@vectorx/xhs-cloud-cli 1.0.0 → 1.1.0

package/lib/commands/fun/new.js

@@ -28,12 +28,25 @@ 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* () {
-            const { projectName, dir } = options;
+            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);
@@ -44,18 +57,20 @@ let FunNewCommand = class FunNewCommand extends base_1.Command {
                 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 templateDir = path_1.default.join(__dirname, "../../../", "templates", "ai-cloud-functions-example");
-            if (!fs_1.default.existsSync(templateDir)) {
-                log.error(`模板目录不存在: ${templateDir}`);
-                throw new Error(`模板目录不存在: ${templateDir}`);
-            }
             const spinnerCopy = require("ora")("复制模板文件...").start();
             try {
                 yield this.copyTemplate(templateDir, projectDir);
@@ -71,6 +86,13 @@ let FunNewCommand = class FunNewCommand extends base_1.Command {
             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) {
@@ -107,6 +129,10 @@ let FunNewCommand = class FunNewCommand extends base_1.Command {
                     flags: "-p, --projectName <projectName>",
                     desc: "指定项目名称，默认为当前目录名称",
                 },
+                {
+                    flags: "-t, --template <template>",
+                    desc: "指定模板 ID，不传则交互式选择",
+                },
             ],
         };
     }

package/lib/core/base.js

@@ -8,11 +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) => {
@@ -94,6 +98,7 @@ 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();
@@ -133,7 +138,9 @@ class Command {
             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);
+                expectedParts.push(typeof this.options.childCmd === "string"
+                    ? this.options.childCmd
+                    : this.options.childCmd.cmd);
             }
             if (this.options.childSubCmd) {
                 expectedParts.push(this.options.childSubCmd);
@@ -154,6 +161,7 @@ class Command {
             });
             const startTime = Date.now();
             const ctx = { cmd, params, options: cmdOptions };
+            loading.stop();
             try {
                 const res = yield this.execute(ctx);
                 tracker.reportSuccess(Date.now() - startTime);

package/lib/decorators/auth.js

@@ -35,7 +35,8 @@ 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();

package/lib/main.js

@@ -17,7 +17,9 @@ 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" });
+            (0, cloud_toolkit_1.initCliApm)({
+                cliVersion: (process === null || process === void 0 ? void 0 : process.CLI_VERSION) || "unknown",
+            });
         }
         catch (e) {
         }

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": "1.0.0",
+  "version": "1.1.0",
   "description": "xhs-cloud-cli 主要用于如下场景：  - agent 调试、发布  - cloud 云函数的调试、部署",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "main": "lib/index.js",
   "types": "types/index.d.ts",
   "bin": {
@@ -16,10 +19,6 @@
   ],
   "dependencies": {
     "@koa/router": "^12.0.1",
-    "@vectorx/agent-simulator": "1.0.0",
-    "@vectorx/cloud-toolkit": "1.0.0",
-    "@vectorx/function-debugger": "1.0.0",
-    "@vectorx/functions-framework": "1.0.0",
     "address": "^1.1.2",
     "archiver": "^6.0.1",
     "camelcase-keys": "^7.0.2",
@@ -66,7 +65,11 @@
     "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": "1.1.0",
+    "@vectorx/cloud-toolkit": "2.0.0",
+    "@vectorx/function-debugger": "1.1.0",
+    "@vectorx/functions-framework": "1.1.0"
   },
   "devDependencies": {
     "@types/archiver": "^5.3.2",
@@ -100,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 后填写

package/templates/cloud-agents/agent-doc-template/agent-cloudbase-functions.json

@@ -0,0 +1,11 @@
+{
+  "functionsRoot": "./src",
+  "functions": [
+    {
+      "triggerPath": "/",
+      "name": "main",
+      "directory": "./",
+      "source": "index.js"
+    }
+  ]
+}

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

@@ -0,0 +1,11 @@
+{
+  "version": "1.0.0",
+  "description": "文档理解智能体模板（最简版）",
+  "scripts": {
+    "dev": "rcb-ff"
+  },
+  "dependencies": {
+    "@vectorx/agent-runtime": "latest",
+    "@vectorx/functions-framework": "latest"
+  }
+}

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

@@ -0,0 +1,6 @@
+{
+  "name": "[从开放平台获取]",
+  "agentId": "[从开放平台获取]",
+  "desc": "文档理解智能体（最简版）",
+  "version": "0.0.1"
+}

package/templates/cloud-agents/agent-doc-template/src/index.js

@@ -0,0 +1,68 @@
+const { AgentRuntime, AgentDriver } = require("@vectorx/agent-runtime");
+
+class DocAgent extends AgentRuntime {
+  async sendMessage(message) {
+    try {
+      const userContent = [];
+
+      // 1. 添加文档 URL（标准上传的文件）
+      if (Array.isArray(message?.files) && message.files.length > 0) {
+        message.files.forEach((file) => {
+          if ((file.fileSource === "standard" || !file.fileSource) && file.url) {
+            userContent.push({
+              type: "doc_url",
+              doc_url: [file.url],
+              file_parsing_strategy: "auto",
+            });
+          }
+        });
+      }
+
+      // 2. 添加用户文本提示
+      const userPrompt = message?.msg || "请分析这个文档";
+      if (userPrompt.trim()) {
+        userContent.push({ type: "text", text: userPrompt.trim() });
+      }
+
+      if (userContent.length === 0) {
+        this.sseSender.send({
+          data: {
+            choices: [{
+              message: { role: "assistant", type: "error", content: "请上传文档或输入分析提示" },
+              finish_reason: "error",
+            }],
+          },
+        });
+        this.sseSender.end();
+        return;
+      }
+
+      const model = this.createModel("qwen-doc-turbo");
+      const modelResponse = await model.streamText({
+        messages: [{ role: "user", content: userContent }],
+        parameters: { temperature: 0.3, max_tokens: 2000 },
+        enable_thinking: true,
+      });
+
+      for await (const chunk of modelResponse) {
+        this.sseSender.send({ data: chunk });
+      }
+    } catch (error) {
+      console.error("DocAgent error:", error);
+      this.sseSender.send({
+        data: {
+          choices: [{
+            message: { role: "assistant", type: "error", content: "文档分析出错：" + (error?.message || "Unknown") },
+            finish_reason: "error",
+          }],
+        },
+      });
+    } finally {
+      this.sseSender.end();
+    }
+  }
+}
+
+exports.main = (event, context) => {
+  return AgentDriver.run(event, context, new DocAgent(context));
+};

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

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

package/templates/cloud-agents/agent-image-template/agent-cloudbase-functions.json

@@ -0,0 +1,11 @@
+{
+  "functionsRoot": "./src",
+  "functions": [
+    {
+      "triggerPath": "/",
+      "name": "main",
+      "directory": "./",
+      "source": "index.js"
+    }
+  ]
+}

package/templates/cloud-agents/agent-image-template/package.json

@@ -0,0 +1,11 @@
+{
+  "version": "1.0.0",
+  "description": "文生图智能体模板（最简版）",
+  "scripts": {
+    "dev": "rcb-ff"
+  },
+  "dependencies": {
+    "@vectorx/agent-runtime": "latest",
+    "@vectorx/functions-framework": "latest"
+  }
+}

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

@@ -0,0 +1,6 @@
+{
+  "name": "[从开放平台获取]",
+  "agentId": "[从开放平台获取]",
+  "desc": "文生图智能体（最简版）",
+  "version": "0.0.1"
+}

package/templates/cloud-agents/agent-image-template/src/index.js

@@ -0,0 +1,56 @@
+const { AgentRuntime, AgentDriver } = require("@vectorx/agent-runtime");
+
+class ImageAgent extends AgentRuntime {
+  async sendMessage(message) {
+    try {
+      if (!message?.msg) {
+        this.sseSender.send({
+          data: {
+            choices: [{
+              message: { role: "assistant", type: "error", content: "请输入图片描述" },
+              finish_reason: "error",
+            }],
+          },
+        });
+        this.sseSender.end();
+        return;
+      }
+
+      const model = this.createModel("qwen-image");
+      const modelResponse = await model.streamText({
+        messages: [
+          {
+            role: "user",
+            content: [{ type: "text", text: message.msg }],
+          },
+        ],
+        parameters: {
+          negative_prompt: "",
+          prompt_extend: true,
+          watermark: true,
+          size: "1328*1328",
+        },
+      });
+
+      for await (const chunk of modelResponse) {
+        this.sseSender.send({ data: chunk });
+      }
+    } catch (error) {
+      console.error("ImageAgent error:", error);
+      this.sseSender.send({
+        data: {
+          choices: [{
+            message: { role: "assistant", type: "error", content: "图片生成出错：" + (error?.message || "Unknown") },
+            finish_reason: "error",
+          }],
+        },
+      });
+    } finally {
+      this.sseSender.end();
+    }
+  }
+}
+
+exports.main = (event, context) => {
+  return AgentDriver.run(event, context, new ImageAgent(context));
+};

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

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

package/templates/cloud-agents/agent-text-template/agent-cloudbase-functions.json

@@ -0,0 +1,11 @@
+{
+  "functionsRoot": "./src",
+  "functions": [
+    {
+      "triggerPath": "/",
+      "name": "main",
+      "directory": "./",
+      "source": "index.js"
+    }
+  ]
+}

package/templates/cloud-agents/agent-text-template/package.json

@@ -0,0 +1,11 @@
+{
+  "version": "1.0.0",
+  "description": "文本模型智能体模板（最简版）",
+  "scripts": {
+    "dev": "rcb-ff"
+  },
+  "dependencies": {
+    "@vectorx/agent-runtime": "latest",
+    "@vectorx/functions-framework": "latest"
+  }
+}