31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# 审计目录（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)。
|