@lark-apaas/miaoda-cli 0.1.16-alpha.0 → 0.1.16-alpha.f6825fa

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

@@ -16,7 +16,6 @@ function registerDeployCommandsModern(program) {
         .description('触发 modern 应用发布：本地构建 + 本地部署（preRelease + localPublish）')
         .option('--dir <path>', '项目目录', '.')
         .option('--skip-build', '跳过 build 步骤（已构建好时使用）', false)
-        .option('--conf <json>', '关联元信息 JSON，仅识别 checkPointVersion / commitID 两字段')
         .addHelpText('after', `
 不要用异步模式或后台模式调用 deploy，否则调用可能提前结束，Agent 会误判发布已完成。
 
@@ -33,12 +32,6 @@ function registerDeployCommandsModern(program) {
   6. savePluginInstances（扫描 dist/output_capabilities/*.json 批量注册）
   7. finalizeLocalRelease(Finished|Failed)
 
---conf（关联元信息透传）
-  值为 JSON string，只识别两个字段，其余 key 忽略：
-    checkPointVersion  关联的 checkpoint 版本
-    commitID           关联的代码 commit ID
-  两字段均可选；非法 JSON / 非对象 / 字段值非字符串会报错。
-
 JSON 输出（stdout）
   {"data": {"appId": "...", "version": <n>, "url": "...", "releaseID": "...", "preReleaseID": "..."}}
 
@@ -46,14 +39,12 @@ JSON 输出（stdout）
   $ miaoda deploy
   $ miaoda deploy --dir ./my-app
   $ miaoda deploy --skip-build
-  $ miaoda deploy --conf '{"checkPointVersion":"v3","commitID":"a1b2c3d"}'
 `);
     deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
         await (0, modern_1.handleDeployModern)({
             dir: rawOpts.dir ?? '.',
             appId: (0, shared_1.resolveAppId)({}),
             skipBuild: rawOpts.skipBuild,
-            conf: rawOpts.conf,
         });
     }));
 }

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

@@ -3,46 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseDeployConf = parseDeployConf;
 exports.handleDeployModern = handleDeployModern;
 const node_path_1 = __importDefault(require("node:path"));
 const output_1 = require("../../../utils/output");
-const error_1 = require("../../../utils/error");
 const index_1 = require("../../../services/deploy/modern/index");
-const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"..."} 的 JSON 对象';
-/**
- * 解析 `--conf` JSON string，只取 checkPointVersion / commitID 两个白名单字段。
- * - 未传 → 返回 {}（行为不变）。
- * - 非法 JSON / 非 object / 字段值非 string → 抛 DEPLOY_CONF_INVALID。
- * - 空串字段视为未提供（不进 body，保持可选语义）；未知 key 忽略。
- */
-function parseDeployConf(raw) {
-    if (raw === undefined || raw === '')
-        return {};
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf 不是合法 JSON，${CONF_EXPECTED}`);
-    }
-    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-        throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf 必须是 JSON 对象，${CONF_EXPECTED}`);
-    }
-    const source = parsed;
-    const conf = {};
-    for (const key of ['checkPointVersion', 'commitID']) {
-        const value = source[key];
-        if (value === undefined)
-            continue;
-        if (typeof value !== 'string') {
-            throw new error_1.AppError('DEPLOY_CONF_INVALID', `--conf.${key} 必须是字符串，${CONF_EXPECTED}`);
-        }
-        if (value !== '')
-            conf[key] = value;
-    }
-    return conf;
-}
 /**
  * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
  *
@@ -50,13 +14,10 @@ function parseDeployConf(raw) {
  */
 async function handleDeployModern(opts) {
     const projectDir = node_path_1.default.resolve(opts.dir);
-    const conf = parseDeployConf(opts.conf);
     const result = await (0, index_1.runModernDeploy)({
         projectDir,
         appId: opts.appId,
         skipBuild: opts.skipBuild ?? false,
-        checkPointVersion: conf.checkPointVersion,
-        commitID: conf.commitID,
     });
     (0, output_1.emit)({
         data: {

package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -33,28 +33,25 @@ exports.MIGRATE_CONFIG = {
         // 依赖集合变了，lockfile 重新生成（首次 npm install 时）
         { type: 'delete-file', to: 'package-lock.json' },
         // ===== 3. 从 user package.json 删除 vite-react 专属字段 =====
-        // 这步在 merge-json 之前，确保 vite-react 的 preset 不残留。
-        // merge-json 是"template 覆盖同名 key + user 多出 key 保留"，所以 user 的 vite-react
-        // 专属字段不会被自动清理 —— 必须显式删。
+        // 这步在 merge-json 之前，确保 vite-react 的残留不会被 merge-json 兜底"保留 user 多出
+        // 的 key"逻辑留下来。
         //
-        // 注意：不删 dependencies.@lark-apaas/client-toolkit-lite —— lite 是 vite-react 时代的
-        // 入门 wrapper（顶层 38 个 export），完整版 @lark-apaas/client-toolkit 只暴露 ~20 个
-        // 对等出口（components/* / hooks/* / utils/* / tools/* / 顶层 alias），剩下 ~18 个 lite
-        // symbol（copyToClipboard / getAppId / clsxWithTw / isMobile / avatarImages 等）在 full
-        // 公共 API 里没有对等物。lite 跟 full 不是简单替换关系，而是不同抽象层级。强行替换
-        // 会让 build 失败；让两个包共存（lite 很轻量）是当前的现实选择。后续若 client-toolkit
-        // 补全 utility 出口，可启用 src/utils/codemod-client-toolkit-lite.ts 里已实现的 codemod
-        // rule（在 MigrateRule 联合里有 CodemodClientToolkitLiteRule 类型）。
+        // dependencies.@lark-apaas/client-toolkit-lite 也删 —— client-toolkit@1.2.48+ 顶层
+        // single-entry 完整 re-export 了 lite 全部 48 项 export，包名替换 codemod 后业务代码
+        // 全部 import 走 full 顶层，lite dep 不再被引用。详见
+        // fullstack-plugin#1124（client-toolkit 兼容 lite API 形态）。
         {
             type: 'delete-json-keys',
             to: 'package.json',
             keys: [
                 // 顶层 "type": "module" —— vite-react ESM 入口约定，nestjs CommonJS 不需要
                 'type',
-                // vite-react 的 vite preset，nestjs 用 fullstack-vite-preset
+                // vite-react 的 vite preset
                 'devDependencies.@lark-apaas/coding-preset-vite-react',
                 // vite-react 的 ESLint preset
                 'devDependencies.@lark-apaas/coding-presets-react',
+                // lite SDK：codemod 后 import 走 client-toolkit 顶层，lite dep 移除
+                'dependencies.@lark-apaas/client-toolkit-lite',
             ],
         },
         // ===== 4. 模板资产覆盖 / 新增 =====
@@ -74,10 +71,13 @@ exports.MIGRATE_CONFIG = {
         // 所以 from 也写 dot-form
         { type: 'file', from: '.gitignore', to: '.gitignore', overwrite: true },
         { type: 'file', from: '.npmrc', to: '.npmrc', overwrite: true },
-        // client 入口：用 nestjs 模板的 index.tsx 覆盖（含 Toaster / defaultTheme），原 vite-react
-        // 入口在前面 move-directory 时已搬到 client/src/index.tsx
+        // client 入口：原 vite-react 入口在前面 move-directory 时已搬到 client/src/index.tsx；
+        // 用户可能在入口加了 logger 初始化 / 自定义 Provider / 第三方 SDK init 等，强制覆盖
+        // 会丢用户改动。改为 overwrite:false（仅 user 没有时用 template 兜底）。codemod 会
+        // 把入口里的 lite import 包名换成 client-toolkit，让 AppContainer / QueryProvider /
+        // ErrorRender 等走 client-toolkit 顶层，业务行为不变。
         { type: 'file', from: 'client/index.html', to: 'client/index.html', overwrite: true },
-        { type: 'file', from: 'client/src/index.tsx', to: 'client/src/index.tsx', overwrite: true },
+        { type: 'file', from: 'client/src/index.tsx', to: 'client/src/index.tsx', overwrite: false },
         // 整目录复制（不存在则创建，存在则递归覆盖同名文件）
         // server/：NestJS SSR runtime，固定模板，不需要业务定制
         { type: 'directory', from: 'server', to: 'server', overwrite: true },
@@ -103,7 +103,15 @@ exports.MIGRATE_CONFIG = {
             from: 'package.json',
             to: 'package.json',
         },
-        // ===== 6. 切 stack =====
+        // ===== 6. 业务代码 codemod：lite → full 包名替换 =====
+        // client-toolkit@1.2.48+ 顶层 single-entry 完整覆盖 lite 全部 48 项；
+        // 扫两个目录：客户端业务代码（client/src）+ 客户端服务端共享代码（shared）—
+        // shared 也可能引 lite 的类型 / utils（如 IUserProfile / IFileAttachment / logger），
+        // lite dep 已被 delete-json-keys 删，shared 里残留 lite import 会导致 typecheck/build 报错。
+        // codemod 覆盖 named import / dynamic import / require / export ... from / CSS @import。
+        { type: 'codemod-client-toolkit-lite', root: 'client/src' },
+        { type: 'codemod-client-toolkit-lite', root: 'shared' },
+        // ===== 7. 切 stack =====
         // 收尾：把 .spark/meta.json 的 stack 切到 nestjs-react-fullstack，后续 miaoda app sync
         // 会按新 stack 的 SyncConfig 跑
         { type: 'set-stack', stack: 'nestjs-react-fullstack' },

package/dist/config/sync-configs/design-stack.js

@@ -42,7 +42,7 @@ exports.SYNC_CONFIG = {
             command: 'node scripts/hooks/run-precommit.js',
             overwrite: false,
         },
-        // 2. .gitignore 卫生：移除 package-lock.json + 加 .agent/
+        // 2. .gitignore 卫生：移除 package-lock.json + 加 .agent/ / .npm_cache
         {
             type: 'remove-line',
             to: '.gitignore',
@@ -53,6 +53,11 @@ exports.SYNC_CONFIG = {
             to: '.gitignore',
             line: '.agent/',
         },
+        {
+            type: 'add-line',
+            to: '.gitignore',
+            line: '.npm_cache',
+        },
         // 3. 老 npm scripts 迁移（裸 fullstack-cli → 钉版 npx）。两条 ifStartsWith 分别覆盖
         //    "裸 fullstack-cli"（最老形态）和 "npx 未钉版" 形态，统一升到 FULLSTACK_CLI_PIN_SPEC。
         {

package/dist/config/sync-configs/nestjs-react-fullstack.js

@@ -113,6 +113,12 @@ exports.SYNC_CONFIG = {
             to: '.gitignore',
             line: '.agent/',
         },
+        // 7a. 确保 .gitignore 包含 .npm_cache 目录
+        {
+            type: 'add-line',
+            to: '.gitignore',
+            line: '.npm_cache',
+        },
         // 8. 同步 .spark_project 配置文件（总是覆盖）
         {
             type: 'file',

package/dist/services/deploy/modern/atoms/local-release.js

@@ -10,13 +10,8 @@ const logger_1 = require("../../../../utils/logger");
  * 创建本地发布单（加锁；不挂 pipeline）。
  * 返回的 releaseId 必须由 finalizeLocalRelease 翻为终态，否则发布单一直挂着。
  */
-async function createLocalRelease(appId, version, extra) {
-    return (0, index_1.createLocalRelease)({
-        appID: appId,
-        version,
-        checkPointVersion: extra?.checkPointVersion,
-        commitID: extra?.commitID,
-    });
+async function createLocalRelease(appId, version) {
+    return (0, index_1.createLocalRelease)({ appID: appId, version });
 }
 /**
  * 把本地发布单翻为终态。Finished / Failed 由 pipeline 视上下游结果决定。

package/dist/services/deploy/modern/pipelines/local.js

@@ -43,10 +43,7 @@ async function localBuildLocalPublishPipeline(opts) {
         });
     }
     (0, logger_1.log)('deploy', 'Creating local release...');
-    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version, {
-        checkPointVersion: opts.checkPointVersion,
-        commitID: opts.commitID,
-    });
+    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version);
     try {
         (0, logger_1.log)('deploy', 'Uploading artifacts...');
         await (0, index_1.uploadArtifacts)({ projectDir: ctx.projectDir, appId: ctx.appId, data });

package/dist/utils/codemod-client-toolkit-lite.js

@@ -1,21 +1,22 @@
 "use strict";
 /**
- * Codemod：把 `@lark-apaas/client-toolkit-lite` 的 import 改写到 `@lark-apaas/client-toolkit`
- * 的对应子路径。
+ * Codemod：把 `@lark-apaas/client-toolkit-lite` 的 import 改写到 `@lark-apaas/client-toolkit`。
  *
  * 用于 `miaoda app migrate vite-react → nestjs-react-fullstack`：迁移后让两个包共存属于
- * lib 冗余（两份 react / 两套主题 / 两套 axios），所以扫 client/src 把 lite import 改写到
- * full 等价子路径，然后用 delete-json-keys 移除 lite dep。
+ * lib 冗余（两份 react / 两套主题 / 两套 axios），所以扫 user 代码把 lite import 改写到
+ * full，然后用 delete-json-keys 移除 lite dep。
  *
- * 表的来源：grep client-toolkit lib/ 目录定位每个 lite symbol 的 d.ts 路径，subpath 取相对
- * 路径。同 symbol 多个 d.ts 时按优先级选最合理的——例如 AppContainer 优先 `components/` 而
- * 非 `apis/components/`（跟 fullstack template 自带 client/src/index.tsx 的约定一致）。
+ * 实现策略：单行包名替换。
+ *
+ * client-toolkit 自 v1.2.48 起在顶层 single-entry 完整 re-export 了 client-toolkit-lite
+ * 的全部 48 项（components / hooks / utils / integrations / logger / trace / types /
+ * constants），跟 lite 同名同签 —— 所以 codemod 只需把 import 来源包名从 `-lite` 换掉，
+ * specifier 列表完全不动。CSS `@import` 同理（client-toolkit 顶层加了 ./styles.css 别名）。
  *
  * 边界：
  *   - 仅处理形如 `import [type] { A, B as C } from '@lark-apaas/client-toolkit-lite'` 的
- *     单行 named import。default import / namespace import / 跨多行 specifier 表当作 unmapped。
- *   - 表里没有的 symbol：保留原 import 行 + 加一行 `// TODO[migrate]: ...` 注释；后续 build
- *     会因为 lite dep 被删而失败，提示用户手动处理。
+ *     named import；default import / namespace import / 跨多行 specifier 当前不识别，
+ *     但只要 `from '...lite'` 在同一行，包名替换仍有效（regex 抓 from 段）。
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -26,68 +27,10 @@ exports.rewriteCssText = rewriteCssText;
 exports.rewriteText = rewriteText;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-/** lite 38 个 export → full 子路径的映射表 */
-const SYMBOL_MAP = {
-    // === 组件（apis/components 是 lite 兼容层，components 是基础层） ===
-    ActiveLink: { subpath: 'apis/components/ActiveLink' },
-    AppContainer: { subpath: 'components/AppContainer' },
-    ErrorRender: { subpath: 'components/ErrorRender' },
-    NavLink: { subpath: 'apis/components/NavLink' },
-    PagePlaceholder: { subpath: 'components/PagePlaceholder' },
-    QueryProvider: { subpath: 'components/QueryProvider' },
-    UniversalLink: { subpath: 'apis/components/UniversalLink' },
-    Welcome: { subpath: 'apis/components/Welcome' },
-    // === 类型 ===
-    AppInfoPayload: { subpath: 'types/common' },
-    IFileAttachment: { subpath: 'apis/udt-types' },
-    IJson: { subpath: 'apis/udt-types' },
-    IUserProfile: { subpath: 'apis/udt-types' },
-    LogLevel: { subpath: 'logger/log-types' },
-    LogWithMeta: { subpath: 'logger/log-types' },
-    TrackKey: { subpath: 'types/tea' },
-    TrackParams: { subpath: 'types/tea' },
-    // === 图片资源（lite 端用了 alias：avatar→avatarImages 等） ===
-    avatarImages: { subpath: 'apis/constants/img-resources/avatar', sourceName: 'avatar' },
-    bannerImages: { subpath: 'apis/constants/img-resources/banner', sourceName: 'banner' },
-    coverImages: { subpath: 'apis/constants/img-resources/cover', sourceName: 'cover' },
-    // === Hooks ===
-    useAppInfo: { subpath: 'hooks/useAppInfo' },
-    useCurrentUserProfile: { subpath: 'hooks/useCurrentUserProfile' },
-    useIsMobile: { subpath: 'hooks/useIsMobile' },
-    useLogout: { subpath: 'hooks/useLogout' },
-    // === Utils / 工具函数 ===
-    axiosForBackend: { subpath: 'utils/getAxiosForBackend' },
-    capabilityClient: { subpath: '' }, // 在 full 顶层 export
-    clsxWithTw: { subpath: 'utils/utils' },
-    copyToClipboard: { subpath: 'utils/copyToClipboard' },
-    getAppId: { subpath: 'utils/getAppId' },
-    getAppInfo: { subpath: 'integrations/getAppInfo' },
-    getAxiosForBackend: { subpath: 'utils/getAxiosForBackend' },
-    getCsrfToken: { subpath: 'utils/getCsrfToken' },
-    getCurrentUserProfile: { subpath: 'integrations/getCurrentUserProfile' },
-    getDataloom: { subpath: 'apis/dataloom' },
-    getEnvPath: { subpath: 'utils/getEnvPath' },
-    getWsPath: { subpath: 'utils/utils' },
-    initAxiosConfig: { subpath: 'utils/axiosConfig' },
-    initObservable: { subpath: 'runtime/observable' },
-    isIOS: { subpath: 'utils/deviceType' },
-    isIpad: { subpath: 'utils/deviceType' },
-    isMobile: { subpath: 'utils/deviceType' },
-    isPreview: { subpath: 'utils/utils' },
-    logger: { subpath: 'apis/logger' },
-    normalizeBasePath: { subpath: 'utils/utils' },
-    reportTeaEvent: { subpath: 'components/AppContainer/utils/tea' },
-    resolveAppUrl: { subpath: 'utils/resolveAppUrl' },
-    safeStringify: { subpath: 'utils/safeStringify' },
-    scopedStorage: { subpath: 'apis/utils/scopedStorage' },
-    trace: { subpath: 'trace/index' },
-};
 const LITE_PKG = '@lark-apaas/client-toolkit-lite';
 const FULL_PKG = '@lark-apaas/client-toolkit';
 /**
  * 递归扫描 rootDir 下的 .ts/.tsx/.js/.jsx/.css 文件，把 lite import 改写到 full。
- * css 里 `@import "@lark-apaas/client-toolkit-lite/styles.css"` 同样要重写到
- * `@lark-apaas/client-toolkit/lib/index.css`，否则 css build 会因 lite dep 被删而 ENOENT。
  */
 function rewriteLiteImports(rootDir) {
     const result = {
@@ -108,8 +51,7 @@ function rewriteLiteImports(rootDir) {
         if (!before.includes(LITE_PKG))
             continue;
         const rel = node_path_1.default.relative(rootDir, file);
-        const { text, count, unmapped } = isJs ? rewriteText(before, rel) : rewriteCssText(before, rel);
-        result.unmapped.push(...unmapped);
+        const { text, count } = isJs ? rewriteText(before, rel) : rewriteCssText(before, rel);
         if (count > 0) {
             node_fs_1.default.writeFileSync(file, text);
             result.filesChanged.push(rel);
@@ -119,128 +61,35 @@ function rewriteLiteImports(rootDir) {
     return result;
 }
 /**
- * css 改写器：把 `@import "@lark-apaas/client-toolkit-lite/styles.css"` 重写到 full 的入口
- * `@lark-apaas/client-toolkit/lib/index.css`；其他 lite styles 子路径（如 `styles/*`）
- * 在 full 里没有对等物，留下 TODO 注释让用户手动处理。
+ * css 改写器：单行包名替换。`@import "@lark-apaas/client-toolkit-lite/<path>"` →
+ * `@import "@lark-apaas/client-toolkit/<path>"`。其中 styles.css 在 full 端已加同名别名
+ * 指向 ./lib/index.css。
  */
-function rewriteCssText(source, fileLabel) {
-    const unmapped = [];
+function rewriteCssText(source, _fileLabel) {
     let count = 0;
-    const lines = source.split('\n');
-    const out = [];
-    // 匹配 `@import "@lark-apaas/client-toolkit-lite/<path>";` 或 single quote
-    const re = /^(\s*)@import\s+['"]@lark-apaas\/client-toolkit-lite\/([^'"]+)['"]\s*;?\s*$/;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const m = re.exec(line);
-        if (!m) {
-            out.push(line);
-            continue;
-        }
-        const captures = m;
-        const indent = captures[1] ?? '';
-        const subpath = captures[2] ?? '';
-        if (subpath === 'styles.css') {
-            out.push(`${indent}@import "${FULL_PKG}/lib/index.css";`);
-            count++;
-        }
-        else {
-            // styles/* 等子路径 full 没对等物，保留原行 + TODO（build 会失败）
-            out.push(line);
-            out.push(`${indent}/* TODO[migrate]: @lark-apaas/client-toolkit-lite/${subpath} has no known mapping in @lark-apaas/client-toolkit; replace manually. */`);
-            unmapped.push({ file: fileLabel, symbol: subpath, line: i + 1 });
-        }
-    }
-    return { text: out.join('\n'), count, unmapped };
+    const re = /(@import\s+['"])@lark-apaas\/client-toolkit-lite(\/[^'"]*)?(['"])/g;
+    const text = source.replace(re, (_match, p1, sub, p3) => {
+        count++;
+        return `${p1}${FULL_PKG}${sub ?? ''}${p3}`;
+    });
+    return { text, count, unmapped: [] };
 }
-/** 对单个文件文本做改写。导出供单测直接验证。 */
-function rewriteText(source, fileLabel) {
-    const unmapped = [];
+/**
+ * JS/TS 文件改写器：把任何 `from '@lark-apaas/client-toolkit-lite'` 改成 full 包名。
+ * specifier 列表完全保留 —— full 顶层 single-entry 已经兼容 lite 全部 48 项 export。
+ *
+ * 同样兼容 dynamic import / require / `export ... from` 等其他形式（只要包名字符串在）。
+ */
+function rewriteText(source, _fileLabel) {
     let count = 0;
-    const lines = source.split('\n');
-    const out = [];
-    // 匹配单行 named import：捕获 indent / `type ` 修饰符 / specifier 段
-    const reImport = /^(\s*)import\s+(type\s+)?\{([^}]+)\}\s+from\s+['"]@lark-apaas\/client-toolkit-lite['"]\s*;?\s*$/;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const m = reImport.exec(line);
-        if (!m) {
-            out.push(line);
-            continue;
-        }
-        // RegExp.exec 返回 string[]，但 optional capture group 实际可能是 undefined。
-        // 显式 cast 让 TS narrow 配合 eslint no-unnecessary-condition 不报"永远 truthy"。
-        const captures = m;
-        const indent = captures[1] ?? '';
-        const wholeIsType = captures[2] !== undefined;
-        const specifiers = parseSpecifiers(captures[3] ?? '');
-        // 按 target subpath 分组（同 subpath 的 specifier 合并到一条 import）
-        const groups = new Map();
-        const localUnmapped = [];
-        for (const spec of specifiers) {
-            // SYMBOL_MAP 是 Record，TS 默认推断索引返回非 undefined；用 hasOwnProperty 做 narrow
-            if (!Object.prototype.hasOwnProperty.call(SYMBOL_MAP, spec.imported)) {
-                localUnmapped.push(spec.imported);
-                unmapped.push({ file: fileLabel, symbol: spec.imported, line: i + 1 });
-                continue;
-            }
-            const info = SYMBOL_MAP[spec.imported];
-            const target = info.subpath ? `${FULL_PKG}/${info.subpath}` : FULL_PKG;
-            const sourceName = info.sourceName ?? spec.imported;
-            const isType = wholeIsType || spec.isType;
-            const entry = groups.get(target) ?? { items: [], allTypes: true };
-            entry.items.push({ source: sourceName, local: spec.local, isType });
-            entry.allTypes = entry.allTypes && isType;
-            groups.set(target, entry);
-            count++;
-        }
-        if (groups.size === 0) {
-            // 全部 unmapped：保留原行 + TODO 注释
-            out.push(line);
-            out.push(`${indent}// TODO[migrate]: '${localUnmapped.join(', ')}' has no known mapping from '${LITE_PKG}' to '${FULL_PKG}'; replace manually before building.`);
-            continue;
-        }
-        // 输出 group 化的新 import 行（同 target 下区分 type-only / 混合）
-        for (const [target, { items, allTypes }] of groups) {
-            if (allTypes) {
-                const inner = items.map(fmtSpec).join(', ');
-                out.push(`${indent}import type { ${inner} } from '${target}';`);
-            }
-            else {
-                // 把 type 和非 type 分两条输出更稳：避免 `import { type X, Y }` 在某些工具链下不被支持
-                const typeItems = items.filter((it) => it.isType);
-                const valItems = items.filter((it) => !it.isType);
-                if (typeItems.length > 0) {
-                    out.push(`${indent}import type { ${typeItems.map(fmtSpec).join(', ')} } from '${target}';`);
-                }
-                out.push(`${indent}import { ${valItems.map(fmtSpec).join(', ')} } from '${target}';`);
-            }
-        }
-        if (localUnmapped.length > 0) {
-            out.push(`${indent}// TODO[migrate]: '${localUnmapped.join(', ')}' has no known mapping from '${LITE_PKG}' to '${FULL_PKG}'; replace manually before building.`);
-        }
-    }
-    return { text: out.join('\n'), count, unmapped };
-}
-function fmtSpec(s) {
-    return s.local === s.source ? s.source : `${s.source} as ${s.local}`;
-}
-function parseSpecifiers(raw) {
-    const out = [];
-    for (const part of raw.split(',')) {
-        const t = part.trim();
-        if (!t)
-            continue;
-        const m = /^(type\s+)?([A-Za-z_$][A-Za-z0-9_$]*)(?:\s+as\s+([A-Za-z_$][A-Za-z0-9_$]*))?$/.exec(t);
-        if (!m)
-            continue;
-        const captures = m;
-        const imported = captures[2];
-        if (imported === undefined)
-            continue;
-        out.push({ isType: captures[1] !== undefined, imported, local: captures[3] ?? imported });
-    }
-    return out;
+    // 既匹配 `from 'pkg'` 也匹配 `from "pkg"`，单双引号都管。
+    // 同时覆盖 `import('pkg')` / `require('pkg')` 等其他常见形态。
+    const re = /(['"])@lark-apaas\/client-toolkit-lite(['"])/g;
+    const text = source.replace(re, (_match, p1, p2) => {
+        count++;
+        return `${p1}${FULL_PKG}${p2}`;
+    });
+    return { text, count, unmapped: [] };
 }
 function* walk(dir) {
     for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.16-alpha.0",
+  "version": "0.1.16-alpha.f6825fa",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -17,20 +17,6 @@
     "dist",
     "upgrade"
   ],
-  "scripts": {
-    "build": "bash scripts/build.sh",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "lint": "eslint src/ --max-warnings 0",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/",
-    "test": "vitest run --project=unit",
-    "test:watch": "vitest --project=unit",
-    "test:integration": "vitest run --project=integration",
-    "dev": "node --import tsx src/main.ts",
-    "cli": "node --env-file-if-exists=integration/.env --import tsx src/main.ts",
-    "prepare": "husky",
-    "prepublishOnly": "pnpm format:check && pnpm lint && pnpm build && pnpm test"
-  },
   "keywords": [
     "miaoda",
     "cli",
@@ -65,5 +51,16 @@
     "vitest": "^4.1.4",
     "xml2js": "^0.6.2"
   },
-  "packageManager": "pnpm@10.16.1+sha512.0e155aa2629db8672b49e8475da6226aa4bdea85fdcdfdc15350874946d4f3c91faaf64cbdc4a5d1ab8002f473d5c3fcedcd197989cf0390f9badd3c04678706"
-}
+  "scripts": {
+    "build": "bash scripts/build.sh",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src/ --max-warnings 0",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "test": "vitest run --project=unit",
+    "test:watch": "vitest --project=unit",
+    "test:integration": "vitest run --project=integration",
+    "dev": "node --import tsx src/main.ts",
+    "cli": "node --env-file-if-exists=integration/.env --import tsx src/main.ts"
+  }
+}