@cloudbase/manager-node 4.7.0-beta.0 → 4.7.1

package/lib/agent/index.js

@@ -15,18 +15,14 @@ const utils_1 = require("../utils");
 const path_1 = __importDefault(require("path"));
 /**
  * Agent 管理类
- * 提供新版 Agent 的完整生命周期管理功能
  */
 class AgentService {
     constructor(environment) {
         this.environment = environment;
         this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
-        this.scfService = new utils_1.CloudService(environment.cloudBaseContext, 'scf', '2018-04-16');
-        this.functionService = environment.getFunctionService();
-        this.userService = environment.getUserService();
     }
     /**
-     * 创建函数型 Agent（兼容旧版本）
+     * 创建函数型 Agent
      * @param {string} [cwd=process.cwd()] 工作目录
      * @param {ICreateFunctionAgentParams} agentInfo Agent 信息
      * @returns {Promise<{ BotId: string; RequestId: string }>} Agent 创建结果
@@ -67,145 +63,8 @@ class AgentService {
         });
         return this.tcbService.request('CreateBot', Object.assign(Object.assign({}, agentInfo), { EnvId: envConfig.EnvId, PackageName: packageName, PackageVersion: packageVersion }));
     }
-    /**
-     * 部署新版 Agent 到 web云函数
-     * @param {ICreateAgentParams} params 创建参数
-     * @returns {Promise<IResponseInfo>} 创建结果
-     */
-    async deployWebFn(params, isFirstDeploy = true) {
-        const envConfig = this.environment.lazyEnvironmentConfig;
-        const { name, agentId, agentPath, agentRootPath, deployConfig } = params;
-        // 构造部署参数
-        const deployAgentData = Object.assign({}, deployConfig);
-        // 上传代码包到 COS
-        const uploadRes = await this.functionService.uploadFunctionZipToCos({ func: { name: name, ignore: deployConfig.ignore }, functionPath: agentPath, functionRootPath: agentRootPath }, 'FALSE');
-        console.log('uploadRes', uploadRes);
-        const { Key } = uploadRes;
-        console.log('tempobjectkey', Key);
-        deployAgentData.code = {
-            cosBucketRegion: 'ap-shanghai',
-            tempCosObjectName: `/${Key}`
-        };
-        // 使用 zipFile 上传
-        // deployAgentData.code = await this.getCodeParams({ deployConfig, agentPath, agentRootPath })
-        try {
-            let res;
-            if (isFirstDeploy) {
-                // 调用创建接口 TODO: 临时屏蔽 resourceList
-                res = await this.tcbService.request('CreateAgent', (0, utils_1.upperCaseObjKey)({
-                    envId: envConfig.EnvId,
-                    // agentId,
-                    name,
-                    runtimeConfig: Object.assign(Object.assign({}, deployAgentData), { ignore: undefined, resources: undefined, environment: undefined, functionName: undefined })
-                }));
-                console.log('CreateAgent res', res);
-                // 等待函数状态正常
-                await this.functionService.waitFunctionActive(res.AgentId);
-            }
-            else {
-                // 调用函数代码更新接口
-                res = await this.scfService.request('UpdateFunctionCode', {
-                    FunctionName: agentId,
-                    Namespace: envConfig.EnvId,
-                    InstallDependency: 'FALSE',
-                    Code: deployAgentData.code
-                });
-                console.log('UpdateFunctionCode res', res);
-                // 等待函数状态正常
-                await this.functionService.waitFunctionActive(agentId);
-            }
-            return res;
-        }
-        catch (error) {
-            throw new Error(`${isFirstDeploy ? '创建' : '更新'} Agent 失败: ${error.message}`);
-        }
-    }
-    /**
-     * 获取 Agent 列表
-     * @param {IListAgentsParams} [params] 查询参数
-     * @returns {Promise<IListAgentsResponse>} Agent 列表
-     */
-    async list(params) {
-        const envConfig = this.environment.lazyEnvironmentConfig;
-        const { limit = 20, offset = 0, agentId } = params || {};
-        // 转化为 pageSize 和 pageNum
-        const pageSize = limit;
-        const pageNumber = Math.floor(offset / limit) + 1;
-        try {
-            const params = {
-                EnvId: envConfig.EnvId,
-            };
-            if (agentId) {
-                params.AgentId = agentId;
-            }
-            else {
-                params.PageSize = pageSize;
-                params.PageNumber = pageNumber;
-            }
-            const res = await this.tcbService.request('DescribeAgentList', params);
-            console.log('DescribeAgentList res', JSON.stringify(res, null, 2));
-            const transformAggentList = await Promise.all(res.AgentList.map(async (item) => {
-                const fnDetail = await this.functionService.getFunctionDetail(item.AgentId);
-                return Object.assign(Object.assign({}, item), { RuntimeConfig: Object.assign(Object.assign({}, item.RuntimeConfig), { Runtime: fnDetail.Runtime, MemorySize: fnDetail.MemorySize, Timeout: fnDetail.Timeout }) });
-            }));
-            return Object.assign(Object.assign({}, res), { AgentList: transformAggentList });
-        }
-        catch (error) {
-            throw new Error(`获取 Agent 列表失败: ${error.message}`);
-        }
-    }
-    /**
-     * 获取 Agent 详情
-     * @param {object} params 查询参数
-     * @param {string} params.agentId Agent ID
-     * @returns {Promise<IAgentDetailResponse>} Agent 详情
-     */
-    async getAgentInfo(params) {
-        const listRes = await this.list({ agentId: params.agentId });
-        if (listRes.Total > 0) {
-            return listRes.AgentList[0];
-        }
-        else {
-            return null;
-        }
-    }
-    /**
-     * 删除 Agent
-     * @param {IDeleteAgentParams} params 删除参数
-     * @returns {Promise<IResponseInfo>} 删除结果
-     */
-    async delete(params) {
-        const envConfig = this.environment.lazyEnvironmentConfig;
-        const { agentId } = params;
-        try {
-            // 1. 删除 Agent 实体
-            const res = await this.tcbService.request('DeleteAgent', {
-                EnvId: envConfig.EnvId,
-                AgentId: agentId
-            });
-            // 2. 删除 agentId 对应的函数
-            const deleteFunctionRes = await this.functionService.deleteFunction({ name: agentId });
-            console.log('deleteFunctionRes', deleteFunctionRes);
-            return res;
-        }
-        catch (error) {
-            throw new Error(`删除 Agent 失败: ${error.message}`);
-        }
-    }
 }
 exports.AgentService = AgentService;
 __decorate([
     (0, utils_1.preLazy)()
 ], AgentService.prototype, "createFunctionAgent", null);
-__decorate([
-    (0, utils_1.preLazy)()
-], AgentService.prototype, "deployWebFn", null);
-__decorate([
-    (0, utils_1.preLazy)()
-], AgentService.prototype, "list", null);
-__decorate([
-    (0, utils_1.preLazy)()
-], AgentService.prototype, "getAgentInfo", null);
-__decorate([
-    (0, utils_1.preLazy)()
-], AgentService.prototype, "delete", null);

package/lib/cloudrun/index.js

@@ -196,7 +196,7 @@ class CloudRunService {
         if (await this._checkFunctionExist(serverName)) {
             // 更新
             const serverDetail = await this.detail({ serverName });
-            const _serverConfig = Object.assign(Object.assign({}, serverConfig), ((serverDetail === null || serverDetail === void 0 ? void 0 : serverDetail.ServerConfig.Tag) === 'function:' ? { Port: 3000 } : {}) // 函数型不能指定端口，需要固定为3000
+            const _serverConfig = Object.assign(Object.assign(Object.assign({}, serverConfig), { OpenAccessTypes: ['OA', 'PUBLIC', 'MINIAPP'] }), ((serverDetail === null || serverDetail === void 0 ? void 0 : serverDetail.ServerConfig.Tag) === 'function:' ? { Port: 3000 } : {}) // 函数型不能指定端口，需要固定为3000
             );
             if ((serverDetail === null || serverDetail === void 0 ? void 0 : serverDetail.ServerConfig.Tag) === 'function:') {
                 deployInfo.BuildPacks = {
@@ -231,7 +231,7 @@ class CloudRunService {
                     RepoLanguage: 'Node.js'
                 };
             }
-            const _serverConfig = Object.assign(Object.assign(Object.assign({ OpenAccessTypes: ['OA', 'PUBLIC'], 
+            const _serverConfig = Object.assign(Object.assign(Object.assign({ OpenAccessTypes: ['OA', 'PUBLIC', 'MINIAPP'], 
                 // Cpu: 0,
                 // Mem: 0,
                 MinNum: 0, 

package/lib/common/index.js

@@ -13,7 +13,7 @@ const ActionVersionMap = {
     flexdb: '2018-11-27',
     scf: '2018-04-16',
     sts: '2018-04-16',
-    cam: '2018-04-16',
+    cam: '2019-01-16',
     lowcode: '2021-01-08'
 };
 class CommonService {

package/lib/constant.js

@@ -4,7 +4,7 @@
 //     static credentail = 'credential'
 // }
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COS_SDK_KEEPALIVE = exports.COS_SDK_PROTOCOL = exports.USE_INTERNAL_ENDPOINT = exports.SCF_STATUS = exports.ROLE_NAME = exports.PUBLIC_RSA_KEY = exports.ERROR = exports.SERVICE_TYPE = exports.ENDPOINT = exports.RUN_ENV = exports.SDK_VERSION = exports.ENV_NAME = void 0;
+exports.COS_SDK_KEEPALIVE = exports.COS_SDK_PROTOCOL = exports.INTERNAL_ENDPOINT_REGION = exports.USE_INTERNAL_ENDPOINT = exports.SCF_STATUS = exports.ROLE_NAME = exports.PUBLIC_RSA_KEY = exports.ERROR = exports.SERVICE_TYPE = exports.ENDPOINT = exports.RUN_ENV = exports.SDK_VERSION = exports.ENV_NAME = void 0;
 exports.ENV_NAME = {
     ENV_SECRETID: 'TENCENTCLOUD_SECRETID',
     ENV_SECRETKEY: 'TENCENTCLOUD_SECRETKEY',
@@ -56,5 +56,6 @@ exports.SCF_STATUS = {
 };
 // 是否使用内网域名
 exports.USE_INTERNAL_ENDPOINT = "USE_INTERNAL_ENDPOINT" in process.env;
+exports.INTERNAL_ENDPOINT_REGION = process.env.INTERNAL_ENDPOINT_REGION;
 exports.COS_SDK_PROTOCOL = process.env.COS_SDK_PROTOCOL;
 exports.COS_SDK_KEEPALIVE = process.env.COS_SDK_KEEPALIVE;

package/lib/context.js

@@ -1,14 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CloudBaseContext = void 0;
+const constant_1 = require("./constant");
 class CloudBaseContext {
-    constructor({ secretId = '', secretKey = '', token = '', proxy = '', region = '', envType = '' }) {
+    constructor({ secretId = '', secretKey = '', token = '', proxy = '', region = '', envType = '', useInternalEndpoint = undefined, internalEndpointRegion = undefined }) {
         this.secretId = secretId;
         this.secretKey = secretKey;
         this.token = token;
         this.proxy = proxy;
         this.region = region;
         this.envType = envType;
+        this.useInternalEndpoint = useInternalEndpoint;
+        this.internalEndpointRegion = internalEndpointRegion;
+    }
+    isInternalEndpoint() {
+        return this.useInternalEndpoint !== undefined ? this.useInternalEndpoint : constant_1.USE_INTERNAL_ENDPOINT;
+    }
+    getInternalEndpointRegion() {
+        return this.internalEndpointRegion || constant_1.INTERNAL_ENDPOINT_REGION;
     }
 }
 exports.CloudBaseContext = CloudBaseContext;

package/lib/env/index.js

@@ -280,19 +280,20 @@ class EnvService {
         });
     }
     getCos() {
+        const internalEndpoint = this.environment.cloudBaseContext.isInternalEndpoint();
         const { secretId, secretKey, token } = this.environment.getAuthConfig();
         const cosConfig = {
             SecretId: secretId,
             SecretKey: secretKey,
             SecurityToken: token,
-            Domain: constant_1.USE_INTERNAL_ENDPOINT ? "{Bucket}.cos-internal.{Region}.tencentcos.cn" /* COS_ENDPOINT.INTERNAL */ : "{Bucket}.cos.{Region}.tencentcos.cn" /* COS_ENDPOINT.PUBLIC */,
+            Domain: internalEndpoint ? "{Bucket}.cos-internal.{Region}.tencentcos.cn" /* COS_ENDPOINT.INTERNAL */ : "{Bucket}.cos.{Region}.tencentcos.cn" /* COS_ENDPOINT.PUBLIC */,
         };
         if (constant_1.COS_SDK_PROTOCOL) {
             cosConfig.Protocol = (constant_1.COS_SDK_PROTOCOL.endsWith(':')
                 ? constant_1.COS_SDK_PROTOCOL.toLowerCase()
                 : constant_1.COS_SDK_PROTOCOL.toLowerCase() + ':');
         }
-        if (constant_1.USE_INTERNAL_ENDPOINT) {
+        if (internalEndpoint) {
             cosConfig.Protocol = 'http:';
         }
         return new cos_nodejs_sdk_v5_1.default(cosConfig);

package/lib/environment.js

@@ -33,6 +33,7 @@ class Environment {
         this.hostingService = new hosting_1.HostingService(this);
         this.thirdService = new third_1.ThirdService(this);
         this.accessService = new access_1.AccessService(this);
+        this.userService = new user_1.UserService(this);
         this.cloudBaseRunService = new cloudBaseRun_1.CloudBaseRunService(this);
     }
     async lazyInit() {

package/lib/function/index.js

@@ -13,11 +13,11 @@ exports.FunctionService = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const lodash_1 = __importDefault(require("lodash"));
+const cos_nodejs_sdk_v5_1 = __importDefault(require("cos-nodejs-sdk-v5"));
 const packer_1 = require("./packer");
 const error_1 = require("../error");
 const utils_1 = require("../utils");
 const constant_1 = require("../constant");
-const cos_nodejs_sdk_v5_1 = __importDefault(require("cos-nodejs-sdk-v5"));
 // 是否为 Node 函数
 function isNodeFunction(runtime) {
     // 不严格限制
@@ -78,6 +78,14 @@ function configToParams(options) {
         }));
         params.Layers = transformLayers;
     }
+    // HTTP 云函数类型
+    if ((func === null || func === void 0 ? void 0 : func.type) === 'HTTP') {
+        params.Type = 'HTTP';
+    }
+    // 云函数描述
+    if (func === null || func === void 0 ? void 0 : func.description) {
+        params.Description = func.description;
+    }
     return params;
 }
 class FunctionService {
@@ -95,12 +103,12 @@ class FunctionService {
      * @memberof FunctionService
      */
     async updateFunctionIncrementalCode(funcParam) {
-        const { namespace } = this.getFunctionConfig();
+        const { env } = this.getFunctionConfig();
         const { functionRootPath, func, deleteFiles, addFiles } = funcParam;
         const { name, runtime } = func;
         const params = {
             FunctionName: name,
-            Namespace: namespace
+            EnvId: env
         };
         let packer;
         let base64;
@@ -124,7 +132,7 @@ class FunctionService {
             }
             params.AddFiles = base64;
         }
-        return this.scfService.request('UpdateFunctionIncrementalCode', params);
+        return this.tcbService.request('UpdateFunctionIncrementalCode', params);
     }
     /**
      * 创建云函数
@@ -132,14 +140,14 @@ class FunctionService {
      * @returns {(Promise<IResponseInfo | ICreateFunctionRes>)}
      */
     async createFunction(funcParam) {
-        const { namespace } = this.getFunctionConfig();
-        const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath } = funcParam;
+        const { env } = this.getFunctionConfig();
+        const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath, deployMode } = funcParam;
         const funcName = func.name;
         const params = configToParams({
             func,
             codeSecret,
             baseParams: {
-                Namespace: namespace,
+                EnvId: env,
                 Role: 'TCB_QcsRole',
                 Stamp: 'MINI_QCBASE'
             }
@@ -148,14 +156,15 @@ class FunctionService {
             func,
             base64Code,
             functionPath,
-            functionRootPath
+            functionRootPath,
+            deployMode
         }, params.InstallDependency);
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         params.ClsTopicId = TopicId;
         params.ClsLogsetId = LogsetId;
         try {
             // 创建云函数
-            const res = await this.scfService.request('CreateFunction', params);
+            const res = await this.tcbService.request('CreateFunction', params);
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 创建函数触发器、失败自动重试
@@ -224,9 +233,9 @@ class FunctionService {
      */
     async getFunctionList(limit = 20, offset = 0) {
         // 获取Function 环境配置
-        const { namespace } = this.getFunctionConfig();
-        const res = await this.scfService.request('ListFunctions', {
-            Namespace: namespace,
+        const { env } = this.getFunctionConfig();
+        const res = await this.tcbService.request('ListFunctions', {
+            EnvId: env,
             Limit: limit,
             Offset: offset
         });
@@ -357,16 +366,17 @@ class FunctionService {
      * @returns {Promise<Record<string, string>>}
      */
     async getFunctionDetail(name, codeSecret) {
-        const { namespace } = this.getFunctionConfig();
+        const { env } = this.getFunctionConfig();
         const params = {
             FunctionName: name,
-            Namespace: namespace,
-            ShowCode: 'TRUE'
+            EnvId: env,
+            ShowCode: 'TRUE',
+            Namespace: env
         };
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
-        const data = await this.scfService.request('GetFunction', params);
+        const data = await this.tcbService.request('GetFunction', params);
         // 解析 VPC 配置
         const { VpcId = '', SubnetId = '' } = data.VpcConfig || {};
         if (VpcId && SubnetId) {
@@ -556,6 +566,9 @@ class FunctionService {
             Namespace: namespace,
             L5Enable: l5Enable
         };
+        if (func === null || func === void 0 ? void 0 : func.description) {
+            params.Description = func.description;
+        }
         // 修复参数存在 undefined 字段时，会出现鉴权失败的情况
         // Environment 为覆盖式修改，不保留已有字段
         envVariables.length && (params.Environment = { Variables: envVariables });
@@ -612,9 +625,9 @@ class FunctionService {
      * @memberof FunctionService
      */
     async updateFunctionCode(funcParam) {
-        const { func, functionRootPath, base64Code, codeSecret, functionPath } = funcParam;
+        const { func, functionRootPath, base64Code, codeSecret, functionPath, deployMode } = funcParam;
         const funcName = func.name;
-        const { namespace } = this.getFunctionConfig();
+        const { env } = this.getFunctionConfig();
         let installDependency;
         // Node 函数默认安装依赖
         installDependency = isNodeFunction(func.runtime) ? 'TRUE' : 'FALSE';
@@ -626,9 +639,16 @@ class FunctionService {
             func,
             functionPath,
             functionRootPath,
-            base64Code
+            base64Code,
+            deployMode
         }, installDependency);
-        const params = Object.assign({ FunctionName: funcName, Namespace: namespace, Handler: func.handler || 'index.main', InstallDependency: installDependency }, codeParams);
+        const params = {
+            FunctionName: funcName,
+            EnvId: env,
+            Handler: func.handler || 'index.main',
+            InstallDependency: installDependency,
+            Code: codeParams
+        };
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
@@ -636,7 +656,7 @@ class FunctionService {
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 更新云函数代码
-            const res = await this.scfService.request('UpdateFunctionCode', params);
+            const res = await this.tcbService.request('UpdateFunctionCode', params);
             if (installDependency && func.isWaitInstall === true) {
                 await this.waitFunctionActive(funcName, codeSecret);
             }
@@ -1145,14 +1165,17 @@ class FunctionService {
             Namespace: namespace
         });
     }
-    async uploadFunctionZipToCos(options, installDependency) {
-        const { func, functionPath, functionRootPath, base64Code } = options;
-        const { env } = await this.getFunctionConfig();
+    /**
+     * 通过scf COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
+     * 返回 TempCosObjectName 用于创建/更新函数
+     */
+    async uploadFunctionZipToCosLegacy(options, installDependency) {
+        const { func, functionPath, functionRootPath } = options;
+        const { env } = this.getFunctionConfig();
         const { CloudAppId } = await this.userService.getTcbAccountInfo();
         const objectPath = `${CloudAppId}/${env}/${func.name}.zip`;
-        console.log('objectPath', objectPath);
         // 1. 生成存放函数包的临时 Cos 目录
-        const { Date, Sign, RequestId } = await this.scfService.request('GetTempCosInfo', {
+        const { Date: cosDate, Sign } = await this.scfService.request('GetTempCosInfo', {
             ObjectPath: `${objectPath}`
         });
         // 2. 本地压缩
@@ -1170,7 +1193,7 @@ class FunctionService {
         });
         const zipFilePath = await packer.compressFiles();
         // 3. 初始化 cos 并上传
-        const tempCosObjectName = `/${Date}/${objectPath}`;
+        const tempCosObjectName = `/${cosDate}/${objectPath}`;
         const TEMP_COS_APPID = '1253665819';
         const uploadParams = {
             Bucket: `shtempcos-${TEMP_COS_APPID}`,
@@ -1185,7 +1208,9 @@ class FunctionService {
             }
         });
         return new Promise((resolve, reject) => {
-            cos.sliceUploadFile(uploadParams, (err, data) => {
+            cos.sliceUploadFile(uploadParams, async (err, data) => {
+                // 清理临时文件
+                await packer.clean();
                 if (err) {
                     reject(err);
                 }
@@ -1195,6 +1220,59 @@ class FunctionService {
             });
         });
     }
+    /**
+     * 新的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
+     * 返回 CosTimestamp 用于创建/更新函数
+     */
+    async uploadFunctionZipToCos(options, installDependency) {
+        const { func, functionPath, functionRootPath } = options;
+        const { env } = this.getFunctionConfig();
+        // 1. 生成存放函数包的临时 Cos 目录
+        const { UploadUrl, UnixTimestamp, UploadHeaders } = await this.tcbService.request('DescribeBuildServiceCosInfo', {
+            EnvId: env,
+            ServiceName: func.name,
+            Business: 'scf',
+            Suffix: '.zip'
+        });
+        // 2. 本地压缩
+        const codeType = packer_1.CodeType.File;
+        // 云端安装依赖，自动忽略 node_modules 目录
+        const ignore = installDependency === 'TRUE'
+            ? ['node_modules/**/*', 'node_modules', ...(func.ignore || [])]
+            : [...(func.ignore || [])];
+        const packer = new packer_1.FunctionPacker({
+            ignore,
+            codeType,
+            functionPath,
+            name: func.name,
+            root: functionRootPath
+        });
+        const zipFilePath = await packer.compressFiles();
+        // 3. 通过 UploadUrl 直接上传
+        const fileBuffer = fs_1.default.readFileSync(zipFilePath);
+        // 构建请求头
+        const headers = {
+            'Content-Type': 'application/zip'
+        };
+        if (UploadHeaders && UploadHeaders.length > 0) {
+            UploadHeaders.forEach(item => {
+                headers[item.Key] = item.Value;
+            });
+        }
+        const response = await fetch(UploadUrl, {
+            method: 'PUT',
+            body: fileBuffer,
+            headers
+        });
+        if (!response.ok) {
+            throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}`);
+        }
+        // 清理临时文件
+        await packer.clean();
+        return {
+            UnixTimestamp
+        };
+    }
     async createAccessPath(name, path) {
         const access = this.environment.getAccessService();
         try {
@@ -1219,11 +1297,13 @@ class FunctionService {
         }
     }
     async getCodeParams(options, installDependency) {
-        const { func, functionPath, functionRootPath, base64Code } = options;
-        // 20MB
-        const BIG_LENGTH = 167772160;
-        if ((base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) > BIG_LENGTH) {
-            throw new error_1.CloudBaseError('base64 不能大于 20 MB');
+        const { func, functionPath, functionRootPath, base64Code, deployMode } = options;
+        // 更新的时候直接上传的zip包的情况
+        // ZIP 包大小上限 20MB，base64 编码后长度约为原始大小的 4/3
+        const MAX_ZIP_SIZE = 20 * 1024 * 1024; // 20MB
+        const MAX_BASE64_LENGTH = Math.floor(MAX_ZIP_SIZE * 4 / 3); // ≈ 27962026
+        if ((base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) > MAX_BASE64_LENGTH) {
+            throw new error_1.CloudBaseError('ZIP 包不能大于 20MB');
         }
         if (base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) {
             return {
@@ -1243,11 +1323,22 @@ class FunctionService {
             root: functionRootPath
         });
         await packer.build();
-        // 通过云 API 传输的代码大小不能超过 50MB
+        // 如果指定了上传方式，按指定方式上传
+        // 判断是否需要走 COS 上传
         const reachMax = await packer.isReachMaxSize();
-        if (reachMax) {
-            throw new error_1.CloudBaseError('函数代码不能大于 50MB');
+        const useCos = deployMode === 'cos' || (deployMode !== 'zip' && reachMax);
+        if (useCos) {
+            // 先调用scf的 COS 上传方式
+            const legacyResult = await this.uploadFunctionZipToCosLegacy(options, installDependency);
+            // 再调用tcb COS 上传方式
+            const cosResult = await this.uploadFunctionZipToCos(options, installDependency);
+            return {
+                CosTimestamp: cosResult.UnixTimestamp,
+                CosBucketRegion: 'ap-shanghai',
+                TempCosObjectName: `/${legacyResult.Key}`
+            };
         }
+        // ZIP base64 上传
         const base64 = await packer.getBase64Code();
         if (!(base64 === null || base64 === void 0 ? void 0 : base64.length)) {
             throw new error_1.CloudBaseError('文件不能为空');
@@ -1451,6 +1542,9 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "getFunctionAlias", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], FunctionService.prototype, "uploadFunctionZipToCosLegacy", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "uploadFunctionZipToCos", null);

package/lib/index.js

@@ -18,7 +18,7 @@ class CloudBase {
     }
     constructor(config = {}) {
         this.cloudBaseConfig = {};
-        let { secretId, secretKey, token, envId, proxy, region, envType } = config;
+        let { secretId, secretKey, token, envId, proxy, region, envType, useInternalEndpoint, internalEndpointRegion } = config;
         // config 中传入的 secretId secretkey 必须同时存在
         if ((secretId && !secretKey) || (!secretId && secretKey)) {
             throw new Error('secretId and secretKey must be a pair');
@@ -30,7 +30,9 @@ class CloudBase {
             envId,
             envType,
             proxy,
-            region
+            region,
+            useInternalEndpoint,
+            internalEndpointRegion,
         };
         // 初始化 context
         this.context = new context_1.CloudBaseContext(this.cloudBaseConfig);
@@ -85,5 +87,8 @@ class CloudBase {
     getManagerConfig() {
         return this.cloudBaseConfig;
     }
+    get isInternalEndpoint() {
+        return this.context.isInternalEndpoint();
+    }
 }
 module.exports = CloudBase;

package/lib/storage/index.js

@@ -838,6 +838,7 @@ class StorageService {
      * 获取 COS 配置
      */
     getCos(parallel = 20) {
+        const internalEndpoint = this.environment.cloudBaseContext.isInternalEndpoint();
         const { secretId, secretKey, token, proxy } = this.environment.getAuthConfig();
         const cosProxy = process.env.TCB_COS_PROXY;
         const cosConfig = {
@@ -846,14 +847,14 @@ class StorageService {
             SecretKey: secretKey,
             Proxy: cosProxy || proxy,
             SecurityToken: token,
-            Domain: constant_1.USE_INTERNAL_ENDPOINT ? "{Bucket}.cos-internal.{Region}.tencentcos.cn" /* COS_ENDPOINT.INTERNAL */ : "{Bucket}.cos.{Region}.tencentcos.cn" /* COS_ENDPOINT.PUBLIC */,
+            Domain: internalEndpoint ? "{Bucket}.cos-internal.{Region}.tencentcos.cn" /* COS_ENDPOINT.INTERNAL */ : "{Bucket}.cos.{Region}.tencentcos.cn" /* COS_ENDPOINT.PUBLIC */,
         };
         if (constant_1.COS_SDK_PROTOCOL) {
             cosConfig.Protocol = (constant_1.COS_SDK_PROTOCOL.endsWith(':')
                 ? constant_1.COS_SDK_PROTOCOL.toLowerCase()
                 : constant_1.COS_SDK_PROTOCOL.toLowerCase() + ':');
         }
-        if (constant_1.USE_INTERNAL_ENDPOINT) {
+        if (internalEndpoint) {
             cosConfig.Protocol = 'http:';
         }
         // COSSDK 默认开启 KeepAlive，这里提供关闭的方式

package/lib/utils/cloud-api-request.js

@@ -61,6 +61,8 @@ class CloudService {
         this.cloudBaseContext = context;
     }
     get baseUrl() {
+        const internalEndpoint = this.cloudBaseContext.isInternalEndpoint();
+        const internalEndpointRegion = this.cloudBaseContext.getInternalEndpointRegion();
         const tcb = process.env.TCB_BASE_URL || 'https://tcb.tencentcloudapi.com';
         const urlMap = {
             tcb,
@@ -74,8 +76,11 @@ class CloudService {
         const intranetUrlMap = Object.keys(urlMap).map((service) => ({
             [service]: `https://${service}.internal.tencentcloudapi.com`,
         })).reduce((acc, cur) => (Object.assign(Object.assign({}, acc), cur)), {});
-        if (constant_1.USE_INTERNAL_ENDPOINT) {
-            return intranetUrlMap[this.service];
+        if (internalEndpoint) {
+            if (internalEndpointRegion) {
+                return `https://${this.service}.${internalEndpointRegion}.tencentcloudapi.woa.com`;
+            }
+            return intranetUrlMap[this.service] || `https://${this.service}.internal.tencentcloudapi.com`;
         }
         if (urlMap[this.service]) {
             return urlMap[this.service];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "4.7.0-beta.0",
+    "version": "4.7.1",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/agent/index.d.ts

@@ -1,19 +1,14 @@
 import { Environment } from '../environment';
-import { IResponseInfo } from '../interfaces';
-import { ICreateFunctionAgentParams, ICreateAgentParams, IAgentListItem, IListAgentsParams, IListAgentsResponse, IDeleteAgentParams } from './type';
+import { ICreateFunctionAgentParams } from './type';
 /**
  * Agent 管理类
- * 提供新版 Agent 的完整生命周期管理功能
  */
 export declare class AgentService {
     private environment;
     private tcbService;
-    private scfService;
-    private functionService;
-    private userService;
     constructor(environment: Environment);
     /**
-     * 创建函数型 Agent（兼容旧版本）
+     * 创建函数型 Agent
      * @param {string} [cwd=process.cwd()] 工作目录
      * @param {ICreateFunctionAgentParams} agentInfo Agent 信息
      * @returns {Promise<{ BotId: string; RequestId: string }>} Agent 创建结果
@@ -22,33 +17,4 @@ export declare class AgentService {
         BotId: string;
         RequestId: string;
     }>;
-    /**
-     * 部署新版 Agent 到 web云函数
-     * @param {ICreateAgentParams} params 创建参数
-     * @returns {Promise<IResponseInfo>} 创建结果
-     */
-    deployWebFn(params: ICreateAgentParams, isFirstDeploy?: boolean): Promise<IResponseInfo & {
-        AgentId?: string;
-    }>;
-    /**
-     * 获取 Agent 列表
-     * @param {IListAgentsParams} [params] 查询参数
-     * @returns {Promise<IListAgentsResponse>} Agent 列表
-     */
-    list(params?: IListAgentsParams): Promise<IListAgentsResponse>;
-    /**
-     * 获取 Agent 详情
-     * @param {object} params 查询参数
-     * @param {string} params.agentId Agent ID
-     * @returns {Promise<IAgentDetailResponse>} Agent 详情
-     */
-    getAgentInfo(params: {
-        agentId: string;
-    }): Promise<IAgentListItem | null>;
-    /**
-     * 删除 Agent
-     * @param {IDeleteAgentParams} params 删除参数
-     * @returns {Promise<IResponseInfo>} 删除结果
-     */
-    delete(params: IDeleteAgentParams): Promise<IResponseInfo>;
 }

package/types/agent/type.d.ts

@@ -20,357 +20,3 @@ export interface ICreateFunctionAgentParams {
      */
     Avatar?: string;
 }
-export interface IEnvironmentVariable {
-    Name: string;
-    Value: string;
-}
-export interface IEnvironment {
-    Variables: IEnvironmentVariable[];
-}
-/**
- * Agent 配置接口
- */
-export interface IAgentConfig {
-    /**
-     * 函数名称
-     */
-    functionName: string;
-    /**
-     * 代码结构
-     */
-    code?: {
-        cosBucketRegion?: string;
-        cosBucketName?: string;
-        cosObjectName?: string;
-        tempCosObjectName?: string;
-        zipFile?: string;
-    };
-    /**
-     * 超时时间（秒）
-     */
-    timeout?: number;
-    /**
-     * 环境变量
-     */
-    environment?: IEnvironment;
-    /**
-     * 运行时
-     */
-    runtime?: string;
-    /**
-     * 内存大小（MB）
-     */
-    memorySize?: number;
-    /**
-     * 描述
-     */
-    description?: string;
-    /**
-     * 会话配置
-     */
-    sessionConfig?: {
-        enable: boolean;
-    };
-    /**
-     * 绑定的资源
-     */
-    resourceList?: IAgentResource[];
-    /**
-     * 忽略的文件或目录
-     */
-    ignore?: string[];
-    installDependency?: boolean;
-}
-/**
- * Agent 资源接口
- */
-export interface IAgentResource {
-    agentId: string;
-    /**
-     * 资源 ID
-     */
-    resourceId: string;
-    /**
-     * 资源类型
-     */
-    resourceType: string;
-    /**
-     * 子类型
-     */
-    subType: string;
-    /**
-     * 资源配置
-     */
-    resourceConfig: {
-        apiKey: string;
-    };
-}
-/**
- * Agent 创建参数
- */
-export interface ICreateAgentParams {
-    /**
-     * Agent ID
-     */
-    agentId?: string;
-    /**
-     * Agent 名称
-     */
-    name: string;
-    /**
-     * 指定的 Agent 路径
-     */
-    agentPath: string;
-    /**
-     * Agent 根路径
-     */
-    agentRootPath: string;
-    deployConfig: IAgentConfig;
-}
-export interface ICreateAgentRes {
-    /**
-     *
-     */
-    agentId: string;
-}
-/**
- * Agent 更新参数
- */
-export type IUpdateAgentParams = ICreateAgentParams;
-/**
- * Agent 列表查询参数
- */
-export interface IListAgentsParams {
-    /**
-     * 每页数量
-     */
-    limit?: number;
-    /**
-     * 偏移量
-     */
-    offset?: number;
-    /**
-     * Agent ID
-     */
-    agentId?: string;
-}
-/**
- * Agent 列表响应
- */
-export interface IListAgentsResponse {
-    /**
-     * Agent 列表
-     */
-    AgentList: IAgentListItem[];
-    /**
-     * 总数
-     */
-    Total: number;
-}
-/**
- * Agent 列表项
- */
-export interface IAgentListItem {
-    /**
-     * Agent ID
-     */
-    AgentId: string;
-    /**
-     * Agent 名称
-     */
-    Name: string;
-    /**
-     * 状态
-     */
-    UpdateTime: string;
-    /**
-     * 运行时配置
-     */
-    RuntimeConfig: IRuntimeConfig;
-}
-export interface IRuntimeConfig {
-    Runtime: string;
-    MemorySize: number;
-    Timeout: number;
-    Environment: string;
-    SessionConfig: {
-        Enable: boolean;
-    };
-}
-export interface IAgentDetailParams {
-    agentId: string;
-}
-/**
- * Agent 详情响应
- */
-export interface IAgentDetailResponse {
-    /**
-     * Agent ID
-     */
-    id: string;
-    /**
-     * Agent 名称
-     */
-    name: string;
-    /**
-     * 状态
-     */
-    status: string;
-    /**
-     * 运行时
-     */
-    runtime: string;
-    /**
-     * 内存大小（MB）
-     */
-    memorySize: number;
-    /**
-     * 超时时间（秒）
-     */
-    timeout: number;
-    /**
-     * 描述
-     */
-    description: string;
-    /**
-     * 创建时间
-     */
-    createTime: string;
-    /**
-     * 更新时间
-     */
-    updateTime: string;
-    /**
-     * 环境变量
-     */
-    environment: IEnvironment;
-    /**
-     * 会话配置
-     */
-    sessionConfig: {
-        enable: boolean;
-    };
-    /**
-     * 绑定的资源
-     */
-    resources: IAgentResource[];
-    /**
-     * 部署信息
-     */
-    deployInfo?: {
-        mode: string;
-        version: string;
-        codeSize: number;
-        lastDeploy: string;
-    };
-}
-/**
- * Agent 删除参数
- */
-export interface IDeleteAgentParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-}
-/**
- * Agent 代码下载参数
- */
-export interface IDownloadAgentCodeParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-    /**
-     * 目标路径
-     */
-    targetPath: string;
-}
-/**
- * 资源绑定参数
- */
-export interface IBindResourceParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-    /**
-     * 资源列表
-     */
-    resourceList: IAgentResource[];
-}
-export interface IBindResourceRes {
-    /**
-     * 受影响的行数
-     */
-    Affected: number;
-}
-/**
- * 资源解绑参数
- */
-export interface IUnbindResourceParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-    /**
-     * 资源 ID
-     */
-    resourceId: string;
-}
-/**
- * 资源解绑响应
- */
-export interface IUnbindResourceRes {
-    /**
-     *
-     */
-    Affected: number;
-}
-/**
- * 获取资源绑定参数
- */
-export interface IGetResourceBindingParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-    /**
-     * 资源 ID
-     */
-    resourceId: string;
-    /**
-     * 资源类型
-     */
-    resourceType: string;
-}
-/**
- * 获取 Agent 资源参数
- */
-export interface IGetAgentResourcesParams {
-    /**
-     * Agent ID
-     */
-    agentId: string;
-}
-/**
- * 资源绑定响应
- */
-export interface IResourceBindingResponse {
-    Total: number;
-    AgentResourceList: IAgentResource[];
-}
-/**
- * Agent 资源响应
- */
-export interface IAgentResourcesResponse {
-    /**
-     * 资源列表
-     */
-    resources: IAgentResource[];
-}
-export interface IAgentCodeOptions {
-    deployConfig: IAgentConfig;
-    agentRootPath?: string;
-    agentPath?: string;
-}

package/types/constant.d.ts

@@ -41,6 +41,7 @@ export declare const SCF_STATUS: {
     DELETE_FAILED: string;
 };
 export declare const USE_INTERNAL_ENDPOINT: boolean;
+export declare const INTERNAL_ENDPOINT_REGION: string;
 export declare const enum COS_ENDPOINT {
     INTERNAL = "{Bucket}.cos-internal.{Region}.tencentcos.cn",
     PUBLIC = "{Bucket}.cos.{Region}.tencentcos.cn"

package/types/context.d.ts

@@ -6,12 +6,18 @@ export declare class CloudBaseContext {
     readonly envId: string;
     readonly region: string;
     readonly envType: string;
-    constructor({ secretId, secretKey, token, proxy, region, envType }: {
+    readonly useInternalEndpoint?: boolean;
+    readonly internalEndpointRegion?: string;
+    constructor({ secretId, secretKey, token, proxy, region, envType, useInternalEndpoint, internalEndpointRegion }: {
         secretId?: string;
         secretKey?: string;
         token?: string;
         proxy?: string;
         region?: string;
         envType?: string;
+        useInternalEndpoint?: any;
+        internalEndpointRegion?: any;
     });
+    isInternalEndpoint(): boolean;
+    getInternalEndpointRegion(): string;
 }

package/types/function/index.d.ts

@@ -6,6 +6,7 @@ export interface IFunctionCode {
     functionRootPath?: string;
     base64Code?: string;
     functionPath?: string;
+    deployMode?: 'cos' | 'zip';
 }
 export interface ICreateFunctionParam {
     func: ICloudFunction & {
@@ -16,6 +17,7 @@ export interface ICreateFunctionParam {
     base64Code?: string;
     functionPath?: string;
     codeSecret?: string;
+    deployMode?: 'cos' | 'zip';
 }
 export interface IUpdateFunctionCodeParam {
     func: ICloudFunction;
@@ -23,6 +25,7 @@ export interface IUpdateFunctionCodeParam {
     functionRootPath?: string;
     base64Code?: string;
     codeSecret?: string;
+    deployMode?: 'cos' | 'zip';
 }
 export interface IUpdateFunctionIncrementalCodeParam {
     func: ICloudFunction;
@@ -479,9 +482,20 @@ export declare class FunctionService {
      * @memberof FunctionService
      */
     getFunctionAlias(params: IGetFunctionAlias): Promise<IGetFunctionAliasRes>;
-    uploadFunctionZipToCos(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
+    /**
+     * 通过scf COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
+     * 返回 TempCosObjectName 用于创建/更新函数
+     */
+    uploadFunctionZipToCosLegacy(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
         Key: string;
     }>;
+    /**
+     * 新的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
+     * 返回 CosTimestamp 用于创建/更新函数
+     */
+    uploadFunctionZipToCos(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
+        UnixTimestamp: string;
+    }>;
     private createAccessPath;
     private getCodeParams;
     private getTempCosInfo;

package/types/function/types.d.ts

@@ -181,7 +181,10 @@ export interface ITag1 {
 export interface IFunctionCode {
     CosBucketName?: string;
     CosObjectName?: string;
-    ZipFile: string;
+    CosBucketRegion?: string;
+    TempCosObjectName?: string;
+    ZipFile?: string;
+    CosTimestamp?: string;
 }
 export interface ILayerVersionItem {
     LayerName: string;

package/types/index.d.ts

@@ -20,6 +20,8 @@ interface CloudBaseConfig {
     proxy?: string;
     region?: string;
     envType?: string;
+    useInternalEndpoint?: boolean;
+    internalEndpointRegion?: string;
 }
 declare class CloudBase {
     private static cloudBase;
@@ -52,5 +54,6 @@ declare class CloudBase {
     get user(): UserService;
     getEnvironmentManager(): EnvironmentManager;
     getManagerConfig(): CloudBaseConfig;
+    get isInternalEndpoint(): Boolean;
 }
 export = CloudBase;

package/types/interfaces/function.interface.d.ts

@@ -23,6 +23,8 @@ export interface LayerVersionSimple {
 }
 export interface ICloudFunction extends ICloudFunctionConfig {
     name: string;
+    description?: string;
+    type?: 'Event' | 'HTTP';
     handler?: string;
     codeSecret?: string;
     isWaitInstall?: boolean;

package/.cursor/rules/cloudbase-rules.mdc

@@ -1,119 +0,0 @@
----
-cloudbaseAIVersion：1.8.20
-description: CloudBase AI 开发规则索引 - 防止不同开发场景的规则互相干扰
-globs: 
-alwaysApply: true
----
-
-#  AI 开发人机协同规则索引
-
-## 核心行为规则
-0. 你擅长调用合适的工具来完成完成各项任务
-1. 你会在对话输出完毕后选择适当的时机向用户提出询问，例如是否需要添加后端能力，是否打开预览，是否需要部署等
-2. 你首先会阅读当前项目的 README.md，遵照当前项目的说明进行开发，如果不存在则会在生成项目后生成一个 README.md 文件
-3. 开发的时候，默认就在当前目录下产出所有项目代码，先检查当前目录的文件  
-4. 开发预览的时候，如果本身项目有依赖后端数据库集合和云函数，可以优先部署后端然后再预览前端
-5. 交互式反馈规则：在需求不明确时主动与用户对话澄清，优先使用自动化工具 interactiveDialog 完成配置。执行高风险操作前必须使用 interactiveDialog 获得用户确认。保持消息简洁并用emoji标记状态。
-6. 如果涉及到实时通信相关的例如实时对战等，可以使用云开发的实时数据库 watch 能力
-
-## 工作流
-
-<workflow>
-0. 请注意！必须遵守以下的规则，每个环节完成后都需要由我进行确认后才可进行下一个环节；
-1. 如果你判断我的输入提出的是一个新需求，可以按照下面的标准软件工程的方式独立开展工作，需要时才向我询问，可以采用 interactiveDialog 工具来收集
-2. 每当我输入新的需求的时候，为了规范需求质量和验收标准，你首先会搞清楚问题和需求，然后再进入下一阶段
-3. 需求文档和验收标准设计：首先完成需求的设计,按照 EARS 简易需求语法方法来描述，跟我进行确认，最终确认清楚后，需求定稿，然后再进入下一阶段，保存在 `specs/spec_name/requirements.md` 中，参考格式如下
-
-```markdown
-# 需求文档
-
-## 介绍
-
-需求描述
-
-## 需求
-
-### 需求 1 - 需求名称
-
-**用户故事：** 用户故事内容
-
-#### 验收标准
-
-1. 采用 ERAS 描述的子句 While <可选前置条件>, when <可选触发器>, the <系统名称> shall <系统响应>，例如 When 选择"静音"时，笔记本电脑应当抑制所有音频输出。
-2. ...
-...
-```
-4. 技术方案设计： 在完成需求的设计之后，你会根据当前的技术架构和前面确认好的需求，进行需求的技术方案设计，精简但是能够准确的描述技术的架构（例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性），必要时可以用 mermaid 来绘图，跟我确认清楚后，保存在  `specs/spec_name/design.md`  中，然后再进入下一阶段
-5. 任务拆分：在完成技术方案设计后，你会根据需求文档和技术方案，细化具体要做的事情，跟我确认清楚后，，保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段，开始正式执行任务，同时需要及时更新任务的状态，执行的时候尽可能独立自主运行，保证效率和质量
-
-任务参考格式如下
-
-``` markdown
-# 实施计划
-
-- [ ] 1. 任务信息
-  - 具体要做的事情
-  - ...
-  - _需求: 相关的需求点的编号
-
-```
-</workflow>
-
-## 专业领域规则文件
-
-**重要：根据具体的开发场景，AI 必须参考对应的规则文件，避免不同场景的规则互相干扰**
-
-### rules/web-development.mdc
-描述前端+云开发 CloudBase 项目开发的专业规则，包含：
-- Web 项目结构和工程化配置
-- 静态托管部署流程
-- Web SDK 使用和认证方式
-- 适用于纯 Web 项目开发时参考
-
-### rules/miniprogram-development.mdc  
-描述微信小程序开发的专业规则，包含：
-- 小程序项目结构和配置
-- 微信云开发能力集成
-- 小程序特有的 API 和权限处理
-- 适用于微信小程序开发时参考
-
-### rules/cloudbase-platform.mdc
-描述 CloudBase 平台的核心知识，包含：
-- 云开发环境和认证
-- 云函数、数据库、存储等服务
-- 数据模型和权限管理
-- 控制台管理页面链接
-- 适用于所有使用 CloudBase 平台的项目
-
-### rules/workflows.mdc
-描述开发工作流程，包含：
-- 部署流程（云函数、静态托管）
-- 素材下载和知识库查询
-- 文档和配置文件生成规则
-- MCP 接口调用规范
-- 适用于项目开发的各个阶段
-
-### rules/database.mdc
-描述云开发 CloudBase 数据库操作的专业规则，包含：
-- CloudBase 数据库操作注意事项
-- 数据库权限管理
-- 数据更新和错误处理
-- 适用于涉及数据库操作的项目
-
-### rules/ui-design.mdc
-描述web/小程序等页面设计和 UI 规范，包含：
-- 高保真原型设计流程
-- UI 设计规范和工具选择
-- 前端样式处理
-- 适用于需要设计界面的项目
-
-## 使用指导
-- **Web 项目开发**：主要参考 `rules/web-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`
-- **微信小程序开发**：主要参考 `rules/miniprogram-development.mdc` + `rules/cloudbase-platform.mdc` + `rules/workflows.mdc`  
-- **数据库相关**：额外参考 `rules/database.mdc`
-- **UI 设计需求**：额外参考 `rules/ui-design.mdc`
-
-**重要提醒：开发微信小程序时，严禁参考 Web SDK 的认证方式，必须使用小程序专用的 API 和云开发方式！**
-
-
-