dsh-file-context
在终端中运行以下命令:
dsh plugin install LIghtJUNction/dsh-file-context
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install LIghtJUNction/dsh-file-context,或从 https://github.com/LIghtJUNction/dsh-file-context 的 Release 安装构建包后重启 DSH。
插件介绍
在本地项目里和智能体协作时,模型往往只能看到「当前这一刻」的文件内容:你刚让它分析某段代码,磁盘上的文件可能已经改了,后续对话里再引用同一路径,上下文会对不上。dsh-file-context 面向 DSH 0.2.x,用只读、带修订校验的方式把文件片段和 Git diff 变成可复用的工具结果,而不是把整盘文件系统交给模型。
插件提供三类能力:按行范围捕获不可变摘录(可省略范围以读取文件前 500 行),用 id 在源文件变更后仍取回当时捕获的原文,以及相对 HEAD 或指定 commit 的工作区 diff。摘录与 diff 都可配合 expectedRevision,在文件或 diff 内容与预期不一致时明确拒绝,避免在静默漂移上继续推理。操作范围限定在你配置的 canonical 工作区根目录内,并拒绝路径穿越、.git 段、符号链接文件等高风险读法;不提供任何写文件能力。
快照保存在主机内存中(总量上限 64,卸载或重启 DSH 会清空,释放 agent 会清该 agent 的快照),适合需要「先钉住一段上下文,再对照 Git 变更」的本地开发场景。它不提供 Pi 文件浏览器、预览或自动注入下一 prompt,也不是远程 world 适配器或安全沙箱——请在可信的本机工作区启用。
适合在 DSH 里跑 coding agent、希望工具层能稳定交付「某次捕获的原文」和「相对 HEAD 的 diff」的开发者;若项目不在 Git 仓库根、或依赖已删除/未跟踪文件的 diff,需知悉 README 中的边界与限制。
使用场景
- 先捕获某文件的固定行范围,再在文件改动后继续引用当时原文
- 对照 HEAD 或指定 commit 查看工作区中某路径的 Git diff
- 在修订校验失败时停止推理,避免基于已变更文件继续分析
适合人员
- 在 DSH 中运行 coding agent 的本地开发者
- 需要可复现、带 id 的文件摘录而非瞬时读盘的团队
- 只在可信本机工作区启用只读文件工具的用户