@lark-apaas/miaoda-cli 0.1.32 → 0.1.33-alpha.414062

package/dist/cli/commands/deploy/modern.js

@@ -72,7 +72,7 @@ JSON 输出（stdout）
     }));
     const patchCmd = deployCmd
         .command('patch')
-        .description('design-html 增量发布：按文件 create/update/delete，.html 增删时同步 routes.json')
+        .description('design-html 增量发布：按文件 create/update/delete，.html 变动时同步 routes.json')
         .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--update <relpath>', '覆盖已有文件（可重复）', shared_1.collectRepeatedOption, [])
         .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
@@ -80,10 +80,11 @@ JSON 输出（stdout）
         .addHelpText('after', `
 --dir 为项目目录（与 deploy 同名参数，默认当前目录）。
 仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
-禁绝对路径与 ".."。--create/--update 的本地文件必须存在。.html 被新增/删除（路由集合变化）
-时自动重算并随包更新 routes.json；纯 --update 现有 .html 只改内容，不动 routes.json。
-routes.json 每项为 {path, file}：path 为相对路径（不含 base 前缀，由消费侧拼接），file 为
-对应源文件（如 / → index.html）。
+禁绝对路径与 ".."。--create/--update 的本地文件必须存在。改动里含任意 .html（增 / 改 / 删）
+时自动重算并随包更新 routes.json；纯非 .html 改动不动 routes.json。
+routes.json 每项为 {path, file, name?}：path 为相对路径（不含 base 前缀，由消费侧拼接），
+file 为对应源文件（如 / → index.html），name 为该 HTML 的 <title> 文本（方案名，可缺省，
+缺省时由消费侧 fallback 到 path）。
 
 JSON 输出
   {"data": {"upsertCount": <n>, "deleteCount": <n>, "actionsSent": <n>, "routesRegenerated": <bool>}}

package/dist/cli/handlers/skills/sync.js

@@ -34,14 +34,20 @@ function syncSteeringForSandbox(params) {
     catch (err) {
         return { status: 'skipped', reason: `read .spark/meta.json failed: ${err.message}` };
     }
-    // 版本口径与下方本地分支保持一致：--version > BOE 的 dist-tag dev > latest
-    const isBoe = process.env.FORCE_FRAMEWORK_ENVIRONMENT === 'boe';
-    const effectiveVersion = params.version ?? (isBoe ? 'dev' : undefined);
+    // 版本口径：--version > lane（TCC tgzKey）> BOE 的 dist-tag dev > latest。
+    //
+    // **这里不预先把 BOE 解成 'dev'**（下方本地分支为了回报 versionSource 才那么做）：
+    // 一旦提前填进 version，就会盖住 lane —— version 在优先级里高于 lane，BOE 沙箱上
+    // 配了 tgzKey 也永远命中不了。把 version 原样透传（未指定就是 undefined），让
+    // syncCodingSteering 一处算全链：version > lane > dev > latest。
     try {
         const r = (0, coding_steering_1.syncCodingSteering)({
             stack,
             targetDir: params.targetDir,
-            version: effectiveVersion,
+            version: params.version,
+            // TCC 的 X 与平铺 skill 共用：pickLaneVersion 只匹配 `-alpha.<X>` 后缀，
+            // 不看 base 版本，所以一个 key 同时定向 coding-steering 与 sandbox-skills。
+            tgzKey: params.tgzKey,
             // 必须显式传 mode，不能落到 inferMode()：它靠 env MIAODA_DEP_CACHE_DIR 嗅探，
             // 而 mode 决定读包内哪个 layer（sandbox→`skills/`，local→`skills_local/`）。
             // `--type` 分支本身就是沙箱语义，嗅探失手会去读不存在的 skills_local/、
@@ -70,9 +76,16 @@ function syncSteeringForSandbox(params) {
  *
  * 版本来源优先级（从高到低）：
  *   1. CLI `--version` flag（显式指定）
- *   2. `FORCE_FRAMEWORK_ENVIRONMENT=boe` → dist-tag `dev`（BOE 测试灰度，跟随
+ *   2. lane：`--type` 分支下由 TCC `skillsUpdateTgzKey` 透传 `--tgz-key`，反推 X 后
+ *      解析出 `-alpha.<X>` 版本。**与平铺 skill 共用同一个 X** —— 匹配只看后缀、
+ *      不看 base 版本，所以 TCC 配一个 key 就同时定向 coding-steering 与 sandbox-skills。
+ *      本地分支（不带 `--type`）没有 tgzKey，这一档天然不参与。
+ *   3. `FORCE_FRAMEWORK_ENVIRONMENT=boe` → dist-tag `dev`（BOE 测试灰度，跟随
  *      publish-alpha.sh 在 develop 分支打的 dev tag，便于在 BOE 沙箱里验证预发 steering）
- *   3. 默认 `latest`
+ *   4. 默认 `latest`
+ *
+ * 2/3/4 档统一在 `syncCodingSteering` 里算（见那边注释），handler 只负责透传，避免
+ * 提前把 `dev` 填进 version 把 lane 挤掉。
  *
  * **不读 meta.json**——steering 版本不在 meta 里钉。
  */
@@ -98,7 +111,7 @@ async function handleSkillsSync(opts) {
         const result = (0, sandbox_skills_1.syncSandboxSkills)({ type, tgzKey, targetDir });
         const steering = result.skippedByKeepFile
             ? { status: 'skipped', reason: '.keep file found, sync frozen' }
-            : syncSteeringForSandbox({ targetDir, version: opts.version });
+            : syncSteeringForSandbox({ targetDir, version: opts.version, tgzKey });
         // ③ 收尾锁只读（update-skills.sh:241 的 chmod -R a=rX）。必须在 ①② 全部写完之后，
         //    锁上就写不进去了。`.keep` 冻结时不锁 —— 老链路那条路径是 exit 0 直接走、
         //    末尾的 chmod 压根不执行，保持一致。

package/dist/services/deploy/modern/patch/actions.js

@@ -36,8 +36,10 @@ function isHtml(rel) {
 /**
  * 把 changeset 组成 TosFileAction[]：
  *   - create/update 读本地文件、自动编码；delete 仅 FilePath。
- *   - .html 被 create / delete（路由集合变化）时，追加重算 routes.json 的 UPDATE action；
- *     纯 update 现有 .html 只改内容、不改路由集合，不重算 routes.json。
+ *   - 任一 .html 被 create / update / delete 时，追加重算 routes.json 的 UPDATE action。
+ *     update 也算：routes.json 的 name 取自 HTML 的 `<title>`，改方案名就是一次纯 update，
+ *     只按 create/delete 判定会让改名永远进不了 routes.json。
+ *   - 纯非 .html 改动（js / css / 图片）不动 routes.json。
  */
 function buildTosActions(projectDir, cs) {
     const actions = [];
@@ -48,8 +50,8 @@ function buildTosActions(projectDir, cs) {
     for (const rel of cs.deletes) {
         actions.push({ actionType: index_1.TosActionType.DELETE, filePath: normalizeRel(rel) });
     }
-    const routeSetChanged = [...cs.creates, ...cs.deletes].some(isHtml);
-    if (routeSetChanged) {
+    const routesMayChange = [...cs.creates, ...cs.updates, ...cs.deletes].some(isHtml);
+    if (routesMayChange) {
         actions.push({
             actionType: index_1.TosActionType.UPDATE,
             filePath: 'routes.json',

package/dist/services/deploy/modern/patch/html-title.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTitle = extractTitle;
+const node_fs_1 = __importDefault(require("node:fs"));
+/**
+ * 读 `<title>` 时的扫描窗口上限（字节）。title 规范上在 `<head>` 里、正常紧贴文档开头，
+ * 64KB 足以覆盖 head 里塞了内联 style / script 的情况，同时给大 HTML 兜住 IO 上限
+ * （generateRoutes 会遍历工程内所有 .html，不能整文件读）。
+ */
+const HEAD_SCAN_BYTES = 64 * 1024;
+const TITLE_RE = /<title[^>]*>([^<]*)<\/title>/i;
+const HEAD_CLOSE_RE = /<\/head\s*>/i;
+const COMMENT_RE = /<!--[\s\S]*?-->/g;
+const ENTITY_RE = /&(#x[0-9a-f]+|#[0-9]+|[a-z]+);/gi;
+/** HTML 里可能出现在 title 文本中的命名实体。未列出的原样保留，不做全量实体表。 */
+const NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+};
+/** 把 title 文本里的实体还原成明文——name 是给前端直接当文本渲染的，不该带 `&amp;`。 */
+function decodeEntities(s) {
+    return s.replace(ENTITY_RE, (matched, body) => {
+        if (!body.startsWith('#')) {
+            return NAMED_ENTITIES[body.toLowerCase()] ?? matched;
+        }
+        const code = /^#x/i.test(body) ? parseInt(body.slice(2), 16) : parseInt(body.slice(1), 10);
+        if (!Number.isInteger(code) || code <= 0 || code > 0x10ffff)
+            return matched;
+        return String.fromCodePoint(code);
+    });
+}
+/** 只读文件头部 HEAD_SCAN_BYTES 字节。尾部可能截断多字节字符，对 title 提取无影响。 */
+function readHead(absPath) {
+    const fd = node_fs_1.default.openSync(absPath, 'r');
+    try {
+        const buf = Buffer.alloc(HEAD_SCAN_BYTES);
+        const bytes = node_fs_1.default.readSync(fd, buf, 0, HEAD_SCAN_BYTES, 0);
+        return buf.subarray(0, bytes).toString('utf-8');
+    }
+    finally {
+        node_fs_1.default.closeSync(fd);
+    }
+}
+/**
+ * 取 HTML 的 `<title>` 文本作为该页面的方案名。
+ *
+ * - 扫描范围截到第一个 `</head>`：body 里的 `<title>` 不算——内联 SVG 图标的 a11y
+ *   `<title>` 很常见，抓到就会把图标描述当成方案名。找不到 `</head>` 时退回整个窗口。
+ * - 先剔 HTML 注释，避免抓到被注释掉的 title。
+ * - 实体还原 + 空白折叠 + trim；空 title / 无 title / 读失败一律返回 undefined，
+ *   由消费侧 fallback 到 path（旧应用没有 title 时保持显示页面地址）。
+ */
+function extractTitle(absPath) {
+    let head;
+    try {
+        head = readHead(absPath);
+    }
+    catch {
+        return undefined;
+    }
+    const headClose = HEAD_CLOSE_RE.exec(head)?.index ?? -1;
+    const scope = (headClose >= 0 ? head.slice(0, headClose) : head).replace(COMMENT_RE, '');
+    const raw = TITLE_RE.exec(scope)?.[1];
+    if (raw === undefined)
+        return undefined;
+    const text = decodeEntities(raw).replace(/\s+/g, ' ').trim();
+    return text === '' ? undefined : text;
+}

package/dist/services/deploy/modern/patch/index.js

@@ -11,7 +11,7 @@ const actions_1 = require("./actions");
 var actions_2 = require("./actions");
 Object.defineProperty(exports, "buildTosActions", { enumerable: true, get: function () { return actions_2.buildTosActions; } });
 /**
- * design-html 增量发布：读本地文件组 TosFileAction（create/delete .html 时带重算的
+ * design-html 增量发布：读本地文件组 TosFileAction（改动含 .html 时带重算的
  * routes.json），调后端 applyTosDiff 应用到 latest。scope 限 design_local_deploy。
  */
 async function patchDesignDeploy(opts) {

package/dist/services/deploy/modern/patch/routes.js

@@ -1,6 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateRoutes = generateRoutes;
+const node_path_1 = __importDefault(require("node:path"));
+const html_title_1 = require("./html-title");
 const source_scan_1 = require("./source-scan");
 /**
  * .html → route path 推导（相对路径，不带 base 前缀）。rel 为 posix 相对路径。
@@ -16,8 +21,9 @@ function toRoute(rel) {
 }
 /**
  * 扫描 projectDir 下所有 .html（套 source-scan 的 EXCLUDES），生成 routes.json 文本（含尾换行）。
- * 每项为 { path, file }：path 为相对路径（不带 CLIENT_BASE_PATH 前缀，由消费侧拼接），
- * file 为该路由对应的原始 .html 源文件。按 path 排序、同 path 取字典序靠前的 file 去重。
+ * 每项为 { path, file, name? }：path 为相对路径（不带 CLIENT_BASE_PATH 前缀，由消费侧拼接），
+ * file 为该路由对应的原始 .html 源文件，name 为该文件 `<title>` 解析出的方案名（可缺省）。
+ * 按 path 排序、同 path 取字典序靠前的 file 去重。
  * 零 html 时输出空数组——不伪造解析不到文件的根路由。
  */
 function generateRoutes(projectDir) {
@@ -27,7 +33,11 @@ function generateRoutes(projectDir) {
         if (!byPath.has(entry.path))
             byPath.set(entry.path, entry);
     }
-    const routes = [...byPath.values()];
+    // title 只读去重后胜出的 file：同 path 多源（foo.html / foo/index.html）时不做无用 IO。
+    const routes = [...byPath.values()].map((entry) => {
+        const name = (0, html_title_1.extractTitle)(node_path_1.default.join(projectDir, entry.file));
+        return name === undefined ? entry : { ...entry, name };
+    });
     return JSON.stringify(routes, null, 2) + '\n';
 }
 function byPathThenFile(a, b) {

package/dist/utils/coding-steering.js

@@ -40,7 +40,27 @@ function inferMode() {
  */
 function syncCodingSteering(opts) {
     const logPrefix = opts.logPrefix ?? 'skills';
-    const effectiveVersion = opts.version ?? 'latest';
+    // 版本优先级：--version（显式 pin / 止血）> lane（TCC 定向灰度）> BOE 默认 @dev > @latest
+    //
+    // 与 sandbox-skills 的 syncSandboxSkills 完全同一套口径，只是包名不同。BOE 的 @dev
+    // 由 miaoda-coding develop 分支的自动发布维护；lane 必须压过 dev —— TCC 配了 tgzKey
+    // 就是定向到某个 feat 分支的快照，不该被"BOE 跟 develop"这条默认规则盖掉。
+    //
+    // BOE→dev 这一档在本函数里算，不由调用方预填：`skills sync --type` 分支会带 tgzKey
+    // 进来，调用方若先把 'dev' 塞进 version，version 档位更高，lane 就永远命不中。
+    // 本地分支 / app init 为了回报 versionSource 仍会自己算 dev 再传 version —— 那两条路
+    // 没有 tgzKey，lane 档天然为空，两处口径一致不会打架。
+    //
+    // lane 解析与 sandbox-skills 同一套：`extractLaneFromTgzKey` 反推 X，`pickLaneVersion`
+    // 过滤后缀 `-alpha.<X>`。**匹配只看后缀、不看 base 版本**，所以 coding-steering
+    // （`0.1.3x-alpha.<X>`）和 sandbox-skills（`0.1.x-alpha.<X>`）能共用 TCC 里的同一个
+    // key —— 前提是 lane 发布脚本用同一个 X 把两边一起发出去。这个包没发 `-alpha.<X>`
+    // 时 pickLaneVersion 返回 null（它对报错 / 无匹配都返回 null，绝不 throw），静默
+    // 回落到 dev / latest，不影响现有行为。
+    const lane = (0, npm_pack_1.extractLaneFromTgzKey)(opts.tgzKey);
+    const laneVersion = lane === null ? null : (0, npm_pack_1.pickLaneVersion)(STEERING_PACKAGE, lane);
+    const isBoe = process.env.FORCE_FRAMEWORK_ENVIRONMENT === 'boe';
+    const effectiveVersion = opts.version ?? laneVersion ?? (isBoe ? 'dev' : 'latest');
     const mode = opts.mode ?? inferMode();
     const layout = opts.outputLayout ?? 'nested';
     (0, logger_1.log)(logPrefix, `Fetching ${STEERING_PACKAGE}@${effectiveVersion} (mode=${mode}, layout=${layout})...`);

package/dist/utils/npm-pack.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pickLaneVersion = pickLaneVersion;
+exports.extractLaneFromTgzKey = extractLaneFromTgzKey;
 exports.fetchNpmPackage = fetchNpmPackage;
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
@@ -44,6 +45,35 @@ function pickLaneVersion(packageName, X, registry) {
         return null;
     }
 }
+/**
+ * 从 TCC skillsUpdateTgzKey 反推 lane 名。
+ *   skills_versions/all_feat-xxx.tgz  → feat-xxx
+ *   skills_versions/all_feat_xxx.tgz  → feat-xxx  (_ sanitize → -)
+ *   skills_versions/all_latest.tgz    → null（走各自的默认版本口径）
+ *   任何 all_<X>.tgz                  → <X> 里 _ 全部转 -
+ *
+ * **宽进严出**：正则允许 `_` 匹配（兼容老 miaoda-skills 时代 TOS key 含 `_` 的存量 TCC
+ * 命名），但返回时 sanitize 成 `-` —— 对齐 publish-sandbox-skills.sh 侧只发 `-` 版
+ * lane 的现实（npm SemVer pre-release 只允许 `[A-Za-z0-9-]`，不允许 `_`）。
+ * 存量 TCC 里如果有 `all_feat_xxx.tgz` 这种命名，反推出 `feat-xxx` 后能正确命中
+ * npm 上实际发出的 `-alpha.feat-xxx-<ts>` 包，而不是静默 fallback。
+ *
+ * 用 nullable 而不是空字符串 —— 让调用方能判断"没 lane 就走默认版本"。
+ */
+function extractLaneFromTgzKey(tgzKey) {
+    if (tgzKey === undefined || tgzKey === '') {
+        return null;
+    }
+    const match = /(?:^|\/)all_([A-Za-z0-9][A-Za-z0-9_-]*)\.tgz$/.exec(tgzKey);
+    if (match === null) {
+        return null;
+    }
+    const lane = match[1].replace(/_/g, '-');
+    if (lane === 'latest') {
+        return null;
+    }
+    return lane;
+}
 /**
  * `npm pack <pkg>@<ver> --registry <r>` + `tar -xzf`，解到临时目录。
  * extractDir 是包内容根（含 package.json）。使用完必须 cleanup()。

package/dist/utils/sandbox-skills.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractLaneFromTgzKey = extractLaneFromTgzKey;
+exports.extractLaneFromTgzKey = void 0;
 exports.syncSandboxSkills = syncSandboxSkills;
 exports.validateSandboxSyncOpts = validateSandboxSyncOpts;
 const node_fs_1 = __importDefault(require("node:fs"));
@@ -68,34 +68,11 @@ const BUSINESS_LINE_BY_TYPE = {
     openclaw: null, // openclaw 独立包，直接展平
 };
 /**
- * 从 TCC skillsUpdateTgzKey 反推 lane 名。
- *   skills_versions/all_feat-xxx.tgz  → feat-xxx
- *   skills_versions/all_feat_xxx.tgz  → feat-xxx  (_ sanitize → -)
- *   skills_versions/all_latest.tgz    → null（走 @latest）
- *   任何 all_<X>.tgz                  → <X> 里 _ 全部转 -
- *
- * **宽进严出**：正则允许 `_` 匹配（兼容老 miaoda-skills 时代 TOS key 含 `_` 的存量 TCC
- * 命名），但返回时 sanitize 成 `-` —— 对齐 publish-sandbox-skills.sh 侧只发 `-` 版
- * lane 的现实（npm SemVer pre-release 只允许 `[A-Za-z0-9-]`，不允许 `_`）。
- * 存量 TCC 里如果有 `all_feat_xxx.tgz` 这种命名，反推出 `feat-xxx` 后能正确命中
- * npm 上实际发出的 `@lane-feat-xxx` 包，而不是静默 fallback 到 @latest。
- *
- * 用 nullable 而不是空字符串 —— 让调用方能判断"没 lane 就走 latest"。
+ * lane 解析已下沉到 `utils/npm-pack`（与 `pickLaneVersion` 同处一地，供
+ * sandbox-skills 与 coding-steering 共用）。这里保留再导出，维持既有引用面。
  */
-function extractLaneFromTgzKey(tgzKey) {
-    if (tgzKey === undefined || tgzKey === '') {
-        return null;
-    }
-    const match = /(?:^|\/)all_([A-Za-z0-9][A-Za-z0-9_-]*)\.tgz$/.exec(tgzKey);
-    if (match === null) {
-        return null;
-    }
-    const lane = match[1].replace(/_/g, '-');
-    if (lane === 'latest') {
-        return null;
-    }
-    return lane;
-}
+var npm_pack_2 = require("./npm-pack");
+Object.defineProperty(exports, "extractLaneFromTgzKey", { enumerable: true, get: function () { return npm_pack_2.extractLaneFromTgzKey; } });
 /**
  * 主流程：按 type 拉包 + sync 到目标目录。
  *
@@ -113,7 +90,7 @@ function syncSandboxSkills(opts) {
     const targetDir = node_path_1.default.resolve(opts.targetDir ?? process.cwd());
     const packageName = PACKAGE_BY_TYPE[opts.type];
     const businessLine = BUSINESS_LINE_BY_TYPE[opts.type];
-    const lane = extractLaneFromTgzKey(opts.tgzKey);
+    const lane = (0, npm_pack_1.extractLaneFromTgzKey)(opts.tgzKey);
     // ---- lane 拉包 ----
     // 新姿势（2026-08 迁离 lane-<X> dist-tag 之后）：
     //   TCC 里的 X（比如 `feat-migrate-skills-from-miaoda-skills-20260805143512`）
@@ -121,14 +98,25 @@ function syncSandboxSkills(opts) {
     //   过滤 `endsWith('-alpha.' + X)`（因 X 含 timestamp 全局唯一，唯一命中或 0 命中）。
     //   0 命中 → fallback @latest（对齐旧 TCC 值找不到、灰度切换期间的兜底语义）。
     //   `pickLaneVersion` 内部对 `npm view` 报错 / 无匹配都返回 null，绝不 throw ——
-    //   目标就是"不挂掉"。
+    //   目标就是"不挂掉"。**同一个 X 也被 coding-steering 侧用同样方式解析**（见
+    //   `syncCodingSteering`）：匹配只看 `-alpha.<X>` 后缀、不看 base 版本，所以两个包
+    //   base 版本不同也能共用一个 TCC key。
     let fetched;
     const laneVersion = lane === null ? null : (0, npm_pack_1.pickLaneVersion)(packageName, lane, opts.registry);
     if (lane !== null && laneVersion === null) {
         (0, logger_1.debug)(`sandbox-skills: no npm version matched -alpha.${lane}, fallback to @latest ` +
             `(TCC 里的 X 可能是老 lane dist-tag 命名 / 已 unpublish / npm view 挂 / 网络断)`);
     }
-    const primaryVersion = laneVersion ?? 'latest';
+    // 版本优先级：lane（TCC 显式定向）> BOE 默认 @dev > @latest
+    //
+    // `dev` 通道由 miaoda-coding 的 publish-sandbox-skills-dev.sh 在 develop 分支自动发布
+    // （`<base>-dev.<sha>` + dist-tag `dev`），口径与 coding-steering 完全一致 ——
+    // 后者在本仓 coding-steering 侧也是 `FORCE_FRAMEWORK_ENVIRONMENT=boe` 时默认取 `dev`。
+    //
+    // lane 必须压过 dev：TCC 里配了 tgz-key 就说明是定向灰度（钉某个 feat 分支的快照），
+    // 不能被"BOE 就跟 develop"这条默认规则覆盖掉。
+    const isBoe = process.env.FORCE_FRAMEWORK_ENVIRONMENT === 'boe';
+    const primaryVersion = laneVersion ?? (isBoe ? 'dev' : 'latest');
     try {
         (0, logger_1.debug)(`sandbox-skills: fetching ${packageName}@${primaryVersion}`);
         fetched = (0, npm_pack_1.fetchNpmPackage)({
@@ -138,6 +126,9 @@ function syncSandboxSkills(opts) {
         });
     }
     catch (err) {
+        // @latest 是最后一档，它再挂就没得降了，直接抛。
+        // lane / dev 拉失败都降到 @latest：dev 通道可能因为 develop 还没发过包而不存在
+        // （dist-tag 缺失 → npm pack 404），这时候不该让整条 sync 挂掉。
         if (primaryVersion === 'latest') {
             throw err;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.32",
+  "version": "0.1.33-alpha.0414062",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {