@my-life-buddies/cli 0.18.1 → 0.21.0

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 和平台地址
 
@@ -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。
 
 旧版没有标记服务器归属的钥匙串记录不会自动复用或删除；升级后需要重新登录一次。
 
@@ -135,7 +135,7 @@ buddy-cli init --mode direct --directory "<搭子工程目录>" --avatar "<头
 
 `.buddy/meta/` 保存草稿、候选图片、预览与接续说明，push 不上传。上传失败保留已创建的 buddyId，重试复用原身份；已有云端头像不会在恢复中被覆盖。Meta 创建响应丢失时会明确暂停，核对后台身份后用 `--buddy-id` 恢复，避免重复创建。
 
-基础资料和头像的确认不等于 Creator 四册已确认。已有搭子的恢复沿用原身份和云端头像；明确需要更换头像时使用 `buddy-cli avatar --file`。
+基础资料和头像的确认不等于 Creator 四册已确认。已有搭子的恢复沿用原身份和云端头像；明确需要更换头像时使用 `buddy-cli meta update --avatar`。
 
 ## 需求明确时，直接开发
 
@@ -305,26 +305,31 @@ Creator 例外保留首次创作背景快照，用于接续同一作品；恢复
 
 这些规则通过 CLI 帮助、命令输出和 Creator 的 `HANDOFF.md` 交给 Coding Agent；CLI 不会在 `init` 内自动执行采访、编写业务代码或批量调用模型。重试创作时复用当前接续说明和作品，不覆盖开发者修改的文件。已有完整工程无需重新初始化，可从更新后的 CLI 帮助和 `preview` 输出读取交接规则。
 
-## 修改搭子的头像
+## 查看和修改搭子资料
 
-在搭子工程中上传本地生成或选择的图片：
+登记后用 `meta` 查看云端资料，用 `meta update` 修改名称、介绍或替换头像：
 
 ```bash
-buddy-cli avatar --file ./avatar.png
-buddy-cli avatar --clear
+buddy-cli meta
+buddy-cli meta update --name "川大厨" --tagline "帮你安排每天吃什么"
+buddy-cli meta update --intro "根据食材、人数和口味推荐菜谱"
+buddy-cli meta update --avatar ./avatar.png
 ```
 
-`--file` 与 `--clear` 二选一。支持静态 PNG、JPEG、WebP，最大 5 MiB。Server 校验图片并裁剪成 512 × 512 WebP，生成头像地址；CLI 不再提供 `--url`。服务端处理失败时保留原头像。
+`meta` 只读，修改时必须带 `update` 并至少提供一个字段。多个修改参数可以组合，未传字段保持原样，包括云端已有的扩展资料。文字字段不能为空，名称最多 60 字，一句话介绍最多 200 字，完整介绍最多 10000 字。头像只上传替换，不提供清除选项；支持静态 PNG、JPEG、WebP，最大 5 MiB。Server 校验图片并生成地址，处理失败时保留原头像。
 
-命令默认向上寻找 `package.json`，可用 `--directory ./my-buddy` 指定工程；图片路径始终相对执行命令的当前目录。创作阶段只有身份清单时也能使用，无需安装 Runtime。工程外可直接指定平台 ID：
+默认向上寻找 `package.json.buddyId`，也可用 `--directory ./cooking-buddy` 指定工程；图片路径始终相对执行命令的当前目录。创作阶段只有身份清单时也能使用，无需安装或启动 Runtime。工程外可直接指定平台 ID：
 
 ```bash
-buddy-cli avatar --buddy-id b_example --file ./avatar.png
+buddy-cli meta --buddy-id b_example
+buddy-cli meta update --buddy-id b_example --name "川大厨" --avatar ./avatar.png
 ```
 
-`--buddy-id` 和 `--directory` 不能同时使用。命令复用 CLI 登录态，由 Server 校验搭子归属；通过 `PUT /cli/buddies/:id/meta` 提交 multipart 图片，服务端保留其他资料。清除时 JSON 提交 `avatar: null`。云端头像立即保存，不写入本地工程配置，无需 `push`。`buddy-cli status` 可查看头像地址。
+`--buddy-id` 和 `--directory` 不能同时使用。命令复用 CLI 登录态，由 Server 校验搭子归属。CLI 先通过 `GET /cli/buddies/:id` 获取最新资料，合并指定修改，再通过 `PUT /cli/buddies/:id/meta` 更新；含头像时使用 multipart，文字和图片通过校验后一起提交。头像地址由平台生成，文字更新不提交原头像 URL。
 
-头像固定保存为 `avatar-<buddyId>.webp`，更换时覆盖文件；返回地址带内容摘要查询参数，让客户端重新加载图片。此版本需要部署支持 multipart 头像的新 MLB Server。
+云端展示资料立即更新，包括已发布搭子；无需 `push`、提审或重新发布程序包，不改写本地工程配置、Creator 背景快照、Prompt 或业务代码。改实际行为仍需调整对应代码。`init` 继续负责登记和恢复，不用于覆盖已有资料；遇到恢复资料不一致时先用 `meta` 查看。
+
+原 `avatar` 命令保留为旧脚本的兼容入口，和 `meta update` 共用更新逻辑；新调用统一使用 `meta update --avatar`。
 
 ## 为这个搭子选一个模型
 
@@ -332,9 +337,9 @@ buddy-cli avatar --buddy-id b_example --file ./avatar.png
 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、avatar 不查询 Runtime。
+在已有工程执行 `buddy-cli`、`init` 或打开 `preview` 时检查更新并提示适配，但允许继续编辑工程。默认平台下，`dev`、Preview 中每次启动 DEV、文件自动重载，以及 `push` 必须联网查询 npm 最新稳定版，工程声明及实际安装版本必须与本次查询结果完全一致；不接受旧版、超前版、预发布版或范围依赖。查询失败即停止，不使用缓存冒充最新，也没有跳过检查参数。已有 npm 锁文件需与目标版本一致，push 还会按本次查询结果校验实际上传快照及其中的 npm 锁文件。失败信息包含原因和适配提示，CLI 不自动修改工程依赖、模型或数据权限。修复后重新启动；自动重载失败后保存文件可重试。帮助、登录、status、meta 和兼容命令 avatar 不查询 Runtime。
 
 此限制由本版 CLI 执行，不修改服务端策略或已部署进程；直接运行工程 `npm start`、旧 CLI 或服务端发布入口不受本版 CLI 检查约束。
 
@@ -365,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 并重新登记。部署环境需提供对应登记接口。
 
@@ -401,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；不会提审或发布。
@@ -430,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
@@ -445,16 +450,28 @@ 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 |
+
+旧配置只在未设置 `MLB_GATEWAY_URL` 时兼容：账号和上传命令依次读取 `BUDDY_APP_SERVER_URL`、`BUDDY_DEV_APP_SERVER_URL`；`dev`、`preview` 顺序相反。新配置只需设置 `MLB_GATEWAY_URL`，它会统一覆盖这两种旧变量。空值、错误地址和跨平台的后台地址会报错，不静默回退。远程平台要求 HTTPS；本机 loopback 允许 HTTP。
+
+CLI 根据选定地址打开 `/developer/` 网页、访问 MLB API，并在启动 DEV 时把该地址和开发 Token 写入工程 `.env`。Runtime 通过 Node 加载 `.env` 中的 `MLB_GATEWAY_URL`。CLI 本身不自动加载项目 `.env` 或读取 shell 启动文件来选平台，因此 `login` 和新建工程也能在工程外使用。修改变量仅影响后续命令，不会让正在运行的预览中途切换。
 
-`BUDDY_DEV_APP_SERVER_URL` 保留为开发会话的专用覆盖。如果希望所有命令连接同一环境，只配置 `BUDDY_APP_SERVER_URL` 即可。
+切换平台后，CLI 按服务器 origin 分别保存登录和开发凭据，不向新平台发送旧平台的 Token。工程 `.env` 已绑定其他平台时会阻止复用；确认目标平台和工程归属后，使用 `--refresh-token` 更新开发凭据。搭子 ID、项目和平台上的数据不会自动迁移。使用后台生成的连接或停止指令时保留完整参数，`--app-server` 只覆盖该次命令。
 
-这些是地址配置选项，不表示开发版搭子一定运行在另一套域名或独立数据库里。如果特意配置了不同服务器，需要确认搭子属于目标服务器，且该服务器已开放所选模型。除固定 test 入口外，远程服务必须使用 HTTPS；本机 loopback 仍允许 HTTP。
+`models` 和 `datasets` 从公共 npm 读取 Runtime 能力，不向平台申请目录或权限；默认平台使用最新稳定版。平台地址与 Runtime 规则以当前终端的 `buddy-cli guide` 输出为准，Coding Agent 应先完成指南要求的必要选择，再继续创建工程；不要用别的环境的指南替代当前输出。
 
 ## 上传程序包，不等于发布
 
@@ -513,7 +530,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 项。
 
@@ -550,3 +567,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

@@ -70,7 +70,6 @@ import {
   BuddyDevError,
   checkRuntimeUpdate,
   DEFAULT_MLB_TEST_URL,
-  DEFAULT_DEVELOPER_WEB_URL,
   HttpDeveloperPlatformClient,
   LoopbackBrowserLoginAdapter,
   MlbDevRegistrationClient,
@@ -82,6 +81,7 @@ import {
   createPushPreflight,
   createPushSourceBundle,
   resolvePlatformUrl,
+  resolveDeveloperWebUrl,
   openExternalUrl,
   requireBuddyAgentProjectRoot
 } from "./core.js";
@@ -104,7 +104,8 @@ 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
   --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
@@ -250,6 +251,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 +283,9 @@ 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 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 +356,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 +423,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({
@@ -913,9 +914,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)
       })
     }),