aa1143/NamiDSH

选用指南

AI 根据 README 整理 · 2026/11/6 09:11:32

适用场景

适合想理解 DeepSeek Harness 架构的开发者，通过对照迷你实现和文档学习。

查看 README 依据

- **网页端 Agent**：`npm start` 打开浏览器就能对话，可以接 DeepSeek，没有 API Key 也能离线跑 - **零运行时依赖**：Node.js 22.18 起直接运行 TypeScript，不用编译，也不用装任何框架 读完这个项目，再去读 DSH 的源码，你会发现每个文件都能找到对应。 > 先学 [NamiGPT](https://github.com/aa1143/NamiGPT) 搞懂模型本身，再学 [NamiAgent](https://github.com/aa1143/NamiAgent) 搞懂模型外面那一圈，最后用 NamiDSH 看懂工业级 Agent 是怎么搭起来的。 ## 配套文章 架构图上的每一块，都有一篇文章展开讲。可以在网站上读（带可视化），也可以直接读 `docs/` 里的 Markdown。 | 篇 | 文章 | 对应代码 | |---|---|---| | 01 | [一切皆插件：DeepSeek Harness 最核心的设计](docs/01-plugin-everything.md) · [网页版](https://namiai.tech/dsh/plugin-everything/) | 全貌 |

使用方式

通过命令行运行，npm start 启动网页端，可配置 API_KEY 接 DeepSeek 或使用离线假模型。

查看 README 依据

app.plugin(apiKey ? deepseek : mock, { apiKey }) // 模型适配器，随时可换 app.plugin(webserver, { port, staticDir }) // 入口 ``` ## 快速开始 需要 Node.js 22.18 以上（直接运行 TypeScript，不用编译）。 ```bash npm install # 只是把 packages/* 链接起来，不下载运行时依赖 npm start # 打开 http://localhost:3000 ``` 没有设置 API Key 时，会使用离线假模型，可以问「现在几点」「项目里有哪些文件」。接 DeepSeek： ```bash API_KEY=sk-xxx npm start # 可选：BASE_URL（默认 https://api.deepseek.com）、MODEL（默认 deepseek-v4-flash）、PORT、WORKSPACE ``` ## 和真 Cordis 行为一致 `tests/compat.ts` 里有 14 个场景：依赖等待、拔掉服务、同名冲突、配置热更新、错误隔离、配置校验、Service 类、五种事件、自动取消监听、嵌套卸载、注入检查、可选依赖、异步 effect。

部署要求

需要 Node.js 22.18 以上，直接运行 TypeScript，无需编译。

查看 README 依据

app.plugin(apiKey ? deepseek : mock, { apiKey }) // 模型适配器，随时可换 app.plugin(webserver, { port, staticDir }) // 入口 ``` ## 快速开始 需要 Node.js 22.18 以上（直接运行 TypeScript，不用编译）。 ```bash npm install # 只是把 packages/* 链接起来，不下载运行时依赖 npm start # 打开 http://localhost:3000 ``` 没有设置 API Key 时，会使用离线假模型，可以问「现在几点」「项目里有哪些文件」。接 DeepSeek： ```bash API_KEY=sk-xxx npm start # 可选：BASE_URL（默认 https://api.deepseek.com）、MODEL（默认 deepseek-v4-flash）、PORT、WORKSPACE ``` ## 和真 Cordis 行为一致 `tests/compat.ts` 里有 14 个场景：依赖等待、拔掉服务、同名冲突、配置热更新、错误隔离、配置校验、Service 类、五种事件、自动取消监听、嵌套卸载、注入检查、可选依赖、异步 effect。