Nodo

简体中文 | English

一个人，指挥一支 AI 编程团队。

让 Claude Code 规划、Codex 实现、OpenCode 审查——你只说目标，剩下的由它们自己分工、执行、汇报。

上图为演示片段，约 40 秒的完整版可以 在线观看。

它解决什么问题

同时用好几个 AI 编程工具时，你要在多个终端之间来回切换，手动复制结果、转述上下文，谁做到哪一步全靠记忆。真正的瓶颈是你的注意力：每多一个会话，就多一份要记住的上下文。

Nodo 是运行在 DeepSeek Harness（下称 dsh）里的插件，把这些 Agent 放进同一个窗口：

• 各用各的：每个 Agent 仍用自己原生的登录、模型和工具，Nodo 只通过官方公开接口接入，不替它们干活。
• 有人派活：设一名主控，由它给任务分类，再按你配置的规则派给对应角色；执行结果自动回到主控，不用你搬运。主控只收到结论和结果预览，完整结果按需读取，不会被执行细节占满上下文。
• 省钱：难题交给强模型，常规任务交给便宜的角色。

三步看懂

1. 建角色：给每个 Agent 定名字和职责，例如 coder（Codex）、reviewer（OpenCode）。
2. 组团队：把角色放进团队，指定一名主控（Claude Code 或 Codex），并设置「什么任务派给谁」。
3. 说目标：在团队里新建会话，告诉主控你要什么。它派活、执行者干活、报告回来，整个过程在一个界面里按轮显示，随时点「查看会话」看细节。

安装

需要：dsh 0.2.0-rc.1 或更高版本；至少一个已登录的 Agent（目前已接入 Codex、Claude Code、DeepSeek Harness、ZCode、CodeBuddy、OpenCode、Qoder，Pi 为实验性接入）。

在 dsh 插件页点击 添加插件 → 安装第三方插件，输入 GitHub 地址 https://github.com/waikoeng234/Nodo，重新加载后侧栏出现 Nodo 即成功：

从源码安装：克隆仓库后在 orchestrator/ 执行 npm ci --ignore-scripts && npm run build:check（需要 Node.js 24+），再在插件页填入该目录路径。

快速开始

1. 首次引导：打开 Nodo，按提示启用 Agent、创建角色、添加项目。检测不到的 Agent，到 设置 → 模型提供方与 Agent 填程序路径。
2. 创建角色：在「角色」页新建，填职责概述，选 Agent、模型和权限。可套用 coder、reviewer、tester 等预置模板。
3. 建团队、设主控：新增团队，把执行角色拖进成员区，把主控角色拖进「拖入主控」。
4. 任务分配：点「任务分配」，添加任务类型（如「功能开发」），为每种类型指定承接角色；需要时用「困难任务单独指定」为难题另选角色。
5. 开始派活：在左侧「团队」标签下新建会话，选择主控，说明目标。

主控只能是 Claude Code 或 Codex，且只领导一个团队。只有在「团队」标签下新建的主控会话才会派活。

手机远程

在 macOS 的 DSH Desktop 中打开 Nodo 设置 → 手机远程，按提示完成：

1. 电脑和手机安装 Tailscale，登录同一账号并连接。
2. 点击 启用手机远程；首次使用时在授权页启用 HTTPS certificates，保持可选的 Funnel 关闭，再回到 Nodo 继续配置。
3. 点击 连接手机，用手机扫描二维码，在浏览器里打开 Nodo。以后可收藏该地址。

无需另外启动 dsh web。手机连接的是这台 Desktop 的同一个宿主，任务仍在电脑上执行；电脑需保持联网、唤醒，Desktop 保持运行。Android 上 Tailscale 会替换正在运行的 VPN。登录二维码授予整个 DSH 宿主的所有者权限，请勿分享。详细的日常使用、关闭和排错方法见手机远程指南。

为什么不直接用「多模型 API」或 Subagent

它们是在同一个 Harness 里换模型或拆任务；Nodo 是把多个原生 Agent 组织起来，各自保留自己的执行环境。两者不冲突，Agent 在 Nodo 里照常可以用自己的 Subagent。

工作原理

flowchart LR
    U[你] --> N[Nodo<br/>团队 · 角色 · 会话]
    N --> L[主控<br/>按任务类型和难度派活]
    L --> D[驱动层]
    N --> D
    D --> A[Codex · Claude Code · OpenCode …]
    A --> P[(项目目录)]
    A -.->|报告| L

• 接入：走各 Agent 官方公开接口（如 Codex app-server、Claude Code stream-JSON、OpenCode ACP）。
• 角色：职责概述通过 Agent 自己的系统提示通道注入，每个会话一次。
• 派活：主控只给任务分类（类型和是否难题），派给谁由你在「任务分配」里的配置决定，同样的输入结果一致。
• 报告：主控只收到结论和结果预览，完整正文按需读取；中间过程留在执行会话里，需要时用「查看会话」回查。
• 决策：要改公共接口或兼容方式、增加范围、几个方案互斥这类需要你定的事，主控会停下来在团队会话里提问，不自己选。有没回答的问题时这个会话不派新活，你答完它才重新规划。

更多细节见架构说明。

数据与隐私

• 项目、角色、团队和会话保存在本机 ~/.dsh/orchestrator，反馈问题时请勿上传这个目录。
• Nodo 自己不上传数据，但各 Agent 会把任务和代码发给它配置的模型服务，费用和数据规则以该服务为准。

当前限制

• 各 Agent 在模型、思考档位、图片、附件等方面能力不同，Nodo 只接入 Agent 实际提供的部分。
• 主控目前只支持 Claude Code 和 Codex。
• 主控同时最多派 5 个活，每轮最多派 24 个；子任务用 parentId 归属目标（父任务已验收时先 reopen），有先后依赖用 dependsOn（全部验收为 done 后才能派活）；会改同一批文件的任务用 worktree:true 隔离，Nodo 不自动合并。
• 决策关口只保证已经提出来的问题会挡住主控：它仍可能漏问需要你定的取舍，或把现有的依据判得太宽；重要的取舍还是自己确认。
• 只在你发消息后行动，不会监听群聊、PR、CI 等外部事件，也不会主动开工。
• 没给任务类型配置承接角色时，主控无法派活，会说明缺口并停下。
• ZCode 无法直接调用订阅服务：需要在 coding plan 内创建 API key，再在 ZCode 里添加自定义供应商并填入该 key，才能识别到 ZCode 模型。

常见问题

安装后没有 Nodo 入口？ 重新加载插件和页面；本地安装时确认路径指向含 package.json 的 orchestrator/ 目录，且已执行 npm ci --ignore-scripts 和 npm run build:check。

检测不到 Agent？ 宿主的 PATH 可能与终端不同，在 Agent 设置里填 CLI 的绝对路径。

主控不派活？ 依次检查：团队是否设了主控、执行角色是否在团队里、是否有任务类型、每种类型是否选了承接角色；会话里还有没回答的待决问题时要先回答。

删除角色或项目后历史会话还在吗？ 在，会归档保留，在侧栏「已移除」中只读查看。

一起开发

我是独立作者，精力有限。如果你对 Nodo 感兴趣，有能力也有精力，想一起把它做下去，欢迎在 Discussions 或 Issues 留言，说明你的想法或想负责的方向。

接入新的 Agent、完善文档、修 Bug、做测试，都欢迎。

参与

欢迎提交问题和代码：贡献指南 · 开发指南 · 架构说明 · 设计系统 · 问题反馈

许可证

Apache-2.0，版权声明见 NOTICE，第三方内容见第三方声明。文中提及的产品名称与商标归各自权利人所有。