桌面智能体UI树验收工作流

桌面智能体UI树验收工作流

4个实用技能 · 4步完成 · 每一步都能单独使用

注册用户免费下载。把调用方已经导出的脱敏 UI 树整理为快照，检查选择器候选、动作合同字段，再生成待人工决定的发布材料。不采集 UI 树或截图，不操作桌面。

4个可下载技能 · 每个技能可单独运行

4步自动化工作流

1 蓝色步骤：UI树记录归一

技能文件：desktop-ui-tree-snapshot

解决什么： 整理 app_ref、window_ref 和元素字段，标记部分禁用内容模式。

What you get: READY/REVIEW、normalized、element_count、desktop_tree_snapshot_hash；live_desktop_read=false。

流转与确认： 把实际快照交给第二步，不含真实客户或登录信息。

2 绿色步骤：选择器候选核对

技能文件：desktop-selector-stability-auditor

解决什么： 按 role/name/ancestor_path 形成候选并标记重复、缺失和动态 ID。

What you get: PASS/REVIEW、候选、ambiguous_refs、dynamic_id_refs；候选稳定性仍须真实应用验证。

流转与确认： 把实际结果与快照交给第三步，人工先处理歧义。

3 橙色步骤：动作合同记录核对

技能文件：desktop-action-contract-checker

解决什么： 检查动作名、目标引用、前后状态字段并标记不可逆动作需确认。

What you get: PASS/REVIEW/BLOCKED、findings、checked_actions 和 human_confirmation_required；execute_action=false。

流转与确认： 把实际报告和前两步输出交给第四步，不执行任何动作。

4 紫色步骤：桌面人工待审包

技能文件：desktop-ui-human-release-gate

解决什么： 检查负责人、运行、前后证据、决定引用及指定上游字段。

What you get: READY_FOR_HUMAN_DESKTOP_RELEASE/HOLD、human_decision=PENDING、desktop_write_executed=false。

流转与确认： 只形成最终本地待审包；真人另外核实窗口、元素、证据、审批和不可逆动作。

实际示例

合成两元素 UI 树可得到候选和待审包；复制同名同祖先元素会产生歧义 REVIEW；删除 owner_ref 可使最终包 HOLD。动作报告 REVIEW 仍可组成人工待审包，但不代表批准或执行。未连接 Windows UI Automation。上述均为脱敏合成测试，不是客户成果或真实环境验收。

适合谁

学习 UIA 导出结构、选择器候选与动作合同审阅的桌面智能体开发者。

买家只需提供

已授权并脱敏的 UI 树 JSON，app/window/元素引用、role/name/ancestor_path/actions；选择器策略和带预期前后状态的动作记录；人工负责人、运行、前后证据和决定引用。不得输入密码、Cookie、令牌、真实客户记录或无权使用的内容。

使用方式

1. 登录注册账号后下载原有技能；准备 Python 3.10 或更高版本及独立测试目录，无第三方 Python 依赖。

2. 逐项阅读 SKILL.md、README 和 examples；使用全新输出路径运行原有 scripts。带 --output 的脚本必须指定新文件，位置参数脚本只打印 JSON，可在测试目录接收标准输出；不要运行会覆盖包内 examples/output.json 的示范路径。

3. 各步可单独运行；衔接须按输入结构人工映射或另编排，包内没有自动串联执行器。发现错误、REVIEW、HOLD 或 BLOCKED 先停止，保留原始和失败副本，修正新副本后重跑，不编辑状态冒充通过。

交付与验收

• 保留原4个技能目录、脚本、说明、示例、附件、版本与下载地址；本次只更新父套餐免费状态及本详情，子技能原价字段不改，由父套餐免费权限继承。

• 在独立目录检查输出 JSON、状态、数量和实际输入对应关系；完整样例与缺失/冲突样例都要核对。有限本地合成测试不是实机、模型效果、普通用户实际下载或业务交付证明。

• 已知限制：稳定候选只是字段组合，不核实真实窗口、版本、可见性或元素动作支持；格式、类型、重复 ID 和敏感数据检查不完整。最终步骤明确允许 actions=REVIEW，也不重新验证所有选择器和哈希；只生成 PENDING 材料，不是放行决定。哈希不是签名，输入证据引用不等于真实完成动作。

• 不包含账号、外部 API、额度、真实系统接入、部署、数据清洗或持续维护服务；浏览量、注册、下载、收益等尚无可验证数据。

服务说明

默认只读买家有权使用且已脱敏的本地素材，写入指定新输出；不上传、不调用付费模型、不覆盖或删除原文件。哈希和状态只反映提供的数据，不替代真人审批、真实性验证、安全或合规认证。任何后续联网、密钥使用、上传、付费或不可逆操作均不由这些脚本实施，须另行告知权限、隐私、费用、失败边界并取得人工确认。适用范围为当前交付脚本的静态规则，不承诺跟随平台变化自动更新、零错误或收益。