前言¶
在 DeepSeek Harness (DSH) 的 Web 界面中,向模型提供代码上下文通常需要手动复制粘贴。这种方式不仅打断心流,还容易产生“草稿污染”(即代码意外进入可见的输入框)。针对这一场景,dsh-codex-select 插件通过模拟 Codex 的交互逻辑,实现了在文件树和查看器中直观地选中代码或文件,并自动将其转化为消息上下文。
插件定位¶
dsh-codex-select 是一个为 DeepSeek Harness Web GUI 设计的插件,由用户 light-only 维护。它主要解决“如何在 Web 界面高效地将文件或代码片段作为上下文发送给模型”的问题,替代了传统的手动复制粘贴方式。
核心功能¶
该插件主要提供以下能力:
- 懒加载文件树与只读查看器:左侧展示工作区文件树,默认跳过
node_modules和.git目录;右侧为只读文件查看器,支持 UTF-8 文本,限制为 1 MiB,拒绝二进制文件。 - Codex 风格的选择交互:在查看器中选中代码,或通过文件树行上的
+按钮加入文件,都会自动生成“引用芯片”(已选中 N 行 · 文件名)并插入到输入框上方,无需点击额外按钮。 - 无草稿污染与芯片管理:选中的内容不会进入可见的草稿文本,仅在发送时通过插件编解码器序列化为代码块。点击芯片上的
×可清除选择,新的选择会替换旧的选择。
安装与启用¶
安装命令如下:
dsh plugin --profile web add dsh-codex-select
dsh web
安装后需要重启 dsh web 服务,插件才会生效。
典型用法¶
- 安装并重启
dsh web后,打开一个会话,点击顶部的 文件 / Files 选项卡。 - 展开左侧的文件树,点击任意文件以在右侧查看内容。
- 在右侧查看器中选中需要提供的代码片段,输入框上方会自动出现引用芯片。
- 在输入框中输入你的 Prompt,发送消息。模型将直接使用选中的代码作为上下文。
- 若要移除当前选中的上下文,点击芯片上的
×即可。
适用场景与注意¶
- 适用场景:适合需要频繁向模型提供代码片段上下文,且希望保持输入界面整洁的开发者。
- 权限与安全:该插件的主机路由共享 Harness Web 服务器的信任模型。任何能访问 Harness Web 的人都可以列出和读取主机账户的绝对路径(与核心目录选择器权限一致)。插件本身是只读的,不会写入或执行文件。
- 格式限制:文件查看器仅支持 UTF-8 文本,且文件大小限制在 1 MiB 以内,超出该范围的二进制文件会被拒绝。
总结¶
dsh-codex-select 通过芯片化的交互设计,让代码上下文的传递变得流畅且不污染输入流。对于习惯使用 DSH Web 界面的开发者,这是一个提升效率的实用工具。更多详情可参考 GitHub 或 DSH 插件目录。