@surething/cockpit 1.0.233 → 1.0.235

package/.next-prod/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":20957061,"timestamp":151827038,"id":14,"parentId":1,"tags":{},"startTime":1782975840933,"traceId":"313e8d4206ab0a46"},{"name":"run-typescript","duration":19481077,"timestamp":172788182,"id":1603,"parentId":1,"tags":{},"startTime":1782975861895,"traceId":"313e8d4206ab0a46"},{"name":"static-check","duration":1214307,"timestamp":192311801,"id":1606,"parentId":1,"tags":{},"startTime":1782975881418,"traceId":"313e8d4206ab0a46"},{"name":"static-generation","duration":6666062,"timestamp":193689063,"id":1878,"parentId":1,"tags":{},"startTime":1782975882796,"traceId":"313e8d4206ab0a46"},{"name":"collect-build-traces","duration":21646916,"timestamp":193526726,"id":1875,"parentId":1,"tags":{},"startTime":1782975882633,"traceId":"313e8d4206ab0a46"},{"name":"telemetry-flush","duration":93,"timestamp":215178967,"id":1887,"parentId":1,"tags":{},"startTime":1782975904285,"traceId":"313e8d4206ab0a46"},{"name":"next-build","duration":63530263,"timestamp":151648812,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1782975840755,"traceId":"313e8d4206ab0a46"}]
+[{"name":"run-webpack","duration":20021804,"timestamp":209200108,"id":14,"parentId":1,"tags":{},"startTime":1783087338651,"traceId":"d4faafea5b747eae"},{"name":"run-typescript","duration":17715183,"timestamp":229225693,"id":1604,"parentId":1,"tags":{},"startTime":1783087358677,"traceId":"d4faafea5b747eae"},{"name":"static-check","duration":1182531,"timestamp":246981364,"id":1607,"parentId":1,"tags":{},"startTime":1783087376433,"traceId":"d4faafea5b747eae"},{"name":"static-generation","duration":6044624,"timestamp":248295312,"id":1879,"parentId":1,"tags":{},"startTime":1783087377747,"traceId":"d4faafea5b747eae"},{"name":"collect-build-traces","duration":19380003,"timestamp":248164502,"id":1876,"parentId":1,"tags":{},"startTime":1783087377616,"traceId":"d4faafea5b747eae"},{"name":"telemetry-flush","duration":60,"timestamp":267549705,"id":1888,"parentId":1,"tags":{},"startTime":1783087397001,"traceId":"d4faafea5b747eae"},{"name":"next-build","duration":58524579,"timestamp":209025198,"id":1,"tags":{"buildMode":"default","version":"16.2.6","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1783087338477,"traceId":"d4faafea5b747eae"}]

package/README.md

@@ -26,7 +26,7 @@
 
 ---
 
-> **OpenCockpit is the open-source Claude Code GUI** — and a single canvas for whatever agent you bring next. Run multi-project Claude sessions out of the box; pop open a tab for **Codex, DeepSeek, Kimi, or local Ollama** whenever you need. Built-in terminal, Chrome control, PostgreSQL / MySQL / Redis bubbles, code review, and slash modes — all local.
+> **OpenCockpit is the open-source Claude Code GUI** — an IDE-like workbench for the whole dev loop, and a single canvas for whatever agent you bring next. Run multi-project Claude sessions out of the box; pop open a tab for **Codex, DeepSeek, Kimi, or local Ollama** whenever you need. Built-in terminal, Chrome control, PostgreSQL / MySQL / Redis bubbles, code review, and slash modes — all local. And it's web client–server: **self-host it on a shared dev box and every teammate gets a seat.**
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
@@ -53,6 +53,31 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 | No automation hooks | One-time / interval / cron-based **scheduled tasks** |
 | "Cloud relay" trust concerns | **Fully local**. No telemetry. Keys (Codex / DeepSeek / Kimi) stay in `~/.cockpit/settings.json` on your laptop. |
 
+### How it compares
+
+An honest snapshot as of July 2026 — each tool wins somewhere. Spotted an error? PRs welcome.
+
+|  | **OpenCockpit** | Claude Code Desktop (official) | Opcode |
+|---|---|---|---|
+| Positioning | **IDE-like workbench for the whole dev loop** | agent session companion | session manager for Claude Code |
+| Architecture | ✅ **web client–server** — deploy on a shared dev box; the whole team codes with AI in parallel, each on their own project / worktree | single-user desktop app | single-user desktop app |
+| Open source | ✅ MIT | ❌ closed source | ✅ AGPL-3.0 |
+| Engines | ✅ **Claude + Codex / DeepSeek / Kimi / Ollama** (BYOK) | Claude only | Claude only |
+| Parallel multi-project sessions | ✅ | ✅ | ✅ |
+| Agent-drivable browser & DB (Chrome / Postgres / MySQL / Redis) | ✅ Smart Bubbles | ❌ preview pane only | ❌ |
+| LAN-shared code review pages | ✅ | ❌ | ❌ |
+| Fully offline / air-gapped | ✅ via Ollama | ❌ | ❌ |
+| Phone / tablet access | ✅ any LAN browser — code runs on **your** machine | ✅ via Claude Code on the web (cloud sandbox) | ❌ desktop only |
+| Native desktop app | ❌ local web app (needs Node ≥ 20) | ✅ | ✅ Tauri |
+| Newest Claude Code features on day one | ⏳ tracks Agent SDK releases with a lag | ✅ first party | ❌ |
+| Automation triggers | one-time / interval / cron | ✅ Routines: cron + API + GitHub events | background agents |
+| Session checkpoints / rewind | pinning & forking only | ✅ | ✅ checkpoint timeline |
+| Usage / cost analytics | basic token counts | n/a (plan-based) | ✅ full dashboard |
+| Cost | GUI free (MIT); AI billed by whichever engine you bring — can be $0 with local Ollama | app free; needs a paid Claude plan or API billing | GUI free (AGPL); needs a paid Claude plan or API billing |
+| Actively maintained | ✅ | ✅ | ⚠️ last release Aug 2025 |
+
+**Pick Claude Code Desktop** if you live inside the Anthropic ecosystem and want first-party polish. **Pick Opcode** if you want a native desktop feel with checkpoints and cost analytics. **Pick OpenCockpit** if you want more than a chat window — an open-source, IDE-like cockpit that covers the whole dev loop (read code, drive your browser and databases, review, automate) with any engine you bring, even from your phone.
+
 ## Features
 
 ### Engines — Claude by default, bring any agent you want
@@ -126,6 +151,7 @@ Cockpit is the instrument panel. It does **not** replace Claude Code; it stands
 - **Solo dev, multi-repo:** "I have a refactor running in API, tests writing in Web, and a bug investigation in Pipeline — all at once, all visible."
 - **Day one in an unfamiliar repo:** Open it in Code Map, click through caller/callee pins, walk the auth flow in five clicks instead of a 90-minute file-tree scavenger hunt.
 - **Two-person team:** Senior reviews via LAN-shared review page, no GitHub PR round-trip needed for in-progress work.
+- **Team on a shared dev box:** self-host one Cockpit where the code lives — every teammate opens a browser, takes a seat, and runs their own AI sessions in their own project / worktree.
 - **Reviewing AI-generated PRs:** Switch the changed files into Code Map — changed functions are highlighted with their callers / callees still drawn around them, so blast-radius is one click away.
 - **Full-stack chore mode:** `/fx` in one tab on a backend bug, `/ex` in another to plan the frontend refactor, `/go` to land it — three slash modes, three different agent postures.
 - **Cheap second opinion:** Same prompt in two tabs — Claude in one, **DeepSeek v4-pro** in the other — compare answers before you trust either.

package/README.zh.md

@@ -26,7 +26,7 @@
 
 ---
 
-> **OpenCockpit 是开源的 Claude Code GUI** —— 也是你想接入的任何 Agent 的统一画布。多项目 Claude 会话开箱即用；想用 **Codex、DeepSeek、Kimi 或本地 Ollama**？直接新开一个 tab。内置终端、Chrome 自动化、PostgreSQL / MySQL / Redis 气泡、代码评审与斜杠模式 —— 全部本地。
+> **OpenCockpit 是开源的 Claude Code GUI** —— 贴合研发全流程的 IDE 式工作台，也是你想接入的任何 Agent 的统一画布。多项目 Claude 会话开箱即用；想用 **Codex、DeepSeek、Kimi 或本地 Ollama**？直接新开一个 tab。内置终端、Chrome 自动化、PostgreSQL / MySQL / Redis 气泡、代码评审与斜杠模式 —— 全部本地。Web client-server 架构：**自托管到共享开发机，全队一起飞。**
 
 https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 
@@ -53,6 +53,31 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 | 没有自动化触发器 | 一次性 / 间隔 / **Cron** **定时任务** |
 | 担心"云端中转" | **完全本地**。无遥测，Codex / DeepSeek / Kimi 的 Key 仅存在本机 `~/.cockpit/settings.json` |
 
+### 横向对比
+
+截至 2026 年 7 月的实事求是快照 —— 每个工具都有赢的地方。发现错误？欢迎 PR 指正。
+
+|  | **OpenCockpit** | Claude Code Desktop（官方） | Opcode |
+|---|---|---|---|
+| 定位 | **贴合研发全流程的 IDE 式工作台** | Agent 会话伴侣 | Claude Code 会话管理器 |
+| 架构 | ✅ **Web client-server** —— 部署到共享开发机，全队一起飞，各占各的项目 / worktree | 单机桌面应用 | 单机桌面应用 |
+| 开源 | ✅ MIT | ❌ 闭源 | ✅ AGPL-3.0 |
+| 引擎 | ✅ **Claude + Codex / DeepSeek / Kimi / Ollama**（BYOK） | 仅 Claude | 仅 Claude |
+| 多项目并行会话 | ✅ | ✅ | ✅ |
+| Agent 可驱动浏览器 & 数据库（Chrome / Postgres / MySQL / Redis） | ✅ 智能气泡 | ❌ 仅只读预览面板 | ❌ |
+| 局域网共享评审页 | ✅ | ❌ | ❌ |
+| 全离线 / 内网隔离 | ✅ 走 Ollama | ❌ | ❌ |
+| 手机 / 平板可用 | ✅ 局域网任意浏览器 —— 代码跑在**你自己的**机器上 | ✅ 走 Claude Code on the web（云端沙箱） | ❌ 仅桌面 |
+| 原生桌面应用 | ❌ 本地 Web 应用（需 Node ≥ 20） | ✅ | ✅ Tauri |
+| 第一时间跟进 Claude Code 新特性 | ⏳ 跟随 Agent SDK 发版，有滞后 | ✅ 官方第一方 | ❌ |
+| 自动化触发 | 一次性 / 间隔 / cron | ✅ Routines：cron + API + GitHub 事件 | 后台 Agent |
+| 会话检查点 / 回滚 | 仅固定 & 分叉 | ✅ | ✅ 检查点时间线 |
+| 用量 / 成本分析 | 仅基础 token 计数 | 不适用（订阅制） | ✅ 完整仪表盘 |
+| 费用 | GUI 免费（MIT）；AI 按所带引擎计费 —— 本地 Ollama 可 ¥0 | 应用免费；需付费 Claude 订阅或 API 计费 | GUI 免费（AGPL）；需付费 Claude 订阅或 API 计费 |
+| 持续维护 | ✅ | ✅ | ⚠️ 最后发版 2025-08 |
+
+**选官方 Desktop**：深度绑定 Anthropic 生态、要第一方打磨体验。**选 Opcode**：要原生桌面手感 + 检查点 + 成本分析。**选 OpenCockpit**：你要的不只是一个聊天窗 —— 而是开源、IDE 式、贴合研发全流程的驾驶舱（读码、驱动浏览器和数据库、评审、自动化），引擎随你带，手机也能开。
+
 ## 功能特性
 
 ### 引擎 —— 默认 Claude，也接得住你想要的任何 Agent
@@ -126,6 +151,7 @@ Cockpit 就是那个仪表盘。它**不替代** Claude Code，而是站在官
 - **独立开发者多仓并行：** "API 在重构、Web 在写测试、Pipeline 在排 bug —— 同时跑、同时可见。"
 - **新仓库的第一天：** 用 Code Map 打开它，沿着 caller / callee pin 一路点过去 —— 鉴权流程 5 次点击就走完，不再是 90 分钟的"文件树找地鼠"。
 - **二人小团队：** Senior 用局域网共享评审页 review，半成品代码不用绕 GitHub PR。
+- **共享开发机团队：** 在代码所在的机器上自托管一个 Cockpit —— 队友打开浏览器就能一起飞，各自在自己的项目 / worktree 上跑 AI 会话。
 - **评审 AI 写的 PR：** 把改动文件切到 Code Map，**改动过的函数被高亮**，周围还画着它们的 caller / callee —— 一眼看清这次改动的爆炸半径。
 - **全栈杂活模式：** 后端 bug 一个 tab 跑 `/fx`，另一个 tab 跑 `/ex` 规划前端重构，最后 `/go` 落地 —— 三种姿态、三种 Agent 模式。
 - **便宜的二次意见：** 同一个 prompt 在两个 tab 跑 —— 一个 Claude、一个 **DeepSeek v4-pro**，对比答案后再决定相信谁。

package/bin/cock-browser.mjs

@@ -332,12 +332,13 @@ async function fetchBrowserInfo(shortId) {
 
 // Chunked evaluate result resolver
 //
-// Chrome extension 的 runtime messaging 在 sendResponse 边界有一个 ~8 KiB 的
-// 隐性 structured-clone 截断点；为了避免 evaluate 大结果被默默截掉，
-// extension 侧会把 >6 KiB 的结果暂存到 page window 上的一个 Map，
-// 返回一个 { __cockpit_chunked: true, token, totalBytes, isString } 的
-// descriptor。这里遇到 descriptor 就自动走 evaluate_chunk action 把完整
-// payload 拉回来，对上层 formatOutput 完全透明。
+// Chrome extension runtime messaging has an implicit ~8 KiB structured-clone
+// truncation point at the sendResponse boundary. To keep large evaluate
+// results from being silently cut off, the extension side stashes any result
+// >6 KiB in a Map on the page window and returns a
+// { __cockpit_chunked: true, token, totalBytes, isString } descriptor.
+// Whenever we see that descriptor here, we pull the full payload back via
+// the evaluate_chunk action — fully transparent to formatOutput above.
 async function fetchOneChunk(baseUrl, id, token, offset, cmdTimeout) {
   const resp = await fetch(`${baseUrl}/api/browser/evaluate_chunk`, {
     method: 'POST',
@@ -382,7 +383,8 @@ async function autoResolveChunked(baseUrl, id, data, cmdTimeout) {
     if (data.__cockpit_chunked === true && typeof data.token === 'string') {
       return await resolveChunkedDescriptor(baseUrl, id, data, cmdTimeout);
     }
-    // allFrames=true 聚合时可能得到数组，每一项都可能是独立 chunked
+    // With allFrames=true the aggregate may be an array, and each element
+    // may be independently chunked
     if (Array.isArray(data)) {
       return Promise.all(data.map(item => autoResolveChunked(baseUrl, id, item, cmdTimeout)));
     }
@@ -491,8 +493,9 @@ async function run() {
       process.exit(1);
     }
 
-    // 大结果由 extension 端自动 stash 并返回 chunked descriptor;
-    // 这里透明地把完整内容拉回来，调用方看不到 chunking 细节。
+    // Large results are auto-stashed by the extension side, which returns a
+    // chunked descriptor; we transparently pull the full content back here —
+    // callers never see the chunking.
     const resolved = await autoResolveChunked(baseUrl, id, data.data, timeout);
 
     // Post-`type` verification — `type` via CDP dispatchKeyEvent silently no-ops

package/bin/cock.mjs

@@ -143,12 +143,12 @@ const knownCommands = new Set(['browser', 'terminal', 'update', 'help', 'codegra
 const arg = process.argv[2];
 let projectDir = null;
 
-// 第一个参数不是 flag 且不是已知子命令 → 视为目录路径
+// First arg is neither a flag nor a known subcommand → treat it as a directory path
 if (arg && !arg.startsWith('-') && !knownCommands.has(arg)) {
-  // 展开 ~ 为 home 目录
+  // Expand ~ to the home directory
   const raw = arg.startsWith('~') ? arg.replace(/^~/, homedir()) : arg;
   projectDir = resolve(raw);
-  // 目录不存在则创建
+  // Create the directory if it doesn't exist
   if (!existsSync(projectDir)) {
     mkdirSync(projectDir, { recursive: true });
     console.log(`Created ${projectDir}`);
@@ -173,7 +173,7 @@ const { exec } = await import('child_process');
 const running = await isServerRunning();
 
 if (running) {
-  // 服务已运行 → 打开浏览器，立即退出
+  // Server already running → open the browser and exit immediately
   const base = `http://localhost:${port}`;
   const url = projectDir ? `${base}/?cwd=${encodeURIComponent(projectDir)}` : base;
   if (!process.env.COCKPIT_NO_OPEN) {
@@ -194,7 +194,7 @@ if (!isDev && !existsSync(resolve(PROJECT_ROOT, '.next-prod', 'BUILD_ID'))) {
   process.exit(1);
 }
 
-// 传递项目目录给 server.mjs，让它打开正确的 URL
+// Hand the project directory to server.mjs so it opens the right URL
 if (projectDir) {
   process.env.COCKPIT_OPEN_PROJECT = projectDir;
 }

package/bin/postinstall.mjs

@@ -21,7 +21,7 @@ try {
 }
 
 if (process.platform !== 'win32') {
-  // node-pty: spawn-helper 需要可执行权限
+  // node-pty: spawn-helper needs the executable bit
   try {
     const spawnHelper = join(
       projectRoot,
@@ -33,8 +33,8 @@ if (process.platform !== 'win32') {
 }
 
 // chrome-extension → ~/.cockpit/chrome-extension/
-// npm 安装时 projectRoot 在 node_modules 下（无 src/ 目录），需要复制到用户目录
-// npm link 时 projectRoot 是源码目录（有 src/），不需要复制
+// Installed via npm: projectRoot sits under node_modules (no src/ dir) → copy into the user dir.
+// Via npm link: projectRoot is the source checkout (has src/) → no copy needed.
 const isNpmInstall = !existsSync(join(projectRoot, 'src'));
 if (isNpmInstall) {
   try {
@@ -46,13 +46,13 @@ if (isNpmInstall) {
     cpSync(src, dest, { recursive: true, force: true });
 
     if (process.platform !== 'win32') {
-      // sudo 安装时文件 owner 是 root，Chrome 无法写入 _metadata/
-      // 用 SUDO_USER 还原为真实用户
+      // Under a sudo install the files end up owned by root and Chrome can't
+      // write _metadata/ — restore ownership to the real user via SUDO_USER
       const realUser = process.env.SUDO_USER;
       if (realUser) {
         try { execSync(`chown -R "${realUser}" "${cockpitDir}"`); } catch {}
       }
-      // macOS: 清除 com.apple.provenance 等扩展属性
+      // macOS: strip extended attributes like com.apple.provenance
       if (process.platform === 'darwin') {
         try { execSync(`xattr -cr "${dest}"`); } catch {}
       }

package/chrome-extension/automation.js

@@ -1,11 +1,12 @@
 /**
  * Cockpit Browser Automation Layer (ES Module)
  *
- * 注入到 Cockpit iframe 中，接收来自 BrowserBubble 的自动化命令，
- * 构建 a11y tree、执行 DOM 操作、返回结果。
+ * Injected into the Cockpit iframe; receives automation commands from
+ * BrowserBubble, builds the a11y tree, performs DOM operations, and
+ * returns results.
  *
- * 通过 content.js 的 activateCockpitBridge() 动态 import()。
- * 运行在 content script isolated world 中（保留 chrome.runtime 访问权）。
+ * Dynamically import()-ed by activateCockpitBridge() in content.js.
+ * Runs in the content script isolated world (retains chrome.runtime access).
  */
 
 let _realParent = null;
@@ -14,7 +15,7 @@ let _chrome = null;
 const LOG_PREFIX = '[Cockpit Automation]';
 
 // ============================================================================
-// Ref 系统：为 a11y tree 中的元素分配稳定的 ref ID
+// Ref system: assigns stable ref IDs to elements in the a11y tree
 // ============================================================================
 
 let refCounter = 0;
@@ -91,7 +92,7 @@ function findByRef(ref) {
 }
 
 // ============================================================================
-// A11y Tree 构建
+// A11y Tree construction
 // ============================================================================
 
 const IMPLICIT_ROLES = {
@@ -284,7 +285,7 @@ function safeRegex(src) {
 }
 
 // ============================================================================
-// Console 拦截
+// Console interception
 // ============================================================================
 
 const consoleBuffer = [];
@@ -312,24 +313,26 @@ function initConsoleCapture() {
 }
 
 // ============================================================================
-// Network 捕获（接收 Main World 的 network-capture.js 通过 CustomEvent 发来的条目）
+// Network capture (receives entries sent via CustomEvent from the Main
+// World's network-capture.js)
 //
-// fetch / XHR 拦截在 Main World 执行（network-capture.js），
-// 本层只负责：存储 buffer、管理录制状态、处理 CLI 命令。
+// fetch / XHR interception runs in the Main World (network-capture.js);
+// this layer is only responsible for: storing the buffer, managing
+// recording state, and handling CLI commands.
 // ============================================================================
 
 const networkBuffer = [];
 const MAX_NETWORK_BUFFER = 500;
 
-// 录制状态：由本层管理，通过 CustomEvent 同步给 Main World
+// Recording state: managed by this layer, synced to the Main World via CustomEvent
 const networkRecording = {
   active: false,
   filters: {},   // { url, method, status }
-  timer: null,   // 自动过期定时器
+  timer: null,   // auto-expiry timer
   startedAt: 0,
 };
 
-// 清除所有 entry 的 body 数据（过期时调用）
+// Clear body data from all entries (called on expiry)
 function clearAllBodies() {
   for (const entry of networkBuffer) {
     entry.requestHeaders = null;
@@ -339,32 +342,32 @@ function clearAllBodies() {
   }
 }
 
-// 同步录制状态到 Main World 的 network-capture.js
+// Sync recording state to the Main World's network-capture.js
 function syncRecordingToMainWorld() {
   window.dispatchEvent(new CustomEvent('cockpit:network-recording', {
     detail: { active: networkRecording.active, filters: networkRecording.filters },
   }));
 }
 
-// 监听 Main World 发来的网络条目
+// Listen for network entries sent from the Main World
 function initNetworkListener() {
-  // 请求发起时收到占位条目（保持发起顺序）
+  // Placeholder entry received when a request starts (preserves initiation order)
   window.addEventListener('cockpit:network-entry', (e) => {
     networkBuffer.push(e.detail);
     if (networkBuffer.length > MAX_NETWORK_BUFFER) networkBuffer.splice(0, 1);
   });
-  // 响应完成时收到更新（补全 status / duration / body 等字段）
+  // Update received when the response completes (fills in status / duration / body etc.)
   window.addEventListener('cockpit:network-update', (e) => {
     const update = e.detail;
     const entry = networkBuffer.find(r => r.id === update.id);
     if (entry) Object.assign(entry, update);
   });
-  // 通知 Main World：Isolated World 已就绪，可以 flush 缓存的条目
+  // Notify the Main World: the Isolated World is ready, cached entries can be flushed
   window.dispatchEvent(new CustomEvent('cockpit:network-bridge-ready'));
 }
 
 // ============================================================================
-// 命令处理器
+// Command handlers
 // ============================================================================
 
 const handlers = {
@@ -382,7 +385,7 @@ const handlers = {
     buildA11yTree(document.body, { filter, includeHiddenText, maxDepth }),
 
   screenshot: async () => {
-    // 1) 通知父页面（项目 iframe）：切到 console view + 切到本项目 + 返回 iframe bounds
+    // 1) Notify the parent page (project iframe): switch to console view + switch to this project + return the iframe bounds
     const boundsReqId = 'ss-' + Date.now();
     const bounds = await new Promise((resolve, reject) => {
       const timeout = setTimeout(() => reject(new Error('Timeout preparing screenshot')), 5000);
@@ -397,7 +400,7 @@ const handlers = {
       _realParent.postMessage({ type: 'cockpit:prepare-screenshot', reqId: boundsReqId }, '*');
     });
 
-    // 2) captureVisibleTab 截取整个浏览器标签页
+    // 2) captureVisibleTab captures the entire browser tab
     const dataUrl = await new Promise((resolve, reject) => {
       _chrome.runtime.sendMessage({ type: 'cockpit:capture-tab' }, (response) => {
         if (_chrome.runtime.lastError) { reject(new Error(_chrome.runtime.lastError.message)); return; }
@@ -406,7 +409,7 @@ const handlers = {
       });
     });
 
-    // 3) 裁切到 iframe 区域
+    // 3) Crop to the iframe area
     const img = new Image();
     await new Promise((resolve, reject) => { img.onload = resolve; img.onerror = reject; img.src = dataUrl; });
     const cropCanvas = document.createElement('canvas');
@@ -416,7 +419,7 @@ const handlers = {
     cropCtx.drawImage(img, bounds.x, bounds.y, bounds.width, bounds.height, 0, 0, bounds.width, bounds.height);
     const result = cropCanvas.toDataURL('image/png');
 
-    // 4) 通知父页面截图完成，恢复界面
+    // 4) Notify the parent page the screenshot is done, restore the UI
     _realParent.postMessage({ type: 'cockpit:screenshot-done' }, '*');
 
     return { image: result, format: 'png' };
@@ -659,11 +662,11 @@ const handlers = {
   },
 
   evaluate: async ({ js, allFrames }) => {
-    // 通过 background.js 的 chrome.scripting.executeScript 在 main world 执行
-    // 不受页面 CSP 限制，可访问页面 JS 变量（React state 等）
-    // allFrames: true → 在所有 frame 中执行（解决跨域 iframe 访问问题）
-    // 大结果 (>6 KiB) 会在 MAIN world 被 auto-stash 并以 descriptor 形式返回；
-    // cock-browser CLI 识别 descriptor 后会通过 evaluate_chunk 回填内容。
+    // Executed in the main world via background.js's chrome.scripting.executeScript.
+    // Not restricted by the page's CSP; can access page JS variables (React state, etc.).
+    // allFrames: true → execute in all frames (solves cross-origin iframe access).
+    // Large results (>6 KiB) are auto-stashed in the MAIN world and returned as a descriptor;
+    // the cock-browser CLI recognizes the descriptor and backfills the content via evaluate_chunk.
     return new Promise((resolve) => {
       _chrome.runtime.sendMessage({ type: 'cockpit:evaluate', js, allFrames: !!allFrames }, (response) => {
         if (_chrome.runtime.lastError) {
@@ -677,13 +680,15 @@ const handlers = {
   },
 
   evaluate_chunk: async ({ token, offset = 0, size = 5000 }) => {
-    // 读取 MAIN-world stash 里某个 token 的一段内容。token 由上一次 evaluate
-    // 返回的 descriptor 提供。注意 stash 在 page window 上，页面导航/刷新会丢；
-    // 必须同一个浏览器 session、同一个页面上下文。
+    // Reads a slice of a token's content from the MAIN-world stash. The token
+    // comes from the descriptor returned by the previous evaluate. Note the
+    // stash lives on the page window, so page navigation/reload loses it;
+    // must be the same browser session and the same page context.
     //
-    // 返回 { chunk, done, nextOffset, totalBytes, isString }；
-    // size 默认 5000 以确保每次返回对象 JSON 序列化 < 6000，远低于 Chrome
-    // 在 chrome.runtime 消息边界的 ~8192 字节隐性截断阈值。
+    // Returns { chunk, done, nextOffset, totalBytes, isString };
+    // size defaults to 5000 to keep each returned object's JSON serialization
+    // < 6000, well below Chrome's ~8192-byte implicit truncation threshold at
+    // the chrome.runtime message boundary.
     const offNum = Number(offset) || 0;
     const szNum = Math.min(Math.max(1, Number(size) || 5000), 7000);
     const tokStr = String(token);
@@ -755,10 +760,10 @@ const handlers = {
     };
   },
 
-  // 录制控制：start 开始捕获 body，stop 停止，status 查看状态
+  // Recording control: start begins body capture, stop ends it, status shows state
   network_record: async ({ action = 'status', url, method, status, ttl = 600 }) => {
     if (action === 'start') {
-      // 清除旧的过期定时器
+      // Clear the old expiry timer
       if (networkRecording.timer) clearTimeout(networkRecording.timer);
       networkRecording.active = true;
       networkRecording.filters = {};
@@ -767,7 +772,7 @@ const handlers = {
       if (status) networkRecording.filters.status = status;
       networkRecording.startedAt = Date.now();
       syncRecordingToMainWorld();
-      // ttl 秒后自动过期（默认 10 分钟）
+      // Auto-expire after ttl seconds (default 10 minutes)
       networkRecording.timer = setTimeout(() => {
         networkRecording.active = false;
         clearAllBodies();
@@ -784,7 +789,7 @@ const handlers = {
       networkRecording.active = false;
       if (networkRecording.timer) { clearTimeout(networkRecording.timer); networkRecording.timer = null; }
       syncRecordingToMainWorld();
-      // 停止后不立即清 body，允许查询已录制的数据
+      // Don't clear bodies immediately after stopping; allow querying the recorded data
       return { recording: false, recordedCount: networkBuffer.filter(r => r.recorded).length };
     }
     // status
@@ -1299,7 +1304,7 @@ function simpleJsonPath(data, path) {
 }
 
 // ============================================================================
-// 命令分发
+// Command dispatch
 // ============================================================================
 
 function handleCommand(event) {
@@ -1357,7 +1362,7 @@ function bagCounts(s) {
 }
 
 // ============================================================================
-// 导出初始化函数
+// Exported initialization function
 // ============================================================================
 
 export function initAutomation(realParent, chromeApi) {