@vectorx/xhs-cloud-cli 0.0.0-beta-20260108133839 → 0.0.0-beta-20260320063305

package/lib/commands/fun/new.js

@@ -0,0 +1,151 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FunNewCommand = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const base_1 = require("../../core/base");
+const decorators_1 = require("../../decorators");
+const templates_1 = require("../../utils/templates");
+let FunNewCommand = class FunNewCommand extends base_1.Command {
+    execute(options, log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let { projectName, dir, template } = options;
+            if (!projectName) {
+                const { projectName: inputName } = yield inquirer_1.default.prompt([
+                    {
+                        type: "input",
+                        name: "projectName",
+                        message: "请输入项目名称：",
+                        validate: (v) => ((v || "").trim() ? true : "项目名称不能为空"),
+                    },
+                ]);
+                projectName = (inputName || "").trim();
+            }
+            if (!projectName) {
+                log.error("项目名称不能为空");
+                process.exit(1);
+            }
+            const targetDir = dir || process.cwd();
+            const projectDir = path_1.default.join(targetDir, projectName);
+            if (fs_1.default.existsSync(projectDir)) {
+                log.error(`项目目录已存在: ${projectDir}`);
+                process.exit(1);
+            }
+            const templateId = yield (0, templates_1.selectTemplate)("cloud-dev", { template });
+            const templateDir = (0, templates_1.resolveTemplatePath)("cloud-dev", templateId);
+            if (!fs_1.default.existsSync(templateDir)) {
+                log.error(`模板目录不存在: ${templateDir}`);
+                throw new Error(`模板目录不存在: ${templateDir}`);
+            }
+            log.breakLine();
+            console.log(chalk_1.default.bold.blue("📋 云函数项目创建信息"));
+            console.log(chalk_1.default.gray("─".repeat(40)));
+            console.log(chalk_1.default.bold("创建目录:   ") + chalk_1.default.green(projectDir));
+            console.log(chalk_1.default.bold("目录名称:   ") + chalk_1.default.cyan(projectName));
+            console.log(chalk_1.default.bold("使用模板:   ") + chalk_1.default.cyan(templateId));
+            console.log(chalk_1.default.gray("─".repeat(40)));
+            log.breakLine();
+            const spinnerCopy = require("ora")("复制模板文件...").start();
+            try {
+                yield this.copyTemplate(templateDir, projectDir);
+                spinnerCopy.succeed("模板文件复制完成");
+            }
+            catch (e) {
+                spinnerCopy.fail("模板文件复制失败: " + e.message);
+                throw e;
+            }
+            log.breakLine();
+            log.info(`✔️ 云函数项目创建成功: ${projectDir}`);
+            log.info("下一步操作:");
+            log.info(`  - cd ${projectDir}`);
+            log.info("  - npm install");
+            log.info("  - npm run dev");
+            log.breakLine();
+            console.log(chalk_1.default.bgYellow.black(" ⚠️  重要：配置云环境 "));
+            console.log(chalk_1.default.yellow("云函数发布前需指定目标云环境："));
+            console.log(chalk_1.default.gray("  • 前往开放平台创建云环境（若尚未创建）"));
+            console.log(chalk_1.default.cyan("  • rcb env list            — 查看当前账号下的云环境列表"));
+            console.log(chalk_1.default.cyan("  • rcb env set -e <envId>  — 指定当前云函数要发布的环境"));
+            log.breakLine();
+        });
+    }
+    copyTemplate(sourceDir, targetDir) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!fs_1.default.existsSync(targetDir)) {
+                fs_1.default.mkdirSync(targetDir, { recursive: true });
+            }
+            const files = fs_1.default.readdirSync(sourceDir);
+            for (const file of files) {
+                const sourcePath = path_1.default.join(sourceDir, file);
+                const targetPath = path_1.default.join(targetDir, file);
+                const stat = fs_1.default.statSync(sourcePath);
+                if (stat.isDirectory()) {
+                    yield this.copyTemplate(sourcePath, targetPath);
+                }
+                else {
+                    fs_1.default.copyFileSync(sourcePath, targetPath);
+                }
+            }
+        });
+    }
+    get options() {
+        return {
+            cmd: "fun",
+            childCmd: "new",
+            desc: "创建新的云函数项目",
+            usage: "rcb fun new [projectName]",
+            options: [
+                {
+                    flags: "-d, --dir <dir>",
+                    desc: "指定项目创建的目标目录，默认为当前目录",
+                },
+                {
+                    flags: "-p, --projectName <projectName>",
+                    desc: "指定项目名称，默认为当前目录名称",
+                },
+                {
+                    flags: "-t, --template <template>",
+                    desc: "指定模板 ID，不传则交互式选择",
+                },
+            ],
+        };
+    }
+};
+exports.FunNewCommand = FunNewCommand;
+__decorate([
+    (0, decorators_1.InjectParams)(),
+    __param(0, (0, decorators_1.ArgsOptions)()),
+    __param(1, (0, decorators_1.Log)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Function]),
+    __metadata("design:returntype", Promise)
+], FunNewCommand.prototype, "execute", null);
+exports.FunNewCommand = FunNewCommand = __decorate([
+    (0, base_1.ICommand)()
+], FunNewCommand);

package/lib/commands/index.js

@@ -16,3 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth"), exports);
 __exportStar(require("./agent"), exports);
+__exportStar(require("./fun"), exports);
+__exportStar(require("./env"), exports);

package/lib/constants/cmd.js

@@ -25,13 +25,13 @@ exports.ALL_COMMANDS = [
     "env domain list",
     "env domain create",
     "env domain delete",
-    "fn list",
-    "fn download",
-    "fn deploy",
-    "fn delete",
-    "fn detail",
-    "fn code update",
-    "fn invoke",
-    "fn publish-version",
-    "fn list-function-versions",
+    "fun list",
+    "fun download",
+    "fun deploy",
+    "fun delete",
+    "fun detail",
+    "fun code update",
+    "fun invoke",
+    "fun publish-version",
+    "fun list-function-versions",
 ];

package/lib/core/base.js

@@ -8,10 +8,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Command = exports.registrableCommands = void 0;
 exports.ICommand = ICommand;
+const cloud_toolkit_1 = require("@vectorx/cloud-toolkit");
 const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
 exports.registrableCommands = [];
 function ICommand() {
     return (target) => {
@@ -23,6 +28,11 @@ class Command {
     init() {
         const { cmd, childCmd, childSubCmd, deprecateCmd } = this.options;
         let instance;
+        const mainCommandDescriptions = {
+            agent: "开发与构建 AI Agent",
+            fun: "管理 Fun 云函数调试与部署",
+            env: "管理云环境（Environment）",
+        };
         if (cmdMap.has(cmd)) {
             instance = cmdMap.get(cmd);
         }
@@ -30,6 +40,9 @@ class Command {
             instance = commander_1.program.command(cmd);
             instance._helpDescription = "输出帮助信息";
             instance.addHelpCommand("help [command]", "查看命令帮助信息");
+            if (childCmd && mainCommandDescriptions[cmd]) {
+                instance.description(mainCommandDescriptions[cmd]);
+            }
             cmdMap.set(cmd, instance);
         }
         if (childCmd) {
@@ -85,10 +98,79 @@ class Command {
         });
         instance.description(desc);
         instance.action((...args) => __awaiter(this, void 0, void 0, function* () {
+            const loading = (0, ora_1.default)({ text: "执行中...", color: "cyan" }).start();
             const params = args.slice(0, -1);
+            const commandObj = args[args.length - 1];
             const cmdOptions = instance.opts();
+            const normalizeCmdPath = (raw) => {
+                var _a, _b;
+                const parts = String(raw || "")
+                    .trim()
+                    .split(/\s+/)
+                    .filter(Boolean);
+                if (!parts.length)
+                    return cmd;
+                const head = (_b = (_a = parts[0]) === null || _a === void 0 ? void 0 : _a.toLowerCase) === null || _b === void 0 ? void 0 : _b.call(_a);
+                if (head === "rcb" || head === "tcb") {
+                    parts.shift();
+                }
+                return parts.join(" ");
+            };
+            const buildFullCmdPath = () => {
+                const { childCmd, childSubCmd } = this.options;
+                const cmdParts = [cmd];
+                if (childCmd) {
+                    const childCmdName = typeof childCmd === "string" ? childCmd : childCmd.cmd;
+                    cmdParts.push(childCmdName);
+                }
+                if (childSubCmd) {
+                    cmdParts.push(childSubCmd);
+                }
+                return cmdParts.join(" ");
+            };
+            const rawCmdPath = typeof (commandObj === null || commandObj === void 0 ? void 0 : commandObj.commandPath) === "function"
+                ? commandObj.commandPath()
+                :
+                    typeof (instance === null || instance === void 0 ? void 0 : instance.commandPath) === "function"
+                        ?
+                            instance.commandPath()
+                        : null;
+            let cmdPath = rawCmdPath ? normalizeCmdPath(rawCmdPath) : buildFullCmdPath();
+            const expectedParts = [cmd];
+            if (this.options.childCmd) {
+                expectedParts.push(typeof this.options.childCmd === "string"
+                    ? this.options.childCmd
+                    : this.options.childCmd.cmd);
+            }
+            if (this.options.childSubCmd) {
+                expectedParts.push(this.options.childSubCmd);
+            }
+            const cmdPathParts = cmdPath.split(/\s+/).filter(Boolean);
+            if (cmdPathParts.length < expectedParts.length) {
+                cmdPath = buildFullCmdPath();
+            }
+            const optionsKeys = Object.keys(cmdOptions || {})
+                .filter((k) => !k.startsWith("_"))
+                .filter((k) => k !== "help" && k !== "version")
+                .filter((k) => typeof (cmdOptions === null || cmdOptions === void 0 ? void 0 : cmdOptions[k]) !== "undefined");
+            const tracker = (0, cloud_toolkit_1.createCliCommandTracker)({
+                cmd_path: cmdPath,
+                cmd_root: cmd,
+                params_count: params.length,
+                options_keys: optionsKeys,
+            });
+            const startTime = Date.now();
             const ctx = { cmd, params, options: cmdOptions };
-            yield this.execute(ctx);
+            loading.stop();
+            try {
+                const res = yield this.execute(ctx);
+                tracker.reportSuccess(Date.now() - startTime);
+                return res;
+            }
+            catch (err) {
+                tracker.reportFail(Date.now() - startTime, err);
+                throw err;
+            }
         }));
     }
 }

package/lib/decorators/auth.js

@@ -35,10 +35,17 @@ function AuthGuard() {
                     cloud_toolkit_1.logger.error(`Warning: 执行当前命令需要先登录~`);
                     cloud_toolkit_1.logger.breakLine();
                     console.log(chalk_1.default.yellow("💡提示：请先执行登录命令"));
-                    console.log(chalk_1.default.gray("  使用命令: ") + chalk_1.default.cyan("rcb login --secretId <secretId> --secretKey <secretKey>"));
+                    console.log(chalk_1.default.gray("  使用命令: ") +
+                        chalk_1.default.cyan("rcb login --secretId <secretId> --secretKey <secretKey>"));
                     cloud_toolkit_1.logger.breakLine();
                     console.log(chalk_1.default.gray("🔗 获取登录秘钥：https://miniapp.xiaohongshu.com/console-panel"));
                     cloud_toolkit_1.logger.breakLine();
+                    try {
+                        (0, cloud_toolkit_1.reportCliException)("uncaughtException", new Error("Auth required: please login first"));
+                        yield new Promise((r) => setTimeout(r, 250));
+                    }
+                    catch (_a) {
+                    }
                     process.exit(1);
                 }
                 return originalExecute.call(this, ctx);

package/lib/decorators/captureError.js

@@ -20,6 +20,7 @@ const CaptureError = () => (target, key, descriptor) => {
             }
             catch (e) {
                 const errMsg = (e === null || e === void 0 ? void 0 : e.message) || (typeof (e === null || e === void 0 ? void 0 : e.toString) === "function" ? e.toString() : "") || "Unknown Error";
+                throw e;
             }
         });
     };

package/lib/main.js

@@ -11,10 +11,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommands = registerCommands;
 require("reflect-metadata");
+const cloud_toolkit_1 = require("@vectorx/cloud-toolkit");
 const base_1 = require("./core/base");
 require("./commands");
 function registerCommands() {
     return __awaiter(this, void 0, void 0, function* () {
+        try {
+            (0, cloud_toolkit_1.initCliApm)({
+                cliVersion: (process === null || process === void 0 ? void 0 : process.CLI_VERSION) || "unknown",
+            });
+        }
+        catch (e) {
+        }
         base_1.registrableCommands.forEach(({ Command }) => new Command().init());
     });
 }

package/lib/utils/agent-check.js

@@ -0,0 +1,158 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAndGuideAgentProject = checkAndGuideAgentProject;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const cloud_toolkit_1 = require("@vectorx/cloud-toolkit");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const open_1 = __importDefault(require("open"));
+const OPEN_PLATFORM_URL = "https://miniapp.xiaohongshu.com/app-choose";
+function isPlaceholder(value) {
+    if (!value || !value.trim())
+        return true;
+    const v = value.trim();
+    return v.startsWith("[") || v.includes("从开放平台获取");
+}
+function readProjectConfig(workDir) {
+    const configPath = path_1.default.join(workDir, "project.config.json");
+    if (!fs_1.default.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs_1.default.readFileSync(configPath, "utf-8"));
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function writeProjectConfig(workDir, updates) {
+    var _a;
+    const configPath = path_1.default.join(workDir, "project.config.json");
+    const existing = (_a = readProjectConfig(workDir)) !== null && _a !== void 0 ? _a : {};
+    const next = Object.assign(Object.assign(Object.assign(Object.assign({}, existing), { agentId: updates.agentId }), (updates.name !== undefined ? { name: updates.name } : {})), (updates.desc !== undefined ? { desc: updates.desc } : {}));
+    fs_1.default.writeFileSync(configPath, JSON.stringify(next, null, 2), "utf-8");
+}
+function openUrl(url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield (0, open_1.default)(url);
+        }
+        catch (_a) {
+            console.log(chalk_1.default.cyan(`请手动访问：${url}`));
+        }
+    });
+}
+function checkAndGuideAgentProject(workDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const config = readProjectConfig(workDir);
+        if (!config || !("agentId" in config)) {
+            return undefined;
+        }
+        const rawAgentId = config.agentId;
+        if (isPlaceholder(rawAgentId)) {
+            console.log(chalk_1.default.yellow("\n⚠️  检测到 project.config.json 中的 agentId 尚未配置，正在引导您关联智能体..."));
+            return yield selectAndBindAgent(workDir);
+        }
+        try {
+            const detail = yield (0, cloud_toolkit_1.getAgentInfoById)(rawAgentId);
+            if (!detail) {
+                console.log(chalk_1.default.yellow(`\n⚠️  project.config.json 中的 agentId「${rawAgentId}」在当前账号下未找到，正在引导您重新关联...`));
+                return yield selectAndBindAgent(workDir);
+            }
+            const remoteName = (_a = detail.agentName) !== null && _a !== void 0 ? _a : "";
+            const remoteDesc = (_b = detail.description) !== null && _b !== void 0 ? _b : "";
+            const localName = (_c = config.name) !== null && _c !== void 0 ? _c : "";
+            const localDesc = (_d = config.desc) !== null && _d !== void 0 ? _d : "";
+            const localAgentId = (_e = config.agentId) !== null && _e !== void 0 ? _e : "";
+            const needsUpdate = localAgentId !== detail.agentId || localName !== remoteName || localDesc !== remoteDesc;
+            if (needsUpdate) {
+                writeProjectConfig(workDir, {
+                    agentId: detail.agentId,
+                    name: remoteName,
+                    desc: remoteDesc,
+                });
+                console.log(chalk_1.default.green(`✅ 已同步 project.config.json（agentId: ${detail.agentId}，name: ${remoteName || "(空)"}，desc: ${remoteDesc || "(空)"}）`));
+            }
+            else {
+                console.log(chalk_1.default.gray(`ℹ️  project.config.json 与开放平台一致，无需更新（agentId: ${detail.agentId}）`));
+            }
+            return detail.agentId;
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  校验 agentId 时出现错误（${(_f = err === null || err === void 0 ? void 0 : err.message) !== null && _f !== void 0 ? _f : String(err)}），将跳过校验直接启动。`));
+            return rawAgentId;
+        }
+    });
+}
+function selectAndBindAgent(workDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        let agentList = [];
+        try {
+            agentList = yield (0, cloud_toolkit_1.getAgentList)({ pageNo: 1, pageSize: 50 });
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  获取智能体列表失败（${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : String(err)}），将跳过关联直接启动。`));
+            return undefined;
+        }
+        if (!agentList || agentList.length === 0) {
+            console.log("");
+            console.log(chalk_1.default.bold.yellow("你好，您当前的账号下没有智能体，请先去开放平台创建智能体："));
+            console.log(chalk_1.default.cyan(OPEN_PLATFORM_URL));
+            console.log("");
+            yield openUrl(OPEN_PLATFORM_URL);
+            process.exit(0);
+        }
+        let selectedId;
+        if (agentList.length === 1) {
+            const only = agentList[0];
+            selectedId = only.agentId;
+            console.log(chalk_1.default.green(`\n✅ 检测到您账号下只有一个智能体，已自动关联：${only.agentName}（${only.agentId}）`));
+        }
+        else {
+            console.log("");
+            const { chosenId } = yield inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "chosenId",
+                    message: "检测到您账号下有多个智能体，请选择要开发的智能体：",
+                    choices: agentList.map((a) => ({
+                        name: `${a.agentName}  ${chalk_1.default.gray(`(${a.agentId})`)}`,
+                        value: a.agentId,
+                    })),
+                },
+            ]);
+            selectedId = chosenId;
+        }
+        try {
+            const detail = yield (0, cloud_toolkit_1.getAgentInfoById)(selectedId);
+            if (detail) {
+                writeProjectConfig(workDir, {
+                    agentId: detail.agentId,
+                    name: (_b = detail.agentName) !== null && _b !== void 0 ? _b : "",
+                    desc: (_c = detail.description) !== null && _c !== void 0 ? _c : "",
+                });
+                console.log(chalk_1.default.green(`✅ project.config.json 已更新（agentId: ${detail.agentId}，name: ${detail.agentName || "(空)"}，desc: ${detail.description || "(空)"}）`));
+                return detail.agentId;
+            }
+        }
+        catch (err) {
+            console.warn(chalk_1.default.yellow(`\n⚠️  获取智能体详情失败（${(_d = err === null || err === void 0 ? void 0 : err.message) !== null && _d !== void 0 ? _d : String(err)}），将直接写入 agentId。`));
+        }
+        writeProjectConfig(workDir, { agentId: selectedId });
+        return selectedId;
+    });
+}

package/lib/utils/templates.js

@@ -0,0 +1,75 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPLATE_CATEGORIES = void 0;
+exports.loadTemplatesConfig = loadTemplatesConfig;
+exports.resolveTemplatePath = resolveTemplatePath;
+exports.selectTemplate = selectTemplate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const TEMPLATES_ROOT = path_1.default.join(__dirname, "../../templates");
+exports.TEMPLATE_CATEGORIES = {
+    "cloud-agents": path_1.default.join(TEMPLATES_ROOT, "cloud-agents"),
+    "cloud-dev": path_1.default.join(TEMPLATES_ROOT, "cloud-dev"),
+};
+function loadTemplatesConfig(category) {
+    const categoryDir = exports.TEMPLATE_CATEGORIES[category];
+    const configPath = path_1.default.join(categoryDir, "templates.json");
+    if (!fs_1.default.existsSync(configPath)) {
+        return [];
+    }
+    try {
+        const content = fs_1.default.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        if (!Array.isArray(config.templates))
+            return [];
+        return config.templates.filter((t) => {
+            const templateDir = path_1.default.join(categoryDir, t.id);
+            return fs_1.default.existsSync(templateDir) && fs_1.default.statSync(templateDir).isDirectory();
+        });
+    }
+    catch (_a) {
+        return [];
+    }
+}
+function resolveTemplatePath(category, templateId) {
+    return path_1.default.join(exports.TEMPLATE_CATEGORIES[category], templateId);
+}
+function selectTemplate(category, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const templates = loadTemplatesConfig(category);
+        if (templates.length === 0) {
+            throw new Error(`未找到可用模板，请检查 ${exports.TEMPLATE_CATEGORIES[category]}/templates.json`);
+        }
+        if (options.template) {
+            const found = templates.find((t) => t.id === options.template);
+            if (found)
+                return found.id;
+            throw new Error(`模板 "${options.template}" 不存在。可用: ${templates.map((t) => t.id).join(", ")}`);
+        }
+        const { templateId } = yield inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "templateId",
+                message: "请选择模板：",
+                choices: templates.map((t) => ({
+                    name: `${t.name} - ${t.desc}`,
+                    value: t.id,
+                })),
+            },
+        ]);
+        return templateId;
+    });
+}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@vectorx/xhs-cloud-cli",
-  "version": "0.0.0-beta-20260108133839",
+  "version": "0.0.0-beta-20260320063305",
   "description": "xhs-cloud-cli 主要用于如下场景：  - agent 调试、发布  - cloud 云函数的调试、部署",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "main": "lib/index.js",
   "types": "types/index.d.ts",
   "bin": {
@@ -16,9 +19,6 @@
   ],
   "dependencies": {
     "@koa/router": "^12.0.1",
-    "@vectorx/agent-simulator": "0.0.0-beta-20260108133839",
-    "@vectorx/cloud-toolkit": "0.0.0-beta-20260108133839",
-    "@vectorx/functions-framework": "0.0.0-beta-20260108133839",
     "address": "^1.1.2",
     "archiver": "^6.0.1",
     "camelcase-keys": "^7.0.2",
@@ -34,7 +34,7 @@
     "execa": "^4.0.3",
     "fs-extra": "^8.1.0",
     "https-proxy-agent": "^5.0.1",
-    "inquirer": "^6.5.0",
+    "inquirer": "^6.5.2",
     "inversify": "^7.5.2",
     "json-schema-to-typescript": "^14.0.5",
     "koa": "^2.16.1",
@@ -65,12 +65,16 @@
     "ws": "^8.18.2",
     "xdg-basedir": "^4.0.0",
     "yargs": "^16.2.0",
-    "yargs-parser": "^21.0.1"
+    "yargs-parser": "^21.0.1",
+    "@vectorx/agent-simulator": "0.0.0-beta-20260320063305",
+    "@vectorx/cloud-toolkit": "0.0.0-beta-20260320063305",
+    "@vectorx/function-debugger": "0.0.0-beta-20260320063305",
+    "@vectorx/functions-framework": "0.0.0-beta-20260320063305"
   },
   "devDependencies": {
     "@types/archiver": "^5.3.2",
     "@types/fs-extra": "^11.0.4",
-    "@types/inquirer": "^9.0.8",
+    "@types/inquirer": "^9.0.9",
     "@types/jest": "^27",
     "@types/koa": "^2.13.12",
     "@types/koa-bodyparser": "^4.3.12",
@@ -99,6 +103,5 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "dev": "rimraf lib types && tsc -w",
     "gen:command": "ts-node scripts/generate-command.ts"
-  },
-  "readme": "# xhs cloud 命令行工具\nxhs-cloud-cli 主要用于如下场景：\n - agent 调试、发布\n - cloud 云函数的调试、部署\n\n使用方式：\n - xhs-cloud-cli agent dev \n\n - xhs-cloud-cli cloud dev\n\n## 安装 CloudBase CLI\n\nsrc/\n├── commands/\n│   └── agent/\n│       └── dev.ts       # agent dev 命令实现\n├── core/\n│   └── server/\n│       ├── server.node.ts  # Koa 服务器实现\n│       └── function-loader.ts  # 函数加载器实现\n\n### npm\n\n```shell\nnpm install -g @cloudbase/cli\n```\n\n## 命令\n> xhs-cloud-cli\n\n## 命令\n- deploy\n- dev\n\n"
+  }
 }

package/templates/cloud-agents/agent-base-template/project.config.json

@@ -0,0 +1,6 @@
+{
+  "name": "[从开放平台获取]",
+  "agentId": "[从开放平台获取]",
+  "desc": "基础版本智能体模板",
+  "version": "0.0.1"
+}

package/templates/{chatbox-agent → cloud-agents/agent-base-template}/src/index.js

@@ -10,7 +10,6 @@ let test_answer = "你好，我是开放平台智能体，我可以为你做很
  */
 class MyAgent extends AgentRuntime {
   async sendMessage(message) {
-    console.log("==== message ====", JSON.stringify(message, null, 2));  
     return new Promise((res) => { 
       const charArr = test_answer.split("")
 

package/templates/cloud-agents/agent-doc-template/.env.template

@@ -0,0 +1 @@
+# 环境变量模板，复制为 .env 后填写