dsh-code-quote

DSH（DeepSeek Harness）Web 输入框的代码引用折叠插件：把「路径：行号 + 代码」粘贴自动折叠成一行紧凑引用，发送时把完整代码快照内联给模型。

这是什么

在没有行内引用机制之前，往 DSH 输入框粘贴一段带 路径:行号 头的代码，它会以原始多行文本进入草稿和消息。本插件提供「方案 b（内联快照）」体验：

• 输入框：粘贴后自动折叠成一行 token —— ⟦代码引用#qxxx|dsh-web-launcher/package.json:13-15⟧，Ctrl+Z 一步还原；
• 气泡：发送后用户消息保持紧凑 token；
• 模型：agent/pre-step 在消息进入模型前，把粘贴时落定的完整代码快照作为一条独立的上下文消息追加进批次（UI 中渲染为可展开的「上下文注入」行，后续轮次持续可见）。

数据是快照口径：折叠那一刻的代码内容被留存，之后文件怎么改动都不影响这条引用；快照持久化到 <DSH_HOME>/storages/dsh-code-quote/snapshots.json，进程重启后仍可用——「快照已失效」提示仅作为文件损坏/被删等极端情况的回退，不静默失败。

工作原理

粘贴「header + 代码体」
  → 浏览器半（conversation.input.dock 条目）识别形态
      → POST /dsh-code-quote/put 存快照 {id, header, code}
      → inputActions.setDraft 折叠为 ⟦代码引用#id|header⟧（一次可撤销事务）
发送
  → 持久日志 = 紧凑 token（气泡紧凑）
  → agent/pre-step：先 await next() 委托下游，再对 enter 批次扫描 token，
      追加 source={kind:'plugin', plugin:'dsh-code-quote'} 的独立上下文消息
  → 模型看到完整代码快照

token 形态契约（client 与 host 两半必须同形）：⟦代码引用#<id>|<header>⟧， 其中 <id> 为插件生成的 q + ≥7 位 base36（文档示例里的字面模板如 #id 不会被扫描注入）， <header> 为不含 ⟦/换行的任意文本（≤300 字符）。

安装

# ① npm 包名直装（推荐——免构建授权步骤）
dsh plugin --profile web add dsh-code-quote

# ② GitHub Release 预构建 tarball
dsh plugin --profile web add https://github.com/hanrr92/dsh-code-quote/releases/download/v0.2.0/dsh-code-quote-0.2.0.tgz

# ③ GitHub 源码 tarball（pinned）
dsh plugin --profile web add https://codeload.github.com/hanrr92/dsh-code-quote/tar.gz/<sha>

# 安装后需重启 profile：bundle 成员在启动时固定

国内网络下 npm 安装走 npmmirror 镜像即可；包本身无构建步骤，三种方式效果一致。

cordis.patch.yml 会经 dsh.bundle.patch 在 reconcile 时自动把插件加入 profile 组合；无需构建步骤（源码即 ESM 直发）。安装后重启，浏览器端 client bundle 重新下发即可生效。

卸载

卸载方法见 UNINSTALL.md。最常用一行：

dsh plugin --profile web remove dsh-code-quote

（推荐）之后重启 profile 即从运行组合移除。

使用与识别规则

把下面这种格式粘贴进输入框（编辑器选中复制即可）：

dsh-web-launcher/package.json:13-15
  "bin": {
    "dsh-web-launcher": "bin/dsh-web-launcher.js"
  },

识别条件（最小版故意保守，防误判）：

条件	值
首行	路径:行号 或 路径:起始-结束（整行匹配，可含路径分隔符）
代码体	至少 1 行非空代码；单行代码需 ≥40 字符
插入长度	≥30 字符且含换行
排除	纯文本无 header、已含 token 字符 ⟦ 的文本

折叠是异步确认的：快照落库成功且草稿未再变化才替换；期间你继续输入则放弃本次折叠。

行为边界

• 识别阈值偏保守：无 header 的纯代码粘贴不会折叠（后续版本可加）；
• 折叠后光标可能跳到输入框末尾；
• 快照保存失败不再静默：右下角出现「代码引用折叠失败」轻提示，4 秒自动消失；
• 快照持久化于 <DSH_HOME>/storages/dsh-code-quote/snapshots.json（上限 64 块 / 单块 128KB，LRU 淘汰），进程重启后自动载回；存储不可用时退化为内存 LRU，文件损坏/被删则回退「快照已失效」提示，不阻塞发送；
• 与会话内动态版插件（如 quote-1）二选一：两者都监听 agent/pre-step，同时启用会重复注入。

开发

src/plugin.js    Host 半：/dsh-code-quote/put 路由（same-origin 校验）+ agent/pre-step 注入 + 快照原子持久化（tmp+rename）
client/client.js 浏览器半：dock 条目、粘贴识别与折叠、fetch 存快照
cordis.patch.yml bundle 成员声明（reconcile 时插入 profile 组合）
test/persistence.test.mjs 持久化自测（put / 重启存活 / 失效回退）

调整识别阈值：默认内置（插入 ≥30 字符、单行代码 ≥40 字符），可用环境变量 DSH_CODE_QUOTE_MIN_INSERTED / DSH_CODE_QUOTE_MIN_SINGLE_LINE_CHARS 覆盖；客户端启动时经 GET /dsh-code-quote/config 拉取一次，拉取失败沿用内置默认。token 形态若变化，需同步修改 src/plugin.js 的 TOKEN_RE 与 contextText。

真 chip 模式（实验，默认关）：设环境变量 DSH_CODE_QUOTE_CHIP_MODE=1 后，折叠产物在输入框中成为可退格删除的真引用 chip，发送时仍序列化为紧凑 token，host 快照注入链路不变。该模式依赖 DSH 引用机制的 span 区间替换语义，若发现粘贴后原始代码未被替换，请关闭该开关并提 Issue 反馈。

持久化自测：node test/persistence.test.mjs。

License

MIT