Agent Inbox 会把 Markdown 文件变成 AI Agent 工作报告收件箱。每个报告文件可以带一个小型 YAML frontmatter envelope，让 App 识别来源、状态、优先级和时间戳。
这个协议是 local-first 的。Markdown 文件仍然保存在你控制的文件夹里；你在 iOS 或 macOS 授权文件夹后，Agent Inbox 才会索引它们。
文件夹结构
先在 App 中连接文件夹，再让 agent 把 Markdown 报告写进去：
Reports Folder/
reports/
daily-gsc.mdAgent Inbox 只扫描显式连接的文件夹。它会跳过 .git、node_modules、.build、DerivedData 这类开发目录。
Agent Report Frontmatter
每个 AI Agent 报告都是一个带小型 frontmatter envelope 的 Markdown 文件。真正的业务内容放在 Markdown 正文里。
---
report_version: 1
type: agent_report
title: Daily GSC SEO Report
source: openclaw
agent: clawceo
status: needs_review
priority: normal
created_at: 2026-05-15T09:04:32+08:00
---
# Daily GSC SEO Report
## TL;DR
Organic clicks increased slightly, but CTR dropped on two high-impression pages.
## Recommended Action
Generate new title and meta variants for the affected pages.Report 字段
| 字段 | 必填 | 说明 |
|---|---|---|
report_version | 否 | 报告 envelope 版本，使用 1。 |
type | 推荐 | Agent 输出使用 agent_report。也支持 manual_note。 |
title | 否 | 展示标题。省略时回退到第一个 # 标题或文件名。 |
source | 否 | 来源，例如 codex、openclaw、github_actions、cron、mac_helper。 |
agent | 否 | Agent 名称或角色。 |
status | 否 | 可选值：done、needs_review、failed、blocked、partial、draft。 |
priority | 否 | 自由文本，例如 low、normal、high、urgent。 |
created_at | 否 | ISO 8601 时间戳，支持带或不带小数秒。 |
只有 Markdown frontmatter 里有受支持的 type 时，Agent Inbox 才会把它当作 Agent report 候选文件解析。
给 Agent 的提示词模板
可以把下面这段交给负责写报告的 AI Agent：
请为 Agent Inbox 写一份完整 Markdown 报告。
使用 YAML frontmatter：
- report_version: 1
- type: agent_report
- title: <clear report title>
- source: <agent or automation source>
- agent: <agent name>
- status: needs_review, done, failed, blocked, partial, or draft
- priority: low, normal, high, or urgent
- created_at: <ISO 8601 timestamp>
业务指标和原始 provider 数据放在 Markdown 正文里，不要放进 frontmatter。
不要包含 API key、token、cookie 或私密凭据。兼容性说明
当前 App 只会在用户授权文件夹后索引本地 Markdown 文件。因为 Apple 的 security-scoped file access 是设备本地授权，同一个文件夹可能需要分别在 iPhone 和 Mac 上连接一次。
这个 YAML envelope 只用于发现和轻量 review 状态。它不是任务调度器、指标数据库、项目注册表，也不是连接器配置格式。
