Neo-ZQYY/docs/audit/README.md

审计目录（docs/audit/）

项目级统一审计落地点。所有模块（ETL、后端、小程序、管理后台等）的审计产物均写入此目录。

子目录与文件

目录/文件	说明
changes/	AI 逐次变更审计记录（<YYYY-MM-DD>__<slug>.md）
prompt_logs/	Prompt 日志文件（每次 prompt 生成一个独立文件，按时间戳命名）
session_logs/	全量会话记录（按 YYYY-MM/DD/ 分层），含双索引和 LLM 操作摘要。详见 SESSION-LOG-GUIDE.md
audit_dashboard.md	审计一览表（自动生成，勿手动编辑）
SESSION-LOG-GUIDE.md	Session 日志使用指南（索引字段、查询方法、典型场景）

维护约定

• prompt_logs/ 由 prompt-audit-log Hook 自动管理，请勿手动编辑
• session_logs/ 由 agentStop Hook 自动提取，索引由提取脚本自动更新
• audit_dashboard.md 由 /audit 流程自动刷新，也可通过 python scripts/audit/gen_audit_dashboard.py 手动重新生成
• 变更审计记录由 /audit 流程（audit-writer 子代理）生成，包含 session_id 字段与 Session 日志双向关联
• 历史记录（迁移前 ETL 子项目的审计）已合并至此目录

审计追溯链

Prompt 日志 ←→ Session 日志 ←→ 变更审计记录
(用户说了什么)   (AI 做了什么)   (正式变更文档)

通过 Prompt-ID 和 Session-ID 可在三者之间双向追溯。详见 SESSION-LOG-GUIDE.md。