ArgusBot 是一个用于 Codex CLI 和 Claude Code CLI 的 Python 监督插件。它的核心用途是让智能体持续运行、审查和规划，直到任务真正完成，从而解决常见的“智能体过早停止并要求下一条指令”问题。
主要能力与工作方式：主智能体通过所选执行后端执行任务；审查子智能体评估完成状态（done / continue / blocked）；规划子智能体维护实时框架视图并提出下一会话目标；循环仅在审查者表示 done 且所有验收检查通过时才停止。默认 max_rounds 为 500；守护进程子模型默认继承所选后端的默认值，除非显式设置预设或覆盖；守护进程启动的空闲运行会先尝试从上次保存的 session_id 恢复。
功能快照包括：带审查门控的主智能体持久循环；具备实时计划快照、工作流表和后续目标提议的规划/管理智能体；跨规划扫描维护的规划 TODO 板（plan_todo.md）和探索者待办；停滞看门狗，具备软诊断与硬重启安全窗口；实时可见性包括终端流、仪表盘、Telegram 推送和 typing heartbeat；运行期间支持 Telegram 入站控制（/inject、/status、/stop、语音/音频转写）；运行期间支持飞书入站控制（/run、/inject、/status、/stop、/plan、/review 的文本轮询及纯文本路由）；空闲启动的常驻守护进程模式；守护进程后续提示；规划模式 off、auto、record，设置默认 auto；守护进程双控制通道 Telegram 和终端；单词操作入口 argusbot；基于令牌唯一的守护进程锁；操作员消息历史持久化为 markdown 并反馈给审查决策；为运行交接自动生成 PPTX；最终交接产物在审查者 done 后生成 Markdown 与 PPTX；运行归档以 JSONL 持久化，包含日期/工作区/会话元数据。
快速开始（24/7 Telegram 控制）：需先安装并认证所选后端 CLI（确保 codex 或 claude 可用，再运行 argusbot init）。24/7 守护进程运行时，选择 high 或 xhigh 推理可能导致 token 使用接近持续运行一个 Codex 会话 24 小时，需仔细规划预算；medium 推理通常是长时后台控制的质量/成本折中。步骤：克隆仓库并以可编辑模式安装；进入目标项目目录；运行 argusbot init，选择控制通道和执行后端并完成设置提示；设置后守护进程在后台启动并持续运行；通过 Telegram 机器人对话使用 /run、/inject、/status、/stop 控制。初始化时先选控制通道（1. Telegram，2. 飞书，适合 CN 网络环境），再选执行后端（1. Codex CLI，2. Claude Code CLI），然后输入所选通道凭据。配置持久化在主项目的 .argusbot/ 下。
运行后端：--runner-backend codex 使用 Codex CLI；--runner-backend claude 使用 Claude Code CLI；--runner-bin 选择底层可执行路径，--codex-bin 作为兼容别名。Copilot 代理仅适用于 Codex 后端。Claude 仅接受 low|medium|high effort，因此选择 Claude 时 ArgusBot 将 xhigh 映射为 high。
为什么是插件而非原生标志：当前 Codex CLI 和 Claude Code CLI 未提供内置的 --autoloop 标志，因此该仓库在其原生任务执行命令之上增加了一层包装。
PPTX 报告依赖（可选）：PPTX 运行报告生成器使用 Node.js 脚本；若 node 不可用，PPTX 生成会被静默跳过，不会阻塞循环。
通过 copilot-proxy 使用 GitHub Copilot：ArgusBot 可将 Codex 后端调用路由到本地 copilot-proxy 检出，使主/审查/规划/BTW 运行可使用 GitHub Copilot 配额而非 OpenAI API 计费。启用时会自动启动 proxy.mjs（如需要）并按运行注入 Codex 提供程序覆盖，无需重写全局 ~/.codex/config.toml。Claude 后端按设计忽略 Copilot 代理设置。
原生 GitHub Copilot CLI 后端：可从设置选择后端 3. GitHub Copilot CLI，或直接使用 CLI。若将模型设置留空，ArgusBot 不会传递 --model，Copilot CLI 保持其官方默认模型。--main-model、--reviewer-model、--plan-model 在显式设置时转发到 Copilot CLI --model；--main-reasoning-effort、--reviewer-reasoning-effort、--plan-reasoning-effort 映射到 Copilot CLI --reasoning-effort；--yolo 映射到 Copilot CLI --yolo / --allow-all。非交互提示模式下，ArgusBot 授予 Copilot CLI 工具自动批准，使运行可自主进行；原生 Copilot 后端不使用 copilot-proxy。
单词操作工作流（argusbot）：首次运行询问控制通道（默认 Telegram），再选运行后端（1. Codex CLI、2. Claude Code CLI、3. GitHub Copilot CLI），然后收集所选通道凭据，写入 .argusbot/daemon_config.json，并在当前 shell 目录启动守护进程。后续运行复用配置，确保守护进程运行，然后直接附加到实时输出。argusbot init 会停止所有当前 ArgusBot 守护进程，提示控制通道+后端+凭据/模型/游玩模式，在后台启动守护进程后退出。init 后运行 argusbot 可将监视器附加到后台守护进程。
同一终端可控制守护进程/运行，支持命令包括 /run <objective>、/new、/inject <instruction>、/mode <off|auto|record>、/btw <question>、/confirm-send、/cancel-send、/plan <session-goal-or-direction>、/review <criteria>、/show-main-prompt、/show-plan、/show-plan-context、/show-review [round]、/show-review-context、/status、/stop、/daemon-stop。纯文本自动路由：运行中 => 注入，空闲 => 运行。规划模式语义：off 禁用守护进程启动运行的规划智能体行为；auto（默认）规划器保持启用并可提议下一请求，但在 /plan <session-goal> 确认当前会话目标前，守护进程不自动运行后续；record 规划器仅记录 markdown，不自动执行后续。守护进程启动的运行默认始终使用 --yolo。
常用选项包括 --runner-backend {codex,claude,copilot}、--runner-bin <path>、--session-id <id>、--main-model / --reviewer-model、--planner-model、--copilot-proxy [--copilot-proxy-port 18080] [--copilot-proxy-dir /custom/path]、python -m codex_autoloop.model_catalog、--yolo、--full-auto、--state-file <file>、--final-report-file <file>、--pptx-report-file <file>、--plan-report-file <file>、--plan-todo-file <file>、--plan-update-interval-seconds 1800、--verbose-events、--dashboard、--dashboard-host 0.0.0.0 --dashboard-port 8787、--telegram-bot-token + --telegram-chat-id、--telegram-events、--telegram-live-interval-seconds 30、--feishu-app-id / --feishu-app-secret / --feishu-chat-id、--feishu-events、--feishu-live-updates + --feishu-live-interval-seconds 30、--feishu-heartbeat-interval-seconds 600、--feishu-control、--no-live-terminal、--stall-soft-idle-seconds 3600、--stall-hard-idle-seconds 10800、--telegram-control 等。
重要警告：守护进程启动的运行默认使用 --yolo，授予所选后端高本地执行权限，仅应在受信任的仓库/工作区运行。Telegram/飞书片段可能隐藏重要细节，若行为异常，先在目标工作区运行 argusbot 查看本地实时输出/日志。长时目标可能消耗大量 token，规划器或审查器质量也可能导致重复循环，应始终设置清晰验收检查、监控运行时间并在需要时停止/重新界定范围。守护进程支持通过 Telegram 和飞书远程控制，且守护进程启动的运行可能以高本地权限执行，因此 bot 令牌、应用密钥及相关凭据应视为高度敏感；若凭据泄露，未经授权方可能发出在你的本地机器或工作区执行的远程命令；切勿分享令牌、切勿提交到仓库，怀疑暴露时应立即轮换。
