技能介绍

在 Windows 或 macOS 上把 Python、Node、二进制或 Shell 脚本当成长期运行的后台服务时，常见痛点是：系统自带的自启动机制各有一套（sc/schtasks vs launchd），崩溃后没人拉起，日志散落控制台，Web 服务挂了却进程还在。

Universal AutoStart 把「安装为系统服务 + 运行期看护」收敛到一套 JSON 配置和少量 CLI/脚本入口，面向本机运维场景而不是容器编排。

跨平台后端：Windows 走 sc 与计划任务；macOS 走 launchd。支持 install / uninstall / start / stop / status 等命令行操作，也可用 install.bat、install_macos.sh 等脚本双击安装。
进程与类型：program.type 支持 python、node、binary、shell，通过 path、arguments、working_dir 描述启动方式。
环境与日志：可开启 environment.load_dotenv 加载 .env，variables 会覆盖同名键。日志默认写入 .logs/UniversalService_YYYY-MM-DD.log，支持按大小轮转、级别与是否输出到控制台。
健康检查与重启：port 或 process 两种检查；连续失败达到阈值可触发 auto_restart，并可用 max_restarts、restart_delay 限制重启频率，避免死循环。
信号：支持 SIGTERM/SIGINT 的优雅退出路径。

当前文档明确支持 Windows 与 macOS；Linux 不在 v1.1 能力范围内。
安装/卸载通常需要管理员权限；权限不足时 Windows 与 macOS 的排查路径不同，应先查日志再改健康检查间隔或 max_failures，避免「检查过严导致频繁重启」。
Python 等解释器若不在 PATH 中，需在配置里写完整可执行路径，否则服务会表现为「已安装但未真正启动」。