DSH 插件盒子

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。随着社区插件数量增加，管理这些插件——包括查找、阅读介绍、获取安装命令——变得较为繁琐。DSH 插件盒子是一个安装在 Harness 网页客户端内的插件，它充当了一个插件市场。

该插件通过连接社区维护的 Oh-My-DSH 目录，在 Web 界面中展示 GitHub 上的插件，提供中文简介、按 star 排序、分类过滤和搜索功能，并允许用户一键复制官方安装命令。

功能概览¶

DSH 插件盒子提供以下核心能力：

浏览与搜索：展示 GitHub 上的社区插件，支持按插件名、作者、仓库全名、中文简介或英文描述进行搜索。
信息呈现：提供中文简介、许可证信息，并按 GitHub star 数从高到低排序。
目录管理：从 Oh-My-DSH 拉取最新插件清单，支持分类过滤。
安装辅助：点击即可复制官方安装命令，不直接执行安装。
本地缓存：刷新后的目录数据会保存在浏览器的 localStorage 中，重启客户端后依然可用。

安装¶

在终端执行以下命令安装插件盒子。必须指定 --profile web 参数，因为该插件运行在网页客户端环境中。

dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box

如果是从 Harness 源码目录启动，请使用：

pnpm dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box

安装完成后，必须完全退出并重新打开 DeepSeek Harness 的网页客户端（或桌面客户端），才能在界面中看到插件盒子。

使用方法¶

打开面板¶

安装成功后，可以通过以下两种方式打开插件盒子面板：

侧栏入口：点击左侧栏底部或设置按钮附近的「插件盒子」（折叠状态下为蓝鲸盒子图标）。
设置入口：打开「设置」→ 左侧选择「插件」→ 顶部点击「插件盒子」。

面板顶部会显示当前收录的插件数量及最后一次刷新目录的时间。

浏览与筛选¶

排序：列表默认按 GitHub star 数从高到低排列。
搜索：在搜索框输入关键词，可匹配插件名、作者、仓库全名、中文简介及英文描述。
分类：点击分类芯片可过滤当前列表，点击「全部」显示完整清单。

安装社区插件¶

插件盒子只负责复制命令，不会在你的机器上直接安装插件。

在插件卡片上点击 「+ 复制安装命令」。
将复制的命令粘贴到终端执行。
命令格式通常为 dsh plugin --profile web add github:<作者>/<仓库>。
执行完命令后，完全退出并重新打开客户端，新插件才会生效。

如果对方插件仓库是 TypeScript 源码，且需要本地构建，可能会遇到 pnpm 10 拒绝执行 prepare 脚本的问题。此时需在对应 profile 的 pnpm-workspace.yaml 中配置 allowBuilds，允许该包的构建脚本运行。

刷新目录¶

点击面板右上角的 「刷新目录」，插件会向 Oh-My-DSH 拉取最新的 plugins.json。

刷新操作会执行以下逻辑：
1. 过滤出 type = 插件 的仓库。
2. 更新已有插件的 star 数、简介和许可证信息；若新简介为空，保留原有的中文简介。
3. 将新出现的插件追加到列表中，不会清空现有列表。
4. 将合并后的目录写入浏览器的 localStorage（键名 dsh.plugin-box.catalog.v1）。

刷新需要联网，且失败时面板会提示原因，原有列表不会被删除。

安全与注意事项¶

代码运行环境：插件盒子本身不托管代码，也不修改社区插件的源码。你通过终端执行 dsh plugin add 后，插件的代码会在你的机器上运行。
权限与信任：安装任何第三方插件前，请务必在 GitHub 上查看 README 和源码。目录数据来自 Oh-My-DSH，仅供参考，不构成官方认证。
缓存清理：卸载插件盒子不会自动清除缓存的目录。如需重置目录为初始状态，可在浏览器开发者工具中删除 dsh.plugin-box.catalog.v1。

维护与构建¶

如果你是维护者，需要更新插件盒子内置的目录数据，可以执行构建脚本：

node scripts/build.mjs

构建过程支持通过环境变量指定数据源：

OH_MY_DSH_PLUGINS：指向 Oh-My-DSH 的 data/plugins.json
PLUGIN_BOX_JSON：指向带有中文简介的清单文件

更多细节可参考 GitHub 仓库。