feat(systemd-service-manager): 添加单元状态摘要输出功能

- 在 enable、disable、start、stop、restart 命令后添加状态摘要输出
- 在 install 命令中添加已安装和已启动的状态输出
- 移除 status 命令中的重复状态检查逻辑，统一使用新的摘要函数
- 新增 ssm_collect_unit_summary 和 ssm_print_unit_summary 函数提供统
  一的状态摘要功能
- 添加对激活中但未启用的单元的友好提示信息
- 更新相关测试用例验证新的输出格式

Author: mudssky

scripts/bash/systemd-service-manager/commands/disable.sh

@@ -11,4 +11,6 @@ ssm_cmd_disable() {
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
   ssm_systemctl "${SSM_ACTIVE_SCOPE}" disable "${SSM_ACTIVE_UNIT}"
+  printf 'disabled=%s\n' "${SSM_ACTIVE_UNIT}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

scripts/bash/systemd-service-manager/commands/enable.sh

@@ -11,4 +11,6 @@ ssm_cmd_enable() {
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
   ssm_systemctl "${SSM_ACTIVE_SCOPE}" enable "${SSM_ACTIVE_UNIT}"
+  printf 'enabled=%s\n' "${SSM_ACTIVE_UNIT}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

scripts/bash/systemd-service-manager/commands/install.sh

@@ -37,9 +37,12 @@ ssm_cmd_install() {
       mkdir -p "$(ssm_unit_dir_for_scope "${scope}")"
       cp "${service_unit_file}" "$(ssm_unit_dir_for_scope "${scope}")/"
       ssm_daemon_reload "${scope}"
+      printf 'installed=%s\n' "$(ssm_service_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       if [[ "${SSM_CLI_START_AFTER_INSTALL}" == "1" ]]; then
         ssm_systemctl "${scope}" start "$(ssm_service_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
+        printf 'started=%s\n' "$(ssm_service_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       fi
+      ssm_print_unit_summary "${SSM_RESOLVED_TARGET_NAME}" "${scope}" "$(ssm_service_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       ;;
     timer)
       ssm_parse_timer_config "${project_dir}" "${SSM_RESOLVED_TARGET_NAME}"
@@ -81,9 +84,12 @@ ssm_cmd_install() {
       cp "${task_unit_file}" "$(ssm_unit_dir_for_scope "${scope}")/"
       cp "${timer_unit_file}" "$(ssm_unit_dir_for_scope "${scope}")/"
       ssm_daemon_reload "${scope}"
+      printf 'installed=%s\n' "$(ssm_timer_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       if [[ "${SSM_CLI_START_AFTER_INSTALL}" == "1" ]]; then
         ssm_systemctl "${scope}" start "$(ssm_timer_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
+        printf 'started=%s\n' "$(ssm_timer_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       fi
+      ssm_print_unit_summary "${SSM_RESOLVED_TARGET_NAME}" "${scope}" "$(ssm_timer_unit_name "${SSM_RESOLVED_TARGET_NAME}")"
       ;;
     *)
       ssm_die "Unknown install target kind: ${target_kind}"

scripts/bash/systemd-service-manager/commands/restart.sh

@@ -11,4 +11,6 @@ ssm_cmd_restart() {
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
   ssm_systemctl "${SSM_ACTIVE_SCOPE}" restart "${SSM_ACTIVE_UNIT}"
+  printf 'restarted=%s\n' "${SSM_ACTIVE_UNIT}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

scripts/bash/systemd-service-manager/commands/start.sh

@@ -11,4 +11,6 @@ ssm_cmd_start() {
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
   ssm_systemctl "${SSM_ACTIVE_SCOPE}" start "${SSM_ACTIVE_UNIT}"
+  printf 'started=%s\n' "${SSM_ACTIVE_UNIT}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

scripts/bash/systemd-service-manager/commands/status.sh

@@ -10,16 +10,5 @@ ssm_cmd_status() {
   local target_kind="${1:-}"
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
-
-  local enabled_state=""
-  local active_state=""
-  enabled_state="$(ssm_systemctl "${SSM_ACTIVE_SCOPE}" is-enabled "${SSM_ACTIVE_UNIT}" 2>/dev/null || true)"
-  active_state="$(ssm_systemctl "${SSM_ACTIVE_SCOPE}" is-active "${SSM_ACTIVE_UNIT}" 2>/dev/null || true)"
-
-  printf 'name=%s\n' "${SSM_ACTIVE_NAME}"
-  printf 'unit=%s\n' "${SSM_ACTIVE_UNIT}"
-  printf 'scope=%s\n' "${SSM_ACTIVE_SCOPE}"
-  printf 'installed=%s\n' "$(ssm_is_unit_installed "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}")"
-  printf 'enabled=%s\n' "${enabled_state:-unknown}"
-  printf 'active=%s\n' "${active_state:-unknown}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

scripts/bash/systemd-service-manager/commands/stop.sh

@@ -11,4 +11,6 @@ ssm_cmd_stop() {
   local target_name="${2:-}"
   ssm_load_target_context "${target_kind}" "${target_name}"
   ssm_systemctl "${SSM_ACTIVE_SCOPE}" stop "${SSM_ACTIVE_UNIT}"
+  printf 'stopped=%s\n' "${SSM_ACTIVE_UNIT}"
+  ssm_print_unit_summary "${SSM_ACTIVE_NAME}" "${SSM_ACTIVE_SCOPE}" "${SSM_ACTIVE_UNIT}"
 }

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

@@ -142,6 +142,43 @@ ssm_load_target_context() {
   esac
 }
 
+# 读取当前 unit 的 installed/enabled/active 摘要，供状态展示和成功提示复用。
+ssm_collect_unit_summary() {
+  local scope="$1"
+  local unit_name="$2"
+
+  SSM_SUMMARY_INSTALLED="$(ssm_is_unit_installed "${scope}" "${unit_name}")"
+  SSM_SUMMARY_ENABLED="$(ssm_systemctl "${scope}" is-enabled "${unit_name}" 2>/dev/null || true)"
+  SSM_SUMMARY_ACTIVE="$(ssm_systemctl "${scope}" is-active "${unit_name}" 2>/dev/null || true)"
+
+  [[ -n "${SSM_SUMMARY_ENABLED}" ]] || SSM_SUMMARY_ENABLED="unknown"
+  [[ -n "${SSM_SUMMARY_ACTIVE}" ]] || SSM_SUMMARY_ACTIVE="unknown"
+}
+
+# 输出统一状态摘要，并附加人类可读提示。
+ssm_print_unit_summary() {
+  local name="$1"
+  local scope="$2"
+  local unit_name="$3"
+
+  ssm_collect_unit_summary "${scope}" "${unit_name}"
+
+  printf 'name=%s\n' "${name}"
+  printf 'unit=%s\n' "${unit_name}"
+  printf 'scope=%s\n' "${scope}"
+  printf 'installed=%s\n' "${SSM_SUMMARY_INSTALLED}"
+  printf 'enabled=%s\n' "${SSM_SUMMARY_ENABLED}"
+  printf 'active=%s\n' "${SSM_SUMMARY_ACTIVE}"
+
+  if [[ "${SSM_SUMMARY_ENABLED}" == "disabled" && "${SSM_SUMMARY_ACTIVE}" != "inactive" ]]; then
+    printf 'note=unit 已启动但未启用开机自启\n'
+  fi
+
+  if [[ "${SSM_SUMMARY_ACTIVE}" == "activating" ]]; then
+    printf 'note=unit 正在启动中\n'
+  fi
+}
+
 # 判断当前命令是否需要在非 root 下自动提权。
 ssm_should_auto_elevate() {
   local command="$1"

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

@@ -162,6 +162,8 @@ describe('install command', () => {
     )
 
     expect(result.exitCode).toBe(0)
+    expect(result.stdout).toContain('installed=myapp-api.service')
+    expect(result.stdout).toContain('started=myapp-api.service')
     expect(fs.readFileSync(systemctlLog, 'utf8')).toContain('daemon-reload')
     expect(fs.readFileSync(systemctlLog, 'utf8')).toContain('start myapp-api.service')
   })

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

@@ -181,4 +181,44 @@ describe('lifecycle commands', () => {
     expect(fs.readFileSync(sudoLog, 'utf8')).toContain(workspace.sourceEntry)
     expect(fs.readFileSync(systemctlLog, 'utf8')).toContain('start myapp-api.service')
   })
+
+  it('status explains activating but not enabled units', async () => {
+    const workspace = createWorkspace()
+    workspaces.push(workspace)
+
+    const systemctlLog = path.join(workspace.root, 'systemctl.log')
+    installMockCommand(
+      workspace,
+      'systemctl',
+      [
+        '#!/usr/bin/env bash',
+        'printf "%s\\n" "$*" >>"${SSM_SYSTEMCTL_LOG}"',
+        'if [[ "$1" == "is-enabled" ]]; then printf "disabled\\n"; fi',
+        'if [[ "$1" == "is-active" ]]; then printf "activating\\n"; fi',
+        'exit 0',
+      ].join('\n'),
+    )
+
+    const projectRoot = path.join(
+      workspace.managerHome,
+      'tests',
+      'fixtures',
+      'project-basic',
+    )
+
+    const result = await runSource(
+      workspace,
+      ['status', 'api', '--project', projectRoot],
+      {
+        SSM_TEST_EUID: '0',
+        SSM_SYSTEMCTL_LOG: systemctlLog,
+      },
+    )
+
+    expect(result.exitCode).toBe(0)
+    expect(result.stdout).toContain('enabled=disabled')
+    expect(result.stdout).toContain('active=activating')
+    expect(result.stdout).toContain('note=unit 已启动但未启用开机自启')
+    expect(result.stdout).toContain('note=unit 正在启动中')
+  })
 })