前言¶
DeepSeek Harness（DSH）采用插件化架构。dsh-essential-tools（DET）是 LLYlab 维护的一个永久插件，旨在将 DSH 转变为一个具备工程化能力的控制台。它通过浏览器控制、项目运行、版本快照、虚拟对话树（VTD）等功能，解决智能体在真实代码开发中上下文断裂、缺乏执行环境、无法回溯历史操作等痛点。
核心功能¶
浏览器控制¶
DET 通过一个基于 Manifest V3 的浏览器扩展（Edge 或 Chrome）与 DSH 主机通信。扩展通过本地 WebSocket 桥接连接，默认端口为 127.0.0.1:9123，允许模型操作用户已登录的浏览器实例。
- 权限控制：用户通过扩展弹窗控制权限旋钮，模型只能读取当前设定的权限状态。
关闭 off：无任何权限。只读 read：可读取页面文本、DOM、截图、URL 和标题。只写 write：可导航、点击、填表、运行程序，但无法读取页面内容。启用 on：完整读写权限。
- 安全机制：模型需具备网络权限等级 4 才能启动连接；非完整权限模式下，浏览器操作需经过 DSH 的
tools/pre-execute审批流程。
虚拟对话树 (VTD)¶
VTD 允许在对话中创建和管理分支，无需复制粘贴到新会话。
- 分支操作：编辑或重试任意用户消息会创建一个真实的子分支会话（
origin: vtd-fork），原线程保持不变。使用<N>选择器可在分支间切换。 - 消息小版本：记录
baseline/edit/retry/auto-switch等微版本，支持回溯。 - 实时渲染：流式生成时刷新率约 700ms，空闲时约 2.5s，自动滚动。
工程化工具¶
在 DSH 右侧工具栏提供项目级操作。
- 运行 (Run)：自动寻找入口点（如
main、entry/run或.sln文件），使用 MSBuild 进行编译和运行。 - 文件树：显示工作区文件结构，支持预览和编辑。
- 快照与回退：对程序代码进行快照备份。快照仅包含代码文件。支持手动快照、回退（自动备份后）和删除。
全局插件管理器¶
提供跨会话的插件管理能力。
- 多级启用策略：插件具有 5 种级别：
全局启用、对话AI可自行决定启用、对话内AI需审批启用、不再会有新启用、全局禁用。 - 来源与安全：支持从运行中的对话提升插件、从商店搜索或导入 Manifest URL。支持直接下载或通过 AI 重写源码（
det_global_plugin_github_rebuild），重写后的代码不会被执行，仅用于安全检查。 - 引导与防护：插件加载器支持热插拔。内置 Boot Guard 机制，限制连续启动失败次数（默认 2 次），防止恶意插件导致系统无法启动。
记忆层与审计¶
- MDA (Mixing Dialogue Agent)：提供
native、workspace和model分组记忆。 - CDM (Cross Dialogue Memory)：支持跨对话记忆的列表与搜索。
- 安全审计：提供审计日志和安全开关。
使用说明¶
运行项目¶
在 DSH 右侧工具栏点击 ▶ 运行，插件会自动检测 main、entry 或 .sln 文件，调用 MSBuild 进行编译并启动程序。
对话分支与重试¶
- 在对话中长按任意消息，选择
编辑或重试。 - AI 修改内容后，会生成一个新的隐藏分支。
- 使用
<N>切换到该分支查看结果，原对话不受影响。
管理插件¶
- 在右侧工具栏点击
🧩 插件进入全局插件管理器。 - 使用
det_global_plugin_set_enabled切换插件启用状态，或使用det_global_plugin_github_rebuild从 GitHub 安全导入插件。
注意事项¶
- 零配置：插件在未配置项目路径时即可运行对话树、消息编辑等核心功能。
- 浏览器依赖：使用浏览器控制功能需要安装扩展并确保
127.0.0.1:9123桥接正常工作。 - 权限等级：网络权限等级必须达到 4 才能启动浏览器控制功能。
- 快照范围：程序快照仅包含代码文件，不包含二进制输出或环境配置。
