OKF Anything开放知识格式
开放知识格式 (Open Knowledge Format)

脱离中心化云端锁，
重获数据绝对所有权

okf-anything 支持增量拉取与同步 Notion 与 飞书 Lark 文档，保留完整层级与 YAML 元数据，落地为本地自由控制的 OKF Markdown 工作区，无缝对接 AI Agent 与 Claude Code Skills。

npm i -g @inon-ai/okf-anything
绝对只读 · 零污染
UUID 幂等增量同步
本地目录随意调整
OKF 增量流式架构
Read-Only 模式
1. 云端数据源 (Notion / 飞书)

只读 API 抓取 Page, Database, Block 及其修改时间

UUID 幂等匹配
2. 本地 OKF Markdown 工作区~/iNon
YAML Frontmatter + 标准 Markdown，目录随意重命名
在线互动体验 (Live Terminal Simulation)

体验 okfa 命令行流式同步

点击下方不同命令，模拟云端（Notion / 飞书）文档增量流式落盘至本地 OKF Markdown 工作区。

zsh — okfa CLI
云端只读授权
>$ okfa sync notion
[info][OKFA Engine] Loading configuration from ~/.okfa/config.yaml...
[info][Notion Adapter] Fetching updated pages since 2026-07-01...
[ok][OKF Sync] Stream writing -> ~/iNon/notion/Q3-Product-Roadmap.md
[md]✓ Sync completed: 1 page updated, 0 deleted (read-only mode)
notion/Q3-Product-Roadmap.md
Notion
YAML Frontmatter (元数据标头)
notion_id: 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d
last_edited_time: 2026-07-06T09:30:00.000Z
---
inon_id: 9b8a7c6f-5e4d-3c2b-1a0f-9e8d7c6b5a4f
notion_id: 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d
title: "Q3 架构设计与平台迁移路线"
resource: "https://notion.so/workspace/1a2b3c4d"
created_time: "2026-06-01T10:00:00.000Z"
last_edited_time: "2026-07-06T09:30:00.000Z"
timestamp: "2026-07-06T09:30:00.000Z"
properties:
  Status: "In Progress"
  Owner: "Jackson He"
---

# Q3 架构设计与平台迁移路线

## 核心目标
1. 脱离 Notion / 飞书云端数据库锁定。
2. 增量拉取落地至本地 OKF Markdown。
3. 提供原生 CLI 与 Agent Skill。
为什么选择 OKF Anything

传统云端知识库 vs OKF 开放格式

摆脱 SaaS 软件的导出限制、频率封禁与数据私有化隐患，让你的个人与团队知识回归本地磁盘。

传统 SaaS 云端知识库

Vendor Lock-in
  • 黑盒数据锁定：文档只能保存在云端服务器，服务中断或到期即面临丢失风险。
  • 导出格式错乱：手动导出往往丢失数据库关联、嵌套层级与自定义属性。
  • 无法供 AI Agent 消费：API 极其受限且有频控限速，本地 CLI 工具与 AI 模型无法极速检索。
  • 目录结构僵化：一旦在云端修改移动层级，外部脚本或引用链接立刻失效。

OKF Anything 本地知识库

Open & Private
  • 通用标准 Markdown：纯文本落盘，零私有格式，用任何编辑器（Obsidian, VSCode, iNon）均可直接打开。
  • UUID 组合幂等增量：notion_id 与 lark_id 在 YAML 标头留存，目录随意拖拽重命名不破坏同步。
  • AI Agent 原生集成：内置 4 大 Claude Code Skills 与高效 okfa shot 全文与属性检索指令。
  • 严格只读 · 安全透明：仅拉取数据写入本地，绝不出域，绝不调用 Notion / 飞书的写数据接口。
核心功能矩阵 (Capabilities)

专为脱离云端而设计的 OKF 引擎

从流式落盘到 AI Agent 原生集成，每一个细节都只为数据自由与极速体验。

双平台增量同步 Engine

支持 Notion 与 飞书 (Lark) 双平台。通过 UUID + 最后编辑时间进行幂等增量对比，无需反复重新全量拉取。

  • 流式落盘 (Ctrl-C 不破坏目录)
  • 自动处理重名冲突追加后缀
  • 绝对只读云端数据，零风险

OKF 标准 Markdown 存储

无缝转换数据库属性、父子关系、文档标题与修改时间至扁平化 YAML Frontmatter，支持任意 Markdown 工具查看。

  • 包含 notion_id / lark_id / inon_id
  • 保留原文 URL 资源溯源链接
  • 完全摆脱私有格式绑定

Claude Code Skills 原生集成

开箱即用 4 大 Claude Agent 技能 (okfa-init, okfa-sync-notion, okfa-sync-lark, okfa-shot)，让 AI 助手自由操作同步与检索。

  • 免配置直接调用 CLI 命令行
  • 可配置定时 Schedule 任务模板
  • 支持 Agent 自动知识库构建

okfa shot 高性能检索引擎

专为 Agent 与开发者设计的本地检索引擎。集成 ripgrep 极速按属性、标题、全文检索与批量替换。

  • 类 .gitignore 规则过滤
  • 正则与全文高亮匹配
  • 毫秒级定位目标 Markdown
架构映射逻辑

云端原生字段 ➔ OKF YAML 映射

无缝解构 Notion 与 飞书的原生文档结构，平铺为清晰规范的 YAML 标头与标准 Markdown 文本。

Notion 字段 ➔ OKF YAML 规范

将 Notion API 返回的原始 json 扁平化归档，保留唯一 notion_id 与时间戳，Database Properties 自动存入 properties 对象中。

Notion Raw FieldOKF Field
idnotion_id
titletitle
urlresource
lastEditedTimelast_edited_time / timestamp
parent.idnotion_parent_id
# OKF Markdown Sample (~/iNon/notion/page.md)
---
inon_id: 9b8a7c6f-5e4d-3c2b-1a0f-9e8d7c6b5a4f
notion_id: 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d
title: "OKF Specification"
resource: "https://notion.so/1a2b3c4d"
created_time: "2026-06-01T10:00:00.000Z"
last_edited_time: "2026-07-06T09:30:00.000Z"
timestamp: "2026-07-06T09:30:00.000Z"
properties:
  Tags: ["Documentation", "OKF"]
---

# OKF Specification

Data stored in local `~/iNon` directory.
AI Agent Skills & Claude Code

Claude Code Agent Skills 原生支持

内置 4 大 Claude Agent 代码技能（Skills），让 AI 助手能够自动感知并操控您的 OKF 知识库。

okfa-init

工作区初始化

自动配置 .okfa/config.yaml 校验规则与默认 ~/iNon 知识路径。

okfa-sync-notion

Notion 增量拉取

自动提取 Notion 页面、数据库与 Block，流式渲染落盘为 OKF 格式。

okfa-sync-lark

飞书 Lark 同步

增量解析飞书团队知识文档，生成干净统一的本地 Markdown。

okfa-shot

Agent 检索与替换

基于 ripgrep 实现 Frontmatter 属性过滤、全局全文匹配与批量更新。