数据处理

scan 读取什么

scan 通过经过身份验证的 GitHub GraphQL 查询，为指定 login 请求仓库、Pull Request、commit、贡献、profile、组织以及可选的 Profile README 字段。这些查询没有仅公开的可见性过滤：结果跟随令牌或查看者的权限，可能包含私有或内部可见的仓库和 PR 数据。请使用最小权限令牌，在扫描前确认它的可见范围。

scan 写入什么

默认的 raw 目录是 out/LOGIN/raw/，里面可能有 repos.jsonl、prs.jsonl、commits.jsonl、contributions.json、user_info.json 和可选的 profile_readme.md。所有生成文件都应当作本地敏感数据——记录中可能包含可识别的作者元数据，以及从私有或内部可见来源派生的内容。

report 写入什么

report 读取这些 raw 文件，在 out/LOGIN/ 下写入 profile.json、top_repos.json 和图表文件。narrate 可能在同一个用户目录里添加提示词文件或生成的导读。

保留与删除

固定源码不强制保留周期。作为操作者，你需要明确用途、使用最小权限令牌、限制访问、避免提交每位用户的生成输出，并在用途结束时删除 raw、派生、提示词和导读文件。

外部传输

扫描时会向 GitHub 发送查询。只有在 API key 存在时，AI 导读生成才会把从 profile 派生的提示词材料发送给配置的 provider。启用之前，先审查提示词内容和 provider 的条款。

Issue 报告状态

遇到可复现的文档问题可以用 Report issue 反馈，附上命令、运行时版本和脱敏后的错误信息；不要附带原始用户记录、提示词或凭据。源码中的留存说明提醒：删除当前文件不会抹除 Git 历史。