@cloudbase/manager-node 5.6.4 → 5.6.6

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## @cloudbase/manager-node v5.6.5 版本发布 🚀(2026-07-28)
+
+- 新增 PostgreSQL 数据库迁移相关 API 与类型定义
+- 新增 统一 SCF/TCBR Agent 日志查询走 CLS searchClsLog
+- 新增 code 入参并完善相关文档与测试
+
+---
+
+## @cloudbase/manager-node v5.6.4 版本发布 🚀(2026-07-23)
+
+- 新增 code 入参并完善相关文档与测试
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
+## @cloudbase/manager-node v5.6.3 版本发布 🚀(2026-07-16)
+
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
 ## @cloudbase/manager-node v5.6.2 版本发布 🚀(2026-07-09)
 
 - 新增 支持镜像部署模式

package/lib/access/index.js

@@ -8,6 +8,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccessService = void 0;
 const utils_1 = require("../utils");
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 class AccessService {
     constructor(environment) {
         this.environment = environment;

package/lib/agent/index.js

@@ -313,10 +313,11 @@ class AgentService {
     // ==================== 日志查询方法 ====================
     /**
      * 获取 Agent 调用日志（自动判断类型）
+     *
+     * SCF / TCBR 均直接走 CLS `searchClsLog`，返回 CLS 原始检索结果 `ISearchClsLogResponse`。
+     * 分页请透传上次返回的 `LogResults.Context` 到入参 `context`。
      * @param params 查询参数
-     * @returns 日志结果，根据 Agent 类型返回不同结构：
-     *   - SCF: IFunctionLogDetailRes[]
-     *   - TCBR: ISearchClsLogResponse
+     * @returns CLS 检索结果 ISearchClsLogResponse
      * @example
      * ```typescript
      * const logs = await agentService.getAgentLogs({
@@ -336,25 +337,18 @@ class AgentService {
         }
         const agentInfo = agentListRes.AgentList[0];
         const agentType = agentInfo.AgentType;
-        // 2. 根据 Agent 类型获取日志
-        if (agentType === 'scf') {
-            const functionService = this.environment.getFunctionService();
-            return functionService.getCompleteFunctionLogs({
-                name: AgentId,
-                offset: params.offset,
-                limit: params.limit,
-                startTime: params.startTime,
-                endTime: params.endTime,
-                requestId: params.requestId
-            });
-        }
-        else if (agentType === 'tcbr') {
+        //    scf / tcbr 均直接走 CLS searchClsLog（getFunctionLogs 系列接口已下线）
+        if (agentType === 'scf' || agentType === 'tcbr') {
             const logService = this.environment.getLogService();
-            const { startTime, endTime, limit = 100, requestId } = params;
+            const { startTime, endTime, limit = 100, requestId, context, sort } = params;
             // 构建查询语句
-            let queryString = `SCF_FunctionName:${AgentId}`;
+            // 采用双引号短语检索保证精确匹配（AgentId/RequestId 含 '-' 会被分词，
+            // 不加引号会因分词命中相似 ID 的其它日志）；并对入参做转义，避免检索语法被注入。
+            // CLS 双引号短语检索下需转义 '"'、'*' 与 '\\'。
+            const escapeClsPhrase = (value) => value.replace(/["*\\]/g, '\\$&');
+            let queryString = `SCF_FunctionName:"${escapeClsPhrase(AgentId)}"`;
             if (requestId) {
-                queryString += ` AND SCF_RequestId:${requestId}`;
+                queryString += ` AND SCF_RequestId:"${escapeClsPhrase(requestId)}"`;
             }
             // 辅助函数：格式化时间
             const formatDateTime = (date) => {
@@ -368,7 +362,9 @@ class AgentService {
                 StartTime: startTime || defaultStartTime,
                 EndTime: endTime || defaultEndTime,
                 queryString: queryString,
-                Limit: limit > 100 ? 100 : limit
+                Limit: limit > 100 ? 100 : limit,
+                Context: context,
+                Sort: sort
             });
         }
         else {

package/lib/cloudApp/index.js

@@ -126,7 +126,7 @@ class CloudAppService {
      * @param params 上传参数
      */
     async uploadCode(params) {
-        const { serviceName, localPath, ignore = [] } = params;
+        const { serviceName, localPath, ignore = [], onPhase } = params;
         // 1. 验证本地路径
         if (!fs_1.default.existsSync(localPath)) {
             throw new error_1.CloudBaseError(`本地路径不存在: ${localPath}`);
@@ -138,20 +138,27 @@ class CloudAppService {
         // 2. 打包本地文件为 ZIP
         const tmpZipPath = path_1.default.join(os_1.default.tmpdir(), `cloudapp-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
         const defaultIgnore = ['node_modules/**', '.git/**', '.DS_Store', '**/.DS_Store'];
+        const packStart = Date.now();
         await (0, utils_1.compressToZip)({
             dirPath: localPath,
             outputPath: tmpZipPath,
             ignore: [...defaultIgnore, ...ignore]
         });
+        const zipSize = fs_1.default.statSync(tmpZipPath).size;
+        onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'pack', durationMs: Date.now() - packStart, bytes: zipSize });
         try {
             // 3. 获取上传凭证
+            const credStart = Date.now();
             const cosInfo = await this.describeCosInfo({
                 deployType: params.deployType,
                 serviceName,
                 suffix: '.zip'
             });
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'credential', durationMs: Date.now() - credStart });
             // 4. 读取 ZIP 文件
+            const readStart = Date.now();
             const zipBuffer = fs_1.default.readFileSync(tmpZipPath);
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'read', durationMs: Date.now() - readStart, bytes: zipBuffer.length });
             // 5. 构建请求头
             const headers = {
                 'Content-Type': 'application/zip'
@@ -162,6 +169,7 @@ class CloudAppService {
                 }
             }
             // 6. 使用预签名 URL 上传
+            const putStart = Date.now();
             const response = await (0, http_request_1.fetchStream)(cosInfo.UploadUrl, {
                 method: 'PUT',
                 body: zipBuffer,
@@ -178,6 +186,7 @@ class CloudAppService {
                 }
                 throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
             }
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'upload', durationMs: Date.now() - putStart, bytes: zipBuffer.length });
             // 7. 返回结果（返回 cosTimestamp，用于创建应用）
             return {
                 cosTimestamp: cosInfo.UnixTimestamp,

package/lib/database/index.js

@@ -329,6 +329,177 @@ class DatabaseService {
         }
         return this.dbOpService.request('ExecutePGSql', params);
     }
+    /**
+     * 预览 PG 用户 migrations 的远端执行计划（不实际执行 SQL）
+     * @param options 预览参数
+     * @returns 预览结果（Pending、Applied、Conflicts、Executable）
+     */
+    async previewPGUserMigrations(options) {
+        var _a;
+        const { EnvId, Migrations, IncludeAll } = options;
+        if (!Array.isArray(Migrations) || Migrations.length === 0) {
+            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+        }
+        for (const migration of Migrations) {
+            if (!/^\d{14}$/.test(migration.Version)) {
+                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+            }
+            if (!/^[a-z_]+$/.test(migration.Name)) {
+                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+            }
+            if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
+                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+            }
+        }
+        return this.dbOpService.request('PreviewPGUserMigrations', Object.assign({ EnvId: EnvId || this.envId, Migrations }, (IncludeAll !== undefined ? { IncludeAll } : {})));
+    }
+    /**
+     * 批量应用 PG 用户 migrations
+     * @param options 批量 migration 参数
+     * @returns 任务信息（TaskId、RequestId）
+     */
+    async pushPGUserMigrations(options) {
+        var _a;
+        const { EnvId, Migrations, LockTimeoutMs, StatementTimeoutMs, IncludeAll } = options;
+        if (!Array.isArray(Migrations) || Migrations.length === 0) {
+            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+        }
+        for (const migration of Migrations) {
+            if (!/^\d{14}$/.test(migration.Version)) {
+                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+            }
+            if (!/^[a-z_]+$/.test(migration.Name)) {
+                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+            }
+            if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
+                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+            }
+        }
+        if (LockTimeoutMs !== undefined && LockTimeoutMs < 0) {
+            throw new error_1.CloudBaseError('LockTimeoutMs 不能小于 0');
+        }
+        if (StatementTimeoutMs !== undefined && StatementTimeoutMs < 0) {
+            throw new error_1.CloudBaseError('StatementTimeoutMs 不能小于 0');
+        }
+        return this.dbOpService.request('PushPGUserMigrations', Object.assign(Object.assign(Object.assign({ EnvId: EnvId || this.envId, Migrations }, (LockTimeoutMs !== undefined ? { LockTimeoutMs } : {})), (StatementTimeoutMs !== undefined ? { StatementTimeoutMs } : {})), (IncludeAll !== undefined ? { IncludeAll } : {})));
+    }
+    /**
+     * 修复 PG 用户 migration history，仅维护 user_schema_migrations 记录，不执行 SQL
+     * @param options 修复参数
+     * @returns RequestId
+     */
+    async repairPGUserMigrationHistory(options) {
+        const { EnvId, MigrationVersion, Name, Status, Reason, Query } = options;
+        if (!/^\d{14}$/.test(MigrationVersion)) {
+            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+        }
+        if (!/^[a-z_]+$/.test(Name)) {
+            throw new error_1.CloudBaseError('Name 只允许小写字母和下划线');
+        }
+        if (Status !== 'applied' && Status !== 'reverted') {
+            throw new error_1.CloudBaseError('Status 只允许 applied 或 reverted');
+        }
+        if (!(Reason === null || Reason === void 0 ? void 0 : Reason.trim())) {
+            throw new error_1.CloudBaseError('Reason 不能为空');
+        }
+        if (Status === 'applied' && !(Query === null || Query === void 0 ? void 0 : Query.trim())) {
+            throw new error_1.CloudBaseError('Status=applied 时 Query 不能为空');
+        }
+        const params = {
+            EnvId: EnvId || this.envId,
+            MigrationVersion,
+            Name,
+            Status,
+            Reason
+        };
+        if (Status === 'applied') {
+            params.Query = Query;
+        }
+        return this.dbOpService.request('RepairPGUserMigrationHistory', params);
+    }
+    /**
+     * 查询目标环境已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、Limit、Offset）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    async listPGUserMigrations(options = {}) {
+        const { EnvId, Limit, Offset } = options;
+        if (Limit !== undefined && (Limit < 1 || Limit > 500)) {
+            throw new error_1.CloudBaseError('Limit 取值范围为 [1, 500]');
+        }
+        if (Offset !== undefined && Offset < 0) {
+            throw new error_1.CloudBaseError('Offset 不能小于 0');
+        }
+        return this.dbOpService.request('ListPGUserMigrations', Object.assign(Object.assign({ EnvId: EnvId || this.envId }, (Limit !== undefined ? { Limit } : {})), (Offset !== undefined ? { Offset } : {})));
+    }
+    /**
+     * 查询目标环境全部已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、PageSize）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    async listAllPGUserMigrations(options = {}) {
+        const { EnvId, PageSize = 500 } = options;
+        if (PageSize < 1 || PageSize > 500) {
+            throw new error_1.CloudBaseError('PageSize 取值范围为 [1, 500]');
+        }
+        const migrations = [];
+        let offset = 0;
+        let latestVersion = '';
+        let total = 0;
+        let requestId = '';
+        while (true) {
+            const page = await this.listPGUserMigrations({
+                EnvId,
+                Limit: PageSize,
+                Offset: offset
+            });
+            const pageMigrations = page.Migrations || [];
+            migrations.push(...pageMigrations);
+            latestVersion = page.LatestVersion || latestVersion;
+            total += pageMigrations.length;
+            requestId = page.RequestId || requestId;
+            if (pageMigrations.length < PageSize) {
+                break;
+            }
+            offset += PageSize;
+        }
+        return {
+            Total: total,
+            LatestVersion: latestVersion,
+            Migrations: migrations,
+            RequestId: requestId
+        };
+    }
+    /**
+     * 查询目标环境指定 migration 详情
+     * @param options 查询参数（EnvId 可选、MigrationVersion 必填）
+     * @returns migration 详情（Version、Name、Query）
+     */
+    async describePGUserMigration(options) {
+        const { EnvId, MigrationVersion } = options;
+        if (!/^\d{14}$/.test(MigrationVersion)) {
+            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+        }
+        return this.dbOpService.request('DescribePGUserMigration', {
+            EnvId: EnvId || this.envId,
+            MigrationVersion
+        });
+    }
+    /**
+     * 查询任务结果
+     * @param options 查询参数（EnvId 可选、TaskId 必填）
+     * @returns 任务状态详情（TaskType、Status、Phase、Reason 等）
+     */
+    async describeTaskResult(options) {
+        const { EnvId, TaskId } = options;
+        if (!(TaskId === null || TaskId === void 0 ? void 0 : TaskId.trim())) {
+            throw new error_1.CloudBaseError('TaskId 不能为空');
+        }
+        return this.dbOpService.request('DescribeTaskResult', {
+            EnvId: EnvId || this.envId,
+            TaskId
+        });
+    }
 }
 exports.DatabaseService = DatabaseService;
 DatabaseService.tcbServiceVersion = {
@@ -372,3 +543,24 @@ __decorate([
 __decorate([
     preLazy()
 ], DatabaseService.prototype, "executePGSql", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "previewPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "pushPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "repairPGUserMigrationHistory", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "listPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "listAllPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "describePGUserMigration", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "describeTaskResult", null);

package/lib/database/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/function/index.js

@@ -623,48 +623,27 @@ class FunctionService {
         return data;
     }
     /**
-     * 获取函数日志
-     * @deprecated 请使用 getFunctionLogsV2 代替
-     * @param {{
-    *         name: string
-    *         offset: number
-    *         limit: number
-    *         order: string
-    *         orderBy: string
-    *         startTime: string
-    *         endTime: string
-    *         requestId: string
-    *     }} options
-    * @returns {Promise<IFunctionLogRes>}
-    */
-    async getFunctionLogs(options) {
-        let { name, offset = 0, limit = 10, order, orderBy, startTime, endTime, requestId } = options;
-        const { namespace } = this.getFunctionConfig();
-        if (startTime && !endTime) {
-            // 自动补 endTime 为 startTime + 1d
-            endTime = (0, utils_1.formatTimeByMs)(new Date(startTime).getTime() + 24 * 3600 * 1000);
-        }
-        if (endTime && !startTime) {
-            // 自动补 startTime 为 endTime - 1d
-            startTime = (0, utils_1.formatTimeByMs)(new Date(endTime).getTime() - 24 * 3600 * 1000);
-        }
-        const params = {
-            Namespace: namespace,
-            FunctionName: name,
-            Offset: offset,
-            Limit: limit,
-            Order: order,
-            OrderBy: orderBy,
-            StartTime: startTime,
-            EndTime: endTime,
-            FunctionRequestId: requestId
-        };
-        const res = await this.scfService.request('GetFunctionLogs', params);
-        return res;
+ * 获取函数日志
+ * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+ * @param {{
+ *         name: string
+ *         offset: number
+ *         limit: number
+ *         order: string
+ *         orderBy: string
+ *         startTime: string
+ *         endTime: string
+ *         requestId: string
+ *     }} options
+ * @returns {Promise<IFunctionLogRes>}
+ */
+    async getFunctionLogs(_options) {
+        throw new error_1.CloudBaseError('getFunctionLogs 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
- * 获取函数日志 ID 列表
- * @param {{
+    * 获取函数日志 ID 列表
+    * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+    * @param {{
     *         name: string
     *         offset: number
     *         limit: number
@@ -675,28 +654,12 @@ class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogResV2>}
     */
-    async getFunctionLogsV2(options) {
-        let { name, offset = 0, limit = 10, startTime, endTime, requestId, qualifier } = options;
-        const { env } = this.getFunctionConfig();
-        ({ startTime, endTime } = (0, utils_1.getCompleteTimeRange)({
-            startTime,
-            endTime
-        }));
-        const params = {
-            EnvId: env,
-            FunctionName: name,
-            Offset: offset,
-            Limit: limit,
-            StartTime: startTime,
-            EndTime: endTime,
-            LogRequestId: requestId,
-            Qualifier: qualifier || "$LATEST" // 云函数版本，不传则用 $LATEST
-        };
-        const res = await this.tcbService.request('GetFunctionLogs', params);
-        return res;
+    async getFunctionLogsV2(_options) {
+        throw new error_1.CloudBaseError('getFunctionLogsV2 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
  * 根据函数日志 ID 查询日志详情
+ * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
  * @param {{
     *         startTime: string
     *         endTime: string
@@ -704,46 +667,18 @@ class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogDetailRes>}
     */
-    async getFunctionLogDetail(options) {
-        let { logRequestId, startTime, endTime } = options;
-        ({ startTime, endTime } = (0, utils_1.getCompleteTimeRange)({
-            startTime,
-            endTime
-        }));
-        const params = {
-            StartTime: startTime,
-            LogRequestId: logRequestId,
-            EndTime: endTime
-        };
-        const res = await this.tcbService.request('GetFunctionLogDetail', params);
-        return res;
+    async getFunctionLogDetail(_options) {
+        throw new error_1.CloudBaseError('getFunctionLogDetail 已废弃：底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 获取函数的完整调用日志
      * 该方法会自动完成两步操作：1. 获取日志请求ID列表。 2. 根据ID列表获取每条日志的详细内容。
+     * @deprecated 底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
      * @param {IFunctionLogOptionsV2} options - 查询选项
      * @returns {Promise<IFunctionLogDetailRes[]>} 返回包含完整日志详情的数组
      */
-    async getCompleteFunctionLogs(options) {
-        // 调用 getFunctionLogsV2 获取日志请求ID列表
-        const { name } = options;
-        const logs = await this.getFunctionLogsV2(options);
-        // 如果没有日志，直接返回空数组
-        if (logs.LogList.length === 0) {
-            return [];
-        }
-        const detailPromises = logs.LogList.map(async (log) => {
-            // 对每一个日志ID，调用 getFunctionLogDetail
-            const res = await this.getFunctionLogDetail({
-                logRequestId: log.RequestId,
-                startTime: options.startTime,
-                endTime: options.endTime
-            });
-            return Object.assign(Object.assign({}, res), { RetCode: log.RetCode, FunctionName: name });
-        });
-        // 并发执行所有详情查询，等待它们全部完成
-        const detailedLogs = await Promise.all(detailPromises);
-        return detailedLogs;
+    async getCompleteFunctionLogs(_options) {
+        throw new error_1.CloudBaseError('getCompleteFunctionLogs 已废弃：底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 更新云函数配置

package/lib/index.js

@@ -64,6 +64,10 @@ class CloudBase {
     get hosting() {
         return this.currentEnvironment().getHostingService();
     }
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access() {
         return this.currentEnvironment().getAccessService();
     }

package/package.json

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

package/types/access/index.d.ts

@@ -1,6 +1,11 @@
 import { Environment } from '../environment';
 import { ICreateAccessOptions, IApi, IUpdateOptions, IService, IDeleteOptions, IGetOptions, IDomainOptions } from './types';
 import { IResponseInfo } from '../interfaces';
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 export declare class AccessService {
     private tcbService;
     private environment;

package/types/agent/index.d.ts

@@ -1,5 +1,6 @@
 import { Environment } from '../environment';
 import { ICreateFunctionAgentParams, ICreateAgentParams, ICreateTcbrAgentByImageParams, ICreateTcbrAgentByPackageParams, ICreateTcbrAgentByCodeParams, IDescribeAgentListParams, IDescribeAgentListResponse, IDescribeAgentResponse, IDeleteAgentParams, IDescribeCloudBaseBuildServiceParams, IDescribeCloudBaseBuildServiceResponse, ICreateAgentResponse, IDeleteAgentResponse, ICommonResponse, IUpdateAgentParams, IUpdateScfAgentParams, IUpdateScfAgentResponse, IUpdateTcbrAgentParams, IGetAgentLogsParams } from './type';
+import { ISearchClsLogResponse } from '../log';
 /**
  * Agent 管理类
  * 支持三种部署方式：
@@ -64,10 +65,11 @@ export declare class AgentService {
     updateScfAgent(params: IUpdateScfAgentParams): Promise<IUpdateScfAgentResponse>;
     /**
      * 获取 Agent 调用日志（自动判断类型）
+     *
+     * SCF / TCBR 均直接走 CLS `searchClsLog`，返回 CLS 原始检索结果 `ISearchClsLogResponse`。
+     * 分页请透传上次返回的 `LogResults.Context` 到入参 `context`。
      * @param params 查询参数
-     * @returns 日志结果，根据 Agent 类型返回不同结构：
-     *   - SCF: IFunctionLogDetailRes[]
-     *   - TCBR: ISearchClsLogResponse
+     * @returns CLS 检索结果 ISearchClsLogResponse
      * @example
      * ```typescript
      * const logs = await agentService.getAgentLogs({
@@ -78,7 +80,7 @@ export declare class AgentService {
      * })
      * ```
      */
-    getAgentLogs(params: IGetAgentLogsParams): Promise<any>;
+    getAgentLogs(params: IGetAgentLogsParams): Promise<ISearchClsLogResponse>;
     /**
      * 通过镜像创建 TCBR Agent
      * @internal 暂不对外暴露，后续版本开放

package/types/agent/type.d.ts

@@ -372,16 +372,18 @@ export interface IDeleteAgentResponse {
 export interface IGetAgentLogsParams {
     /** Agent ID */
     AgentId: string;
-    /** 偏移量，默认 0 */
-    offset?: number;
-    /** 返回数量，默认 10 */
+    /** 单次返回条数，默认 100，最大 100 */
     limit?: number;
-    /** 开始时间，如 "2024-01-01 00:00:00" */
+    /** 开始时间，如 "2024-01-01 00:00:00"，默认最近 1 小时 */
     startTime?: string;
-    /** 结束时间，如 "2024-01-01 23:59:59" */
+    /** 结束时间，如 "2024-01-01 23:59:59"，默认当前时间 */
     endTime?: string;
-    /** 按 RequestId 筛选（仅 SCF Agent） */
+    /** 按 RequestId 筛选 */
     requestId?: string;
+    /** 分页游标，透传上次返回的 LogResults.Context 获取下一页 */
+    context?: string;
+    /** 按时间排序：'asc' 升序 / 'desc' 降序（默认 desc） */
+    sort?: 'asc' | 'desc';
 }
 /**
  * @deprecated 请使用 ICreateTcbrAgentByCodeParams

package/types/cloudApp/types.d.ts

@@ -299,6 +299,21 @@ export interface IProgressData {
     total: number;
     percent: number;
 }
+/**
+ * 代码上传的分步阶段
+ */
+export type UploadPhase = 'pack' | 'credential' | 'read' | 'upload';
+/**
+ * 单个阶段计时信息（由 uploadCode 的 onPhase 回调触发）
+ */
+export interface IUploadPhaseTiming {
+    /** 阶段名 */
+    phase: UploadPhase;
+    /** 耗时(ms) */
+    durationMs: number;
+    /** 字节数（pack: zip 大小; read/upload: buffer 大小） */
+    bytes?: number;
+}
 /**
  * 上传代码参数
  */
@@ -313,6 +328,8 @@ export interface IUploadCloudAppCodeParams {
     ignore?: string[];
     /** 进度回调 */
     onProgress?: (progress: IProgressData) => void;
+    /** 分步计时回调（各阶段完成时触发，用于 verbose 模式输出耗时） */
+    onPhase?: (timing: IUploadPhaseTiming) => void;
 }
 /**
  * 上传代码结果

package/types/database/index.d.ts

@@ -1,5 +1,6 @@
 import { IServiceVersion, IExistsRes, CreateIndex, DropIndex, IndexInfo, TableInfo, Pager, IResponseInfo, CollectionDispension } from '../interfaces/';
 import { Environment } from '../environment';
+import { IDescribePGUserMigrationOptions, IDescribePGUserMigrationResult, IDescribeTaskResultOptions, IDescribeTaskResultResult, IListAllPGUserMigrationsOptions, IListPGUserMigrationsOptions, IListPGUserMigrationsResult, IPreviewPGUserMigrationsOptions, IPreviewPGUserMigrationsResult, IPushPGUserMigrationsOptions, IPushPGUserMigrationsResult, IRepairPGUserMigrationHistoryOptions } from './type';
 interface IDatabaseConfig {
     Tag: string;
 }
@@ -226,5 +227,47 @@ export declare class DatabaseService {
      * console.log(res.Rows)    // ['["1","Alice"]']
      */
     executePGSql(options: IExecutePGSqlOptions): Promise<IExecutePGSqlResult>;
+    /**
+     * 预览 PG 用户 migrations 的远端执行计划（不实际执行 SQL）
+     * @param options 预览参数
+     * @returns 预览结果（Pending、Applied、Conflicts、Executable）
+     */
+    previewPGUserMigrations(options: IPreviewPGUserMigrationsOptions): Promise<IPreviewPGUserMigrationsResult>;
+    /**
+     * 批量应用 PG 用户 migrations
+     * @param options 批量 migration 参数
+     * @returns 任务信息（TaskId、RequestId）
+     */
+    pushPGUserMigrations(options: IPushPGUserMigrationsOptions): Promise<IPushPGUserMigrationsResult>;
+    /**
+     * 修复 PG 用户 migration history，仅维护 user_schema_migrations 记录，不执行 SQL
+     * @param options 修复参数
+     * @returns RequestId
+     */
+    repairPGUserMigrationHistory(options: IRepairPGUserMigrationHistoryOptions): Promise<IResponseInfo>;
+    /**
+     * 查询目标环境已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、Limit、Offset）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    listPGUserMigrations(options?: IListPGUserMigrationsOptions): Promise<IListPGUserMigrationsResult>;
+    /**
+     * 查询目标环境全部已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、PageSize）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    listAllPGUserMigrations(options?: IListAllPGUserMigrationsOptions): Promise<IListPGUserMigrationsResult>;
+    /**
+     * 查询目标环境指定 migration 详情
+     * @param options 查询参数（EnvId 可选、MigrationVersion 必填）
+     * @returns migration 详情（Version、Name、Query）
+     */
+    describePGUserMigration(options: IDescribePGUserMigrationOptions): Promise<IDescribePGUserMigrationResult>;
+    /**
+     * 查询任务结果
+     * @param options 查询参数（EnvId 可选、TaskId 必填）
+     * @returns 任务状态详情（TaskType、Status、Phase、Reason 等）
+     */
+    describeTaskResult(options: IDescribeTaskResultOptions): Promise<IDescribeTaskResultResult>;
 }
 export {};

package/types/database/type.d.ts

@@ -0,0 +1,212 @@
+/**
+ * PushPGUserMigrations 的单条 migration 输入
+ */
+export interface IPGUserMigrationInput {
+    /** migration 版本，14 位数字时间串，如 20260526000000 */
+    Version: string;
+    /** migration 名称，仅允许小写字母和下划线 */
+    Name: string;
+    /** 要执行的 SQL */
+    Query: string;
+    /** 回滚 SQL（可选） */
+    Rollback?: string;
+}
+/**
+ * 批量应用 PG 用户 migrations 请求参数
+ */
+export interface IPushPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 列表（至少 1 条） */
+    Migrations: IPGUserMigrationInput[];
+    /** 获取数据库锁最长等待时间（毫秒） */
+    LockTimeoutMs?: number;
+    /** 单条 SQL 最长执行时间（毫秒） */
+    StatementTimeoutMs?: number;
+    /** 是否允许 out-of-order local migrations */
+    IncludeAll?: boolean;
+}
+/**
+ * 批量应用 PG 用户 migrations 返回参数
+ */
+export interface IPushPGUserMigrationsResult {
+    /** 请求唯一 ID */
+    RequestId: string;
+    /** 异步任务 ID，可用于查询任务进度 */
+    TaskId: string;
+}
+/**
+ * 预览 PG 用户 migrations 请求参数
+ */
+export interface IPreviewPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 列表（至少 1 条） */
+    Migrations: IPGUserMigrationInput[];
+    /** 是否允许 out-of-order local migrations */
+    IncludeAll?: boolean;
+}
+/**
+ * migration 计划项
+ */
+export interface IPGUserMigrationPlanItem {
+    /** migration 版本 */
+    Version: string;
+    /** migration 名称 */
+    Name: string;
+    /** 当前状态（例如 applied / pending） */
+    Status?: string;
+    /** 状态原因（例如 checksum_matched） */
+    Reason?: string;
+    /** migration 内容校验和 */
+    Checksum?: string;
+    /** 来源标记（响应字段，服务端可能返回） */
+    Source?: string;
+}
+/**
+ * migration 冲突项
+ */
+export interface IPGUserMigrationConflict {
+    /** 发生冲突的 migration 版本 */
+    Version: string;
+    /** 本地 migration 名称 */
+    Name?: string;
+    /** 远端（数据库已应用）migration 名称 */
+    RemoteName?: string;
+    /** 本次 SQL 计算出来的 checksum */
+    LocalChecksum?: string;
+    /** 数据库中已应用 migration 的 checksum */
+    RemoteChecksum?: string;
+    /** 冲突原因（如 checksum_mismatch） */
+    Reason?: string;
+    /** 冲突详情信息 */
+    Message?: string;
+    /** 兼容服务端未来扩展字段 */
+    [key: string]: any;
+}
+/**
+ * 预览 PG 用户 migrations 返回参数
+ */
+export interface IPreviewPGUserMigrationsResult {
+    /** 将要执行的 migration 列表 */
+    Pending: IPGUserMigrationPlanItem[] | null;
+    /** 已经应用过的 migration 列表 */
+    Applied: IPGUserMigrationPlanItem[] | null;
+    /** checksum 冲突列表 */
+    Conflicts: IPGUserMigrationConflict[] | null;
+    /** 是否可直接执行（当前主要表示无 checksum 冲突） */
+    Executable: boolean;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 已应用的 PG 用户 migration 摘要项
+ */
+export interface IPGUserMigrationSummary {
+    /** migration 版本号，14 位数字时间串（如 20260526000000） */
+    Version: string;
+    /** migration 名称 */
+    Name: string;
+}
+/**
+ * 查询已应用 PG 用户 migrations 请求参数
+ */
+export interface IListPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 查询条数，取值范围 [1, 500]，默认 100 */
+    Limit?: number;
+    /** 分页偏移，默认 0 */
+    Offset?: number;
+}
+/**
+ * 查询全部已应用 PG 用户 migrations 请求参数
+ */
+export interface IListAllPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 内部翻页每页大小，取值范围 [1, 500]，默认 500 */
+    PageSize?: number;
+}
+/**
+ * 查询已应用 PG 用户 migrations 返回参数
+ */
+export interface IListPGUserMigrationsResult {
+    /** 总数量 */
+    Total: number;
+    /** 已应用的最新版本号，14 位数字时间串 */
+    LatestVersion: string;
+    /** 已应用 migration 列表 */
+    Migrations: IPGUserMigrationSummary[];
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 查询单条 PG 用户 migration 详情请求参数
+ */
+export interface IDescribePGUserMigrationOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 版本号，14 位数字时间串（如 20260526000000） */
+    MigrationVersion: string;
+}
+/**
+ * 查询单条 PG 用户 migration 详情返回参数
+ */
+export interface IDescribePGUserMigrationResult {
+    /** migration 版本号，14 位数字时间串 */
+    Version: string;
+    /** migration 名称（仅小写字母和下划线） */
+    Name: string;
+    /** migration SQL */
+    Query: string;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 查询任务结果请求参数
+ */
+export interface IDescribeTaskResultOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 任务 ID */
+    TaskId: string;
+}
+/**
+ * 查询任务结果返回参数
+ */
+export interface IDescribeTaskResultResult {
+    /** 任务 ID */
+    TaskId: string;
+    /** 任务类型（如 PGUserMigration） */
+    TaskType: string;
+    /** 任务状态：Failed / Succeed / Accepted / Running */
+    Status: 'Failed' | 'Succeed' | 'Accepted' | 'Running' | string;
+    /** 当前步骤 */
+    Phase: string;
+    /** 失败原因（成功时可能为空） */
+    Reason: string;
+    /** 创建时间（ISO 8601） */
+    CreatedAt: string;
+    /** 最后更新时间（ISO 8601） */
+    UpdatedAt: string;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 修复 PG 用户 migration history 请求参数
+ */
+export interface IRepairPGUserMigrationHistoryOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 版本，14 位数字时间串，如 20260526000000 */
+    MigrationVersion: string;
+    /** migration 版本名，仅允许小写字母和下划线 */
+    Name: string;
+    /** 修复状态：applied（写入 history）或 reverted（删除 history） */
+    Status: 'applied' | 'reverted';
+    /** 修复原因 */
+    Reason: string;
+    /** applied 时建议传入对应 SQL，reverted 时可不传 */
+    Query?: string;
+}

package/types/function/index.d.ts

@@ -311,24 +311,25 @@ export declare class FunctionService {
         codeSecret: any;
     }): Promise<IFunctionInfo[]>;
     /**
-     * 获取函数日志
-     * @deprecated 请使用 getFunctionLogsV2 代替
-     * @param {{
-    *         name: string
-    *         offset: number
-    *         limit: number
-    *         order: string
-    *         orderBy: string
-    *         startTime: string
-    *         endTime: string
-    *         requestId: string
-    *     }} options
-    * @returns {Promise<IFunctionLogRes>}
-    */
-    getFunctionLogs(options: IFunctionLogOptions): Promise<IFunctionLogRes>;
-    /**
- * 获取函数日志 ID 列表
+ * 获取函数日志
+ * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
  * @param {{
+ *         name: string
+ *         offset: number
+ *         limit: number
+ *         order: string
+ *         orderBy: string
+ *         startTime: string
+ *         endTime: string
+ *         requestId: string
+ *     }} options
+ * @returns {Promise<IFunctionLogRes>}
+ */
+    getFunctionLogs(_options: IFunctionLogOptions): Promise<IFunctionLogRes>;
+    /**
+    * 获取函数日志 ID 列表
+    * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+    * @param {{
     *         name: string
     *         offset: number
     *         limit: number
@@ -339,9 +340,10 @@ export declare class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogResV2>}
     */
-    getFunctionLogsV2(options: IFunctionLogOptionsV2): Promise<IFunctionLogResV2>;
+    getFunctionLogsV2(_options: IFunctionLogOptionsV2): Promise<IFunctionLogResV2>;
     /**
  * 根据函数日志 ID 查询日志详情
+ * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
  * @param {{
     *         startTime: string
     *         endTime: string
@@ -349,14 +351,15 @@ export declare class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogDetailRes>}
     */
-    getFunctionLogDetail(options: IFunctionLogDetailOptions): Promise<IFunctionLogDetailRes>;
+    getFunctionLogDetail(_options: IFunctionLogDetailOptions): Promise<IFunctionLogDetailRes>;
     /**
      * 获取函数的完整调用日志
      * 该方法会自动完成两步操作：1. 获取日志请求ID列表。 2. 根据ID列表获取每条日志的详细内容。
+     * @deprecated 底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
      * @param {IFunctionLogOptionsV2} options - 查询选项
      * @returns {Promise<IFunctionLogDetailRes[]>} 返回包含完整日志详情的数组
      */
-    getCompleteFunctionLogs(options: IFunctionLogOptionsV2): Promise<IFunctionLogDetailRes[]>;
+    getCompleteFunctionLogs(_options: IFunctionLogOptionsV2): Promise<IFunctionLogDetailRes[]>;
     /**
      * 更新云函数配置
      * @param {ICloudFunction} func 云函数配置

package/types/index.d.ts

@@ -56,6 +56,10 @@ declare class CloudBase {
     get storage(): StorageService;
     get database(): DatabaseService;
     get hosting(): HostingService;
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access(): AccessService;
     get mysql(): MysqlService;
     /**