介绍
什么是 Agent Inbox?
Agent Inbox 是用于 AI agent 报告的 Markdown inbox。
Codex、OpenClaw、CI 修复脚本或增长自动化可以把结构化 Markdown 文件写入已连接的文件夹。Agent Inbox 会索引这些文件，让人类可以在 Mac 或 iPhone app 中审核 unread、needs-review 与 failed 报告。
持久 artifact 仍然是你控制的文件夹里的 Markdown 文件。App 只是围绕这个文件增加审核工作流，不替代你的编辑器、Obsidian vault、Git 历史或 issue tracker。
核心工作流
- 在 App 中连接文件夹。
- 让 agent 把报告 Markdown 写入这个文件夹。
- 在 Agent Inbox 中审核报告。
- 标记已审核，或要求继续跟进。
报告 frontmatter
Agent Inbox 读取一个很小的 YAML frontmatter 契约：
---
report_version: 1
type: agent_report
source: codex
agent: codex
status: needs_review
priority: high
created_at: 2026-05-15T09:00:00Z
---HTML artifact
Agent 也可以推送完全自包含的 HTML 页面（例如可视化报告、仪表盘），而不只是 Markdown 文本。使用 Content-Type: text/html 直接 POST，或在 JSON 中带上 html 字段。每个 HTML artifact 会发布到一个稳定的 /r/{slug} 链接。
用相同的 artifact_key 重新推送即可原地更新同一个链接（revision 递增；内容不变则返回 unchanged）；不传 artifact_key 时每次都会新建一篇。由于发布端 CSP 会拦截所有外部请求，HTML 必须内联所有 CSS/JS，图片用 data: URI。