| 1 | import type { LocalizedText } from "./vocabulary"; |
| 2 | |
| 3 | export const PLUGINS_COPY = { |
| 4 | metaTitle: { en: "Plugins and marketplace · Codewhale", zh: "插件与市场 · Codewhale" }, |
| 5 | metaDescription: { |
| 6 | en: "Let the agent operate the desktop apps you choose with Computer Use, and install reviewed plugins from the Codewhale catalog, a GitHub repository, or a tarball.", |
| 7 | zh: "用 Computer Use 让代理操作你选定的桌面应用,并从 Codewhale 目录、GitHub 仓库或压缩包安装经过审阅的插件。", |
| 8 | }, |
| 9 | kicker: { en: "Plugins and marketplace", zh: "插件与市场" }, |
| 10 | title: { en: "Give the agent your apps, on your terms.", zh: "按你的规则,把应用交给代理。" }, |
| 11 | lead: { |
| 12 | en: "Add capabilities from the first-party Codewhale catalog, a GitHub repository, or a tarball. Nothing runs until you read the manifest and trust it.", |
| 13 | zh: "从官方 Codewhale 目录、GitHub 仓库或压缩包添加能力。在你阅读清单并信任它之前,不会运行任何内容。", |
| 14 | }, |
| 15 | marketplaceCta: { en: "Browse the Codewhale catalog", zh: "浏览 Codewhale 目录" }, |
| 16 | docsCta: { en: "Plugin authoring guide", zh: "插件编写指南" }, |
| 17 | |
| 18 | cuLabel: { en: "First-party plugin · macOS beta", zh: "官方插件 · macOS Beta" }, |
| 19 | cuTitle: { en: "Computer Use: let the agent operate your apps.", zh: "Computer Use:让代理操作你的应用。" }, |
| 20 | cuLead: { |
| 21 | en: "The agent observes the apps you choose, reads their controls through the accessibility tree, types and clicks, and records each action in a receipt. macOS is the qualified beta platform; Windows, Linux and HarmonyOS backends remain experimental and source-only.", |
| 22 | zh: "代理观察你选择的应用,通过无障碍树读取控件,执行输入与点击,并在回执中记录每一步操作。macOS 是完成认证的 Beta 平台;Windows、Linux 与 HarmonyOS 后端仍为实验性、仅提供源码。", |
| 23 | }, |
| 24 | cuInstall: { en: "/plugin marketplace install codewhale computer-use", zh: "/plugin marketplace install codewhale computer-use" }, |
| 25 | cuFeatures: [ |
| 26 | { |
| 27 | title: { en: "Works in the background", zh: "后台工作" }, |
| 28 | detail: { |
| 29 | en: "On macOS the agent drives a selected app without moving your pointer or taking focus, so you keep using the machine. Foreground control is a separate, explicit grant.", |
| 30 | zh: "在 macOS 上,代理驱动指定应用时不会移动你的指针或抢占焦点,你可以继续使用电脑。前台控制是独立的显式授权。", |
| 31 | }, |
| 32 | }, |
| 33 | { |
| 34 | title: { en: "Reads the UI, not just pixels", zh: "读懂界面,而非只看像素" }, |
| 35 | detail: { |
| 36 | en: "The accessibility tree (macOS AX, Windows UIA, Linux AT-SPI) returns controls, values, and advertised actions, so a text-only model can drive an app without screenshots.", |
| 37 | zh: "无障碍树(macOS AX、Windows UIA、Linux AT-SPI)返回控件、值与可执行动作,因此纯文本模型无需截图也能驱动应用。", |
| 38 | }, |
| 39 | }, |
| 40 | { |
| 41 | title: { en: "Sees when it has to", zh: "必要时才看" }, |
| 42 | detail: { |
| 43 | en: "Screenshots and zoom feed compatible vision models. On macOS, local OCR reads window text on-device with no remote service or vision model.", |
| 44 | zh: "截图与缩放供兼容的视觉模型使用。在 macOS 上,本地 OCR 直接在设备上读取窗口文字,无需远程服务或视觉模型。", |
| 45 | }, |
| 46 | }, |
| 47 | { |
| 48 | title: { en: "One agent, many computers", zh: "一个代理,多台计算机" }, |
| 49 | detail: { |
| 50 | en: "Control the local machine, registered SSH hosts (the remote agent installs itself), or HarmonyOS devices over hdc. Every receipt names the computer it happened on.", |
| 51 | zh: "控制本机、已注册的 SSH 主机(远程代理自动安装)或通过 hdc 连接的 HarmonyOS 设备。每条回执都标明它发生在哪台计算机上。", |
| 52 | }, |
| 53 | }, |
| 54 | { |
| 55 | title: { en: "Permissions stay yours", zh: "权限仍归你所有" }, |
| 56 | detail: { |
| 57 | en: "Accessibility and Screen Recording grants stay in System Settings under your control. The agent tells you once what is missing instead of opening dialogs.", |
| 58 | zh: "辅助功能与屏幕录制权限保留在系统设置中,由你掌控。代理只会告诉你一次缺少什么,不会弹出对话框。", |
| 59 | }, |
| 60 | }, |
| 61 | { |
| 62 | title: { en: "Fails closed, with receipts", zh: "失败即停,回执为证" }, |
| 63 | detail: { |
| 64 | en: "Stale observations, unexpected foreground changes, and unavailable capabilities refuse with a receipt instead of guessing. Each task owns its session; stopping releases every held input.", |
| 65 | zh: "过期的观察结果、意外的前台变化与不可用的能力都会携带回执拒绝执行,而非猜测。每个任务独占自己的会话;停止即释放所有按住的输入。", |
| 66 | }, |
| 67 | }, |
| 68 | { |
| 69 | title: { en: "Drives a browser, in its own profile", zh: "以独立配置文件驱动浏览器" }, |
| 70 | detail: { |
| 71 | en: "The agent drives a Chromium-family browser over the DevTools protocol in its own profile, clicking by CSS selector or page pixel. It never attaches to your profile, tabs, or logins.", |
| 72 | zh: "代理通过 DevTools 协议在自己的配置文件中驱动 Chromium 系浏览器,按 CSS 选择器或页面像素点击。它绝不会连接你的配置文件、标签页或登录信息。", |
| 73 | }, |
| 74 | }, |
| 75 | { |
| 76 | title: { en: "Watch it, bound it, replay it", zh: "可看、可限、可重放" }, |
| 77 | detail: { |
| 78 | en: "A live preview shows the bound app while a session works, and list_sessions names every live session. The stop switch halts input, trajectories record every call (refusals included) for replay, and a launch-time grant fixes what a session may call.", |
| 79 | zh: "会话工作时,实时预览显示所绑定的应用;list_sessions 列出每个活动会话。停止开关终止输入,轨迹记录每一次调用(包括被拒绝的调用)以供重放,启动时的授权固定会话可调用的范围。", |
| 80 | }, |
| 81 | }, |
| 82 | ], |
| 83 | cuToolsNote: { |
| 84 | en: "36 MCP tools: observation, actions, screenshots and zoom, keyboard and pointer, clipboard, recording, browser control over CDP, window frames, the installed-app catalog, sessions and computer switching.", |
| 85 | zh: "36 个 MCP 工具:观察、操作、截图与缩放、键盘与指针、剪贴板、录制、基于 CDP 的浏览器控制、窗口边框、已安装应用目录、会话以及计算机切换。", |
| 86 | }, |
| 87 | |
| 88 | catalogLabel: { en: "First-party catalog", zh: "官方目录" }, |
| 89 | catalogTitle: { en: "The Codewhale marketplace.", zh: "Codewhale 市场。" }, |
| 90 | catalogLead: { |
| 91 | en: "An offline snapshot of the Codewhale catalog ships with the terminal, so browsing never fetches or runs anything. Install from it with one command.", |
| 92 | zh: "终端内置 Codewhale 目录的离线快照,浏览时不会拉取或运行任何内容。一条命令即可安装。", |
| 93 | }, |
| 94 | catalogBrowse: { en: "/plugin marketplace list", zh: "/plugin marketplace list" }, |
| 95 | catalogEntries: [ |
| 96 | { |
| 97 | title: { en: "WhaleWiki", zh: "WhaleWiki" }, |
| 98 | detail: { |
| 99 | en: "Repository and concept documentation the agent can consult while it works.", |
| 100 | zh: "供代理在工作时查阅的仓库与概念文档。", |
| 101 | }, |
| 102 | reference: "/plugin marketplace install codewhale whalewiki", |
| 103 | }, |
| 104 | { |
| 105 | title: { en: "Cloudflare Docs", zh: "Cloudflare 文档" }, |
| 106 | detail: { |
| 107 | en: "Cloudflare documentation lookup inside a session.", |
| 108 | zh: "在会话内查询 Cloudflare 文档。", |
| 109 | }, |
| 110 | reference: "/plugin marketplace install codewhale cloudflare-docs", |
| 111 | }, |
| 112 | { |
| 113 | title: { en: "Skill bundle", zh: "技能包" }, |
| 114 | detail: { |
| 115 | en: "The bundled Codewhale skills the terminal ships with, kept in sync with the catalog.", |
| 116 | zh: "终端内置的 Codewhale 技能集,与目录保持同步。", |
| 117 | }, |
| 118 | reference: "#path=skills", |
| 119 | }, |
| 120 | ], |
| 121 | catalogNote: { |
| 122 | en: "Catalog source: github.com/codewhale-hq/codewhale-plugin-marketplace. A local catalog named codewhale takes precedence over the bundled snapshot.", |
| 123 | zh: "目录来源:github.com/codewhale-hq/codewhale-plugin-marketplace。名为 codewhale 的本地目录优先于内置快照。", |
| 124 | }, |
| 125 | |
| 126 | sourcesLabel: { en: "Install sources", zh: "安装来源" }, |
| 127 | sourcesTitle: { en: "Install from a repository, folder, or tarball.", zh: "从仓库、文件夹或压缩包安装。" }, |
| 128 | sourcesLead: { |
| 129 | en: "Point /plugin install at a directory, a repository, or a tarball. The fetched tree must hold exactly one bundle root: a plugin.json, a compatible kimi.plugin.json or .claude-plugin/plugin.json, or a legacy plugin.toml.", |
| 130 | zh: "/plugin install 可以指向目录、仓库或压缩包。获取的目录树必须恰好包含一个 bundle 根:plugin.json、兼容的 kimi.plugin.json 或 .claude-plugin/plugin.json,或旧版 plugin.toml。", |
| 131 | }, |
| 132 | sources: [ |
| 133 | { |
| 134 | title: { en: "GitHub repository", zh: "GitHub 仓库" }, |
| 135 | detail: { |
| 136 | en: "Fetches an archive of the default branch, the same mechanism the marketplace catalog uses.", |
| 137 | zh: "获取默认分支的归档,市场目录也使用这一机制。", |
| 138 | }, |
| 139 | reference: "/plugin install github:owner/repo", |
| 140 | }, |
| 141 | { |
| 142 | title: { en: "Local directory", zh: "本地目录" }, |
| 143 | detail: { |
| 144 | en: "Copied from disk. The fastest loop while authoring your own bundle.", |
| 145 | zh: "从磁盘复制。编写自己的 bundle 时最快的迭代方式。", |
| 146 | }, |
| 147 | reference: "/plugin install ./path/to/bundle", |
| 148 | }, |
| 149 | { |
| 150 | title: { en: "Tarball URL", zh: "压缩包 URL" }, |
| 151 | detail: { |
| 152 | en: "Downloads the archive directly under the per-domain network policy. An unknown host is refused until you allow it.", |
| 153 | zh: "在按域网络策略下直接下载归档。未知主机会被拒绝,直到你允许它。", |
| 154 | }, |
| 155 | reference: "/plugin install https://example.com/x.tar.gz", |
| 156 | }, |
| 157 | ], |
| 158 | |
| 159 | trustLabel: { en: "Trust lifecycle", zh: "信任生命周期" }, |
| 160 | trustTitle: { en: "Installed is not enabled.", zh: "已安装不等于已启用。" }, |
| 161 | trustLead: { |
| 162 | en: "Every bundle lands disabled and untrusted. Review the manifest and declared capabilities, then trust and enable it. An update with changed bytes requires review again.", |
| 163 | zh: "每个 bundle 安装后均为未启用、未信任状态。审阅清单与声明的能力后,再信任并启用。内容有变更的更新需要重新审阅。", |
| 164 | }, |
| 165 | trustSteps: [ |
| 166 | { |
| 167 | title: { en: "Review", zh: "审阅" }, |
| 168 | detail: { |
| 169 | en: "/plugin show <name> prints the manifest, declared capabilities, and install receipt, including the source and bundle selector.", |
| 170 | zh: "/plugin show <name> 打印清单、声明的能力与安装回执,包括来源与 bundle 选择器。", |
| 171 | }, |
| 172 | }, |
| 173 | { |
| 174 | title: { en: "Trust", zh: "信任" }, |
| 175 | detail: { |
| 176 | en: "/plugin trust <name> marks your decision. Official catalog provenance grants no execution or network permission on its own.", |
| 177 | zh: "/plugin trust <name> 记录你的决定。官方目录来源本身不授予任何执行或网络权限。", |
| 178 | }, |
| 179 | }, |
| 180 | { |
| 181 | title: { en: "Enable", zh: "启用" }, |
| 182 | detail: { |
| 183 | en: "/plugin enable <name> activates the bundle. Plugin-contributed MCP servers run under namespaced <plugin>-<server> identities with the stricter boundary.", |
| 184 | zh: "/plugin enable <name> 激活 bundle。插件提供的 MCP 服务以 <plugin>-<server> 命名空间身份运行,适用更严格的边界。", |
| 185 | }, |
| 186 | }, |
| 187 | ], |
| 188 | trustNote: { |
| 189 | en: "Downloads are tarball-only with a size cap and no symlinks; traversal, ambiguous roots, and changed plugin identities are rejected. /plugin suggest ranks installed and catalog bundles against a task without installing anything.", |
| 190 | zh: "下载仅限压缩包,有大小限制且不允许符号链接;路径穿越、模糊根目录与插件身份变更都会被拒绝。/plugin suggest 仅对已安装与目录中的 bundle 按任务排序,不会安装任何内容。", |
| 191 | }, |
| 192 | |
| 193 | commandsTitle: { en: "Command reference", zh: "命令参考" }, |
| 194 | commandsLead: { |
| 195 | en: "Run the full lifecycle from the terminal:", |
| 196 | zh: "在终端中完成整个生命周期:", |
| 197 | }, |
| 198 | } satisfies Record< |
| 199 | string, |
| 200 | | LocalizedText |
| 201 | | { title: LocalizedText; detail: LocalizedText; reference: string }[] |
| 202 | | { title: LocalizedText; detail: LocalizedText }[] |
| 203 | >; |
| 204 | |
| 205 | export const PLUGIN_COMMANDS = [ |
| 206 | "/plugin marketplace list", |
| 207 | "/plugin marketplace show codewhale", |
| 208 | "/plugin marketplace install codewhale <name>", |
| 209 | "/plugin install github:owner/repo", |
| 210 | "/plugin show <name>", |
| 211 | "/plugin trust <name>", |
| 212 | "/plugin enable <name>", |
| 213 | "/plugin update <name>", |
| 214 | "/plugin suggest <task>", |
| 215 | ] as const; |
| 216 |