# @baitongserver/dsh-plugin-market 中文文档

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

版本：0\.1\.19
npm 元数据更新时间：2026-10-28T03:12:06.555Z
中文译文更新时间：2026-11-07T17:29:07.316Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：477 kB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：react ^18\.2\.0，@deepseek-ai/cordis \*，@deepseek-ai/dsh-tools ^0\.1\.1-rc\.2 \|\| ^0\.2\.0-rc\.1，@deepseek-ai/schemastery \*
- 首次发布：2026-10-16T02:02:37.161Z
- 最新版本发布：2026-10-28T03:12:06.348Z
- 近 30 天下载量：3629（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

百通插件广场：在 DeepSeek Harness 中浏览、搜索并安装百通插件市场的 DSH 插件与百通技能库技能

## 安装

```sh
npm install @baitongserver/dsh-plugin-market
```

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

## README

# @baitongserver/dsh-plugin-market

在 **DeepSeek Harness（DSH）** 中浏览、搜索并安装**百通插件市场的 DSH 插件**与**百通技能库技能** —— 侧栏一个「百通插件广场」面板，或直接对 Agent 说话。

-   兼容 DSH **web 与桌面端（GUI）**，装完即用
-   支持私有化部署，改配置即可，无需重新编译（见[配置](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E9%85%8D%E7%BD%AE)）

源码：[github.com/imyasonly/dsh-plugin-market](https://github.com/imyasonly/dsh-plugin-market) · 遇到问题请提 [issue](https://github.com/imyasonly/dsh-plugin-market/issues)

## 目录

-   [功能](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E5%8A%9F%E8%83%BD)
-   [环境要求](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E7%8E%AF%E5%A2%83%E8%A6%81%E6%B1%82)
-   [安装](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E5%AE%89%E8%A3%85)
-   [使用](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E4%BD%BF%E7%94%A8)
-   [配置](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E9%85%8D%E7%BD%AE)
-   [数据与网络](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E6%95%B0%E6%8D%AE%E4%B8%8E%E7%BD%91%E7%BB%9C)
-   [故障排查](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E6%95%85%E9%9A%9C%E6%8E%92%E6%9F%A5)
-   [安全](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E5%AE%89%E5%85%A8)
-   [开发](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E5%BC%80%E5%8F%91)
-   [许可证](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E8%AE%B8%E5%8F%AF%E8%AF%81)

* * *

## 功能

**侧栏「百通插件广场」面板**

-   插件 / 技能双分类页，全部 / 已安装切换、类目筛选、排序
-   面板头部显示**当前插件版本号**与通知喇叭图标；当前版本低于线上版本时点亮红点并提示可更新到的版本
-   插件卡片：详情直达 GitHub、一键安装、实时进度（准备中 → 下载 → 完成）
-   已安装视图：本机只读预览已安装插件与技能（来源 spec、版本、体积、更新时间），可卸载

**Agent 工具**

| 工具 | 作用 |
| --- | --- |
| `baitong_plugin_search` | 搜索百通插件市场的 DSH 插件 |
| `baitong_plugin_install` | 安装指定插件（`owner` + `name`） |
| `baitong_skill_search` | 搜索百通技能库（公共 + 团队） |
| `baitong_skill_install` | 安装指定技能 |
| `baitong_skill_list` | 列出本机已装技能 |
| `baitong_skill_uninstall` | 卸载指定技能 |

**其他**

-   安装完成后可**一键重启 DSH**（桌面端走应用级重启，web 端走进程重启）
-   图标支持站内相对路径（如 `/baitong_ai/static/skill-icons/icon-02.png`）与 https 外链， 统一经本机图标代理加载（离线/内网不裂图）；加载失败降级为首字色块
-   界面跟随 Harness 的中英文语言设置

* * *

## 环境要求

-   DeepSeek Harness（web 或桌面端）
-   Node.js ≥ 22（由 DSH 提供）

`@deepseek-ai/cordis`、`@deepseek-ai/dsh-tools`、`react` 等均由 DSH 提供，**无需自行安装**。

这些依赖在 `peerDependencies` 里写成**发布轨道范围**（`@deepseek-ai/dsh-tools` 是 `^0.1.1-rc.2 || ^0.2.0-rc.1`），而不是钉死单个版本 —— DSH 在装包前会把该范围与 **正在运行的 DSH 版本**做匹配（`semver.satisfies(runtime, range, { includePrerelease: true })`）， 不匹配就在跑 pnpm 之前直接拒装。所以 DSH 跨到新的 0.x 线时，本插件需要跟着补一版范围。

* * *

## 安装

**Web（CLI）**

```sh
dsh plugin --profile web add @baitongserver/dsh-plugin-market
dsh web
```

**桌面端（GUI）**

```sh
dsh plugin --profile desktop add @baitongserver/dsh-plugin-market
```

装完**需要重启 DSH** 才生效。web 端重启进程并强制刷新浏览器；桌面端可点安装完成横幅上的「立即重启」，或从系统托盘完全退出后重新打开。

**几条容易踩的坑**

-   ⚠️ **必须带 `@baitongserver/` scope**。npm 上无前缀名的 `dsh-plugin-market` 是**另一个项目**（`veloce-ailab`），不是本插件。
-   `dsh web` 请绑定 `127.0.0.1`，不要监听 `0.0.0.0`。
-   从源码本地安装（`link:` 方式），以及构建 / 自检 / 发布流程，见 [开发](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/#readme-%E5%BC%80%E5%8F%91)。

**npm 与 `github:` 两种源都支持**

-   **npm（推荐）**：装的是预构建产物，无需任何额外配置。
    
-   **`github:` 源**：安装时会在本机现场构建（`prepare` 脚本），所以目标 profile 要先允许依赖的构建脚本：
    
    ```yaml
    # ~/.dsh/profiles/<profile>/pnpm-workspace.yaml
    dangerouslyAllowAllBuilds: true
    ```
    
    放行后重新执行 add 即可。用本插件安装**其他**插件时若遇到同类拦截，会自动写入这一项并重试，无需手动配置。
    

* * *

## 使用

直接对 Agent 说即可，例如：

-   找个能处理 PDF 的 skill
-   百通插件里搜一下浏览器自动化的
-   我装了哪些技能
-   把刚才那个卸载掉
-   装一下第一个插件

搜索完成后，对话中会出现可点击卡片；点开详情后再安装。**插件卡片也可以在对话流里直接点「安装」**，进度就地显示，装完按横幅提示「立即重启」。

侧栏底部的\*\*「百通插件广场」\*\*会在聊天区打开独立面板（可切换 插件 / 技能），面板盖在会话列上，关掉后直接回到对话。

> Agent 已被约束为只调用本插件的工具，不会打印 `dsh plugin` / `npm` / `curl` 命令。

* * *

## 配置

设置页中本插件的配置项 id 为 **`baitong-plugin-market`**（路径：设置 → 插件 → 插件配置）：

| 项 | 说明 |
| --- | --- |
| `apiBase` | 百通 API 根地址（不含 `/api`），用于指向私有化部署 |
| `skillsDir` | 技能安装目录，默认 `$DSH_HOME/skills` |
| `timeoutMs` | 上游请求超时（毫秒），默认 `20000` |
| `maxResults` | 搜索结果上限，默认 `12` |
| `userAgent` | 请求 UA |

保存后立即生效。配置写入 `$DSH_HOME/baitong-market.json`，不会进入 git。

### apiBase 覆盖链（高 → 低）

| 优先级 | 来源 | 适用场景 |
| --- | --- | --- |
| 1 | 环境变量 `BAITONG_API_BASE` | CLI 启动，最高 |
| 2 | 设置页保存 → `$DSH_HOME/baitong-market.json` | GUI，⚠️ 会覆盖下面几项 |
| 3 | `~/.dsh/profiles/<profile>/cordis.patch.yml` | **GUI 启动唯一入口**（自动加载 + 支持热重载） |
| 4 | 仓库内 `cordis.patch.local.yml` + `--patch` | 本地联调，不随包发布 |
| 5 | 默认值 `https://s.1100111.cn/baitong_ai`（生产；0.1.9–0.1.11 曾临时指向测试环境 `ts.`） | 无需配置 |

### 私有化部署示例

GUI 启动无法传 `--patch`，配置写在 profile 层（改这层支持热重载，不必重启）：

```yaml
# ~/.dsh/profiles/desktop/cordis.patch.yml
- id: baitong-plugin-market
  name: "@baitongserver/dsh-plugin-market"
  config:
    apiBase: https://your-private-host/baitong_ai
```

> patch 的非 insert 项**必须带 `id`**，否则报 `patch: id is required for non-insert patches`。

### 临时换地址（不改文件）

```sh
BAITONG_API_BASE=https://your-private-host/baitong_ai dsh web
```

地址可写裸 `host:port`（自动补 `http://`），尾部斜杠自动去除。

### 确认当前生效地址

不确定连的是哪个地址时，直接查诊断接口（返回里的 `apiBase` 就是实际生效值）：

```sh
curl -X POST http://127.0.0.1:<port>/baitong-market -d '{"method":"pluginInstallStatus"}'
```

* * *

## 数据与网络

| 用途 | 请求 |
| --- | --- |
| 插件目录 / 类目 | `GET {apiBase}/api/bt/dsh/plugins`、`/categories` |
| 插件安装计划 | `GET {apiBase}/api/bt/dsh/plugins/{owner}/{name}/install-plan` |
| 技能搜索 / 详情 | `GET {apiBase}/api/v1/search`、`/api/v1/skills/{slug}` |
| 技能安装包 | `GET {apiBase}/api/v1/download?slug=`（302 → COS 预签名） |
| 版本自检 | `GET registry.npmjs.org` / `registry.npmmirror.com` 的 `@baitongserver/dsh-plugin-market/latest`（成功缓存 1h，失败 5min） |
| 本机面板 | `/baitong-market`（安装进度轮询、图标代理、同源重启） |

-   上游请求有超时（默认 20s），超时与网络失败会给出可读的错误原因
-   网络走**使用者自己的系统配置**，插件不内置任何代理
-   版本自检**只读且不阻塞**：查不到线上版本时徽标只显示当前版本，不报错、不影响任何功能
-   自定义 `apiBase` 应只指向你信任的服务

* * *

## 故障排查

| 现象 | 处理 |
| --- | --- |
| 点安装后要等一会儿才动 | 正常。服务端要先拉安装计划并做依赖冲突预检，期间显示「正在准备安装…」。**不要重复点击** |
| 提示「已有安装任务在进行中」 | 已有安装任务在跑，看进度条即可；重复点击不会加快 |
| 点「立即重启」没反应 / 提示无法自动重启 | 桌面端从**系统托盘**完全退出 DSH 后重开（只关窗口不够，托盘常驻） |
| 安装失败：`fetch failed` | 网络问题。查诊断接口的 `net.proxy`（进程实际看到的代理环境）与 `apiBase` |
| 装完了但没生效 | 插件需要重启 DSH 才加载 |
| 找不到广场入口 | 点侧栏底部「百通插件广场」；重启 DSH 并强制刷新浏览器 |
| 私有化部署连不上 | 用上面的诊断接口确认 `apiBase` 生效值，再逐层核对覆盖链 |
| 面板停在加载中 | 确认面板是最新构建产物，然后重启 DSH 并强制刷新 |

* * *

## 安全

-   **install-plan 校验链**：拒绝带 `--force` 的安装计划、只接受 `web` profile，并按插件计划兼容 npm、github、git、URL、file/link 等 DSH 安装规格；仅对 pinned GitHub 计划校验仓库与 `headSha`
-   **名称白名单**：profile 名与插件包名均按正则校验（`/^[a-z0-9][a-z0-9._-]{0,63}$/i`），防路径穿越
-   **loader id 冲突预检**：安装前检查目标包 `cordis.patch.yml` 的 loader id 是否与已装插件冲突，避免装完起不来
-   **技能包安全**：zip 解压拒绝路径穿越（zip-slip），必须含 `SKILL.md`；插件不执行技能包内的代码
-   安装第三方插件等于把第三方代码装进你的 profile，**请只安装信任来源**

* * *

## 开发

构建、自检与发布流程见 [DEVELOPMENT.md](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/DEVELOPMENT.md)。

* * *

## 许可证

[MIT](https://npmcn.com/package/%40baitongserver/dsh-plugin-market/LICENSE) © Yansen

「百通」「DeepSeek」「DeepSeek Harness」等名称归其各自所有者，本项目与它们没有从属或背书关系。

## 常见问题

### @baitongserver/dsh-plugin-market 是什么？

百通插件广场：在 DeepSeek Harness 中浏览、搜索并安装百通插件市场的 DSH 插件与百通技能库技能

### 如何安装 @baitongserver/dsh-plugin-market？

在项目目录运行 npm install @baitongserver/dsh-plugin-market，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）、@deepseek-ai/cordis（\*）、@deepseek-ai/dsh-tools（^0\.1\.1-rc\.2 \|\| ^0\.2\.0-rc\.1）、@deepseek-ai/schemastery（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @baitongserver/dsh-plugin-market 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/baitongserver\_\_dsh-plugin-market 是否存在。

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

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

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

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

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

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

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

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

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

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