前言¶
DeepSeek Harness（DSH）的会话是追加型的事件日志。当调度器在工具调用期间抛出异常，且 tool/call 被持久化但 tool/result 未被记录时，会话会产生“提供者可见的转录缺陷”。后续的模型请求会因协议错误（如缺少工具结果）而失败，且单纯发送新消息无法修复这种已损坏的历史记录。需要一种机制来诊断这些缺陷，并从安全的边界继续。
插件定位¶
dsh-session-integrity 是一个用于诊断 DeepSeek Harness 会话完整性故障并提供非破坏性恢复的插件。它旨在区分提供者可见的转录缺陷与已被压缩隐藏的原始执行缺口，并找到安全的恢复边界。
- 名称：dsh-session-integrity
- 所有者：DON738110198
- 类别：工作流
- 许可证：MIT
核心功能¶
该插件提供以下能力：
- 会话扫描：在会话加载时以及在回合结束时扫描实时会话。
- 离线诊断：通过 CLI 检查导出的 JSON 或未压缩的 JSONL，无需启动模型请求。
- 缺陷分离：将提供者可见的转录缺陷与已被压缩隐藏的原始执行缺口区分开。
- 隐私报告：使用哈希引用报告，省略提示词、工具参数和工具结果。
- 恢复规划：找到最新已完成的前缀，该前缀仍可安全发送给提供者。
- Web 集成：在 Web 插件中为历史助手回合添加“从这里继续”。它创建一个分叉（fork）会话，同时保留原始会话。
- 安全操作：分析器和规划器为只读。恢复使用 Harness 的公共 Fork API，而不是重写持久化历史记录。
- 安全契约：永不突变、破坏、删除或替换源会话中的事件。恢复通过 Fork API 创建子会话。它从不重试工具，也不声称外部副作用已回滚。
安装与启用¶
通过官方插件命令安装。安装后，插件会在会话加载时检查会话，并在回合结束时再次检查。
dsh plugin --profile web add github:DON738110198/dsh-session-integrity#v0.2.1
dsh --profile web --dump-config
dsh --profile web
典型用法¶
插件通过 CLI 执行，支持扫描和恢复模式。
扫描会话完整性：
dsh plugin --profile web exec dsh-session-integrity ./session.l
dsh plugin --profile web exec dsh-session-integrity ./session.l -- > integrity-report.
生成恢复计划：
dsh plugin --profile web exec dsh-session-integrity recover ./session.l -- > recovery-plan.
dsh plugin --profile web exec dsh-session-integrity recover ./session.l --at 42
注意：恢复命令输出计划，不修改源文件或实时会话。
适用场景与注意事项¶
- 适用场景：当模型请求因协议错误（如缺少工具结果）而失败，且怀疑是会话历史被破坏时。
- 注意事项：
- 插件以当前 DSH 进程权限运行。
- 插件不实现硬删除；当前公共持久化服务没有后端独立的会话删除操作。
- 包未发布到 npm；因此不支持
npx dsh-session-integrity。 - Zstandard 日志未独立解码；使用 Harness 导出或未压缩后端。
- 该插件通过 Harness 的 Fork API 创建子会话，而非重写历史记录，因此不承诺回滚外部副作用。
生态背景¶
DeepSeek Harness 理念是“一切皆插件”。社区目录（如 SkillHub）提供了插件索引，但与 DeepSeek 或幻方无官方从属关系。外部贡献目前通过 Discussions、插件和社区支持路由，而非外部 Pull Requests。
短结尾¶
dsh-session-integrity 提供了诊断会话缺陷和生成安全恢复计划的原语，无需修改源会话。它通过 Fork API 将风险降至最低，确保原始数据保持完整。更多细节请参考 GitHub 仓库。
