Compliance AIops

合规 AIops

免责声明：这是由社区维护的开源项目。与任何框架机构或 GRC 供应商均无关联，也未获其认可或赞助。 HIPAA、PCI-DSS、SOC 2、GDPR 和 OSCAL 均为描述性引用；相关框架和商标归其所有者所有。本项目采用 MIT 许可证。

面向 AI Agent 基础设施运维的受治理合规证据工具。它会读取受治理 AIops Agent 已写入的审计轨迹——即本地的 ~/.<tool>-aiops/audit.db SQLite 轨迹，它们都使用同一个 audit_log 架构——并将这些活动转换为映射到框架、经哈希链封存的合规证据。它绝不会扫描你的基础设施，也不会取代 GRC 平台：它会将你已生成的轨迹转换为可供审计人员使用、防篡改的证据包。

与 AIops-tools 系列中的其他工具不同，它不是平台封装器：没有外部 API、没有网络、没有平台凭据。它唯一的输入是这些磁盘上的审计数据库，且以只读方式读取。因此，它也是该系列中最容易进行自测的工具——完全离线且具确定性。

证据，而非认证。 完全离线；源 audit.db 文件仍是系统记录的权威来源。OSCAL 导出是文档中记录的 v0.2 路线图项目（v0.1 会生成 JSON + Markdown + CSV，其结构旨在便于未来适配 OSCAL Assessment-Results）。

主要功能

• 诚实标注证据强度的框架映射——审计事件会映射到 HIPAA §164.312 / PCI-DSS v4.0 / SOC 2 TSC / GDPR 控制项。审计轨迹能有力证明运行有效性，但对控制设计 / 配置只能提供部分证明；每个控制项均标记为 strong 或 partial。gap_analysis 会针对每个控制项说明这一点，并附上注意事项和修复建议。
• 经哈希链封存的证据包——对有序记录计算 SHA-256（hash = SHA-256(prev_hash ‖ canonical_json(record))，初始 prev 为 64 个零）。对于相同的（框架、周期、来源），chainHead 可复现。verify_bundle 可检测篡改；verify_source_chain 可检测源轨迹中的行 ID 间断 / 删除。还可选用 HMAC 签名，使用已存储的签名密钥封存证据包。
• 零网络、只读——无需凭据，不进行出站调用，也不修改源轨迹。唯一写入的内容是证据包，存放于 ~/.compliance-aiops/bundles/ 下。
• 确定性且经测试验证的完整性——完整性声明本身也经过测试：通过真实的治理框架 AuditEngine 构建合成审计数据库，断言黄金标准的可复现 chainHead，并通过篡改测试确认能够检测到篡改。无需连接运行中的基础设施。

此工具会做什么，以及不会决定什么

它会读取你的审计轨迹并写入证据包，同时记录每项操作。它不会决定是否允许生成或签署证据包：这取决于 Agent 的判断，或其运行账户的文件系统权限。无论如何，源 audit.db 文件都只会以严格只读方式打开，唯一会写入的内容是 ~/.compliance-aiops/bundles/ 下的证据包。

因此，无需配置只读开关、策略文件或审批关卡。此工具保证的一点是，任何操作都不会悄无声息：每次调用，无论通过 MCP 还是命令行，都会在 ~/.compliance-aiops/audit.db 中写入一条审计记录。

每个工具都会声明一个 risk_level，测试会确保其与 [READ] / [WRITE] 文档标签一致，并将其作为描述性等级写入审计记录——审核人员可以一眼看出记录对应的操作。它只是一个标签，不是关卡。

工具（16 个 MCP 工具）

读取 / 分析（13）

工具	用途
list_audit_sources	发现的同级审计数据库（路径、工具、是否可读、行数）
query_audit_events	跨工具事件查询——按工具/技能/状态/风险/是否已批准/选择器/起始时间/结束时间筛选
activity_timeline	按小时或天分桶统计事件数量
list_frameworks	支持的框架及控制项数量
coverage_summary	单个框架中各控制项的已覆盖/覆盖较弱/未覆盖情况
control_evidence	单个控制项的证据行、总体数量及可复现查询
gap_analysis	没有证据或证据较弱的控制项 + 如实说明的局限 + 补救措施
approval_report	高风险写入操作 + 批准人 + 理由（CC8.1 / PCI 7-8 / HIPAA §312(a) 所需材料）
exceptions_report	被拒绝/出错/超出预算的操作——执行情况 + 异常证据
verify_source_chain	一个来源的链头 + 行 ID 间隔检测
verify_bundle	验证已封存的包：链、封存头及可选签名
list_bundles	~/.compliance-aiops/bundles/ 下的包
oscal_assessment_results	将已封存的包作为 NIST OSCAL 1.2.3 评估结果文档内联提供，并明确列出其局限
bundle_schedule_hint	可直接粘贴的 cron 行 + 用于定期封存的非交互式命令（不写入任何内容）

写入 / 生成材料（3 — 不会修改外部内容）

工具	风险	用途
generate_evidence_bundle	低	一次调用：覆盖情况 + 审批记录 + 异常 + 已封存记录 → 生成一个 .json 包
export_bundle	低	将包导出为 Markdown / CSV / JSON / OSCAL
sign_bundle	中	使用存储的签名密钥对封存内容进行 HMAC 签名

CLI 提供一组便捷子集；完整的 19 个工具均可通过 MCP 使用。

框架与控制项

框架	控制项示例（强度）
HIPAA（§164.312）	164.312(b) 审计控制（强），164.312(a)(1) 访问控制（强），164.312(c)(1) 完整性（强）
PCI-DSS v4.0	10.2 审计日志内容（强），10.3 保护审计日志（强），7-8 最小权限 / 身份验证（部分）
SOC 2 TSC	CC6.1 逻辑访问（强），CC7.2 监控（强），CC8.1 变更管理（强）
GDPR	第 30 条 处理活动记录（部分），第 32 条 处理安全（强）
ISO/IEC 27001:2022（附录 A）	A.5.15 访问控制（强），A.5.16 身份管理（强），A.5.18 访问权限（部分），A.8.2 特权访问（部分），A.8.15 日志记录（强），A.8.16 监控（强），A.8.32 变更管理（强）
等保 2.0（DJCP L3）（GB/T 22239-2019 三级）	8.1.5.4 安全审计（强），8.1.4.2 访问控制（部分），8.1.5 安全管理中心/集中审计（强）

安装

uv tool install compliance-aiops      # or: pipx install compliance-aiops

快速开始

作为 Claude Code 插件

安装一次，即可同时为 Agent 提供技能和 MCP 服务：

/plugin marketplace add AIops-tools/marketplace
/plugin install compliance-aiops@aiops-tools

MCP 服务通过 uv 获取，并固定到此插件声明的包版本，因此可以将审计记录追溯到写入它的代码。凭据仍需使用 compliance-aiops init 配置——请参阅下文。

作为 OpenClaw 插件

同一套程序包也发布在 ClawHub，安装一次即可同时获取技能和 MCP 服务：

openclaw plugins install clawhub:@zw008/compliance-aiops
openclaw skills info compliance-aiops          # expect: Visible to model: yes

之后重启 OpenClaw 网关，使其加载插件。MCP 服务通过 uv 获取，并固定到此精确版本，因此 uvx 必须位于 PATH 中——若没有，技能仍会安装，但会报告 Visible to model: no。凭据按下文说明进行配置。

作为 CLI 或独立 MCP 服务

compliance-aiops init                 # discover sibling ~/.*-aiops/audit.db, set org name, optional signing key
compliance-aiops doctor               # which sibling audit DBs are present/readable
compliance-aiops overview             # audit sources + per-framework covered/total
compliance-aiops report coverage soc2 # per-control SOC 2 coverage
compliance-aiops bundle generate soc2 # sealed evidence bundle → ~/.compliance-aiops/bundles/
compliance-aiops bundle verify <path> # re-verify the chain + seal (+ signature)

作为 MCP 服务运行（stdio）：

export COMPLIANCE_AIOPS_MASTER_PASSWORD=...   # only needed to unlock a signing key
compliance-aiops mcp                          # or: compliance-aiops-mcp

密码之后会存放在哪里：导出的变量可被此 shell 启动的所有进程读取，也会记录在 shell 历史中。在共享或长期运行的主机上，建议使用交互式提示，或通过密钥管理器将密码注入需要它的单个命令的运行环境。

定期封存（计划任务）

证据包按周期（例如每周）封存最有用，这样每个周期都有防篡改锚点。此工具不附带守护进程——bundle schedule 会打印一行可直接粘贴的 cron 配置，以及确切的非交互式命令，不会写入任何内容：

compliance-aiops bundle schedule soc2 --cron "0 2 * * 1" --period 7d --sign

它会返回一个 cronLine，供你粘贴到 crontab -e 中，例如：

0 2 * * 1 compliance-aiops bundle generate soc2 --period 7d --sign

• --period（bundle generate 也支持）是一个便捷的相对时间窗口——7d、24h、2w 或 last-7-days——会解析为一组以“现在”为结束时间的起始/结束时间，因此每次计划运行都会封存最近一个时间窗口。
• 在cron 任务的环境变量中导出 COMPLIANCE_AIOPS_MASTER_PASSWORD，这样存储的签名密钥就能以非交互方式解锁。不要将真实密码直接写入 crontab 文件——请从受保护的环境变量文件中引用它。

完整性与诚实的局限

• 防篡改检测，而非防篡改。 哈希链和可选签名可让审计员检测篡改，但无法阻止篡改。源 audit.db 文件仍是记录系统；如果需要独立锚点，请通过其他渠道记录 chainHead。
• 运行有效性与设计有效性。 审计跟踪能有力证明某项控制已运行（样本、审批、拒绝），但只能部分证明某项控制的设计/配置正确（例如要求启用 MFA、角色遵循最小权限原则）。每项控制都会标记为 strong 或 partial，gap_analysis 会明确说明这一局限，而不会夸大其效果。

支持范围与限制

• 提供证据，不提供认证。 此工具会生成可供审计员使用的证据包，但不会出具鉴证、意见或认证。
• 范围内： 上述六种框架，以及由通过 ~/.*-aiops/audit.db 发现的 AIops 工具写入的 audit_log 跟踪记录。
• 范围外： 此工具不会扫描基础设施、连接任何平台，也不会取代 GRC 平台。平台运维请使用其他 AIops-tools。
• OSCAL 导出为 v0.2。 v0.1 会生成 JSON、Markdown 和 CSV。
• v1.0 发布前，接口可能会变更。
• 验证： 完整性声明由确定性的离线测试覆盖；可查看 docs/VERIFICATION.md 了解可复现的运行步骤。

缺少某项功能？

想要添加其他框架、控制映射、导出格式（OSCAL、CSV 格式），或这里未提及的验证方式？欢迎提交 issue 或 PR，贡献代码！