dsh-service-control

dsh-service-control

DSH 服务控制：给 dsh 命令一对翅膀——通过 dsh --profile ctl 管理服务的 systemd 生命周期、持久化配置与运行时诊断。不再引入独立命令（旧版 dshctl 已废弃）。

机制

dsh 启动器只解析自己的 flag（--profile/--patch/--dump-config）， 其后的内层参数原样转交给启动后的应用树。本插件在专用的轻量 ctl profile （dsh-base + 插件，无 webserver/agent）里通过 @deepseek-ai/dsh-cmdline 接管这些 参数，执行完命令后请求进程退出。每次调用 = 启动一次轻量 profile（约 0.2-0.5s）。

安装

# 首次创建 ctl profile 并安装（ctl 是约定的控制面 profile 名）
dsh plugin --profile ctl add dsh-service-control

# 本地开发安装
dsh plugin --profile ctl add "file:/path/to/agents-plugins/dsh-service-control"

注意：不要把本插件装进 web profile——它的命令树会与 web 自身的参数解析冲突。 插件只在 ctl 这类无 webserver 的轻量 profile 中生效。

命令

dsh --profile ctl <namespace> <subcommand> [args]

URL 与 launch token：dsh ≥ 0.1.2 的 web 每次启动生成随机访问 token，裸 http://127.0.0.1:<port> 会返回 401。start/restart/status 报告的 url 与 start 自动打开的地址都会从日志携带当次启动的 token；健康探测（probe/看门狗） 把 401/404 视为“进程活着”（HTTP 层可达），仅连接失败/超时才判不健康。

systemd 生命周期分层：

install        = 托管：写 unit + 注册 → 崩溃自愈/看门狗生效，【不开机自启】
reinstall      = 追加环境变量：保留 unit 文件全部内容，仅插入/更新 --env 指定的键
enable         = 托管 + 开机自启（无 unit 时自动先 install）
disable        = 停看门狗 + 取消自启（unit 文件保留，托管仍生效）
uninstall/remove = 撤销托管：删除 unit 文件

--env 环境变量（install / reinstall 支持，可重复）：

# 显式传值
dsh --profile ctl systemd install --env OPENROUTER_API_KEY=sk-xxxxx567
# 隐式：从当前 shell 环境取值（未设置或为空 → 安装失败）
dsh --profile ctl systemd install --env OPENROUTER_API_KEY
# 多个变量
dsh --profile ctl systemd install --env A=1 --env B=2
# 向已安装 unit 追加（保留用户手改；已存在的键跳过并提示）
dsh --profile ctl systemd reinstall --env OPENROUTER_API_KEY=sk-xxxxx567

环境变量以 Environment="KEY=value" 写入主 unit 的 [Service] 段 （$ 原样保留、%/引号/反斜杠按 systemd 语法转义）。注意：unit 内的环境变量 对同用户 D-Bus 客户端可见，不适合存放高敏密文；隐式形式 --env KEY 可避免 密钥出现在 shell 历史与进程命令行中。reinstall 只 daemon-reload、不自动 重启——新环境变量在下次 dsh --profile ctl systemd restart 时生效。

被控目标 profile

ctl 是控制面，被控的服务 profile 默认 web。可在 ctl profile 的 cordis.patch.yml 中覆盖：

- id: dsh-service-control
  config:
    profile: tui

补全（放入 shell 默认加载目录，不修改 rc 文件）

dsh --profile ctl completions --install          # 安装全部三个 shell
dsh --profile ctl completions --install bash     # 只装 bash
dsh --profile ctl completions bash               # 只打印脚本（不安装）
dsh --profile ctl completions --write-state      # 缓存到 $DSH_HOME/completions（可选）

--install 把生成的脚本放进各 shell 默认自动加载目录，不修改任何用户的 .zshrc / .bashrc 配置文件：

配置键（config set 白名单）

平台与依赖

• Linux 为主：bash、systemctl（可选，无则自启相关命令报错）、pgrep/pkill、ss 或 lsof、curl。
• macOS 部分支持（ss→lsof 回退、probe 延迟回退 node、浏览器回退 open）；systemd 命令不可用。
• Windows 需要 WSL。
• 依赖：@deepseek-ai/dsh-cmdline、commander、@deepseek-ai/schemastery（Node ≥ 18）。

测试

npm test        # 单元测试：命令树解析（别名/flag/退出）、completions 生成、
                # control.sh systemd 分层（install/enable/disable/uninstall）、插件形态
npm run smoke   # 冒烟：隔离 profile 安装 → 组合配置断言 → cmdline 通道 self info / systemd status

卸载

dsh plugin --profile ctl remove dsh-service-control   # 移除插件本体
rm -rf ~/.dsh/profiles/ctl                            # （可选）删除控制面 profile
dsh --profile ctl systemd uninstall                   # （可选）卸载前先撤销 systemd 托管