你的代理,就在你真实的电脑上。
Codewhale 插件为你已在运行的代理添加经审阅的能力——来自官方 Codewhale 目录、GitHub 仓库或压缩包。在你亲自阅读清单并信任之前,不会执行任何内容。
Computer Use:代理的眼睛与手。
代理不再对你的桌面视而不见。它观察你选择的应用,通过无障碍树读取控件,在你指定的地方输入与点击——然后用回执报告每一步操作。macOS 是完成认证的 Beta 平台;Windows、Linux 与 HarmonyOS 后端仍为实验性、仅提供源码。
/plugin marketplace install codewhale computer-use
36 个 MCP 工具:观察、操作、截图与缩放、键盘与指针、剪贴板、录制、基于 CDP 的浏览器控制、窗口边框、已安装应用目录、会话以及计算机切换。
- 后台工作
- 在 macOS 上,代理可以驱动指定应用而不移动你的指针或抢占焦点——你在前台继续工作,它在后台定向输入。前台控制是独立的显式授权。
- 读懂界面,而非只看像素
- 无障碍树(macOS AX、Windows UIA、Linux AT-SPI)返回控件、值与可执行动作——纯文本模型无需任何截图即可驱动整个应用。
- 必要时才看
- 截图与缩放供视觉模型使用;在 macOS 上,本地 OCR 直接在设备上读取窗口文字——无需远程服务,也无需视觉模型。
- 一个代理,多台计算机
- 控制本机、已注册的 SSH 主机(远程代理自动安装)或通过 hdc 连接的 HarmonyOS 设备。每条回执都标明它发生在哪台计算机上。
- 权限仍归你所有
- 辅助功能与屏幕录制权限由你在系统设置中掌控。代理只会询问一次缺少什么——绝不弹出对话框。
- 失败即停,回执为证
- 过期的观察结果、意外的前台变化与不可用的能力都会携带回执拒绝执行,而非猜测。每个任务独占自己的会话;停止即释放所有按住的输入。
- 以独立配置文件驱动浏览器
- 通过 DevTools 协议在独立配置文件中驱动 Chromium 系浏览器——按 CSS 选择器或页面像素点击,直接截取页面画面。你自己的配置文件、标签页与登录信息绝不会被连接。
- 可看、可限、可重放
- 会话工作时,实时预览持续显示所绑定的应用;list_sessions 列出机器上的每个活动会话。停止开关终止输入,kill_app 按精确身份退出指定应用,轨迹记录包括被拒绝调用在内的每一步以供忠实重放,启动时的能力授权固定会话可调用的范围。
Codewhale 市场。
终端与应用内置 Codewhale 目录的离线快照,浏览不会拉取或执行任何内容。一条命令即可安装。
/plugin marketplace list
目录来源:github.com/Hmbown/codewhale-plugin-marketplace。名为 codewhale 的本地目录优先于内置快照。
任何 GitHub 仓库都可以是插件。
/plugin install 可以指向目录、仓库或压缩包。获取的目录树必须恰好包含一个 bundle 根——plugin.json、兼容的 kimi.plugin.json 或 .claude-plugin/plugin.json,或旧版 plugin.toml。
已安装不等于已启用。
每个 bundle 安装后均为未启用、未信任状态。审阅清单与声明的能力后,再信任并启用。内容有变更的更新需要重新审阅。
下载仅限压缩包,有大小限制且不允许符号链接;路径穿越、模糊根目录与插件身份变更都会被拒绝。/plugin suggest 仅对已安装与目录中的 bundle 按任务排序,不会安装任何内容。
命令参考
插件编写指南完整生命周期在终端中进行。已记录的命令:
/plugin marketplace list /plugin marketplace show codewhale /plugin marketplace install codewhale <name> /plugin install github:owner/repo /plugin show <name> /plugin trust <name> /plugin enable <name> /plugin update <name> /plugin suggest <task>