okp-import

okp-import — 知识导入 Skill

CRITICAL — 开始前 MUST 确认 okp CLI 已安装并可连接 API：

npm install -g @markbangwu/okp
okp domains    # 确认 API 可达

权限模型

public: admin/host > writer > reader

private: host > writer > reader

• admin：全局管理员，可管理公开 domain。对 private domain 没有任何旁路权限，必须接受 reader/writer 邀请后才能读取或写入，且仍不能管理 private domain。
• host：每个 domain 有且只有一个 host，由 domain 创建者自动获得。负责管理 domain README、成员和邀请码。host 不可转让。
• writer：domain 写入者。可通过 invitation 获得。可写入概念，不能管理成员和邀请码。
• reader：公开 domain 的默认只读权限；在 private domain 中必须通过邀请显式获得。

domain 默认公开。创建者可选择 private；private domain 不会向非成员出现在 domains、search、sample、links 或 export 中。

新建 domain → 自动成为 host

写 README 即创建 domain，创建者自动成为该 domain 唯一 host：

okp domain <domain> --set readme.md

返回 201 即创建成功，创建者已持有 host 角色。

创建 private domain：

okp domain <domain> --set readme.md --visibility private

获得 writer 权限

若 put / batch / domain --set 返回 403（write access denied）：

1. 让该 domain 的 host（公开 domain 也可由 admin）生成邀请码：

   okp invite create <domain> --expires-hours 72 --max-uses 1
   

2. 当前用户接受：

   okp invite accept OKP-XXXX-XXXX
   

3. 确认成员身份：

   okp invite members <domain>
   

公开 domain 邀请码授予 writer。private domain 可邀请 reader 或 writer，不能授予 host 或 admin：

okp invite create <private-domain> --role reader
okp invite create <private-domain> --role writer

邀请码是短码，不是链接路由。门户右上角「邀请」也可输入同一邀请码。

工作流（严格按顺序）

Step 1: 读 domain README

每个 domain 有自己的 README，定义了 frontmatter 字段规范。必须先读。

okp domain <domain>          # 打印 README（含 schema 定义）
okp domains                  # 查看所有 domain
okp domains -q <keyword>     # 模糊搜索领域名

如果是新 domain，先写 README 再导入（写 README 即定义 domain，之后 okp domains 立即可见）：

okp domain <domain> --set readme.md

README 格式（YAML frontmatter 定义 schema）：

---
fields:
  sender:
    type: string
    required: true
    description: 飞书发送者用户名
  group:
    type: string
    required: true
    description: 来源飞书群
  platform:
    type: enum
    required: false
    enum: [bilibili, douyin, xiaohongshu, github, youtube]
  date:
    type: string
    required: false
    description: 发布日期 YYYY-MM-DD
---

# feishu-social

飞书社媒分享数据...

## How to contribute
每条 concept 的 frontmatter 必须包含 sender 和 group。