前言¶
在使用 DeepSeek Harness (DSH) 进行开发时,往输入框粘贴一段带路径的代码,如果没有引用机制,它通常以原始多行文本进入草稿。dsh-code-quote 插件提供了一种“方案 b(内联快照)”的体验:输入框内自动折叠成一行紧凑引用,发送时将完整代码快照作为独立上下文消息内联给模型。
这是什么¶
dsh-code-quote 是 DeepSeek Harness Web 输入框的代码引用折叠插件,由 hanrr92 维护。它解决了代码粘贴冗长、模型无法获取完整上下文的问题。
核心功能¶
- 自动折叠引用:粘贴带路径行号的代码自动折叠为紧凑引用。
- 真 Chip 模式:默认开启真 chip 模式,支持 Ctrl+Z 还原。输入框中直接显示文件图标 + 文件名:行号。
- 侧边栏支持:支持 dsh-better-sidebar 侧边栏的“添加到对话框”功能,选中 >500 字符的代码可自动折叠。
- 快照持久化:代码快照持久化到本地,进程重启后仍可用,模型可获取完整代码上下文。
- 形态兼容:支持新旧 token 形态兼容。
- 快照管理:快照上限 64 块 / 单块 128KB,采用 LRU 淘汰策略。
安装与启用¶
安装插件需要执行以下命令:
dsh plugin --profile web add dsh-code-quote
安装后需重启 profile 使配置生效。
典型用法¶
- 粘贴引用:在编辑器中选中代码,复制包含路径和行号的部分(例如
dsh-web-launcher/package.:13-15),粘贴到 DSH 输入框。 - 侧边栏引用:在侧边栏选中代码(大于 500 字符),点击“添加到对话框”,插件会自动识别并折叠。
- 发送:发送消息时,插件会将完整代码快照作为独立上下文消息追加给模型。
注意事项¶
- 冲突处理:与动态版插件(如
quote-1)二选一,同时启用会重复注入。 - 环境要求:需要 Node >= 20 环境,依赖
@deepseek-ai/cordis ^4.0.1。 - 配置切换:默认开启真 chip 模式。若需退回 token 模式,可设置环境变量
DSH_CODE_QUOTE_CHIP_MODE=0。 - 识别阈值:识别阈值偏保守,纯代码无 header 不会折叠。
- 快照限制:快照上限 64 块 / 单块 128KB(LRU 淘汰)。
总结¶
dsh-code-quote 通过将代码粘贴操作转化为结构化引用并持久化快照,有效解决了 DSH 上下文窗口中代码展示冗长的问题。开发者可以使用 Ctrl+Z 快速撤销,侧边栏也能无缝支持,适合需要频繁引用项目代码进行调试或开发的场景。