TencentCloudBase/CloudBase-AI-ToolKit

激活邀请码

云开发 AI编程激励计划, через пригласительный код активирует поощрение пользователей.

CloudBase 开发阶段登录与环境

CloudBase (Tencent Cloud Development) — логин и привязка окружения на этапе разработки. После входа вы получаете доступ к облачным ресурсам; окружение (env) — это изолированная единица для облачных функций, баз данных, статического хостинга и других ресурсов. Только после привязки окружения остальные MCP-инструменты смогут с ним работать. Поддерживается: проверка статуса, вход в систему, вход по API Key, привязка окружения (set_env), выход из системы.

调用云API

Универсальный инструмент для вызова облачных API, в основном используется для вызова API управляющей плоскости CloudBase / Tencent Cloud и связанных с зависимыми ресурсами. Перед вызовом сначала убедитесь в корректности service, Action и Param, чтобы избежать угадывания имени Action. Если ваша цель — напрямую интегрировать бизнес-API CloudBase (auth/functions/cloudrun/storage/mysqldb и т.д.) через протокол HTTP, не используйте в первую очередь callCloudApi, а сначала просмотрите соответствующий OpenAPI/Swagger. Существующие возможности OpenAPI/Swagger не являются универсальным набором Action для управляющей плоскости; для API управляющей плоскости сначала обращайтесь к CloudBase API Overview https://cloud.tencent.com/document/product/876/34809 и руководству по интерфейсам зависимых ресурсов облачной разработки https://cloud.tencent.com/document/product/876/34808. Для сервиса tcb часто используемые Action делятся на следующие категории: **Управление окружениями**: `CreateEnv`, `ModifyEnv`, `DescribeEnvs`, `DestroyEnv` **Управление пользователями**: `CreateUser`, `ModifyUser`, `DescribeUserList`, `DeleteUsers` **Конфигурация аутентификации**: `EditAuthConfig`, `DescribeAuthDomains` **Облачные функции**: `DescribeFunctions`, `CreateFunction`, `UpdateFunctionCode`, `DeleteFunction` **Базы данных**: `CreateMySQLInstance`, `DescribeMySQLInstances`, `DestroyMySQLInstance` При уничтожении окружения стандартная практика — обязательно передавать как минимум `EnvId` и `BypassCheck: true`, а если окружение уже находится в периоде изоляции, то по документации дополнительно указать `IsForce: true`.

下载远程文件到指定路径

Скачивает удалённые файлы в указанный относительный путь в корне проекта. Например: изображения для Tabbar мини-программ, которые обязательно должны быть в формате **png**, можно загрузить из Unsplash, Wikimedia (обычно выбирают размер 500), Pexels, официальных ресурсов Apple UI и других источников.

下载项目模板

自动下载并部署 CloudBase 项目模板。 **注意**：当用户请求使用 CloudBase 模板创建新项目时，请调用此工具。 支持的模板: - react: React + CloudBase 全栈应用模板 - vue: Vue + CloudBase 全栈应用模板 - miniprogram: 微信小程序 + 云开发模板 - uniapp: UniApp + CloudBase 跨端应用模板 - rules: 只包含 AI 编辑器配置文件（包含 Cursor、WindSurf、CodeBuddy 等所有主流编辑器配置），适合在已有项目中补充 AI 编辑器配置 支持的 IDE 类型: - all: 下载所有 IDE 配置 - cursor: Cursor AI 编辑器 - 其他 IDE 类型见下方列表 注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数 - windsurf: WindSurf AI 编辑器 - codebuddy: CodeBuddy AI 编辑器 - claude-code: Claude Code AI 编辑器 - cline: Cline AI 编辑器 - gemini-cli: Gemini CLI - opencode: OpenCode AI 编辑器 - qwen-code: 通义灵码 - baidu-comate: 百度 Comate - openai-codex-cli: OpenAI Codex CLI - augment-code: Augment Code - github-copilot: GitHub Copilot - roocode: RooCode AI 编辑器 - tongyi-lingma: 通义灵码 - trae: Trae AI 编辑器 - qoder: Qoder AI 编辑器 - antigravity: Google Antigravity AI 编辑器 - vscode: Visual Studio Code - kiro: Kiro AI 编辑器 - aider: Aider AI 编辑器 特别说明： - rules 模板会自动包含当前 mcp 版本号信息（版本号：2.23.10），便于后续维护和版本追踪 - 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）

CloudBase 环境域名管理（安全域名 / CORS 白名单）

Управляет безопасными доменами CloudBase (безопасные домены / CORS-белый список), поддерживает добавление и удаление (исходные имена инструментов: createEnvDomain/deleteEnvDomain, можно продолжать использовать их для совместимости со старыми AI-правилами). Когда веб-приложение в браузере должно обращаться к ресурсам CloudBase напрямую из локального Vite / dev server, сначала проверь через queryEnv(action=domains), есть ли в белом списке host:port, соответствующий текущему origin браузера, затем добавь именно это значение. После добавления или удаления обычно нужно продолжать опрашивать queryEnv(action=domains), чтобы убедиться, что состояние сходится; безопасные домены обычно вступают в силу примерно через 10 минут. ⚠️ Важно: этот инструмент используется только для проверки CORS/источника запросов и не имеет отношения к SSL-сертификатам. Для привязки пользовательского домена для HTTPS-доступа из публичной сети используй manageGateway(action="bindCustomDomain").

CloudBase 环境查询

Запрашивает информацию о среде CloudBase. Поддерживает список сред, детали указанной среды и домены безопасности. (Прежние названия: envQuery, listEnvs, getEnvInfo, getEnvAuthDomains). Если action=list, то выполняется список/фильтрация по семантике DescribeEnvs. Стандартные поля возврата: EnvId, Alias, Status, EnvType, Region, PackageId, PackageName, IsDefault. Допускается обрезка этих полей через белый список fields. При aliasExact=true выполняется точный поиск по псевдониму, чтобы среды с похожим префиксом не ошибочно попадали в кандидаты. Даже если передан envId, при action=list возвращается только сводка, без полного списка ресурсов или expiry. Для получения подробной информации (включая поля ресурсов и данные о тарификации) об известной среде по EnvId необходимо использовать action=info и передать параметр envId целевой среды. При action=info, когда это возможно, дополняется BillingInfo (поля тарификации: ExpireTime, PayMode, IsAutoRenew и т.д.). 🔍 action=info также выводит три производных поля для выбора бэкенда: - `EnvInfo.RuntimeMode`: 'postgresql' или 'nosql' — указывает, какой бэкенд рекомендуется использовать по умолчанию для новых проектов (postgresql, если PostgreSQL уже подключён, иначе nosql). - `EnvInfo.RuntimeBackends`: три булевых значения `{postgresql, nosql, mysql}` — описывает, какие бэкенды фактически сосуществуют в текущей среде. - `EnvInfo.RuntimeModeHints`: подсказки по API/инструментам/skill для каждого бэкенда. Перед написанием кода для бизнес-логики, управления доступом или хранения данных AI обязан сначала просмотреть эти три поля: в PG-режиме для новых проектов рекомендуется использовать `app.rdb()` + RLS (выполнить `CREATE POLICY` через `managePgDatabase action=execute`) + pgstore; существующие коллекции NoSQL / старое storage / `managePermissions(resourceType="noSqlDatabase")` в PG-среде по-прежнему работают. Действительно неприменим только MySQL: когда `RuntimeBackends.mysql === false`, не следует использовать `manageMysqlDatabase`, `queryMysqlDatabase` и навык `relational-database-tool`.

管理 CloudBase Agent

Единая точка входа для записи в домен CloudBase Agent. Поддерживает создание, обновление и удаление удаленных агентов.

管理 CloudBase 应用认证配置

CloudBase - точка входа для настройки аутентификации на стороне приложения. Используется для изменения способа входа, provider, конфигурации client, обеспечения publishable key, а также создания или удаления API key и пользовательских ключей входа. ⚠️ Этот инструмент предназначен для администрирования и не выполняет вход пользователя. Если задача требует написать клиентский код входа (например, «войти с помощью JS SDK»), сначала выполните настройку через этот инструмент (например, включите usernamePassword, получите publishable key), а затем напишите клиентский код входа из @cloudbase/js-sdk (например, auth.signInWithPassword()) в проекте, а не используйте этот инструмент для выполнения входа. Если фронтенд должен принимать идентификаторы в стиле обычного имени пользователя, сначала выполните action=patchLoginStrategy с параметром patch={ usernamePassword: true }, а затем реализуйте соответствующую логику входа на фронтенде.

部署应用到 CloudBase（独立子域名）

部署 Web 应用到 CloudBase（构建前后端，部署到独立子域名）。 action=getUploadUrl 获取预签名上传 URL（cloud mode 下使用），返回上传地址和 cosTimestamp。 action=deployApp 上传源码 ZIP 并触发远端构建部署管道： 1. 远端 npm install（可通过 installCmd="" 跳过） 2. 远端 npm run build（可通过 buildCmd="" 跳过） 3. 远端 tcb hosting deploy 域名格式：`<serviceName>-<envId>.webapps.tcloudbase.com`（每个 serviceName 一个独立子域名） ✅ 推荐用法（新项目／需要独立域名的 Web 应用，首选此工具）： 新建项目首次部署时，传 framework=static, installCmd="", buildCmd="" 跳过远端构建， 只执行 tcb hosting deploy。部署后获得独立子域名，支持版本管理。 ⚠️ 兼容性说明： - 已有项目若之前用 manageHosting 部署过（域名格式：`<envId>-<appId>.tcloudbaseapp.com`）， 切换到 manageApps 会产生全新的 URL，老链接失效。请保持原部署方式不变。 - 如需判断：调用 queryHosting 检查是否已有托管文件。 与 manageHosting 对比： - manageApps（本工具，新项目首选）：域名 `<serviceName>-<envId>.webapps.tcloudbase.com`，独立子域名，支持版本管理 - manageHosting（已有项目或 fallback）：域名 `<envId>-<appId>.tcloudbaseapp.com/<path>`，共享环境域名 两者均可绑定自定义域名。 ⚠️ 如果 manageApps 构建失败，先用 queryApps(action="getBuildLog") 查日志；仍不行再 fallback 到 manageHosting。

管理 CloudRun 服务

Управляет облачными сервисами хостинга, поддерживает в порядке разработки: инициализацию проекта (можно начать с шаблона, список шаблонов доступен через запрос queryCloudRun), загрузку кода сервиса, локальный запуск (только для сервисов на функциях), развертывание кода, удаление сервиса. При развертывании можно настроить CPU, память, количество экземпляров, тип доступа и другие параметры. Операция удаления требует подтверждения, рекомендуется установить force=true.

数据模型管理

Инструмент для запросов к моделям данных, поддерживает получение списка и детальный запрос (только чтение). Тип операции задаётся параметром action: list — получить список моделей (без схемы, можно отфильтровать через параметр names), get — получить детали одной модели (содержит список полей схемы, форматы, связи и другое, требуется name), docs — сгенерировать SDK-документацию (требуется name).

CloudBase 环境管理（创建/变配/续费）

Управляет окружениями CloudBase. Поддерживает: listPackages — запрос списка доступных тарифов, create — создание нового окружения (нужно подтверждение), modifyPlan — смена тарифа (апгрейд/даунгрейд, нужно подтверждение), renew — продление окружения (нужно подтверждение). ⚠️ Все платные операции (create/modifyPlan/renew) перед выполнением обязательно показывают сводку по конфигурации и ждут, пока пользователь подтвердит командой confirm="yes".

管理 CloudBase 云函数

CloudBase 云函数 единая точка входа для записи. Поддерживает создание функций, обновление кода, обновление конфигурации, вызов функций, управление таймерными триггерами для запланированных задач / cron-задач / scheduled job, а также привязку слоёв. Чтобы создать cron-задачу, сначала создайте функцию с помощью createFunction, затем создайте таймерный триггер с помощью createFunctionTrigger (поддерживается 7-сегментное cron-выражение), а для удаления триггера используйте deleteFunctionTrigger. Развёртывание образов (Runtime=CustomImage): сначала упакуйте код через zip → COS → custom-сборка CloudApp → отправка образа в TCR (этот этап выполняется через чистые Tencent Cloud API, данный инструмент их не покрывает), затем создайте HTTP-функцию на основе образа TCR с помощью createFunction(func.runtime="CustomImage", imageConfig); для последующих итераций используйте updateFunctionCode + imageConfig, чтобы сменить тег образа. Опасные операции требуют явного confirm=true.

管理 CloudBase 网关

CloudBase 网关统一写入口。通过 action 创建目标访问入口，后续承接更通用的网关配置能力。为已存在的 HTTP 云函数补默认域名访问时，通常使用 createAccess 并提供 targetType="function"、targetName、type="HTTP" 与期望 path。注意 createAccess 只创建网关入口，不会自动修改函数资源权限。⚠️ 如需绑定带 SSL 证书的自定义域名供公网 HTTPS 访问，使用 action="bindCustomDomain"（需要 domain 和 certificateId 参数）；如需配置 CORS/安全域名（无证书），请使用 envDomainManagement 工具。

管理 CloudBase 静态托管

Управляет изменениями статического хостинга CloudBase. `action=upload` — загрузить собранные локально артефакты на общий домен (формат домена: `<envId>-<appId>.tcloudbaseapp.com/<cloudPath>`). `action=delete` — удалить файл или каталог хостинга (обязательно `confirm=true`). `action=setWebsiteDocument` — задать индексную страницу, страницу ошибки или правила маршрутизации. `action=enableService` — включить статический хостинг. `action=bindDomain / unbindDomain / updateDomain` — управлять кастомными доменами. `action=downloadFile / downloadDirectory` — скачать содержимое хостинга локально. ⚠️ Для новых проектов в первую очередь используйте `manageApps` (развёртывание на отдельный поддомен). Этот инструмент подходит для продолжения работы со старыми проектами или как fallback для `manageApps`. Домены `manageApps` и `manageHosting` различаются — переход приведёт к тому, что старые ссылки перестанут работать. Если задача — просто посмотреть конфигурацию, файлы или статус домена, используйте `queryHosting`.

管理 CloudBase MySQL 数据库生命周期或执行写入 SQL

Управляет ресурсами базы данных CloudBase MySQL. Поддерживает создание MySQL, удаление MySQL, выполнение запросов SQL/DDL на запись, а также инициализацию схемы базы данных. Примечание: сначала необходимо создать MySQL (action=provisionMySQL, confirm=true), прежде чем выполнять runStatement или initializeSchema. Если MySQL ещё не создан, инструмент вернёт MYSQL_NOT_CREATED и подсказку с nextAction для создания.

管理 CloudBase 权限与用户配置

Управляет правами и пользовательскими конфигурациями CloudBase, поддерживает изменение разрешений ресурсов (базы данных/облачные функции/хранилища и т.д.), управление ролями, добавление/удаление участников и политик, CRUD пользователей приложений. Примеры: - Сделать корзину приватной: `action="updateResourcePermission", resourceType="storage", resourceId="bucket-name", permission="PRIVATE"` - Создать роль: `action="createRole", roleName="admin", roleIdentity="admin"` Внимание: `createUser` / `updateUser` — это управление пользователями приложения на стороне окружения, подходит для тестовых учётных записей, администраторов или предустановленных пользователей. Не заменяет форму регистрации Web SDK в браузере. Для регистрации с логином и паролем на клиенте используйте `auth.signUp({ username, password })`, для входа — `auth.signInWithPassword({ username, password })`. Создание пользователей с логином и паролем напрямую в браузере через `auth.signUp` зависит от поддержки SDK/провайдера — перед использованием обязательно проверьте. Если не поддерживается, используйте бэкенд или административную границу, не раскрывайте ключи в браузере. Семантика `securityRule` зависит от `resourceType`: `doc._openid`, `auth.openid`, проверка подмножества условий запроса, а шаблоны JSON для `create`/`update`/`delete` применимы только к правилам безопасности документной базы данных с `resourceType="noSqlDatabase"`. При настройке `function` или `storage` обращайтесь к официальной документации по правилам безопасности соответствующего ресурса, не копируйте шаблоны NoSQL. 📌 Подсказка для границ между бэкендами: перед вызовом используйте `envQuery(action="info", envId=...)`, чтобы проверить `EnvInfo.RuntimeBackends`: - `resourceType="noSqlDatabase"` действует только на коллекции CloudBase NoSQL документной базы данных. Права на уровне строк таблиц CloudBase PostgreSQL (PG) **не** управляются этим — для таблиц PG используйте RLS: `managePgDatabase(action="execute", confirm=true)` для выполнения `ALTER TABLE ... ENABLE ROW LEVEL SECURITY` и `CREATE POLICY ...`. Если в том же PG-окружении есть коллекции NoSQL, для них по-прежнему используйте правила `noSqlDatabase` — это корректно. (Не "PG-окружение отключает этот инструмент".) - `resourceType="storage"` управляет ACL корзин NoSQL/COS; корзина `pgstore` в PG не попадает под этот `resourceType`. - Данный инструмент не затрагивает MySQL; права доступа к MySQL задавайте через собственные операторы GRANT/REVOKE (через `manageMysqlDatabase`).

管理 PostgreSQL 上下文或执行写入 SQL

Управление CloudBase PostgreSQL: выполнение подтверждённых SQL-запросов на запись или DDL, предварительная проверка рисков SQL, планирование миграции. Контекст автоматически выводится из текущей среды MCP, инициализация не требуется. Поддерживается только путь выполнения встроенного в CloudBase облачного Manager SDK для PostgreSQL.

管理 CloudBase 存储文件

管理 CloudBase 云存储文件，只对 COS/Storage 对象操作，不涉及静态网站托管。支持上传文件/目录、下载文件/目录、删除文件/目录等操作。删除时必须设置 `force=true` 确认，防止误删重要文件。注意：上传后返回的 `temporaryUrl` 是临时签名链接，1小时后过期，不要当作永久公网地址写入配置或持久化存储。工具还会基于 `DescribeEnvs` 返回的 `Storages[0].CdnDomain` 推导出 `publicUrl`，⚠️ 警告：`publicUrl` 仅在存储桶 ACL 为公有读（所有用户可读）时才能被匿名访问；默认私有读写存储桶返回的 `publicUrl` 会返回 403，此时请继续使用 `temporaryUrl`，或先通过控制台/SDK 将目标路径设置为公有读。 💡 存储桶 ACL 权限管理请使用 `permissions` 工具：`queryPermissions(action="getResourcePermission", resourceType="storage", resourceId="bucket-name")` 查询，`managePermissions(action="updateResourcePermission", resourceType="storage", resourceId="bucket-name", permission="READONLY")` 设置。 📦 CloudBase PG / pgstore 桶必须先创建后使用（与 Supabase Storage 一致：upload 前 bucket 必须存在）。浏览器 SDK `app.storage.from().upload(path, file)` 不会自动建桶，且 `path` 的第一段就是 bucket 名（例如 `covers/foo.png` → bucket=`covers`）；`from('covers')` 这个参数当前不会被拼到 path 里。如果上传时浏览器看到 `STORAGE_BUCKET_NOT_FOUND` 或 `PUT https://undefined/`（DevTools 表现为 `net::ERR_NAME_NOT_RESOLVED`），先用本工具或控制台确认/创建对应的 pgstore bucket，再让前端重试上传，不要让前端静默吞掉上传失败。`DescribeEnvs.Storages[]` 返回的旧 NoSQL bucket（形如 `<hash>-<envId>-<appId>`）不是可用的 pgstore bucket，切勿当作默认目标使用。

修改数据模型（当前仅支持创建）

Создаёт модель данных на основе Mermaid classDiagram. Для совместимости имя инструмента остаётся modifyDataModel; сейчас поддерживается только создание новых моделей — обновлять существующую структуру нельзя. Встроен мониторинг асинхронных задач: автоматический опрос до завершения или таймаута.

查询 CloudBase Agent

CloudBase Agent домен, единый вход только для чтения. Поддерживает запрос списка, деталей и логов.

查询 CloudBase 应用认证配置

CloudBase — точка чтения конфигурации аутентификации на стороне приложения. Используется для проверки готовности аутентификации: способ входа, provider, publishable key, API key, конфигурация client, статические домены и т.д. ⚠️ Этот инструмент предназначен только для просмотра конфигурации со стороны администратора, он не выполняет вход пользователя. Если задача требует написать клиентский код для входа (например, «войти через JS SDK»), сначала проверьте конфигурацию через этот инструмент, затем в коде проекта напишите клиентский код @cloudbase/js-sdk (например, `auth.signInWithPassword()`), а не используйте этот инструмент для самого входа. Если бизнес-логика должна принимать обычные строковые идентификаторы (типа имени пользователя), сначала выполните запрос `action=getLoginConfig`; если `usernamePassword=false`, сразу вызовите `manageAppAuth(action=patchLoginStrategy, patch={ usernamePassword: true })`, не пишите прямо API входа через email.

查询 CloudBase 应用部署状态

Запрашивает приложения и версии развёртывания CloudBase. Можно получить список/детали приложений и список/детали версий; после развёртывания используй getAppVersion с buildId для опроса статуса сборки; getBuildLog позволяет запросить логи сборки для диагностики причин сбоя.

查询 CloudRun 服务信息

Запрос информации об услугах облачного хостинга: поддерживает получение списка услуг, запрос деталей услуги, получение списка доступных шаблонов и логов развертывания. Возвращаемая информация об услуге включает название услуги, статус, тип доступа, детали конфигурации и контекст последнего развертывания.

CloudBase 环境查询

Запрашивает информацию, связанную с окружением CloudBase: поддерживается список окружений, детали конкретного окружения и домены безопасности (ранее называлось: envQuery, listEnvs, getEnvInfo, getEnvAuthDomains). Когда action=list, работает в семантике DescribeEnvs — вывод списка/фильтрация, стандартные поля возврата: EnvId, Alias, Status, EnvType, Region, PackageId, PackageName, IsDefault. Поддерживается обрезка этих полей через белый список fields. При aliasExact=true выполняется точная фильтрация по псевдониму, чтобы не подхватить окружения с похожим префиксом. Даже если передан envId, action=list возвращает только краткую сводку, без полных ресурсов или expiry. Чтобы получить подробную информацию об окружении по известному EnvId (включая ресурсы и платёжные данные), необходимо использовать action=info и передать параметр envId целевого окружения. При action=info, если доступно, добавляется BillingInfo (поля оплаты: ExpireTime, PayMode, IsAutoRenew и т.д.). 🔍 action=info также вычисляет три поля для выбора бэкенда: - `EnvInfo.RuntimeMode`: 'postgresql' или 'nosql' — рекомендованный бэкенд для новых проектов (postgresql, если PG уже включён, иначе nosql). - `EnvInfo.RuntimeBackends`: `{postgresql, nosql, mysql}` — три булевых значения, описывающие реально сосуществующие бэкенды текущего окружения. - `EnvInfo.RuntimeModeHints`: подсказки по API/инструментам/skills для каждого бэкенда. Перед написанием кода для бизнес-логики, прав доступа или хранения AI обязан сначала посмотреть эти три поля: в режиме PG новые проекты рекомендуется через `app.rdb()` + RLS (команда `managePgDatabase action=execute` с `CREATE POLICY`) + pgstore; уже существующие коллекции NoSQL / старый storage / `managePermissions(resourceType="noSqlDatabase")` в окружении PG всё ещё работают. Реально неприменим только MySQL: когда `RuntimeBackends.mysql === false`, нельзя использовать `manageMysqlDatabase` / `queryMysqlDatabase` / skill `relational-database-tool`.

查询 CloudBase 云函数

CloudBase: единая точка входа только для чтения для облачных функций. Через более самоочевидный action можно запросить список облачных функций CloudBase, детали функций, логи выполнения, слои, триггеры и адреса загрузки кода. **Описание пагинации**: `listFunctions`, `listLayers` поддерживают параметры `limit` и `offset`. - `limit`: количество элементов на странице, значение по умолчанию задаётся бэкендом - `offset`: смещение страницы, начиная с 0 - Пример: `queryFunctions(action="listFunctions", offset=10, limit=10)` **Запрос логов облачных функций CloudBase**: используйте `action="listFunctionLogs"`, требуется параметр `functionName`. - Пример: `queryFunctions(action="listFunctionLogs", functionName="my-function")` - Чтобы посмотреть детали лога: `queryFunctions(action="getFunctionLogDetail", requestId="xxx")` **Плановые задачи / cron / запланированные запуски**: используйте `listFunctionTriggers` для запроса конфигурации timer-триггера функции. **Отличие от инструмента `queryLogs`**: - Этот инструмент предназначен для запроса логов выполнения конкретной облачной функции CloudBase - Инструмент `queryLogs` используется для поиска в сервисе логов CLS (агрегация логов между сервисами)

查询 CloudBase 网关

CloudBase — унифицированная точка входа шлюза только для чтения. Через action запрашивает доменное имя шлюза, точку входа и статус открытости целевых ресурсов.

查询 CloudBase 静态托管

Запрашивает информацию только для чтения о статическом хостинге CloudBase. Подходит для AI: сначала обнаружить, затем решить, что делать дальше: action=websiteConfig запрашивает информацию о домашней странице, странице ошибок, правилах маршрутизации и доменном имени сайта; action=status запрашивает статус службы хостинга; action=findFiles ищет файлы по префиксу; action=listFiles выводит список всех файлов хостинга; action=domainStatus запрашивает текущий статус и конфигурацию пользовательского домена. Этот инструмент не вызывает никаких побочных эффектов.

查询 CloudBase 日志服务

CloudBase — единая точка входа для чтения логов. Позволяет проверить состояние сервиса логов и выполнять поиск по логам CLS. **Важное различие**: - Поиск логов облачных функций: используйте `queryFunctions(action="listFunctionLogs", functionName="xxx")` - Поиск логов CLS (агрегированные логи разных сервисов): используйте этот инструмент `queryLogs(action="searchLogs")` **Сценарии использования**: - Проверка, включён ли сервис логов CLS: `action="checkLogService"` - Поиск по логам разных сервисов (например, поиск всех ERROR-логов): `action="searchLogs"` - Поиск логов конкретного сервиса по синтаксису CLS: `action="searchLogs", service="tcb|tcbr"`

查询 CloudBase MySQL 数据库状态或执行只读 SQL

Запрашивает информацию о базе данных CloudBase MySQL. Поддерживает выполнение только SQL запросов на чтение, проверку результата открытия MySQL, проверку статуса задач MySQL, а также получение контекстной информации текущего экземпляра.

查询 CloudBase 权限与用户配置

Запрос прав пользователей и конфигурации CloudBase, поддерживает запрос прав доступа к ресурсам (базы данных, облачные функции, хранилища и т.д.), список/детали ролей, список/детали пользователей приложения. Пример: - Запрос прав доступа к хранилищу: `action="getResourcePermission", resourceType="storage", resourceId="bucket-name"` 📌 Примечание на границе между бэкендами: перед вызовом используйте `envQuery(action="info", envId=...)`, чтобы посмотреть `EnvInfo.RuntimeBackends`. `resourceType="noSqlDatabase"` запрашивает правила коллекций CloudBase NoSQL, это независимый механизм от Row-Level Security (RLS) таблиц CloudBase PostgreSQL (PG) — если в одном окружении PG всё ещё используются коллекции NoSQL, результаты запроса для этих коллекций через данный инструмент **остаются действительными**. Для запроса RLS таблиц PG используйте `queryPgDatabase(action="sql", sql="SELECT * FROM pg_policies WHERE tablename=...")`. Данный инструмент не затрагивает права MySQL.

查询 PostgreSQL 上下文、对象、元数据或执行只读 SQL

Запрос к базе данных CloudBase PostgreSQL. Поддерживает: получение текущего контекста PG, перечисление объектов базы данных со схемами, чтение облегченных метаданных, проверку структуры отдельного объекта и выполнение SQL только для чтения.

查询 PostgreSQL 环境云存储能力和上传方案

Выполните запрос к возможностям облачного хранения в среде CloudBase PostgreSQL. Верните сводку возможностей bucket/config, схему запроса информации об объектах, а также реализацию загрузки через HTTP API или SDK; локальные файлы не считываются, большое количество подписанных URL по умолчанию не выводится.

查询 CloudBase 存储信息

Запрашивает информацию о CloudBase облачном хранилище: поддерживает просмотр файлов в каталоге, получение информации о файле, получение временной ссылки для скачивания и другие операции только на чтение. Возвращаемая информация о файле включает имя, размер, время изменения, ссылку для скачивания и т.д. Важно: `temporaryUrl` из `action=url` — это временная подписанная ссылка, срок действия определяется параметром `maxAge` (по умолчанию 1 час), не используйте её как постоянный публичный адрес. Инструмент также выводит `publicUrl` на основе `Storages[0].CdnDomain` из `DescribeEnvs`. ⚠️ Предупреждение: `publicUrl` доступен анонимно, только если ACL бакета настроен на публичное чтение (доступно всем пользователям); для бакета с приватным чтением/записью по умолчанию `publicUrl` вернёт 403 — в этом случае продолжайте использовать `temporaryUrl` или сначала через консоль/SDK сделайте целевой путь публично читаемым. 💡 Управление ACL бакета — используйте инструмент permissions: `queryPermissions(action="getResourcePermission", resourceType="storage", resourceId="bucket-name")` для запроса, `managePermissions(action="updateResourcePermission", resourceType="storage", resourceId="bucket-name", permission="READONLY")` для настройки. 📦 Окружение CloudBase PG / pgstore: бакеты, перечисленные в `DescribeEnvs.Storages[]`, относятся к старому NoSQL-бэкенду и НЕ равны бакету pgstore. Данный инструмент предназначен для просмотра обычного хранилища; при подготовке бакета для загрузки через PG-браузер убедитесь, что целевой бакет доступен для бэкенда pgstore, иначе вызов `app.storage.from().upload(...)` в браузере вернёт `STORAGE_BUCKET_NOT_FOUND` с ошибкой `PUT https://undefined/`.

查询并获取 CloudBase NoSQL 数据库数据记录

Запрашивает записи данных в NoSQL-базе CloudBase. Поддерживает фильтрацию по условиям, пагинацию, сортировку. Подходит для запросов данных и администрирования на стороне управления.

读取 CloudBase NoSQL 数据库结构

读取 CloudBase NoSQL 数据库集合与索引结构，支持列出集合、查看集合详情、列出索引以及检查索引是否存在。这个工具属于服务端管理工具，用于管理端查询数据库结构，不用于编写客户端代码。

云开发知识库检索

云开发知识库智能检索工具，支持向量查询 (vector)、固定技能文档 (skill)、OpenAPI 文档 (openapi) 和 CloudBase 官方文档 (docs) 查询。 强烈推荐始终优先使用固定技能文档 (skill)、OpenAPI 文档 (openapi) 或 CloudBase 官方文档 (docs) 模式进行检索，仅当固定文档无法覆盖你的问题时，再使用向量查询 (vector) 模式。 ⚠️ 重要：当 CloudBase skills 处于禁用状态或当前 IDE 不支持 skill 文件读取时，必须使用 searchKnowledgeBase(mode=skill, skillName=...) 来获取 CloudBase 技能文档内容，而不是尝试直接读取 skill 文件。直接读取可能返回 400 错误。示例： - 需要 auth-tool 指南时：searchKnowledgeBase(mode=skill, skillName=auth-tool) - 需要 auth-web 指南时：searchKnowledgeBase(mode=skill, skillName=auth-web) - 需要 cloudbase-agent 指南时：searchKnowledgeBase(mode=skill, skillName=cloudbase-agent) 固定技能文档 (skill) 查询当前支持 23 个固定文档，分别是： 文档名：ai-model-nodejs 文档介绍：Use this skill when developing Node.js backend services or CloudBase cloud functions (Express/Koa/NestJS, serverless, backend APIs) that need AI capabilities. Features text generation (generateText), streaming (streamText), AND image generation (generateImage) via @cloudbase/node-sdk ≥3.16.0. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended), DeepSeek (deepseek-v3.2 recommended), and hunyuan-image for images. This is the ONLY SDK that supports image generation. NOT for browser/Web apps (use ai-model-web) or WeChat Mini Program (use ai-model-wechat). 文档名：ai-model-web 文档介绍：Use this skill when developing browser/Web applications (React/Vue/Angular, static websites, SPAs) that need AI capabilities. Features text generation (generateText) and streaming (streamText) via @cloudbase/js-sdk. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended) and DeepSeek (deepseek-v3.2 recommended). NOT for Node.js backend (use ai-model-nodejs), WeChat Mini Program (use ai-model-wechat), or image generation (Node SDK only). 文档名：ai-model-wechat 文档介绍：Use this skill when developing WeChat Mini Programs (小程序, 企业微信小程序, wx.cloud-based apps) that need AI capabilities. Features text generation (generateText) and streaming (streamText) with callback support…

修改 CloudBase NoSQL 数据库数据记录

Изменить записи данных в базе данных CloudBase NoSQL. Поддерживает вставку, обновление (с операторами $set/$inc/$push и другими), удаление, upsert и другие операции. Подходит для записи данных и администрирования на стороне сервера. ⚠️ Запись на сервере не содержит _openid: если коллекция использует правила безопасности на уровне строк из клиентского SDK (@cloudbase/js-sdk или wx.cloud.database() из WeChat Mini Program), например doc._openid == auth.openid, при записи на сервере необходимо вручную добавить поле _openid, иначе клиент не сможет прочитать эти данные. ⚠️ Для частичного обновления вложенных полей используйте точечную нотацию, например `$set: {"shipping.city": "guangzhou"}`. Прямая передача вложенного объекта приведёт к перезаписи всего поля.

创建并管理 CloudBase NoSQL 数据库集合

Создаёт, удаляет и управляет коллекциями (collection) базы данных CloudBase NoSQL. Поддерживает создание новых коллекций, удаление существующих коллекций, а также добавление и удаление индексов через updateOptions.CreateIndexes / updateOptions.DropIndexes при вызове updateCollection. Если нужно создать новую коллекцию, используйте action=createCollection. Этот инструмент предназначен для серверного администрирования — для управления коллекциями и структурой индексов на стороне администратора, а не для написания клиентского кода.