AI 使用留痕与审计

围绕《人工智能生成合成内容标识办法》（2025-09-01 施行）第九条、第十二条的日志留存义务，提供 AI 生成服务使用日志的完整闭环：留痕 → 追溯 → 体检 → 报告。

核心法规依据

第九条：用户申请提供无显式标识的生成合成内容时，服务提供者须「依法留存提供对象信息等相关日志不少于六个月」。
第十二条：履行算法备案、安全评估手续时，须提供标识相关材料并加强信息共享——留痕是备案的必需底稿。

本技能只做「使用留痕与审计」，不负责给内容加显式/隐式标识。标识写入见 aigc-metadata-embed，标识合规检查见 aigc-label-check。

使用方式

主脚本为 scripts/usage_log.py，纯标准库，零第三方依赖。四个子命令：

1. record —— 记录一条使用日志

python3 scripts/usage_log.py record <日志文件.jsonl> \
  --provider "服务方名称" \
  --target "对象标识（可脱敏）" \
  --content-type text|image|audio|video|other \
  --no-label \
  --time "2026-09-12T08:00:00Z" \
  --summary "内容摘要"

--no-label 表示本次申请了无显式标识的生成内容（第九条重点留存对象）。
--time 缺省为当前 UTC 时间。
必填字段缺失会被拒绝写入并提示。

2. query —— 检索追溯

python3 scripts/usage_log.py query <日志文件.jsonl> \
  --provider "服务方" --target "对象" \
  --content-type text \
  --no-label 1 \
  --since "2026-09-01" --until "2026-09-30" \
  --grep "关键词"

支持按服务方、对象、内容类型、是否无标识、时间范围、全文子串过滤。

3. audit —— 自动体检

python3 scripts/usage_log.py audit <日志文件.jsonl>

体检项：必填要素缺失、损坏行、接近 6 个月留存期的记录（需归档提醒），并单独统计「申请无标识但缺时间/对象信息」的记录数（第九条核心）。

4. report —— 生成审计报告

python3 scripts/usage_log.py report <日志文件.jsonl>            # Markdown 到 stdout
python3 scripts/usage_log.py report <日志文件.jsonl> --format json -o report.json

输出概览（总数、无标识申请数、问题数）、内容类型/服务方分布、问题清单。

日志格式

JSONL，每行一条。核心字段：

| 字段 | 必填 | 含义 | |---|---|---| | provider | 是 | 服务提供者名称 | | target | 是 | 提供对象标识（可脱敏） | | time | 是 | 使用时间（ISO 8601） | | content_type | 是 | 内容类型 text/image/audio/video/other | | no_label | 是 | 是否申请无显式标识（bool） | | summary | 否 | 内容摘要 |

能力边界

只做日志记录与审计，不自动抓取平台数据、不联网。
输出为自检与备案材料准备的底稿，不构成法律意见。
不提供删除/篡改标识的能力（《标识办法》第十条明文禁止）。

详见 references/usage-guide.md（操作手册）与 references/retention-rules.md（法规参数与字段规范）。