🇪🇺 面向 AI 合规的开源证据工具包
开放证据格式 • 本地偏见评估 • Schema 校验 • CycloneDX 互操作性
离线优先 • 隐私保护 • 可复用产物 • 符合 WCAG 2.2 AA 无障碍标准
EuConform 定义了一种面向 AI 合规的开放证据格式,并提供用于生成、校验和实证评估该格式的工具——离线且不依赖特定供应商。
[!IMPORTANT] 法律免责声明:本工具仅提供技术指导。它不构成法律建议,也不替代公告机构作出的具有法律约束力的合规性评估或专业法律咨询。请务必就合规决策咨询合格的法律专业人士。
| 功能 | 描述 |
|---|---|
| 🧾 开放证据格式 | 生成可移植的 report、aibom、ci 和 bundle 产物,以可检查的 JSON 文档形式呈现 |
| 🧪 本地偏见评估 | 基于 CrowS-Pairs 的模型评估,使用真实句子对数概率——可复现、离线、不依赖供应商 |
| ✅ Schema 校验 | 使用 euconform validate 依据已发布的 schema 校验 EuConform JSON 文档 |
| 📦 Bundle 验证 | 在将产物交给 CI、审查者或审计人员之前,验证 manifest、目录或 ZIP bundle 的完整性 |
| 🚦 合规 CI 门禁 | 将 euconform scan 转化为 GitHub 原生注解、CI 摘要和机器可读产物 |
| 🎯 风险分类 | 交互式测验,实现欧盟《人工智能法案》第 5 条(禁止类)、第 6 条 + 附件 III(高风险类) |
| 🔄 CycloneDX 互操作性 | 将外部 CycloneDX SBOM 导入 EuConform AI BOM 层,作为互操作性桥梁 |
| 🌐 离线优先 | 核心证据工作流保持本地化和可检查,而不依赖供应商仪表盘 |
| 🔒 隐私保护 | 零跟踪、无 Cookie、无外部字体——你的数据始终由你掌控 |
| 🌙 深色模式 | 精美的玻璃拟态设计,完整支持深色模式 |
| ♿ 无障碍 | 符合 WCAG 2.2 AA 标准,支持完整键盘导航 |
| 🌍 多语言 | 英语和德语界面 |
| 命令 | 主要输出 | 使用场景 |
|---|---|---|
scan | 原生 EuConform 产物 | 从真实仓库生成结构化证据 |
bias | 偏差报告 JSON 和/或 Markdown | 通过 transformers.js 运行可复现的本地模型评估——EuConform 独特的实证层 |
compare | 比较 JSON 和/或 Markdown | 比较两次偏差运行:分数/偏好差异、各偏差类型的变化、McNemar 显著性 |
validate | 每个 JSON 文件的有效/无效状态 | 根据已发布的 schema 检查 EuConform JSON 文件 |
verify | 包完整性状态 | 检查清单、提取的包或 ZIP 归档 |
import | euconform.aibom.json | 将外部 CycloneDX SBOM 映射到 EuConform AI BOM 层 |
paired-eval | 提示集 + 分数(JSONL)、分析报告 | 预注册的配对决策评估(实验性):模型是否因正确的原因而正确? |
想在不安装的情况下试用? 点击上方的 🌐 部署 链接,在 Vercel 上启动你自己的实例。
# Clone the repository
git clone https://github.com/Hiepler/EuConform.git
cd EuConform
# Install dependencies
pnpm install
# Start development server
pnpm dev
# Open http://localhost:3001
下面的仓库内示例直接使用构建好的 CLI:
# Build the CLI
pnpm --filter @euconform/cli build
从真实代码库生成原生 EuConform 产物:
node packages/cli/dist/index.js scan . --scope production
这会写入:
.euconform/euconform.report.json.euconform/euconform.aibom.json.euconform/euconform.summary.md.euconform/euconform.bundle.json典型用途:
用于 CI 时,添加 GitHub 原生注解和失败阈值:
node packages/cli/dist/index.js scan . --scope production --ci github --fail-on high
要交换可移植的产物,请创建一个 bundle 归档文件:
node packages/cli/dist/index.js scan . --scope production --zip true
根据已发布的 schema 验证单个 EuConform JSON 文档:
node packages/cli/dist/index.js validate .euconform
典型输出:
euconform.aibom.json — valid (euconform.aibom.v1)0,schema 错误为 1,未找到 EuConform JSON 文件时为 2验证 bundle 清单、解压后的 bundle 目录或 ZIP 归档:
node packages/cli/dist/index.js verify .euconform/euconform.bundle.json
典型用法:
针对 Hugging Face 模型运行可复现的 CrowS-Pairs 偏差评估, 通过 transformers.js 在本地进行测量(这是唯一受支持的测量引擎—— 见下方说明):
node packages/cli/dist/index.js bias onnx-community/Llama-3.2-1B-Instruct --lang de --output all
这是 EuConform 独有的实证证据层。它生成其他开源合规工具目前都无法提供的模型行为数据——完全离线、可复现,且不依赖任何厂商 API。
生成的 euconform.bias.json 可以在 Web 应用(/bias)中查看:在那里会以相同的统计量重新计算方式进行验证,并可与第二次运行结果进行对比。
典型用途:
scan 提供的结构性证据之上叠加行为证据层将基线测量结果与候选结果进行比较(同一模型更新后,或同一目录上的不同模型):
node packages/cli/dist/index.js compare \
./.euconform-baseline/ \
./.euconform-candidate/ \
--output all --out-dir ./comparison
compare 接受产物文件(euconform.bias.json)或偏置运行写入该文件的目录,并报告:
当两个产物未以相同的测量设置回答同一问题时(不同的目录、评分方法或模板策略),比较将拒绝运行。不同模型、dtype 或库版本属于预期情况,会作为环境差异列出。--allow-incomparable 仍会写出报告,并明确标记 comparable: false。
将外部 CycloneDX JSON 文件映射到 EuConform AI BOM 层:
node packages/cli/dist/index.js import ./third-party.cdx.json \
--scope production \
--output /tmp/euconform-import
node packages/cli/dist/index.js validate /tmp/euconform-import/euconform.aibom.json
这会写入:
/tmp/euconform-import/euconform.aibom.json重要说明:
import 接受 CycloneDX JSON,并仅将 AI 相关子集映射到 euconform.aibom.v1.1--scope production 会排除 optional 和 excluded 组件如果你想以 OSS 构建者的身份评估当前的采用路径,请使用
examples/ 中的一个参考项目:
# 1. Build the CLI
pnpm --filter @euconform/cli build
# 2. Scan a reference project
node packages/cli/dist/index.js scan examples/ollama-chatbot \
--scope production \
--output /tmp/euconform-ollama
# 3. Verify the generated bundle
node packages/cli/dist/index.js verify /tmp/euconform-ollama/euconform.bundle.json
# 4. Open the web app and import the generated artifacts
pnpm dev
对于检索优先的示例,请将 examples/ollama-chatbot 替换为
examples/rag-assistant。
偏差测量完全通过 transformers.js 在本地运行,
它会加载 Hugging Face 模型(例如 onnx-community/Llama-3.2-1B-Instruct、
Xenova/distilgpt2)并计算真实的句子对数概率。Ollama 不是偏差测量引擎:它的 logprobs 字段仅覆盖
已生成的 token,从不覆盖被评分的提示/句子,因此它在这里从未测量过任何真实内容——bias --engine ollama 会在尝试任何网络访问之前
以该解释被拒绝。
[!WARNING] Vercel / 云部署:此功能需要在本地运行 EuConform(
pnpm dev)。
[!NOTE] 主要法律来源:Regulation (EU) 2024/1689 (EU AI Act)
工具覆盖范围: