minimal-agent 0.10.0 → 0.12.0

package/plugins/computer_use/app/macos-system-settings.md

@@ -0,0 +1,81 @@
+---
+schemaVersion: 2
+guideVersion: 1
+status: identity-verified
+platforms: [macOS]
+match:
+  bundleId: [com.apple.systempreferences]
+  processName: [System Settings, 系统设置]
+  displayName: [System Settings, 系统设置]
+irreversible:
+  - intent:change-security-setting
+  - intent:remove-account
+  - intent:remove-profile
+  - intent:forget-network
+  - intent:reset-or-erase-device
+  - intent:disable-protection
+verifiedRange:
+  macOS: package identity on macOS 26.5.2 only
+  windows: not-applicable
+lastVerifiedAt: 2026-07-29
+verification:
+  environment: macOS 26.5.2
+  verifiedAt: 2026-07-29
+  verifiedItems: [identity]
+  unverifiedItems: [layout, controls, flows]
+---
+
+# macOS 系统设置 App Guide
+
+## 稳定身份
+
+### macOS
+
+- Bundle ID：`com.apple.systempreferences`
+- 进程名：`System Settings`
+- 常见显示名：`System Settings`、`系统设置`
+
+### Windows
+
+- 不适用；Windows Settings 应建立独立指南，不能复用本指南的身份和交互事实。
+
+## AX / UIA 可发现线索
+
+- **macOS AX 候选线索**：设置窗口、搜索框、侧边栏、详情区、开关、弹出菜单、Sheet 和认证面板应从当前 AX 快照确认。
+- **焦点通道可用层级**：未实机验证。
+- 搜索结果、侧边栏选择和详情页标题必须同时核对；不能因同名设置项推断当前页面。
+
+## 常见自绘区
+
+- Apple ID、隐私与安全、网络详情、软件更新、扩展和第三方设置面板可能包含 SwiftUI、自定义列表、系统认证 Sheet 或外部扩展视图；AX 完整度尚未实机验证。
+
+## 风险动作与不可逆动作
+
+- 修改隐私、安全、登录项、辅助功能、屏幕录制或开发者设置。
+- 移除账户、配置描述文件、VPN、证书或已保存网络。
+- 关闭防护、自动更新、磁盘加密或其他安全能力。
+- 重置、抹掉、退出 Apple ID 或改变系统级数据同步。
+- 任何要求管理员密码、生物识别或恢复密钥的动作。
+
+## 弹窗与恢复
+
+| 弹窗或状态 | 可观察线索 | 安全恢复出口 |
+|---|---|---|
+| 管理员认证或生物识别 | 系统认证 Sheet、密码或 Touch ID 提示 | 交还用户处理，不读取密码或恢复密钥 |
+| 需要重启/注销 | 系统确认 Sheet | 保持未提交状态，等待用户明确确认 |
+| 设置被组织管理 | 管理提示、灰显控件或描述文件信息 | 停止尝试，不绕过策略并报告管理来源 |
+| 软件更新正在准备/安装 | 进度、重启提示或不可交互状态 | 不强制结束进程，等待系统状态稳定 |
+| 搜索后页面切换失败 | 搜索结果仍选中但详情标题未变化 | 清除搜索，重新确认侧边栏与详情标题 |
+
+## 可替代 API
+
+- 读取可由官方系统命令或受控 Runtime API可靠获得的状态时，优先使用系统通道。
+- 仅使用 Apple公开支持的命令或配置接口；无公开接口的设置必须通过系统设置并接受系统认证。
+- 不使用私有 defaults key、数据库修改或权限数据库写入代替用户授权。
+
+## 已验证范围
+
+- **验证环境**：macOS 26.5.2；应用包元数据版本显示 15.0。
+- **已验证**：Bundle ID、进程/显示名候选和应用包版本元数据。
+- **仍需验证**：AX 层级、搜索、各设置页、认证 Sheet、组织管理、更新与重启恢复。
+- 不把应用包版本 15.0 推断为已验证的界面版本范围。

package/plugins/computer_use/app/microsoft-excel.md

@@ -0,0 +1,80 @@
+---
+schemaVersion: 2
+guideVersion: 1
+status: draft
+platforms: [macOS, Windows]
+match:
+  bundleId: [com.microsoft.Excel]
+  processName: [Microsoft Excel, EXCEL.EXE]
+  displayName: [Microsoft Excel, Excel]
+irreversible:
+  - intent:replace-workbook
+  - intent:discard-unsaved-changes
+  - intent:delete-worksheet
+  - intent:publish-or-share-workbook
+  - intent:run-macro
+verifiedRange:
+  macOS: not-verified
+  windows: not-verified
+lastVerifiedAt: never
+verification:
+  environment: 未验证
+  verifiedAt: never
+  verifiedItems: []
+  unverifiedItems: [identity, layout, controls, flows]
+---
+
+# Microsoft Excel App Guide
+
+## 稳定身份
+
+### macOS
+
+- Bundle ID 候选：`com.microsoft.Excel`
+- 进程名候选：`Microsoft Excel`
+
+### Windows
+
+- 可执行文件名候选：`EXCEL.EXE`
+- 常见显示名：`Microsoft Excel`、`Excel`
+
+## AX / UIA 可发现线索
+
+- **macOS AX 候选线索**：工作簿窗口、功能区、名称框、公式栏、工作表标签和状态栏应从当前 AX 快照确认。
+- **Windows UIA 候选线索**：Ribbon、名称框、公式栏、工作表区域、工作表标签和 Backstage 页面应从当前 UIA 树确认。
+- **焦点通道可用层级**：macOS 与 Windows 均未实机验证。
+- 活动单元格、编辑模式、选区范围和筛选状态必须从当前应用状态确认，不能从旧截图推断。
+
+## 常见自绘区
+
+- 单元格网格、图表、数据透视表、切片器、条件格式、公式建议和大型工作表可能只有部分 Accessibility 信息，需视觉或文件级验证；尚未实机验证。
+
+## 风险动作与不可逆动作
+
+- 覆盖已有工作簿或关闭时放弃修改。
+- 删除工作表、表格列、名称、查询或连接。
+- 运行宏、刷新外部连接或启用外部内容。
+- 对外共享、发布或导出包含敏感数据的工作簿。
+- 批量粘贴、填充和排序可能改变大范围数据。
+
+## 弹窗与恢复
+
+| 弹窗或状态 | 可观察线索 | 安全恢复出口 |
+|---|---|---|
+| 格式兼容性或功能丢失警告 | 保存时出现模态说明 | 另存目标格式副本，未获授权不覆盖 |
+| 文件锁定/共同编辑冲突 | 只读、上传失败或冲突副本提示 | 停止覆盖并保留本地副本 |
+| 公式或数据连接警告 | 安全横幅、凭据或刷新确认 | 不启用连接，不输入凭据，等待用户决定 |
+| 大数据操作未完成 | 状态栏仍在计算/刷新或应用无响应 | 等待状态完成并通过文件/工作簿状态复核 |
+
+## 可替代 API
+
+- 创建、读取和校验 XLSX 优先使用现有电子表格/Open XML 工具。
+- Microsoft Graph 仅用于已授权的云端工作簿。
+- 数据正确性优先通过结构化单元格值、公式和工作簿重开验证，视觉检查用于布局和图表。
+
+## 已验证范围
+
+- **验证环境**：当前机器未安装 Microsoft Excel。
+- **已验证**：无。
+- **仍需验证**：macOS/Windows 身份、AX/UIA 层级、单元格导航、公式编辑、图表、保存冲突和外部连接流程。
+- 不声明任何 Excel 版本已受支持。

package/plugins/computer_use/app/microsoft-powerpoint.md

@@ -0,0 +1,80 @@
+---
+schemaVersion: 2
+guideVersion: 1
+status: draft
+platforms: [macOS, Windows]
+match:
+  bundleId: [com.microsoft.Powerpoint]
+  processName: [Microsoft PowerPoint, POWERPNT.EXE]
+  displayName: [Microsoft PowerPoint, PowerPoint]
+irreversible:
+  - intent:replace-presentation
+  - intent:discard-unsaved-changes
+  - intent:delete-slides
+  - intent:publish-or-share-presentation
+  - intent:run-macro
+verifiedRange:
+  macOS: not-verified
+  windows: not-verified
+lastVerifiedAt: never
+verification:
+  environment: 未验证
+  verifiedAt: never
+  verifiedItems: []
+  unverifiedItems: [identity, layout, controls, flows]
+---
+
+# Microsoft PowerPoint App Guide
+
+## 稳定身份
+
+### macOS
+
+- Bundle ID 候选：`com.microsoft.Powerpoint`
+- 进程名候选：`Microsoft PowerPoint`
+
+### Windows
+
+- 可执行文件名候选：`POWERPNT.EXE`
+- 常见显示名：`Microsoft PowerPoint`、`PowerPoint`
+
+## AX / UIA 可发现线索
+
+- **macOS AX 候选线索**：演示文稿窗口、功能区、缩略图窗格、幻灯片画布、备注区和状态栏应从当前 AX 快照确认。
+- **Windows UIA 候选线索**：Ribbon、缩略图列表、编辑画布、备注区、状态栏和 Backstage 页面应从当前 UIA 树确认。
+- **焦点通道可用层级**：macOS 与 Windows 均未实机验证。
+- 当前幻灯片、选中对象、文本编辑态和放映态必须在每次操作前重新确认。
+
+## 常见自绘区
+
+- 幻灯片画布、母版、动画时间线、SmartArt、图表、媒体和放映窗口可能只有部分 Accessibility 信息，需视觉兜底；尚未实机验证。
+
+## 风险动作与不可逆动作
+
+- 覆盖已有演示文稿或关闭时放弃修改。
+- 删除多张幻灯片、母版、媒体或批量对象。
+- 对外共享、发布、广播或导出演示文稿。
+- 运行宏、启用外部内容或更新链接媒体。
+- 替换字体、主题或版式可能影响全部幻灯片。
+
+## 弹窗与恢复
+
+| 弹窗或状态 | 可观察线索 | 安全恢复出口 |
+|---|---|---|
+| 字体/媒体/格式兼容性提示 | 保存或导出时出现警告 | 保留源文件并另存副本 |
+| 文件锁定或云端冲突 | 只读、冲突副本或上传失败 | 停止覆盖，保留本地副本 |
+| 放映窗口占据前台 | 出现独立放映窗口或全屏状态 | 退出放映后重新确认编辑窗口和当前幻灯片 |
+| 媒体导出仍在处理 | 进度窗口或状态仍未完成 | 等待输出文件存在且大小稳定，再重新打开验证 |
+
+## 可替代 API
+
+- 创建、修改和校验 PPTX 优先使用现有演示文稿/Open XML 工具。
+- Microsoft Graph 仅用于已授权的云端文件。
+- PowerPoint Computer Use 主要用于视觉验收、特殊编辑和放映检查，不替代结构化文档管线。
+
+## 已验证范围
+
+- **验证环境**：当前机器未安装 Microsoft PowerPoint。
+- **已验证**：无。
+- **仍需验证**：macOS/Windows 身份、AX/UIA 层级、普通/母版/放映视图、媒体、保存冲突和导出流程。
+- 不声明任何 PowerPoint 版本已受支持。

package/plugins/computer_use/app/microsoft-word.md

@@ -0,0 +1,79 @@
+---
+schemaVersion: 2
+guideVersion: 1
+status: draft
+platforms: [macOS, Windows]
+match:
+  bundleId: [com.microsoft.Word]
+  processName: [Microsoft Word, WINWORD.EXE]
+  displayName: [Microsoft Word, Word]
+irreversible:
+  - intent:replace-document
+  - intent:discard-unsaved-changes
+  - intent:publish-or-share-document
+  - intent:run-macro
+verifiedRange:
+  macOS: not-verified
+  windows: not-verified
+lastVerifiedAt: never
+verification:
+  environment: 未验证
+  verifiedAt: never
+  verifiedItems: []
+  unverifiedItems: [identity, layout, controls, flows]
+---
+
+# Microsoft Word App Guide
+
+## 稳定身份
+
+### macOS
+
+- Bundle ID 候选：`com.microsoft.Word`
+- 进程名候选：`Microsoft Word`
+
+### Windows
+
+- 可执行文件名候选：`WINWORD.EXE`
+- 常见显示名：`Microsoft Word`、`Word`
+
+## AX / UIA 可发现线索
+
+- **macOS AX 候选线索**：文档窗口、标题栏、功能区/工具栏、文档编辑区、导航窗格和状态栏应从当前 AX 快照分别确认。
+- **Windows UIA 候选线索**：Ribbon、文档视图、导航窗格、状态栏和 Backstage 页面应从当前 UIA 树确认，不能依赖固定 AutomationId。
+- **焦点通道可用层级**：macOS 与 Windows 均未实机验证。
+- 当前插入点、选区和受保护状态必须通过焦点/选区状态确认，不能仅凭页面外观判断。
+
+## 常见自绘区
+
+- 页面画布、批注/修订气泡、浮动对象、公式、图表和嵌入对象可能只有部分 Accessibility 信息，需视觉兜底；尚未实机验证。
+
+## 风险动作与不可逆动作
+
+- 覆盖已有文档或将新格式覆盖回原文件。
+- 关闭时选择“不保存”。
+- 对外共享、发布或发送文档。
+- 运行宏、启用外部内容或解除受保护视图。
+- 接受/拒绝全部修订会批量改变文档内容。
+
+## 弹窗与恢复
+
+| 弹窗或状态 | 可观察线索 | 安全恢复出口 |
+|---|---|---|
+| 保存格式兼容性警告 | 模态对话框提示功能可能丢失 | 保留原格式或另存副本，未获授权不覆盖 |
+| 文件已被修改或锁定 | 冲突、只读或上传失败提示 | 停止覆盖，保留编辑副本并报告冲突 |
+| 受保护视图/宏安全提示 | 文档上方安全横幅或模态提示 | 不启用内容，除非用户明确授权 |
+| 恢复文档窗格 | 出现多个自动恢复版本 | 保留全部候选，交由用户选择权威版本 |
+
+## 可替代 API
+
+- 结构化创建或修改 DOCX 优先使用 Open XML/现有文档工具，再由 Word 做最终视觉验收。
+- Microsoft Graph 仅适用于已授权的 OneDrive/SharePoint 文件，不代替本机文件权限。
+- 文件保存成功以文件存在、哈希/修改时间和可重新打开验证为准。
+
+## 已验证范围
+
+- **验证环境**：当前机器未安装 Microsoft Word。
+- **已验证**：无。
+- **仍需验证**：macOS/Windows 身份、AX/UIA 层级、不同视图、修订、保存冲突、宏安全和恢复流程。
+- 不声明任何 Word 版本已受支持。