前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在纯聊天界面中处理代码文件和终端命令通常需要切换上下文或使用外部工具。dsh-ide-lite 插件将「文件」和「终端」标签页直接集成到 DSH WebUI 的会话界面中，为开发者提供一个轻量级的本地编辑与运行环境。
插件简介¶
dsh-ide-lite 是一个由 justarook1e 维护的轻量 IDE 插件。它将文件浏览、编辑、Agent 变更审阅以及集成终端功能注入到 WebUI 会话中。插件遵循 MIT 许可证。
核心功能¶
- 工作区侧边栏：提供项目文件树（按层加载、Git 状态着色、
.gitignore灰显）及会话历史管理（新建、切换、置顶、删除）。 - 文件浏览与编辑：支持 24 种语言语法高亮、Markdown 渲染。提供独立的撤销/重做栈（仅撤销用户编辑）、自动保存及 Ctrl+S 手动保存。
- Agent 变更审阅：提供行级 diff 视图。采用基线机制，接受变更即建立新基线，拒绝则将基线写回磁盘，新增文件拒绝即删除。
- 大文件可用：支持按需加载大文件内容并保留指纹，避免因文件体积导致无法审阅。
- 即时更新：Agent 对文件的改/增/删操作约 1.5 秒内同步到界面；纯换行符变化（CRLF/LF）不计入改动。
- 集成终端：独立进程运行，支持 ANSI 颜色、进度条重写、命令历史。终端命令不受 Agent 沙箱限制，等同于本机终端。
- 运行按钮：支持执行当前打开的代码文件（如
.py,.js,.ts,.sh），优先使用项目内的本地运行时（如.venv、runtime\python\python.exe），有未保存编辑会先保存再运行。
安装与启用¶
安装命令：
pnpm dsh plugin --profile web add @justarook1e/dsh-ide-lite
重启与刷新：
安装完成后，重启 pnpm dsh web 并在浏览器中按 Ctrl+F5 刷新页面。
桌面端安装：
桌面应用拥有独立的 desktop profile，无法通过上述 CLI 命令安装。需在应用内左侧栏的「插件」页安装同一个包 @justarook1e/dsh-ide-lite。
典型用法¶
- 运行代码：在「文件」标签页打开代码文件，点击工具栏的运行按钮即可执行。
- 终端操作：在「终端」标签页输入
npm run dev或docker compose up等复杂命令。 - 审阅变更：当 Agent 修改文件后，在「文件」标签页的变更列表中选择逐文件或全部接受/拒绝。
注意事项¶
- 版本兼容：适配 DSH
dsh-v0.1.7-rc.2；Host 半区兼容0.1.2-alpha.1到0.1.7-rc.2。 - 测试版状态：包含实验性功能（如撤销/重做、自动保存），建议对重要数据做好备份。
- 权限差异：终端命令不受 Agent 沙箱限制，等同于本机终端。
- 文档位置：插件文档位于开发者本地工作副本，不随 npm 发布。
总结¶
该插件通过集成文件编辑、变更审阅和终端功能，降低了在 DSH 与外部工具间切换的损耗。更多细节可查阅 GitHub。
