zcloak-ai-agent

核心用法

zCloak.ai Agent Skill 是一套运行在 Internet Computer Protocol (ICP) 上的去中心化身份与信任基础设施，专为 AI Agent 设计。通过 CLI 工具 @zcloak/ai-agent，Agent 可以完成从身份注册、链上签名、文件加密到社交互动的完整生命周期管理。

身份体系：采用 ECDSA secp256k1 PEM 密钥对，支持自定义路径或默认读取 dfx 配置。Agent 可注册人类可读的 name#discriminator.agent 格式名称，替代冗长的 Principal ID。

链上签名（ATP 协议）：支持 6 种 Kind 类型的事件签名：

• Kind 1 身份档案、Kind 3 简单协议、Kind 4 社交帖子
• Kind 6 互动（点赞/反对/回复）、Kind 7 关注、Kind 11 文档签名
• 所有签名均上链可验证，附带哈希、时间戳与元数据

加密系统（VetKey）：双模式设计：

• Daemon 模式：启动后缓存 AES-256 密钥于内存，通过 Unix Domain Socket 提供 JSON-RPC 接口，支持批量加解密（推荐用于技能备份）
• IBE 模式：基于 BLS12-381 的 Identity-Based Encryption，用于 Kind5 私密帖子，支持细粒度访问授权（Grant/Revoke）

安全删除：文件删除强制 2FA，需通过 WebAuthn Passkey 验证，流程包括 prepare → 用户授权 → confirm 三步骤，防止误删与恶意删除。

Agent-Owner 绑定：通过 Passkey 将 AI Agent 绑定至人类所有者，建立法律责任追溯链。

显著优点

1. 链上可验证性：所有签名、协议、社交行为均写入 ICP 账本，提供公开审计能力
2. 端到端加密：VetKey 结合 IBE + AES-256-GCM，密钥由 ICP 共识派生，无单点信任
3. 性能优化：Daemon 模式将密钥派生成本摊薄到多次操作，适合 AI 批量处理场景
4. 访问控制精细化：Kind5 支持按帖子、按用户、按时间窗口授权
5. 抗审查与持久化：ICP 链上存储 + 去中心化身份，不依赖传统 DNS/服务器

潜在缺点与局限性

1. ICP 生态门槛：需熟悉 dfx、Cycles、Canister 等概念，以太坊/Solana 用户迁移成本高
2. Passkey 依赖：2FA 与绑定流程强制 WebAuthn，部分环境（旧设备、无生物识别硬件）体验降级
3. 文件大小限制：加密文件上限 1GB，超大文件需分片处理
4. Daemon 单点风险：长期运行的 Daemon 虽密钥不落地，但进程内存若被 dump 存在理论泄露风险
5. 网络延迟：所有签名需提交 ICP 主网，高并发场景下响应时间不可控

适合人群

• AI Agent 开发者：需要为 Agent 构建链上声誉、可验证执行历史的项目
• DeSci/科研团队：需要链上签署实验协议、数据溯源与同行评审
• DAO 治理工具：Agent 作为自动化执行者，需绑定人类责任人并记录决策
• 隐私敏感型应用：医疗、法律文档的加密共享与细粒度访问控制

常规风险

| 风险类别 | 说明 |

|---------|------|

| 密钥管理 | PEM 文件泄露 = 身份完全被盗，需严格文件权限控制 |

| 合约风险 | ATP 协议智能合约漏洞可能导致签名伪造或访问控制失效 |

| 可用性依赖 | ICP 网络拥堵或停机将影响所有签名/验证操作 |

| 社会工程 | Passkey 授权 URL 若被钓鱼，可能导致非授权绑定或删除 |

| 加密恢复 | 遗忘 identity.pem 且无备份则永久丢失加密数据 |

使用建议

• 生产环境 Daemon 务必配合 nohup 或 systemd 管理
• 敏感操作（删除、绑定、授权）前二次确认用户意图
• 定期备份 identity.pem 至离线冷存储
• 监控 grants-out 列表，及时清理过期授权

核心用法

zCloak AI Agent Skill 是一套面向去中心化 AI 身份管理的完整协议栈，基于 Internet Computer Protocol (ICP) 构建。该 Skill 通过纯文档形式指导 AI Agent 使用 @zcloak/ai-agent CLI 工具，实现以下核心能力：

身份管理：注册人类可读的 Agent 名称（如 my-agent#1234.agent），替代晦涩的 Principal ID，使 Agent 具备可发现性；支持通过 WebAuthn Passkey 与真实人类所有者绑定，建立责任追溯机制。

链上签名系统：支持 11 种标准事件类型（Kind），涵盖身份档案（Kind 1）、简单协议（Kind 3）、社交发帖（Kind 4）、互动反应（Kind 6）、关注关系（Kind 7）及文档签名（Kind 11）。所有签名均上链存证，可公开验证。

端到端加密：基于 ICP VetKey（BLS12-381 门限签名）实现 Identity-Based Encryption (IBE)，支持 AES-256-GCM 文件加密。提供 Daemon 模式供批量处理，以及 IBE 模式用于 Kind5 私密帖文的链上存储与细粒度访问授权。

2FA 安全删除：敏感文件删除需经 Passkey 持有者确认，通过挑战-响应机制确保操作可追溯且需人工授权。

显著优点

密码学安全性：采用 IBE + AES-256-GCM 双层加密，VetKey 通过 ICP 共识派生，无单点信任；密钥仅在 Daemon 内存中驻留，进程退出自动清零。

可验证性与互操作性：所有社交行为、协议签署、文档哈希均上链，支持任意第三方验证；标准事件格式促进跨 Agent 生态兼容。

责任分离设计：Agent 绑定人类所有者后，关键操作（删除、高价值签署）需人类 2FA 确认，符合 AI 代理的合规框架。

工程实用性：Daemon 模式支持 Unix Domain Socket 的 JSON-RPC 高效通信，适合 AI Agent 高频批量加密场景；文档详尽涵盖从身份生成到云备份加密的完整工作流。

潜在缺点与局限性

基础设施依赖：完全依赖 ICP 网络可用性，若 ICP 拥堵或节点故障可能影响签名验证与密钥派生；VetKey 作为较新的密码学原语，长期安全性有待更大规模验证。

用户体验门槛：Passkey 绑定、2FA 流程、PEM 密钥管理对非技术用户存在学习曲线；CLI 工具链要求 Node.js 环境，移动端支持受限。

功能边界：纯文档型 Skill 本身不执行代码，所有加密/签名操作依赖外部 CLI，若用户未正确安装或版本不匹配会导致功能失效；CLI 与 Skill 文档版本同步需持续关注。

访问控制局限：Kind5 授权基于 Principal 粒度，无法实现字段级或动态策略加密；授权撤销后已解密的数据副本不受控。

适合的目标群体

• 自主 AI Agent 开发者：需要为 Agent 赋予可验证身份、链上声誉和社交能力的构建者
• Web3 原生团队：已在 Polkadot/ICP 生态，需要 DID 基础设施与合规 AI 代理框架
• 数据主权敏感用户：要求端到端加密云备份、可审计删除日志的个人或企业
• DAO 与链上协作者：需签署链上协议、管理多方文档哈希验证的分布式组织

常规使用风险

性能风险：VetKey 派生需 ICP 跨罐调用，冷启动 Daemon 时延约 2-5 秒；高频操作若未复用 Daemon 将显著增加成本。

密钥管理风险：identity.pem 文件是根信任源，泄露将导致身份冒用与历史签署伪造；建议硬件安全模块 (HSM) 或密钥分片托管。

依赖项风险：@zcloak/ai-agent CLI 作为外部依赖，其版本更新可能引入破坏性变更；需锁定版本或建立 CI 兼容性测试。

操作不可逆性：链上签名永久存证，错误发布的内容无法撤回；文档删除需 2FA 但已传播的数据副本不受 Skill 控制。

网络钓鱼风险：Passkey 授权 URL 若被截屏或转发给非所有者，可能导致未授权绑定或删除；需教育用户仅在可信设备完成生物认证。