第4章 插件与市场 · Codewhale

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