词汇表与资料
术语对照
| 术语 | 含义 |
|---|---|
| dsh | DeepSeek Harness 的 CLI 命令名,也是项目简称 |
| Cordis | dsh 的运行时框架,上游 cordiverse/cordis,由 Koishi 作者 Shigma 开发 |
| Context | Cordis 的根容器,被 ReflectService.handler 代理的 Proxy 对象 |
| Fiber | 一次 ctx.plugin() 返回的实例,有限状态机(PENDING→LOADING→ACTIVE→UNLOADING→DISPOSED) |
| Service | Cordis 的服务基类,构造时 ctx.reflect.provide(name, self) 注册自己 |
| Registry | RegistryService,以 callback 为 identity key 记录 Plugin.Runtime |
| Effect | "可逆注册"——ctx.on/ctx.provide 等被记入 fiber 的 _disposables,卸载时逆序执行 |
| Isolate | Context 的多实例机制,同一 service 名在不同 isolate 子树可有不同实现 |
| Intercept | Context 的 config 覆盖机制,沿原型链合并 |
| Inject | 插件声明所需服务名的字段,fiber 在服务全部 active 时才 LOADING→ACTIVE |
| Loader | vendor/loader,管理 entry 树 + Node 内置 ModuleLoader 做 ESM/CJS 导入 |
| Bundle | packages/bundle/* 的 YAML patch 层(base/headless/web-app),把插件组合成开箱即用的模式 |
| Profile | 用户私有的 pnpm workspace,dsh plugin add 写入依赖 |
| Dynamic Plugin | agent 通过 cordis_define 工具运行时注入的插件,会话级、不持久化 |
| Host 半 / Client 半 | dsh 的两个 realm:host 半是 Node 进程,client 半是浏览器 React |
| Sandbox | 动态插件的 sandboxContext,只暴露白名单 verb——不是安全边界,用于 cooperative package |
| HMR | Hot Module Replacement,服务端 chokidar + 反向依赖图,浏览器端 stat-poll + SSE |
| SrcLink | 本站的源码跳转组件,点击直达 GitHub 对应行 |
框架事件(internal/*)
| 事件 | 作用 |
|---|---|
internal/plugin | 插件生命周期日志 |
internal/status | 状态变更 |
internal/config | config 插值 |
internal/update | HMR/Loader 持久化挂载点(waterfall) |
internal/get / internal/set | 服务 store 读写 |
internal/listener | 框架自身事件优先级分流 |
internal/dispatch | 事件派发 |
五种 dispatch
| dispatch | 模式 |
|---|---|
emit | 通知(忽略返回) |
parallel | 聚合(并发,等全部) |
serial | 串行(依次) |
bail | 短路(首个有返回即停) |
waterfall | 中间件(洋葱模型,next() 委托) |
官方资料
- 源仓库:deepseek-ai/deepseek-harness(MIT)
- Cordis 上游:cordiverse/cordis
- 官方 Cordis Primer:
docs/cordis-primer.md - 官方 Cordis API 文档:
docs/cordis-api/{context,events,fiber,registry,service}.md - 官方 Cordis 教程:
docs/cordis-tutorial/01-first-plugin.md~07-into-the-harness.md
本站版本钉点
- commit:
47f943859bef60e4160492346772ded9b24f765a(master @ 2026-08-13) - 版本:dsh@0.1(release 提交,无 release tag)
- Cordis 版本:4.0.1(上游 4.0.0-rc.7,vendored)
- 本地修改:18 处(见
vendor/README.md)
非官方声明
本站是社区驱动的源码学习材料,非官方文档,不替代官方 docs。深度内容指向官方 docs/cordis-primer 与 cordis-tutorial。内容基于 MIT 许可的 deepseek-ai/deepseek-harness 源码二次创作分析,所有 SrcLink 指向公开 GitHub 源码行。详见隐私政策、服务条款、关于。