zoahdev/dsh-ecosystem

DeepSeek Harness 全家桶中文总览

由 zoahdev 维护。这里串起我在 DeepSeek Harness（dsh）生态做的全部东西——每个仓库是干嘛的、彼此什么关系、新手从哪开始。给中文读者的一页地图。

最新状态（2026-08）： 48 个上游补丁 · 7 个 npm 包 · 9 个插件（npm + GitHub + CI 全绿）；收录 PR：awesome-deepseek-harness #401（9 插件套件）与 awesome-dsh-plugin #1732（firstrun）已合并 ✅，其余 7 个收录 PR gate 全绿待合并 · 注册表 917 插件（325 可 npm 安装，质量评分已全覆盖） · 官方 RFC #1814（dsh plugin check / doctor 采纳）与 #2486（补丁队列）。

一句话看懂关系

flowchart LR
A[找/装插件] -->|订阅| S[dsh-subscribe 市场]
A -->|发现| P[dsh-plugin-search]
B[写/发插件] -->|模板| T[dsh-plugin-template]
B -->|自检| D[dsh-plugin-doctor]
B -->|安全| G[dsh-poison-guard]
C[运营/观测] -->|会话| H[dsh-shelf]
C -->|回放| R[dsh-replay]
C -->|审计| SA[dsh-sandbox-audit]
E[看生态] -->|地图| M[dsh-ecosystem]
E -->|情报| I[dsh-github-intelligence]
E -->|教程| TU[dsh-tutorials]
E -->|文档| DD[dsh-docs]

六大板块

① 市场与分发 —— 怎么找插件、装插件

| 仓库 | 一句话 |
| --- | --- |
| dsh-subscribe | Steam 式插件市场：网页一键订阅 + 一条命令同步进 dsh，900+ 插件注册表 |
| dsh-marketplace | 开源插件市场：浏览、搜索、一条 dsh 命令安装 |
| awesome-dsh-plugin | 插件精选列表（zoahdev 已有 8 个项目被收录） |
| dsh-plugin-search | 在 dsh agent 里直接搜 npm + awesome 插件 |

② 开发工具链 —— 怎么写插件、发插件

| 仓库 | 一句话 |
| --- | --- |
| dsh-plugin-template | 已验证的最小插件模板：CI 真的会调用 tool（不只是加载成功） |
| dsh-plugin-doctor | 发布前健康检查：manifest/patch/build/pack/install + 环境诊断 + 投毒预检 |
| dsh-plugin-doctor-action | 上面那套健康检查的 GitHub Action，一行接入 CI |
| dsh-rule-evolve | 验证驱动的自我进化：失败日志 → 经验 → 可审计的 AGENTS.md 规则 |
| dsh-pet-evolve | 会随你的 agent 一起成长的电子宠物 |

③ 安全 —— 防投毒、防泄露、防越权

| 仓库 | 一句话 |
| --- | --- |
| dsh-poison-guard | 装插件前投毒扫描：AST（JS-X-Ray）+ 反混淆解码，拦混淆外发/eval/隐藏命令 |
| dsh-poison-guard-action | 投毒扫描的 GitHub Action |
| dsh-redact | 分享会话日志前脱敏（API key/token/私钥/邮箱/路径） |
| dsh-sandbox-audit | 沙箱策略一致性审计（找出越权读/写/删） |

④ 内核层可观测 —— 看 agent 到底在干嘛

| 仓库 | 一句话 |
| --- | --- |
| dsh-replay | 时间旅行调试器：回放整条轨迹（思考/工具调用/结果）并 diff |
| dsh-trace | 聚合可观测仪表盘：token/tool/error/latency 一张 HTML 看全 |
| dsh-compose-viz | 可视化 preset 的 Cordis 组成（分组/隔离域/工具行） |
| dsh-preset-diff | 对比两个 agent preset 的差异 |
| dsh-shelf | 会话生命周期：导出/归档/回收站/搜索/统计 |

⑤ 生态情报 —— 看整个 dsh 生态

| 仓库 | 一句话 |
| --- | --- |
| dsh-github-intelligence | 196+ 只读工具 × 16 个生态（GitHub/GitLab/npm/PyPI/ArXiv/...），带缓存 |
| dsh-github-release-radar | Release/star/仓库搜索雷达，无需 API key |
| dsh-ecosystem | 生态地图：精选目录 + 周报 + 发布兼容性 + 补丁验证 |
| dsh-ecosystem-status | 自动生成的状态仪表盘 |
| dsh-docs | 官方文档提案 + 48 张可 cherry-pick 的上游补丁 |
| dsh-tutorials | 56 页（28 章 × 中英）双语教程：入门/架构/插件开发/发布自检/贡献路线/社区工作流 |

⑥ 官方上游

| 仓库 | 一句话 |
| --- | --- |
| deepseek-harness | 官方仓库 fork，带着 48 张补丁（根因 + 回归测试，等 PR 通道开） |

新手从哪开始

1. 想装插件 → 打开 dsh-subscribe，网页订阅，一条命令同步。
2. 想写插件 → 复制 dsh-plugin-template，写完用 dsh-plugin-doctor 自检。
3. 怕装到毒 → 装 dsh-poison-guard，dsh plugin add 之前先扫一遍。
4. 想看懂 agent → 用 dsh-replay 回放、dsh-trace 看指标。
5. 想跟上生态 → 看 dsh-ecosystem 周报 + dsh-tutorials 教程。

一句话定位：别人在做插件，我在做「装插件、发插件、防毒、看 agent、看生态」的地基。

DeepSeek Harness 生态地图

dsh 插件生态的活地图——精选、带质量信号、每周更新。由 zoahdev 维护。

Weekly · Plugins · Bugs tracked

这是什么

DeepSeek Harness（dsh）在 0.1.0-rc.6 开源，生态在几天内爆发：2,958 个仓库带有 dsh-plugin 主题，至少存在 8 个精选列表，新插件每小时都在出现。此前没有人在一个地方追踪质量信号、bug 状态和空白。这张地图就是那个地方。

- 每周版本 — 2026-08-19 汇总 — 发布了什么、什么坏了、什么修好了。
- 精选插件目录 — 真正可被 dsh 安装的插件，带分类、作者、可见性，以及（经审计的）验证信号。
- Bug 雷达 — 已知上游 bug，带状态、根因和修复/规避方案。
- 差距雷达 — 生态系统缺失什么（以及谁在构建它）。
- 发布兼容性报告 — npm dist-tags + zoahdev 套件 CI + 生态系统健康度，每次发布列车变更时自动生成。
- 官方参与档案 — 一页汇总所有上游贡献（补丁、RFC、文档），附链接和状态。
- 已知缺陷族图谱 — 已验证讨论族的根因分类法（dist-tags、%TEMP% 清理、损坏的构件、符号拆分、推理别名、Windows 令牌、信任围栏、工具结果可观测性）。

如何解读质量信号

| 信号 | 含义 |
|---|---|
| ✅ 已验证 | 我审计过此仓库：CI 存在、发布/tarball 存在，并且（对于 zoahdev 套件）真实注册表的 agent 可见性测试通过 |
| 🟡 信号部分 | 部分信号存在（发布或 CI），未完全审计 |
| ○ 未审计 | 来自 topic/awesome/marketplace 调查的列表；质量尚未验证 |

快速统计（2026-08-19）

- 官方：deepseek-ai/deepseek-harness — 0.1.0-rc.7（HEAD 99f6f02）
- 官方讨论：3000+ 主题帖；zoahdev 回复：60+ 证据级（分诊：scripts/discussion-triage.mjs，每日 CI：.github/workflows/discussion-triage.yml）
- #2763（损坏的 latest dist-tag）：仍未修复，全族 160/325 个插件受影响（dsh-tools 78）；假设 latest->rc.7 可恢复 100 个，剩余 60 个；验证器：scripts/verify-2763-fix.mjs（14 个包 latest==next）
- 注册表（dsh-subscribe）：917 个插件，325 个可 npm 安装，78 个 B 级仅与 #2763 相关

快速统计（2026-08-15）

- 官方：deepseek-ai/deepseek-harness — 103k★，0.1.0-rc.6
- dsh-plugin topic：2,958 个仓库（噪声较大：包含技能、桌面端及无关项目）
- 精选列表：8+（拥挤 — 见 docs/plugins.md）
- 市场/注册表：dsh-marketplace（基于 PR）、dsh-market（DSH 内）、若干 web 市场
- 跟踪的上游缺陷：48（48 个可直接 cherry-pick 的补丁，见补丁列表）
- 差距：8（见差距雷达）

zoahdev 套件（完全验证）

| 仓库 | 内容 | 验证 |
|---|---|---|
| dsh-subscribe | Steam 风格市场 + 917 插件注册表 + harness 内安装 | ✅ check-registry、CI、awesome #492 已合并 |
| dsh-rule-evolve | 验证驱动的自进化 + 徽章 | ✅ 18 项测试，awesome #560 已合并 |
| dsh-plugin-doctor | 发布前预检 + 环境解释 + 入口点 + profile-shadow | ✅ 49 项测试 + dsh-doctor/v1 契约 |
| dsh-plugin-doctor-action | 面向插件作者的一行 GitHub Action CI 门禁 | ✅ @v1，发布 tarball |
| dsh-shelf | 会话生命周期：Web 面板 + CLI + 验证/救援 | ✅ 14 项测试 |
| dsh-pet-evolve | 随你的 agent 一起成长的宠物 | ✅ 13 项测试 |
| dsh-github-intelligence | 196+ 工具 × 16 个生态系统 + 每周摘要 | ✅ 真实 API 冒烟测试，47 项测试，CI |
| dsh-plugin-search | 在 DSH 内部发现插件 | ✅ 6 项测试，可见性，CI |
| dsh-github-release-radar | 发布/星标/标签雷达 | ✅ 16 项测试，可见性，CI |
| dsh-plugin-template | 带 peer guard 的已验证模板 | ✅ CI |
| dsh-tutorials | 52 页（26 章中/英）双语教程站点 | ✅ 页面已上线 |
| dsh-docs | 官方文档缺口规格 + 上游补丁列表 | ✅ 已记录 48 个补丁 |
| dsh-ecosystem | 地图 + 每周 + 发布兼容性 + 补丁验证 | ✅ 48 分支补丁验证机器人 |

实时仪表盘

- 生态系统健康仪表盘 — 供应链扫描、#2763 影响、质量排行榜 v1（325 个插件，240A/84B/1F）尽在一页。

#2763 修复日验证器

运行 node scripts/verify-2763-fix.mjs — 检测官方 latest dist-tag 何时变化，然后重新扫描注册表、重新为排行榜评分，并写出影响下降报告。

贡献

- 知道某个插件应该被收录进目录？带上仓库 URL 开一个 issue 或 PR。
- 发现了雷达上没有的 bug？开一个 issue。
- 想认领一个空白？在 issue 里说明——地图会追踪它。

许可

CC0 — 地图是数据；随意使用。

中文说明

DeepSeek Harness 插件生态地图。

由 zoahdev 维护，每周更新，带质量信号。

DeepSeek Harness（dsh）在 0.1.0-rc.6 开源后，生态几天内爆发：2958 个仓库挂了 dsh-plugin 标签，至少 8 个精选列表，新插件每小时都在出现。但没人在一个地方统一追踪质量信号、bug 状态、生态空白。这张地图就是那个地方。

包含什么

- 周报（docs/）：本周上了什么、坏了什么、修了什么。
- 精选插件目录（docs/plugins.md）：真实可装的插件，带分类、作者、可见性、验证信号。
- Bug 雷达：已知上游 bug，带状态、根因、修复/规避方案。
- 空白雷达：生态还缺什么（以及谁在做）。
- 发布兼容性报告（docs/release-compat/）：npm dist-tags + zoahdev 套件 CI + 生态健康，每次 release train 变化自动生成。
- 官方互动档案（docs/official-engagement.md）：一页列出所有上游贡献（补丁、RFC、文档）及状态链接。
- 已知问题家族图谱（docs/bug-families.md）：已核验讨论家族的根因分类（dist-tag、%TEMP% 清理、坏工件隔离、符号分裂、推理字段别名、Windows 令牌、远程信任边界、工具结果可信度）。

质量信号怎么看

| 信号 | 含义 |
|---|---|
| ✅ verified | 我已审计：有 CI、有 release/tarball，（zoahdev 套件）还通过了真实注册表的 agent 可见性测试 |
| 🟡 signals partial | 有部分信号（release 或 CI），未完全审计 |
| ○ not audited | 从 topic/awesome/marketplace 调研收录，质量未验证 |

许可

CC0——地图是数据，随意使用。