refactor(install): drop nlt-service-* wrappers; add nlt-celery

- Remove duplicate nlt-service-{airflow,celery,paperclip,code-server,new-api}
- Emit nlt-celery -> celery/setup.sh (parity with nlt-airflow)
- Update nlt-services hint, smoke test, README, and superpowers docs

Made-with: Cursor

Author: farfarfun

README.md

@@ -21,7 +21,7 @@ Python 包元数据见根目录 [`pyproject.toml`](pyproject.toml)（MIT）。
 
 ## 推荐：一键安装到 ~/.local/nltdeploy
 
-将仓库内脚本同步到 `~/.local/nltdeploy/libexec/nltdeploy/`，并在 `~/.local/nltdeploy/bin/` 生成以 `nlt-` / `nlt-service-` 开头的命令（实现与规格见 [`docs/superpowers/specs/2026-04-11-nltdeploy-local-install-design.md`](docs/superpowers/specs/2026-04-11-nltdeploy-local-install-design.md)）。
+将仓库内脚本同步到 `~/.local/nltdeploy/libexec/nltdeploy/`，并在 `~/.local/nltdeploy/bin/` 生成以 **`nlt-`** 开头的命令（实现与规格见 [`docs/superpowers/specs/2026-04-11-nltdeploy-local-install-design.md`](docs/superpowers/specs/2026-04-11-nltdeploy-local-install-design.md)）。
 
 **克隆仓库后本地安装 / 更新：**
 
@@ -85,23 +85,19 @@ bash tests/install_smoke.sh
 | `nlt-pip-sources` | `scripts/tools/pip-sources/setup.sh`（无参时 gum 选 install/update/reinstall/uninstall） |
 | `nlt-python-env` | `scripts/tools/python-env/setup.sh`（无参时 gum 选子命令；见脚本头） |
 | `nlt-airflow-install` | `scripts/services/airflow/setup.sh` install |
-| `nlt-airflow`（可接任意子命令；无参为 gum 菜单） | `scripts/services/airflow/setup.sh` …（含 `update`） |
-| `nlt-service-airflow` | 同上 `setup.sh`，透传子命令（如 `start` / `stop` / `restart` / `status` / `update`） |
+| `nlt-airflow` | 同上 `setup.sh` 全量子命令（如 `start` / `stop` / `status` / `update`）；无参为 gum 菜单 |
 | `nlt-celery-install` | `scripts/services/celery/setup.sh` install |
-| `nlt-celery-update` | `setup.sh` update |
-| `nlt-service-celery` | 同上 `setup.sh`，透传（如 `start-worker` / `start-beat` / `start-flower` / `stop` / `restart` / `status`） |
+| `nlt-celery-update` | 同上 `setup.sh` update |
+| `nlt-celery` | 同上 `setup.sh` 全量子命令（如 `start-worker` / `stop` / `status`）；无参为菜单 |
 | `nlt-utils`（可接子参数，如 `gum`、`all`） | `scripts/tools/utils/setup.sh` … |
 | `nlt-github-net` | `scripts/tools/github-net/setup.sh`（无参 gum；可 `install` / `update` / `reinstall` / `uninstall`） |
 | `nlt-services` | `scripts/services/nlt-services.sh`（无参 gum；`status`；`install` 先选安装或卸载；非交互：`install add <模块>` / `install remove <模块>`；`status --no-http`） |
 | `nlt-paperclip-install` | `scripts/services/paperclip/setup.sh` install（git clone + pnpm install） |
-| `nlt-paperclip` | 同上，透传子命令；无参为 gum 菜单 |
-| `nlt-service-paperclip` | 同上 `setup.sh`，透传（如 `start` / `stop` / `status` / `update`） |
+| `nlt-paperclip` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
 | `nlt-code-server-install` | `scripts/services/code-server/setup.sh` install（下载解压官方包） |
-| `nlt-code-server` | 同上，透传子命令；无参为 gum 菜单 |
-| `nlt-service-code-server` | 同上 `setup.sh`，透传（如 `start` / `stop` / `status` / `update`） |
+| `nlt-code-server` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
 | `nlt-new-api-install` | `scripts/services/new-api/setup.sh` install（下载 Release 二进制） |
-| `nlt-new-api` | 同上，透传子命令；无参为 gum 菜单 |
-| `nlt-service-new-api` | 同上 `setup.sh`，透传（如 `start` / `stop` / `status` / `update`） |
+| `nlt-new-api` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
 
 ## 目录结构
 

docs/superpowers/plans/2026-04-11-nltdeploy-local-install.md

@@ -2,7 +2,7 @@
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
-**Goal:** 提供仓库根目录一键 `install.sh`，将 `scripts/` 中的实现同步到 `~/.local/nltdeploy/libexec/nltdeploy/`，并在 `bin/` 生成符合规格的 `nlt-*` / `nlt-service-*` 薄包装；文档与 `NLTDEPLOY_RAW_BASE` 兼容变量同步更新。
+**Goal:** 提供仓库根目录一键 `install.sh`，将 `scripts/` 中的实现同步到 `~/.local/nltdeploy/libexec/nltdeploy/`，并在 `bin/` 生成符合规格的 **`nlt-*`** 薄包装；文档与 `NLTDEPLOY_RAW_BASE` 兼容变量同步更新。
 
 **Architecture:** 以 **`scripts/` 为单一源码真相**（不在首版重复维护第二套脚本正文）。安装时按固定映射表 **复制** 到 `libexec`（避免符号链接在打包/部分文件系统上的问题）。`bin` 下全部为两行级薄包装：`NLTDEPLOY_ROOT` + `exec` 到 libexec 目标并附加固定子命令参数。Airflow/Celery 继续沿用现有 `setup.sh` 的子命令接口。
 
@@ -143,10 +143,10 @@ _emit_wrapper nlt-github-net github-net/setup.sh
 
 _emit_wrapper nlt-airflow-install airflow/setup.sh install
 _emit_wrapper nlt-airflow airflow/setup.sh
-_emit_wrapper nlt-service-airflow airflow/setup.sh
 
 _emit_wrapper nlt-celery-install celery/setup.sh install
-_emit_wrapper nlt-service-celery celery/setup.sh
+_emit_wrapper nlt-celery-update celery/setup.sh update
+_emit_wrapper nlt-celery celery/setup.sh
 ```
 
 - [ ] **Step 3: 安装结束提示 PATH（不默认写 profile）**
@@ -169,7 +169,7 @@ Expected: 退出码 0。
 
 ```bash
 git add install.sh
-git commit -m "feat: generate nlt-* and nlt-service-* bin wrappers in install.sh"
+git commit -m "feat: generate nlt-* bin wrappers in install.sh"
 ```
 
 ---
@@ -237,8 +237,8 @@ export NLTDEPLOY_ROOT="${TMP}/nd"
 bash "${ROOT}/install.sh"
 for f in \
   nlt-pip-sources nlt-python-env nlt-utils nlt-github-net \
-  nlt-airflow-install nlt-airflow nlt-service-airflow \
-  nlt-celery-install nlt-service-celery
+  nlt-airflow-install nlt-airflow \
+  nlt-celery-install nlt-celery-update nlt-celery
 do
   [[ -x "${NLTDEPLOY_ROOT}/bin/${f}" ]] || { echo "missing: bin/${f}" >&2; exit 1; }
   bash -n "${NLTDEPLOY_ROOT}/bin/${f}" || exit 1
@@ -280,7 +280,7 @@ git commit -m "test: add install smoke test for bin wrappers and libexec"
 
 表格列：`新命令（bin）` | `原 scripts 路径与用法` | 备注。
 
-须包含本计划中 `_emit_wrapper` 列出的全部 `nlt-*` / `nlt-service-*` 名称。
+须包含本计划中 `_emit_wrapper` 列出的全部 `nlt-*` 名称。
 
 - [ ] **Step 3: 在「环境变量」相关小节补充 `NLTDEPLOY_RAW_BASE`**
 
@@ -301,7 +301,7 @@ git commit -m "docs: document local install, nlt-* mapping, and NLTDEPLOY_RAW_BA
 |----------|----------|
 | 一键安装 + `bin` 仅 `nlt-*` | Task 1–2 |
 | `libexec` 实现分离 | Task 1 |
-| `nlt-service-<域>` 单入口透传子命令 | Task 2（Airflow/Celery 等） |
+| `nlt-<域>` 单入口透传子命令 | Task 2（Airflow/Celery 等） |
 | `nlt-airflow-install` 非 service | Task 2 |
 | `NLTDEPLOY_ROOT` 可覆盖 | Task 1–2 薄包装 |
 | `NONINTERACTIVE` 保留 | 无需改脚本（沿用现有） |

docs/superpowers/specs/2026-04-11-nltdeploy-local-install-design.md

@@ -12,7 +12,7 @@
 
 - **一键安装**：单入口脚本（可 `curl | bash`，也可 clone 后本地执行）完成目录创建、文件同步、`bin` 下命令就绪，并提示配置 `PATH`。
 - **统一安装根**：运行时工具箱根目录为 **`~/.local/nltdeploy`**（可通过环境变量覆盖，见第 6 节）。
-- **PATH 仅暴露 `nlt-*`**：用户可执行文件全部以 `nlt-` 开头；其中 **服务启停类** 以 **`nlt-service-`** 开头。
+- **PATH 仅暴露 `nlt-*`**：用户可执行文件全部以 `nlt-` 开头（含工具、安装类与服务生命周期，**不再**单独使用 `nlt-service-*` 前缀）。
 - **实现与入口分离**：真实逻辑放在 **`libexec/nltdeploy/`**，`bin` 仅为薄包装，便于升级与测试。
 
 成功标准：安装后在不进入仓库目录的情况下，仅依赖 `PATH` 即可调用文档中列出的命令；现有 `scripts/` 行为可通过迁移表逐项对齐或显式废弃。
@@ -25,8 +25,9 @@
 |------|------|------|
 | 主形态 | **A：Bash 小命令为主** | 与当前仓库以 shell 为主力一致；Python 包不作为终端主入口（可后续作为可选依赖，本规格不强制）。 |
 | 命令前缀 | **`nlt-`** | 所有 `bin` 内可执行文件名均以此开头。 |
-| 服务类前缀 | **`nlt-service-`** | 长期运行服务的 start/stop/restart/status 等归属此族。 |
-| Airflow「首次安装」 | **`nlt-airflow-install`（非 service）** | 与「装环境」一致归为工具/安装类；装好后日常运维用 **`nlt-service-airflow`** 接子命令（如 `start` / `status`），与 `nlt-airflow` 等价透传。 |
+| 服务生命周期 | **`nlt-<域>`** | 与 **`nlt-airflow`**、**`nlt-celery`**、**`nlt-paperclip`** 等总控入口透传 `start` / `stop` / `status` / `update` 等子命令；**不**再生成 `nlt-service-<域>` 重复包装。 |
+| Airflow「首次安装」 | **`nlt-airflow-install`** | 首次/干净环境安装；日常运维用 **`nlt-airflow`** 接子命令。 |
+| Celery | **`nlt-celery-install`** / **`nlt-celery-update`** / **`nlt-celery`** | 安装、依赖升级与全量子命令（含 worker/beat/flower）分口，与 Airflow 的 install + 总控对称。 |
 | 数据与运行时目录 | **默认保持现有 `~/opt/...` 约定** | 与 README 及现有脚本一致，降低迁移成本；若设置 `AIRFLOW_HOME` / `CELERY_HOME` 等，仍以用户环境为准。后续可在实现阶段增加可选「统一到 `~/.local/nltdeploy/var`」的迁移助手，**不作为本规格 v1 默认行为**。 |
 
 ---
@@ -41,7 +42,7 @@
 └── etc/nltdeploy/                # 用户级配置覆盖（可选）
 ```
 
-- **`bin/`**：仅包含名称以 `nlt-` 开头的文件（含 `nlt-service-*`）。
+- **`bin/`**：仅包含名称以 `nlt-` 开头的文件。
 - **`libexec/nltdeploy/`**：可按域分子目录（例如 `pip/`、`python-env/`、`airflow/`、`celery/`），具体结构由实现计划定义；规格要求 **不将 `libexec` 加入 PATH**。
 
 ---
@@ -68,11 +69,11 @@
 
 ### 4.3 服务（进程生命周期）
 
-- 模式：**`nlt-service-<服务名>`** 为单一薄包装，`exec` 到对应域脚本并 **透传 `"$@"`**；动作为 **第一个参数**（及后续参数）。
+- 模式：**`nlt-<服务名>`** 为薄包装，`exec` 到对应域 `setup.sh` 并 **透传 `"$@"`**；动作为 **第一个参数**（及后续参数）。
 - 动作建议统一为：`start` | `stop` | `restart` | `status` | `update`（Celery 另有 `start-worker` / `start-beat` / `start-flower` 等，与域脚本一致）。
 - 示例：
-  - `nlt-service-airflow start` / `stop` / `restart` / `status` / `update`
-  - `nlt-service-celery start-worker` / `start-beat` / `stop` / `status` / …
+  - `nlt-airflow start` / `stop` / `restart` / `status` / `update`
+  - `nlt-celery start-worker` / `start-beat` / `stop` / `status` / …
 
 ---
 
@@ -111,7 +112,7 @@
 ## 8. 测试与验收（规格层）
 
 - 安装脚本在 **macOS 与 Linux**（含无 TTY 的 `NONINTERACTIVE`）下可完成安装。
-- 抽样验收：`nlt-pip-sources`、`nlt-python-env`、`nlt-airflow-install`、`nlt-service-airflow status`（在未安装服务时可有明确退出码与提示）等按迁移表可调用。
+- 抽样验收：`nlt-pip-sources`、`nlt-python-env`、`nlt-airflow-install`、`nlt-airflow status`（在未安装服务时可有明确退出码与提示）等按迁移表可调用。
 
 ---
 
@@ -125,5 +126,5 @@
 ## 规格自检记录
 
 - **占位符**：无 TBD；数据目录默认策略已写死为保留 `~/opt` 与既有 env。
-- **一致性**：服务类仅 `nlt-service-*`；Airflow 安装单独 `nlt-airflow-install`，与上文表格一致。
+- **一致性**：服务生命周期统一经 `nlt-<域>`；Airflow / Celery 的首次安装仍用 `nlt-airflow-install`、`nlt-celery-install`，与上文表格一致。
 - **范围**：本文件仅定义布局与命名；不展开具体 systemd/launchd 或进程管理实现细节（归入实现计划）。

docs/superpowers/specs/2026-04-11-nltdeploy-tool-service-conventions.md

@@ -59,8 +59,8 @@
 ### 3.2 与 `bin` 命名的关系（不破坏现有安装）
 
 - **推荐**：每个域一个 **总控入口**（如 `nlt-airflow` → `airflow/setup.sh "$@"`），所有子命令通过参数触发直执行或 gum 菜单。
-- **服务族命名**：每个长期运行域对应 **一个** **`nlt-service-<域>`**，透传子命令（如 `nlt-service-airflow start`），**不再**为每个动词单独生成 `nlt-service-<域>-<动词>` 文件。
-- **新增服务/工具**：优先 **总控** `nlt-<域>` 与 **`nlt-service-<域>`**（二者可指向同一 libexec 脚本）；安装类入口仍可用 `nlt-<域>-install`。
+- **服务域**：长期运行域只用 **`nlt-<域>`** 透传子命令（如 `nlt-airflow start`），**不**再提供并行的 `nlt-service-<域>` 包装。
+- **新增服务/工具**：总控 `nlt-<域>`；需要单独语义时仍可用 `nlt-<域>-install` / `nlt-<域>-update`（如 Celery）等，**不为**每个动词单独生成 `nlt-<域>-<动词>` 文件。
 
 ---
 
@@ -102,7 +102,7 @@
 - [ ] 无参数走 gum 交互；带首参子命令时直执行，不经过主菜单。  
 - [ ] 需要 gum 前调用 `_nlt_ensure_gum`，且 gum 已安装时 O(1) 跳过。  
 - [ ] `NONINTERACTIVE=1` 行为在脚本头注释中说明。  
-- [ ] `install.sh` 与 README 中的 `nlt-*` / `nlt-service-*` 对照表已更新（若新增包装）。
+- [ ] `install.sh` 与 README 中的 `nlt-*` 对照表已更新（若新增包装）。
 
 ---
 

install.sh

@@ -328,23 +328,19 @@ do_install_or_update() {
 
   _emit_wrapper nlt-airflow-install airflow/setup.sh install
   _emit_wrapper nlt-airflow airflow/setup.sh
-  _emit_wrapper nlt-service-airflow airflow/setup.sh
 
   _emit_wrapper nlt-celery-install celery/setup.sh install
   _emit_wrapper nlt-celery-update celery/setup.sh update
-  _emit_wrapper nlt-service-celery celery/setup.sh
+  _emit_wrapper nlt-celery celery/setup.sh
 
   _emit_wrapper nlt-paperclip-install paperclip/setup.sh install
   _emit_wrapper nlt-paperclip paperclip/setup.sh
-  _emit_wrapper nlt-service-paperclip paperclip/setup.sh
 
   _emit_wrapper nlt-code-server-install code-server/setup.sh install
   _emit_wrapper nlt-code-server code-server/setup.sh
-  _emit_wrapper nlt-service-code-server code-server/setup.sh
 
   _emit_wrapper nlt-new-api-install new-api/setup.sh install
   _emit_wrapper nlt-new-api new-api/setup.sh
-  _emit_wrapper nlt-service-new-api new-api/setup.sh
 
   if [[ "${NLTDEPLOY_SKIP_PROFILE_HINT:-}" != "1" ]]; then
     echo ""

scripts/services/nlt-services.sh

@@ -166,7 +166,7 @@ cmd_status() {
     echo "  Flower URL: http://${FLOWER_ADDRESS}:${FLOWER_PORT}/"
     echo "  探测:       $(http_probe "http://${FLOWER_ADDRESS}:${FLOWER_PORT}/")"
   fi
-  echo "  详情:       nlt-service-celery status"
+  echo "  详情:       nlt-celery status"
 
   section "Paperclip"
   echo "  名称:     Paperclip"

tests/install_smoke.sh

@@ -10,11 +10,11 @@ bash "${ROOT}/install.sh" install
 bash "${ROOT}/install.sh" update
 for f in \
   nlt-pip-sources nlt-python-env nlt-utils nlt-github-net nlt-services \
-  nlt-airflow-install nlt-airflow nlt-service-airflow \
-  nlt-celery-install nlt-celery-update nlt-service-celery \
-  nlt-paperclip-install nlt-paperclip nlt-service-paperclip \
-  nlt-code-server-install nlt-code-server nlt-service-code-server \
-  nlt-new-api-install nlt-new-api nlt-service-new-api
+  nlt-airflow-install nlt-airflow \
+  nlt-celery-install nlt-celery-update nlt-celery \
+  nlt-paperclip-install nlt-paperclip \
+  nlt-code-server-install nlt-code-server \
+  nlt-new-api-install nlt-new-api
 do
   [[ -x "${NLTDEPLOY_ROOT}/bin/${f}" ]] || { echo "missing: bin/${f}" >&2; exit 1; }
   bash -n "${NLTDEPLOY_ROOT}/bin/${f}" || exit 1