@my-life-buddies/cli 0.19.0 → 0.21.1

package/README.md

@@ -4,7 +4,7 @@
 
 这份说明按一次开发过程展开：登记搭子，准备工程，在本地预览，然后上传程序包。所有搭子统一使用 `@my-life-buddies/buddy-runtime`，业务能力通过 Prompt、`src/buddy-options.mjs` 和 Tool 实现。
 
-新建工程动态查询公共 npm 的最新 Runtime，并写入准确版本与锁文件；查询或锁文件生成失败时停止，不回退旧版本。版本选择与联调范围见 [Runtime 集成说明](../../docs/runtime-integration.md)。
+默认平台的新建工程动态查询公共 npm 的最新稳定版 Runtime，并写入准确版本与锁文件；查询或锁文件生成失败时停止，不回退旧版本。版本选择与联调范围见 [Runtime 集成说明](../../docs/runtime-integration.md)。
 
 ## 准备 CLI 和平台地址
 
@@ -49,7 +49,7 @@ buddy-cli update
 
 从 CLI 0.17.0 起，每条正常命令（含 `guide` 和无参数入口）先查询公共 npm `latest`，当前版本落后时自动更新，并由新版执行原命令。无需手动先运行 `update`，等待当前命令完成即可。更新发生在创建工程、领取凭据、启动 DEV 或上传之前；保留参数、工作目录、终端输入输出和退出状态，一次调用最多自动切换一次。版本相同或更高时继续执行，不降级；已经运行的 DEV 不因新版本发布而中断。
 
-全局安装更新当前 npm 环境中对应的 CLI；源码、`npm link`、项目内安装和 `npx` 自动下载准确版本到 `~/.cache/buddy-cli/updates/releases/`，从缓存运行，不改写原安装或工程依赖。并发更新共用安装锁。手动 `update` 仍只用于 npm 全局安装。查询最多等待 10 秒，安装最多等待 180 秒；失败或取消时停止原业务命令，不回退旧版。帮助、各命令 `--help`、`--version` 和应急清理命令 `dev stop` 不联网更新。自动更新进度写入 stderr，不混入业务命令的 stdout 或 JSON；更新失败时 `--json` 返回 `code=CLI_UPDATE_FAILED` 和 `error`。
+全局安装更新当前 npm 环境中对应的 CLI；源码、`npm link`、项目内安装和 `npx` 自动下载准确版本到 `~/.cache/buddy-cli/updates/releases/`，从缓存运行，不改写原安装或工程依赖。并发更新共用安装锁。手动 `update` 仍只用于 npm 全局安装。查询最多等待 10 秒，安装（含重试）最多等待 180 秒。安装通过 `--prefer-online` 刷新 npm 版本缓存；找不到版本（`ETARGET`）时最多重试一次，始终安装本次自检查到的准确版本。仍失败时说明 npm 的具体原因，不展示日志路径，也不修改用户的 npm 配置或清空缓存；失败或取消时停止原业务命令，不回退旧版。帮助、各命令 `--help`、`--version` 和应急清理命令 `dev stop` 不联网更新。自动更新进度写入 stderr，不混入业务命令的 stdout 或 JSON；更新失败时 `--json` 返回 `code=CLI_UPDATE_FAILED` 和 `error`。
 
 更新只针对 CLI，已有工程的 Runtime 依赖、锁文件和业务适配仍需另行修改与验证。旧 CLI 不会自动获得自检能力，需要先用 npm 安装命令升级一次。
 
@@ -75,17 +75,17 @@ npm publish --workspace @my-life-buddies/cli
 
 版本维护：每批修改 CLI 发布内容时递增一次版本，默认 patch；根包和内部工作区版本、依赖引用、锁文件一起更新。Agent 工程自己的项目版本独立。升级 Runtime 时同步模板依赖与模板锁文件，并运行独立安装验收。
 
-CLI 默认连接 MLB 测试环境 `http://47.116.168.81:8788`，不必先配置地址：
+CLI 默认连接 MLB 测试环境 `https://47.116.168.81`，不必先配置地址：
 
 ```bash
 buddy-cli login
 ```
 
-这是实际 test 环境，不是演示数据。当前测试入口使用 HTTP，登录凭证和对话内容未加密传输，仅用于测试；只有这个固定 origin 被允许使用远程 HTTP，不会放开其他 IP、端口或相似域名。后续有 HTTPS 入口时替换默认值。手机 App 需要连接同一环境。
+这是实际 test 环境，使用 HTTPS；其他远程平台同样要求 HTTPS，HTTP 仅用于本机 loopback 联调。手机 App 需要连接同一环境。
 
 CLI 会打开搭搭创作者平台网页完成登录和授权。浏览器已有有效 Cookie 时，页面直接显示当前账号，开发者确认后即可返回终端；没有登录时，先在同一网页完成短信登录，再确认授权。CLI 不读取浏览器 Cookie，也拿不到短信验证码，只通过本机回调收到一次性授权码，再换取自己的会话。
 
-CLI 会把换取到的会话保存到 macOS Keychain。有效会话会复用，不必每条命令都重新登录；切换服务器 origin（协议、主机或端口）后，使用另一份凭据，不把原服务器的 Token 发过去。开发者平台网页默认使用 `https://47.116.168.81/developer/`；本地联调其他 Web 时可设置 `BUDDY_DEVELOPER_WEB_URL`，远程地址必须使用 HTTPS。
+CLI 会把换取到的会话保存到 macOS Keychain。有效会话会复用，不必每条命令都重新登录；切换服务器 origin（协议、主机或端口）后，使用另一份凭据，不把原服务器的 Token 发过去。开发者平台网页自动使用当前网关域名下的 `/developer/`。显式设置 `BUDDY_DEVELOPER_WEB_URL` 或 `preview --developer-web` 时，必须与网关同源，否则在联网前报错；本地静态页面联调也需通过同一入口代理 MLB API。
 
 旧版没有标记服务器归属的钥匙串记录不会自动复用或删除；升级后需要重新登录一次。
 
@@ -337,9 +337,9 @@ buddy-cli meta update --buddy-id b_example --name "川大厨" --avatar ./avatar.
 buddy-cli models
 ```
 
-不必先创建工程。无论是否在工程内，CLI 每次查询公共 npm latest，把对应 Runtime 缓存到 `~/.cache/buddy-cli/runtimes/<版本>` 并读取枚举；同版本复用缓存，不修改工程依赖。查询或下载失败时明确报错，不把旧缓存称为最新版。两个目录命令的 `--json` 返回 `source`（固定为 `npm`）、`runtimeVersion`、目录，以及 `projectRuntimeVersion`、`latestRuntimeVersion`、`versionStatus`、`adaptationRequired`。版本状态为 `no_project`、`unconfigured`、`current`、`update_available` 或 `project_ahead`；没有准确工程版本时返回 `null`，工程未锁定版本或版本与 npm latest 不一致时需要适配。提示输出到 stderr，stdout 保持纯 JSON。
+默认平台不必先创建工程。无论是否在工程内，CLI 每次查询公共 npm latest，把对应 Runtime 缓存到 `~/.cache/buddy-cli/runtimes/<版本>` 并读取枚举；同版本复用缓存，不修改工程依赖。查询或下载失败时明确报错，不把旧缓存称为最新版。两个目录命令的 `--json` 返回 `source`（固定为 `npm`）、`runtimeVersion`、目录，以及 `projectRuntimeVersion`、`latestRuntimeVersion`、`versionStatus`、`adaptationRequired`。版本状态为 `no_project`、`unconfigured`、`current`、`update_available` 或 `project_ahead`；没有准确工程版本时返回 `null`，工程未锁定版本或版本与 npm latest 不一致时需要适配。提示输出到 stderr，stdout 保持纯 JSON。
 
-在已有工程执行 `buddy-cli`、`init` 或打开 `preview` 时检查更新并提示适配，但允许继续编辑工程。`dev`、Preview 中每次启动 DEV、文件自动重载，以及 `push` 必须联网查询 npm 最新稳定版，工程声明及实际安装版本必须与本次查询结果完全一致；不接受旧版、超前版、预发布版或范围依赖。查询失败即停止，不使用缓存冒充最新，也没有跳过检查参数。已有 npm 锁文件需与目标版本一致，push 还会按本次查询结果校验实际上传快照及其中的 npm 锁文件。失败信息包含原因和适配提示，CLI 不自动修改工程依赖、模型或数据权限。修复后重新启动；自动重载失败后保存文件可重试。帮助、登录、status、meta 和兼容命令 avatar 不查询 Runtime。
+在已有工程执行 `buddy-cli`、`init` 或打开 `preview` 时检查更新并提示适配，但允许继续编辑工程。默认平台下，`dev`、Preview 中每次启动 DEV、文件自动重载，以及 `push` 必须联网查询 npm 最新稳定版，工程声明及实际安装版本必须与本次查询结果完全一致；不接受旧版、超前版、预发布版或范围依赖。查询失败即停止，不使用缓存冒充最新，也没有跳过检查参数。已有 npm 锁文件需与目标版本一致，push 还会按本次查询结果校验实际上传快照及其中的 npm 锁文件。失败信息包含原因和适配提示，CLI 不自动修改工程依赖、模型或数据权限。修复后重新启动；自动重载失败后保存文件可重试。帮助、登录、status、meta 和兼容命令 avatar 不查询 Runtime。
 
 此限制由本版 CLI 执行，不修改服务端策略或已部署进程；直接运行工程 `npm start`、旧 CLI 或服务端发布入口不受本版 CLI 检查约束。
 
@@ -370,7 +370,7 @@ initialState: {
 }
 ```
 
-新工程生成 `{ "requirements": [] }`。最多 32 项，ID 不能重复；`id`、`purpose` 会去除首尾空白，用途必须为 1～200 字。完整选项由 `buddy-cli datasets [--json]` 从 npm 最新 Runtime 读取，DEV 与 push 使用工程安装的 SDK 校验 ID。
+新工程生成 `{ "requirements": [] }`。最多 32 项，ID 不能重复；`id`、`purpose` 会去除首尾空白，用途必须为 1～200 字。完整选项由 `buddy-cli datasets [--json]` 按当前环境的版本规则读取，DEV 与 push 使用工程安装的 SDK 校验 ID。
 
 Runtime 0.17.0 启动时自动读取该文件，通过 `PUT /internal/v1/data-access/requirements` 登记；文件缺失或空数组会上传空声明，清除旧声明。登记失败阻止启动，不会带着未同步的配置上线。DEV 监听该文件，保存后重启 Runtime 并重新登记。部署环境需提供对应登记接口。
 
@@ -406,7 +406,7 @@ buddy-cli preview --directory ./study-buddy
 - CLI 被强杀、电脑离线或旧版进程无法响应时，网页不能保证本机进程已退出。到原电脑的工程目录执行后台提供的停止指令，例如：
 
 ```bash
-buddy-cli dev stop --buddy-id b_example --app-server http://47.116.168.81:8788
+buddy-cli dev stop --buddy-id b_example --app-server https://47.116.168.81
 ```
 
 `dev stop` 无需登录、查询 npm 或访问平台，支持 `--directory`；按平台和工程 buddyId 查找本机进程。原 CLI 存活时通知它停止监听与 Runtime，原 CLI 已退出时核对进程身份后清理残留；不能确认身份时保留锁并报错，不误杀其他进程。同一搭子从其他目录启动时，应在提示的原工程目录执行。其他电脑的进程需到那台电脑停止。清理后如需调试，重新执行连接指令，再在页面启动 DEV；不会提审或发布。
@@ -435,9 +435,9 @@ Preview 展示平台对话记录、发送与流式输出耗时、会话状态和
 
 ### 从海外服务器回迁阿里云
 
-平台地址为 `http://47.116.168.81:8788`，开发者后台为 <https://47.116.168.81/developer/>。升级 CLI 后重新运行 `buddy-cli login`；海外域名与阿里云 IP 的浏览器 Cookie 和 CLI 登录凭据独立保存，不能直接沿用海外登录态。
+平台地址为 `https://47.116.168.81`，开发者后台为 <https://47.116.168.81/developer/>。升级 CLI 后重新运行 `buddy-cli login`；海外域名与阿里云 IP 的浏览器 Cookie 和 CLI 登录凭据独立保存，不能直接沿用海外登录态。
 
-已有工程先移除或更新终端和 shell 配置中的旧 `BUDDY_APP_SERVER_URL`、`BUDDY_DEV_APP_SERVER_URL`、`BUDDY_DEVELOPER_WEB_URL` 覆盖，再在工程目录运行：
+仅在明确要切回默认外部平台时，移除或更新终端和 shell 配置中的 `MLB_GATEWAY_URL` 及旧 `BUDDY_APP_SERVER_URL`、`BUDDY_DEV_APP_SERVER_URL`、`BUDDY_DEVELOPER_WEB_URL` 覆盖，再在工程目录运行：
 
 ```bash
 buddy-cli login
@@ -450,16 +450,30 @@ DEV 启动前会从阿里云平台重新领取已有开发 Token，并更新 `.e
 
 ### 什么时候需要另一个服务地址
 
-需要平台连接的命令默认使用上述 test 地址。`models` 和 `datasets` 不使用平台地址；始终从公共 npm 查询最新 Runtime 并读取其目录。覆盖顺序如下：
+CLI 与 Runtime 共用 `MLB_GATEWAY_URL`。需要连接其他平台时，在运行 CLI 的终端设置平台提供的地址（仅协议、域名和可选端口，不加 `/cli` 或 `/developer`）：
+
+```bash
+export MLB_GATEWAY_URL=https://platform.example
+buddy-cli login
+buddy-cli preview
+```
+
+将示例地址替换成实际平台地址。设置在当前终端及其子进程中生效；要在新终端保留，可加入已有的 shell 启动配置。Coding Agent 执行 CLI 的进程同样需要继承这个变量；图形应用未必继承另一个终端中的设置。无需新增 `config.json`、工程平台字段或另一份 npm 包。平台地址不影响 CLI 自动更新、Runtime 和 Skill 从公共 npm 下载。
 
 | 命令 | 地址优先级（从高到低） |
 | --- | --- |
-| `login`、`init`、`logout`、`push`、`status` | `BUDDY_APP_SERVER_URL` → `BUDDY_DEV_APP_SERVER_URL` → 默认 test |
-| `dev`、`preview` | `--app-server` → `BUDDY_DEV_APP_SERVER_URL` → `BUDDY_APP_SERVER_URL` → 默认 test |
+| `login`、`init`、`logout`、`meta`、`push`、`status` | `MLB_GATEWAY_URL` → 旧地址配置 → 默认 test |
+| `dev`、`preview`（包括 `dev stop`） | `--app-server` → `MLB_GATEWAY_URL` → 旧地址配置 → 默认 test |
 
-`BUDDY_DEV_APP_SERVER_URL` 保留为开发会话的专用覆盖。如果希望所有命令连接同一环境，只配置 `BUDDY_APP_SERVER_URL` 即可。
+旧配置只在未设置 `MLB_GATEWAY_URL` 时兼容：账号和上传命令依次读取 `BUDDY_APP_SERVER_URL`、`BUDDY_DEV_APP_SERVER_URL`；`dev`、`preview` 顺序相反。新配置只需设置 `MLB_GATEWAY_URL`，它会统一覆盖这两种旧变量。空值、错误地址和跨平台的后台地址会报错，不静默回退。远程平台要求 HTTPS；本机 loopback 允许 HTTP。
 
-这些是地址配置选项，不表示开发版搭子一定运行在另一套域名或独立数据库里。如果特意配置了不同服务器，需要确认搭子属于目标服务器，且该服务器已开放所选模型。除固定 test 入口外，远程服务必须使用 HTTPS；本机 loopback 仍允许 HTTP。
+CLI 根据选定地址打开 `/developer/` 网页、访问 MLB API，并在启动 DEV 时把该地址和开发 Token 写入工程 `.env`。Runtime 通过 Node 加载 `.env` 中的 `MLB_GATEWAY_URL`。CLI 本身不自动加载项目 `.env` 或读取 shell 启动文件来选平台，因此 `login` 和新建工程也能在工程外使用。修改变量仅影响后续命令，不会让正在运行的预览中途切换。
+
+`preview` 在连接前、`dev` 在启动前检查工程 `.env` 的网关。已知旧 ECS 入口 `http://47.116.168.81:8788` 和 `http://47.116.168.81` 统一转向 `https://47.116.168.81`；启动 DEV 时按当前账号和 `package.json.buddyId` 校验归属并领取开发凭据，取得实例锁后再更新 `.env`，保留业务变量和注释。检查失败不改文件。终端会说明旧地址处理方式，后台显示可公开的具体配置错误。
+
+切换平台后，CLI 按服务器 origin 分别保存登录和开发凭据，不向新平台发送旧平台的 Token。工程 `.env` 已绑定其他平台时会阻止复用；确认目标平台和工程归属后，使用 `--refresh-token` 更新开发凭据。搭子 ID、项目和平台上的数据不会自动迁移。使用后台生成的连接或停止指令时保留完整参数，`--app-server` 只覆盖该次命令。
+
+`models` 和 `datasets` 从公共 npm 读取 Runtime 能力，不向平台申请目录或权限；默认平台使用最新稳定版。平台地址与 Runtime 规则以当前终端的 `buddy-cli guide` 输出为准，Coding Agent 应先完成指南要求的必要选择，再继续创建工程；不要用别的环境的指南替代当前输出。
 
 ## 上传程序包，不等于发布
 
@@ -518,7 +532,7 @@ buddy-cli datasets
 buddy-cli datasets --directory ./my-buddy --json
 ```
 
-目录来自 npm 最新 Runtime 的 `DATA_ACCESS_CAPABILITIES`，包括 ID、名称、来源和 Schema 版本。JSON 返回版本信息、适配状态和 `datasets` 数组（字段见上方模型目录说明）。命令不登录、不启动搭子、不申请权限，也不修改配置；从子目录运行会向上找到工程。每次都需要联网检查 latest，下载失败时明确报错，不把旧缓存称为最新版。
+默认平台的目录来自 npm 最新稳定版 Runtime 的 `DATA_ACCESS_CAPABILITIES`，包括 ID、名称、来源和 Schema 版本。JSON 返回版本信息、适配状态和 `datasets` 数组（字段见上方模型目录说明）。命令不登录、不启动搭子、不申请权限，也不修改配置；从子目录运行会向上找到工程。每次都需要联网检查 latest，下载失败时明确报错，不把旧缓存称为最新版。
 
 开发者将实际选择的 ID 和用途写进 `data-access.json.requirements`。JSON Schema 检查形状与用途；DEV 和上传预检按工程安装的 Runtime 检查所选模型与非空数据声明。目录缺失、依赖未安装或版本不匹配时明确报错。Runtime 0.12.2 有 10 项，但单次数据查询仍最多 8 项。
 
@@ -555,3 +569,7 @@ CLI 与 Runtime 统一使用 `package.json.buddyId`。CLI 启动前校验本地
 Runtime 0.19.0 支持在 `schema.json.openTargets` 声明入口。业务通过 `conversation.widget.send(id, { idempotencyKey, openTarget })` 或模型工具发送 `version: 1`、`entry` 以及可选 `resource`、`state`；记录必须已经存在。H5 读取 `window.widget.openTarget` 定位，无目标时显示默认页。
 
 后台和本地模拟器保留每条消息的目标，通过 `POST /app/widgets/:widgetId/presentation` 获取鉴权页面；列表入口不传目标。同一 Widget 的不同卡片、加载重试与 DEV 重载分别保留自己的目标；目标记录删除或权限变化时显示打开失败，不回退默认页。
+
+## CLI 0.20：MLB 统一提供服务
+
+默认平台入口与网页同源，使用 HTTPS。CLI 的一次性浏览器授权走 `/cli/web/authorizations`、`/cli/web/exchange`，预览连接走 `/cli/preview/*`，不再调用独立 Web 服务。网页仍使用 `/developer/`；仅指定平台地址时，后台地址默认取同域名的 `/developer/`。已有地址覆盖需更新到当前平台域名，并重新运行 `buddy-cli login`。两套环境凭据隔离，预览不触发上传或发布。

package/dist/bin/buddy.js

@@ -69,8 +69,8 @@ import {
   CloudAuthenticator,
   BuddyDevError,
   checkRuntimeUpdate,
+  checkProjectGateway,
   DEFAULT_MLB_TEST_URL,
-  DEFAULT_DEVELOPER_WEB_URL,
   HttpDeveloperPlatformClient,
   LoopbackBrowserLoginAdapter,
   MlbDevRegistrationClient,
@@ -82,6 +82,7 @@ import {
   createPushPreflight,
   createPushSourceBundle,
   resolvePlatformUrl,
+  resolveDeveloperWebUrl,
   openExternalUrl,
   requireBuddyAgentProjectRoot
 } from "./core.js";
@@ -104,9 +105,11 @@ var PREVIEW_COMMAND_HELP = `\u7528\u6CD5:
   --local \u662F\u540E\u53F0\u4E0D\u53EF\u7528\u65F6\u7684\u72EC\u7ACB\u672C\u5730\u9884\u89C8\u5907\u7528\u5165\u53E3\uFF0C--port \u4EC5\u4E0E --local \u4E00\u8D77\u4F7F\u7528\u3002
   \u4FDD\u6301\u7EC8\u7AEF\u8FD0\u884C\uFF1BCtrl+C \u6216\u5173\u95ED\u7EC8\u7AEF\u4F1A\u505C\u6B62 DEV \u5E76\u65AD\u5F00\u8FDE\u63A5\uFF0C\u5237\u65B0\u540E\u53F0\u4E0D\u4F1A\u81EA\u52A8\u542F\u52A8 DEV\u3002
   \u540E\u53F0\u53EF\u5F3A\u5236\u65AD\u8FDE\uFF1B\u672C\u673A\u505C\u6B62\u672A\u786E\u8BA4\u65F6\uFF0C\u5728\u539F\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C buddy-cli dev stop\u3002\u8BE5\u547D\u4EE4\u4E0D\u91CD\u8FDE\u3001\u4E0D\u91CD\u542F\u3002
-  \u672A\u914D\u7F6E\u5730\u5740\u65F6\u8FDE\u63A5 MLB \u6D4B\u8BD5\u73AF\u5883 ${DEFAULT_MLB_TEST_URL}\uFF08HTTP \u4EC5\u9650\u6D4B\u8BD5\uFF09\u3002
+  \u672A\u914D\u7F6E\u5730\u5740\u65F6\u8FDE\u63A5 MLB \u6D4B\u8BD5\u73AF\u5883 ${DEFAULT_MLB_TEST_URL}\uFF08HTTPS\uFF09\u3002
+  MLB_GATEWAY_URL \u7EDF\u4E00\u9009\u62E9\u5E73\u53F0\uFF0C--app-server \u53EF\u8986\u76D6\u672C\u6B21\u547D\u4EE4\uFF1B\u540E\u53F0\u9ED8\u8BA4\u4F7F\u7528\u540C\u4E00\u5730\u5740\u7684 /developer/\u3002
   CLI \u7EDF\u4E00\u542F\u52A8\u5E76\u7BA1\u7406\u5DE5\u7A0B\u4E2D\u7684\u5B98\u65B9 Runtime\uFF1B\u6BCF\u6B21\u542F\u52A8\u6216\u91CD\u8F7D\u5FC5\u987B\u901A\u8FC7 npm \u6700\u65B0\u7A33\u5B9A\u7248\u68C0\u67E5\u3002
   \u8EAB\u4EFD\u8BFB\u53D6 package.json.buddyId\uFF1B.env \u4FDD\u5B58 Token\uFF0C\u542F\u52A8\u524D\u5411 Server \u6821\u9A8C\u6240\u5C5E\u642D\u5B50\u3002
+  \u8FDE\u63A5\u524D\u81EA\u68C0 .env \u7F51\u5173\uFF1B\u5DF2\u77E5\u65E7 ECS \u5730\u5740\u5728\u542F\u52A8 DEV \u65F6\u6821\u9A8C\u5F52\u5C5E\u5E76\u81EA\u52A8\u66F4\u65B0\uFF0C\u4E0D\u540C\u5E73\u53F0\u4ECD\u9700\u660E\u786E\u786E\u8BA4\u3002
   --refresh-token \u91CD\u65B0\u9886\u53D6\u5DF2\u6709\u5F00\u53D1 Token\uFF0C\u66F4\u65B0\u5DE5\u7A0B .env\uFF1B\u4E0D\u4F1A\u751F\u6210\u65B0\u5BC6\u94A5\u3002
   Widget \u6D88\u606F\u5361\u7247\u4FDD\u7559\u6307\u5B9A\u8BB0\u5F55\u7684\u6253\u5F00\u76EE\u6807\uFF0C\u5C0F\u6302\u4EF6\u5217\u8868\u6253\u5F00\u9ED8\u8BA4\u89C6\u56FE\u3002
   \u6A21\u62DF\u5668\u4F7F\u7528\u5F53\u524D\u5F00\u53D1\u8005\u8D26\u53F7\u8BBF\u95EE <buddyId>-dev \u8C03\u8BD5\u5206\u8EAB\u3002`;
@@ -250,6 +253,7 @@ var BuddyPlatformHost = class {
         baseUrl,
         token: async () => (await session.token({ signal: this.#signal })).accessToken
       }),
+      runtimeUpdate: { ...this.#runtimeUpdate, env: this.#env, platformUrl: baseUrl },
       preparePush
     };
   }
@@ -281,11 +285,10 @@ var BuddyPlatformHost = class {
     const baseUrl = resolvePlatformUrl({ env: this.#env, override: parsed.appServer, development: true });
     const manifest = await readBuddyProjectManifest(projectRoot);
     if (parsed.buddyId && parsed.buddyId !== manifest.buddyId) throw new Error(`\u5F53\u524D\u5DE5\u7A0B\u5C5E\u4E8E ${manifest.buddyId}\uFF0C\u8FDE\u63A5\u6307\u4EE4\u8981\u6C42 ${parsed.buddyId}\uFF1B\u8BF7\u5728\u6B63\u786E\u642D\u5B50\u7684\u5DE5\u7A0B\u76EE\u5F55\u6267\u884C\u3002`);
-    const webUrl = new URL(parsed.developerWeb ?? this.#env.BUDDY_DEVELOPER_WEB_URL ?? DEFAULT_DEVELOPER_WEB_URL);
-    if (webUrl.protocol !== "https:" && !(webUrl.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(webUrl.hostname)) || webUrl.username || webUrl.password || webUrl.search || webUrl.hash) throw new Error("\u521B\u9020\u8005\u540E\u53F0\u5FC5\u987B\u4F7F\u7528 HTTPS\uFF0C\u672C\u673A\u8C03\u8BD5\u53EF\u4F7F\u7528 loopback HTTP");
-    if (!webUrl.pathname.endsWith("/")) webUrl.pathname += "/";
+    const webUrl = resolveDeveloperWebUrl(baseUrl, parsed.developerWeb ?? this.#env.BUDDY_DEVELOPER_WEB_URL);
     const signal = this.#signal ?? new AbortController().signal;
-    await checkRuntimeUpdate(projectRoot, (message) => io.writeError(message), { signal, ...this.#runtimeUpdate });
+    await checkProjectGateway(projectRoot, baseUrl, { refreshToken: parsed.refreshToken, report: (message) => io.write(message) });
+    await checkRuntimeUpdate(projectRoot, (message) => io.writeError(message), { ...this.#runtimeUpdate, signal, env: this.#env, platformUrl: baseUrl });
     const session = this.#session(baseUrl, webUrl);
     await session.token({ signal });
     const starter = this.#previewStarter(baseUrl, manifest.buddyId, session, parsed.refreshToken ?? false);
@@ -356,7 +359,7 @@ var BuddyPlatformHost = class {
         const handle = await starter.start({
           projectRoot,
           signal,
-          runtimeUpdate: this.#runtimeUpdate,
+          runtimeUpdate: { ...this.#runtimeUpdate, env: this.#env, platformUrl: baseUrl },
           onError(error) {
             logs.flush();
             let message = error.message;
@@ -423,13 +426,14 @@ var BuddyPlatformHost = class {
     return resolvePlatformUrl({ env: this.#env });
   }
   #session(baseUrl, webUrl) {
+    const developerWebUrl = resolveDeveloperWebUrl(baseUrl, webUrl ?? this.#env.BUDDY_DEVELOPER_WEB_URL);
     const key = baseUrl.origin;
     let session = this.#sessions.get(key);
     if (!session) {
       session = new CloudAuthenticator(
         new LoopbackBrowserLoginAdapter({
           platformUrl: baseUrl,
-          ...webUrl ? { developerWebUrl: webUrl } : this.#env.BUDDY_DEVELOPER_WEB_URL ? { developerWebUrl: this.#env.BUDDY_DEVELOPER_WEB_URL } : {},
+          developerWebUrl,
           openBrowser: this.#openUrl
         }),
         new SystemCloudTokenStore({
@@ -494,10 +498,54 @@ async function withUpdateLock(path, signal, action) {
   }
 }
 
+// apps/cli/src/npm-update-install.ts
+import { stripVTControlCharacters as stripVTControlCharacters2 } from "node:util";
+function redact(text) {
+  return text.replace(/https?:\/\/[^\s<>"']+/giu, (value) => {
+    try {
+      const url = new URL(value);
+      url.username = "";
+      url.password = "";
+      url.search = "";
+      url.hash = "";
+      return url.toString();
+    } catch {
+      return "[URL]";
+    }
+  }).replace(/\bBearer\s+\S+/giu, "Bearer [REDACTED]").replace(/\b(?:_authToken|_auth|token|password|authorization)\s*[:=]\s*\S+/giu, "[REDACTED]").replace(/\bnpm_[A-Za-z0-9]+/gu, "[REDACTED]");
+}
+function npmFailure(cause) {
+  const error = cause;
+  const stderr2 = stripVTControlCharacters2(typeof error?.stderr === "string" ? error.stderr.slice(-32768) : "");
+  const lines = stderr2.split(/\r?\n/u).map((line) => line.match(/^npm (?:error|ERR!)\s+(.*)$/u)?.[1]).filter((line) => !!line);
+  const code = lines.map((line) => line.match(/^code\s+(E[A-Z0-9_]+)\b/u)?.[1]).find(Boolean) ?? (typeof error?.code === "string" && /^E[A-Z0-9_]+$/u.test(error.code) ? error.code : error?.killed ? "ETIMEDOUT" : "UNKNOWN");
+  const reason = lines.filter((line) => !/^(?:code |A complete log |A complete log can|Log files |In most cases|If you |Note:)/u.test(line) && !/debug[^\r\n]*\.log\s*$/u.test(line)).slice(0, 3).map(redact).join(" ").slice(0, 700);
+  return { code, reason };
+}
+async function installCliWithNpm(args, settings, runNpm) {
+  const deadline = Date.now() + settings.timeout;
+  for (let attempt = 0; attempt < 2; attempt++) {
+    settings.signal?.throwIfAborted();
+    try {
+      const timeout = deadline - Date.now();
+      if (timeout <= 0) throw Object.assign(new Error("install timeout"), { code: "ETIMEDOUT" });
+      await runNpm([...args, "--prefer-online"], { ...settings, timeout });
+      return;
+    } catch (cause) {
+      settings.signal?.throwIfAborted();
+      const { code, reason } = npmFailure(cause);
+      if (code === "ETARGET" && attempt === 0 && Date.now() < deadline) continue;
+      const hint = code === "ETARGET" ? `npm \u5C1A\u672A\u63D0\u4F9B\u6240\u9700\u7248\u672C\uFF1B${attempt > 0 ? "\u5DF2\u8054\u7F51\u5237\u65B0\u5E76\u91CD\u8BD5\u4E00\u6B21" : "\u8054\u7F51\u5237\u65B0\u540E\u4ECD\u627E\u4E0D\u5230\u8BE5\u7248\u672C"}\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002` : code === "EACCES" || code === "EPERM" ? "\u8BF7\u68C0\u67E5 npm \u5B89\u88C5\u76EE\u5F55\u548C\u7F13\u5B58\u76EE\u5F55\u7684\u5199\u5165\u6743\u9650\u3002" : code === "EBADENGINE" ? "\u8BF7\u68C0\u67E5 Node.js \u7248\u672C\u662F\u5426\u6EE1\u8DB3\u5305\u7684\u8981\u6C42\u3002" : ["ENOTFOUND", "ECONNRESET", "ECONNREFUSED", "ETIMEDOUT", "EAI_AGAIN"].includes(code) ? "\u8BF7\u68C0\u67E5\u5230 npm \u7684\u7F51\u7EDC\u8FDE\u63A5\u540E\u91CD\u8BD5\u3002" : "\u8BF7\u6839\u636E\u4EE5\u4E0A\u539F\u56E0\u5904\u7406\u540E\u91CD\u8BD5\u3002";
+      throw new Error(`npm \u5B89\u88C5\u672A\u5B8C\u6210\uFF08${code}\uFF09\u3002${reason ? `${reason}
+` : ""}${hint}`);
+    }
+  }
+}
+
 // apps/cli/src/self-update.ts
 var PACKAGE = "@my-life-buddies/cli";
 var REGISTRY = "https://registry.npmjs.org/";
-var MANUAL_UPDATE = `npm install --global ${PACKAGE}@latest --registry=${REGISTRY}`;
+var MANUAL_UPDATE = `npm install --global ${PACKAGE}@latest --registry=${REGISTRY} --prefer-online`;
 var execute = promisify(execFile);
 var HELP = `\u7528\u6CD5:
   buddy-cli --version [--json]
@@ -510,6 +558,7 @@ var HELP = `\u7528\u6CD5:
 
 \u65E0\u9700\u767B\u5F55\u642D\u642D\u8D26\u53F7\uFF0C\u4E5F\u65E0\u9700\u8FDB\u5165\u642D\u5B50\u5DE5\u7A0B\u3002
 \u6B63\u5E38\u547D\u4EE4\uFF08\u542B guide\uFF09\u4F1A\u5148\u8054\u7F51\u81EA\u68C0\uFF0C\u81EA\u52A8\u66F4\u65B0\u540E\u7531\u65B0\u7248\u7EE7\u7EED\u6267\u884C\uFF1B\u7B49\u5F85\u5B8C\u6210\u5373\u53EF\u3002
+\u5B89\u88C5\u4E3B\u52A8\u5237\u65B0 npm \u7248\u672C\u7F13\u5B58\uFF0C\u627E\u4E0D\u5230\u7248\u672C\uFF08ETARGET\uFF09\u65F6\u6700\u591A\u91CD\u8BD5\u4E00\u6B21\uFF1B\u5931\u8D25\u8BF4\u660E\u5177\u4F53\u539F\u56E0\u3002
 --help\u3001\u5404\u547D\u4EE4 --help \u4E0E --version \u79BB\u7EBF\u53EF\u7528\uFF1B\u67E5\u8BE2\u6216\u66F4\u65B0\u5931\u8D25\u65F6\u505C\u6B62\u4E1A\u52A1\u64CD\u4F5C\u3002
 update \u7528\u4E8E\u5355\u72EC\u66F4\u65B0\u5F53\u524D npm \u5168\u5C40\u5B89\u88C5\u7684 CLI\uFF0C\u4E0D\u4FEE\u6539\u642D\u5B50\u5DE5\u7A0B\u7684 Runtime \u4F9D\u8D56\u3002
 \u5DF2\u7ECF\u662F\u6700\u65B0\u7248\u6216\u5F53\u524D\u7248\u672C\u66F4\u9AD8\u65F6\u4E0D\u5B89\u88C5\u3001\u4E0D\u964D\u7EA7\u3002
@@ -585,7 +634,7 @@ async function installUpdate(version, options) {
     if (current.name === PACKAGE && current.version === version) return;
     if (current.name === PACKAGE && compareVersions(current.version, version) > 0) throw new Error("\u53E6\u4E00\u4E2A\u8FDB\u7A0B\u5DF2\u5B89\u88C5\u66F4\u65B0\u7684 CLI\uFF0C\u8BF7\u91CD\u65B0\u6267\u884C\u547D\u4EE4\u3002");
     try {
-      await runNpm([
+      await installCliWithNpm([
         "install",
         "--global",
         `${PACKAGE}@${version}`,
@@ -596,11 +645,11 @@ async function installUpdate(version, options) {
         "--engine-strict",
         "--no-audit",
         "--no-fund"
-      ], { ...settings, timeout: 18e4 });
+      ], { ...settings, timeout: 18e4 }, runNpm);
     } catch (cause) {
       if (options.signal?.aborted) throw new Error("\u66F4\u65B0\u5DF2\u53D6\u6D88\uFF0C\u8BF7\u8FD0\u884C buddy-cli --version \u68C0\u67E5\u5B89\u88C5\u72B6\u6001\u3002");
-      const code = cause && typeof cause === "object" && "code" in cause ? String(cause.code) : "unknown";
-      throw new Error(`npm \u5B89\u88C5\u672A\u5B8C\u6210\uFF08${code}\uFF09\u3002\u8BF7\u68C0\u67E5\u7F51\u7EDC\u548C\u5168\u5C40\u76EE\u5F55\u6743\u9650\uFF0C\u7136\u540E\u91CD\u8BD5\uFF1A${MANUAL_UPDATE}`);
+      throw new Error(`${cause instanceof Error ? cause.message : "npm \u5B89\u88C5\u672A\u5B8C\u6210\u3002"}
+\u4E5F\u53EF\u624B\u52A8\u5B89\u88C5\uFF1A${MANUAL_UPDATE}`);
     }
     const installed = JSON.parse(await readFile(join2(installedRoot, "package.json"), "utf8"));
     if (installed.name !== PACKAGE || installed.version !== version) {
@@ -728,26 +777,22 @@ async function prepareLatest(version, options) {
     const temporary = await mkdtemp(join3(cache, "releases", ".install-"));
     try {
       await writeFile2(join3(temporary, "package.json"), JSON.stringify({ private: true }));
-      try {
-        await runNpm(
-          [
-            "install",
-            "--prefix",
-            temporary,
-            "--save-exact",
-            `${PACKAGE2}@${version}`,
-            `--registry=${REGISTRY2}`,
-            `--@my-life-buddies:registry=${REGISTRY2}`,
-            "--engine-strict",
-            "--no-audit",
-            "--no-fund"
-          ],
-          { cwd: temporary, signal: options.signal, timeout: 18e4 }
-        );
-      } catch (cause) {
-        const code = cause && typeof cause === "object" && "code" in cause ? String(cause.code) : "unknown";
-        throw new Error(`\u65B0\u7248 CLI \u7F13\u5B58\u5B89\u88C5\u5931\u8D25\uFF08${code}\uFF09\uFF0C\u8BF7\u68C0\u67E5\u7F51\u7EDC\u3001Node.js \u7248\u672C\u548C\u76EE\u5F55\u6743\u9650\u540E\u91CD\u8BD5\u3002`);
-      }
+      await installCliWithNpm(
+        [
+          "install",
+          "--prefix",
+          temporary,
+          "--save-exact",
+          `${PACKAGE2}@${version}`,
+          `--registry=${REGISTRY2}`,
+          `--@my-life-buddies:registry=${REGISTRY2}`,
+          "--engine-strict",
+          "--no-audit",
+          "--no-fund"
+        ],
+        { cwd: temporary, signal: options.signal, timeout: 18e4 },
+        runNpm
+      );
       await checkedEntry(join3(temporary, "node_modules", PACKAGE2), version);
       options.signal?.throwIfAborted();
       await rm2(destination, { recursive: true, force: true });
@@ -913,9 +958,10 @@ try {
   const host = () => platformHost ??= new BuddyPlatformHost({ signal: lifecycle.signal });
   const result = maintenance ?? await runBuddyCli(args, terminal, {
     runtimeCatalog: { signal: lifecycle.signal },
-    scaffoldPlatformAgent: (root, name) => scaffoldPlatformAgent(root, name, {
+    scaffoldPlatformAgent: (root, name, runtimeVersion) => scaffoldPlatformAgent(root, name, {
       resolveDependencies: (template) => latestRuntimeTemplate(template, {
         signal: lifecycle.signal,
+        runtimeVersion,
         report: (message) => terminal.write(message)
       })
     }),