magian1127/deepseek-harness-hashline

README 摘要

deepseek-harness-hashline 中文 · English ⚠️ 测试中（experimental） 当前仍处于测试阶段，请勿用于正式项目。 使用本插件所带来的一切风险由使用者自行承担。 接口、配置项和工具行为可能随时变更，恕不另行通知；在真实工作区启用前请先在隔离环境充分验证。 DeepSeek Harness 哈希锚点文件编辑插件 ：提供 hashline read 和 hashline edit ，用 LINE:HASH 联合锚点把编辑绑定到模型最近读取过的具体行内容，解决同一文件多轮修改、多处原子修改、 CRLF/LF 或空白漂移时的机械可靠性问题。 默认模式补充内置 read / edit ：新文件仍用 write ，简单且唯一的文本替换仍可用内置 edit ； 需要锚定编辑时使用 Hashline。也可在配置中开启“替换内置读写”，让允许编辑的智能体直接以 read / edit 名称使用哈希锚点格式。 功能 能力 说明 LINE:HASH 读取 LINE:HASH\ 内容 格式，默认 4 位十六进制 SHA-256 前缀，哈希覆盖完整行和真实行尾 三种锚定编辑 set line 、 replace lines 、 insert after 精确替换逃生舱 replace 严格精确匹配（CRLF↔LF 自动归一），默认要求唯一匹配 原子批量编辑 一次调用全部锚点先校验、重叠先拒绝，再原子写入 版本 CAS 保护 使用 DSH 文件版本防止校验后到写入前的并发覆盖 文本保真 保留 UTF-8 BOM、LF/CRLF 和文件末尾是否有换行 失效恢复 唯一哈希匹配自动重定位；否则返回附近当前行，坏锚点报错回显真实锚点 可逆替换 开启“替换内置读写”后，Agent scoped 覆盖可逆并随 Cordis Fiber 清理 环境要求 - DeepSeek Harness 0.1.0-rc.7 或兼容版本，默认 profile 为 web - Node.js ^22.19.0 =24.0.0 - 网页配置卡片还要求 DSH 包含 settings.register(..., { exposeToClients: true }) 支持 安装 把下面示例里的 换成你本机实际的绝对路径。源码目录的 lib/ 是构建产物；首次开发安装执行 npm install ，首次安装或源码更新后执行 npm run build ： 普通本地安装： 持续开发使用 link: 直接安装（新版运行时从 profile 解析 DSH peer，无需本地 junction）： 安装后检查组合： 更新 重新执行安装命令即可更新依赖和持久 bundle。浏览器端内容更新后刷新页面；使用本地 link: 开发时， 主机文件在 DSH HMR 服务可用时自动热重载，否则按日…

分类