Agent Workflow Local Connector

Local Connector 让 Agent Workflow Platform 在你的电脑上执行经过审批的文件、进程和桌面操作。它只从本机主动连接平台，不会开放入站端口。

该 npm CLI 是当前不依赖 Apple Developer 账号的主交付方案。Electron 桌面伴侣的 Developer ID、公证或 Windows Authenticode 状态不会阻塞本包的测试、打包和发布门禁。

开始使用

无需全局安装。打开平台项目的“本地执行”页面，创建 CLI 配对，然后在需要授权的目录中运行页面生成的命令：

npx --yes @shiaopingc/[email protected] --code ABCD-EFGH --api-url https://example.com

每次连接只运行网页生成的这一条命令。连接期间请保持终端窗口打开；执行审批统一在工作流运行页面完成，CLI 不要求输入 y 或进行第二次本地确认。文件变更仍由平台展示并审批准确 Diff，Connector 只接受平台已授权且摘要冻结的请求。

环境检查

需要 Node.js 20.18 或更高版本：

npx --yes @shiaopingc/[email protected] doctor --api-url https://example.com

可选能力

• --allow-desktop：允许查看和控制桌面应用。
• --allow-desktop-interact：额外允许强制退出应用，并自动启用桌面能力。
• --allow-shell：允许 Shell 执行；平台服务端也必须显式启用。

旧命令中的 --trust-web-approvals 和 --require-signed-approvals 会被兼容解析，但不再改变执行审批方式。

按 Ctrl-C 会结束当前会话，本次配对不可复用。下次需要连接时，回到网页创建新的 CLI 配对并运行新命令，不存在额外的恢复命令。

路径边界、命令策略、Shell 开关、冻结 Diff 和执行租约仍在 Connector 本地强制执行。macOS 辅助功能/自动化、Windows UAC 等系统权限提示由操作系统处理，平台和 Connector 都不会绕过。

发布门禁

在仓库根目录运行本地验证：

pnpm local-cli:release-gate

干净 CI 使用：

pnpm local-cli:release-gate --require-clean

独立证据写入 tmp/local-cli-release/。只有干净提交、CLI 范围的类型检查和测试、真实 API/PostgreSQL/Redis/Gateway/Worker/Core 链路、npm 压缩包、Critical SCA、许可证清单及 hash 绑定的 ClamAV 扫描全部通过时，releaseTracks.cli.status 才能成为 CANDIDATE_READY。该状态不要求 Apple Developer ID，也不代表 npm publish 已自动执行。