DeepSeek Harness (DSH) 的右侧栏通常用于文档展示。开发者在处理代码时,经常需要在查看代码、引用特定行或搜索工作区文件之间切换。dsh-sidebar-editor 解决了这个痛点。它是一个免构建的 DSH 插件,在右侧栏的文档面板中提供彩色代码预览、按名字搜索工作区文件,并将选中行一键引用进对话框。
核心功能¶
右侧栏预览与引用¶
在右侧栏文档面板中彩色预览代码文件,支持按行渲染。插件内置分类着色,覆盖注释、字符串、关键字、函数名等多种语法元素。点选行或拖选多行,选中行会实时显示在面板上方。点击「引用选中行」按钮,会将 @路径 L10-L20 格式插入到对话输入框。工具条提供「引用整个文件」和「引用所在目录」按钮,也可通过菜单项操作。
工作区搜索与定位¶
在文件面板工具栏(路径栏最左)的搜索框输入名字,可匹配工作区文件和文件夹。按 Ctrl/Cmd+Shift+P 可直接打开文件面板并聚焦搜索框。点击搜索结果,若为文件会自动展开并高亮;若为文件夹则只展开定位。打开文件后,工具条上的「查找」按钮或 Ctrl+F 可在当前文件内查找内容,支持跳转和计数。
文件树快捷操作¶
在右侧文件树的行上右键,可直接选择「引用整个文件」、「引用这个目录」或「复制绝对路径」。此功能不依赖先打开文档面板,直接作用于文件树。
其他特性¶
- 大文件处理:超过 4000 行时自动关闭着色,仅显示纯文本,行仍可选可引用。
- 编辑与保存:默认关闭。插件 bundle 中包含编辑器与保存逻辑,但出于浏览器撤销栈兼容性和侧栏不适合写代码的考虑,默认形态为只读预览。
注意事项¶
- 编辑与保存默认关闭:如需启用,需在
client.js中修改editingEnabled()的返回值。受控<textarea>会清空浏览器的原生撤销栈,且侧栏环境不适合进行完整的代码编辑。 - 搜索限制:搜索功能不认识
.gitignore,也不做模糊评分,仅按文件名匹配。 - 文件树右键行为:在文件树右键会顶掉浏览器的原生菜单。
- 宿主接口:插件在宿主端注册了
POST /api/sidebarEditor/save路由用于保存文件。
总结¶
dsh-sidebar-editor 通过在 DSH 右侧栏提供代码预览和引用能力,简化了查看代码和引用文件的操作流程。插件采用预览优先的设计策略,默认为只读模式,适合开发者快速查阅和引用代码片段。