变更摘要

本 PR 新增安全审计日志框架 foundation/openjiuwen_runtime/foundation/audit/ 包，实现 SRS FR1（schema 驱动的日志格式、合规校验门、NTP 时钟同步）并为其后续 FR2–FR8（脱敏、异步输出、存储、外送、访问控制、配置下发、打点）提供配置骨架与接口占位。核心包括：AuditLogSchema（头部 HeaderSchema + 内容 ContentSchema）、validate_schema 合规校验门、SyncedClock NTP 同步时钟、format_audit_line/parse_audit_line 格式化与解析、AuditLogConfig 配置聚合及 AuditFacade 打点门面，并随附三份单元测试（test_audit_clock.py、test_audit_formatter.py、test_audit_schema.py）。

主要改动

• Schema 定义与默认常量: 新增 schema.py 与 constants.py，定义 11 字段头部（DEFAULT_HEADER_FIELDS，| 分隔、- 占位）与内容层（#UA:/#EVT: 关键字、|@| 要素分隔、= KV 分隔、replace/escape 两种转义模式），并声明不可削弱的红线字段 DEFAULT_REDLINE_FIELDS 与 RSPCD 码表 RSPCD_KNOWN。
• 合规校验门: 新增 validator.py 的 validate_schema，在自定义 schema 生效前强制校验 semver 版本、红线字段齐全、timestamp 保留、占位符/分隔符/转义模式声明、NTP 配置合法性及 command_force_redact 不被关闭，不通过则抛 SchemaValidationError，并拒绝占位符形式的 NTP 地址。
• NTP 同步时钟: 新增 clock.py 的 SyncedClock/UdpNtpClient/SequenceNtpClient，实现启动同步与周期同步，时间源由配置注入（禁止硬编码），全部源不可达时降级本地时钟不阻断调用方，主源 failover 或偏差超阈值时产生 ClockEvent 事件。
• 日志行格式化与解析: 新增 formatter.py 的 format_audit_line/parse_audit_line，自动补全头部 pid/tid/caller/时间戳，required 字段缺失时占位、校验 RSPCD 格式与 caller 行号，沙箱要素（ACTION/SANDBOXID/RESULT）转入 EXT（x_ 前缀），format_clock_event 将 NTP 事件落成 #EVT 管道行。
• 配置聚合与未实现接口占位: 新增 config.py 的 AuditLogConfig/default_config 聚合 format/ntp/identity/redaction 等子配置并在加载时过校验门；writer.py/storage.py/shipper.py/access.py/deploy.py/redaction.py/linkpoint.py 及 facade.py 的 log_audit 仅提供接口骨架，明确以 AuditNotImplementedError 拒绝假装落盘。

🤖 AI 代码检视正在进行中，请稍候…

欢迎来到 openJiuwen 社区

Hey @seanzhang_cn , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用，可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

AtomGit AI 助手使用指南

在 PR 评论中使用命令即可触发。支持在普通评论和代码行评论中使用。

免责声明

AI 助手可能存在误判，请结合自身判断。可以对评论点 👍 或 👎 帮助我们改进。

CLA 签署成功

seanzhang_cn, 感谢您的代码贡献。 所有的代码贡献者都已完成了 CLA 签署。 👍

ci-pipeline