Mission Control：实时查看 Claude Code 子代理和工具调用

Mission Control 是一款实时显示 Claude Code 子代理和工具调用的社区插件，作者是 Hamza Zafar（hamzafer），属于他的 claude-code-mods 合集。它把 Claude Code 正在做的事集中到一处：主代理、它的子代理，以及它们发起的每一次工具调用。运行 /mission，聊天旁边就会打开一个显示树结构的面板。主循环在最上方，每个 Claude Code 子代理挂在它下面，工具调用则位于发起它们的代理之下。连续的同一工具调用会折叠成一行，例如 read: README.md → src/login.js ×2，每一行都会显示耗时。

在 Claude 工作期间以及之后的 30 秒内，输入框上方会有一行文字做出汇总：◈ mission: 2 tools，如果有代理或改动过的文件，也会显示它们的数量。第二个视图 /mission code 会绘制一张 Claude 读取或编辑过的文件地图，用箭头表示它们之间的相对导入，正在被处理的文件会发光，每处改动都附有一行说明。作者的 README 要求该合集使用 Claude Code 2.1.287 或更高版本；我们在 2.1.296 上做了测试。

录屏中，我们在小型演示项目里启动加载了该插件的 Claude Code，并让 Claude 读取 README.md 和 src/login.js，用一句话说明它们的作用。Claude 读取这两个文件，工作期间输入框上方的状态行会统计工具调用次数。回答结束后，录屏输入 /mission。面板在输入框上方打开，带有 Who、Code 和 Close 按钮，显示汇总 0 agents (0 running) · 2 tool calls、带有提示词文本的绿色主线，以及其下折叠后的 read: demo-app/README.md → src/login.js ×2 一行。录屏中没有展示代码地图。

使用安装区块中的任意一种方式；它们都直接从作者自己的插件市场安装。然后在会话中运行 /mission。如果是安装到已经打开的会话中，请先运行 /reload-plugins。

插件把树、文件列表和当前视图保存在由宿主持有的 $.state 原子中，因此热重载后画面依然保留。每一次工具调用都被包裹在一个 tool.call 钩子中：先添加一个节点，让调用运行，然后把它标记为完成或失败。以下代码来自 hooks/register.tsx：

let failed = true
let r: Awaited<ReturnType<typeof next>>
try {
  r = await next(e)
  failed = r.deny !== undefined || r.isError === true
} finally {
  await update($, nodes, list => list.map(n => (n.id === id ? { ...n, status: failed ? 'failed' : 'done', end: Date.now() } : n)))
}

agent.spawn 会添加子代理，turn.start 会重置树，turn.complete 会关闭仍标记为运行中的节点。对 Agent 的调用以及 Claude Code 自身的记录类工具（ToolSearch、TaskCreate 等）不会出现在树中。一个每秒触发的时钟只在有任务运行时更新显示；树最多保留 300 个节点。对于代码地图，hooks/map.ts 会构建一个 SVG：它通过 $.fs.read 读取每个被涉及的源文件，用正则表达式找出相对导入，并按导入深度把文件分列排布。SVG 由无头 Chrome 转换为 PNG，再通过面板的 Image 元素显示出来。

/config 中没有任何选项。唯一的控制方式是 /mission、/mission who 和 /mission code，以及面板按钮 w、c 和 q。若要改变行为，请编辑 register.tsx 顶部的常量：MAX_NODES（树的大小）、MAX_FILES（地图上的文件数）、BAND_AFTER_MS（状态行保留多久）、INTERNAL（不进入树的工具）以及 CODE_FILE（会出现在地图上的文件类型）。

在运行之前，我们读过了插件可以执行的每一个文件：.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx、hooks/map.ts、hooks/tree.ts、类型声明以及测试。没有 package.json、安装脚本、二进制文件或打包后的代码，我们也没有发现隐藏的 Unicode 字符、eval 或远程代码。

• 网络： 自身不使用网络。没有 fetch、套接字或主机。
• 模型调用： 在主代理的某一轮编辑或写入文件之后，register.tsx 中的 explain() 会以 model: 'haiku' 调用 $.model.complete。提示词包含每个 old_string 和 new_string 最多 300 个字符（写入的文件最多 400 个字符），回复会成为地图上最多 80 个字符的说明。回复先按 JSON 解析、截断并转义，然后才进入 SVG。它使用你会话的额度。
• 进程： 通过 $.process.run 运行一个 sh -c 脚本，用一次性的配置文件启动无头 Chrome，等待截图完成，然后结束这个 Chrome。文件名和文件夹名作为参数传入，而不是拼接进 shell 字符串。只有当面板打开在代码视图时才会启动 Chrome。
• 文件写入： 仅限 $TMPDIR/mission-control/：map.svg、两个 map-N.png 文件以及一个 Chrome 配置文件夹。不会写入 ~/.claude、设置、shell 配置文件或 LaunchAgents。插件会读取 Claude 涉及的文件以查找导入，并把编辑片段保存在内存中。
• 守护进程： 没有。每秒触发的时钟随会话结束而停止，Chrome 在每次截图后都会被结束。
• 密钥与环境变量： 只读取 TMPDIR。
• 遥测： 没有。
• 对提示词的影响： 它不添加任何 additionalContext，也不改写提示词或工具结果。
• 拦截型钩子： tool.call 和 agent.spawn 被包裹，claude plugin validate 把它们列为没有 .catch 的拦截型钩子。它们只做观察；tool.call 原样返回工具结果，也不修改参数。
• 外部依赖： 代码地图需要位于 /Applications/Google Chrome.app 的 Google Chrome（macOS 路径）；Who 视图不需要。
• 许可证： MIT，附带 LICENSE 文件。

claude plugin validate 没有报告任何错误或警告，作者的 7 个测试在 Claude Code 2.1.296 上全部通过。

已在 macOS 上使用 Claude Code 2.1.296 检查（validate、测试和录屏）。如果出现问题：

• /mission 是未知命令。 在 /plugin 中确认插件已加载，全新安装后运行 /reload-plugins。
• 代码地图提示需要 Google Chrome。 把 Chrome 安装到 /Applications/Google Chrome.app。插件只会查找这个路径。
• 显示 "Nothing yet"。 树会在一轮对话运行时逐步填充。开始一个任务，各行就会出现。
• 在终端之外没有地图。 在其他界面中，面板会提示代码地图只在终端中绘制。
• 状态行没有出现。 它只在 Claude 工作期间及之后的 30 秒内显示，问卷打开时也不会显示。