ADHDev 智能体控制台

这个 Agent 能做什么，适合哪些场景？

ADHDev 是一个自托管的 AI 编码 Agent 控制面板：它不替换也不新建 Agent，而是附着到机器上已安装的 Claude Code、Codex、Kimi、Cursor Agent、Antigravity CLI、Grok CLI、OpenCode 等 CLI 工具（通过 PTY），以及 Cursor、VS Code、Antigravity、Kiro 等 IDE（通过 Chrome DevTools Protocol）和 IDE 扩展（CDP webview）之上。本地守护进程 daemon-standalone 在 localhost:3847 提供 HTTP/WebSocket 服务并托管 Web 面板，daemon-core 管理各类 provider 集成与命令路由，独立的 adhdev-sessiond 进程持有长期 PTY 运行时，使 CLI 会话在守护进程重启或升级后仍然存活。核心能力是 Repo Mesh：任务进入 SQLite 队列（pending → assigned → completed/failed，支持 depends_on 依赖与重试），空闲节点自行认领，每个任务在独立 git worktree 中运行，完成后由 Refinery 执行仓库自带校验、补丁等价性检查、子模块感知的 rebase，并在 main 未移动时才合并、清理 worktree。此外还提供基于订阅额度的路由（读取各 CLI 5 小时与每周配额）、审批收件箱、多视角评审和单一助理聊天。开源版为 AGPL-3.0，云端版额外提供跨网络可达、推送通知和项目文件传输。

启动后守护进程探测本机已安装的 Agent，通过 PTY 启动并驱动 CLI 会话、通过 CDP 连接 IDE，把聊天与原始终端两种视图暴露在 Web 面板上。用户向协调者（coordinator）描述任务，协调者调用 mesh_enqueue_task 将其写入 SQLite 队列并打上难度标签；空闲节点认领后在自动引导（安装依赖、原生重建、生成 gitignore 的构建产物）过的 worktree 中运行 worker Agent。任务完成或失败都写入 mesh 本地 SQLite 的 append-only 账本，运行期学到的操作笔记会被注入后续协调者提示词。Refinery 随后执行仓库自带的校验门禁、补丁等价性检测、子模块可达性检查与原子指针更新，rebase 后仅在 main 未移动时合并，否则转人工持有。额度方面，每台机器读取各 CLI 订阅的 5 小时与每周剩余窗口，接近耗尽的方案被跳过，即将在下次重置前浪费的额度优先消耗，Tasks 页可按难度预测下一个任务分配到哪个槽位。面板通过 WebRTC 数据通道传输聊天、命令、截图与远程输入；自托管模式还暴露 GET /api/v1/status、POST /api/v1/command、/api/v1/runtime/:sessionId/snapshot、/api/v1/mux/:workspace/state 等本地 API 与 ws://localhost:3847/ws。

1. 同时维护多台开发机（笔记本、台式机、构建机）的团队，希望把编码任务丢进一个共享队列，让空闲机器自动认领。
2. 已经在为 Claude Code、Codex、Kimi 等多个 CLI 订阅付费，想避免某个订阅额度到期末被浪费，并按任务难度分配到便宜或昂贵的模型。
3. 在含 git 子模块的 monorepo 中并行跑多个 Agent，需要自动化的 rebase、子模块指针收敛和测试门禁后才允许合入 main。
4. 需要在手机或平板上查看 Agent 会话、审批 rm -rf 或 git push --force 这类高风险命令，而不是守在终端前。
5. 想对一次故障根因分析或设计评审获得多模型交叉意见，把同一问题发给 2–3 个不同 provider 的 worker 并对比结论。
6. 需要为审计留痕的团队，要求每一次派发、完成、失败、停滞都可从 append-only 账本回溯。
7. 已有自研或小众编码 CLI 的开发者，想通过 ~/.adhdev/providers/ 下的 provider.v1.json 清单把它接入统一面板。

如何安装或部署这个 Agent？

需要 Node.js 22 LTS、git，以及至少一个已安装并完成认证的编码 Agent。Windows 上 Node.js 24+ 目前无法正常启动，需改用 22.x 或 PowerShell 安装脚本。

推荐用 adhdev CLI 安装：

npm install -g adhdev
adhdev standalone

或者直接安装独立守护进程包（两个包都提供 adhdev 命令，只装其一，不要同时安装）：

npm install -g @adhdev/daemon-standalone
adhdev-standalone

云端版（多机器、推送通知）可通过安装脚本或 Homebrew：

curl -fsSL https://adhf.dev/install | sh

irm https://adhf.dev/install.ps1 | iex

brew tap vilmire/adhdev && brew install adhdev
adhdev setup

从源码开发需要带子模块克隆，因为 vendor/seqscribe 是构建依赖：

git clone --recurse-submodules https://github.com/vilmire/adhdev.git
cd adhdev
npm install
npm run build
npm run dev

如何使用这个 Agent？

启动后在浏览器打开 http://localhost:3847，面板会检测本机已安装的 Agent。常用启动参数：

adhdev standalone --host 0.0.0.0   # 允许同一局域网的其他设备访问
adhdev standalone --port 8080      # 自定义端口
adhdev standalone --token mysecret # 为脚本或运维访问启用令牌认证
adhdev standalone --no-open        # 不自动打开浏览器
adhdev standalone --dev            # 启用本地 DevServer 端点(:19280)调试 provider

第一个会话：选一个 provider 和工作目录并启动，聊天视图与原始终端视图可切换。当 Agent 请求权限时，请求进入面板的活动收件箱，而不是阻塞在无人查看的终端里。单机试用 Mesh：打开 /mesh，创建一个绑定到仓库的 mesh，克隆一个 worktree 节点，然后排队一个任务并观察账本中 dispatch → completion → Refinery → rebase 合并到 main。局域网或 Tailscale 上的第二台机器可在 mesh 界面用地址加一次性配对码接入。

本地 API 可直接调用：

curl http://localhost:3847/api/v1/status

curl -X POST http://localhost:3847/api/v1/command -H 'Content-Type: application/json' -d '{"type":"..."}'

接入自定义 Agent 的 provider 清单放在：

~/.adhdev/providers/provider.v1.json

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题