插件与市场

你的代理,就在你真实的电脑上。

Codewhale 插件为你已在运行的代理添加经审阅的能力——来自官方 Codewhale 目录、GitHub 仓库或压缩包。在你亲自阅读清单并信任之前,不会执行任何内容。

官方插件 · macOS Beta

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 按精确身份退出指定应用,轨迹记录包括被拒绝调用在内的每一步以供忠实重放,启动时的能力授权固定会话可调用的范围。

目录来源:github.com/Hmbown/codewhale-plugin-marketplace。名为 codewhale 的本地目录优先于内置快照。

安装来源

任何 GitHub 仓库都可以是插件。

/plugin install 可以指向目录、仓库或压缩包。获取的目录树必须恰好包含一个 bundle 根——plugin.json、兼容的 kimi.plugin.json 或 .claude-plugin/plugin.json,或旧版 plugin.toml。

GitHub 仓库仓库默认分支的归档——市场目录使用同一机制。/plugin install github:owner/repo
本地目录从磁盘复制。编写自己的 bundle 时最快的迭代方式。/plugin install ./path/to/bundle
压缩包 URL直接下载归档,受按域网络策略约束——未知主机会被拒绝,直到你允许它。/plugin install https://example.com/x.tar.gz
信任生命周期

已安装不等于已启用。

每个 bundle 安装后均为未启用、未信任状态。审阅清单与声明的能力后,再信任并启用。内容有变更的更新需要重新审阅。

审阅/plugin show <name> 打印清单、声明的能力与安装回执——包括来源与 bundle 选择器。
信任/plugin trust <name> 记录你的决定。官方目录来源本身不授予任何执行或网络权限。
启用/plugin enable <name> 激活 bundle。插件提供的 MCP 服务以 <plugin>-<server> 命名空间身份运行,适用更严格的边界。

下载仅限压缩包,有大小限制且不允许符号链接;路径穿越、模糊根目录与插件身份变更都会被拒绝。/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>