Agent Vigil — AI skill for Claude Code

AgentVigil

**Keep a vigil over every agent, in every harness.** 移动看板 + 邮件告警，盯住你所有 AI Agent 的任务。

**AgentVigil** is a mobile **task board** and **email alert** system for your **AI agents** — watch agent tasks **across every harness** from one board and one inbox. 通过电脑端 Node.js 桥接服务，在手机浏览器（PWA）中查看电脑上 AI Agent 的任务列表与任务内容（与电脑端一致的对聊天式视图），并可在手机上**直接给 AI 任务发消息**（确认、纠偏、补充要求）。任务**异常 / 待确认**立即邮件告警，**定时汇总**也走邮件，配对信息变动自动推送——人不在电脑旁也能掌控任务。

• 📱 Mobile task board：PWA 一套代码覆盖 Android / iOS / 鸿蒙，无需上架
• 📧 One email inbox：告警、汇总、配对信息，全部进一个邮箱
• 🔌 Not a plugin：独立桥接服务，不改 Agent 工具本身；当前基线接入「爱思办公」，V4 规划多渠道接入
• 🌐 公网访问：Cloudflare 免费隧道（免账号免域名）+ 配对二维码 + 手机远程配置

**免责声明**：本项目为个人学习研究用途的互操作工具，与爱思办公官方无关。 实现依赖非官方接口，可能随时失效；请仅使用自己的账号、自己的邮箱等外部服务配置。 官方若推出手机版，本项目即完成使命。

支持的 Harness

Harness	状态
爱思办公（Agnes Office，ACP 本地后端 agnesd）	✅ 当前基线
其他 Agent 工具（多渠道接入）	🔜 V4 规划，见《V4多渠道接入需求与设计文档》

AgentVigil 按 **harness 无关**设计：桥接服务与看板/邮件链路不绑定任何一家工具，新 harness 只需新增一个数据源适配器（V4 插件化）。

功能

编号	功能	说明
FR1	连接配对	电脑端展示二维码（地址 + 配对码，码在有效期内可重复使用），手机扫码或手动输入完成配对，下次自动连接
FR2	任务列表	按创建时间倒序展示标题 / 状态（进行中·已完成·失败）/ 时间，支持下拉刷新
FR3	任务详情（对话视图）	与电脑端一致：用户消息右气泡、AI 回复左气泡（Markdown 渲染：表格 / 加粗 / 代码块），底部模型名与时间
FR4	处理过程折叠	每条 AI 回复下方的工具调用折叠为「已处理 N 步」胶囊，默认收起；含失败步骤时红色提示
FR5	实时刷新	WebSocket 事件驱动（任务有变化才拉取）+ 8 秒兜底轮询；断线指数退避重连；内容无变化不重渲染
FR6	手机发消息（V2）	详情页底部输入栏，任务报错或等待确认时直接回复「同意执行」「改用方案 B」等；限速保护
FR7	公网访问（V2）	自动拉起 Cloudflare 免费隧道（免账号免域名），手机任何网络可访问；断线自动重连
FR8	配对信息推送（V2）	配对码/公网地址有变动时，自动把地址+配对码+二维码推送到你的邮箱（邮件带服务器发送时间与「第 N 次生成」计数，与页面/控制台对应；失败自动重试）（企业微信可选）
FR9	配置向导（V2）	首次启动分步引导配置邮箱/隧道/配对策略，保存立即生效（仅限本机访问）
FR10	手机远程配置（V2）	推送邮件带第二个区块（链接+二维码）：手机扫码可改收件邮箱 / 切换发件配置档案 / 发测试邮件（令牌鉴权，敏感操作仍限本机向导）
FR11	发件配置自动故障转移（V2）	保存 ≥2 份发件档案时，当前 SMTP 连续 2 次发送失败自动切换下一份并立即重试——多套配置指向同一收件箱，哪套活着推送都能送达
FR12	任务两级分组（V2）	首页按任务工作目录显示为「文件夹 → 任务」两级（与电脑端一致）：默认只显示文件夹，逐个点开或顶栏「全部展开/收起」
FR13	任务告警与定时统计（V3）	详情页「🔔 追