@ agent-forge/plugin-desktop-macos-观察器
只读 macOS 桌面观测能力插件 福吉探员,结构为macOS
对应单位 plugins/desktop-windows-observe它登记了五个只读工具—— desktop_probe, (中文(简体) ), desktop_session_open, (中文(简体) ), desktop_observe, (中文(简体) ),
desktop_reobserve, (中文(简体) ), desktop_session_stop 通过JXA驱动程序得到macOS无障碍树的支持(osascript -l JavaScript) (中文(简体) ). 从来没有
注册输入或重放工具.
该插件自发载出自有的osascript/JXA适配器. 在导入软件包的非macOS 平台上不会丢出;每个工具都报告一个明确
unsupported 而不是去探险 或回到不同的驱动器。 据报缺少无障碍(协助获取)补助金
失败关闭作为探测器的理由 accessibility-permission-required;没有退化的观测模式.
安装
# from a local checkout
agent-forge plugin install ./plugins/desktop-macos-observe
# from npm
agent-forge plugin install @ai-agent-forge/plugin-desktop-macos-observe
货包船有两艘货单: agent-forge.json (确定性插件解析器显示的系统, platform.os: ["macos"]和
plugin.json (主机载重清单 loadCapabilityPluginFromManifest条目 ./dist/entry.js) (中文(简体) ).
图书馆表面
import { DesktopMacosAdapter, MacosAccessibilityDriver } from "@agent-forge/plugin-desktop-macos-observe";
DesktopMacosAdapter——只读取可访问性适配器外观.MacosAccessibilityDriver(options?)— JXA 驱动程序; 支持command编号 :timeoutMs编号 :spawnSync编号 :platform给经纪人注射和测试.createDesktopObserveCapabilityFactoryV1(runtime)- 将5个观察工具登记在CapabilityAPI。 。 。 .- 默认导出
dist/entry.js——外部插件加载所使用的预编厂.
观察预测(窗口/控制身份、预算、截取)是一份有意的内置副本,与
@agent-forge/plugin-desktop-macos-input 所以两个包裹都保持自成一体.
真实主机状态
驾驶员和适配员通过合同测试 装有被注射的假药 spawnSync (扫描JSON,没有真正的桌面). 真正的Darwin行为——JXA
盘点脚本、无障碍许可分类和观察到的窗口/控制忠诚度——仅由明确封门者核查
测试(AGENT_FORGE_MACOS_AX_REAL_TEST=1 在 macOS 上),截至此更改尚未在真正的 macOS 主机上验证.
发展
npm install --ignore-scripts # repo root, creates the workspace symlink
npm run build # plugins/desktop-macos-observe (tsgo)
npm test # vitest; the entry fidelity test requires `npm run build` first