核心用法
context-verifier 是 Neon Agentic Suite 的基础层技能,整合哈希计算、完整性验证、风险分级和上下文包管理四大功能,通过 /cv 命令前缀统一调用:
- `/cv hash <file>` — 计算文件 SHA-256 哈希值
- `/cv verify <file> <hash>` — 比对文件当前哈希与预期值,输出 ✓ MATCH / ✗ MISMATCH
- `/cv tag <file> [severity]` — 自动识别文件风险等级(critical/important/minor),支持手动覆盖
- `/cv packet <files> [--name]` — 批量打包文件元数据为 JSON 快照,支持 glob 通配
典型工作流:编辑前执行 hash 保存基线,修改前执行 verify 确认文件未变,关键操作前创建 packet 生成可审计快照。
显著优点
1. 密码学安全:默认禁用 MD5/SHA-1,仅使用 SHA-256;关键文件变更可配置为阻断操作
2. 风险分级智能:内置敏感文件识别(.env、*credentials*、*secret* 等),支持 YAML 配置自定义规则
3. 零依赖基础层:作为 foundation 层技能,不依赖其他技能,反被 failure-memory、constraint-engine 等依赖
4. 上下文可追溯:自动生成的 packet 包含路径、哈希、风险等级、时间戳,支持重构前后的状态比对
5. 多配置兼容:同时支持 .openclaw/ 和 .claude/ 配置目录,便于跨平台迁移
潜在局限
- 仅支持 SHA-256:虽有安全考量,但无法兼容需 MD5/SHA-1 的历史系统
- 文件级粒度:最小操作单元为单个文件,无法针对文件内片段做细粒度验证
- 本地文件系统依赖:暂不支持远程文件、URL 或对象存储的直接验证
- 无自动监控:需显式调用(explicit invocation),不具备后台实时监听变更的能力
- 风险分级基于文件名模式:内容分析能力有限,可能误判(如普通文件命名为
secret.txt)
适合人群
- 使用 OpenClaw/Claude Code 进行代码重构的开发者
- 需要审计追踪的 AI 辅助编程场景
- 处理敏感配置文件(密钥、凭证)的团队
- 构建 agentic 工作流、需依赖注入式验证机制的架构师
常规风险
- 哈希碰撞误报:SHA-256 虽无已知碰撞,但极端场景下的存储位翻转可能导致误报
- 配置覆盖风险:
critical_patterns配置不当可能漏标敏感文件,或过度阻断正常操作 - 权限拒绝导致假阴性:文件不可读时直接报错,需手动处理权限问题
- packet 存储路径暴露:默认输出至
output/context-packets/,多用户环境需注意访问控制 - 时间戳依赖:验证流程依赖系统时钟,跨时区协作时需确保时间同步
来源与可信度
由 Live Neon 团队维护,MIT 协议开源,仓库地址明确可审计。作为 2026-02-15 技能合并重构后的基础组件,代码历史可追溯。