@cloudbase/manager-node 5.2.0-beta.1 → 5.3.0

package/cloudbase-manager-node/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "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=\"获取版本列表\")"
+    ]
+  }
+}

package/cloudbase-manager-node/.editorconfig

@@ -0,0 +1,8 @@
+root = true
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

package/cloudbase-manager-node/.eslintignore

@@ -0,0 +1,3 @@
+lib/
+types/
+node_modules

package/cloudbase-manager-node/.eslintrc.js

@@ -0,0 +1,27 @@
+module.exports = {
+    extends: ['alloy', 'alloy/typescript'],
+    rules: {
+        indent: ['error', 4],
+        semi: ['error', 'never'],
+        complexity: ['error', { max: 40 }],
+        'no-useless-constructor': 'off',
+        '@typescript-eslint/explicit-member-accessibility': 'off',
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/interface-name-prefix': 'off',
+        '@typescript-eslint/no-useless-constructor': 'off',
+        '@typescript-eslint/no-duplicate-imports': 'off'
+    },
+    env: {
+        es6: true,
+        node: true,
+        jest: true
+    },
+    overrides: [
+        {
+            files: ['*.js'],
+            rules: {
+                '@typescript-eslint/no-var-requires': 'off'
+            }
+        }
+    ]
+}

package/cloudbase-manager-node/.prettierrc.js

@@ -0,0 +1,31 @@
+module.exports = {
+    // 一行最多 100 字符
+    printWidth: 100,
+    // 使用 4 个空格缩进
+    tabWidth: 4,
+    // 不使用缩进符，而使用空格
+    useTabs: false,
+    // 行尾需要有分号
+    semi: false,
+    // 使用单引号
+    singleQuote: true,
+    // 对象的 key 仅在必要时用引号
+    quoteProps: 'as-needed',
+    // 末尾不需要逗号
+    trailingComma: 'none',
+    // 大括号内的首尾需要空格
+    bracketSpacing: true,
+    // 每个文件格式化的范围是文件的全部内容
+    rangeStart: 0,
+    rangeEnd: Infinity,
+    // 不需要写文件开头的 @prettier
+    requirePragma: false,
+    // 不需要自动在文件开头插入 @prettier
+    insertPragma: false,
+    // 使用默认的折行标准
+    proseWrap: 'preserve',
+    // 换行符使用 lf
+    endOfLine: 'lf',
+    // 箭头括号
+    arrowParens: 'avoid'
+}

package/cloudbase-manager-node/CHANGELOG.md

@@ -0,0 +1,109 @@
+# 4.0.0
+- 升级 https-proxy-agent 3->5 修复 https://github.com/TencentCloud/tencentcloud-sdk-nodejs/issues/47
+
+
+# v3.9.2-beta
+-   扩展禁用用户接口为变更用户状态接口
+-   增加修改用户信息接口
+
+# v3.5.0
+
+-   新增获取云开发用户列表接口
+-   新增停用云开发用户接口
+-   新增批量删除云开发用户接口
+
+# v3.4.0
+
+-   增加云接入服务
+-   创建函数支持同时创建云接入
+-   优化请求错误栈
+
+# v3.3.2
+
+-   函数轮询状态时间修复 30s => 300s
+
+# v3.3.0
+
+-   静态托管支持配置重定向规则
+-   新增删除静态托管自定义域名接口
+-   新增获取静态网站配置接口
+-   新增获取域名配置接口
+-   新增域名配置接口
+
+# v3.2.0
+
+-   新增静态托管查询文件，配置文档，绑定自定义域名接口
+
+# v3.1.1
+
+-   优化文件夹删除接口
+-   增加批量上传文件接口
+-   修复静态网站上传单个文件没有回调的问题
+
+# v3.0.0
+
+-   [fix] common 方法改造
+-   [add] 支持数据库 CRUD
+
+# v2.4.1
+
+-   [fix] 修复并行调用 createFunction 接口报错的问题
+-   [add] 支持通过指定函数路径创建函数
+
+# v2.4.0
+
+-   [add] 新增安全来源 API
+-   [fix] 修复云函数环境下取环境变量 bug (入口函数外部调用，未取到报错)
+
+# v2.3.4
+
+-   [fix] 修复函数配置更新问题
+
+# v2.3.2
+
+-   [fix] 修复更新函数 VPC 配置导致无法访问公网的问题
+
+# v2.3.1
+
+-   [fix] 修复创建函数、更新函数代码，代码保护参数遗漏的问题
+
+# v2.3.0
+
+-   [add] 支持文件层
+-   [add] 支持查询修改存储安全规则异步任务状态
+-   [fix] 文档订正
+
+# v2.2.1
+
+-   [fix] 修复查询所有集合信息接口，集合为空时报错
+-   [fix] updateFunctionCode 支持自动安装依赖
+
+# v2.2.0
+
+-   [fix] 修复上传文件夹等接口 `onFileFinish` 参数 TS 定义错误
+-   [add] 创建云函数返回 RequestId 响应值
+-   [add] 支持 L5 选项
+
+# v2.1.0
+
+-   [add] 支持上传或更新函数时 等待依赖安装完成
+-   [add] 支持增量上传函数代码
+-   [add] 新增创建自定义登录私钥
+-   [add] 新增 HTTP Service API
+-   [add] 新增安全规则 API
+
+# v2.0.0
+
+-   [refactor] 重构 storage , function 接口(breaking change)
+-   [add] 支持闭环完成环境创建
+-   [add] 支持函数操作代码保护
+-   [fix] 修复 windows 下上传文件路径 bug
+
+# v1.3.0
+
+-   [add] 支持获取云函数代码下载链接
+
+# v1.2.0
+
+-   [deprecated] env 创建环境功能暂时停用
+-   [add] 支持创建云函数自动安装依赖

package/cloudbase-manager-node/LICENSE

@@ -0,0 +1,6 @@
+ISC License (ISC)
+Copyright <2019> <Tencent Cloud Base>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/cloudbase-manager-node/README.md

@@ -0,0 +1,46 @@
+# cloudbase-manager-node
+
+云开发 manager-node 支持开发者通过接口形式对云开发提供的云函数、数据库、文件存储等资源进行创建、管理、配置等操作。更多源码内容请参见 [cloudbase-manager-node](https://github.com/TencentCloudBase/cloudbase-manager-node)。
+
+## 安装
+
+npm
+
+```bash
+npm install @cloudbase/manager-node
+```
+
+yarn
+
+```bash
+yarn add @cloudbase/manager-node
+```
+
+## 使用
+
+要在你的代码内使用该模块：
+
+```js
+const CloudBase = require('@cloudbase/manager-node')
+```
+
+或
+
+```js
+import CloudBase from '@cloudbase/manager-node'
+```
+
+初始化
+
+```js
+const app = CloudBase.init({
+    secretId: 'Your SecretId',
+    secretKey: 'Your SecretKey',
+    token: 'Your SecretToken', // 使用临时凭证需要此字段
+    envId: 'Your envId' // 云环境 ID，可在腾讯云-云开发控制台获取
+})
+```
+
+## 文档
+
+请访问新的[文档站点](https://docs.cloudbase.net/api-reference/manager/node/introduction.html)查看详细的文档。

package/cloudbase-manager-node/jest.config.js

@@ -0,0 +1,18 @@
+module.exports = {
+    roots: ['<rootDir>/test'],
+    globals: {
+        'ts-jest': {
+            tsConfig: 'tsconfig.test.json'
+        }
+    },
+    transform: {
+        '^.+\\.ts?$': 'ts-jest'
+    },
+    transformIgnorePatterns: ['node_modules'],
+    testEnvironment: 'node',
+    forceExit: true,
+    // https://github.com/facebook/jest/issues/5164
+    globalSetup: './test/global-setup-hook.ts',
+    // globalTeardown: './test/global-teardown-hook.js',
+    coverageReporters: ['json', 'lcov', 'clover', 'text-summary']
+}

package/cloudbase-manager-node/package.json

@@ -0,0 +1,70 @@
+{
+    "name": "@cloudbase/manager-node",
+    "version": "5.3.0",
+    "description": "The node manage service api for cloudbase.",
+    "main": "lib/index.js",
+    "scripts": {
+        "build": "rimraf lib types && npx tsc",
+        "test:coverage": "jest --runInBand --detectOpenHandles --coverage --testTimeout=100000",
+        "test": "jest --runInBand --detectOpenHandles --testTimeout=100000",
+        "lint": "eslint \"./**/*.ts\"",
+        "lint:fix": "eslint --fix \"./**/*.ts\"",
+        "prepublishOnly": "npm run build",
+        "watch": "rimraf lib types && tsc -w",
+        "link": "node scripts/link.js",
+        "unlink": "node scripts/link.js -d"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/TencentCloudBase/cloudbase-manager-node.git"
+    },
+    "author": "Tencent CloudBase Team",
+    "license": "ISC",
+    "typings": "types/index.d.ts",
+    "devDependencies": {
+        "@lerna/create-symlink": "^6.4.1",
+        "@types/fs-extra": "^11.0.4",
+        "@types/jest": "^24.0.18",
+        "@types/node": "^12.7.4",
+        "@types/node-fetch": "^2.5.0",
+        "@types/unzipper": "^0.10.11",
+        "@typescript-eslint/eslint-plugin": "^3.7.1",
+        "@typescript-eslint/parser": "^3.7.1",
+        "eslint": "^7.6.0",
+        "eslint-config-alloy": "^3.7.4",
+        "husky": "^3.0.5",
+        "jest": "^24.9.0",
+        "lint-staged": "^9.2.5",
+        "rimraf": "^3.0.0",
+        "ts-jest": "^24.1.0",
+        "typescript": "^5.8.3"
+    },
+    "dependencies": {
+        "@cloudbase/database": "^0.6.2",
+        "archiver": "^3.1.1",
+        "cos-nodejs-sdk-v5": "^2.14.0",
+        "del": "^5.1.0",
+        "fs-extra": "^11.3.0",
+        "https-proxy-agent": "^5.0.1",
+        "lodash": "^4.17.21",
+        "make-dir": "^3.0.0",
+        "micromatch": "^4.0.2",
+        "node-fetch": "^2.6.0",
+        "query-string": "^6.8.3",
+        "unzipper": "^0.12.3",
+        "uuid": "^9.0.0",
+        "walkdir": "^0.4.1"
+    },
+    "husky": {
+        "hooks": {
+            "pre-commit": "npm run build && git add . && lint-staged"
+        }
+    },
+    "lint-staged": {
+        "*.ts": [
+            "eslint --fix",
+            "git add"
+        ]
+    },
+    "packageManager": "yarn@1.22.22"
+}

package/cloudbase-manager-node/scripts/link.js

@@ -0,0 +1,98 @@
+/**
+ * Tencent is pleased to support the open source community by making CloudBaseFramework - 云原生一体化部署工具 available.
+ *
+ * Copyright (C) 2020 THL A29 Limited, a Tencent company.  All rights reserved.
+ *
+ * Please refer to license text included with this package for license details.
+ */
+
+const os = require('os')
+const fs = require('fs')
+const fse = require('fs-extra')
+const del = require('del')
+const path = require('path')
+const mkdirp = require('mkdirp')
+const { execSync } = require('child_process')
+const { createSymlink } = require('@lerna/create-symlink')
+
+const globalNpmPath = execSync('npm root -g', {
+    encoding: 'utf-8'
+}).trim()
+// 如果不支持workspace 可以用下面写死
+// const globalNpmPath = '/usr/local/lib/node_modules';
+
+async function main() {
+    const unlink = process.argv?.[2] === '-d'
+    await linkCore(unlink)
+}
+
+async function linkCore(unlink = false) {
+    const jsonString = await fs.readFileSync(path.join(__dirname, '../package.json'))
+    const { name } = JSON.parse(jsonString)
+    await link(path.join(process.cwd()), path.join(globalNpmPath, '@cloudbase/cli'), name, unlink)
+}
+
+function isSymlink(path) {
+    const stats = fs.lstatSync(path)
+    return stats.isSymbolicLink()
+}
+
+// 将 global tcb cli 工具中的 framework-core link 到 packages/framework-core
+async function link(src, dest, packageName, unlink = false) {
+    const prevCwd = process.cwd()
+    const destPlugin = path.join(dest, 'node_modules', '@cloudbase')
+    // 确保目录存在
+    mkdirp.sync(destPlugin)
+    // 切换 cwd
+    process.chdir(destPlugin)
+
+    const pathName = packageName.replace('@cloudbase/', '')
+    const backupPathName = `${pathName}_backup`
+
+    if (unlink) {
+        if (fs.existsSync(pathName) && !isSymlink(pathName)) {
+            console.log(`【失败】${pathName} 不是软链接`, process.cwd())
+            return
+        }
+
+        if (fs.existsSync(pathName) && fs.existsSync(backupPathName)) {
+            // 删除软链接
+            del.sync([pathName])
+
+            // 恢复备份
+            fse.moveSync(backupPathName, pathName)
+
+            // 删除软链接
+            console.log('【成功】删除软链接：', process.cwd())
+        } else {
+            console.info(
+                `不存在 ${pathName} 或 ${backupPathName}，请重装安装 npm i @cloudbase/cli -g`,
+                process.cwd()
+            )
+        }
+    } else {
+        // 创建软链接
+
+        if (fs.existsSync(pathName)) {
+            if (!fs.existsSync(backupPathName)) {
+                // 不存在备份则进行备份
+
+                if (!isSymlink(pathName)) {
+                    // 不是软链接才备份
+                    fse.moveSync(pathName, backupPathName)
+                }
+            } else {
+                // 存在备份则直接删除
+                del.sync([pathName])
+            }
+        }
+
+        await createSymlink(src, pathName, 'junction')
+        console.log('【成功】创建软链接：', process.cwd())
+    }
+
+    // 切回源目录
+    process.chdir(prevCwd)
+}
+
+main()

package/cloudbase-manager-node/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compileOnSave": true,
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "ES2017",
+        "moduleResolution": "node",
+        "outDir": "lib",
+        "removeComments": false,
+        "types": ["node"],
+        "esModuleInterop": true,
+        "declaration": true,
+        "declarationDir": "./types",
+        "experimentalDecorators": true,
+        "newLine": "LF",
+        "skipLibCheck": true
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "test"]
+}

package/cloudbase-manager-node/tsconfig.test.json

@@ -0,0 +1,14 @@
+{
+    "compileOnSave": true,
+    "compilerOptions": {
+        "experimentalDecorators": true,
+        "module": "commonjs",
+        "target": "ES2017",
+        "moduleResolution": "node",
+        "outDir": "lib",
+        "types": ["node", "jest"],
+        "esModuleInterop": true
+    },
+    "include": ["src/**/*", "test/**/*"],
+    "exclude": ["node_modules"]
+}

package/lib/aiModel/index.js

@@ -0,0 +1,101 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiModelService = void 0;
+const utils_1 = require("../utils");
+class AiModelService {
+    constructor(environment) {
+        this.environment = environment;
+        this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+    }
+    /**
+     * 创建 AI 模型配置分组
+     */
+    async createAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupName, baseUrl, models, remark, status, secret } = options;
+        if (!groupName || groupName.trim().length === 0) {
+            throw new Error('groupName is required');
+        }
+        if (groupName.toLowerCase().startsWith('cloudbase')) {
+            throw new Error('groupName cannot start with cloudbase');
+        }
+        if (status !== undefined && status !== 1 && status !== 2) {
+            throw new Error('status must be 1 or 2');
+        }
+        return this.tcbService.request('CreateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
+    }
+    /**
+     * 更新 AI 模型配置分组
+     */
+    async updateAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupName, baseUrl, models, remark, status, secret } = options;
+        if (!groupName || groupName.trim().length === 0) {
+            throw new Error('groupName is required');
+        }
+        if (status !== undefined && status !== 1 && status !== 2) {
+            throw new Error('status must be 1 or 2');
+        }
+        return this.tcbService.request('UpdateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
+    }
+    /**
+     * 删除 AI 模型配置分组，支持批量删除
+     */
+    async deleteAIModel(options) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId, groupNames } = options;
+        if (!Array.isArray(groupNames) || groupNames.length === 0) {
+            throw new Error('groupNames is required');
+        }
+        const invalidGroupName = groupNames.find(item => typeof item !== 'string' || item.trim().length === 0);
+        if (invalidGroupName !== undefined) {
+            throw new Error('groupNames contains invalid item');
+        }
+        return this.tcbService.request('DeleteAIModel', {
+            EnvId: envId || EnvId,
+            GroupNames: groupNames
+        });
+    }
+    /**
+     * 查询指定云开发环境下已配置的 AI 模型分组列表
+     */
+    async describeAIModels(options = {}) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId } = options;
+        return this.tcbService.request('DescribeAIModels', {
+            EnvId: envId || EnvId
+        });
+    }
+    /**
+     * 查询云开发平台支持的托管类型 AI 模型列表
+     */
+    async describeManagedAIModelList(options = {}) {
+        const { EnvId } = this.environment.lazyEnvironmentConfig;
+        const { envId } = options;
+        return this.tcbService.request('DescribeManagedAIModelList', {
+            EnvId: envId || EnvId
+        });
+    }
+}
+exports.AiModelService = AiModelService;
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "createAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "updateAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "deleteAIModel", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "describeAIModels", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], AiModelService.prototype, "describeManagedAIModelList", null);

package/lib/aiModel/type.js

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

package/lib/environment.js

@@ -21,6 +21,7 @@ const mysql_1 = require("./mysql");
 const cloudApp_1 = require("./cloudApp");
 const permission_1 = require("./permission");
 const sandbox_1 = require("./sandbox");
+const aiModel_1 = require("./aiModel");
 class Environment {
     constructor(context, envId) {
         this.inited = false;
@@ -45,6 +46,7 @@ class Environment {
         this.permissionService = new permission_1.PermissionService(this);
         this.cloudAppService = new cloudApp_1.CloudAppService(this);
         this.sandboxService = new sandbox_1.SandboxService(this);
+        this.aiModelService = new aiModel_1.AiModelService(this);
     }
     async lazyInit() {
         if (!this.inited) {
@@ -116,6 +118,9 @@ class Environment {
     getSandboxService() {
         return this.sandboxService;
     }
+    getAiModelService() {
+        return this.aiModelService;
+    }
     getCommonService(serviceType = 'tcb', serviceVersion) {
         return new common_1.CommonService(this, serviceType, serviceVersion);
     }

package/lib/index.js

@@ -119,6 +119,9 @@ class CloudBase {
     get sandbox() {
         return this.currentEnvironment().getSandboxService();
     }
+    get aiModel() {
+        return this.currentEnvironment().getAiModelService();
+    }
     get docs() {
         if (!this.docsService) {
             this.docsService = new docs_1.DocsService();

package/package.json

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

package/types/aiModel/index.d.ts

@@ -0,0 +1,27 @@
+import { Environment } from '../environment';
+import { CreateAIModelOptions, CreateAIModelResp, UpdateAIModelOptions, UpdateAIModelResp, DeleteAIModelOptions, DeleteAIModelResp, DescribeAIModelsOptions, DescribeAIModelsResp, DescribeManagedAIModelListOptions, DescribeManagedAIModelListResp } from './type';
+export declare class AiModelService {
+    private environment;
+    private tcbService;
+    constructor(environment: Environment);
+    /**
+     * 创建 AI 模型配置分组
+     */
+    createAIModel(options: CreateAIModelOptions): Promise<CreateAIModelResp>;
+    /**
+     * 更新 AI 模型配置分组
+     */
+    updateAIModel(options: UpdateAIModelOptions): Promise<UpdateAIModelResp>;
+    /**
+     * 删除 AI 模型配置分组，支持批量删除
+     */
+    deleteAIModel(options: DeleteAIModelOptions): Promise<DeleteAIModelResp>;
+    /**
+     * 查询指定云开发环境下已配置的 AI 模型分组列表
+     */
+    describeAIModels(options?: DescribeAIModelsOptions): Promise<DescribeAIModelsResp>;
+    /**
+     * 查询云开发平台支持的托管类型 AI 模型列表
+     */
+    describeManagedAIModelList(options?: DescribeManagedAIModelListOptions): Promise<DescribeManagedAIModelListResp>;
+}

package/types/aiModel/type.d.ts

@@ -0,0 +1,205 @@
+import { IResponseInfo } from '../interfaces';
+/** 模型状态，1：开启，2：关闭 */
+export type AIModelStatus = 1 | 2;
+/** AI 模型信息 */
+export interface AIModel {
+    /** 模型名，示例值：huanyuan-v1 */
+    Model?: string;
+    /** 是否开启 MCP，示例值：false */
+    EnableMCP?: boolean;
+    /** 标签 */
+    Tags?: string[];
+}
+/** AI 模型密钥信息 */
+export interface AIModelSecret {
+    /** 密钥来源，示例值：custom */
+    SecretSource?: string;
+    /** 密钥 ID，和 SecretKey 一一对应 */
+    SecretId?: string;
+    /** 密钥 Key，和 SecretId 一一对应 */
+    SecretKey?: string;
+    /** ApiKey，SecretKey 和 ApiKey 二选一 */
+    ApiKey?: string;
+}
+/** AI 模型分组类型 */
+export type AIModelGroupType = 'builtin' | 'custom';
+/** AI 模型分组信息 */
+export interface AIModelGroup {
+    /**
+     * 模型分组
+     * 枚举值：
+     * - hunyuan-exp
+     * - hunyuan-image
+     * - deepseek
+     * - cloudbase
+     * - custom-xxxx
+     */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: AIModel[] | null;
+    /** 模型类型：builtin 内置模型分组类别，custom 用户自定义模型分组类别 */
+    Type?: AIModelGroupType;
+    /** 原始模型类型：builtin 内置模型类型，custom 用户自定义模型类型 */
+    OriginType?: AIModelGroupType;
+    /** 备注 */
+    Remark?: string;
+    /** 模型地址 */
+    BaseUrl?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    Status?: AIModelStatus;
+    /**
+     * 模型密钥
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Secret?: AIModelSecret | null;
+    /** 创建时间，ISO8601 格式 */
+    CreateTime?: string;
+    /** 更新时间，ISO8601 格式 */
+    UpdateTime?: string;
+}
+/** 托管 AI 模型计费类型 */
+export type ManagedAIModelChargingType = 'Uniform' | 'Tiered';
+/** 托管 AI 模型参数规格 */
+export interface ManagedAIModelSpec {
+    /** 最大输入 Token，示例值：192k */
+    MaxInputToken?: string;
+    /** 最大输出 Token，示例值：32k */
+    MaxOutputToken?: string;
+    /** 上下文长度，示例值：128k */
+    ContextLength?: string;
+}
+/** 托管 AI 模型计费信息 */
+export interface ManagedAIModelChargingInfo {
+    /** 计费类型：Uniform 固定计费，Tiered 分段计费 */
+    Type?: ManagedAIModelChargingType;
+    /** 分组名称，示例值：0-16k */
+    Name?: string;
+    /** 输入 Token 价格，示例值：1.2 */
+    InputPrice?: string;
+    /** 输出 Token 价格，示例值：4 */
+    OutputPrice?: string;
+    /** 命中缓存价格，示例值：0.4 */
+    CachePrice?: string;
+    /** 计费单位，示例值：千tokens */
+    InputOutputUnit?: string;
+}
+/** 托管型 AI 模型信息 */
+export interface ManagedAIModel {
+    /** 模型名，示例值：hy3-preview */
+    Model?: string;
+    /** 是否开启 MCP，示例值：true */
+    EnableMCP?: boolean;
+    /** 模型规格 */
+    ModelSpec?: ManagedAIModelSpec;
+    /** 模型计费信息 */
+    ModelChargingInfo?: ManagedAIModelChargingInfo[];
+}
+/** 云开发内置 AI 模型分组信息 */
+export interface ManagedAIModelGroup {
+    /** 模型分组，示例值：cloudbase */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: ManagedAIModel[] | null;
+    /** 备注，示例值：腾讯云开发 */
+    Remark?: string;
+}
+/**
+ * CreateAIModel 用户入参
+ */
+export interface CreateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /**
+     * 分组名
+     * 入参限制：不允许以 cloudbase 为前缀
+     */
+    groupName: string;
+    /** 模型服务地址，示例值：http://xxx */
+    baseUrl?: string;
+    /** 模型名列表 */
+    models?: AIModel[];
+    /** 分组备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** CreateAIModel 返回结果 */
+export interface CreateAIModelResp extends IResponseInfo {
+    /** 创建数量 */
+    Count: number;
+}
+/**
+ * UpdateAIModel 用户入参
+ */
+export interface UpdateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名 */
+    groupName: string;
+    /** 模型地址，示例值：http://xxx */
+    baseUrl?: string;
+    /**
+     * 模型名列表
+     * 注意：Models 列表更新采用全量替换
+     */
+    models?: AIModel[];
+    /** 备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** UpdateAIModel 返回结果 */
+export interface UpdateAIModelResp extends IResponseInfo {
+    /** 更新数量 */
+    Count: number;
+}
+/**
+ * DeleteAIModel 用户入参
+ */
+export interface DeleteAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名列表 */
+    groupNames: string[];
+}
+/** DeleteAIModel 返回结果 */
+export interface DeleteAIModelResp extends IResponseInfo {
+    /** 成功删除数量 */
+    Count: number;
+}
+/** DescribeAIModels 用户入参 */
+export interface DescribeAIModelsOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeAIModels 返回结果 */
+export interface DescribeAIModelsResp extends IResponseInfo {
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    AIModels: AIModelGroup[] | null;
+}
+/** DescribeManagedAIModelList 用户入参 */
+export interface DescribeManagedAIModelListOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeManagedAIModelList 返回结果 */
+export interface DescribeManagedAIModelListResp extends IResponseInfo {
+    /**
+     * 托管模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    ManagedAIModelList: ManagedAIModelGroup[] | null;
+}

package/types/environment.d.ts

@@ -17,6 +17,7 @@ import { CloudAppService } from './cloudApp';
 import { EnvInfo } from './interfaces';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
+import { AiModelService } from './aiModel';
 export declare class Environment {
     inited: boolean;
     cloudBaseContext: CloudBaseContext;
@@ -39,6 +40,7 @@ export declare class Environment {
     private permissionService;
     private cloudAppService;
     private sandboxService;
+    private aiModelService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -59,6 +61,7 @@ export declare class Environment {
     getCloudAppService(): CloudAppService;
     getPermissionService(): PermissionService;
     getSandboxService(): SandboxService;
+    getAiModelService(): AiModelService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;
     getAuthConfig(): {

package/types/index.d.ts

@@ -18,6 +18,7 @@ import { DocsService } from './docs';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
 import { CloudAppService } from './cloudApp';
+import { AiModelService } from './aiModel';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -82,6 +83,7 @@ declare class CloudBase {
     get user(): UserService;
     get permission(): PermissionService;
     get sandbox(): SandboxService;
+    get aiModel(): AiModelService;
     get docs(): DocsService;
     getEnvironmentManager(): EnvironmentManager;
     getManagerConfig(): CloudBaseConfig;