NamiDSH(迷你DSH)

作者 算力观察

DeepSeek Harness 说「一切皆插件」,可真正读源码时容易被规模劝退。这是个一千来行 TypeScript 的迷你复刻:迷你版 Cordis、迷你版 DSH 加网页端 Agent,配一张架构图和一个真实提问的逐跳代码对照。

Github
项目 知识学习 v1.0.0 热度 265

项目说明

NamiDSH 是什么

NamiDSH 是一个迷你版 DeepSeek Harness,用一千来行 TypeScript 讲清 DSH「一切皆插件」的架构。它由三部分组成:迷你版 Cordis(插件框架)、迷你版 DSH(Agent 主体)、以及一个网页端 Agent。

最有价值的是它的可视化:拿一次提问「现在几点?」为例,左边是架构图,右边是这一步对应的真实代码,把一次请求怎么在插件之间流转,一步步摊开给你看。仓库还配了专门的讲解文章。

部分对应关系
迷你版 Cordis对应真 Cordis,行为保持一致
迷你版 DSH对应 DSH packages/*,保留插件树结构
网页端 Agent可在浏览器里直接跑起来看效果
代码量一千来行 TypeScript

NamiDSH 怎么安装

npm install

注意:这一步只是把 packages/* 链接起来,不下载运行时依赖。真正的依赖按仓库的「快速开始」一节装。

NamiDSH 怎么使用

  1. 先读那张架构图,建立「插件树」的整体印象。
  2. 按「快速开始」把项目跑起来,打开网页端 Agent 提一个问题。
  3. 对照左图右码,看这一步用了哪个插件、经过了哪几个环节。
  4. 改一个插件的实现,再观察输出变化——手改比只读理解快得多。
  5. 回到真 DSH 的对应目录对照,确认自己的理解和真实实现一致。

NamiDSH 适合谁用

  • 想读懂 DSH / Cordis 架构、但被完整代码规模劝退的开发者。
  • 要自己写插件系统、需要一份可读参考实现的人。
  • 教别人插件化架构、需要小而全的示例的项目维护者。
  • 用 TypeScript 做 Agent 基础设施的工程师。
  • 只想直接上手用现成 Agent、不关心内部结构的用户,这个项目对你是绕路。

NamiDSH 项目地址

  • GitHub 仓库:https://github.com/aa1143/NamiDSH
  • 配套文章:https://github.com/aa1143/NamiDSH#配套文章
  • 和 DSH 的对应关系:https://github.com/aa1143/NamiDSH#和-dsh-的对应关系