前言¶
DeepSeek Harness (DSH) 采用插件化架构,允许用户按需扩展功能。在进行智能体开发或代码审查时,开发者通常需要同时查看代码和与 AI 对话。dsh-code-ui 是一个客户端插件,它将 Cursor 编辑器的核心体验——文件树、多标签页编辑、语法高亮——以及行内引用/翻译功能引入 DSH,提供边看代码、边与 AI 对话的工作台。
核心功能¶
插件提供以下能力:
- 双布局可选:支持右侧停靠(默认布局,与聊天并排)和悬浮窗口(可拖拽浮动窗口)两种模式。
- 切换入口:支持悬浮模式条(默认)或会话头按钮两种切换方式,两者可独立配置。
- 代码编辑:内置文件树、多标签页、语法高亮(基于 highlight.js 11,支持 193 种语言)。支持展开目录、打开文件、直接编辑、Ctrl+S 保存。
- 行内交互:选中代码右键可进行引用、翻译、备注或复制。翻译或引用后生成行内 chip,点击可跳转,发送后由 AI 工具读取。
- 主题管理:支持跟随 DSH、跟随系统、浅色、深色四种主题状态。
安装¶
通过官方命令一键安装:
dsh plugin --profile web add dsh-code-ui
安装完成后重启 DSH。编辑器默认隐藏(dsh UI 模式),不自动占屏,需通过顶部悬浮模式条的 code UI 按钮唤出。
使用方法¶
- 打开编辑器:点击顶部悬浮模式条的
code UI打开编辑器(默认切换按钮;也可在插件卡片换成会话头按钮)。默认布局为右侧停靠。 - 浏览文件:在文件树/浏览器里打开文件。
- 引用与翻译:选中代码右键 → 引用 / 翻译 / 备注 / 复制。
- 发送消息:
- 悬浮布局:在底部输入框直接输入,Ctrl+Enter 发送。
- 停靠布局:使用 DSH 原生输入条。
- AI 读取:对 AI 说“读取我引用的代码”,AI 会通过工具获取片段。
注意事项¶
- 数据存储:文件数据存储在运行期内存中,重启后清空。
- 高亮机制:依赖 highlight.js,若加载失败或 Electron 环境(file:// 协议),会自动回退内置轻量 tokenizer。重高亮带有约 60ms 防抖,且对 512KB 以上的大文件会降级处理。
- 会话隔离:根目录按会话隔离,切换对话时自动切换工作区根目录。
- 未保存确认:标签页右键菜单关闭未保存文件时,会弹出确认框。
结尾¶
该插件由 sogoodayo 维护,遵循 MIT 协议。更多细节可访问 GitHub 仓库。