（4598期）Context Verifier – 文件完整性验证与上下文快照工具

文件完整性验证与上下文快照工具 AI Agent 文件完整性验证工具，本地 SHA256 哈希计算、变更检测与上下文包生成，防止操作过期数据 使用说明 核心用法 context-verifier 是一套用于文件完整性验证的基础层技能，通过显式命令调用（/cv）实现以下功能： | 子命令 | 功能 ||--------|------|| /cv hash <file> | 计算文件 SHA-256 哈希值 || /cv verify <file> <hash> | 验证文件是否与预期哈希匹配 || /cv tag <file> | 按关键程度标记文件（critical/important/minor）|| /cv packet <files> | 创建包含哈希、标记、时间戳的上下文包 | 典型工作流 # 编辑前保存哈希/cv hash src/main.go # 得到 a1b2c3... 编辑前验证未变更 /cv verify src/main.go a1b2c3... # ✓ MATCH 则安全编辑 --- 显著优点 纯本地处理：SHA-256 计算完全本地执行，文件内容绝不发送至任何模型、API 或外部服务 零依赖基础层：作为 Neon Agentic Suite 的根基技能，可被其他技能安全依赖 智能关键文件识别：自动识别 .env、credentials、secret 等敏感文件，标记为 critical 级别 防漂移设计：专门解决"AI 操作过期数据"问题——读取后文件被修改，导致编辑冲突 可配置严重度规则：通过 .openclaw/context-verifier.yaml 自定义关键文件模式 审计追踪：上下文包（context packet）可用于重构操作前后的文件状态 --- 潜在缺点与局限性 | 局限 | 说明 ||------|------|| 仅支持 SHA-256 | 明确移除 MD5/SHA-1（密码学已破解），无其他算法选项 || 显式调用负担 | 不会自动验证，需用户主动执行 /cv 命令 || 元数据级验证 | 仅验证哈希匹配，不验证语义正确性 || 无自动冲突解决 | 检测到不匹配仅警告/阻断，不提供合并方案 || 敏感文件误包风险 | --include-content 标志可将敏感内容写入磁盘，需人工规避 || 无加密存储 | 上下文包为明文 JSON，依赖文件系统权限保护 || 无自动清理 | 数据包永久保留，需手动清理 | --- 适合人群 AI Agent 开发者：构建需要状态感知的 Agent 工作流 代码重构场景：大规模改动前创建快照，事后比对变更 CI/CD 流程：验证部署前配置文件未被篡改 多轮对话场景：防止 LLM 在长时间对话中操作已变更的文件 敏感代码库：需要明确区分 critical/important/minor 文件变更影响 --- 常规风险 高危操作：--include-content # ⚠️ 危险：将 secrets 写入磁盘/cv packet .env --include-content ✓ 安全：仅存储哈希 /cv packet src/*.go --name "pre-refactor" 必做配置 必须将以下目录加入 .gitignore：output/context-packets/ 权限建议 限制 output/ 目录权限（非全局可读） 敏感环境使用加密文件系统 定期清理历史数据包 设计特性风险 与其他技能不同，context-verifier 会读取任意用户指定的文件路径（不仅限于元数据声明的路径）。这是验证功能的必要设计，但意味着 /cv hash ~/myfile 会实际读取该文件——即使它包含敏感数据。 原始说明 Know the file you're editing is the file you think it is — verify integrity before you act