数据与隐私
Agent Note 面向希望保留 AI review history、但不想依赖 hosted backend 的团队。永久数据是 git-native，临时数据保留在 local clone 中。
| 项目 | 行为 |
|---|---|
| Hosted service | 不需要 Agent Note server |
| 永久历史 | refs/notes/agentnote 中的 git notes |
| 临时数据 | .git/agentnote/，不会 commit |
| Telemetry | 不向 Agent Note service 发送 prompt、response 或 path |
| 字段 | 用途 |
|---|---|
prompt / response | 产生 commit 的对话 |
contexts[] | 给短 prompt 的 display-only hint |
files | committed files 以及 AI 是否修改 |
attribution | AI Ratio、method 和可用行数 |
agent / model | agent 与 model metadata |
匹配 repository root 的 .agentnoteignore 的 path 仍会保留在 files 中，只会从 AI Ratio 的分母里排除。
完整 schema 见 工作原理。
启用 Dashboard 前
Section titled “启用 Dashboard 前”| 需要确认的事 | 建议 |
|---|---|
| 能看到 Pages 的人是否也可以读取 prompt | 只有当 Pages 可见范围符合仓库策略时，才启用 Dashboard。 |
| prompt 是否可能包含 secret 或客户数据 | 把 git notes 当作 review data，不要把 secret 写进 prompt。 |
| 是否只需要 PR review 的上下文 | 只使用 PR Report，跳过 --dashboard。 |
| 层级 | 位置 | 是否共享 |
|---|---|---|
| 临时 session data | .git/agentnote/sessions/ | 否 |
| 永久 notes | refs/notes/agentnote | 是，执行 git push 时 |
| PR Report | PR description 或 comment | 是，在 GitHub 中 |
| Dashboard | Pages artifact 与 gh-pages/dashboard/notes/*.json | 是，启用后 |
不保存的内容
Section titled “不保存的内容”- 整个 workspace。
- 不把 shell command output 当作 file evidence 保存。
- 上传到 Agent Note backend 的数据。
能 fetch refs/notes/agentnote 的人可以读取保存的 prompt 和 response。请把 git notes 当作 repository data 处理。
Dashboard 是可选的。如果不需要共享 web view，只使用 PR Report，并跳过 --dashboard。