# 审计目录（docs/audit/）

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

## 子目录与文件

| 目录/文件 | 说明 |
|-----------|------|
| `changes/` | AI 逐次变更审计记录（`<YYYY-MM-DD>__<slug>.md`） |
| `prompt_logs/` | Prompt 日志文件（每次 prompt 生成一个独立文件，按时间戳命名） |
| `session_logs/` | 全量会话记录（按 `YYYY-MM/DD/` 分层），含双索引和 LLM 操作摘要。详见 [`SESSION-LOG-GUIDE.md`](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`](SESSION-LOG-GUIDE.md)。