dsh-large-proj-perf

DSH（DeepSeek Harness）大会话性能插件。消除 fork、历史会话加载、超大会话落盘对 事件循环的阻塞，并治理冷会话内存——面向数十万事件的会话。

所有优化都带源码特征校验 + 协议探测 + 三层回退（能力探测 / try-catch / 配置 开关）：dsh 内部结构变化时补丁自动跳过并告警，绝不盲补。上游原生实现了某项能力后， 对应补丁自动从 active 转为 retired。

能力与效果

运行时状态经 stats.get 的 patches 字段暴露：active（已安装生效）、 retired（上游已原生实现）、inactive（环境缺失或特征漂移）、off（配置关闭）。

安装

要求 Node ≥ 22.15.0（node:zlib 的 zstd 接口），dsh 0.1.0-rc.6 ~ 0.2.1-rc.3。

# 从 GitHub 安装（推荐）
dsh plugin --profile web add github:orangeofcarl0-sys/dsh-large-proj-perf

# 从 npm 安装
dsh plugin --profile web add dsh-large-proj-perf

# 本地开发
dsh plugin --profile web add file:<本仓库路径>

重启 dsh web 后，启动日志出现 [dsh-perf] installed (...) 即装载成功。

file: 安装不跟随源码改动。改完代码需把 lib/、cordis.patch.yml、 package.json、icon.svg、locale/ 同步到 <DSH_HOME>/profiles/web/node_modules/dsh-large-proj-perf/，或重新 dsh plugin add。

建议同时调高 V8 heap 上限

多个大会话并存时，每个 live 事件树约 700MB，默认 ~4GB 上限容易 OOM。heap 上限是 启动期参数，进程内改不了。用仓库脚本启动（内置 --max-old-space-size=8192）：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-dsh.ps1

插件会在上限低于 6GB 时打告警，但不代为修改。

配置

可经 Settings 卡片、config.set API 或 settings 持久化修改。数值项带下限钳制 （如 materializeChunkEvents ≥ 1000、chunkSize ≥ 1），NaN/Infinity 直接拒绝。

验证是否生效

启动日志会打印探测到的 dsh 版本与各补丁安装结果：

[dsh-perf] dsh version: 0.2.1-rc.3 (verified)
[dsh-perf] zero-copy fork installed (SessionStore.prototype.fork patched, protocol: 0.1.7 forkSeed)
[dsh-perf] chunked materialize installed (chunk=50000 events/frame, protocol: 0.1.3)

出现 signature mismatch 说明 dsh 内部结构已变，对应补丁跳过（功能回退到官方实现， 不会出错）。此时升级插件或运行兼容性检查：

node tests/verify_compat.mjs

HTTP API

POST http://127.0.0.1:3080/dsh-large-proj-perf/api/<method>（仅回环 + 同源）：

curl -X POST http://127.0.0.1:3080/dsh-large-proj-perf/api/stats.get
curl -X POST http://127.0.0.1:3080/dsh-large-proj-perf/api/config.set \
  -H 'Content-Type: application/json' -d '{"key":"backfillOnBoot","value":true}'

已知限制

• 这是被动优化，削减不了正在使用的 live 事件树（每会话几百 MB 是物理成本）。 建议配合 dsh-fresh-start 主动控制会话规模：/fresh 一键「总结 → 开新会话 → 归档老会话」。
• backfillOnBoot 的解码在插件层同步执行（虽按 chunkSize 分片让出），超大文件 仍可能短暂冻结事件循环，故默认关闭。
• preparedCacheTrim 在新版 dsh 上自动跳空为 inactive（上游已系统代偿）；仅在 老版本 dsh 上真正生效。
• 与其他插件不冲突，但若某个行管理类插件禁用了 session-projection-cache， 本插件的缓存与预热能力会被削弱。

开发

# 链接全局 dsh 的嵌套依赖（仓库本身无 node_modules）
powershell -ExecutionPolicy Bypass -File .\scripts\link-deps.ps1

# 全套 8 套件 147 断言
npm test

测试分两层：verify_compat 对真实安装源码做特征断言与门禁实算；e2e_real_components 直接驱动 dsh 的真实实现类（JsonlSessionPersistence / SessionProjectionRegistry / SessionStore），逐点位验证「补丁装上 → 行为正确」。其余套件覆盖逻辑与边界。

更多文档

License

MIT