DeskClaw 发版与部署

触发后的工作流程

1. 解析用户意图

从用户消息中提取以下参数：

注意："部署当前分支"、"部署本地分支"只表示把当前工作树构建为镜像并部署，不等于发版授权。除非用户明确要求"发版"、"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 参数速查

镜像仓库规则

• get_component_registry("admin") → $REGISTRY（私有，EE 专用）
• get_component_registry("其他") → $PUBLIC_REGISTRY（公开）或回退 $REGISTRY
• 配置位于 deploy/.env.local（不进 git）

Release Note / 公告称呼规则

• 对外 Release Note、群聊公告和发布摘要中，首次出现必须写成“DeskClaw 团队版 <version>”。
• 禁止写成“个人版”，也禁止省略“团队版”导致对外产品定位错误。
• 后文如需简称，必须先完整出现一次“DeskClaw 团队版”。