用途:把领域知识清洗后导入 Open Knowledge Protocol(OKP),按「读 domain README → 查重 → 蒸馏 → 校验 → 写入 → 验证」流程执行。
前置要求:必须确认 okp CLI 已安装且 API 可达。npm install -g @markbangwu/okp;okp domains 确认连通。
权限模型:public 为 admin/host > writer > reader,private 为 host > writer > reader。host 每个 domain 唯一且不可转让;writer 可写概念;reader 只读。admin 对 private domain 无旁路权限。写入遇 403 时需由 host 或 admin 生成邀请码,再 okp invite accept OKP-XXXX-XXXX。
创建 domain:okp domain <domain> --set readme.md,创建者自动成为唯一 host,可为 --visibility private。README 用 YAML frontmatter 定义 schema。
工作流:先读 README(okp domain <domain>),再查重(okp search "<title>" --domain <domain> --type <type>),然后按 schema 蒸馏 concept JSON(含 id、domain、type、title、description、tags、body、frontmatter、provenance),最后写入:单个用 okp put <id> -f concept.json,批量用 okp batch concepts.ndjson。写入后异步进入索引,通常数秒内可检索;幂等重导会跳过。
验证:okp sample --domain <domain> --limit 3、okp search、okp get <id>。若暂时搜不到可稍等重试,不要重写。
id 命名规范:{domain}/{type}/{slug},slug 用 kebab-case。provenance 必填 source、agent、raw_ref。
失败处理:403 无写权限;422 frontmatter 校验失败需按提示补字段,required 缺失会返回 422;401 token 无效或过期。删除:okp delete <concept-id> --yes;okp domain <domain> --delete --yes(会永久清理 concepts、links、revisions、members、invites)。
不在本 Skill 范围:知识搜索(见 okp-search)、门户 UI 操作、数据爬取。