awesome-deepseek-harness

168Star112Fork7Issue0Watching

DeepSeek Harness 优秀插件清单仓库,并在 plugins/ 目录附带 4 个可运行的参考插件:图表、幻灯片、代码评审、自动调研循环。

机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
语言
TypeScript
License
NOASSERTION
分支
main
agentagent-frameworkai-agentai-agentsawesomeawesome-listcoding-agentdeepseek

安装

$ dsh plugin --profile web add github:Dominic789654/awesome-deepseek-harness

在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 Dominic789654/awesome-deepseek-harness:先查看仓库 https://github.com/Dominic789654/awesome-deepseek-harness.git 确认安全性,然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。

一句话定位

这是一个围绕 DeepSeek Harness (DSH) 编制的优秀插件清单仓库:根目录收录了社区里值得关注的插件、profile、harness、UI 等资源索引,plugins/ 子目录则附带 4 个可运行的参考插件(dsh-viz / dsh-slides / dsh-code-review / dsh-research-loop),用于示范 DSH 插件的标准结构。

核心能力

  • 提供一份分类清晰的 DSH 生态清单,覆盖官方仓库、profile/patch 层、harness/runtime、安全与权限、会话与记忆、IM 桥接、可视化、slides、coding、agent、loop、MCP、UI、技能等近 20 个分类
  • plugins/ 子目录随仓库发布 4 个参考插件(dsh-viz / dsh-slides / dsh-code-review / dsh-research-loop),每个都按社区观测到的主流布局(package.json#dsh + cordis.patch.yml + dsh.plugin.json + src/index.ts)写成最小可用骨架
  • dsh-viz 注册 chart_render 工具,把结构化数据写入工作区内的 ECharts 自包含 HTML,支持 line / bar / pie / scatter 四种图表
  • dsh-slides 注册 slides_generate 工具,把 markdown 大纲(--- 分页、-- 分垂直子页)渲染为 reveal.js 自包含 HTML 演示
  • dsh-code-review 注册 code_review_context 工具,按 worktree / staged / range 三种 scope 确定性收集 git diff,并附 code-review 技能给出按严重度排序的评审清单
  • dsh-research-loop 注册 research_log 工具,把每个调研主题的发现追加到工作区内的 JSONL 日志,并附 auto-research-loop 技能驱动有界的研究循环

技术实现

  • 语言: TypeScript(ESM,type: module,target ES2022)
  • 关键依赖: @deepseek-ai/cordis(Cordis 容器,提供 Context 与插件装载)、@deepseek-ai/dsh-toolsdefineTool 工厂与 ctx.tools.register)、@deepseek-ai/schemasteryz.object 配置 schema,可调用形式 Config({}) 应用默认值);运行时只依赖 Node 内置模块(node:fs / node:path / node:child_process),无第三方运行时包
  • 架构模式: host-only 插件(无 client bundle)。每个子插件导出 nameinject=['tools']Config(schemastery schema)、apply(ctx, config),由 cordis.patch.yml 通过 insert 在 profile 层栈中挂载;工具注册统一走 ctx.tools.register(defineTool({ name, description, parameters, output, async execute }))
  • 入口文件: 每个子插件入口 plugins/<name>/src/index.ts;挂载清单在同目录的 cordis.patch.yml;元数据在 dsh.plugin.jsonpackage.json#dsh

适用场景

  • 想要了解 DSH 生态有哪些插件、profile、MCP、UI 可用时,把这份清单当索引翻阅(README.md:31-52)
  • 想自己写 DSH 插件但缺少官方 spec 文档时,参考 plugins/ 下 4 个范例的目录结构、cordis.patch.yml 写法、配置 schema 与工具定义方式(plugins/README.md:7-46)
  • 想要 DSH agent 在工作区里画图表、做 PPT、跑代码评审、做有界调研时,直接装 4 个范例里的对应子插件(README.md 与 plugins/README.md:51-55)

前置依赖与兼容性

依赖最低版本说明
DeepSeek Harness (DSH)>= 0.0.1每个子插件在 dsh.plugin.json#engines.dsh 中声明 ">=0.0.1",未对宿主给出更严格版本要求
Node.js未声明仓库没有 engines 字段;@types/node^24.0.0,子插件脚本通过 pnpm install && pnpm build 编译,运行时只用 Node 内置模块
平台macOS / Windows / Linux没有原生绑定;dsh-code-review 通过 execFileSync('git', args) 调系统 git,要求宿主机已装 git 命令
原生模块无 native binding,仅使用 node:fs / node:path / node:child_process

安装方式

dsh plugin --profile web add github:Dominic789654/awesome-deepseek-harness

仓库根目录不是 npm 包,安装命令会拉取整个仓库,但实际生效的是 plugins/ 下的 4 个子插件。如只想装其中一两个,可直接装子目录:dsh plugin --profile web add file:/绝对路径/plugins/dsh-viz(plugins/dsh-viz/README.md:9-13)。每个子插件在装入前需先在该目录内 pnpm install && pnpm build,把 src/index.ts 编译成 lib/index.js,否则 Cordis Loader 找不到入口。

配置项

仓库根没有需要配置的项目;下面是 4 个子插件各自的配置,写在各自 profile patch 的 config 字段里:

dsh-viz

配置类型说明默认值
outputDirstring图表 HTML 的输出目录,相对当前 workspace 根artifacts/charts
echartsSrcstringECharts 运行时的 script src(CDN 地址或自托管 URL)https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js

dsh-slides

配置类型说明默认值
outputDirstring幻灯片 HTML 的输出目录,相对当前 workspace 根artifacts/slides
revealBasestringreveal.js 发行版的 base URLhttps://cdn.jsdelivr.net/npm/reveal.js@5
themestringreveal.js 主题名(black/white/league/sky/moon/...)white

dsh-code-review

配置类型说明默认值
maxDiffBytesnumber单次返回的 diff 文本字节上限;超出后会被截断并打 marker,强制模型按目录重收120000

dsh-research-loop

配置类型说明默认值
logDirstring调研日志目录;每个 topic 在该目录下生成 <slug>.jsonl.dsh-research
maxReadEntriesnumber一次 read 返回的最大日志条数(取尾部最新 N 条,旧→新顺序)200

常见问题

Q: 安装这个仓库会得到什么?

A: 装上后宿主里会挂载 plugins/ 下的 4 个独立插件(dsh-viz / dsh-slides / dsh-code-review / dsh-research-loop),分别注册 chart_render、slides_generate、code_review_context、research_log 四个工具;仓库根目录本身是一份 awesome-list 索引,不在 DSH 运行时里承担任何角色。

Q: 这 4 个插件和官方 DSH 功能是什么关系?

A: 它们不是官方组件,而是从社区高赞插件与 dsh-plugin-development 技能反推出的"结构上忠实"的参考骨架;作者明示未在真实 DSH 实例上验证,@deepseek-ai/* 对等依赖全部按 * 宽松声明,应被视为示例而非生产插件。

Q: 我可以只装其中一两个吗?

A: 可以。每个子插件都是独立的 npm 包,按子目录路径 dsh plugin --profile <name> add file:/绝对路径/plugins/<子目录名> 安装即可,不必安装整个仓库。

Q: 安装前需要做什么?

A: 必须在每个子插件目录内先 pnpm install && pnpm build,因为仓库里只有 src/index.ts,而 dsh.plugin.json 里声明的 main 指向编译产物 lib/index.js,不 build Cordis Loader 会找不到入口。

Q: 这 4 个插件会写文件到我电脑的哪里?

A: 全部被强制限制在当前会话的 workspace 根目录下:dsh-viz 写图表 HTML 到 <workspace>/<outputDir>/、dsh-slides 写幻灯片 HTML 到 <workspace>/<outputDir>/、dsh-research-loop 追加 JSONL 到 <workspace>/.dsh-research/<topic>.jsonl;dsh-code-review 只跑 git diff,不写任何文件。绝对路径与跳出 workspace 的相对路径都会被拒绝。

Q: dsh-code-review 的评审方法学是怎么交给模型的?

A: 工具只负责"取到同一份 diff 快照",评审清单走附带的 code-review 技能,按 正确性 → 安全 → 测试 → 可维护性 四层给出可行动的评审意见,并强制 read-only、不基于截断 diff 下结论。

Q: dsh-research-loop 不会无限跑下去吗?

A: 不会。技能里写明停止条件三选一:所有子问题有 ≥2 个独立来源支撑、连续一轮搜索无新信息、或达到默认 3 轮上限;每一步用 research_log 落盘,下一次迭代从 read 恢复状态,不再凭记忆续写。

Q: 怎么卸载?

A: 仓库没有自带卸载脚本;按 DSH 标准流程用 dsh plugin --profile web remove 即可,4 个子插件的 cordis patch id 分别是 dsh-viz / dsh-slides / dsh-code-review / dsh-research-loop,需要逐条移除。

上手难度

进阶 — 仓库本身的"翻阅索引"用法零门槛,但要用上 plugins/ 里的范例插件,需要先在每个子目录里跑 pnpm install && pnpm build,再理解 Cordis / schemastery / ctx.tools.register 这套 DSH 插件约定;如果你想拿它们当自己写插件的模板,还要读 plugins/README.md:7-46 解释的社区惯例章节。

已知问题与限制

  • 4 个子插件均未在真实 DSH 实例上验证过;@deepseek-ai/cordis / @deepseek-ai/dsh-tools / @deepseek-ai/schemastery 全部以 * 宽松声明为可选 peer 依赖,生产环境使用需要自己锁定到当前 DSH 实际版本(plugins/README.md:57-59)
  • 仓库未提供任何 lib/ 编译产物,安装前必须先在每个子插件目录 pnpm install && pnpm build,否则 Cordis 找不到 main 指向的 lib/index.js(plugins/dsh-viz/package.json:7 / plugins/dsh-viz/README.md:9-13)
  • dsh-code-review 要求工作区是 git 仓库且 git 命令在 PATH 中,否则 execFileSync('git', ...) 会抛错(plugins/dsh-code-review/src/index.ts:46-53)
  • dsh-viz / dsh-slides / dsh-research-loop 都从 ctx.get('agents').currentInitiator().session.header.cwd 取工作区根,没有活动会话时直接报错,不会回退到默认路径(plugins/dsh-viz/src/index.ts:42-49)
  • dsh-viz / dsh-slides 通过 CDN 引入 ECharts / reveal.js,离线或受限网络下打开生成的 HTML 会丢失图表与样式(plugins/dsh-viz/src/index.ts:33 / plugins/dsh-slides/src/index.ts:32-33)

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/Dominic789654/awesome-deepseek-harness)

把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。

返回插件目录