并行 Agent 盯不过来？Nezha 把会话、终端与 Git 收到一桌

开三个仓库、各挂一个 Claude Code 或 Codex，终端标签很快就会变成「哪个在等你确认、哪个已经改完、哪个还在瞎跑」的注意力考验。真正缺的往往不是更强的模型，而是一张能同时盯住多会话、还能顺手看 diff、切 worktree、回放历史的控制台。

开源项目 hanshuaikang/nezha（哪吒）把这件事做成了 Agent 优先的轻量桌面 IDE：基于 Tauri 2 + React + xterm.js，把多项目工作区、原生终端里的 Claude Code / Codex、会话可视化、轻量代码编辑、Git 与 Git Worktree、Skill 软链管理收进同一界面。官方 README 强调安装包约 7MB；截至本文核对，仓库约 1.9k Star，最新发行版为 v0.4.7（2026-08-01），已提供 macOS / Windows / Linux 安装包。源微信页常遇验证码拦截，下文以 GitHub README、Release 资产与仓库元数据为准做深度改写，不复述营销话术。

一、先分清：Nezha 不是「又一个 Claude 聊天客户端」

同类桌面产品里，至少有三条不同赛道：

Nezha 的定位落在第三列。它不会重新实现一套「假终端」聊天协议，而是用 PTY + xterm.js 直接托管本机已安装的 Claude Code / Codex 二进制；上层再叠任务生命周期、会话自动发现、通知角标、以及 Review / Commit 所需的编辑与 Git 视图。心智模型可以写成：

Nezha ≈ 多项目 Agent 调度台 + 虚拟终端 + 会话时间线 + 轻量编辑器 + Git / Worktree，而不是「带皮肤的 Chat」。

因此前置条件很硬：先装好 Claude Code 或 Codex。应用只是编排层；本机没有 Agent CLI，工作台就没有可调度对象。

二、为什么要另开一张「调度桌」

传统 IDE（含 VS Code）的设计中心是「人在一个仓库里敲键」。插件、补全、重构都在放大单人串行效率。Vibe Coding 时代变化的是：代码生成可以并行，人的注意力却不能。常见失败模式是：

1. 终端里开 5 个标签，某个 Agent 停在 Do you want to proceed?，你却盯着另一个仓库的编译日志。

2. 会话一结束，历史只能靠 resume 或翻滚动缓冲，很难「置顶重要对话、可视化回顾」。

3. 改完要切到外部 Git 客户端做分支、diff、commit message；再切回 IDE 看文件——上下文切换本身开始吃掉并行收益。

Nezha 的回答是：把 项目切换、任务状态、终端实时输出、会话回放、代码浏览、Git 工作流 钉在同一窗口。侧边栏点一下换项目，后台会话继续跑；需要人工确认时，系统通知与应用角标会把你拉回来。官方文案里的「提升 5 倍编程效率」应理解为注意力调度收益的宣传口径——实测会随仓库复杂度、Agent 权限模式与你的确认频率波动，不宜当基准测试数字。

三、核心能力拆解：从工作区到闭环

3.1 多项目工作区

左侧（或侧栏）挂载多个仓库路径，单击切换。设计目标是：切换 UI 焦点，不杀掉后台 Agent。适合「主线需求在 A 仓，同时让 Codex 在 B 仓扫测试 / 修文档」这类并行编排。

3.2 会话管理与可视化

相对「终端结束即失忆」，Nezha 会在会话结束后自动可视化对话内容，支持回顾与置顶。需要继续时再 Resume。对排障很有用：你能回答「昨天那个改登录流的会话里，模型最后改了哪几个文件」，而不必在一堆滚动缓冲里捞。

3.3 原生终端体验

虚拟终端跑的是本机 Claude Code / Codex，交互接近本地终端。v0.4.7 还补了模型与推理档位选择、终端选中即复制等细节。记住：权限、网络、API Key 仍由各 CLI 自己的配置负责；Nezha 不替你绕过 Anthropic / OpenAI 账户策略。

3.4 轻量代码与 Markdown 编辑

内置 CodeMirror 系编辑器（仓库依赖可见 @uiw/react-codemirror 与多语言 lang 包），够做 Review、小改、看 Markdown 预览。它不是要取代完整 IDE；重度重构、调试适配器、巨型扩展生态仍应回 VS Code / JetBrains。

3.5 Git 与 Git Worktree

支持一键建分支、AI 生成 commit message、Code Review 视图，以及 Git Worktree 工作流。并行 Agent 场景下，Worktree 能把「同一仓库的两条实验分支」物理隔离到不同目录，减少两个 Agent 抢同一工作树的概率——这比单纯多开终端更贴近真实工程习惯。

3.6 Skill 管理

可通过软链集中管理本机 Skill。对已经在用 Claude Code Skills / 自定义技能目录的人，这相当于把散落的技能入口收到调度台旁边，避免每个项目各拷一份。

3.7 主题

内置白天、黑夜与护眼模式。长时盯场时，护眼模式比「再装一套主题插件」更省事。

四、安装与平台：7MB 叙事 vs 发行包体积

README 写「安装包只有 7M」。发布页上的实际资产会更大——例如 v0.4.7 的 macOS .dmg、Windows setup、Linux .deb / .rpm 多为数 MB 到十余 MB 量级，且随架构变化。阅读时建议把「7MB」理解为产品对 轻量桌面壳 的定位宣传，以 Releases 当前文件大小为准。

4.1 macOS 未签名拦截

首次打开若提示「已损坏，无法打开」，多半是隔离属性（quarantine）而非真损坏。官方给出：

xattr -rd com.apple.quarantine /Applications/nezha.app

执行后再打开。仍失败时检查：是否拖到了 /Applications、是否下错了 arm64 / x64 架构、Gatekeeper 是否被企业策略锁死。

4.2 Windows / Linux

v0.4.7 已提供 x64 / arm64 的 .exe / .msi，以及 .deb / .rpm。Linux 用户注意依赖与显示服务器差异；若窗口起不来，先确认本机 GPU/Wayland 组合是否被 Tauri WebView 支持，再查 Issues。

4.3 从源码开发

技术栈在 package.json 写得很清楚：Vite + React 19 + Tauri 2 + Vitest。常见命令：

pnpm install   # 或项目文档指定的包管理器
pnpm dev       # 前端
pnpm tauri dev # 桌面壳联调
pnpm tauri build

数据目录方面，社区资料常见 ~/.nezha 作为持久化位置（具体子目录以当前版本为准）。升级大版本前建议自行备份该目录与各 Agent 的会话历史。

五、推荐工作流：并行但不失控

一套可复用的「盯场」流程：

1. 先装 Agent CLI：确认 claude / codex 在 PATH 可运行，登录与权限模式已在官方文档下跑通最小任务。

2. 用 Worktree 隔离实验：主分支留给自己，Agent 任务放到独立 worktree，避免互相覆盖未提交改动。

3. 在 Nezha 里按项目挂载：A 仓跑实现、B 仓跑测试修复；打开通知权限。

4. 只在确认点介入：把精力留给「需要人拍板」的提示，而不是盯每一行流式输出。

5. 结束后可视化回顾 → Review diff → AI 辅助写 message → 提交：轻度闭环不必再开完整 IDE。

6. Skill 用软链统一：团队共用的技能目录链到一处，减少「这个项目有、那个项目没有」。

六、排坑清单与边界警告

不是模型替代品：Nezha 不提供推理额度。账单、限流、组织策略仍在 Claude / Codex 侧。

签名与安全：macOS 未签名包需要 xattr；企业环境可能禁止运行。下载只认 GitHub Release 或官网 nezha.hanshutx.com，不要信来路不明的「破解包」。

权限模式：Agent 若以宽松权限跑在生产仓库，桌面壳再漂亮也挡不住误删。先在练习仓验证，再挂真实项目；关键操作保持手动确认。

平台成熟度：虽已发多端安装包，个别 Linux / 显卡组合仍可能踩 WebView 问题；遇崩先搜 Issues，并附上版本号 0.4.7 与系统信息。

与官方 Desktop 的关系：Anthropic 的 Claude Desktop Code 页是官方图形入口；Nezha 是第三方开源调度台，二者可并存，但配置、会话历史、权限模型不互通。不要假设「在 Nezha 里登录一次等于官方 Desktop 全打通」。

许可证：仓库为 GPL-3.0。二次分发或商业嵌入前先读许可证义务，避免把改动闭源进专有桌面产品却未履行 copyleft 要求。

七、本机快速核对脚本

把下面脚本放到练习目录执行，可快速确认「Agent CLI 是否在 PATH、官方仓库与 Release 是否可达」。它不安装 Nezha，只做环境体检：

bash practice/check_nezha_env.sh

典型输出应包含：CLAUDE_CLI / CODEX_CLI 是否安装、GitHub 仓库 HTTP 状态、最新 Release 页是否可达。若 CLI 缺失，优先去官方渠道装 Agent，再回来装桌面壳。

八、小结：什么时候值得装

如果你已经在用 Claude Code / Codex，并且痛苦点是 多仓库并行时注意力碎片化，Nezha 值得一试：它把调度、终端、会话回放与 Git 轻闭环收在约「轻量级桌面壳」里，而不是再造一个聊天 App。

如果你还在为 API Key、安装失败、国内镜像发愁，应先解决 Agent CLI 本身（或考虑安装/配置类枢纽工具），再谈调度台。

如果你要的是 Anthropic 官方权限体系与云端会话一体化，优先看 Claude Desktop 的 Code 页；Nezha 更适合「本机多 Agent、多项目、要 Worktree」的编排党。

仓库地址：https://github.com/hanshuaikang/nezha。装之前记住三句话：先有 Agent，再有工作台；先练习仓，再生产仓；先看 Release 体积与平台包，再被「7MB」口号带节奏。