AI 决策治理与绑定边界控制平面，通过 fail-closed 管道和哈希链审计确保受监管环境下的 AI 决策可追溯、可问责。
VERITAS OS 是一套面向 AI Agent 的决策治理与绑定边界控制平面，专为金融（AML/KYC）、医疗等强监管场景设计。项目当前版本为 v2.0.0（Beta），由 Takeshi Fujishita 开发维护。
核心能力#
决策治理管道#
构建了端到端的 /v1/decide 治理管道，AI 决策在执行前经过可复现、fail-closed、哈希链式治理流程：编排 → 门控 → 持久化 → 回放。引入默认 fail-closed 的 FUJI Gate 安全门控机制，确保非安全或未定义路径下的决策被直接拒绝。
绑定边界控制（Bind-Boundary Control）#
创新性地将治理谱系从"决策审批"延伸至"执行承诺"阶段，分离审批与执行。已在策略更新、策略包晋升、运行时合规配置变更三条操作员管控路径上接线。输出 BindReceipt（完整治理工件）与 bind_summary（紧凑绑定摘要）。
TrustLog 审计日志#
防篡改的哈希链式决策谱系日志，支持签名与哈希链接治理工件，具备分歧感知回放能力。生产环境推荐 PostgreSQL 后端，开发环境支持 JSONL 轻量后端。
运行时姿态控制#
通过 VERITAS_POSTURE（dev / staging / secure / prod）单一变量控制所有安全默认值。prod 姿态下所有治理控制强制开启，覆盖变量被忽略，并强制要求外部密钥管理器（Vault/KMS）。
合规导出#
提供合规导出路径与 veritas-evidence-bundle CLI 证据包打包工具，支持外部审计就绪文档生成。
典型应用场景#
- AML/KYC 合规审查：提供 1 天 PoC 快速入门包与金融治理模板
- 强监管行业 AI 部署：为金融、医疗等提供审批边界与事后审查证据捕获路径
- AI 决策审计与问责：TrustLog 创建审计级决策谱系，支持事后事件审查
- 安全运维：生产姿态强制外部密钥管理、透明日志锚定，减少宽松错误配置
架构概览#
- 后端：Python 3.11+ / FastAPI + Uvicorn + Pydantic 异步架构
- 前端：Next.js 16 构建的 Mission Control 操作员治理面板
- 存储：PostgreSQL（生产，配合 Alembic 迁移）/ JSON / JSONL（开发）
- LLM 集成：OpenAI 为默认，可选安装 Anthropic 额外依赖
- 可观测性：通过
observabilityextra 集成 OpenTelemetry + Prometheus - 签名能力：通过
signingextra 集成 cryptography 库 - CI/CD：GitHub Actions（main、CodeQL、Release Gate、Docker Publish to GHCR）
- 测试覆盖率：自报 87%
- 容器镜像：
ghcr.io/veritasfuji-japan/veritas__os
安装与部署#
前置依赖：Docker 20+、Docker Compose v2；本地开发需 Python 3.11+、Node.js 20+、pnpm。
Docker Compose（推荐）：
git clone https://github.com/veritasfuji-japan/veritas_os.git
cd veritas_os
cp .env.example .env
docker compose up --build
启动后：后端 API localhost:8000（Swagger UI: /docs）、前端 Mission Control localhost:3000、PostgreSQL localhost:5432。
pip 安装（本地开发）：
pip install . # 核心
pip install ".[ml]" # + sentence-transformers / scikit-learn
pip install ".[full]" # 全部依赖
API 与 CLI#
核心 API 端点：
PUT /v1/governance/policy— 策略更新（已绑定治理）POST /v1/governance/policy-bundles/promote— 策略包晋升（已绑定治理）PUT /v1/compliance/config— 合规配置变更（已绑定治理）GET /v1/governance/bind-receipts— 绑定收据列表GET /v1/governance/bind-receipts/{id}— 绑定收据详情GET /v1/governance/bind-receipts/export— 导出绑定收据
CLI 工具：veritas-trustlog-verify（验证 TrustLog 完整性）、veritas-migrate（数据库迁移）、veritas-evidence-bundle（生成合规证据包）。
待确认事项#
- 未发现公开的第三方生产部署案例或用户证言
- 未发现已完成的第三方安全审计报告
- Zenodo 论文为预印本平台发布，同行评审状态未确认
- Core 采用专有 EULA（Evaluation Use 免费，Commercial Use 需书面协议），部分目录采用 MIT，具体目录边界需逐一核查
VERITAS_API_KEY/VERITAS_API_SECRET的签发方式未在 README 中明确说明- 商业许可定价无公开信息，需联系 veritas.fuji@gmail.com