前言¶

智能体在终端里能将操作验证正确，但用户往往无法用手复现，原因是缺少图形界面的操作路径和记录。单纯告诉用户“运行脚本”无法解决这个问题，这会留下一个无法学习的黑盒，且在换到另一台机器时会失效。

DSH 插件 dsh-gui-handoff 旨在填补这个落差，它能把命令行验证过的操作，交接给图形界面。

这是什么¶

这是一个 DeepSeek Harness 技能插件，核心功能是把命令行验证过的操作交接给图形界面。

插件提供两条路径，默认走 B，降级到 A。

路径 B（默认）：
* 做法：智能体真正操作 GUI 走一遍。
* 产出：生成带真截图的教程。
* 价值：用户可以学习操作流程，且支持跨机器生存。

路径 A（降级）：
* 做法：把步骤固化成配置文件。
* 产出：配置文件 + 一键操作。
* 限制：用户无法学习，换机器不可用。

路径 B 运行一个五阶段链：驱动 → 观察 → 捕获 → 还原 → 标注。

插件内置了 30+ 硬约束 和 7 条工作纪律，用于确保操作的可复现性和正确性。验证环节使用地面真值（例如：产物是否存在 + 时间戳，程序输出或调试器退出码），截图仅用于辅助人类，不作判据。

通过以下命令安装插件。插件注册的 skill 名为 gui-handoff，优先级为 600（最低），因此本地修改的副本会优先于仓库副本。

dsh plugin --profile <your-profile> add dsh-gui-handoff

也可以从本地目录安装：

dsh plugin --profile <your-profile> add /path/to/dsh-gui-handoff

启用后，智能体可以执行路径 B 的五阶段链。如果当前环境缺乏驱动目标 OS GUI 的手段（Windows 已提供参考实现），插件会自动降级。

示例逻辑如下：

版本要求：需要 DeepSeek Harness >= 0.1.5-rc.1。
系统依赖：路径 B 的驱动环节需要某种手段来驱动目标系统的图形界面。本仓库为 Windows 提供了参考实现（tools/gui-control/server.py），若在其他系统运行，需自行实现对应的 GUI 驱动逻辑，否则插件会降级到路径 A。
文件说明：tools/ 目录是面向 Windows 的参考实现，并非插件运行的必需项。
权限与安全：插件以 DSH 进程的权限运行，安装前请检查源码与许可证。

该插件通过驱动 GUI 一次并生成带真截图的教程，解决了命令行验证与图形界面操作之间的断层问题，确保了操作的可学习性与跨机器可用性。