前言¶
在 DeepSeek Harness（DSH）里扩展能力，常见做法是手写 dsh plugin add、查 GitHub、对照文档装技能包。百通侧已经维护了插件市场与技能库，但目录在浏览器里，和 Harness 会话、侧栏是两套界面。下面介绍的 @baitongserver/dsh-plugin-market（源码仓库 imyasonly/dsh-plugin-market）把「逛市场、搜技能、一键安装」收进 DSH：侧栏有「百通插件广场」面板，也可以直接对 Agent 说话完成搜索与安装。插件分类为客户端，兼容 DSH web 与桌面端，装完即用；私有化部署时改配置即可，无需重新编译。
这是什么¶
npm 包名是 @baitongserver/dsh-plugin-market（当前 README 对应版本 0.1.17，许可证 MIT）。维护者 imyasonly（作者 Yansen）。它在 Harness 内连接百通插件市场 API 与百通技能库，提供图形面板和一组 Agent 工具，用于搜索、安装、列出与卸载本机技能，并对市场里的 DSH 插件做一键安装与进度展示。
注意：安装时必须带 @baitongserver/ scope；npm 上无前缀的 dsh-plugin-market 属于另一个项目（veloce-ailab），不是本插件。
核心功能¶
侧栏「百通插件广场」¶
- 插件 / 技能双分类页，支持全部 / 已安装切换、类目筛选与排序。
- 面板头部显示当前插件版本号与通知图标；本机版本低于线上版本时红点提示可更新版本。
- 插件卡片可跳转 GitHub 详情、一键安装，并显示准备中 → 下载 → 完成的进度。
- 已安装视图只读展示本机插件与技能（来源 spec、版本、体积、更新时间），可卸载。
侧栏底部入口会在聊天区打开独立面板（可切换插件 / 技能），关闭后回到对话。
Agent 工具¶
| 工具 | 作用 |
|---|---|
baitong_plugin_search |
搜索百通插件市场的 DSH 插件 |
baitong_plugin_install |
安装指定插件（owner + name） |
baitong_skill_search |
搜索百通技能库（公共 + 团队） |
baitong_skill_install |
安装指定技能 |
baitong_skill_list |
列出本机已装技能 |
baitong_skill_uninstall |
卸载指定技能 |
Agent 被约束为只调用上述工具，不会在对话里打印 dsh plugin / npm / curl 命令。
其他能力¶
- 安装完成后可一键重启 DSH（桌面端应用级重启，web 端进程重启）。
- 图标支持站内相对路径与 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 装包前会与当前运行版本做 semver 匹配，不匹配会在执行 pnpm 之前拒装。
安装与启用¶
Web（CLI）
dsh plugin --profile web add @baitongserver/dsh-plugin-market
dsh web
dsh web 建议绑定 127.0.0.1，不要监听 0.0.0.0。
桌面端（GUI）
dsh plugin --profile desktop add @baitongserver/dsh-plugin-market
装完后需要重启 DSH 才生效：web 端重启进程并强制刷新浏览器；桌面端可点安装完成横幅上的「立即重启」，或从系统托盘完全退出后重新打开。
npm 与 github: 源
- npm（推荐）：安装预构建产物，无需额外配置。
github:源：安装时会在本机执行prepare构建，需在对应 profile 的pnpm-workspace.yaml中设置dangerouslyAllowAllBuilds: true后重新 add。用本插件安装其他插件时若遇同类拦截，插件会自动写入该项并重试。
典型用法¶
直接对 Agent 描述需求即可，例如：
- 找个能处理 PDF 的 skill
- 百通插件里搜一下浏览器自动化的
- 我装了哪些技能
- 把刚才那个卸载掉
- 装一下第一个插件
搜索完成后对话里会出现可点击卡片；也可在对话流里的插件卡片上直接点「安装」，进度就地显示，装完按横幅提示重启。
配置与私有化¶
设置页中插件配置 id 为 baitong-plugin-market（路径：设置 → 插件 → 插件配置）。保存后写入 $DSH_HOME/baitong-market.json，立即生效。
| 项 | 说明 |
|---|---|
apiBase |
百通 API 根地址（不含 /api），用于私有化部署 |
skillsDir |
技能安装目录，默认 $DSH_HOME/skills |
timeoutMs |
上游请求超时（毫秒），默认 20000 |
maxResults |
搜索结果上限，默认 12 |
userAgent |
请求 UA |
apiBase 覆盖优先级（高 → 低）：环境变量 BAITONG_API_BASE → 设置页保存的文件 → ~/.dsh/profiles/<profile>/cordis.patch.yml（GUI 启动、支持热重载）→ 仓库内 cordis.patch.local.yml + --patch → 默认 https://s.1100111.cn/baitong_ai。
GUI 私有化示例（写在 profile 层）：
# ~/.dsh/profiles/desktop/cordis.patch.yml
- id: baitong-plugin-market
name: "@baitongserver/dsh-plugin-market"
config:
apiBase: https://your-private-host/baitong_ai
临时换地址：
BAITONG_API_BASE=https://your-private-host/baitong_ai dsh web
确认当前生效的 apiBase：
curl -X POST http://127.0.0.1:<port>/baitong-market -d '{"method":"pluginInstallStatus"}'
适用场景与注意¶
适合已经在用 DSH、并希望从百通插件市场与技能库扩展能力、又希望少切换浏览器的开发者。社区目录页：skillhub.cn 插件条目；DSH 插件生态理念是「一切皆插件」，该目录站与 DeepSeek / 幻方无官方从属关系，本文介绍的百通市场插件同样不代表官方应用商店。
安装第三方插件等于把第三方代码装进你的 profile，插件以当前 dsh 进程权限运行；安装前应查看源码与许可证（本仓库 MIT）。自定义 apiBase 应只指向你信任的服务。网络走使用者自己的系统配置，插件不内置代理；上游请求默认 20s 超时。
安全方面，安装计划会拒绝带 --force 的方案、仅接受 web profile，并对来源做校验；安装前会预检 loader id 冲突；技能 zip 解压防路径穿越且须含 SKILL.md，插件不执行技能包内代码。
常见问题：点安装后先显示「正在准备安装…」属正常，勿重复点击；装完未生效多为未重启 DSH；桌面端「立即重启」无效时需从系统托盘完全退出再开。
结尾¶
@baitongserver/dsh-plugin-market 把百通插件市场与技能库接到 Harness 侧栏与 Agent 工具链里，搜索、安装、已装列表与卸载可以在同一套界面完成。需要细节、配置与故障排查时，以仓库 README 为准：GitHub — imyasonly/dsh-plugin-market。
