用途:okf-validate 用于校验 OKF 知识包的文件契约,确保代理依赖的必需路径、唯一文件、根元数据、Markdown 内容、概念 frontmatter、链接与引用章节符合规范。它不浏览被引用的来源,也不判断知识是否真实、最新、归属正确、完整或安全。
主要能力:检查 validation.valid、文件与概念计数,以及每条 issue 的 level、path、message。错误会使受支持的契约失效,需逐文件修复;警告表示可移植性或来源信息较弱(如缺少引用章节),即使 valid 为 true 也需复核。explanation.nextActions 仅作修复顺序参考,不代表自动修改是安全的。
使用方式:MCP 场景下,仅在需要发现时调用 seo_list_reports(category 为 crawl),再调用 seo_describe_report({"id": "okf-validate"}),然后调用 seo_run_report,传入 id 与 params.files 数组(每项含 path 与 content)。检查 isError 后消费 structuredContent。CLI 使用相同严格 schema: seo reports describe okf-validate --json seo reports run okf-validate --params '{"files":[...]}' --json 资料给出的最小六文件包(index.md、log.md、concepts/index.md、inventory/pages.md、graph/links.md、caveats.md)在结构上有效。
适用场景:在消费或分发 OKF 包之前进行结构校验,或在修改后回归比对问题集合。
限制:不核实引用 URL、声明、日期、访问限制、发布者意图或爬取快照;valid: true 不等于“已事实核查”。修复时应保留原始包,在副本上修改后重跑校验并确定性比对问题集合。其他功能、收费与平台信息暂未提供。