SuperAPI AI 工具集

decodie-verify

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:确认 .decodie/index.json 中每条学习条目仍与其引用的源代码匹配,将不匹配者标记为 stale,并用当前提交 SHA 给确认有效的条目盖章。该模式只修改 .decodie/index.json,不会改动会话文件、源代码或 .decodie/ 之外的任何内容。

激活方式:可传入可选路径参数。未提供路径时校验全部条目;提供路径时只校验来源(或 references[].file)与该路径重叠的条目,若为目录,则任一源文件以该目录开头即视为在范围内。路径不存在则报错并停止。

设置:确认 .decodie/ 存在,否则提示“No .decodie/ directory found — nothing to verify.”并停止。读取 .decodie/index.json,若为空则提示“No entries to verify.”并停止。通过 git rev-parse HEAD 获取当前提交 SHA;若不是 git 仓库则警告并继续(锚点检查仍运行,但无法设置 verified_sha)。

校验过程:对范围内每个条目,优先解析 sources,缺失时回退到唯一的 references[].file 并回填 sources。逐一检查引用 { file, anchor, anchor_hash }:文件缺失则引用失败;文件存在则搜索字面锚点字符串,找到后重新计算 SHA-256 哈希并确认前 8 个十六进制字符与 anchor_hash 一致。若全部引用解析成功,则 stale: false 并写入 verified_sha = HEAD SHA;任一引用失败则 stale: true,verified_sha 保持不变。最后写回 index.json,保留其他字段与排序。

报告格式示例:Decodie verify / Verified: N entries (verified_sha -> <short-sha>) / Stale: M entries / Skipped: K entries (out of scope) / Backfilled sources on: B entries。若有 stale 条目则列出,例如 entry-1711540000-a1b2 -- references/0: src/lib/foo.ts (anchor not found)。

注意事项:条目内容仅追加,只有 sources、verified_sha 和 stale 可被更新;操作幂等,无变化时重复运行等同于无操作;路径是过滤器,范围外条目被跳过而非清除;不重写 git 历史,仅通过 git rev-parse 读取 HEAD。缺失信息:未提供安装命令、收费或价格信息。