前言¶

自主 Agent 在执行交易、发布内容或触发合规相关操作前，往往只有本地日志可回溯，第三方很难独立验证「当时为何这样决策」。若你希望把推理与计划动作在执行前固化为可公开查验的记录，又不想把原始提示词全文上传到外部服务，就需要一套「本地哈希 + 链上锚定 + 可验证链接」的流程。下面介绍 SkillHub 社区技能 xproof（坐标 @user_15292d5a/yjkj-xproof）：它把 xProof 平台的 Prove Before Act、REST、MCP 与 x402 付费调用写进通用 SKILL.md，供 Cursor 等 Agent 按文档引导集成。

这是什么¶

xproof 是一套面向 AI Agent 的 accountability（可问责）技能包：指导 Agent 在重大动作执行之前，将推理（WHY）与计划动作（WHAT）的 SHA-256 哈希及 4W 元数据（Who / What / When / Why）锚定到链上，并在 https://xproof.app/proof/{id} 提供公开验证入口。原始内容在本地计算哈希，技能文档强调哈希上链、明文不出机。

• 发布与来源：SkillHub 分类为 office-efficiency，来源 community，发布者 user_15292d5a；页面显示版本 v1.0.0（包内根 SKILL.md frontmatter 标注 4.0.0，以你实际安装包为准）。
• 平台主页：技能文档指向 xProof Platform。
• 标签：requires_api_key=false（支持无 API Key 的 x402 按次付费路径；也支持 pm_ API Key 与免费试用）。

SkillHub 列表页当前未填写长简介，具体能力以安装包内 SKILL.md、README.md 及 xproof/references/ 为准。

核心功能¶

以下能力均来自已安装技能包文档，可与 Agent Context 对照。

1. Prove Before Act：先锚定推理与计划动作，再执行；执行时可附带 proof_id。
2. 隐私优先：仅提交文件/内容的 SHA-256 与元数据，不上传原始全文（certify.sh 亦在本地 sha256sum 后 POST）。
3. x402 原生：对 https://xproof.app/api/proof 可先收到 HTTP 402 挑战，在 Base 上用 USDC 签名后带 X-PAYMENT 重试，无需预先注册账号（技能内 Python 示例）。
4. MCP：JSON-RPC 2.0 端点 POST https://xproof.app/mcp；文档列出的工具包括 certify_file、audit_agent_session、investigate_proof、register_trial（及参考文档中的 register_free_trial 等）。
5. 免费试用：通过 MCP register_trial / register_free_trial，或 POST https://xproof.app/api/agent/register，可获得带额度的 pm_ Key（文档写明 10 次免费证明量级，以平台当前政策为准）。
6. 配套脚本：包内 xproof/scripts/certify.sh 用 XPROOF_API_KEY 对本地文件发起认证请求。

定价档位在技能 README.md 中列出（例如 0–100k 档 \(0.05 / proof**），按量递减；x402 示例中单次约 **\)0.05 USDC on Base。

安装与启用¶

SkillHub 官方页面给出的安装方式是：让 Agent 阅读 SkillHub 安装说明，并安装坐标 @user_15292d5a/yjkj-xproof。

若本机已有 skillhub CLI，可将技能装进当前 Agent 的 skills 目录（必须使用 --dir，否则默认 ./skills/ 可能不被识别）：

command -v skillhub && skillhub --version

skillhub install yjkj-xproof --namespace user_15292d5a --dir ~/.cursor/skills/

在 Cursor 上，skills 目录一般为 ~/.cursor/skills/；安装后按 Agent 要求重启或重新加载会话，使 SKILL.md 进入上下文。

技能包内另写有其他客户端示例（非 SkillHub 坐标）：

hermes skills install clawhub/xproof
openclaw skills install xproof

是否与你的环境一致，请以对应客户端文档为准；SkillHub 分发路径以上述 skillhub install 为准。

环境变量（API Key 路径）：使用 certify.sh 或 Bearer 认证时，需设置：

export XPROOF_API_KEY=pm_your_key
export XPROOF_API_URL=https://xproof.app   # 可选，默认即此地址

典型用法¶

1. 文件级链上认证（Shell）¶

对已有文件做本地哈希后调用 API（需 API Key）：

export XPROOF_API_KEY=pm_your_key
./xproof/scripts/certify.sh report.pdf "CI Bot"

脚本成功后会输出 proof_id、verify_url 及链上交易信息字段（以 API 返回 JSON 为准）。

2. Prove Before Act（x402，无 API Key）¶

技能文档中的最小流程：本地 json.dumps → SHA-256 → POST /api/proof 收 402 → 钱包签名 x402 → 带 X-PAYMENT 再 POST：

import hashlib, json, base64, requests

def prove_before_act_x402(reasoning: dict, wallet_signer) -> dict:
    file_hash = hashlib.sha256(
        json.dumps(reasoning, sort_keys=True).encode()
    ).hexdigest()

    r = requests.post("https://xproof.app/api/proof",
        json={"file_hash": file_hash, "filename": "reasoning.json"})
    assert r.status_code == 402

    signed = wallet_signer.sign_x402(r.json()["payment"])
    x_payment = base64.b64encode(json.dumps(signed).encode()).decode()

    return requests.post("https://xproof.app/api/proof",
        headers={"X-PAYMENT": x_payment},
        json={"file_hash": file_hash, "filename": "reasoning.json"}).json()

返回体含 proof_id、verify_url 后，再执行真实业务动作。

3. MCP 在动作前 certify_file¶

{
  "name": "certify_file",
  "arguments": {
    "file_hash": "sha256_of_reasoning",
    "filename": "decision_reasoning.json",
    "metadata": {
      "who": "my-agent-v2",
      "what": "execute trade BUY BTC 0.5",
      "why": "RSI=38, below oversold threshold, risk/reward 1:3",
      "purpose": "prove_before_act"
    }
  }
}

文档说明返回 proof_id、verify_url、status: "anchored" 后再继续执行。

4. 无 Key 起步：MCP 免费试用¶

向 https://xproof.app/mcp 调用 register_free_trial（参考 xproof/references/mcp.md），取得 pm_ Key 与剩余额度，再用于后续认证类工具。

适用场景与注意¶

适合谁

• 需要在执行前留下可公开验证决策痕迹的 Agent（交易、研究发布、内容合规、企业内高风险自动化等）。
• 已使用或计划使用 MCP、REST，并愿意对接 x402 或 API Key 计费模型的团队。

限制与风险（技能 skill-card.md 已写明，摘录要点）

• 元数据、文件名、哈希与证明 URL 可能长期公开；勿把密钥、个人隐私或未脱敏的 chain-of-thought 写入可上链字段。
• pm_ Key 与 x402 支付载荷等同凭证，应脱离源码仓库保管，并为自主付费设置上限或人工审批。
• 链上锚定与 MultiversX / Base 等网络依赖以 xProof 当前实现为准；集成前阅读 MCP 参考 与 API 文档。

SkillHub 侧数据（抓取时）：评分 100000，下载 729，安装 0；与页面展示可能随时间变化，以 SkillHub 技能页 为准。

结尾¶

xproof 把「先锚定哈希与 4W 元数据、再行动」的流程固化成 Agent 可读的技能说明，并覆盖 API Key、x402 与 MCP 多条集成路径。若你在 Cursor 等环境中需要可第三方验证的 Agent 审计链，可从 SkillHub 安装 @user_15292d5a/yjkj-xproof，再按包内 SKILL.md 与 xproof/references/ 对接 xproof.app。

• SkillHub API：https://api.skillhub.cn/user_15292d5a/yjkj-xproof
• SkillHub 页面：https://www.skillhub.cn/skills/user_15292d5a/yjkj-xproof