@vectorx/xhs-cloud-cli 0.6.0 → 1.0.0

package/templates/ai-cloud-functions-example/src/multipart/index.js

@@ -0,0 +1,189 @@
+/**
+ * 文件上传处理示例函数
+ * 
+ * 覆盖场景：
+ * - Content-Type: multipart/form-data
+ * 
+ * 业务场景：文件上传，模拟保存到数据库或 OSS
+ */
+
+// Mock 文件存储记录（模拟数据库）
+const FILE_RECORDS = [];
+
+/**
+ * POST 请求：上传文件
+ * 
+ * 示例：
+ * - POST /multipart/upload
+ * - Content-Type: multipart/form-data
+ * - Body: FormData with file field
+ */
+exports.multipartUpload = async function multipartUpload(event, context) {
+  console.log('[multipartUpload] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    timestamp: new Date().toISOString(),
+  });
+  
+  // 对齐抖音云托管：multipart/form-data 会被解析进 event.params（对象）
+  // 文件字段可能是 Buffer、base64 字符串或已处理的对象
+  const formData = (event && event.params) || {};
+  
+  // 提取文件信息
+  const file = formData.file || formData.upload || formData.fileData;
+  const fileName = formData.fileName || formData.filename || 'unknown';
+  const fileType = formData.fileType || formData.contentType || 'application/octet-stream';
+  const description = formData.description || '';
+  
+  console.log('[multipartUpload] 文件信息', {
+    fileName,
+    fileType,
+    hasFile: !!file,
+    hasDescription: !!description,
+    fileDataType: file ? (Buffer.isBuffer(file) ? 'Buffer' : typeof file) : 'none',
+  });
+  
+  if (!file) {
+    console.log('[multipartUpload] 错误：未找到文件数据');
+    return {
+      ok: false,
+      code: 400,
+      message: "MISSING_FILE",
+      detail: "未找到文件数据，请确保表单中包含 file 字段",
+    };
+  }
+  
+  // 处理文件数据
+  let fileBuffer;
+  let fileSize = 0;
+  
+  if (Buffer.isBuffer(file)) {
+    fileBuffer = file;
+    fileSize = file.length;
+    console.log('[multipartUpload] 文件格式：Buffer', { size: fileSize });
+  } else if (typeof file === 'string') {
+    // 如果是 base64 字符串
+    fileBuffer = Buffer.from(file, 'base64');
+    fileSize = fileBuffer.length;
+    console.log('[multipartUpload] 文件格式：base64 字符串', { size: fileSize });
+  } else if (file && file.data) {
+    // 如果文件被包装在对象中
+    fileBuffer = Buffer.isBuffer(file.data) ? file.data : Buffer.from(file.data);
+    fileSize = fileBuffer.length;
+    console.log('[multipartUpload] 文件格式：包装对象', { size: fileSize });
+  } else {
+    console.log('[multipartUpload] 错误：无法解析文件数据格式');
+    return {
+      ok: false,
+      code: 400,
+      message: "INVALID_FILE_FORMAT",
+      detail: "无法解析文件数据格式",
+    };
+  }
+  
+  // 模拟保存到 OSS（这里只是记录元数据）
+  const fileId = `file_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+  const ossUrl = `https://oss.example.com/files/${fileId}`;
+  
+  console.log('[multipartUpload] 生成文件 ID 和 OSS URL', { fileId, ossUrl });
+  
+  // 模拟数据库保存文件元数据
+  const fileRecord = {
+    id: fileId,
+    fileName,
+    fileType,
+    fileSize,
+    description,
+    ossUrl,
+    uploadedAt: new Date().toISOString(),
+    // 实际场景中，文件内容会保存到 OSS，这里只保存元数据
+    // fileContent: fileBuffer.toString('base64'), // 仅用于测试，实际不存储
+  };
+  FILE_RECORDS.push(fileRecord);
+  
+  console.log('[multipartUpload] 文件上传成功', {
+    fileId,
+    fileName,
+    fileSize,
+    ossUrl,
+    totalFiles: FILE_RECORDS.length,
+  });
+  
+  return {
+    ok: true,
+    code: 0,
+    message: "MULTIPART_UPLOAD_OK",
+    data: {
+      fileId,
+      fileName,
+      fileType,
+      fileSize,
+      ossUrl,
+      uploadedAt: fileRecord.uploadedAt,
+    },
+    contentType: "multipart/form-data",
+    // 模拟业务逻辑：返回文件访问信息
+    businessLogic: {
+      savedToDatabase: true,
+      uploadedToOSS: true,
+      canAccess: true,
+    },
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+/**
+ * GET 请求：查询文件列表
+ * 
+ * 示例：
+ * - GET /multipart/files?fileType=image/png
+ */
+exports.multipartFiles = async function multipartFiles(event, context) {
+  console.log('[multipartFiles] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    timestamp: new Date().toISOString(),
+  });
+  
+  const query = (event && event.params) || {};
+  const { fileType } = query;
+  
+  console.log('[multipartFiles] 查询参数', { fileType, totalFiles: FILE_RECORDS.length });
+  
+  let files = FILE_RECORDS;
+  
+  // 模拟数据库查询：按文件类型过滤
+  if (fileType) {
+    files = FILE_RECORDS.filter(f => f.fileType === fileType);
+    console.log('[multipartFiles] 按文件类型过滤', { fileType, filteredCount: files.length });
+  }
+  
+  console.log('[multipartFiles] 查询结果', { total: files.length });
+  
+  return {
+    ok: true,
+    code: 0,
+    message: "MULTIPART_FILES_OK",
+    data: {
+      total: files.length,
+      files: files.map(f => ({
+        id: f.id,
+        fileName: f.fileName,
+        fileType: f.fileType,
+        fileSize: f.fileSize,
+        ossUrl: f.ossUrl,
+        uploadedAt: f.uploadedAt,
+      })),
+    },
+    contentType: "multipart/form-data",
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};

package/templates/ai-cloud-functions-example/src/text/index.js

@@ -0,0 +1,319 @@
+/**
+ * 文本数据处理示例函数
+ * 
+ * 覆盖场景：
+ * - Content-Type: text/plain
+ * - Content-Type: text/html
+ * - Content-Type: text/xml
+ * - 默认 text（未指定 content-type）
+ * 
+ * 业务场景：处理文本数据，模拟日志记录、文本分析等
+ */
+
+// Mock 文本日志记录
+const TEXT_LOGS = [];
+
+/**
+ * POST 请求：提交文本内容
+ * 
+ * 示例：
+ * - POST /text/submit
+ * - Content-Type: text/plain
+ * - Body: "这是一段文本内容"
+ */
+exports.textSubmit = async function textSubmit(event, context) {
+  console.log('[textSubmit] event', JSON.stringify(event, null, 2));
+  console.log('[textSubmit] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    eventType: context?.eventType,
+    timestamp: context?.timestamp,
+    httpContext: context?.httpContext,
+    baseUrl: context?.baseUrl,
+  });
+  
+  // 对齐抖音云托管：文本内容从 event.params 中获取（string 或 object）
+  let textContent = '';
+
+  const params = event?.params;
+
+  if (typeof params === 'string') {
+    textContent = params;
+    console.log('[textSubmit] 数据格式：event.params 是字符串');
+  } else if (params && typeof params.text === 'string') {
+    textContent = params.text;
+    console.log('[textSubmit] 数据格式：event.params.text 是字符串');
+  } else {
+    console.log('[textSubmit] 错误：无法解析文本数据格式');
+    return {
+      ok: false,
+      code: 400,
+      message: "INVALID_TEXT_DATA",
+      detail: "无法解析文本数据",
+    };
+  }
+  
+  if (!textContent || textContent.trim().length === 0) {
+    console.log('[textSubmit] 错误：文本内容为空');
+    return {
+      ok: false,
+      code: 400,
+      message: "EMPTY_TEXT",
+      detail: "文本内容为空",
+    };
+  }
+  
+  // 检测内容类型
+  const contentType = context.httpContext?.headers?.['content-type'] || 'text/plain';
+  let detectedType = 'text/plain';
+  
+  if (contentType.includes('text/html')) {
+    detectedType = 'text/html';
+  } else if (contentType.includes('text/xml')) {
+    detectedType = 'text/xml';
+  } else if (contentType.includes('text/plain')) {
+    detectedType = 'text/plain';
+  }
+  
+  console.log('[textSubmit] 内容类型检测', {
+    contentType,
+    detectedType,
+    textLength: textContent.length,
+  });
+  
+  // 模拟文本分析（字数统计、关键词提取等）
+  const wordCount = textContent.trim().split(/\s+/).length;
+  const charCount = textContent.length;
+  const lines = textContent.split('\n').length;
+  
+  // 简单的关键词提取（示例）
+  const keywords = textContent
+    .toLowerCase()
+    .replace(/[^\w\s]/g, ' ')
+    .split(/\s+/)
+    .filter(w => w.length > 3)
+    .slice(0, 5);
+  
+  console.log('[textSubmit] 文本分析结果', {
+    wordCount,
+    charCount,
+    lines,
+    keywords,
+  });
+  
+  // 模拟保存到数据库
+  const logEntry = {
+    id: `log_${Date.now()}`,
+    contentType: detectedType,
+    textContent: textContent.substring(0, 500), // 只保存前500字符
+    fullLength: textContent.length,
+    wordCount,
+    charCount,
+    lines,
+    keywords,
+    submittedAt: new Date().toISOString(),
+  };
+  TEXT_LOGS.push(logEntry);
+  
+  console.log('[textSubmit] 文本提交成功', {
+    logId: logEntry.id,
+    contentType: detectedType,
+    totalLogs: TEXT_LOGS.length,
+  });
+  
+  return {
+    ok: true,
+    code: 0,
+    message: "TEXT_SUBMIT_OK",
+    data: {
+      logId: logEntry.id,
+      contentType: detectedType,
+      analysis: {
+        wordCount,
+        charCount,
+        lines,
+        keywords,
+      },
+      submittedAt: logEntry.submittedAt,
+    },
+    contentType: detectedType,
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+/**
+ * GET 请求：查询文本日志
+ * 
+ * 示例：
+ * - GET /text/logs?contentType=text/plain
+ */
+exports.textLogs = async function textLogs(event, context) {
+  console.log('[textLogs] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    timestamp: new Date().toISOString(),
+  });
+  
+  const query = (event && event.params) || {};
+  const { contentType, limit = '10' } = query;
+  
+  console.log('[textLogs] 查询参数', { contentType, limit, totalLogs: TEXT_LOGS.length });
+  
+  let logs = TEXT_LOGS;
+  
+  // 模拟数据库查询：按内容类型过滤
+  if (contentType) {
+    logs = TEXT_LOGS.filter(l => l.contentType === contentType);
+    console.log('[textLogs] 按内容类型过滤', { contentType, filteredCount: logs.length });
+  }
+  
+  // 限制返回数量
+  const limitNum = parseInt(limit) || 10;
+  logs = logs.slice(-limitNum).reverse(); // 返回最新的
+  
+  console.log('[textLogs] 查询结果', { total: TEXT_LOGS.length, returned: logs.length });
+  
+  return {
+    ok: true,
+    code: 0,
+    message: "TEXT_LOGS_OK",
+    data: {
+      total: TEXT_LOGS.length,
+      returned: logs.length,
+      logs: logs.map(l => ({
+        id: l.id,
+        contentType: l.contentType,
+        preview: l.textContent.substring(0, 100),
+        wordCount: l.wordCount,
+        charCount: l.charCount,
+        submittedAt: l.submittedAt,
+      })),
+    },
+    contentType: "text/plain",
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+/**
+ * POST 请求：处理 HTML 内容
+ * 
+ * 示例：
+ * - POST /text/html
+ * - Content-Type: text/html
+ * - Body: "<html><body><h1>Hello</h1></body></html>"
+ */
+exports.textHtml = async function textHtml(event, context) {
+  console.log('[textHtml] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    timestamp: new Date().toISOString(),
+  });
+  
+  // 对齐抖音云托管：HTML 内容从 event.params 中获取（string 或 object）
+  let htmlContent = '';
+
+  const params = event?.params;
+
+  if (typeof params === 'string') {
+    htmlContent = params;
+    console.log('[textHtml] 数据格式：event.params 是字符串');
+  } else if (params && typeof params.html === 'string') {
+    htmlContent = params.html;
+    console.log('[textHtml] 数据格式：event.params.html 是字符串');
+  } else {
+    console.log('[textHtml] 错误：无法解析 HTML 数据格式');
+    return {
+      ok: false,
+      code: 400,
+      message: "INVALID_HTML_DATA",
+      detail: "无法解析 HTML 数据",
+    };
+  }
+  
+  console.log('[textHtml] HTML 内容长度', { length: htmlContent.length });
+  
+  // 简单的 HTML 解析（提取标题、链接等）
+  const titleMatch = htmlContent.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const title = titleMatch ? titleMatch[1] : null;
+  
+  const linkMatches = htmlContent.match(/<a[^>]+href=["']([^"']+)["'][^>]*>/gi) || [];
+  const links = linkMatches.map(m => {
+    const hrefMatch = m.match(/href=["']([^"']+)["']/i);
+    return hrefMatch ? hrefMatch[1] : null;
+  }).filter(Boolean);
+  
+  console.log('[textHtml] HTML 解析结果', {
+    hasTitle: !!title,
+    linkCount: links.length,
+    title: title || '未找到标题',
+  });
+  
+  return {
+    ok: true,
+    code: 0,
+    message: "TEXT_HTML_OK",
+    data: {
+      title,
+      linkCount: links.length,
+      links: links.slice(0, 10), // 只返回前10个链接
+      contentLength: htmlContent.length,
+    },
+    contentType: "text/html",
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+/**
+ * 测试函数：返回 event 和 context 的结构
+ * 用于验证 event 和 context 的结构是否正确
+ * 
+ * 示例：
+ * - POST /text/test-structure
+ * - Body: { "hello": "dycloud" }
+ */
+exports.textTestStructure = async function textTestStructure(event, context) {
+  // 返回 event 和 context 的结构信息，用于测试验证
+  return {
+    ok: true,
+    code: 0,
+    message: "STRUCTURE_TEST_OK",
+    data: {
+      // event 结构
+      event: {
+        params: event?.params ?? null,
+        // 注意：对齐抖音云托管，用户函数入参只保证 { params }
+      },
+      // context 结构
+      context: {
+        ctxId: context?.ctxId,
+        eventID: context?.eventID,
+        eventType: context?.eventType,
+        timestamp: context?.timestamp,
+        httpContext: context?.httpContext ? {
+          url: context.httpContext.url,
+          httpMethod: context.httpContext.httpMethod,
+          headers: context.httpContext.headers,
+        } : null,
+        baseUrl: context?.baseUrl,
+        // 注意：request, logger, sse 等不应该被序列化
+      },
+    },
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};

package/templates/ai-cloud-functions-example/src/user/index.js

@@ -0,0 +1,82 @@
+/**
+ * 用户相关函数示例
+ * 
+ * 保留原有的 userProfile 函数，并添加更多示例
+ */
+
+// 测试用用户数据
+const USERS = [
+  {
+    id: "u10001",
+    name: "Alice",
+    level: "gold",
+    maxBorrow: 10,
+  },
+  {
+    id: "u10002",
+    name: "Bob",
+    level: "silver",
+    maxBorrow: 5,
+  },
+];
+
+/**
+ * 查询用户基本信息
+ *
+ * 示例：
+ *  - 请求：POST /user/profile { "userId": "u10001" }
+ *  - 响应：返回用户的基础信息与一些统计字段
+ */
+exports.userProfile = async function userProfile(event, context) {
+  console.log('[userProfile] 函数调用开始', {
+    ctxId: context?.ctxId,
+    eventID: context?.eventID,
+    timestamp: new Date().toISOString(),
+  });
+  
+  const payload = event?.params || {};
+  const userId = payload.userId;
+
+  console.log('[userProfile] 请求参数', { userId });
+
+  if (!userId) {
+    console.log('[userProfile] 参数验证失败：缺少 userId');
+    return {
+      ok: false,
+      code: 400,
+      message: "MISSING_USER_ID",
+      detail: "userId 为必填参数",
+    };
+  }
+
+  const user = USERS.find((u) => u.id === userId);
+  if (!user) {
+    console.log('[userProfile] 用户未找到', { userId });
+    return {
+      ok: false,
+      code: 404,
+      message: "USER_NOT_FOUND",
+      detail: `未找到指定用户: ${userId}`,
+    };
+  }
+
+  console.log('[userProfile] 查询成功', {
+    userId: user.id,
+    userName: user.name,
+    userLevel: user.level,
+  });
+
+  return {
+    ok: true,
+    code: 0,
+    message: "USER_PROFILE_OK",
+    user: {
+      ...user,
+    },
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};

package/templates/chatbox-agent/project.config.json

@@ -1,5 +1,5 @@
 {
-    "agentId": "xhs1234567890",
+    "agentId": "[从开放平台获取]",
     "version": "0.0.1",
-    "desc": "通用智能体 0.0.1"
+    "desc": "[从开放平台获取]"
 }

package/templates/cloudfunction-template/.env.template

@@ -0,0 +1,2 @@
+# key
+GAODE_APPID=123

package/templates/cloudfunction-template/agent-cloudbase-functions.json

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

package/templates/cloudfunction-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/cloudfunction-template/project.config.json

@@ -0,0 +1,5 @@
+{
+    "agentId": "xhs1234567890",
+    "version": "0.0.1",
+    "desc": "通用智能体 0.0.1"
+}

package/templates/cloudfunction-template/src/echo.js

@@ -0,0 +1,27 @@
+/**
+ * 云托管模板示例：Echo 函数
+ *
+ * 对应配置：
+ * {
+ *   "name": "echo",
+ *   "directory": "./",
+ *   "source": "echo.js",
+ *   "triggerPath": "/echo"
+ * }
+ *
+ * - 请求入口：POST /echo
+ * - 行为：原样返回请求体，并附带简单的 meta 信息
+ */
+exports.echo = async function echo(event, context) {
+  return {
+    message: "Echo from cloudfunction-template",
+    input: event || {},
+    meta: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+

package/templates/cloudfunction-template/src/index.js

@@ -0,0 +1,34 @@
+/**
+ * 云托管模板示例：默认入口函数
+ *
+ * 对应配置：
+ * {
+ *   "name": "main",
+ *   "directory": "./",
+ *   "source": "index.js",
+ *   "triggerPath": "/"
+ * }
+ *
+ * - 请求入口：POST / （参见 agent-cloudbase-functions.json 中的 triggerPath）
+ * - 参数：HTTP 请求体会被解析为 JSON 传入 event
+ * - 返回：对象会被直接作为 HTTP 响应 Body
+ */
+exports.main = async function main(event, context) {
+  // event 为解析后的请求体，context 为运行上下文（含请求信息、日志、请求工具等）
+  const now = new Date().toISOString();
+
+  return {
+    message: "Hello from cloudfunction-template 'main' function 🎯",
+    timestamp: now,
+    // 将用户请求原样回显，方便本地调试
+    input: event || {},
+    // 仅保留一些常用的上下文字段示例
+    context: {
+      ctxId: context.ctxId,
+      eventID: context.eventID,
+      eventType: context.eventType,
+    },
+  };
+};
+
+