@vectorx/functions-framework 0.8.0 → 1.0.0

package/README.md

@@ -136,6 +136,34 @@ npm test
 npm run build
 ``` 
 
-
 ### 环境管理
 读取 .env 文件，校验 env 文件的可用性，获取当前运行环境
+
+
+## rcb-ff 自动检测项目类型
+
+当直接使用 `rcb-ff` 命令启动服务时，如果未指定 `--mode` 参数，会自动检测项目类型：
+
+### 检测规则
+
+1. **Agent 项目检测**：
+   - 如果存在 `project.config.json` 文件且包含 `agentId` 字段，则判定为 `agent` 项目
+
+2. **Fun 项目检测**：
+   - 如果不存在 `project.config.json` 或 `project.config.json` 中不存在 `agentId` 字段
+   - 且存在 `agent-cloudbase-functions.json` 配置文件
+   - 则判定为 `fun` 项目
+
+3. **默认行为**：
+   - 如果无法确定项目类型，默认使用 `agent` 模式（保持向后兼容）
+
+### 使用示例
+
+```bash
+# 自动检测项目类型（推荐）
+rcb-ff --directory ./my-project
+
+# 明确指定模式（覆盖自动检测）
+rcb-ff --directory ./my-project --mode fun
+rcb-ff --directory ./my-project --mode agent
+```

package/bin/rcb-ff.js

@@ -7,6 +7,40 @@ const fs = require('fs');
 const nodemon = require('nodemon');
 const chalk = require('chalk');
 
+/**
+ * 自动检测项目类型（agent 或 fun）
+ * 参考 fun-project-validator.ts 的检测逻辑
+ * @param {string} workDir 工作目录
+ * @returns {string} 'agent' | 'fun'
+ */
+function detectProjectMode(workDir) {
+    const projectConfigPath = path.join(workDir, 'project.config.json');
+    
+    // 检查是否存在 project.config.json 且包含 agentId
+    if (fs.existsSync(projectConfigPath)) {
+        try {
+            const projectConfig = JSON.parse(fs.readFileSync(projectConfigPath, 'utf-8'));
+            if (projectConfig.agentId) {
+                // 存在 agentId，判定为 agent 项目
+                return 'agent';
+            }
+        } catch (error) {
+            // project.config.json 解析失败，继续检测
+        }
+    }
+    
+    // 检查是否存在 agent-cloudbase-functions.json
+    const functionsConfigPath = path.join(workDir, 'agent-cloudbase-functions.json');
+    if (fs.existsSync(functionsConfigPath)) {
+        // 不存在 project.config.json 或不存在 agentId，但存在 agent-cloudbase-functions.json
+        // 判定为 fun 项目
+        return 'fun';
+    }
+    
+    // 默认返回 agent（保持向后兼容）
+    return 'agent';
+}
+
 const program = new Command();
 
 program
@@ -20,13 +54,22 @@ program
     .option('--enable-cors', '启用 CORS')
     .option('--allowed-origins <origins>', 'CORS 允许的域名，用逗号分隔', 'localhost,127.0.0.1')
     .option('--config <path>', '指定配置文件路径', 'agent-cloudbase-functions.json')
+    .option('--mode <mode>', '运行模式: agent | fun（未指定时自动检测）')
     .option('--enableRedLangfuse', '启用 Red Langfuse 上报')
+    .option('--verbose', '输出详细错误堆栈（用于排查问题）')
     .option('-w, --watch', '启用文件监听模式，文件变化时自动重启服务');
 
 program.parse();
 
 const options = program.opts();
 
+// 如果未明确指定 mode，则自动检测
+if (!options.mode) {
+    const detectedMode = detectProjectMode(path.resolve(options.directory));
+    options.mode = detectedMode;
+    console.log(chalk.dim(`[自动检测] 项目类型: ${detectedMode}`));
+}
+
 async function startServer() {
     try {
         // 解析并验证目录路径
@@ -46,6 +89,7 @@ async function startServer() {
             functionsConfigFile: path.resolve(directory, options.config),
             enableCors: options.enableCors,
             allowedOrigins: options.allowedOrigins.split(','),
+            mode: options.mode === 'fun' ? 'fun' : 'agent',
             redLangfuseConfig: {
                 enable: Boolean(options.enableRedLangfuse),
             },
@@ -74,6 +118,7 @@ async function startServer() {
             // 使用独立的控制台实例打印启动信息
             startupConsole.log('\n\n' + chalk.bold.cyan(' === RCB Functions Framework ==='));
             startupConsole.log(`${chalk.green('✔')} ${chalk.bold('状态')}: ${chalk.green('运行中')}`);
+            startupConsole.log(`${chalk.green('✔')} ${chalk.bold('模式')}: ${chalk.yellow(frameworkOptions.mode)}`);
             startupConsole.log(`${chalk.green('✔')} ${chalk.bold('端口')}: ${chalk.yellow(frameworkOptions.port)}`);
             startupConsole.log(`${chalk.green('✔')} ${chalk.bold('URL')}: ${chalk.blue.underline(`http://localhost:${frameworkOptions.port}`)}`);
             startupConsole.log(`${chalk.green('✔')} ${chalk.bold('目标函数')}: ${chalk.yellow(frameworkOptions.target)}`);
@@ -111,7 +156,14 @@ async function startServer() {
         });
 
     } catch (err) {
-        console.error('启动服务器失败:', err);
+        // 默认只输出友好错误信息（避免堆栈刷屏）；需要排查时可通过 --verbose 输出完整堆栈
+        const message = (err && err.message) ? err.message : String(err);
+        console.error('启动服务器失败:');
+        console.error(message);
+        if (options.verbose) {
+            const stack = (err && err.stack) ? err.stack : '';
+            if (stack) console.error(stack);
+        }
         process.exit(1);
     }
 }

package/lib/config.js

@@ -1,10 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBaseUrl = getBaseUrl;
-const ENV_BASE_URL = {
-    development: "https://agentbase-sandbox.xiaohongshu.com",
-    production: "https://agentbase.xiaohongshu.com",
-};
+const endpoints_1 = require("@vectorx/endpoints");
 function getBaseUrl() {
-    return ENV_BASE_URL[process.env.OPEN_PLATFORM_STAGE] || ENV_BASE_URL.development;
+    return (0, endpoints_1.resolveUrl)("@vectorx/functions-framework", "baseUrl");
 }

package/lib/constants.js

@@ -7,4 +7,5 @@ exports.defaultOptions = {
     keepAliveTimeoutMS: 25000,
     functionsConfigFile: "agent-cloudbase-functions.json",
     enableCors: false,
+    mode: "agent",
 };

package/lib/framework.js

@@ -73,8 +73,9 @@ class AgentServerFramework {
     }
     startServer() {
         return __awaiter(this, void 0, void 0, function* () {
-            const { functionsConfigFile } = this.options;
+            const { functionsConfigFile, mode = "agent" } = this.options;
             let cloudFunctionConfig;
+            let projectConfig;
             if (!process.env.OPEN_PLATFORM_STAGE) {
                 process.stdout.write(chalk_1.default.yellow(`未设置 OPEN_PLATFORM_STAGE 环境变量，使用默认值: development\n`));
                 process.env.OPEN_PLATFORM_STAGE = "development";
@@ -100,9 +101,27 @@ class AgentServerFramework {
                     }
                 });
             }
-            const projectConfigPath = path_1.default.join(process.cwd(), "project.config.json");
-            if (!(0, fs_1.existsSync)(projectConfigPath)) {
-                throw new Error(`
+            if (mode === "agent") {
+                ({ projectConfig, cloudFunctionConfig } = this.loadAgentModeConfigs(functionsConfigFile));
+            }
+            else {
+                ({ projectConfig, cloudFunctionConfig } = this.loadFunModeConfigs(functionsConfigFile));
+            }
+            this.router = new router_1.Router(cloudFunctionConfig);
+            const server = (0, server_1.createServer)(this.options, this.router, projectConfig);
+            return server;
+        });
+    }
+    getRegisteredFunction(fnName) {
+        const fnId = (0, function_registry_1.buildFnId)("@fn", fnName);
+        return (0, function_registry_1.getRegisteredFunction)(fnId);
+    }
+    loadAgentModeConfigs(functionsConfigFile) {
+        const projectConfigPath = path_1.default.join(process.cwd(), "project.config.json");
+        if (!(0, fs_1.existsSync)(projectConfigPath)) {
+            const funConfigPath = path_1.default.join(process.cwd(), "agent-cloudbase-functions.json");
+            const maybeFunProject = (0, fs_1.existsSync)(funConfigPath);
+            throw new Error(`
 ❌ 项目配置文件未找到: ${projectConfigPath}
 
 请确保:
@@ -113,11 +132,23 @@ class AgentServerFramework {
   "version": "0.0.1",
   "desc": "发布示例",
 }
-`);
-            }
-            const projectConfig = require(projectConfigPath);
-            if (!(0, fs_1.existsSync)(functionsConfigFile)) {
-                throw new Error(`
+${maybeFunProject
+                ? `
+💡 诊断提示:
+- 检测到当前目录存在云函数配置文件（agent-cloudbase-functions.json）
+- 这可能是一个“云函数（fun）项目”目录，但你使用了“智能体（agent）模式”启动
+
+建议你：
+- 改用 fun 模式启动（例如：rcb-ff --mode fun ... 或使用 rcb fun dev）
+- 或切换到正确的 Agent 项目目录后再启动
+
+参考文档：https://miniapp.xiaohongshu.com/doc/DC185638
+`
+                : ""}`);
+        }
+        const projectConfig = require(projectConfigPath);
+        if (!(0, fs_1.existsSync)(functionsConfigFile)) {
+            throw new Error(`
 ❌ 配置文件未找到: ${functionsConfigFile}
 
 请确保:
@@ -135,13 +166,42 @@ class AgentServerFramework {
   ]
 }
 `);
+        }
+        const cloudFunctionConfig = this.loadAndRegisterFunctions(functionsConfigFile, "agent");
+        return { projectConfig, cloudFunctionConfig };
+    }
+    loadFunModeConfigs(functionsConfigFile) {
+        if (!(0, fs_1.existsSync)(functionsConfigFile)) {
+            throw new Error(`
+❌ 函数配置文件未找到: ${functionsConfigFile}
+
+请确保:
+1. 配置文件 'agent-cloudbase-functions.json' 存在于项目根目录
+2. 配置文件格式正确，且 functions 字段已正确配置
+`);
+        }
+        const cloudFunctionConfig = this.loadAndRegisterFunctions(functionsConfigFile, "fun");
+        const projectConfig = {
+            agentId: cloudFunctionConfig.agentId || "local-fun",
+            version: "0.0.0-local",
+            desc: "Local functions development (fun mode)",
+            name: "local-fun",
+            "@vectorx/agent-runtime": getDependencyVersion("@vectorx/agent-runtime", process.cwd()) || "",
+            "@vectorx/functions-framework": getDependencyVersion("@vectorx/functions-framework", process.cwd()) || "",
+        };
+        return { projectConfig, cloudFunctionConfig };
+    }
+    loadAndRegisterFunctions(functionsConfigFile, mode) {
+        try {
+            const cloudFunctionConfig = (0, function_loader_1.loadFunctionsConfig)(functionsConfigFile);
+            const fns = cloudFunctionConfig.functions || [];
+            if (!Array.isArray(fns) || fns.length === 0) {
+                throw new Error("functions 配置为空，请至少配置一个函数");
             }
-            try {
-                cloudFunctionConfig = (0, function_loader_1.loadFunctionsConfig)(functionsConfigFile);
-                for (const fn of cloudFunctionConfig.functions) {
-                    const mainFn = (0, function_loader_1.loadFunction)(cloudFunctionConfig.functionsRoot, fn);
-                    if (!mainFn) {
-                        throw new Error(`
+            for (const fn of fns) {
+                const mainFn = (0, function_loader_1.loadFunction)(cloudFunctionConfig.functionsRoot, fn);
+                if (!mainFn) {
+                    throw new Error(`
 ❌ 函数加载失败: ${fn.name}
 
 请检查:
@@ -149,14 +209,14 @@ class AgentServerFramework {
 2. 源文件是否存在: ${fn.source}
 3. 函数是否正确导出
 `);
-                    }
-                    (0, function_registry_1.registerFunction)(fn.name, mainFn);
                 }
-                this.router = new router_1.Router(cloudFunctionConfig);
+                (0, function_registry_1.registerFunction)(fn.name, mainFn);
             }
-            catch (err) {
-                throw new Error(`
-❌ 函数配置加载失败
+            return cloudFunctionConfig;
+        }
+        catch (err) {
+            throw new Error(`
+❌ 函数配置加载失败（${mode} 模式）
 
 错误详情: ${err}
 
@@ -167,13 +227,7 @@ class AgentServerFramework {
 
 配置文件路径: ${functionsConfigFile}
 `);
-            }
-            const server = (0, server_1.createServer)(this.options, this.router, projectConfig);
-            return server;
-        });
-    }
-    getRegisteredFunction(fnName) {
-        return (0, function_registry_1.getRegisteredFunction)(fnName);
+        }
     }
 }
 function createAgentServerFramework(options) {

package/lib/function-loader.js

@@ -45,7 +45,8 @@ function loadFunction(functionsRoot, functionConfig) {
     if (!functionConfig.source) {
         functionConfig.source = exports.DEFAULT_FN_NAME;
     }
-    const indexPath = (0, path_1.join)(functionsRoot, functionConfig.source);
+    const directory = functionConfig.directory || ".";
+    const indexPath = (0, path_1.join)(functionsRoot, directory, functionConfig.source);
     if (!(0, fs_1.existsSync)(indexPath)) {
         throw new Error(`Function entry file not found at: ${indexPath}, functionConfig: ${JSON.stringify(functionConfig)}`);
     }

package/lib/function-wrapper.js

@@ -50,10 +50,62 @@ const request_1 = require("./request");
 const sse_1 = require("./sse");
 const unified_responder_1 = require("./unified-responder");
 const helper_1 = require("./utils/helper");
+const isPlainObject = (val) => {
+    if (!val || typeof val !== "object")
+        return false;
+    const proto = Object.getPrototypeOf(val);
+    return proto === Object.prototype || proto === null;
+};
+const parseCookies = (cookieHeader) => {
+    const cookies = {};
+    if (!cookieHeader || typeof cookieHeader !== "string")
+        return cookies;
+    const parts = cookieHeader.split(";");
+    for (const part of parts) {
+        const s = part.trim();
+        if (!s)
+            continue;
+        const idx = s.indexOf("=");
+        if (idx === -1)
+            continue;
+        const key = s.slice(0, idx).trim();
+        const val = s.slice(idx + 1).trim();
+        if (!key)
+            continue;
+        try {
+            cookies[key] = decodeURIComponent(val);
+        }
+        catch (_a) {
+            cookies[key] = val;
+        }
+    }
+    return cookies;
+};
+const normalizeQuery = (query) => {
+    if (!query || typeof query !== "object")
+        return {};
+    return Object.assign({}, query);
+};
+const normalizeHeaders = (headers) => {
+    if (!headers || typeof headers !== "object")
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        out[String(k).toLowerCase()] = v;
+    }
+    return out;
+};
+const resolveTrigger = (ctx) => {
+    var _a, _b;
+    const fromHeader = String(((_b = (_a = ctx.request) === null || _a === void 0 ? void 0 : _a.headers) === null || _b === void 0 ? void 0 : _b["xhs-cloud-trigger"]) || "").toLowerCase();
+    if (fromHeader === "online" || fromHeader === "ide_debug" || fromHeader === "console_debug")
+        return fromHeader;
+    return "online";
+};
 const wrapEventFunction = (execute, projectConfig) => {
     return (ctx, next) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
-        let event;
+        var _a, _b, _c, _d, _e;
+        let params;
         if (ctx.request.files) {
             const filesWithBuffer = {};
             const fs = yield Promise.resolve().then(() => __importStar(require("fs")));
@@ -79,21 +131,40 @@ const wrapEventFunction = (execute, projectConfig) => {
                 })));
                 filesWithBuffer[key] = Array.isArray(fileOrFiles) ? processedFiles : processedFiles[0];
             }
-            event = Object.assign(Object.assign({}, filesWithBuffer), ctx.request.body);
+            const fields = isPlainObject(ctx.request.body) ? ctx.request.body : {};
+            params = Object.assign(Object.assign({}, fields), filesWithBuffer);
         }
-        else if (ctx.request.body) {
-            event = ctx.request.body;
+        else if (ctx.method === "GET" || ctx.method === "HEAD") {
+            params = ctx.query || {};
         }
         else {
-            event = ctx.rawBody;
+            params = (_a = ctx.request.body) !== null && _a !== void 0 ? _a : ctx.rawBody;
         }
+        if (params === undefined || params === null) {
+            params = {};
+        }
+        const event = { params };
         let executeDone = false;
         let hasSwitchSSEMode = false;
+        const headers = normalizeHeaders((_b = ctx.request) === null || _b === void 0 ? void 0 : _b.headers);
+        const httpMethod = ctx.method;
+        const path = ctx.path;
+        const url = ctx.url;
+        const query = normalizeQuery(ctx.query);
+        const cookies = parseCookies(headers.cookie);
+        const trigger = resolveTrigger(ctx);
         const context = {
             ctxId: ctx.state.eventID,
             eventID: ctx.state.eventID,
             eventType: ctx.state.eventType,
             timestamp: ctx.state.timestamp,
+            headers,
+            httpMethod,
+            path,
+            url,
+            query,
+            cookies,
+            trigger,
             httpContext: ctx.httpContext,
             baseUrl: (0, config_1.getBaseUrl)(),
             request: new request_1.Request({
@@ -102,11 +173,26 @@ const wrapEventFunction = (execute, projectConfig) => {
                 restrictedMethods: ["get", "post", "upload", "download"],
                 defaultHeaders: {
                     "agent-id": projectConfig.agentId,
-                    "open-id": ctx.request.headers["open-id"],
+                    "open-id": ((_d = (_c = ctx.request) === null || _c === void 0 ? void 0 : _c.headers) === null || _d === void 0 ? void 0 : _d["open-id"]) || "UNKNOWN",
                     "x-open-agent-trace-id": ctx.state.eventID,
                 },
             }),
             logger: logger_1.functionsLogger,
+            set: (field, value) => {
+                ctx.set(field, value);
+            },
+            remove: (field) => {
+                ctx.remove(field);
+            },
+            status: (code) => {
+                ctx.status = code;
+            },
+            setCookie: (name, value, options) => {
+                ctx.cookies.set(name, value, options);
+            },
+            clearCookie: (name, options) => {
+                ctx.cookies.set(name, null, Object.assign(Object.assign({}, (options || {})), { expires: new Date(0), maxAge: 0 }));
+            },
             sse: () => {
                 var _a;
                 const sseInstance = (_a = ctx.sse) === null || _a === void 0 ? void 0 : _a.call(ctx);
@@ -127,12 +213,19 @@ const wrapEventFunction = (execute, projectConfig) => {
             eventID: context.eventID,
             eventType: context.eventType,
             timestamp: context.timestamp,
+            headers: context.headers,
+            httpMethod: context.httpMethod,
+            path: context.path,
+            url: context.url,
+            query: context.query,
+            cookies: context.cookies,
+            trigger: context.trigger,
             httpContext: context.httpContext,
             baseUrl: context.baseUrl,
             request: context.request,
         };
         (0, helper_1.deepFreeze)(contextToFreeze);
-        const frozenContext = Object.assign(Object.assign({}, contextToFreeze), { logger: context.logger, sse: context.sse });
+        const frozenContext = Object.assign(Object.assign({}, contextToFreeze), { logger: context.logger, set: context.set, remove: context.remove, status: context.status, setCookie: context.setCookie, clearCookie: context.clearCookie, sse: context.sse });
         ctx.state.event = event;
         ctx.state.contextInjected = frozenContext;
         let result;
@@ -142,7 +235,7 @@ const wrapEventFunction = (execute, projectConfig) => {
         catch (e) {
             ctx.state.error = e;
             if (hasSwitchSSEMode) {
-                const sse = (_a = ctx.sse) === null || _a === void 0 ? void 0 : _a.call(ctx);
+                const sse = (_e = ctx.sse) === null || _e === void 0 ? void 0 : _e.call(ctx);
                 if (sse && !sse.isClosed) {
                     const errorEvent = {
                         event: "error",

package/lib/middlewares/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.apmMiddleware = exports.openGwRequestMiddleware = exports.logsQueryMiddleware = exports.loggerMiddleware = exports.functionRouteMiddleware = exports.eventIdMiddleware = exports.contextInjectionMiddleware = exports.asyncContextMiddleware = void 0;
+exports.apmMiddleware = exports.openGwRequestMiddleware = exports.logsQueryMiddleware = exports.loggerMiddleware = exports.functionRouteMiddleware = exports.eventIdMiddleware = exports.envVarsInjectionMiddleware = exports.contextInjectionMiddleware = exports.asyncContextMiddleware = void 0;
 var middle_async_context_1 = require("./middle-async-context");
 Object.defineProperty(exports, "asyncContextMiddleware", { enumerable: true, get: function () { return middle_async_context_1.asyncContextMiddleware; } });
 var middle_context_injection_1 = require("./middle-context-injection");
 Object.defineProperty(exports, "contextInjectionMiddleware", { enumerable: true, get: function () { return middle_context_injection_1.contextInjectionMiddleware; } });
+var middle_env_vars_injection_1 = require("./middle-env-vars-injection");
+Object.defineProperty(exports, "envVarsInjectionMiddleware", { enumerable: true, get: function () { return middle_env_vars_injection_1.envVarsInjectionMiddleware; } });
 var middle_event_id_1 = require("./middle-event-id");
 Object.defineProperty(exports, "eventIdMiddleware", { enumerable: true, get: function () { return middle_event_id_1.eventIdMiddleware; } });
 var middle_function_route_1 = require("./middle-function-route");

package/lib/middlewares/middle-common-logger.js

@@ -44,6 +44,7 @@ function loggerMiddleware() {
         finally {
             const endTime = Date.now();
             const duration = endTime - startTime;
+            const contentType = ctx.get("content-type") || "-";
             const accessLog = {
                 type: "HTTP_ACCESS",
                 method: ctx.method,
@@ -65,7 +66,7 @@ function loggerMiddleware() {
                 asyncContext.userCodeLogsFlushTimer = undefined;
             }
             logger_1.functionsLogger.logUserCodelog();
-            process.stdout.write(chalk_1.default.greenBright(`▶️ ${chalk_1.default.gray(`[${new Date().toLocaleString()} - ${eventId.slice(0, -10)}]`)} - ${duration}ms\n`));
+            process.stdout.write(chalk_1.default.greenBright(`▶️ ${chalk_1.default.gray(`[${new Date().toLocaleString()} - ${eventId.slice(0, -10)}]`)} ${chalk_1.default.bold(`${ctx.method} ${ctx.path}`)} ${chalk_1.default.bold(`[${contentType}]`)} - ${duration}ms\n`));
             process.stdout.write(chalk_1.default.greenBright(`\n`));
         }
     });

package/lib/middlewares/middle-env-vars-injection.js

@@ -0,0 +1,65 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envVarsInjectionMiddleware = envVarsInjectionMiddleware;
+function envVarsInjectionMiddleware() {
+    return (ctx, next) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const envVarsHeader = (_b = (_a = ctx.request) === null || _a === void 0 ? void 0 : _a.headers) === null || _b === void 0 ? void 0 : _b["x-ide-env-vars"];
+        if (envVarsHeader && typeof envVarsHeader === "string") {
+            try {
+                const envVars = JSON.parse(envVarsHeader);
+                if (envVars && typeof envVars === "object") {
+                    for (const [key, value] of Object.entries(envVars)) {
+                        if (key && value !== undefined && value !== null) {
+                            process.env[String(key)] = String(value);
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                console.warn("[envVarsInjection] Failed to parse env vars from header:", e);
+            }
+        }
+        const systemHeadersMapping = {
+            "xhs-cloud-env-id": "XHS_CLOUD_ENV_ID",
+            "xhs-cloud-function-id": "XHS_CLOUD_FUNCTION_ID",
+            "xhs-app-id": "XHS_APP_ID",
+        };
+        for (const [headerKey, envKey] of Object.entries(systemHeadersMapping)) {
+            const headerValue = (_d = (_c = ctx.request) === null || _c === void 0 ? void 0 : _c.headers) === null || _d === void 0 ? void 0 : _d[headerKey];
+            if (headerValue && typeof headerValue === "string") {
+                process.env[envKey] = headerValue;
+            }
+        }
+        const versionMapHeader = (_f = (_e = ctx.request) === null || _e === void 0 ? void 0 : _e.headers) === null || _f === void 0 ? void 0 : _f["xhs-cloud-env-version-map"];
+        const aliyunVersionHeader = (_h = (_g = ctx.request) === null || _g === void 0 ? void 0 : _g.headers) === null || _h === void 0 ? void 0 : _h["x-fc-version-id"];
+        if (versionMapHeader &&
+            typeof versionMapHeader === "string" &&
+            aliyunVersionHeader &&
+            typeof aliyunVersionHeader === "string") {
+            try {
+                const parsed = JSON.parse(versionMapHeader);
+                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                    const map = parsed;
+                    const mapped = map[aliyunVersionHeader];
+                    if (mapped !== undefined && mapped !== null) {
+                        process.env.XHS_CLOUD_ENV_VERSION = String(mapped);
+                    }
+                }
+            }
+            catch (e) {
+                console.warn("[envVarsInjection] Failed to parse xhs-cloud-env-version-map:", e);
+            }
+        }
+        yield next();
+    });
+}

package/lib/router.js

@@ -10,6 +10,9 @@ class Router {
         this.router = (0, radix3_1.createRouter)({
             strictTrailingSlash: false,
         });
+        if (!(config && Array.isArray(config.routes))) {
+            return;
+        }
         for (const route of config.routes) {
             if (route.path) {
                 const p = route.path.endsWith("/") ? route.path : route.path + "/";
@@ -40,6 +43,9 @@ class Router {
 }
 exports.Router = Router;
 function routeFunction(router, path) {
+    if (!router) {
+        return {};
+    }
     const matchedRoute = router.findRoute(path);
     if (matchedRoute) {
         return {

package/lib/server.js

@@ -37,6 +37,7 @@ function createServer(options, router, projectConfig) {
     app.use(corsMiddleware());
     app.use((0, middlewares_1.logsQueryMiddleware)());
     app.use((0, middlewares_1.contextInjectionMiddleware)(options, projectConfig));
+    app.use((0, middlewares_1.envVarsInjectionMiddleware)());
     app.use((0, middlewares_1.eventIdMiddleware)());
     app.use((0, middlewares_1.apmMiddleware)());
     app.use((0, middlewares_1.asyncContextMiddleware)());

package/lib/telemetry/langfuse.js

@@ -6,8 +6,10 @@ const secretKey = process.env.LANGFUSE_SECRET_KEY;
 const publicKey = process.env.LANGFUSE_PUBLIC_KEY;
 const baseUrl = process.env.LANGFUSE_BASEURL;
 exports.langfuse = new langfuse_1.Langfuse({
-    secretKey: "sk-lf-f389bb1e-24db-4b42-b506-8d6118f45044",
-    publicKey: "pk-lf-ee301553-7a64-4f0f-bf6b-a2ac1e5ca2df",
-    baseUrl: "https://xray-langfuse.devops.xiaohongshu.com",
+    secretKey,
+    publicKey,
+    baseUrl,
+    environment: process.env.OPEN_PLATFORM_STAGE || "development",
+    enabled: Boolean(secretKey && publicKey && baseUrl),
 });
 exports.default = exports.langfuse;

package/lib/utils/apm.config.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultConfig = exports.APM_MEASUREMENT_NAME = void 0;
+const endpoints_1 = require("@vectorx/endpoints");
 exports.APM_MEASUREMENT_NAME = "vectorx_kit_agent_runtime";
 exports.defaultConfig = {
-    endpoint: "https://apm-fe.xiaohongshu.com/api/data",
+    endpoint: (0, endpoints_1.resolveUrl)("@vectorx/functions-framework", "apmDataEndpoint"),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectorx/functions-framework",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "VectorX Functions Framework",
   "main": "lib/index.js",
   "types": "types/index.d.ts",
@@ -25,7 +25,8 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@vectorx/ai-types": "0.7.0",
+    "@vectorx/ai-types": "1.0.0",
+    "@vectorx/endpoints": "1.0.0",
     "async_hooks": "^1.0.0",
     "chalk": "4",
     "commander": "^12.1.0",
@@ -72,5 +73,5 @@
     "lint": "eslint src --ext .ts",
     "run:demo": "node ./bin/rcb-ff.js"
   },
-  "readme": "# VectorX Functions Framework\n\nVectorX Functions Framework 是一个用于构建和运行云函数的框架，提供了完整的日志系统支持。\n\n## 日志系统\n\n框架内置了完整的日志系统，支持请求日志记录和用户代码日志记录。\n\n### 配置\n\n在初始化框架时，可以配置日志系统：\n\n```typescript\nimport { createAgentServerFramework } from '@vectorx/functions-framework';\n\nconst framework = createAgentServerFramework({\n    port: 3000,\n    logging: {\n        dirname: '/path/to/logs',  // 日志存储目录\n        maxSize: '20m',           // 单个日志文件最大大小\n        maxFiles: 14              // 保留的日志文件数量\n    }\n});\n```\n\n### 日志类型\n\n框架支持两种类型的日志：\n\n- `ACCESS`: 访问日志，记录所有 HTTP 请求\n- `USERCODE`: 用户代码日志，记录用户函数中的日志\n\n### 日志查询 API\n\n框架提供了日志查询 API，用于查看和调试日志：\n\n```\nGET /@logs\n```\n\n#### 查询参数\n\n| 参数名 | 类型 | 必填 | 说明 |\n|--------|------|------|------|\n| type | string | 否 | 日志类型，可选值：ACCESS/USERCODE，默认 ACCESS |\n| limit | number | 否 | 返回的日志条数限制，默认 100 |\n| eventId | string | 否 | 按 eventId 过滤日志 |\n\n#### 示例\n\n1. 查询所有访问日志：\n```bash\ncurl 'http://localhost:3000/@logs?type=ACCESS'\n```\n\n2. 查询特定 eventId 的日志：\n```bash\ncurl 'http://localhost:3000/@logs?eventId=550e8400-e29b-41d4-a716-446655440000'\n```\n\n3. 限制返回条数：\n```bash\ncurl 'http://localhost:3000/@logs?limit=10'\n```\n\n4. 组合查询：\n```bash\ncurl 'http://localhost:3000/@logs?type=USERCODE&eventId=550e8400-e29b-41d4-a716-446655440000&limit=20'\n```\n\n#### 响应格式\n\n成功响应：\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"@timestamp\": \"2024-03-21T10:30:00.000Z\",\n            \"level\": \"info\",\n            \"eventId\": \"550e8400-e29b-41d4-a716-446655440000\",\n            \"message\": \"Request started\",\n            \"method\": \"GET\",\n            \"url\": \"/api/example\"\n        }\n    ]\n}\n```\n\n错误响应：\n```json\n{\n    \"success\": false,\n    \"error\": \"错误信息\"\n}\n```\n\n### 在代码中使用日志\n\n```typescript\nimport { functionsLogger } from '@vectorx/functions-framework';\nimport { LogLevel } from '@vectorx/functions-framework';\n\n// 记录访问日志\nfunctionsLogger.logAccesslog(LogLevel.INFO, 'Custom message', {\n    customField: 'value'\n});\n\n// 记录用户代码日志\nfunctionsLogger.logUserCodelog([\n    { message: 'User log message', level: 'info' }\n]);\n```\n\n### 日志格式\n\n每条日志都包含以下字段：\n\n- `@timestamp`: 日志时间戳\n- `level`: 日志级别\n- `eventId`: 请求 ID\n- `message`: 日志消息\n- 其他自定义字段\n\n## 开发\n\n### 运行测试\n\n```bash\nnpm test\n```\n\n### 构建\n\n```bash\nnpm run build\n``` \n\n\n### 环境管理\n读取 .env 文件，校验 env 文件的可用性，获取当前运行环境\n"
+  "readme": "# VectorX Functions Framework\n\nVectorX Functions Framework 是一个用于构建和运行云函数的框架，提供了完整的日志系统支持。\n\n## 日志系统\n\n框架内置了完整的日志系统，支持请求日志记录和用户代码日志记录。\n\n### 配置\n\n在初始化框架时，可以配置日志系统：\n\n```typescript\nimport { createAgentServerFramework } from '@vectorx/functions-framework';\n\nconst framework = createAgentServerFramework({\n    port: 3000,\n    logging: {\n        dirname: '/path/to/logs',  // 日志存储目录\n        maxSize: '20m',           // 单个日志文件最大大小\n        maxFiles: 14              // 保留的日志文件数量\n    }\n});\n```\n\n### 日志类型\n\n框架支持两种类型的日志：\n\n- `ACCESS`: 访问日志，记录所有 HTTP 请求\n- `USERCODE`: 用户代码日志，记录用户函数中的日志\n\n### 日志查询 API\n\n框架提供了日志查询 API，用于查看和调试日志：\n\n```\nGET /@logs\n```\n\n#### 查询参数\n\n| 参数名 | 类型 | 必填 | 说明 |\n|--------|------|------|------|\n| type | string | 否 | 日志类型，可选值：ACCESS/USERCODE，默认 ACCESS |\n| limit | number | 否 | 返回的日志条数限制，默认 100 |\n| eventId | string | 否 | 按 eventId 过滤日志 |\n\n#### 示例\n\n1. 查询所有访问日志：\n```bash\ncurl 'http://localhost:3000/@logs?type=ACCESS'\n```\n\n2. 查询特定 eventId 的日志：\n```bash\ncurl 'http://localhost:3000/@logs?eventId=550e8400-e29b-41d4-a716-446655440000'\n```\n\n3. 限制返回条数：\n```bash\ncurl 'http://localhost:3000/@logs?limit=10'\n```\n\n4. 组合查询：\n```bash\ncurl 'http://localhost:3000/@logs?type=USERCODE&eventId=550e8400-e29b-41d4-a716-446655440000&limit=20'\n```\n\n#### 响应格式\n\n成功响应：\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"@timestamp\": \"2024-03-21T10:30:00.000Z\",\n            \"level\": \"info\",\n            \"eventId\": \"550e8400-e29b-41d4-a716-446655440000\",\n            \"message\": \"Request started\",\n            \"method\": \"GET\",\n            \"url\": \"/api/example\"\n        }\n    ]\n}\n```\n\n错误响应：\n```json\n{\n    \"success\": false,\n    \"error\": \"错误信息\"\n}\n```\n\n### 在代码中使用日志\n\n```typescript\nimport { functionsLogger } from '@vectorx/functions-framework';\nimport { LogLevel } from '@vectorx/functions-framework';\n\n// 记录访问日志\nfunctionsLogger.logAccesslog(LogLevel.INFO, 'Custom message', {\n    customField: 'value'\n});\n\n// 记录用户代码日志\nfunctionsLogger.logUserCodelog([\n    { message: 'User log message', level: 'info' }\n]);\n```\n\n### 日志格式\n\n每条日志都包含以下字段：\n\n- `@timestamp`: 日志时间戳\n- `level`: 日志级别\n- `eventId`: 请求 ID\n- `message`: 日志消息\n- 其他自定义字段\n\n## 开发\n\n### 运行测试\n\n```bash\nnpm test\n```\n\n### 构建\n\n```bash\nnpm run build\n``` \n\n### 环境管理\n读取 .env 文件，校验 env 文件的可用性，获取当前运行环境\n\n\n## rcb-ff 自动检测项目类型\n\n当直接使用 `rcb-ff` 命令启动服务时，如果未指定 `--mode` 参数，会自动检测项目类型：\n\n### 检测规则\n\n1. **Agent 项目检测**：\n   - 如果存在 `project.config.json` 文件且包含 `agentId` 字段，则判定为 `agent` 项目\n\n2. **Fun 项目检测**：\n   - 如果不存在 `project.config.json` 或 `project.config.json` 中不存在 `agentId` 字段\n   - 且存在 `agent-cloudbase-functions.json` 配置文件\n   - 则判定为 `fun` 项目\n\n3. **默认行为**：\n   - 如果无法确定项目类型，默认使用 `agent` 模式（保持向后兼容）\n\n### 使用示例\n\n```bash\n# 自动检测项目类型（推荐）\nrcb-ff --directory ./my-project\n\n# 明确指定模式（覆盖自动检测）\nrcb-ff --directory ./my-project --mode fun\nrcb-ff --directory ./my-project --mode agent\n```\n"
 }

package/types/framework.d.ts

@@ -1,4 +1,5 @@
 declare function getDependencyVersion(packageName: string, searchPath: string): string | null;
+export type FrameworkMode = "agent" | "fun";
 export interface FrameworkOptions {
     port: number;
     timeoutMS: number;
@@ -18,6 +19,7 @@ export interface FrameworkOptions {
     redLangfuseConfig?: {
         enable?: boolean;
     };
+    mode?: FrameworkMode;
 }
 export type FunctionName = string;
 declare class AgentServerFramework {
@@ -27,6 +29,9 @@ declare class AgentServerFramework {
     constructor(options: FrameworkOptions);
     startServer(): Promise<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
     getRegisteredFunction(fnName: string): Function;
+    private loadAgentModeConfigs;
+    private loadFunModeConfigs;
+    private loadAndRegisterFunctions;
 }
 export { getDependencyVersion };
 export declare function createAgentServerFramework(options: FrameworkOptions): AgentServerFramework;

package/types/middlewares/index.d.ts

@@ -1,5 +1,6 @@
 export { asyncContextMiddleware } from "./middle-async-context";
 export { contextInjectionMiddleware } from "./middle-context-injection";
+export { envVarsInjectionMiddleware } from "./middle-env-vars-injection";
 export { eventIdMiddleware } from "./middle-event-id";
 export { functionRouteMiddleware } from "./middle-function-route";
 export { loggerMiddleware } from "./middle-common-logger";

package/types/middlewares/middle-env-vars-injection.d.ts

@@ -0,0 +1,2 @@
+import type { Context, Next } from "koa";
+export declare function envVarsInjectionMiddleware(): (ctx: Context, next: Next) => Promise<void>;

package/types/router.d.ts

@@ -2,14 +2,14 @@ import type { CloudFunctionConfig, RouteConfig } from "./function-loader";
 export declare class Router {
     private routes;
     private router;
-    constructor(config: CloudFunctionConfig);
+    constructor(config?: CloudFunctionConfig);
     private addRoute;
     findRoute(path: string): RouteConfig | null;
 }
 export declare function routeFunction(router: Router | undefined, path: string): {
-    routeDefinition: RouteConfig;
-    handleFunction: Function;
-} | {
     routeDefinition?: undefined;
     handleFunction?: undefined;
+} | {
+    routeDefinition: RouteConfig;
+    handleFunction: Function;
 };

package/types/server.d.ts

@@ -24,10 +24,22 @@ export interface RcbContext {
     eventID: string;
     eventType: string;
     timestamp: number;
+    headers: Record<string, any>;
+    httpMethod: string;
+    path: string;
+    url: string;
+    query: Record<string, any>;
+    cookies: Record<string, string>;
+    trigger: "online" | "ide_debug" | "console_debug";
     httpContext: any;
     request: Request;
     logger: typeof functionsLogger;
     baseUrl: string;
+    set: (field: string, value: any) => void;
+    remove: (field: string) => void;
+    status: (code: number) => void;
+    setCookie: (name: string, value: string, options?: any) => void;
+    clearCookie: (name: string, options?: any) => void;
     sse: () => any;
 }
 export declare function createServer(options: FrameworkOptions, router: Router, projectConfig: ProjectConfig): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;