项目说明
NamiDSH 是什么
NamiDSH 是一个迷你版 DeepSeek Harness,用一千来行 TypeScript 讲清 DSH「一切皆插件」的架构。它由三部分组成:迷你版 Cordis(插件框架)、迷你版 DSH(Agent 主体)、以及一个网页端 Agent。
最有价值的是它的可视化:拿一次提问「现在几点?」为例,左边是架构图,右边是这一步对应的真实代码,把一次请求怎么在插件之间流转,一步步摊开给你看。仓库还配了专门的讲解文章。
| 部分 | 对应关系 |
|---|---|
| 迷你版 Cordis | 对应真 Cordis,行为保持一致 |
| 迷你版 DSH | 对应 DSH packages/*,保留插件树结构 |
| 网页端 Agent | 可在浏览器里直接跑起来看效果 |
| 代码量 | 一千来行 TypeScript |
NamiDSH 怎么安装
npm install
注意:这一步只是把 packages/* 链接起来,不下载运行时依赖。真正的依赖按仓库的「快速开始」一节装。
NamiDSH 怎么使用
- 先读那张架构图,建立「插件树」的整体印象。
- 按「快速开始」把项目跑起来,打开网页端 Agent 提一个问题。
- 对照左图右码,看这一步用了哪个插件、经过了哪几个环节。
- 改一个插件的实现,再观察输出变化——手改比只读理解快得多。
- 回到真 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-的对应关系