前言¶
DeepSeek Harness (DSH) 是一个以插件为核心的模型推理框架。该插件由用户 baldovinmarques391-design 维护，旨在将 Windows 桌面操作转化为一系列离散的工具调用。每个工具执行单一操作，并返回操作前后捕获的帧数据，避免模型记忆截图的负担。
核心功能¶
插件在 tools 服务下注册了 11 个工具，每个工具仅执行一个动作：
computer_probe: 报告屏幕几何、指针位置/形状及指针下的窗口。computer_screenshot: 截取屏幕或矩形，支持整数缩放。computer_move/computer_click/computer_drag/computer_scroll/computer_type/computer_key/computer_chord/computer_wait: 分别对应移动、点击、拖拽、滚动、打字、按键、组合键和等待操作，均返回操作前后的帧数据。computer_frames: 读取两次调用之间记录的帧数据，用于重建动作细节。
安装与启用¶
安装命令如下，将 <path-to-this-checkout> 替换为插件目录的本地路径：
dsh plugin --profile web add <path-to-this-checkout>
插件依赖由 harness 提供，本地 checkout 通常不包含 node_modules。运行测试：
npm test
使用说明与限制¶
并发与序列化¶
所有工具均为并发不安全，输入由注册表序列化。这意味着同一时间只能有一个桌面输入操作生效。computer_scroll 拒绝零滚轮手势。
computer_frames 机制¶
computer_frames 是唯一不进行新捕获的工具，它读取录制环中两次调用之间的帧数据。默认情况下，maxAttachedImages 为 2，超过数量的帧仅打印路径而不作为图片附件返回。
功能设计¶
插件不支持长按、重复、宏、循环或“运行直到”参数。每个工具在调用结束后会立即释放所有按下的键或按钮。
配置项¶
配置项位于 cordis.patch.yml。以下是关键默认值：
| 参数名 | 默认值 | 说明 |
|---|---|---|
capturesPerSecond |
10 | 录制器帧率 |
maxFrames |
2 | 每次调用返回的帧数（1-20） |
maxAttachedImages |
2 | 附件图片的最大数量 |
settleMs |
700 | 动作完成后额外的捕获时间 |
maxScrollClicks |
10 | 最大滚轮手势步数 |
maxDragSteps |
120 | 最大拖拽步数 |
maxTypeChars |
2000 | computer_type 最大输入字符数 |
生态背景¶
该插件属于 DeepSeek Harness 社区生态。DeepSeek Harness 不接受外部 Pull Request。社区插件通过 GitHub 上的 dsh-plugin 话题进行发现。
链接¶
- GitHub 仓库：https://github.com/baldovinmarques391-design/dsh-computer-control
- 插件目录：https://www.skillhub.cn/plugins/baldovinmarques391-design/dsh-computer-control
