dsh-hashline

一个 DeepSeek Harness（dsh）插件：把 hashline 行寻址文件编辑器封装为 dsh 原生工具 hashline。

English documentation: docs/README.EN.md

特性

• 内嵌二进制：npm 包自带 hashline 各平台二进制，安装即可用，无需系统安装。
• 原生工具：注册为 dsh 工具 hashline，可直接替代默认的 str_replace_editor。
• 稳定行寻址编辑：读取文件时带 [path#HASH] 快照头和行哈希，编辑基于行号，避免脆弱的字符串替换。

安装

dsh plugin --profile web add dsh-hashline

配置

- insert:
    - id: dsh-hashline
      name: 'dsh-hashline'
      config:
        binaryPath: ''            # 可选：自定义 hashline 二进制路径
        maxOutputChars: 16000     # 工具输出最大字符数
        timeoutMs: 60000          # 单次调用超时

替代默认文件编辑器

在 cordis patch 中禁用默认编辑器并注册 hashline：

- id: tool-str-replace-editor
  disabled: true

- insert:
    - id: dsh-hashline
      name: 'dsh-hashline'

工具用法

插件注册 6 个独立工具，每个工具的必填参数有强校验：

工具	参数	说明
hashline_read	path	读取文件，返回 [path#HASH] 快照头 + 带行哈希的编号行
hashline_patch	path, patch, dry_run?	应用 hashline patch（SWAP/DEL/INS.*/SWAP.BLK/...）
hashline_write	path, content, force?	写入完整文件内容
hashline_remove	path	删除文件
hashline_rename	path, target	重命名（移动）文件
hashline_find_block	path, anchor	查找行锚点所在的语法块

示例 patch 文本：

SWAP 2:
+新的第二行

DEL 3

INS.TAIL:
+新增的末尾行

支持平台

平台	内嵌二进制
macOS arm64	hashline-macos-arm64
macOS x64	hashline-macos-x64
Linux x64	hashline-linux-x64
Windows x64	hashline-win32-x64.exe

Linux arm64 暂无官方 release 资产，请从源码安装并通过 binaryPath 指定。

二进制来源

内嵌二进制来自 hashline releases v0.9.12。

许可

MIT