@cloudbase/manager-node 5.4.0-beta.2 → 5.5.0

package/lib/env/index.js

@@ -136,18 +136,33 @@ class EnvService {
      * @returns {Promise<IEnvInfoRes>}
      */
     async getEnvInfo() {
-        // NOTE: DescribeEnv 接口废弃，需要使用 DescribeEnvs 接口
+        var _a;
+        // 使用 DescribeEnvInfo 进行单环境查询
         const params = {
             EnvId: this.envId
         };
-        if (this.envType === 'run') {
-            params.EnvType = 'run';
-        }
-        const { EnvList, RequestId } = await this.describeEnvs(params);
+        const response = await this.describeEnvInfo(params);
+        const envBaseInfo = (_a = response === null || response === void 0 ? void 0 : response.EnvInfo) === null || _a === void 0 ? void 0 : _a.EnvBaseInfo;
+        // 成功获取环境信息，将 EnvBaseInfo 映射到 EnvInfo 类型
+        const envInfo = {
+            EnvId: envBaseInfo.EnvId,
+            Alias: envBaseInfo.Alias,
+            Status: envBaseInfo.Status,
+            Databases: envBaseInfo.Databases,
+            Storages: envBaseInfo.Storages,
+            Functions: envBaseInfo.Functions,
+            PackageId: envBaseInfo.PackageId || '',
+            PackageName: envBaseInfo.PackageName || '',
+            LogServices: envBaseInfo.LogServices || [],
+            CustomLogServices: envBaseInfo.CustomLogServices || [],
+            Region: envBaseInfo.Region || '',
+            Source: envBaseInfo.Source,
+            CreateTime: envBaseInfo.CreateTime,
+            UpdateTime: envBaseInfo.UpdateTime
+        };
         return {
-            // @ts-ignore
-            EnvInfo: (EnvList === null || EnvList === void 0 ? void 0 : EnvList.length) ? EnvList[0] : {},
-            RequestId
+            EnvInfo: envInfo,
+            RequestId: response.RequestId || ''
         };
     }
     /**
@@ -156,6 +171,18 @@ class EnvService {
     async describeEnvs(params) {
         return this.cloudService.request('DescribeEnvs', params);
     }
+    /**
+     * 查询单个环境信息
+     *
+     * 用于单个环境查询时，规避 DescribeEnvs 的 backend issues。
+     * 当 EnvId 参数存在时，应优先使用本方法而非 describeEnvs。
+     *
+     * @param params 查询参数，必须包含 EnvId
+     * @returns 环境信息响应
+     */
+    async describeEnvInfo(params) {
+        return this.cloudService.request('DescribeEnvInfo', params);
+    }
     /**
      * 修改环境名称
      * @param {string} alias 环境名称
@@ -476,28 +503,28 @@ class EnvService {
     async calculatePackageRenewPrice(params) {
         var _a, _b, _c, _d, _e, _f;
         const { envId, period = 1, currency = 'CNY' } = params;
-        const [packageRes, envRes, billingRes] = await Promise.all([
+        const [packageRes, envInfoRes, billingRes] = await Promise.all([
             this.describeBaasPackageList({
                 Source: 'qcloud',
                 PackageTypeList: ['default', 'vip', 'basic', 'trial']
             }),
-            this.describeEnvs({
+            this.describeEnvInfo({
                 EnvId: envId
             }),
             this.describeBillingInfo({
                 EnvId: envId
             })
         ]);
-        const envInfo = (_a = envRes.EnvList) === null || _a === void 0 ? void 0 : _a[0];
+        const envBaseInfo = (_a = envInfoRes === null || envInfoRes === void 0 ? void 0 : envInfoRes.EnvInfo) === null || _a === void 0 ? void 0 : _a.EnvBaseInfo;
         const billingInfo = (_b = billingRes.EnvBillingInfoList) === null || _b === void 0 ? void 0 : _b[0];
-        if (!envInfo || !billingInfo) {
+        if (!(envBaseInfo === null || envBaseInfo === void 0 ? void 0 : envBaseInfo.EnvId) || !billingInfo) {
             throw new error_1.CloudBaseError(`Invalid env id: ${envId}`);
         }
-        const packageInfo = (_c = packageRes.PackageList) === null || _c === void 0 ? void 0 : _c.find(item => item.PackageName === envInfo.PackageId);
+        const packageInfo = (_c = packageRes.PackageList) === null || _c === void 0 ? void 0 : _c.find(item => item.PackageName === envBaseInfo.PackageId);
         if (!packageInfo) {
             throw new error_1.CloudBaseError(`Invalid env id: ${envId}`);
         }
-        const region = envInfo.Region;
+        const region = envBaseInfo.Region;
         const extPackageData = ((_d = billingInfo.ExtPackageCode) === null || _d === void 0 ? void 0 : _d.reduce((acc, { Code, Num }) => {
             acc[Code] = Num;
             return acc;
@@ -530,21 +557,21 @@ class EnvService {
     async calculatePackageModifyPrice(params) {
         var _a, _b, _c, _d, _e, _f, _g;
         const { newPackageId, envId, currency = 'CNY' } = params;
-        const [packageRes, envRes, billingRes] = await Promise.all([
+        const [packageRes, envInfoRes, billingRes] = await Promise.all([
             this.describeBaasPackageList({
                 Source: 'qcloud',
                 PackageTypeList: ['default', 'vip', 'basic', 'trial']
             }),
-            this.describeEnvs({
+            this.describeEnvInfo({
                 EnvId: envId
             }),
             this.describeBillingInfo({
                 EnvId: envId
             })
         ]);
-        const envInfo = (_a = envRes.EnvList) === null || _a === void 0 ? void 0 : _a[0];
+        const envBaseInfo = (_a = envInfoRes === null || envInfoRes === void 0 ? void 0 : envInfoRes.EnvInfo) === null || _a === void 0 ? void 0 : _a.EnvBaseInfo;
         const billingInfo = (_b = billingRes.EnvBillingInfoList) === null || _b === void 0 ? void 0 : _b[0];
-        if (!envInfo || !billingInfo || !billingInfo.PackageId) {
+        if (!(envBaseInfo === null || envBaseInfo === void 0 ? void 0 : envBaseInfo.EnvId) || !billingInfo || !billingInfo.PackageId) {
             throw new error_1.CloudBaseError(`Invalid env id: ${envId}`);
         }
         const oldPackageInfo = (_c = packageRes.PackageList) === null || _c === void 0 ? void 0 : _c.find(item => item.PackageName === billingInfo.PackageId);
@@ -555,7 +582,7 @@ class EnvService {
         if (!newPackageInfo) {
             throw new error_1.CloudBaseError(`Invalid package id: ${newPackageId}`);
         }
-        const region = envInfo.Region;
+        const region = envBaseInfo.Region;
         const newBillTags = this.parseBillTags(newPackageInfo.BillTags);
         const oldBillTags = this.parseBillTags(oldPackageInfo.BillTags);
         let userNumber = 0;

package/lib/function/index.js

@@ -342,39 +342,57 @@ class FunctionService {
             return res;
         }
         catch (e) {
-            // 函数存在
+            // 函数已存在（同名冲突）
             const functionExist = e.code === 'ResourceInUse.FunctionName' || e.code === 'ResourceInUse.Function';
-            // 已存在同名函数，强制更新
-            if (functionExist && force) {
-                // 1. 更新函数代码（通过 deployMode 区分镜像部署和代码部署）
-                const codeRes = await this.updateFunctionCode({
-                    func,
-                    base64Code,
-                    functionPath,
-                    functionRootPath,
-                    codeSecret: codeSecret,
-                    deployMode: isImageDeploy ? 'image' : undefined
-                });
-                // 等待函数状态正常
-                await this.waitFunctionActive(funcName, codeSecret);
-                // 2. 更新函数配置
-                const configRes = await this.updateFunctionConfig(func);
-                // 等待函数状态正常
-                await this.waitFunctionActive(funcName, codeSecret);
-                // 3. 创建函数触发器
-                const triggerRes = await this.retryCreateTrigger(funcName, func.triggers);
-                // 设置路径，创建云接入路径
-                if (func.path) {
-                    await this.createAccessPath(funcName, func.path);
+            if (functionExist) {
+                // 检查同名函数是否是 CREATE_FAILED 残留
+                // 场景：上次部署因依赖安装失败留下了残留函数，用户修正参数后重新部署（不传 force）
+                // 此时应自动清理残留并重新创建，而不是报错要求用户手动删除或传 force
+                try {
+                    const { Status } = await this.getFunctionDetail(funcName, codeSecret);
+                    if (Status === constant_1.SCF_STATUS.CREATE_FAILED) {
+                        console.warn(`[${funcName}] 检测到同名函数处于 CREATE_FAILED 状态，自动清理后重新创建...`);
+                        await this.deleteFunction(funcName);
+                        // 重新执行创建（递归调用，此时同名函数已删除，不会再碰到 ResourceInUse）
+                        return this.createFunction(funcParam);
+                    }
+                }
+                catch (checkErr) {
+                    // 查询或删除失败，继续走原有逻辑（force 判断）
+                    console.warn(`[${funcName}] 检查残留状态失败（可忽略）: ${checkErr.message}`);
+                }
+                // 已存在且状态正常，强制覆盖更新
+                if (force) {
+                    // 1. 更新函数代码（通过 deployMode 区分镜像部署和代码部署）
+                    const codeRes = await this.updateFunctionCode({
+                        func,
+                        base64Code,
+                        functionPath,
+                        functionRootPath,
+                        codeSecret: codeSecret,
+                        deployMode: isImageDeploy ? 'image' : undefined
+                    });
+                    // 等待函数状态正常
+                    await this.waitFunctionActive(funcName, codeSecret);
+                    // 2. 更新函数配置
+                    const configRes = await this.updateFunctionConfig(func);
+                    // 等待函数状态正常
+                    await this.waitFunctionActive(funcName, codeSecret);
+                    // 3. 创建函数触发器
+                    const triggerRes = await this.retryCreateTrigger(funcName, func.triggers);
+                    // 设置路径，创建云接入路径
+                    if (func.path) {
+                        await this.createAccessPath(funcName, func.path);
+                    }
+                    // 检查函数状态
+                    await this.waitFunctionActive(funcName, codeSecret);
+                    // 返回全部操作的响应值
+                    return {
+                        triggerRes,
+                        configRes,
+                        codeRes
+                    };
                 }
-                // 检查函数状态
-                await this.waitFunctionActive(funcName, codeSecret);
-                // 返回全部操作的响应值
-                return {
-                    triggerRes,
-                    configRes,
-                    codeRes
-                };
             }
             // 不强制覆盖，抛出错误
             if (e.message && !force) {
@@ -399,8 +417,8 @@ class FunctionService {
     async getFunctionList(limit = 20, offset = 0) {
         // 获取Function 环境配置
         const { namespace } = this.getFunctionConfig();
-        const res = await this.scfService.request('ListFunctions', {
-            Namespace: namespace,
+        const res = await this.tcbService.request('ListFunctions', {
+            EnvId: namespace,
             Limit: limit,
             Offset: offset
         });
@@ -415,8 +433,8 @@ class FunctionService {
     async listFunctions(limit = 20, offset = 0) {
         // 获取Function 环境配置
         const { namespace } = this.getFunctionConfig();
-        const res = await this.scfService.request('ListFunctions', {
-            Namespace: namespace,
+        const res = await this.tcbService.request('ListFunctions', {
+            EnvId: namespace,
             Limit: limit,
             Offset: offset
         });
@@ -447,8 +465,8 @@ class FunctionService {
         const { envId } = options;
         while (true) {
             try {
-                const res = await this.scfService.request('ListFunctions', {
-                    Namespace: envId,
+                const res = await this.tcbService.request('ListFunctions', {
+                    EnvId: envId,
                     Limit: pageSize,
                     Offset: currentOffset
                 });

package/lib/log/index.js

@@ -19,7 +19,7 @@ exports.isLogServiceEnabled = isLogServiceEnabled;
 const utils_1 = require("../utils");
 __exportStar(require("./types"), exports);
 /**
- * 纯函数：根据 DescribeEnvs 返回的 LogServices 列表判断日志服务是否已开通。
+ * 纯函数：根据 DescribeEnvInfo 返回的 LogServices 列表判断日志服务是否已开通。
  * 已开通条件：至少一个条目有有效的 TopicId。
  */
 function isLogServiceEnabled(logServices) {
@@ -36,21 +36,17 @@ class LogService {
     /**
      * 检查当前环境的日志服务是否已开通
      *
-     * 通过 DescribeEnvs 接口获取环境信息，判断 LogServices 字段中是否包含有效的
+     * 通过 DescribeEnvInfo 接口获取环境信息，判断 LogServices 字段中是否包含有效的
      * 日志主题（TopicId 不为空）。
      *
      * @returns true 表示已开通，false 表示未开通或开通中
      */
     async checkLogServiceEnabled() {
-        var _a;
-        const res = await this.cloudService.request('DescribeEnvs', {
+        var _a, _b;
+        const res = await this.cloudService.request('DescribeEnvInfo', {
             EnvId: this.envId
         });
-        const envInfo = (_a = res === null || res === void 0 ? void 0 : res.EnvList) === null || _a === void 0 ? void 0 : _a[0];
-        if (!envInfo) {
-            return false;
-        }
-        const logServices = envInfo.LogServices;
+        const logServices = (_b = (_a = res === null || res === void 0 ? void 0 : res.EnvInfo) === null || _a === void 0 ? void 0 : _a.EnvBaseInfo) === null || _b === void 0 ? void 0 : _b.LogServices;
         if (!logServices || logServices.length === 0) {
             return false;
         }

package/package.json

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

package/scripts/ci/generate-changelog.js

@@ -0,0 +1,422 @@
+#!/usr/bin/env node
+
+/**
+ * CI Changelog 生成脚本（MR 粒度）
+ *
+ * 从上一个 tag 到当前 HEAD 的 merge commit 中提取 MR 信息，
+ * 按 conventional commit 分类，生成 changelog 并追加到 changelog.md 头部。
+ *
+ * 优势：
+ * - 每个 MR 对应一条 changelog，避免零散 commit 造成条目过多
+ * - 从 MR body 或分支名智能推断变更类型
+ * - 自动提取 MR 编号，生成可跳转链接
+ *
+ * 用法: node scripts/ci/generate-changelog.js
+ * 环境变量:
+ *   MANAGER_NODE_VERSION - 当前发布的版本号（必须）
+ *   GIT_REPO_URL - 仓库地址（可选，用于生成 MR 链接，默认为工蜂地址）
+ *   CHANGELOG_OUTPUT - changelog 输出文件路径（可选，设置后将内容写入该文件，供下游步骤读取）
+ */
+
+const { execSync } = require('child_process')
+const fs = require('fs')
+const path = require('path')
+
+const VERSION = process.env.MANAGER_NODE_VERSION
+if (!VERSION) {
+    console.error('❌ 环境变量 MANAGER_NODE_VERSION 未设置')
+    process.exit(1)
+}
+
+// 仓库 URL，用于生成 MR 链接（当前 formatMR 暂未使用，预留供后续扩展）
+// const REPO_URL = process.env.GIT_REPO_URL || 'https://git.woa.com/QBase/server-side-sdk/cloudbase-manager-node'
+
+// 获取上一个 tag
+// 获取上一个 tag（按版本号排序，排除当前版本）
+// 不使用 git describe（它依赖 commit 祖先关系，在 release 分支上可能跳过中间 tag）
+function getLastTag() {
+    try {
+        const tags = execSync('git tag --sort=-version:refname', {
+            encoding: 'utf8'
+        }).trim().split('\n').filter(Boolean)
+
+        const currentTag = `v${VERSION}`
+        for (const tag of tags) {
+            // 跳过当前版本，找到第一个有效的 semver tag
+            if (tag !== currentTag && /^v?\d+\.\d+\.\d+/.test(tag)) {
+                return tag
+            }
+        }
+        return ''
+    } catch {
+        return ''
+    }
+}
+
+// 获取 merge commits（MR 粒度）
+function getMergeCommits(fromTag) {
+    const range = fromTag ? `${fromTag}..HEAD` : 'HEAD'
+    const separator = '__|__'
+    const recordSeparator = '==RECORD=='
+    try {
+        // %s = subject, %h = short hash, %an = author, %b = body
+        const log = execSync(
+            `git log ${range} --merges --pretty=format:"%s${separator}%h${separator}%an${separator}%b${recordSeparator}"`,
+            { encoding: 'utf8', maxBuffer: 10 * 1024 * 1024 }
+        ).trim()
+        if (!log) return []
+
+        return log
+            .split(recordSeparator)
+            .filter((record) => record.trim())
+            .map((record) => {
+                const parts = record.trim().split(separator)
+                const subject = (parts[0] || '').trim()
+                const hash = (parts[1] || '').trim()
+                const author = (parts[2] || '').trim()
+                const body = (parts[3] || '').trim()
+                return { subject, hash, author, body }
+            })
+    } catch {
+        return []
+    }
+}
+
+// 从 merge commit subject 中提取 MR 编号和分支名
+// 格式: "Merge branch '<branch>' into '<target>' (merge request !<number>)"
+function parseMergeSubject(subject) {
+    const mrMatch = subject.match(/\(merge request !(\d+)\)/)
+    const branchMatch = subject.match(/Merge branch '([^']+)' into/)
+
+    return {
+        mrNumber: mrMatch ? mrMatch[1] : '',
+        branch: branchMatch ? branchMatch[1] : ''
+    }
+}
+
+// 从分支名推断变更类型
+// 常见: feature/xxx, fix/xxx, hotfix/xxx, refactor/xxx, docs/xxx, chore/xxx
+function inferTypeFromBranch(branch) {
+    const branchLower = branch.toLowerCase()
+    if (branchLower.startsWith('feature/') || branchLower.startsWith('feat/')) return 'feat'
+    if (branchLower.startsWith('fix/') || branchLower.startsWith('hotfix/') || branchLower.startsWith('bugfix/')) return 'fix'
+    if (branchLower.startsWith('refactor/')) return 'refactor'
+    if (branchLower.startsWith('perf/')) return 'perf'
+    if (branchLower.startsWith('docs/')) return 'docs'
+    if (branchLower.startsWith('chore/') || branchLower.startsWith('ci/')) return 'chore'
+    if (branchLower.startsWith('revert')) return 'revert'
+    return ''
+}
+
+// 从分支名提取简短描述
+function getDescriptionFromBranch(branch) {
+    // 去掉 feature/, fix/ 等前缀
+    const desc = branch.replace(/^(feature|feat|fix|hotfix|bugfix|refactor|perf|docs|chore|ci|revert)[/-]/, '')
+    // 将 kebab-case 或 camelCase 转为可读文本
+    return desc
+        .replace(/[-_]/g, ' ')
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .trim()
+}
+
+// 解析 conventional commit 格式的文本
+function parseConventional(text) {
+    const match = text.match(/^(\w+)(?:\(([^)]*)\))?(!)?:\s*(.+)$/)
+    if (!match) return null
+    const [, type, scope = '', breaking, description] = match
+    return { type: type.toLowerCase(), scope, description, breaking: !!breaking }
+}
+
+// 早期过滤：基于 subject 和分支名判断是否为噪音 MR
+function shouldFilterEarly(subject, branch) {
+    // 1. 过滤 "Merge branch 'master' into xxx" — 中间合并不是功能变更
+    // 注意：有些带 MR 编号的也是中间合并，subject 格式为
+    // "Merge branch 'feature/xxx' into 'master' (merge request !N)"
+    // 但 body 里是 "Merge branch 'master' into feature/xxx"
+    if (/Merge branch '(master|main|dev|develop)' into/i.test(subject)) return true
+
+    // 2. 分支名为纯 merge 操作的
+    if (/^merge[/-](master|main|dev)/i.test(branch)) return true
+
+    // 3. 分支名就是纯版本号的，如 "2.9.4", "v3.0.1"
+    if (/^v?\d+\.\d+(\.\d+)?(-\w+)?$/.test(branch)) return true
+
+    return false
+}
+
+// 后期过滤：基于解析后的描述判断是否为噪音 MR
+function shouldFilterByDescription(description, body) {
+    // 1. 纯 "update v" 类发版 MR（bump version）
+    if (/^update\s*v(\d|$)/i.test(description)) return true
+    if (/^bump\s*(version|v)/i.test(description)) return true
+    if (/^update\s*version/i.test(description)) return true
+
+    // 2. 描述就是版本号的，如 "2.9.4", "cli 2.11.7"
+    if (/^(cli\s+)?v?\d+\.\d+(\.\d+)?$/i.test(description.trim())) return true
+
+    // 3. 描述为纯合并操作的
+    if (/^合并\s*(master|main)\s*到/i.test(description)) return true
+    if (/^Merge\s+branch\s+'(master|main|dev|develop)'\s+into/i.test(description)) return true
+    if (/^Merge\s+(master|main)\s+(to|into)/i.test(description)) return true
+
+    // 4. body 中描述为纯合并的（fallback）
+    const bodyTrimmed = body.trim()
+    if (/^合并\s*(master|main)\s*到/i.test(bodyTrimmed)) return true
+    if (/^Merge\s+branch\s+'(master|main|dev|develop)'\s+into/i.test(bodyTrimmed)) return true
+
+    return false
+}
+
+// 从描述内容推断更智能的类型（优先于分支名推断）
+function inferTypeFromDescription(description) {
+    const descLower = description.toLowerCase()
+    // 文档相关关键词
+    if (/^(文档|docs?|readme|changelog|注释|说明文档)/.test(descLower)) return 'docs'
+    if (/更新文档|补充文档|修改文档|添加文档/.test(description)) return 'docs'
+    // 重构相关
+    if (/^(重构|refactor)/.test(descLower)) return 'refactor'
+    // 性能优化
+    if (/^(优化|性能|perf)/.test(descLower)) return 'perf'
+    return ''
+}
+
+// 解析一个 MR 的完整信息
+function parseMR(mergeCommit) {
+    const { subject, hash, author, body } = mergeCommit
+    const { mrNumber, branch } = parseMergeSubject(subject)
+
+    // 跳过非 MR 的 merge（如 merge master into feature branch）
+    if (!mrNumber) return null
+
+    // 早期过滤：基于 subject 和分支名
+    if (shouldFilterEarly(subject, branch)) return null
+
+    // 优先从 body 中找 conventional commit 描述
+    let type = 'other'
+    let scope = ''
+    let description = ''
+    let breaking = false
+
+    // body 可能有多行，逐行找第一个有意义的 conventional commit 格式
+    const bodyLines = body.split('\n').map((l) => l.trim()).filter(Boolean)
+    for (const line of bodyLines) {
+        // 跳过分支名本身的重复
+        if (line === branch) continue
+        const parsed = parseConventional(line)
+        if (parsed) {
+            type = parsed.type
+            scope = parsed.scope
+            description = parsed.description
+            breaking = parsed.breaking
+            break
+        }
+        // 如果不是 conventional 格式但也不是分支名，用第一个有意义的行作为描述
+        if (!description && line.length > 3) {
+            description = line
+        }
+    }
+
+    // 如果 body 没有提供有效信息，从分支名推断
+    if (type === 'other' && branch) {
+        const inferredType = inferTypeFromBranch(branch)
+        if (inferredType) type = inferredType
+    }
+
+    if (!description && branch) {
+        description = getDescriptionFromBranch(branch)
+    }
+
+    if (!description) {
+        description = subject
+    }
+
+    // 后期过滤：基于解析后的描述内容（过滤 "update v" 等发版 MR）
+    if (shouldFilterByDescription(description, body)) return null
+
+    // 更智能的分类：描述内容优先于分支名推断
+    // 例如 feature/ 分支但描述是"文档内容"的，应归类为 docs
+    if (type === 'feat' || type === 'fix' || type === 'other') {
+        const descType = inferTypeFromDescription(description)
+        if (descType) type = descType
+    }
+
+    return { type, scope, description, hash, author, mrNumber, breaking }
+}
+
+// 分类 MR
+function categorizeMRs(mergeCommits) {
+    const categories = {
+        breaking: [],
+        feat: [],
+        fix: [],
+        perf: [],
+        refactor: [],
+        revert: [],
+        docs: [],
+        chore: [],
+        other: []
+    }
+
+    for (const mc of mergeCommits) {
+        const parsed = parseMR(mc)
+        if (!parsed) continue // 跳过非 MR 的 merge
+
+        if (parsed.breaking) {
+            categories.breaking.push(parsed)
+        } else if (categories[parsed.type]) {
+            categories[parsed.type].push(parsed)
+        } else {
+            categories.other.push(parsed)
+        }
+    }
+
+    return categories
+}
+
+// 格式化一条 MR
+// 类型 → 中文前缀映射
+const TYPE_PREFIX = {
+    breaking: '不兼容变更',
+    feat: '新增',
+    fix: '修复',
+    perf: '优化',
+    refactor: '重构',
+    revert: '回滚',
+    docs: '文档',
+    chore: '优化',
+    other: ''
+}
+
+function formatMR(parsed) {
+    const prefix = TYPE_PREFIX[parsed.type] || ''
+    const desc = parsed.description
+    // 如果描述已经以前缀开头（如"新增 xxx"），不重复添加
+    const needPrefix = prefix && !desc.startsWith(prefix)
+    const text = needPrefix ? `${prefix} ${desc}` : desc
+    return `- ${text}`
+}
+
+// 生成 changelog 内容（扁平列表格式）
+function generateChangelog(categories) {
+    const date = new Date().toISOString().split('T')[0]
+    const lines = [`## @cloudbase/manager-node v${VERSION} 版本发布 🚀(${date})`, '']
+
+    // 按优先级排列：不兼容变更 → 新功能 → 优化/重构 → 修复 → 其他
+    const order = ['breaking', 'feat', 'perf', 'refactor', 'chore', 'revert', 'docs', 'fix', 'other']
+
+    let hasContent = false
+    for (const key of order) {
+        const items = categories[key]
+        if (items && items.length > 0) {
+            hasContent = true
+            for (const item of items) {
+                lines.push(formatMR(item))
+            }
+        }
+    }
+
+    // 如果完全没有 MR
+    if (!hasContent) {
+        lines.push('- 版本发布')
+    }
+
+    lines.push('')
+    return lines.join('\n')
+}
+
+// 确保 CI 环境有完整的 git 历史和 tags
+function ensureFullGitHistory() {
+    try {
+        // CI 通常是浅克隆，需要 unshallow 才能拿到完整历史
+        const isShallow = fs.existsSync(path.join(
+            execSync('git rev-parse --git-dir', { encoding: 'utf8' }).trim(),
+            'shallow'
+        ))
+        if (isShallow) {
+            console.log('🔄 检测到浅克隆，正在获取完整历史...')
+            execSync('git fetch --unshallow', { encoding: 'utf8', stdio: 'inherit' })
+        }
+    } catch {
+        // 非浅克隆或 unshallow 失败，忽略
+    }
+
+    try {
+        // 确保拉取所有 tags（CI 默认可能不拉 tags）
+        console.log('🏷️  拉取所有 tags...')
+        execSync('git fetch --tags', { encoding: 'utf8', stdio: 'inherit' })
+    } catch {
+        console.warn('⚠️  拉取 tags 失败，将使用本地已有的 tags')
+    }
+}
+
+// 主流程
+function main() {
+    console.log(`📝 正在为 v${VERSION} 生成 changelog（MR 粒度）...`)
+
+    // CI 环境需要确保有完整历史和 tags
+    ensureFullGitHistory()
+
+    const lastTag = getLastTag()
+    if (lastTag) {
+        console.log(`  上一个 tag: ${lastTag}`)
+    } else {
+        console.log('  未找到历史 tag，将使用所有 merge commit')
+    }
+
+    const mergeCommits = getMergeCommits(lastTag)
+    console.log(`  找到 ${mergeCommits.length} 个 merge commit`)
+
+    const categories = categorizeMRs(mergeCommits)
+    const totalMRs = Object.values(categories).reduce((sum, arr) => sum + arr.length, 0)
+    console.log(`  有效 MR: ${totalMRs} 个`)
+
+    const newChangelog = generateChangelog(categories)
+
+    console.log('\n--- 生成的 changelog ---')
+    console.log(newChangelog)
+    console.log('--- end ---\n')
+
+    // 读取现有 changelog
+    const changelogPath = path.join(__dirname, '../../CHANGELOG.md')
+    let existingContent = ''
+    if (fs.existsSync(changelogPath)) {
+        existingContent = fs.readFileSync(changelogPath, 'utf8')
+    }
+
+    // 插入新内容到头部
+    const finalContent = newChangelog + '\n---\n\n' + existingContent
+
+    fs.writeFileSync(changelogPath, finalContent, 'utf8')
+    console.log('📄 changelog.md 已更新')
+
+    // 将本次生成的 changelog 内容单独输出到指定文件
+    // 用于 CI 流水线中传递给下游步骤（如企微通知）
+    // 用法: export CHANGELOG_OUTPUT="/path/to/changelog_content.md"
+    const outputPath = process.env.CHANGELOG_OUTPUT
+    if (outputPath) {
+        // 企微消息有 4KB 左右的大小限制，超长时截断并添加提示
+        const MAX_WEWORK_SIZE = 3800 // 预留一些余量
+        let outputContent = newChangelog
+        if (Buffer.byteLength(outputContent, 'utf8') > MAX_WEWORK_SIZE) {
+            // 按行截断，保留标题和尽量多的条目
+            const lines = outputContent.split('\n')
+            let truncated = ''
+            for (const line of lines) {
+                const next = truncated + line + '\n'
+                if (Buffer.byteLength(next, 'utf8') > MAX_WEWORK_SIZE - 100) {
+                    break
+                }
+                truncated = next
+            }
+            const totalItems = newChangelog.split('\n').filter(l => l.startsWith('- ')).length
+            const keptItems = truncated.split('\n').filter(l => l.startsWith('- ')).length
+            truncated += `\n... 等共 ${totalItems} 项变更（已截断，完整内容见 changelog.md）\n`
+            outputContent = truncated
+            console.log(`⚠️  changelog 过长 (${Buffer.byteLength(newChangelog, 'utf8')} bytes)，已截断为 ${keptItems}/${totalItems} 项`)
+        }
+        fs.writeFileSync(outputPath, outputContent, 'utf8')
+        console.log(`📄 changelog 内容已输出到: ${outputPath}`)
+    }
+}
+
+main()

package/types/env/index.d.ts

@@ -1,7 +1,7 @@
 import { Environment } from '../environment';
 import { IResponseInfo, AuthDomain, EnvInfo, LoginConfigItem, ICheckTcbServiceRes, ICreatePostpayRes, EnvBillingInfoItem, PriceResult } from '../interfaces';
 import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes } from './type';
-import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
+import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvInfoParams, DescribeEnvInfoResponse, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
 type SOURCE = 'miniapp' | 'qcloud';
 interface IDeleteDomainRes {
     RequestId: string;
@@ -629,6 +629,16 @@ export declare class EnvService {
         EnvList: EnvInfo[];
         Total: number;
     }>;
+    /**
+     * 查询单个环境信息
+     *
+     * 用于单个环境查询时，规避 DescribeEnvs 的 backend issues。
+     * 当 EnvId 参数存在时，应优先使用本方法而非 describeEnvs。
+     *
+     * @param params 查询参数，必须包含 EnvId
+     * @returns 环境信息响应
+     */
+    describeEnvInfo(params: DescribeEnvInfoParams): Promise<DescribeEnvInfoResponse>;
     /**
      * 修改环境名称
      * @param {string} alias 环境名称

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

@@ -460,3 +460,67 @@ export interface EnvPkgCreditsUsage {
     ReportValue?: number;
     OriginCredits?: number;
 }
+/**
+ * DescribeEnvInfo API - 查询单个环境信息
+ * 替代 DescribeEnvs 用于单环境查询，用于规避 backend issues when filtering by EnvId
+ */
+export interface DescribeEnvInfoParams {
+    EnvId: string;
+}
+export interface EnvBaseInfo {
+    EnvId?: string;
+    Alias?: string;
+    Status?: string;
+    EnvType?: string;
+    Region?: string;
+    PackageId?: string;
+    PackageName?: string;
+    Databases?: DatabasesInfo[];
+    Storages?: StorageInfo[];
+    Functions?: FunctionInfo[];
+    PayMode?: string;
+    Source?: string;
+    Tags?: Array<{
+        Key: string;
+        Value: string;
+    }>;
+    CreateTime?: string;
+    UpdateTime?: string;
+    EnvPreferences?: Record<string, any>;
+    IsAutoDegrade?: boolean;
+    IsDauPackage?: boolean;
+    PostgreSQL?: Record<string, any>;
+    LogServices?: Array<{
+        LogsetId?: string;
+        TopicId?: string;
+        TopicName?: string;
+        Region?: string;
+    }> | null;
+    CustomLogServices?: Array<{
+        CreateTime: string;
+        ClsLogsetId: string;
+        ClsTopicId: string;
+        ClsRegion: string;
+    }> | null;
+}
+export interface BillingInfo {
+    StartTime?: string;
+    EndTime?: string;
+    Status?: string;
+}
+export interface UserInfo {
+    AppId?: string;
+    Uin?: string;
+    WxAppId?: string;
+}
+export interface DescribeEnvInfoResponse extends IResponseInfo {
+    EnvInfo?: {
+        EnvBaseInfo?: EnvBaseInfo;
+        BillingInfo?: BillingInfo;
+        UserInfo?: UserInfo;
+        Eid?: number;
+        CircleStartTime?: string;
+        CircleEndTime?: string;
+        SiteFlag?: number;
+    };
+}

package/types/log/index.d.ts

@@ -11,7 +11,7 @@ export interface ILogServiceEntry {
     Region?: string;
 }
 /**
- * 纯函数：根据 DescribeEnvs 返回的 LogServices 列表判断日志服务是否已开通。
+ * 纯函数：根据 DescribeEnvInfo 返回的 LogServices 列表判断日志服务是否已开通。
  * 已开通条件：至少一个条目有有效的 TopicId。
  */
 export declare function isLogServiceEnabled(logServices?: ILogServiceEntry[]): boolean;
@@ -23,7 +23,7 @@ export declare class LogService {
     /**
      * 检查当前环境的日志服务是否已开通
      *
-     * 通过 DescribeEnvs 接口获取环境信息，判断 LogServices 字段中是否包含有效的
+     * 通过 DescribeEnvInfo 接口获取环境信息，判断 LogServices 字段中是否包含有效的
      * 日志主题（TopicId 不为空）。
      *
      * @returns true 表示已开通，false 表示未开通或开通中

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test -- --testPathPattern=cloudApp 2>&1)",
-      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test 2>&1)",
-      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test -- --testPathPattern=cloudApp --testNamePattern=\"获取版本列表\")"
-    ]
-  }
-}