Machine Genome 是一个用 Go 实现的开放身份与来源（provenance）协议及参考实现，面向模型、AI Agent、数据集、工具链、运行框架和相关产物建立可验证的“基因”标识。它通过内容寻址、JCS 规范化 JSON、SHA-256 multihash、W3C Data Integrity 签名、DID 身份、追加式修订和 Merkle 日志，为 AI 组件提供可审计、不可篡改的谱系记录。仓库包含协议规范、Go 库、CLI、本地/生产注册表服务、HTTP API、Explorer 界面、JSON Schema、OpenAPI 文档和运维部署材料。当前协议标注为 experimental，适合做技术验证、供应链溯源、AI 资产登记和治理基础设施探索。
适用领域
AI 模型与 Agent 身份标识 / AI 供应链安全 / 模型与数据集溯源 / DID 去中心化身份 / 密码学签名与可验证声明 / Merkle Log 与透明日志 / 软件/模型资产治理 / 注册表服务与审计系统 / Go 后端基础设施 / AI 合规与可信 AI
配置难度
中高。基础 CLI 使用相对简单，Go 开发者可以较快完成构建、签名和验证流程；但如果要理解协议语义、DID、JCS、Data Integrity、Merkle 日志、namespace 控制、注册表生产部署和安全边界，需要较强的后端、安全和 MLOps 背景。用于生产环境或合规系统时难度较高。
商业价值
对中国开发者和企业而言，该项目的价值主要在于为 AI 资产建立可验证的身份、来源和演进记录。随着企业内部模型、开源模型、微调模型、Agent、Prompt、工具调用和数据集数量快速增长，传统名称和版本号不足以支撑审计、追责和供应链安全。Machine Genome 可作为企业 AI 资产注册表、模型治理平台、AI 合规审计系统或 LLMOps 平台的底层 provenance 协议参考。它不直接解决模型能力评估或法律授权问题，但能提供一套标准化、可签名、可审计、可扩展的证据层，适合用于可信 AI 基础设施、金融/政企/医疗等高审计要求场景的技术预研和内部平台建设。
01
技术亮点
- 提供从协议规范到 Go 实现、CLI、注册表、Explorer、OpenAPI 的完整参考实现
- 采用内容寻址 Gene，基于 secured canonical genesis record 的 SHA-256 multihash
- 使用严格 JSON、JCS 规范化和 W3C eddsa-jcs-2022 Data Integrity proof
- 支持 Ed25519 did:key 离线解析，无需依赖特定区块链或专有 DID 解析器
- 明确区分 authorized、operator-observed、unresolved 等不同语义的 lineage parent edges
- 通过追加式 amendments 和第三方 attestations 保留历史，不重写 genesis
- 注册表提供 ACID 存储、验证准入、DNS namespace 控制、Merkle log、审计链、检查点和 tombstone
- HTTP 层不能绕过 registry.Store.Submit 的共享验证边界，架构上重视可信边界
- 包含 JSON Schema、OpenAPI 3.1、conformance vectors 和协议审计文档，便于集成和测试
- 提供生产运维资料，包括 systemd、nginx/Cloudflare、容器、备份、恢复和监控资产
- Apache-2.0 许可证对商业使用友好
- README 对安全边界有明确声明，避免将签名记录误解为能力、意识、所有权或法律状态证明
02
目标用户
- AI 平台工程师
- MLOps/LLMOps 团队
- 模型注册表或模型治理平台开发者
- Agent 框架和工具链开发者
- 数据集与模型发布方
- AI 安全与合规团队
- 需要追踪模型、Prompt、工具、数据来源的企业研发团队
- 研究 AI provenance、可信 AI、透明日志的开发者
- 希望构建私有 AI 资产注册中心的后端工程师
03
配置要求
- Go 1.24+
- GNU Make
- jq
- OpenSSL，用于生成注册表管理员 token
- Linux/macOS 或兼容 Go 构建环境
- 生产环境建议配置 systemd、nginx 或 Cloudflare、备份、恢复和监控
- 注册表需要 checkpoint signing key
- 注册表管理接口需要 admin token 文件
- DNS namespace 首次提交 genesis 前需要完成 registry 的 dns-01 controller challenge
- DID namespace 需要 namespace 等于签名控制者 DID
- 开发环境可使用 --allow-unverified-namespaces，但不建议在生产环境启用
- 私钥文件权限应保持 0600，不能提交到 Git 仓库
- 生产部署前应阅读 architecture、threat model、registry operations 和 deployment 文档
04
适用场景
- 为模型、Agent、数据集或工具链生成稳定的 Gene 标识
- 记录某个 Agent 使用了哪些模型权重、Prompt、工具、数据集和运行策略
- 验证 AI 组件的 genesis record 是否被指定 DID 控制者签名
- 搭建企业内部 AI 资产注册表，登记模型和 Agent 的来源信息
- 追踪模型或 Agent 的版本演进、修订记录和第三方证明
- 通过 Merkle 日志、检查点和一致性证明实现注册表透明审计
- 构建 AI 供应链安全系统，降低伪造模型、来源不明数据集、不可追溯组件的风险
- 作为模型治理、AI 合规、审计取证系统的底层协议组件
- 在 CI/CD 或 MLOps 流水线中自动签名、验证和发布 AI 组件记录
- 基于 OpenAPI 将 provenance 查询能力集成到现有平台
05
部署与配置
- 安装 Go 1.24 或更新版本、GNU Make 和 jq。
- 克隆仓库：git clone https://github.com/paxlabs-inc/machine-genome.git
- 进入项目目录：cd machine-genome
- 执行检查和构建：make check build
- 生成控制者私钥：bin/mgs keygen --out controller.key.json
- 初始化 genesis 记录：bin/mgs init-genesis --key controller.key.json --name cody --namespace example.org --subject-type agent --version 1.0.0 --out genesis.unsigned.json
- 签名 genesis 记录：bin/mgs sign --in genesis.unsigned.json --key controller.key.json --out genesis.json
- 验证记录：bin/mgs verify --in genesis.json
- 生成 Gene：bin/mgs gene --in genesis.json
- 如需运行本地注册表，先生成 checkpoint key：bin/mgs keygen --out registry-checkpoint.key.json
- 生成管理员 token：umask 077 && openssl rand -hex 32 > admin.token
- 启动本地注册表：bin/mgs registry-serve --data-dir ./registry-data --checkpoint-key registry-checkpoint.key.json --admin-token-file admin.token --listen 127.0.0.1:8080 --public-base-url http://127.0.0.1:8080
- 浏览器打开 http://127.0.0.1:8080 查看本地 Explorer。
06
风险与注意事项
- 协议仍处于 experimental 阶段，未来可能出现不兼容变更，不适合直接作为强依赖标准。
- 记录只能证明谁签署了什么字节，不能证明模型能力、训练合法性、知识产权归属、供应商背书或合规状态。
- 当前 profile 主要支持 Ed25519 did:key 离线解析，DID 方法和身份生态支持范围有限。
- 密码学审计、隐私审计、独立 witness、checkpoint gossip、federation 和中立标准治理仍在路线图中。
- 对团队的密码学、DID、透明日志、供应链安全理解要求较高，误用可能导致错误信任结论。
- DNS namespace challenge、key 管理、注册表 token、备份恢复等生产运维复杂度不可忽视。
- 如果私钥泄露或 namespace 控制权被攻击，可能导致伪造或污染记录。
- AI provenance 本身依赖提交者诚实声明，无法自动验证外部模型、数据集或 artifact 的真实性和授权。
- 星标数量中等，生态成熟度和第三方工具集成仍需观察。
- 如果用于企业合规场景，需要额外结合内部审批、合同、许可证扫描、数据治理和法律审查。
2026-07-26
第30名
新收录 · github_search
2026-07-23
第27名
新收录 · github_search
2026-07-22
第28名
新收录 · github_search
