build: add nlt-build tool with aicommits and funbuild alignment

Author: farfarfun

README.md

@@ -10,6 +10,7 @@
 - **celery**：Celery 安装与 worker/beat/flower 启停、状态；默认 `~/opt/celery`。
 - **utils**：安装 **gum**（`~/opt/gum`）与可选 shell 别名（`ll` / `la` / `lla`）。
 - **github-net**：诊断并修复「网页能开但 `git clone` 失败」的常见 HTTPS/SSH 问题。
+- **build**（`nlt-build`）：默认用 **aicommits** 快速提交；子命令对齐开源 **[funbuild / nltbuild](https://github.com/farfarfun/funbuild)**（`pull` / `push` / `upgrade` / `install` / `build` / `release` / `tags` 等，见 `scripts/tools/build/setup.sh` 头注释）。
 - **paperclip**：从 **GitHub 克隆** [paperclipai/paperclip](https://github.com/paperclipai/paperclip) 源码、`pnpm install`，并以 **`pnpm paperclipai run`** 启停；默认安装根 `~/opt/paperclip`，数据目录见上游 `~/.paperclip/…`。
 - **code-server**：从 **GitHub Releases** 下载官方 **standalone** 压缩包并解压到 `~/opt/code-server`；`nohup` 后台运行，默认绑定 `127.0.0.1:8080`；无需本机 Node.js。
 - **new-api**：从 **GitHub Releases** 下载 [QuantumNous/new-api](https://github.com/QuantumNous/new-api) 的预编译二进制到 `~/opt/new-api/bin`；数据目录默认 `~/opt/new-api/data`（SQLite 等），默认 **HTTP 端口 3000**；解析版本时会跳过无附件的 nightly，fallback `v0.12.6`。
@@ -84,20 +85,15 @@ 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` | 同上 `setup.sh` 全量子命令（如 `start` / `stop` / `status` / `update`）；无参为 gum 菜单 |
-| `nlt-celery-install` | `scripts/services/celery/setup.sh` install |
-| `nlt-celery-update` | 同上 `setup.sh` update |
-| `nlt-celery` | 同上 `setup.sh` 全量子命令（如 `start-worker` / `stop` / `status`）；无参为菜单 |
+| `nlt-airflow` | `scripts/services/airflow/setup.sh` 全量子命令；`install` 首次/升级安装；`start` / `stop` / `status` / `update` 等；无参为 gum 菜单 |
+| `nlt-celery` | `scripts/services/celery/setup.sh` 全量子命令；`install` / `update`；`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-build` | `scripts/tools/build/setup.sh` + `nltbuild_core.py`：默认 `aicommits -a`；`commit` / `staged` 同前。子命令 **pull / push / upgrade / install / build / release / tags** 等与 [farfarfun/funbuild](https://github.com/farfarfun/funbuild)（PyPI **nltbuild**）行为对齐；Python 部分需 **python3** 与 **`pip install toml`**；**push** 使用 `aicommits --yes`（与上游 `core.py` 一致）。**clean** / **clean-history** 须设置确认环境变量（见脚本 `help`） |
 | `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` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
-| `nlt-code-server-install` | `scripts/services/code-server/setup.sh` install（下载解压官方包） |
-| `nlt-code-server` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
-| `nlt-new-api-install` | `scripts/services/new-api/setup.sh` install（下载 Release 二进制） |
-| `nlt-new-api` | 同上 `setup.sh` 全量子命令；无参为 gum 菜单 |
+| `nlt-paperclip` | `scripts/services/paperclip/setup.sh` 全量子命令；`install`（git clone + pnpm install）等；无参为 gum 菜单 |
+| `nlt-code-server` | `scripts/services/code-server/setup.sh` 全量子命令；`install`（下载解压官方包）等；无参为 gum 菜单 |
+| `nlt-new-api` | `scripts/services/new-api/setup.sh` 全量子命令；`install` / `update` 下载 Release 二进制；无参为 gum 菜单 |
 
 ## 目录结构
 
@@ -123,8 +119,11 @@ nltdeploy/
 │   │   │   └── README.md
 │   │   ├── utils/
 │   │   │   └── setup.sh                # gum / 别名 / all
-│   │   └── github-net/
-│   │       └── setup.sh                # Git 连通性诊断与修复
+│   │   ├── github-net/
+│   │   │   └── setup.sh                # Git 连通性诊断与修复
+│   │   └── build/
+│   │       ├── setup.sh                # nlt-build：aicommits + nltbuild 移植核心
+│   │       └── nltbuild_core.py        # 构建/版本/发布逻辑（Python）
 │   └── services/                       # 常驻服务与聚合入口
 │       ├── nlt-services.sh             # nlt-services：status + install 聚合入口
 │       ├── airflow/
@@ -253,6 +252,7 @@ curl -LsSf https://gitee.com/farfarfun/nltdeploy/raw/master/scripts/tools/github
 | `tools/python-env` | `setup.sh` | uv、多版本 Python venv、基础包 |
 | `tools/utils` | `setup.sh` | gum 与 shell 便利项 |
 | `tools/github-net` | `setup.sh` | GitHub 克隆通道诊断与修复 |
+| `tools/build` | `setup.sh`、`nltbuild_core.py` | `nlt-build`：aicommits 与 funbuild/nltbuild 能力 |
 | `services/airflow` | `setup.sh` | Airflow 3 安装与日常运维封装 |
 | `services/celery` | `setup.sh` | Celery 安装与进程管理 |
 | `services/paperclip` | `setup.sh` | 克隆 [paperclipai/paperclip](https://github.com/paperclipai/paperclip)、pnpm 安装与启停 |

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

@@ -141,11 +141,7 @@ _emit_wrapper nlt-python-env python-env/setup.sh
 _emit_wrapper nlt-utils utils/setup.sh
 _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-celery-install celery/setup.sh install
-_emit_wrapper nlt-celery-update celery/setup.sh update
 _emit_wrapper nlt-celery celery/setup.sh
 ```
 
@@ -237,8 +233,7 @@ 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-celery-install nlt-celery-update nlt-celery
+  nlt-airflow nlt-celery
 do
   [[ -x "${NLTDEPLOY_ROOT}/bin/${f}" ]] || { echo "missing: bin/${f}" >&2; exit 1; }
   bash -n "${NLTDEPLOY_ROOT}/bin/${f}" || exit 1
@@ -302,7 +297,7 @@ git commit -m "docs: document local install, nlt-* mapping, and NLTDEPLOY_RAW_BA
 | 一键安装 + `bin` 仅 `nlt-*` | Task 1–2 |
 | `libexec` 实现分离 | Task 1 |
 | `nlt-<域>` 单入口透传子命令 | Task 2（Airflow/Celery 等） |
-| `nlt-airflow-install` 非 service | Task 2 |
+| 服务域仅 `nlt-<域>` 单入口（含 `install` 子命令） | Task 2 |
 | `NLTDEPLOY_ROOT` 可覆盖 | Task 1–2 薄包装 |
 | `NONINTERACTIVE` 保留 | 无需改脚本（沿用现有） |
 | `NLTDEPLOY_RAW_BASE` | Task 3 |

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

@@ -26,8 +26,7 @@
 | 主形态 | **A：Bash 小命令为主** | 与当前仓库以 shell 为主力一致；Python 包不作为终端主入口（可后续作为可选依赖，本规格不强制）。 |
 | 命令前缀 | **`nlt-`** | 所有 `bin` 内可执行文件名均以此开头。 |
 | 服务生命周期 | **`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 + 总控对称。 |
+| Airflow / Celery 等安装与运维 | **`nlt-airflow`** / **`nlt-celery`** … | 每个域 **单一** `bin` 入口，**透传** `install`、`update`、`start`、`stop` 等子命令；**不**再为 `install`/`update` 单独生成 `nlt-<域>-install` 等并行包装。 |
 | 数据与运行时目录 | **默认保持现有 `~/opt/...` 约定** | 与 README 及现有脚本一致，降低迁移成本；若设置 `AIRFLOW_HOME` / `CELERY_HOME` 等，仍以用户环境为准。后续可在实现阶段增加可选「统一到 `~/.local/nltdeploy/var`」的迁移助手，**不作为本规格 v1 默认行为**。 |
 
 ---
@@ -65,7 +64,7 @@
 | `scripts/tools/python-env/setup.sh` | `nlt-python-env` |
 | `scripts/tools/utils/setup.sh` | `nlt-utils` 或拆分为 `nlt-utils-gum` 等 |
 | `scripts/tools/github-net/setup.sh` | `nlt-github-net` |
-| Airflow 首次安装/升级（原 `scripts/services/airflow/setup.sh` 中非启停部分） | `nlt-airflow-install` |
+| Airflow 首次安装/升级（原 `airflow/setup.sh` 中非启停部分） | `nlt-airflow install`（及域内 `update` 等） |
 
 ### 4.3 服务（进程生命周期）
 
@@ -112,7 +111,7 @@
 ## 8. 测试与验收（规格层）
 
 - 安装脚本在 **macOS 与 Linux**（含无 TTY 的 `NONINTERACTIVE`）下可完成安装。
-- 抽样验收：`nlt-pip-sources`、`nlt-python-env`、`nlt-airflow-install`、`nlt-airflow status`（在未安装服务时可有明确退出码与提示）等按迁移表可调用。
+- 抽样验收：`nlt-pip-sources`、`nlt-python-env`、`nlt-airflow install`、`nlt-airflow status`（在未安装服务时可有明确退出码与提示）等按迁移表可调用。
 
 ---
 
@@ -126,5 +125,5 @@
 ## 规格自检记录
 
 - **占位符**：无 TBD；数据目录默认策略已写死为保留 `~/opt` 与既有 env。
-- **一致性**：服务生命周期统一经 `nlt-<域>`；Airflow / Celery 的首次安装仍用 `nlt-airflow-install`、`nlt-celery-install`，与上文表格一致。
+- **一致性**：服务生命周期与首次安装统一经 **`nlt-<域>`** 及子命令（如 `install`），与上文表格一致；`install.sh` 在更新时会删除历史上曾生成的 `nlt-<域>-install` 等废弃包装。
 - **范围**：本文件仅定义布局与命名；不展开具体 systemd/launchd 或进程管理实现细节（归入实现计划）。

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

@@ -60,7 +60,7 @@
 
 - **推荐**：每个域一个 **总控入口**（如 `nlt-airflow` → `airflow/setup.sh "$@"`），所有子命令通过参数触发直执行或 gum 菜单。
 - **服务域**：长期运行域只用 **`nlt-<域>`** 透传子命令（如 `nlt-airflow start`），**不**再提供并行的 `nlt-service-<域>` 包装。
-- **新增服务/工具**：总控 `nlt-<域>`；需要单独语义时仍可用 `nlt-<域>-install` / `nlt-<域>-update`（如 Celery）等，**不为**每个动词单独生成 `nlt-<域>-<动词>` 文件。
+- **新增服务/工具**：总控 **`nlt-<域>`** 透传子命令（如 `install`、`update`），**不**再为同一域生成并行的 `nlt-<域>-install` / `nlt-<域>-update` 等独立 `bin` 文件。
 
 ---
 

install.sh

@@ -264,7 +264,7 @@ do_install_or_update() {
   LIBEXEC="${NLTDEPLOY_ROOT}/libexec/nltdeploy"
   mkdir -p "${NLTDEPLOY_ROOT}/bin" "${LIBEXEC}" \
     "${NLTDEPLOY_ROOT}/share/nltdeploy" "${NLTDEPLOY_ROOT}/etc/nltdeploy"
-  mkdir -p "${LIBEXEC}/pip-sources" "${LIBEXEC}/python-env" \
+  mkdir -p "${LIBEXEC}/pip-sources" "${LIBEXEC}/python-env" "${LIBEXEC}/build" \
     "${LIBEXEC}/airflow" "${LIBEXEC}/celery" "${LIBEXEC}/utils" "${LIBEXEC}/github-net" \
     "${LIBEXEC}/paperclip" "${LIBEXEC}/code-server" "${LIBEXEC}/new-api" \
     "${LIBEXEC}/services" \
@@ -300,6 +300,16 @@ do_install_or_update() {
     "${SCRIPTS}/tools/github-net/setup.sh" \
     "${SCRIPTS}/github-net/setup.sh"
 
+  _nlt_cp_first "${LIBEXEC}/build/setup.sh" \
+    "${SCRIPTS}/tools/build/setup.sh" \
+    "${SCRIPTS}/build/setup.sh"
+
+  if [[ -f "${SCRIPTS}/tools/build/nltbuild_core.py" ]]; then
+    cp -f "${SCRIPTS}/tools/build/nltbuild_core.py" "${LIBEXEC}/build/nltbuild_core.py"
+  else
+    die "找不到 ${SCRIPTS}/tools/build/nltbuild_core.py"
+  fi
+
   _nlt_cp_first "${LIBEXEC}/paperclip/setup.sh" \
     "${SCRIPTS}/services/paperclip/setup.sh" \
     "${SCRIPTS}/paperclip/setup.sh" \
@@ -324,23 +334,21 @@ do_install_or_update() {
   _emit_wrapper nlt-python-env python-env/setup.sh
   _emit_wrapper nlt-utils utils/setup.sh
   _emit_wrapper nlt-github-net github-net/setup.sh
+  _emit_wrapper nlt-build build/setup.sh
   _emit_wrapper nlt-services services/nlt-services.sh
 
-  _emit_wrapper nlt-airflow-install airflow/setup.sh install
   _emit_wrapper nlt-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-celery celery/setup.sh
-
-  _emit_wrapper nlt-paperclip-install paperclip/setup.sh install
   _emit_wrapper nlt-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-new-api-install new-api/setup.sh install
   _emit_wrapper nlt-new-api new-api/setup.sh
+  rm -f \
+    "${NLTDEPLOY_ROOT}/bin/nlt-airflow-install" \
+    "${NLTDEPLOY_ROOT}/bin/nlt-celery-install" \
+    "${NLTDEPLOY_ROOT}/bin/nlt-celery-update" \
+    "${NLTDEPLOY_ROOT}/bin/nlt-paperclip-install" \
+    "${NLTDEPLOY_ROOT}/bin/nlt-code-server-install" \
+    "${NLTDEPLOY_ROOT}/bin/nlt-new-api-install"
 
   if [[ "${NLTDEPLOY_SKIP_PROFILE_HINT:-}" != "1" ]]; then
     echo ""

scripts/services/nlt-services.sh

@@ -231,11 +231,11 @@ _dispatch_install_or_remove() {
   fi
 
   case "$name" in
-    airflow) exec "${NLT_BIN}/nlt-airflow-install" ;;
-    celery) exec "${NLT_BIN}/nlt-celery-install" ;;
-    paperclip) exec "${NLT_BIN}/nlt-paperclip-install" ;;
-    code-server) exec "${NLT_BIN}/nlt-code-server-install" ;;
-    new-api) exec "${NLT_BIN}/nlt-new-api-install" ;;
+    airflow) exec "${NLT_BIN}/nlt-airflow" install ;;
+    celery) exec "${NLT_BIN}/nlt-celery" install ;;
+    paperclip) exec "${NLT_BIN}/nlt-paperclip" install ;;
+    code-server) exec "${NLT_BIN}/nlt-code-server" install ;;
+    new-api) exec "${NLT_BIN}/nlt-new-api" install ;;
     pip-sources) exec "${NLT_BIN}/nlt-pip-sources" ;;
     python-env) exec "${NLT_BIN}/nlt-python-env" ;;
     utils) exec "${NLT_BIN}/nlt-utils" ;;

tests/install_smoke.sh

@@ -9,19 +9,23 @@ export NLTDEPLOY_SKIP_GIT_PULL=1
 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-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
+  nlt-pip-sources nlt-python-env nlt-utils nlt-github-net nlt-build nlt-services \
+  nlt-airflow nlt-celery nlt-paperclip nlt-code-server nlt-new-api
 do
   [[ -x "${NLTDEPLOY_ROOT}/bin/${f}" ]] || { echo "missing: bin/${f}" >&2; exit 1; }
   bash -n "${NLTDEPLOY_ROOT}/bin/${f}" || exit 1
 done
+for bad in \
+  nlt-airflow-install \
+  nlt-celery-install nlt-celery-update \
+  nlt-paperclip-install nlt-code-server-install nlt-new-api-install
+do
+  [[ -e "${NLTDEPLOY_ROOT}/bin/${bad}" ]] && { echo "unexpected deprecated bin/${bad}" >&2; exit 1; }
+done
 bash -n "${NLTDEPLOY_ROOT}/libexec/nltdeploy/airflow/setup.sh" || exit 1
 bash -n "${NLTDEPLOY_ROOT}/libexec/nltdeploy/code-server/setup.sh" || exit 1
 bash -n "${NLTDEPLOY_ROOT}/libexec/nltdeploy/new-api/setup.sh" || exit 1
 bash -n "${NLTDEPLOY_ROOT}/libexec/nltdeploy/services/nlt-services.sh" || exit 1
+python3 -m py_compile "${NLTDEPLOY_ROOT}/libexec/nltdeploy/build/nltbuild_core.py" || exit 1
 "${NLTDEPLOY_ROOT}/bin/nlt-services" status --no-http >/dev/null || exit 1
 echo "install_smoke OK"