nodeskai DeskClaw 发版与部署
触发后的工作流程
1. 解析用户意图
从用户消息中提取以下参数：
| 参数 | 如何判断 | 默认值 |
|---|---|---|
| 操作类型 | release / deploy / promote | 必须明确 |
| 版本号 | 用户指定（如 v0.9.8-beta.1） | release/promote 必须指定 |
| CE/EE | 用户说"EE"或"含 admin" → --ee |
CE（不加 --ee） |
| 镜像源 | 用户说"国内源"/"mirrors"/"cn" → --mirrors cn |
不加 |
| 目标环境 | staging（默认）/ 生产（--prod） |
staging |
| 部署目标 | all / backend / admin / portal / proxy | all |
| 仅发版 | 用户说"只发版不部署" → 只运行 release.sh create |
否 |
| 仅部署 | 用户说"不重新构建" → 只运行 deploy.sh deploy --tag <version> |
否 |
| 本地分支部署 | 用户说"当前分支/本地分支部署" → 使用分支用途镜像 tag，禁止创建 git tag/GitHub Release | 否 |
注意："部署当前分支"、"部署本地分支"只表示把当前工作树构建为镜像并部署，不等于发版授权。除非用户明确要求"发版"、"release"、"创建 tag"或"GitHub Release"，不得调用 deploy/release.sh create，不得创建或推送 git tag，不得创建 GitHub Release。
2. 前置检查（只读命令，直接执行）
git status --short # 未提交变更
git tag -l '<version>*' # tag 是否已存在
git log --oneline -1 # 最新 commit
EE 模式额外检查：
ls -d ee/ 2>/dev/null # ee/ 目录存在
cd ee && git status --short # EE 仓库状态
3. 输出操作确认清单
按以下格式输出。如果用户已经在同一请求中明确授权 AI 执行发版/部署，则可以直接执行；否则只给出可粘贴命令，等用户自己运行。
**发版目标**：<版本号> <CE/EE> <Pre-release/正式>
**当前状态**：
- CE 仓库：<干净/有未提交变更>
- EE 仓库：<干净/有未提交变更>（仅 EE 模式）
- 最新 commit：<hash> <message>
- tag <版本号>：<不存在/已存在>
**即将执行**：
| 步骤 | 命令 | 说明 |
|---|---|---|
| 1 | `./deploy/release.sh ...` | ... |
| 2 | `./deploy/deploy.sh ...` | ...（如有） |
**镜像分发**：
- backend/portal/proxy → <PUBLIC_REGISTRY 或 REGISTRY>
- admin → <REGISTRY>（仅 EE）
未授权 AI 执行时，请用户在终端运行以上命令。
重要：默认不得通过 Shell 工具运行 deploy/release.sh、deploy/deploy.sh、deploy/init.sh。只有用户在同一请求中明确授权 AI 执行发版/部署时，才允许运行；执行时必须显式带上 --context 和目标环境标志（--staging / --prod）。
常见场景速查
场景 A：EE Pre-release（如本次 v0.9.8-beta.1）
# 1. 发版（构建镜像 + git tag + GitHub Pre-release）
./deploy/release.sh create <version> --ee --mirrors cn
# 2. 部署到生产（需用户明确授权）
./deploy/deploy.sh deploy all --tag <version> --ee --prod --context <CTX>
场景 B：CE Pre-release
./deploy/release.sh create <version> --mirrors cn
场景 C：日常部署到生产
./deploy/deploy.sh deploy all --tag <version> --prod --context <CTX> # CE
./deploy/deploy.sh deploy all --tag <version> --ee --prod --context <CTX> # EE
./deploy/deploy.sh deploy backend --tag <version> --prod --context <CTX> # 只部署后端
场景 D：部署指定版本（不重新构建）
./deploy/deploy.sh deploy all --tag <version> --prod --context <CTX> # 生产
./deploy/deploy.sh deploy all --tag <version> --staging --context <CTX> # 可选临时 staging
场景 E：正式发布
./deploy/deploy.sh deploy all --tag <version> --prod --context <CTX>
./deploy/release.sh finalize <version>
CLI 参数速查
| 参数 | 作用 | 适用命令 |
|---|---|---|
--ee |
EE 模式（含 admin + ee/ 代码注入） | deploy, release |
--mirrors cn |
国内镜像源加速构建 | deploy, release |
--prod |
部署到生产环境 | deploy |
--tag <tag> |
指定镜像标签 | deploy |
create |
构建推送镜像、创建 git tag 和 GitHub Pre-release | release.sh |
finalize |
将 GitHub Release 标记为正式版 | release.sh |
--skip-proxy |
跳过 proxy 组件 | deploy, release |
--no-cache |
Docker 不使用缓存 | deploy, release |
--force |
跳过 Secret 差异确认 | init |
镜像仓库规则
get_component_registry("admin")→$REGISTRY（私有，EE 专用）get_component_registry("其他")→$PUBLIC_REGISTRY（公开）或回退$REGISTRY- 配置位于
deploy/.env.local（不进 git）
Release Note / 公告称呼规则
- 对外 Release Note、群聊公告和发布摘要中，首次出现必须写成“DeskClaw 团队版 ”。
- 禁止写成“个人版”，也禁止省略“团队版”导致对外产品定位错误。
- 后文如需简称，必须先完整出现一次“DeskClaw 团队版”。