dsh-recover-context
v1.1.2 · 适配 DeepSeek Harness 0.2.1+
恢复上下文插件。
- ↶：点击后，这个问题及其之后的所有内容（对话上下文 + 工作区里产生的文件变更）都会被回退掉——旧会话归档保留日志，新会话从提问之前继续。之后你可以换个方向重新提问，模型不会再被错误的上下文干扰。
- ✎：点击把原问题文本载入输入框，此时不改变任何上下文；编辑后提交的那一瞬间执行回退并重新提问。
安装
dsh plugin --profile web add dsh-recover-context@latest
安装后插件会自动挂载到 web 组合，无需手工编辑 cordis.patch.yml。
本版本要求 DSH >= 0.2.1-rc.2：使用了该版本的 Connection Fetch 路由、SessionPersistence 与
uiConversation / useChat 客户端契约，与更早的版本不兼容。
工作区追踪
插件把工作区快照存放在 ~/.dsh/storages/recover-context/<sessionId>/ 下（绝不写入工作区）：
baseline.json 基线元数据索引（仅 {路径: {sha,size,mtime}}，不含文件内容）
turn-<n>.json 每轮结束时的元数据索引
blobs/<sha> 按内容寻址（CAS）存储的文件内容
- 基线/逐轮索引：只记录文件清单与哈希，单个 JSON 通常在几十 KB 量级。
- 内容按哈希去重：文件内容按 SHA-256 存成独立 blob，跨轮次、跨同名文件自动复用；恢复时按索引取回。
- 流式哈希与原子落盘：SHA-256 用流式计算；所有 JSON 与 blob 先写临时文件再
rename，进程中断不会留下半成品。
- 自动读取
.gitignore：遍历时解析工作区根目录的 .gitignore（支持通配符、目录规则、! 取反），大型数据目录不会被扫描。
- 被忽略路径也会被回退：被忽略路径不备份内容，但会记录其存在性索引。回退时只删除「本会话新增」的
产物（如
dist/、build/、*.log），会话开始前就存在的同类文件保持不动。
- 基线在会话创建时采集：早于任何提问与工具调用，因此稳定代表"工作开始前"的状态。
这正是编辑/回退能可靠撤销本轮产物的前提。
- 子会话继承父会话历史：回退后打开的新会话会继承父会话的基线与已完成的逐轮快照，
因此在其中继续编辑/回退同样能撤销此前轮次的产物，而不是逐层失效。
- 跨会话识别遗留产物：插件维护一份工作区级产物台账，记录每个会话产出过哪些文件。
上一个对话留在工作区里的产物，会在下一个会话回退/编辑到基线时被一并清除——
前提是内容与台账记录完全一致（被改动过的文件视为用户资产，绝不删除）。
- 还原失败不会静默通过：目标快照不可用时接口报错、客户端中止流程，绝不出现
"对话回退了但文件没动"的不一致状态；还原后还会自检文件是否真的已删除。
- 安全上限：
maxFiles（默认 100,000）与 maxTotalBlobBytes（默认 512 MiB）防止超大仓库失控。
单文件默认不限体积（流式复制，内存恒定），可用 blobSizeCap 显式收紧。
配置
可选配置文件：~/.dsh/storages/recover-context/config.json
{
"enabled": true,
"enableGitignore": true,
"ignoreNames": [".git", "node_modules", ".pnpm-store", "dist", "build", ".venv", "__pycache__", ".DS_Store"],
"ignorePatterns": ["*.pyc", "*.log", "*.tmp"],
"trackSizeCap": 104857600,
"maxFiles": 100000,
"maxTotalBlobBytes": 536870912,
"ioConcurrency": 8,
"cleanupPreviousArtifacts": true
}
| 字段 | 说明 |
|---|
enabled | 总开关，false 时完全停止采集 |
enableGitignore | 是否解析工作区 .gitignore |
ignoreNames | 按名字忽略的目录/文件 |
ignorePatterns | 按文件名通配符忽略 |
trackSizeCap | 超过该大小的文件只记录 size+mtime，不计算哈希、不备份内容（默认 100 MiB） |
blobSizeCap | 可选：单文件内容备份上限，默认不限制（受 maxTotalBlobBytes 兜底） |
maxFiles | 扫描文件数上限，超出即停止并告警 |
maxTotalBlobBytes | 单个会话可备份的 blob 总字节上限 |
ioConcurrency | 哈希计算与 blob 写入的并发度 |
cleanupPreviousArtifacts | 回退/编辑到基线时，是否清除上一个对话遗留的产物（默认 true；只删内容未被改动过的） |
License
Apache-2.0
