docs(systemd-service-manager): 更新文档添加命令说明和使用示例

- 在 README.md 中添加 Commands 章节，详细说明所有可用命令
- 添加 Common options 章节，说明通用选项用法
- 添加 Examples 章节，提供具体使用示例
- 更新 CLI 帮助信息，增加命令描述和选项说明
- 修复构建输出路径，在测试中更新本地脚本路径配置

Author: mudssky

scripts/bash/systemd-service-manager/README.md

@@ -2,6 +2,26 @@
 
 一个基于 Bash 的轻量 systemd `service` / `timer` 管理器。
 
+## Commands
+
+- `init`：在项目目录下生成 `deploy/systemd/` 骨架、`README.md`、`*.example` 和默认可编辑配置。
+- `list`：列出项目中声明的 services 与 timers，方便确认命名和管理范围。
+- `install`：把 `.conf` / `.env` 渲染成 `.service` / `.timer`，并安装到 systemd 目录；支持 `--dry-run` 预览。
+- `uninstall`：删除当前工具生成的 unit 文件。
+- `start`：启动指定 service 或 timer。
+- `stop`：停止指定 service 或 timer。
+- `restart`：重启指定 service 或 timer。
+- `status`：查看指定对象的 `unit`、`scope`、`installed`、`enabled`、`active` 状态。
+- `logs`：查看 journald 日志；可配合 `--follow` 持续跟踪。
+- `enable`：启用开机或用户会话自启动。
+- `disable`：禁用开机或用户会话自启动。
+
+## Common options
+
+- `--project <path>`：指定项目根目录，默认使用当前目录。
+- `--dry-run`：只输出计划生成或安装的结果，不真正写入 systemd unit。
+- `--follow`：只给 `logs` 使用，持续跟随日志输出。
+
 ## Build
 
 ```bash
@@ -11,10 +31,20 @@ bash scripts/bash/systemd-service-manager/build.sh
 ## Outputs
 
 - `bin/systemd-service-manager`
-- `scripts/bash/systemd-service-manager.sh`
+- `scripts/bash/systemd-service-manager/systemd-service-manager.local.sh`
 
 打包后的单文件产物内嵌了 `init` 所需模板，因此把脚本单独复制到其他目录后，仍可直接执行 `init` 生成 `deploy/systemd/` 骨架。
 
+## Examples
+
+```bash
+systemd-service-manager init
+systemd-service-manager list --project /path/to/app
+systemd-service-manager install service api --project /path/to/app
+systemd-service-manager install timer cleanup --project /path/to/app --dry-run
+systemd-service-manager logs service api --project /path/to/app --follow
+```
+
 ## Test
 
 ```bash

scripts/bash/systemd-service-manager/lib/cli.sh

@@ -11,18 +11,30 @@ ssm_show_help() {
 Usage: systemd-service-manager <command> [options]
 
 Commands:
-  init
-  list
-  install
-  uninstall
-  start
-  stop
-  restart
-  status
-  logs
-  enable
-  disable
-  help
+  init       初始化当前项目的 deploy/systemd 模板骨架
+  list       列出当前项目中声明的 services 与 timers
+  install    渲染并安装 service/timer unit 到 systemd
+  uninstall  删除当前工具生成的 unit 文件
+  start      启动指定 service 或 timer
+  stop       停止指定 service 或 timer
+  restart    重启指定 service 或 timer
+  status     查看指定 service 或 timer 的安装与运行状态
+  logs       查看指定 service 或 timer 的 journald 日志
+  enable     启用指定 service 或 timer 的自启动
+  disable    禁用指定 service 或 timer 的自启动
+  help       显示这份帮助信息
+
+Common options:
+  --project <path>  指定项目根目录，默认使用当前目录
+  --dry-run         只预览将执行的操作，不实际写入 unit
+  --follow          配合 logs 使用，持续跟随日志输出
+
+Examples:
+  systemd-service-manager init
+  systemd-service-manager list --project /path/to/app
+  systemd-service-manager install service api --project /path/to/app
+  systemd-service-manager install timer cleanup --project /path/to/app --dry-run
+  systemd-service-manager logs service api --project /path/to/app --follow
 EOF
 }
 

scripts/bash/systemd-service-manager/tests/manager-cli.test.ts

@@ -34,6 +34,10 @@ describe('systemd service manager cli', () => {
     expect(sourceHelp.stdout).toContain(
       'Usage: systemd-service-manager <command> [options]',
     )
+    expect(sourceHelp.stdout).toContain('init       初始化当前项目的 deploy/systemd 模板骨架')
+    expect(sourceHelp.stdout).toContain('install    渲染并安装 service/timer unit 到 systemd')
+    expect(sourceHelp.stdout).toContain('--project <path>  指定项目根目录')
+    expect(sourceHelp.stdout).toContain('--dry-run         只预览将执行的操作')
     expect(builtHelp.stdout).toBe(sourceHelp.stdout)
   })
 

scripts/bash/systemd-service-manager/tests/test-utils.ts

@@ -54,7 +54,13 @@ export function createWorkspace(): Workspace {
     sourceEntry: path.join(managerHome, 'main.sh'),
     buildScript: path.join(managerHome, 'build.sh'),
     builtBin: path.join(root, 'bin', 'systemd-service-manager'),
-    builtLocal: path.join(root, 'scripts', 'bash', 'systemd-service-manager.sh'),
+    builtLocal: path.join(
+      root,
+      'scripts',
+      'bash',
+      'systemd-service-manager',
+      'systemd-service-manager.local.sh',
+    ),
     fakeSystemDir,
     fakeUserDir,
     mockBin,