fentz26/dsh-next

dsh-next

面向性能的 DeepSeek Harness（DSH）后端/运行时现代化层。在有基准测试支持的地方使用 Rust，其余全部使用 TypeScript。

dsh-next 是一个树外插件仓库。它不会 fork 或重写 DSH。它通过常规的 Cordis/profile/bundle 组合替换选定的执行/数据平面能力提供者，而 DSH 仍然是控制平面：

DeepSeek Harness TypeScript 控制平面   ← 不变
├─ Cordis 插件图 / 会话语义 / Agent Loop
├─ Jobs 注册表 / Wait 编排 / 模型+工具契约
│         │
│         ▼  现有能力接缝（ctx.sessionPersistence、ctx.subprocess、……）
└─ dsh-next
├─ 轻量 TypeScript 适配器
└─ Rust/原生执行平面   ← 仅在存在可测量收益的地方

不可协商的原则

1. 基准测试优先策略。 没有证据就不重写。如果某个组件的基准测试结果与其 TS 对应实现相同或更差，则保留在 TypeScript 中。
2. 不重写控制平面。 Cordis、agent-loop、jobs 注册表、wait 运行时、会话事件语义、浏览器 UI 永久不在范围内，除非性能分析产生非同寻常的证据。
3. 语义保持。 任何原生提供者都必须精确保持 DSH 契约（持久性耐久性/恢复规则、子进程终止树、凭据擦除、DSH_* 环境变量命名空间、……）。
4. 故障安全回退。 不可用的原生加速必须显式降级到原版提供者——绝不静默声称已加速。
5. 不新增事件总线。 原生组件保持在服务边界之后；面向 JS 的协调仍留在 Cordis/Session 接缝上。

仓库布局

docs/
architecture.md                 审计 + 边界设计（阶段 0）
benchmark-methodology.md        基准测试如何构建和运行
baseline-results.md             阶段 0 测量表 + 分析
journal-pilot.md                原生 journal 试点：API、测试、结论
persistence-provider-design.md  未来 ctx.sessionPersistence 提供者说明
supervisor-design-note.md       持久进程 supervisor 可行性（仅设计）
session-scale.md                1M 事件规模下的全历史消费者审计
paged-hydration.md              分页逻辑水合设计 + 验收证明
checkpoints.md                  派生检查点安全规则（设计/协议）
resume-acceleration.md          实测恢复分解 + 接缝门控
upstream-seam-proposal.md       面向维护者的惰性接缝提案
packages/journal/             BoundedByteJournal：TS 参考实现 + 优化候选实现
packages/paged-history/       基于 SQLite v17 的 PagedLogicalSource（+ 导出消费者）
packages/checkpoint-replay/   分块过滤的派生检查点，REAL-Session 等价性测试
packages/persistence-worker/  worker 持有的持久化提供者
packages/descriptor-store/    持久描述符存储原型
crates/native-journal/        Rust napi-rs 试点（NativeByteJournal）
benches/                      可复现的基准测试框架（针对真实 DSH 运行）

运行

基准测试需要一份 DeepSeek Harness 检出（已构建的工作区）：
bash
DSH_ROOT=~/deepseek-harness pnpm bench              # 全部
DSH_ROOT=~/deepseek-harness pnpm bench:persistence  # sqlite 追加/并发
DSH_ROOT=~/deepseek-harness pnpm bench:cold-load    # 会话重建
DSH_ROOT=~/deepseek-harness pnpm bench:compression  # zstd 编码/解码停顿
DSH_ROOT=~/deepseek-harness pnpm bench:collector    # OutputCollector 压力测试
DSH_ROOT=~/deepseek-harness pnpm bench:journal      # journal 策略 + FFI 批处理
pnpm test                                           # TS + 原生差分测试

pnpm test 无需 DSH 检出即可运行公共门禁；与实时 DSH 内部实现进行对比的测试套件会干净地跳过，除非设置了 DSH_ROOT。额外的里程碑基准测试可按名称运行：
bash
DSH_ROOT=~/deepseek-harness npx tsx benches/src/main.ts resume-modes      # checkpoint 与 legacy resume TTR 对比
DSH_ROOT=~/deepseek-harness npx tsx benches/src/main.ts paged-acceptance  # 4k 页与 1.09M 事件全量加载对比

原生模块目前单独构建（Phase 0 试点）：
bash
cd crates/native-journal && cargo build --release \
&& cp target/release/libdsh_next_native_journal.dylib pilot.node

项目状态

以证据为门禁的轨道（各文档中有门禁；ADR 见 docs/adr.md）：

| 轨道 | 状态 | 文档 |
|---|---|---|
| A — 分段式 journal | JOURNAL 就绪 — segmented-ts 为默认，原生为实验性 | journal.md |
| B — Worker 持久化 | 继续推进 — 主循环延迟约 1 ms，对比 17–50 ms；差分测试套件通过 | persistence-worker.md |
| C — 巨型会话恢复 | 分页水合已验证 + 消费者已迁移 — 4k 页：约 5k 个对象 / 几毫秒，对比全量加载 1.09 M 个对象；导出消费者通过范围流式输出字节完全一致的产物 | paged-hydration.md · session-scale.md |
| D — 检查点式恢复 | 检查点式恢复已验证 — 按块过滤的 distill() 前缀，已针对真实 Session 机制进行等价性测试（messages + requestHeader 完全一致）；恢复 TTR 28 ms 对比 legacy 581 ms，热路径 15 ms。惰性 Session 准备仍受上游 bridge 契约门禁约束 | checkpoints.md · resume-acceleration.md |
| E — 原生原语 | 范围狭窄（仅 journal 试点）；遵循 ADR-001 规则 | adr.md |
| F — 持久化执行 | 已规定状态模型/提交边界/崩溃类别；尚无代码 | durable-execution.md |
| G — Supervisor | 仅设计说明（sidecar 理由） | supervisor-design-note.md |
| H — 诊断/基准测试 | pnpm diagnostics、pnpm bench [--json] | benchmark-methodology.md |
| I — 兼容性/分发 | 版本下限 + 降级矩阵已记录 | compatibility.md |
| 延续性研究 | continue-as-new 词汇/边界已起草（仅研究） | session-continuation.md |

Phase 0 历史与基线表：docs/baseline-results.md。

许可证与联系方式

MIT — 见 LICENSE。安全披露流程见
SECURITY.md。联系方式：contact@fentz.dev。