Tchapwo1/tcha-claude-skills

Tcha合规账本

为自主代理提供自动化的、防篡改的加密日志功能，确保每一次工具执行、API获取和文件修改都有无可争议的审计记录。

为什么这很重要

当自主代理在企业环境中运行时，合规审计人员需要：

1. 操作证明：代理调用了哪些工具？
2. 完整性证明：事件发生后日志是否被篡改？
3. 边界证明：代理是否超出了其定义的安全范围？

工作原理

1. 执行前哈希：拦截工具调用，计算 SHA-256(时间戳 + 工具名 + 参数)。
2. Merkle区块链：将单个操作哈希合并成连续的Merkle树账本。
3. 本地或云存储：严格在本地以JSONL格式保存记录，或配置后同步到企业级Cloudflare KV / S3存储。

在Claude中的使用

为当前会话生成合规报告：

npx tcha-protection ledger --export
# 验证过去代理日志的加密完整性
npx tcha-protection ledger --verify

样本审计记录

{
  "sequence": 142,
  "timestamp": "2026-10-18T22:58:00Z",
  "tool": "filesystem.readFile",
  "status": "APPROVED",
  "policy_checked": "path_boundary",
  "nonce": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "merkle_root": "a89b3f02194c771da4bc234f9a0c128374d9e29a34bc9812df082736458923bc"
}