@coze-arch/cli 0.0.36-alpha.102c95 → 0.0.36-alpha.15544e

package/README.md

@@ -69,12 +69,15 @@ build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Fil
 
 ## 部署
 
-`coze-dev deploy` 内置于同一 CLI，登录态默认保存在 `~/.coze/cli/config.json`：
+`coze-dev deploy` 内置于同一 CLI。认证优先读取
+`~/.coze/desktop/runtime.beta.json`，其次读取 `~/.coze/desktop/runtime.json`；
+CLI 会依次验证候选 Token，收到 401 时继续尝试下一项，再回退到
+`COZE_API_TOKEN` 和 `~/.coze/cli/config.json` 登录态：
 
 ```bash
 coze-dev deploy auth login
 coze-dev deploy doctor
-coze-dev deploy code deploy --source-root . --yes --wait
+coze-dev deploy --source-root . --yes --wait
 ```
 
 完整的应用、环境变量、Pages 和小程序命令说明见 [部署文档](./docs/deploy.md)。

package/docs/deploy.md

@@ -1,7 +1,16 @@
 # coze-dev deploy
 
-`coze-dev` 内置的部署命令，复用主 Coze CLI 保存在
-`~/.coze/cli/config.json` 中的登录状态。
+`coze-dev` 内置的部署命令。认证凭据按以下优先级读取：
+
+1. `~/.coze/desktop/runtime.beta.json` 的 `patToken.accessToken`
+2. `~/.coze/desktop/runtime.json` 的 `patToken.accessToken`
+3. 非空环境变量 `COZE_API_TOKEN`
+4. 主 Coze CLI 保存在 `~/.coze/cli/config.json` 中的登录状态
+
+桌面运行时文件不存在、不可读、JSON 无效或 Token 字段缺失、为空时，CLI
+静默尝试下一来源。固定 Token 会在单次 CLI 进程首次使用时依次验证；候选返回
+401 时继续尝试下一来源，其他网络或服务端错误不会被误判成 Token 无效。选中的
+Token 在本次进程内复用，不输出或持久化。
 
 ## 安装与运行
 
@@ -31,8 +40,8 @@ coze-dev deploy doctor
 `x-tt-env` 和 `x-use-ppe: 1`，该参数只对当前命令生效：
 
 ```bash
-coze-dev deploy --lane ppe_deploy code app list
-coze-dev deploy --lane ppe_deploy code deploy --source-root .
+coze-dev deploy --lane ppe_deploy app list
+coze-dev deploy --lane ppe_deploy --source-root .
 ```
 
 ## 命令
@@ -42,22 +51,22 @@ coze-dev deploy context show
 coze-dev deploy auth login|status|logout
 coze-dev deploy context use --space-id <space_id>
 coze-dev deploy doctor
-coze-dev deploy code app list [--page-size <n>] [--page-token <token>] [--all]
-coze-dev deploy code app show --app-id <app_id>
-coze-dev deploy code app rename <name> --app-id <app_id> --yes
-coze-dev deploy code app delete --app-id <app_id> --yes
-coze-dev deploy code app analytics|metrics --app-id <app_id> [--time-range <range>]
-coze-dev deploy code app usage --app-id <app_id> --bill-month <YYYY-MM>
-coze-dev deploy [--lane <ppe_lane>] code deploy [--source-root <directory>] [--app-id <app_id>] [--application-type <type>] [--name <name>] [--connector-id <id>]
-coze-dev deploy code deploy status|list|online|rollback-check|cancel|rollback|stop|resume|pause
-coze-dev deploy code deploy logs|log-count|count|build-log|config
-coze-dev deploy code domain list [--unit-type dev|prod]
-coze-dev deploy code domain add <domain>
-coze-dev deploy code domain set-prefix <prefix> --app-id <app_id> --yes
-coze-dev deploy code mini-program status|bind|submit-code|unbind|auth|preview
+coze-dev deploy app list [--page-size <n>] [--page-token <token>] [--all]
+coze-dev deploy app show --app-id <app_id>
+coze-dev deploy app rename <name> --app-id <app_id> --yes
+coze-dev deploy app delete --app-id <app_id> --yes
+coze-dev deploy app analytics|metrics --app-id <app_id> [--time-range <range>]
+coze-dev deploy app usage --app-id <app_id> --bill-month <YYYY-MM>
+coze-dev deploy [--lane <ppe_lane>] [--source-root <directory>] [--app-id <app_id>] [--application-type <type>] [--name <name>] [--connector-id <id>]
+coze-dev deploy status|list|online|rollback-check|cancel|rollback|stop|resume|pause
+coze-dev deploy logs|log-count|count|build-log|config
+coze-dev deploy domain list [--unit-type dev|prod]
+coze-dev deploy domain add <domain>
+coze-dev deploy domain set-prefix <prefix> --app-id <app_id> --yes
+coze-dev deploy mini-program status|bind|submit-code|unbind|auth|preview
 ```
 
-`code app list` 是真分页：一次只返回一页（`--page-size` 默认 20、上限 100），`has_more` 为真时用返回的 `next_page_token` 取下一页；要一次拿到名下全部应用用 `--all`，它会自己翻到底。
+`app list` 是真分页：一次只返回一页（`--page-size` 默认 20、上限 100），`has_more` 为真时用返回的 `next_page_token` 取下一页；要一次拿到名下全部应用用 `--all`，它会自己翻到底。
 
 部署确认阶段不传 `--yes`；确认后使用相同参数增加 `--yes`，需要等待终态时再增加
 `--wait`。CLI 会为每次请求自动生成一个 40 位十六进制源码快照 ID，用于兼容 V2 接口的
@@ -85,8 +94,8 @@ Pages 首次部署没有 `app_id`，必须显式指定交付类型。Pages 将
 执行 `deploy.build`，并要求最终产出 `out/index.html`：
 
 ```bash
-coze-dev deploy code deploy --source-root . --application-type pages
-coze-dev deploy code deploy --source-root . --application-type pages --yes --wait
+coze-dev deploy --source-root . --application-type pages
+coze-dev deploy --source-root . --application-type pages --yes --wait
 ```
 
 创建成功后 CLI 会把 Pages Application 写入 `.coze`；后续可继续传
@@ -109,28 +118,28 @@ V2 接口的所有参数均通过 POST JSON body 发送，不会放入 URL。确
 通过 `app_id` 查看当前线上版本的环境变量及快照状态：
 
 ```bash
-coze-dev deploy code env list
-coze-dev deploy code env list --app-id 7672644451805691910
+coze-dev deploy env list
+coze-dev deploy env list --app-id 7672644451805691910
 ```
 
 小程序部署可重复指定渠道：微信为 `10000127`，抖音为 `10000126`：
 
 ```bash
-coze-dev deploy code deploy --source-root . --application-type mini_program \
+coze-dev deploy --source-root . --application-type mini_program \
   --connector-id 10000127 --yes --wait
 ```
 
 小程序预览先完成授权，再执行 preview。preview 会打包微信的 dist/ 或抖音的 dist-tt/ 并上传。Project ID 可通过参数传入或从 .coze 自动读取。
 
 ```bash
-coze-dev deploy code mini-program auth --platform wechat --mini-app-id wx123 --source-root .
-coze-dev deploy code mini-program preview --platform wechat --mini-app-id wx123 --source-root .
+coze-dev deploy mini-program auth --platform wechat --mini-app-id wx123 --source-root .
+coze-dev deploy mini-program preview --platform wechat --mini-app-id wx123 --source-root .
 ```
 
 绑定小程序 AppID 时，默认从源码目录 `.coze [project]` 读取该目录的 `project_id`：
 
 ```bash
-coze-dev deploy code mini-program bind \
+coze-dev deploy mini-program bind \
   --platform wechat \
   --mini-app-id wx123 \
   --redirect-url https://code.coze.cn/coding/auth/callback/miniprogram
@@ -139,34 +148,34 @@ coze-dev deploy code mini-program bind \
 返回 `bind_status=1` 时，打开 `need_authorize_data.auth_url` 完成授权。回调页会自动
 提交授权码；无回调页的调用方也可使用 `mini-program submit-code` 手动提交。
 
-`code deploy status` 和 `list` 会返回 `deploy_detail[].deploy_log_key`。只有一个日志
-key 时，`code deploy build-log --deploy-id <id>` 会自动解析；存在多个 key 时按错误
+`deploy status` 和 `list` 会返回 `deploy_detail[].deploy_log_key`。只有一个日志
+key 时，`deploy build-log --deploy-id <id>` 会自动解析；存在多个 key 时按错误
 详情中的 `available_keys` 选择一个并传 `--key`。
 
 应用维度的管理和观测命令均支持 `--app-id`；省略时从当前目录的 `.coze [project]` 读取：
 
 ```bash
-coze-dev deploy code app rename "新应用名称" --app-id <app_id> --yes
-coze-dev deploy code deploy online --app-id <app_id>
-coze-dev deploy code deploy rollback-check --app-id <app_id> --deploy-id <history_id>
-coze-dev deploy code deploy log-count --app-id <app_id>
-coze-dev deploy code deploy count --app-id <app_id>
-coze-dev deploy code app metrics --app-id <app_id> --time-range week
-coze-dev deploy code app usage --app-id <app_id> --bill-month 2026-08
-coze-dev deploy code domain list --app-id <app_id> --unit-type dev
+coze-dev deploy app rename "新应用名称" --app-id <app_id> --yes
+coze-dev deploy online --app-id <app_id>
+coze-dev deploy rollback-check --app-id <app_id> --deploy-id <history_id>
+coze-dev deploy log-count --app-id <app_id>
+coze-dev deploy count --app-id <app_id>
+coze-dev deploy app metrics --app-id <app_id> --time-range week
+coze-dev deploy app usage --app-id <app_id> --bill-month 2026-08
+coze-dev deploy domain list --app-id <app_id> --unit-type dev
 ```
 
 `domain list` 默认查询 Prod 域名；传 `--unit-type dev` 查询开发态预览域名。
 审核 Unit 是内部流水线槽位，不支持从 CLI 查询。
 
-`code domain set-prefix` 改的是**系统分配的默认域名**（`<prefix>.coze.site`）里的 prefix，
-后缀不变；`code domain add` 加进来的自定义域名不受影响 —— 那类域名服务端只有 create/delete，
+`domain set-prefix` 改的是**系统分配的默认域名**（`<prefix>.coze.site`）里的 prefix，
+后缀不变；`domain add` 加进来的自定义域名不受影响 —— 那类域名服务端只有 create/delete，
 域名串本身改不了。改完旧默认域名立刻不再指向本应用，已经发出去的链接会失效，所以必须传 `--yes`。
 前缀的长度、保留词、是否被占用由服务端判定，CLI 只拦形态明显不合法的值（大写、首尾连字符等）。
 这是**权益能力**：账号没有对应权益时服务端会直接拒绝。
 
-`code app delete` 删除应用，终态不可撤销，必须传 `--yes`。服务端**只接受已停服的应用**：
-仍在服务时会返回一条带当前状态的错误，先跑 `code deploy stop --yes` 再删。CLI 不会替你先停 ——
+`app delete` 删除应用，终态不可撤销，必须传 `--yes`。服务端**只接受已停服的应用**：
+仍在服务时会返回一条带当前状态的错误，先跑 `deploy stop --yes` 再删。CLI 不会替你先停 ——
 停服会真的把线上服务摘掉，那一步要由你自己确认。删除会一并停掉该应用名下的部署单元、
 软删它的域名并清理残留的函数；已删除的应用再删一次是幂等成功。删完记得把 `.coze [project]`
-里的 `app_id` 去掉，否则同目录下一次 `code deploy` 会打到这个已删除的应用上被服务端拒。
+里的 `app_id` 去掉，否则同目录下一次 `deploy` 会打到这个已删除的应用上被服务端拒。

package/lib/__templates__/expo/.cozeproj/scripts/dev_run.sh

@@ -16,7 +16,12 @@ EXPO_HOST="0.0.0.0"
 EXPO_DIR="expo"
 # DEPLOY_RUN_PORT 是平台注入的对外端口，EXPO_PORT 保留为本地覆盖项。
 EXPO_PORT="${DEPLOY_RUN_PORT:-${EXPO_PORT:-<%= port %>}}"
-WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
+COZE_HARDWARE_DID="${COZE_HARDWARE_DID:-}"
+if [ -n "${EXPO_PORT:-}" ] && [ -n "${COZE_HARDWARE_DID}" ]; then
+  WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-https://cozedaemon-${COZE_HARDWARE_DID}-${EXPO_PORT}.dev.coze.site}"
+else
+  WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
+fi
 ASSUME_YES="1"
 EXPO_PUBLIC_BACKEND_BASE_URL="${EXPO_PUBLIC_BACKEND_BASE_URL:-$WEB_URL}"
 EXPO_PUBLIC_COZE_PROJECT_ID="${COZE_PROJECT_ID:-}"
@@ -117,14 +122,41 @@ wait_port_connectable() {
   return 1
 }
 
+# detached 出去的进程没人负责回收，超过这个时长就自己退出，避免端口与内存长期泄露。
+MAX_RUNTIME_SECONDS=1200
+
+# 真正被 detach 的是这层 bash wrapper：它是进程组 leader，组内 watchdog 到点回收整组
+# （wrapper -> pnpm -> expo/node）；被包的进程自己先退出时也顺手清空进程组，不留残余。
+RUN_WITH_TIMEOUT='
+timeout_seconds=$1
+shift
+
+"$@" &
+child_pid=$!
+
+# 先忽略 TERM，才能在向整组发 TERM（自己也在组里）之后存活下来补一发 KILL。
+( trap "" TERM
+  sleep "${timeout_seconds}"
+  echo "[dev] 后台进程运行超过 ${timeout_seconds}s，回收进程组 $$。"
+  kill -TERM -- "-$$" 2>/dev/null || true
+  sleep 5
+  kill -KILL -- "-$$" 2>/dev/null || true
+) &
+
+wait "${child_pid}"
+kill -KILL -- "-$$" 2>/dev/null || true
+'
+
 # coze-daemon 会在 runtime shell 退出时清理原进程组。
 # 通过 Node detached spawn 创建独立 session/进程组，并将 stdio 直接写入日志。
+# 返回的 PID 是 wrapper 的，同时也是整个进程组的 PGID，后续按组回收。
 spawn_detached() {
   local cwd="$1"
   local log_file="$2"
   shift 2
 
-  node - "$cwd" "$log_file" "$@" <<'NODE'
+  node - "$cwd" "$log_file" \
+    /bin/bash -c "${RUN_WITH_TIMEOUT}" detached-runner "${MAX_RUNTIME_SECONDS}" "$@" <<'NODE'
 const fs = require('node:fs');
 const { spawn } = require('node:child_process');
 
@@ -258,6 +290,7 @@ if [ -z "${EXPO_PID}" ]; then
 fi
 
 echo "所有服务已启动。Server PID: ${SERVER_PID}, Expo PID: ${EXPO_PID}"
+echo "两个服务均在 ${MAX_RUNTIME_SECONDS}s 后自动退出。"
 
 echo "检查 Server 服务端口：$SERVER_HOST:$SERVER_PORT"
 if wait_port_connectable "$SERVER_HOST" "$SERVER_PORT" 10 2; then

package/lib/__templates__/expo/pnpm-lock.yaml

@@ -269,8 +269,8 @@ importers:
         specifier: ^2.8.5
         version: 2.8.6
       coze-coding-dev-sdk:
-        specifier: ^0.7.25-beta.4
-        version: 0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
+        specifier: ^0.7.25-beta.8
+        version: 0.7.25-beta.8(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
       dayjs:
         specifier: ^1.11.20
         version: 1.11.20
@@ -2643,8 +2643,8 @@ packages:
     resolution: {integrity: sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA==}
     engines: {node: '>=10'}
 
-  coze-coding-dev-sdk@0.7.25-beta.4:
-    resolution: {integrity: sha512-+PCoJ8yhsAIlx3YT898bCkB2gx5EMBunJMP7/kI/Jq/8dj7SDU9EUBZ2Z8ZJocSaPBT9T6dVvFHBsDLZh4FN/Q==}
+  coze-coding-dev-sdk@0.7.25-beta.8:
+    resolution: {integrity: sha512-RSKlXCO0W/OPDjx9D9JICn2cGeOJw3iG+y0Pr1AhAf7YdAjjNbBZoG7qfg0Zg2SqgaVN2qSLQFmKPbhNq9ZWSg==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -9088,7 +9088,7 @@ snapshots:
       path-type: 4.0.0
       yaml: 1.10.2
 
-  coze-coding-dev-sdk@0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
+  coze-coding-dev-sdk@0.7.25-beta.8(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
     dependencies:
       '@langchain/core': 1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6))
       '@langchain/openai': 1.2.3(@langchain/core@1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6)))(ws@8.19.0)

package/lib/__templates__/expo/server/package.json

@@ -12,7 +12,7 @@
   "dependencies": {
     "@supabase/supabase-js": "2.95.3",
     "cors": "^2.8.5",
-    "coze-coding-dev-sdk": "^0.7.25-beta.4",
+    "coze-coding-dev-sdk": "^0.7.25-beta.8",
     "dayjs": "^1.11.20",
     "dotenv": "^17.2.3",
     "drizzle-orm": "^0.45.1",

package/lib/__templates__/nextjs/package.json

@@ -47,7 +47,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "coze-coding-dev-sdk": "^0.7.16",
+    "coze-coding-dev-sdk": "^0.7.25-beta.8",
     "date-fns": "^4.1.0",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
@@ -56,7 +56,7 @@
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
     "lucide-react": "^0.468.0",
-    "next": "16.1.1",
+    "next": "16.3.3",
     "next-themes": "^0.4.6",
     "pg": "^8.16.3",
     "react": "19.2.3",
@@ -80,7 +80,7 @@
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "16.1.1",
+    "eslint-config-next": "16.3.3",
     "only-allow": "^1.2.2",
     "react-dev-inspector": "^2.0.1",
     "shadcn": "latest",