framework-startup

提供开机自启的注册、注销与启停能力，Windows、Linux、macOS 使用同一套 API。

平台实现

系统级随系统启动，不依赖用户登录，注册与启停通常需要管理员或 root 权限；用户级随当前用户登录启动， 无需提权。Linux 用户级还要求该用户存在可用的 systemd 用户实例。

实现方式为「写入自启定义文件 + 调用系统命令」：Windows 调用 schtasks，Linux 调用 systemctl （用户级附加 --user），macOS 调用 launchctl。命令失败时会带上退出码与完整输出，便于直接展示给用户。

外部命令通过 framework-system 的 CommandExt 执行，错误信息与命令行 由该扩展统一生成。sysinfo 仅在 Windows 目标下参与编译，用于按可执行文件路径判断运行状态。

用法

use framework_startup::{Startup, StartupConfig};

// 以当前可执行文件为启动目标，注册随当前用户登录启动
let mut config = StartupConfig::new("my-app");
config.description = "个人使用的轻量网关".to_string();
config.args = vec!["--port".to_string(), "8080".to_string()];
config.working_directory = Some("/opt/my-app".into());

let startup = Startup::user(config)?;

// install 已注册时不重复执行；需要让配置变更生效时用 install_force
startup.install()?;
// start 已在运行时跳过，stop 未运行时跳过
startup.start()?;
startup.restart()?;

# Ok::<(), anyhow::Error>(())

系统级自启把 Startup::user 换成 Startup::root 即可，其余调用完全一致。

配置

StartupConfig 的字段：

StartupConfig::new(name) 只设置名称，其余字段按需赋值。

API

start()、stop()、is_run()、restart() 与 uninstall() 只对已注册的自启执行；未注册时按 StartupConfig::ignore_not_installed 决定忽略（默认，is_run() 返回假）还是报错。 start() 与 stop() 还会先判断运行状态，因此重复调用不会重复触发底层命令。 restart() 只探测一次运行状态，需要重启时等价于一次 stop() 加一次 start()，但少一次探测。

uninstall() 与 stop() 相互独立：需要注销的同时结束进程时，先调 stop() 再调 uninstall()。

平台差异

• Windows 计划任务的启动目标是完整命令行；systemd 单元的 ExecStart 与 launchd 的 ProgramArguments 由同一份配置生成，含空格的路径会自动加引号或拆分。
• Windows 的权限级别：系统级任务以 SYSTEM 身份运行（/ru SYSTEM /rl highest），用户级任务默认用 未提权的令牌启动；只有 StartupConfig::highest 为真时才追加 /rl highest。
• Windows 计划任务名在任务树的根目录下唯一，系统级与用户级不能使用同名任务；systemd 与 launchd 的两种级别存放于不同目录，可以同名。
• Linux 用户级单元的 [Install] 目标为 default.target（系统级为 multi-user.target）。
• launchd 的 start / stop 只作用于已加载的作业，install 会以 launchctl load -w 加载并 清除 disabled 标记。
• is_run() 的判定方式：Linux 用 systemctl is-active，macOS 用 launchctl list 是否带 PID 键， Windows 按可执行文件完整路径比对进程（sysinfo），因此手动启动同一路径的程序同样算作运行中。