CloudBase 插件支持 DeepSeek Harness（简称 DSH）。通过该插件与 MCP 工具，用户可以在 DSH 会话中直接建表、上传文件、配置认证并完成前后端一键部署。
为什么是 DeepSeek Harness
DSH 是 DeepSeek 的桌面端 Agent 应用，用什么模型由用户自己定。
在日常开发中，用户常遇到一个痛点：模型能快速编写出全栈代码，但运行与部署这些代码却需要多次手动配置。例如，数据库需要登录控制台建表，文件需要手动上传，前端静态资源与后端代码需要手动部署。一旦离开对话，就会中断开发节奏。
@cloudbase/dsh-plugin 插件将 CloudBase 后端能力引入了 DSH 运行环境。大模型可直接调用 CloudBase 的数据库、云存储和云托管等接口。用户在对话中即可完成全栈应用的构建与部署，无需切换窗口。
两种安装形态
CloudBase 插件的 npm 包名是 @cloudbase/dsh-plugin，当前版本是 0.2.3。该插件已被社区插件目录 awesome-dsh-plugin 收录。插件兼容 DSH >=0.1.0-rc.6 <0.3.0（已在 DSH 0.2.0-rc.2 验证），要求 Node.js 版本 >=18。
该插件提供 Web UI 与 Headless 两种运行形态。
1. Web UI 形态（推荐）
Web UI 形态提供 MCP 工具，并在聊天会话中渲染工具交互卡片。
可通过以 下一键脚本安装：
curl -fsSL https://raw.githubusercontent.com/TencentCloudBase/CloudBase-AI-Toolkit/main/dsh-plugin/scripts/install.sh | bash
或手动安装：
dsh plugin --profile web add @cloudbase/dsh-plugin
由于 pnpm ≥9 默认禁止依赖包执行 install 脚本（会导致 protobufjs 构建失败），手动安装要先改一下配置（上面的一键脚本已经包含了这一步）：
echo "enable-scripts=true" >> ~/.dsh/profiles/web/.npmrc
(cd ~/.dsh/profiles/web && pnpm install)
如果装完在界面上看不到插件卡片，再从 DSH 安装目录重建一次 web 前端，然后重启 DSH：
pnpm --dir "$(dirname "$(dirname "$(command -v dsh)")")" run build:web || true
启动命令：
dsh --profile web
2. 只要 MCP 工具（Headless）
若不需要前端卡片，可使用 Headless 形态。该形态不需要前端构建：
dsh plugin --profile headless add @cloudbase/dsh-plugin
启动并测试工具加载：
dsh --profile headless "列出所有 mcp__cloudbase__ 工具"
只想用 MCP 工具的话，其他客户端也能直接接远端 MCP。选一下拿配置：
该客户端已内置 CloudBase，接入方式以官方市场 / 连接器为准，站点跟随你的登录态，无需在此选 择。
配置你的 AI 工具以连接 CloudBase 能力 支持本地与远端两种连接方式，详见 连接方式。
步骤 1：安装 / 配置 CloudBase
一键脚本安装（推荐）
curl -fsSL https://raw.githubusercontent.com/TencentCloudBase/CloudBase-AI-Toolkit/main/dsh-plugin/scripts/install.sh | bash手动安装（Web UI）
dsh plugin --profile web add @cloudbase/dsh-plugin只要 MCP 工具（Headless）
dsh plugin --profile headless add @cloudbase/dsh-plugin步骤 2：和 AI 对话
在 AI 对话中依次输入以下内容:
阅读 https://docs.cloudbase.net/skill.md，帮我介绍可以做什么使用 CloudBase Skills： 在 CloudBase 关系型数据库中执行 SQL 查询和更新操作装好之后怎么用
装完打开 DSH 左侧的「插件」页，能看到 @cloudbase/dsh-plugin 已经就位。它下面列着两个组件，都显示「运行中」：
@deepseek-ai/dsh-mcp-client—— DSH 自带的 MCP 客户端桥，负责连上 MCP server 并把工具注册给模型@cloudbase/dsh-plugin—— CloudBase 插件本体
第一次连接 CloudBase 需要登录一次（见下一节）。之后新开一个会话，直接说你要做什么就行：
- 「帮我在这个项目里建一张 PostgreSQL 表，存用户信息」
- 「把这个前端部署到静态托管，把访问地址给我」
- 「查一下当前环境今天的用量」
写入类操作不会静默跑掉：它们会回到会话里，由 DSH 弹出审批，你确认之后模型才会执行。插件页上的开关可以随时暂停插件，不需要了就点「卸载」。
免 API Key 的设备码登录
该插件不要求在本地或环境变量中配置 CLOUDBASE_API_KEY 或密钥，从而避免了硬编码密钥导致凭据泄露的问题。
插件不传递环境变量和 API Key，使用 cloudbase-mcp 的设备码（Device Code）授权流程进行登录：
-
复用本地登录态：若本地已有
tcb login登录态，插件会自动识别并复用。 -
对话一键登录：若本地无登录态，直接对 DSH 模型发送指令：
调用
mcp__cloudbase__auth，使用action=start_auth且authMode=device，获取验证链接。在浏览器中打开返回的验证 URL 授权一次，登录态即可保存在本机。
-
切换环境：登录后，通过模型发送
mcp__cloudbase__auth并指定action=set_env即可选择环境，后续工具会自动使用该环境。
注意：请勿配置 CLOUDBASE_API_KEY。配置无效的 API Key 会阻断设备码登录流程。
技术细节：一个插件，一套能力
除 cordis 和 react 两个 peer 依赖外，该插件运行时 0 依赖。插件提供 1 个父 Skill，内部包含 31 个参考 Skill，并配置 38 个 MCP 工具。
功能细节如下：
| 能力维度 | 数量 / 标识 | 说明 |
|---|---|---|
| Skill 架构 | 1 个父 Skill (cloudbase) | 打包 31 个 Reference Skill，覆盖文档型数据库（NoSQL）、PostgreSQL、认证、存储、云函数、云托管、Web 与小程序开发、运维巡检等。 |
| MCP 工具桥 | 38 个工具 (mcp__cloudbase__*) | 注册统一前缀工具，对应底层 @cloudbase/cloudbase-mcp@latest（当前版本 2.34.8）工具集，由模型调用。 |
| DataTableCard | 结果表格卡片 | 当模型调用 queryPgDatabase、queryMysqlDatabase 或 readNoSqlDatabaseContent 时渲染表格，支持分页、排序、复制 JSON 与导出 CSV。 |
| DeployPreviewCard | 部署预览卡片 | manageHosting 上传产物后在 iframe 中展示真实域名和打开按钮。 |
| 交付物行 | 交付物呈现 | 会话尾部展示产物本地路径与公网域名。 |
机制与安全规范
- 写操作走 DSH 的审批：所有写入操作（SQL 写入、上传、删除）均注入当前会话。必须获得 DSH 的显式 Approval 授权后才由模型执行，UI 卡片不绕过权限模型。
- 凭据只存在本机：敏感凭据保存在本地 CLI 登录态中，或者保存在
~/.dsh/.credentials.yaml（权限为600，仅当前用户可读写）。插件不上传或泄露密钥。 - 读操作只访问你自己的环境：读操作仅访问用户绑定的 CloudBase 环境，插件本身不进行跨环境数据聚合或分析。
下一步
- CloudBase-AI-Toolkit 概述 — 了解整体工具集能力
- CloudBase 插件 GitHub 仓库 — 获取最新代码与一键安装脚本
- NPM 官方包主页 — 查看
@cloudbase/dsh-plugin包发布详情
