dsh-plugin — DeepSeek Harness 插件收录总库

DeepSeek Harness (DSH) 插件收录总库：收录遵循 Cordis 框架、经官方 profile 机制挂载至 dsh 与原生 Web UI 的插件。

本仓库是 DSH 插件生态的收录索引总库（registry），不是插件源码仓库。

• 收录插件（upstream）：仅保留元数据索引 + 上游链接，内容由 GitHub Actions 自动同步，禁止手工维护；
• 自研插件（self）：本仓库自带完整源码，可手动维护。

目录

路径	说明
registry/	收录索引（机器可读），由 scripts/sync-registry.mjs 自动生成
scripts/	同步与校验脚本
self/	自研插件（本仓库维护源码，self/dsh-sess 等）
docs/	插件规范、挂载指南、收录流程
.github/workflows/sync.yml	自动同步上游收录（定时 + 手动触发）

快速开始

# 安装收录插件（走 npm / github 源，见 docs/MOUNTING.md）
dsh plugin --profile web add dsh-cost-meter

# 安装自研插件（pnpm 子路径直装，见 docs/MOUNTING.md「自研插件安装」）
cd ~/.dsh/profiles/web
pnpm add github:youridol/dsh-plugin#path:/self/dsh-sess

自研插件（self）挂载方式

self/ 下的插件是遵循 Cordis 框架、经官方 profile 机制挂载的标准 DSH 插件（见 docs/STANDARDS.md）：宿主端在 profile 的 dsh.profile.bundles 声明、由 cordis.patch.yml 注入插件行；浏览器端经 package.json 的 dsh.client 声明由 client-modules 扫描进入 window.__DSH_BOOT__，不改 DSH 源码。

两种挂载方式（详见 docs/MOUNTING.md）：

1. profile bundle（推荐，长期生效）：

   cd ~/.dsh/profiles/web
   pnpm add github:youridol/dsh-plugin#path:/self/dsh-sess
   # 然后在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 追加 "dsh-sess"，重启 dsh web
   

2. --patch overlay（临时验证）：启动时叠加 - insert: 插件行，不改 profile 配置。

收录原则

1. 严格遵循 Cordis 框架：插件必须是 Cordis 插件（导出 name / apply），经官方 profile 机制（dsh.profile.bundles / --patch / dsh plugin add）挂载至 dsh 与原生 Web UI，不改 DSH 源码。
2. 收录插件自动同步上游，勿手动维护：registry/ 收录与 self/README.md 的收录插件部分由 scripts/sync-registry.mjs 自动生成，人工修改会被覆盖。
3. 自研插件可手动维护：self/ 下的插件为本仓库所有，正常提交即可。

插件收录状态

类别	数量	说明
收录插件（upstream）	见 registry/plugins.json	自动同步，来源于 awesome-dsh-plugin 官方策展目录 + GitHub dsh-plugin 话题 + npm 关键词
自研插件（self）	见 self/README.md	本仓库维护源码

协议

MIT — 见 LICENSE。