cordisplugins/dsh-cordis

dsh-cordis

dsh-cordis 将 DeepSeek Harness 编码引擎打包为 Cordis 插件。
它将 DSH 基础组合挂载到调用方现有的 Loader 树中：原生
代理、持久会话、模型适配器、工具、目标、计划模式、审批，
以及打包的代理预设。

它不会构建另一个 Cordis 根。它的 Fiber 拥有所包含的 DSH 树，
因此禁用或替换其 Loader 条目会移除其活动服务，并让
消费者进入 PENDING 状态，直到另一个提供者可用。

安装

pnpm add dsh-cordis @deepseek-ai/cordis@4.0.1

组合

在已提供 loader 的宿主中使用稳定的 Loader 行：

- id: dsh-engine
name: dsh-cordis
config:
telemetry: false

telemetry 默认为 false。宿主仍负责 DSH_HOME、
凭据、模型选择、UI，以及任何 ACRYL 引擎选择契约。

生命周期

该包提供原生 DSH 服务提供者。消费者应注入其所需的
特定服务——例如 sessions、agents 或 tools——而不是
导入此包的实现。移除 dsh-engine 行
会通过正常的 Cordis 生命周期处置撤回这些提供者。

工程原则

dsh-cordis 在其公共边界上刻意保持小巧，而在其背后则相当
充实。该包承载 DSH 引擎组合；宿主接收的是普通的
Cordis 服务，而不是特定于引擎的全局单例。

- 依赖倒置与接口分离。 消费者请求
sessions、agents、tools 及其他服务契约。它们不会
导入具体的 DSH 提供者来获取这些能力。
- 接缝而非重写。 引擎是一个能力接缝：宿主可以
观察、替换或移除 DSH 提供者，而无需重写依赖其服务的
消费者。
- 正交性优于隐藏耦合。 插件声明其所需内容。
缺失的依赖保持挂起状态，而不是被隐藏在启动
顺序假设、时序重试或全局初始化序列之后。
- 每个活动贡献只有一个所有者。 Loader 条目、服务提供者、
监听器、定时器、子进程和订阅都属于一个 Fiber。所有者
也拥有它们的清理工作。
- 可逆的运行时变更。 移除引擎条目会撤回其活动的
DSH 服务和注册。替换项可以针对同一
宿主激活，而无需保留提供者引用或重复贡献。
- 配置即组合。 稳定的 Loader ID 选择引擎及其
配置。更改部署选择不需要在应用程序代码中
分散提供者开关。
- 集成边界处的 YAGNI。 该包复用 DSH 的会话、
代理、工具、审批和持久化能力，而不是引入
另一个代理循环、事件总线或生命周期框架。
- 持久事实保持持久。 会话和重放关键工作由
- 由 DSH 会话模型。实时事件协调一个正在运行的进程；它们
不被视为工作的唯一记录。
- 信息隐藏与深层模块。 该包吸收了 DSH 组合、
依赖解析和生命周期机制，为调用方留下一个小的
面向服务的接口，而不是一堆设置细节。
- 快速失败，遏制故障。 无效配置和缺失服务
在部分激活之前就失败。加载器替换在候选者无法激活时
保持一个可用的提供者。
- 重构安全的变更。 替换经过测试，而非假设：发布
套件覆盖缺失依赖、真实 Loader 激活、提供者移除，
以及在宿主仍存活时重复激活。

这些是对该包的实际约束，而非口号：源代码和
测试围绕它们组织，因此引擎可以被安装、使用、移除
和替换，而无需更改宿主架构的其余部分。

来源与出处

该仓库包含 deepseek-harness/，作为来自
的固定 Git 子模块。它是被包装引擎的
源参考。pnpm run upstream:sync 恢复其记录的固定版本；
pnpm run upstream:update 有意将其推进到上游，并留下
新的 gitlink 以供审查和提交。已发布的 DSH 依赖保持版本固定，
直到该源更新已在新的 dsh-cordis 版本中测试并发布。提取的组合、预设、许可证和精确源记录
位于 provenance.json。

该子模块不会作为第二个运行时加载。dsh-cordis 将匹配的
已发布 DeepSeek Harness 包包装为宿主现有
插件树中的一个 Cordis 插件。

这是 ACRYL 未来可选引擎宿主的第一个 DSH 引擎包。
它尚未提供 Pi 集成、引擎切换命令或
跨引擎会话转换。