therandomsecurityguy/signet
AI 工程面向自主 Agent 与技能治理的图优先注册中心,对每个版本做语义校验、签名认证和透明日志记录。
项目介绍
Signet 是一个面向自主 Agent 和计算技能的语义治理注册中心。它不只做元数据目录,而是把持久的 AGENT/SKILL 身份与不可变的版本快照分开,让每个版本沿生命周期流转:draft → validated → published → certified,并支持 rejected、deprecated、revoked、archived 等终态。这样人和 AI Agent 都能先发现能力、加载真实产物、查清来源,再决定是否使用通过策略检查的版本。
校验分五层:W3C SHACL 图结构校验、能力声明的本体校验、非阻塞的 LLM 语义分析,以及人工审核。发布信封会分别按 RFC 8785 规范化 JSON、按 RDFC-1.0 规范化 RDF,然后用分离签名对可信密钥验签。每次生命周期操作都会生成一条治理事件,写入只追加的 Merkle 日志并生成包含证明,也可以锚定到外部 Tessera 透明日志,配合 checkpoint 与见证人机制。来源信息用 PROV-O 建模,可以重放和本地验证。
它主要面向需要管理内部 Agent 文件、技能和操作手册不断增多的平台与安全工程师,让信任变成可机器核验的规则而不是口头约定。
快速使用
最快的本地路径需要 Node.js 22,不需要 Docker、AWS 或 Kubernetes:
for d in service/api service/mcp service/webapp/knowledge-manager client/registry-cli; do
(cd "$d" && npm ci)
done
scripts/demo-local.sh demo
该命令用本地 JSON 文件和文件系统后端启动三个服务并写入演示数据。随后检查各服务是否就绪:
curl -s http://localhost:3000/healthz
curl -s http://localhost:3100/healthz
curl -s http://localhost:3200/healthz
MCP 网关在 3000 端口、API 在 3100 端口、Web 控制台在 3200 端口。有一段 65 秒的录制演示,展示注册 SHACL 策略、草稿按策略消息被拒、以及 registry-operator verify publication 返回 verdict: verified 录制演示。逐步流程见 本地演示文档;Docker Compose 和本地 kind 变体同样不依赖 AWS。
使用约束
- 运行环境: 需要 Node.js 22。快速路径默认用
json_file图后端和文件系统 CAS;Fuseki/SPARQL 是可选后端,供需要查看实时图的运维人员使用。 - 引导顺序: 必须先写入技能,再写入引用这些技能的 Agent;生命周期引导应走技能生命周期端点,而不是只用
POST /v1/skills。 - 可选组件 fail closed: SHACL-AF 规则、SPARQL 函数和自定义 SPARQL 约束依赖可选的 pyshacl sidecar,未配置时相关策略会直接失败。
- 鉴权:
service/api的写接口需要认证,审计状态存于 SQLite;可用service/api的create-api-key脚本签发 API Key。 - 成熟度: 更丰富的本体挖掘、完整的 WORM/Trillian 集成、见证人网络语义等仍被列为计划中。早期阶段的外部仓库和 Okta 连接可能以 mock 模式运行。
- 许可证: BSD 3-Clause。
HotRepo 点评
Signet 是一个 2026 年 11 月才创建的极新仓库,唯一有排名的记录是 2026-11-18 的 TypeScript 新项目快照:109 Star、2 Fork,在一个一小时观察窗口内新增 5 Star。这个时间跨度不足以判断采用情况或趋势,它也从未进入全语言日榜。材料里更值得注意的是覆盖面:创建初期就同时具备生命周期状态机、SHACL 校验、双规范化签名、内部 Merkle 治理日志以及 OpenAPI/SDK/MCP 接口,这类信任机制通常需要更长时间搭建,建议以设计文档和测试为准,而不是看星数下结论。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。