搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

therandomsecurityguy/signet

AI 工程

面向自主 Agent 与技能治理的图优先注册中心,对每个版本做语义校验、签名认证和透明日志记录。

141
2
TypeScript
BSD-3-Clause
创建于 4 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。