dsh-file-mount

DeepSeek Harness 插件：文件增量挂载 + 重复读取去重。记录每个文件哪些行范围已经进入模型上下文，重复读取只补缺失部分，文件在磁盘上变化时自动失效重挂，并提供一个「挂载文件」标签页实时展示账本。

移植自 piwpi 的 context-mount 机制。

效果

• 模型侧：读过的行范围不重复进上下文（去重 marker），新内容只注入缺失区间（增量挂载），磁盘变化即失效重挂（版本感知）；渲染格式确定，prompt 前缀缓存稳定。
• 界面侧：对话区出现「上下文注入 · file-mount」折叠行（摘要显示本次节省，如「saved ≈ 300 tokens」）；轨迹页出现对应 context 记录；对话区标签栏新增「挂载文件」标签页，实时列出路径、指纹、已挂载行范围与状态，顶部显示本次会话累计节省 token 数。
• 节省统计：按「字符数 ÷ 4」粗略估算（去重 = 整个被去重窗口，增量 = 已覆盖区间）；累计值跨文件变化与会话恢复保持一致。

安装

# 从 npm
npx @deepseek-ai/dsh plugin --profile web add dsh-file-mount

# 或从 GitHub（需在 profile 的 pnpm-workspace.yaml 里授权该包的 prepare 构建）
npx @deepseek-ai/dsh plugin --profile web add github:you/dsh-file-mount

# 或本地目录 / tarball
npx @deepseek-ai/dsh plugin --profile web add file:../dsh-file-mount

npx @deepseek-ai/dsh --profile web

一个包两面：dsh.bundle.patch 挂载宿主插件行，dsh.client manifest 让 Web 端扫描出浏览器半部，无需额外配置。

配置

- id: file-mount
  name: dsh-file-mount
  config:
    enabled: true      # 总开关；关闭后所有读取原生透传
    capacity: 32       # 文件身份缓存容量（挂载中文件不受淘汰影响）
    ttlMs: 300000      # 缓存安全阀：同 stat 内容被改的兜底重读间隔

工作原理

插件挂在 tools/post-execute 拦截面：

1. 以 read 工具返回的 canonical value（path/offset/lines/totalLines）为准确定本次窗口；
2. 经 stat 校验式缓存（mtime+size 快路径 + sha256）核实磁盘身份；
3. 三分支决策：完全覆盖 → 结果换成去重 marker 并注入一条「saved ≈ N tokens」笔记消息；部分覆盖 → 结果换成短 marker + 经官方 additionalContexts 通道注入缺失区间（source 携带节省量）；hash 变化 → 声明文件已变更并整体重挂；
4. 挂载状态结构化写入注入消息的 source（标准 user/message 事件），恢复重放与浏览器折叠共用同一载体。

已知限制

• compaction 后「已挂载」保证失效：DSH 尚未把压缩纳入拦截面，插件在会话压缩重建时清空账本，重新挂载从下一轮读取自然恢复。
• 增量 / 去重 / 重挂载替换了结果文本，UI 的 read 卡片降级为通用卡片（canonical value 完整保留）。
• 依赖 read 工具 canonical value 的结构；结构变化时守卫失效并原生透传（集成测试锁定该结构）。
• 自定义会话事件类型在 rc.6 无法安全持久化（加载路径硬性拒绝未知类型），故账本载体选用标准事件上的结构化 source；DSH 开放外部事件类型注册面后可迁移。

开发

pnpm install
pnpm test        # vitest（60 用例：单元 + 真实 read 循环集成 + 持久化往返 + 客户端组件）
pnpm typecheck   # tsc --noEmit
pnpm run build   # tsc + tsdown（lib/index.js / lib/invariant.js / lib/client.js）

依赖 DSH 0.1.0-rc.6（peer 依赖 @deepseek-ai/dsh-*、@deepseek-ai/cordis ^4、React 18）。

License

MIT