# @busabase/dsh-plugin 中文文档

规范地址：https://npmcn.com/package/%40busabase/dsh-plugin/

版本：0\.1\.23
npm 元数据更新时间：2026-10-31T20:01:13.119Z
中文译文更新时间：2026-11-08T20:23:28.082Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40busabase/dsh-plugin
原文对照：https://npmcn.com/package/%40busabase/dsh-plugin/?lang=original
项目主页：https://github.com/busabase/busabase-dsh-plugin#readme
源码仓库：https://github.com/busabase/busabase-dsh-plugin

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.8 MB，59 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.18\.0
- 运行依赖：9 个
- peer 依赖：react ^18\.3\.1，@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-skill \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-tools \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-credentials \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-system-prompt \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-tool \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-host-webserver \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-slots \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-layout \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-api-session-controller \>=0\.2\.1-rc\.2 \<0\.3\.0-0，@deepseek-ai/dsh-client-ui-conversation \>=0\.2\.1-rc\.2 \<0\.3\.0-0
- 首次发布：2026-09-03T03:56:45.593Z
- 最新版本发布：2026-10-31T20:01:12.793Z
- 近 30 天下载量：3608（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Busabase MCP、卡片和DeepSeek Harness现场检查员

## 安装

```sh
npm install @busabase/dsh-plugin
```

也可以使用：`pnpm add @busabase/dsh-plugin`、`yarn add @busabase/dsh-plugin`、`bun add @busabase/dsh-plugin`

## README

[English](https://npmcn.com/package/%40busabase/dsh-plugin/README.md) | 中文

# 给 DeepSeek Harness 插上知识库和数据库

`@busabase/dsh-plugin` 把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 接入 [Busabase](https://busabase.com/)，让 Agent 能读取可信知识、处理结构化数据，并把每一次写入提案交给人审阅。

它让 Agent 获得超越单次对话的长期上下文，但不会让 Agent 静默改写你的事实来源。

## 实际效果

观看 DeepSeek Harness 使用插件创建 CRM AirApp、提交变更供审阅，并在 Busabase 中打开结果。

[观看静音指南视频](https://npmcn.com/package/%40busabase/dsh-plugin/assets/busabase-dsh-plugin-guide.mp4)

## 快速开始

### 环境要求

-   DeepSeek Harness 0.2.1-rc.2 或之后的 0.2.x 版本（`npx @deepseek-ai/dsh` 默认用最新版）；
-   Node.js `>=24.18.0`；
-   `PATH` 中可用 pnpm。

安装前不需要启动本地 Busabase。本地模式会按需启动 `busabase@latest`，或复用健康的 Busabase Personal Desktop 或本地服务；Cloud 模式会通过浏览器 OAuth 连接托管服务。

### 1\. 安装插件

```bash
npx @deepseek-ai/dsh plugin --profile web add @busabase/dsh-plugin
```

安装包会自动激活 Host 和 Web 两端。经过审阅的 Skills 已经包含在 npm 包中，因此安装不需要授权生命周期脚本。安装验证、更新、删除和旧版本说明见 [安装与管理 npm Bundle](https://npmcn.com/package/%40busabase/dsh-plugin/DEVELOPMENT.zh.md#%E5%AE%89%E8%A3%85%E4%B8%8E%E7%AE%A1%E7%90%86-npm-bundle)。

DeepSeek Harness 用 pnpm 安装插件，pnpm 会跳过 `minimumReleaseAge` 观察期内新发布的版本。新版本发布后的大约一天内，上面的命令可能装到旧版本。在包名后加上版本号（`@busabase/dsh-plugin@<版本>`）即可立刻安装最新版。Desktop 中在 **Plugins → Add plugin** 里输入同样的写法。

### 2\. 选择本地或 Cloud

-   **本地**是零配置默认模式，适合本机数据、免账号使用或 Busabase Personal Desktop。
-   **Cloud**适合已有 Busabase 账号、团队工作区和多设备访问。把以下列表项加入 `$DSH_HOME/profiles/web/cordis.patch.yml`；默认路径是 `~/.dsh/profiles/web/cordis.patch.yml`：

```yaml
- id: busabase
  config:
    baseUrl: https://busabase.com
    serverName: busabase
```

如果文件中已有其他 row，请追加此项。不要把凭据写进文件；浏览器登录后，DeepSeek Harness 会把 OAuth 授权保存在凭据存储中。更新、验证、切换模式和故障处理见[完整的本地与 Cloud 设置指南](https://busabase.com/docs/deepseek-harness-plugin)。

### 3\. 启动 DeepSeek Harness

```bash
npx @deepseek-ai/dsh --profile web
```

如果已经全局安装 `dsh`，可以用 `dsh` 替换 `npx @deepseek-ai/dsh`。打开 `http://127.0.0.1:3080/`。本地模式会等到实际需要时再启动 Busabase；Cloud 模式首次启动会打开浏览器 OAuth，之后复用已保存的授权。

### 4\. 试一个任务

```text
创建一个客户跟进 Base，包含公司、联系人、阶段、预计金额、负责人、
下一步动作和跟进日期。把结构提交给我审阅。
```

本地模式下，如果还看不到完整 MCP 工具，请先调用 `busabase_start`；Cloud 模式先完成浏览器授权。Agent 会先检查现有工作区，再通过 ChangeRequest 提出 Base 结构。你查看差异并决定是否批准和合并；Cloud 提案请通过返回的 Busabase 正式链接审核。

## 为什么使用它

聊天上下文适合完成当前任务，却不适合作为长期数据系统。重要结论难以稳定复用，业务对象缺少结构，而 Agent 的一次误判也可能在被发现前污染文档或数据库。

这个插件为 DeepSeek Harness 增加四种能力：

-   **可信知识：** 搜索已批准的 Docs、Files、Bases、Records、评论和关联对象；
-   **结构化工作：** 把自然语言需求变成 Bases、Forms、AirApps 和记录的修改提案；
-   **可用的结果：** 把 Busabase 实体显示成会话卡片和实时 Inspector，而不是大段 JSON；
-   **人的控制权：** 把 Agent 写权限限制在 `changeRequest`，并默认要求用户重新确认每个审阅动作。

```text
DeepSeek Harness 负责理解任务与调用工具
                ↓
@busabase/dsh-plugin 负责把 Agent 接入 Busabase
                ↓
Busabase 负责保存已批准的知识和结构化数据
```

## 常见用法

-   **团队知识：** 从已批准的产品文档、会议决策、研究资料和 FAQ 中检索答案，并返回可定位的来源。
-   **研究整理：** 从访谈中提取证据、主题和优先级，先审阅提案记录，再决定是否合并。
-   **业务数据库：** 用自然语言描述 CRM、项目跟踪、库存、招聘流程或运营台账。
-   **内容运营：** 准备可审阅的文章、社交媒体内容、Newsletter、SEO 页面和本地化记录。
-   **数据清洗：** 批量提出去重、标签、补全、分类、匹配或翻译建议。
-   **工作区应用：** 围绕 Busabase 正式数据创建 Form 和 AirApp，并在 Inspector 中预览。

例如：

```text
查一下知识库中最新的企业版数据保留策略，给我来源文档，
并为存在冲突的 FAQ 记录提出修订。
```

Agent 可以读取已批准的策略并准备修订，但不能批准自己的修改。

## 只提议、不合并的设计

```text
有直接写权限的 Agent
Agent ──直接写入──► 正式数据
                    错误已经生效

本插件（权限封顶在 changeRequest）
Agent ──提出修改──► ChangeRequest ──人类审阅──► 正式数据
                    错误仍只是提案
```

这件事 Busabase 是按凭据逐个决定的：调用方有写权限就当场合并，没有才等人审阅。本插件是刻意把模型压到较低的那一档。

MCP 连接权限固定在 `changeRequest`。Busabase 会拒绝 Agent 发起的批准、拒绝、关闭和合并操作，也不会让 `autoMerge: true` 绕过审阅。Inspector 中的审阅动作默认要求用户重新明确确认，工作区里存储的内容也只会被视为数据，而不是新的指令。高级配置可以关闭确认提示，但这不会提高服务端强制执行的 Agent 权限。

## 配置

默认配置会连接 `http://localhost:15419`，按需启动或复用 loopback 服务，启用 Inspector 实时刷新，并要求用户确认审阅动作。

如需使用其他地址、调整插件加载顺序，或修改服务与刷新行为，请查看 [完整配置参考](https://npmcn.com/package/%40busabase/dsh-plugin/DEVELOPMENT.zh.md#%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E5%8F%82%E8%80%83)。

### 连接 Busabase Cloud

按 `id` 覆盖 Bundle row，并把 `baseUrl` 设置为 `https://` 的 Busabase Cloud 地址（根域名部署可配合 `spaceId`，或直接使用工作区子域名），即可连接到云端而不是本地服务：

```yaml
- id: busabase
  config:
    baseUrl: https://busabase.com
    serverName: busabase
```

插件不会管理或启动远程服务器。首次加载远程插件时会打开系统浏览器完成标准 OAuth 登录；DeepSeek Harness 通过其凭据存储保存生成的令牌，而不是写入本插件的配置。MCP 连接仍会固定发送 `changeRequest` 权限上限。当前版本中，Inspector 的审阅、合并、实时刷新以及 Base/AirApp 内嵌预览仍仅支持本地模式：请使用 Inspector 展示的 Busabase Cloud 正式链接，在云端查看、审阅与合并。

## 当前边界

-   默认面向单个本地 Busabase 工作区；
-   非 loopback `baseUrl` 在 `auto` 模式下会被视为外部服务，插件不会尝试启动它；
-   连接非 loopback 的 `https://` `baseUrl` 时使用基于浏览器的 OAuth，而不是本地中继，且 Inspector 的审阅、合并和实时刷新仍仅支持本地模式；
-   `busabase_start` 启动服务并重新连接后，完整 MCP 工具才会可用（仅本地模式）；
-   Agent 可以提出修改，但不能执行最终审阅和合并；
-   Base 与 AirApp 预览需要正确的同源和 embed origin 配置；
-   关闭 iframe 后，实体元数据和“Open in Busabase”入口仍然可用。

## 文档

-   [开发者指南](https://npmcn.com/package/%40busabase/dsh-plugin/DEVELOPMENT.zh.md)：源码设置、架构、配置、安全内部实现、构建、打包和 E2E 测试；
-   [Busabase 官网](https://busabase.com/)；
-   [Busabase 开源仓库](https://github.com/busabase/busabase)；
-   [Busabase Skills 与 MCP 接入](https://github.com/busabase/skills)；
-   [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。

## 常见问题

### @busabase/dsh-plugin 是什么？

Busabase MCP、卡片和DeepSeek Harness现场检查员

### 如何安装 @busabase/dsh-plugin？

在项目目录运行 npm install @busabase/dsh-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.3\.1）、@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-skill（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-tools（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-credentials（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-system-prompt（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-tool（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-host-webserver（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-slots（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-layout（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-api-session-controller（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）、@deepseek-ai/dsh-client-ui-conversation（\>=0\.2\.1-rc\.2 \<0\.3\.0-0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @busabase/dsh-plugin 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @busabase/dsh-plugin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @busabase/dsh-plugin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @busabase/dsh-plugin 可以商用吗？

@busabase/dsh-plugin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @busabase/dsh-plugin 的下载量有多少？

根据 npm 官方下载统计，@busabase/dsh-plugin 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,608 次，日均约 120 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @busabase/dsh-plugin 还在维护吗？

最新版本 0\.1\.23 发布于 2026/11/01（8 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。