DSH Plugins
返回列表
⚙️

dsh-hashline

工作流 更新于 2026.11.02

在终端中运行以下命令:

dsh plugin install LIghtJUNction/dsh-hashline

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install LIghtJUNction/dsh-hashline 安装该插件(源码仓库:https://github.com/LIghtJUNction/dsh-hashline),构建后重启目标 profile 并在工具列表确认 hashline_read 与 hashline_edit。

插件介绍

在 Agent 反复读写工作区文件时,最常见的风险不是「改错行」,而是基于过时的快照覆盖别人或外部进程刚刚写入的内容。DSH 内置的 read/edit 能完成基本操作,却缺少「读时打锚、写前验真」的协作式安全网。dsh-hashline 正是为这种场景补上一道门:每次读取返回整文件的 SHA-256 revision 以及带行哈希的锚点,编辑时必须携带这些凭证,插件才会在提交前再次核对 revision 与选定行的内容哈希。

核心能力集中在两个独立工具 hashline_read 与 hashline_edit 上。读取支持分页(offset 从 1 起),返回 revision、形如行号:哈希|原文的 lines 以及 nextOffset;编辑支持替换、插入与删除,并尽量保留原文件的换行风格、末尾换行习惯与普通权限位。写入走同目录临时文件加原子 rename,且在落盘前做最后一轮校验。需要强调的是:任何在读取之后发生的变化——哪怕不在你打算编辑的范围内——都要求重新读取后再改,这是设计取舍,不是疏漏。

插件只面向宿主机本地文件系统,通过 workingDirectory 或显式 root 限定工作区,并拒绝符号链接、.git 元数据、目录、非 UTF-8 内容、混合换行和超大文件等边界情况。它不使用 DSH remote world 或 sandbox 文件接口,也不提供跨文件事务、readmap 或语法检查等尚未实现的能力。

适合在 DeepSeek Harness Agent 工作流里、需要在本地仓库做精细行级编辑、又希望降低「静默覆盖」风险的开发者与插件作者。若你主要操作远程沙箱或依赖模糊锚点重定位,应继续评估内置工具或其它方案;若你在 rc.2 环境本地迭代 Cordis/ToolRuntime,这套带 revision 的行锚点读写会更贴合协作式编辑的预期。

使用场景

  • Agent 分页读取大文件并在精确行号处打锚后再改
  • 多轮对话中避免用过期快照覆盖本地刚变更的内容
  • 在 monorepo 本地仓库做行级替换、插入或删除且保留换行习惯

适合人员

  • 在 DSH Agent 工作流里频繁读写源码的开发者
  • 需要 revision 校验而非盲写的插件与工具作者
  • 只在宿主机本地文件系统内操作、可接受严格边界限制的团队