dsh-gcua

GCUA (Generalist Computer-Use Agent) 状态机插件，为 DeepSeek Harness 而生。 移植自阿里通义 MAI-UI 团队的 OpenGCUA 的 harness 哲学：决策下放给模型，沙盒只管执行与记账。

它是什么

三个工具 + 一段系统提示词，把「观察 → 行动 → 验证」的闭环变成强制流程：

工具	干什么
gcua_step	把一段完整 Python 代码丢进沙盒跑一次（每步新进程；文件与系统副作用保留，变量不留）。批量查询、GUI 自动化、带分支的流水线——一次往返全收
gcua_status	读任务台账（todo ledger）与步级相位轨迹
gcua_reset	清台账开新任务（同时清 .gcua/steps，非并发安全）

沙盒 worker 命名空间（每步自动注入，无需 import）：

• todo — 台账：todo.update(id, kind, content, status)，字段省略即继承；kind ∈ task|next_step|fact|question，状态机 pending → attempted → changed_unverified → claimed_verified（或 blocked）。规矩：没把条目从旧状态推进新状态，这一步就是白跑；只有拿到独立证据（读回验证、第二次观察）才许记"已验证"
• screenshot() — 全屏截图存 .gcua/shot-NNN.png，返回路径。只在定验时用，轮询靠文本
• ps(cmd, timeout) — PowerShell（UTF-8 输出）
• paste_text(text) — 剪贴板注入 + Ctrl+V，绕过中文 IME
• pyautogui / uia（pywinauto Desktop，需 pip install pywinauto）/ 标准库
• phase(name) — 步内相位标记（execute / observe / verify…），自动记录进轨迹

内置防呆：StallDetector（同代码+同结果指纹连出 3 次警告、6 次熔断，窗口 12）、文件锁 BUSY 防并发、state.json 原子写 + 损坏自愈（隔离 .json.bad）、超时/中断 taskkill /T /F 斩杀整棵进程树、幂等 selftest 跑在临时目录。

安装

DSH 内：插件市场/plugin_manager 安装本目录；或手动把本目录作为 bundle 目标 install_bundle target=<本仓库克隆路径>（patch 已带 cordis.patch.yml）。

依赖：Windows + Python 3.10+（python 在 PATH）；GUI 车道需 pip install pyautogui mss pywinauto。

系统提示词注入

注册 gcua-machine section（order 850）：台账纪律、批量宏步、0.3–0.5s 文本轮询、截图只留验、UIA 矩形别肉眼估、get_value() 不可信用 window_text() 等——全部来自真机实战踩坑。

出处与致谢

• 设计原型：OpenGCUA（TodoLedger / StallDetector / <intent>+<code> 步级工作流），Apache-2.0
• 本仓库实现：Windows/DSH 移植 + cordis 插件封装，Apache-2.0

License

Apache-2.0