将混乱的文档锻造成OKF v0.2知识包。

okfsmith 是一个 Python CLI，可以导入 PDF、markdown、wiki dump 和 Notion 导出并发布符合规范的 OKF v0.2 捆绑包：带 YAML 的 markdown 文件 前言，加上保留的index.md和log.md。每个概念都包含 来源（sources[]）、信任层、生命周期元数据，以及所有 bundle 由内置的 §11 验证器检查。将其送达给你的代理 一个MCP命令。

60秒快速启动

将任何支持MCP的代理指向该捆绑：

暴露工具：八个读面工具（index、list、search、get， neighbors、traverse、provenance、diff）加上四个受控写回 工具（preview_write_concept、write_concept、update_concept， audit_log）——每个答案都追溯到该丛中的sources[]，且 每次写入都未验证、验证者门禁、来源戳章，且 已审计记录。

⭐ 如果okfsmith帮了你，星星意义重大——它能帮助其他开发者找到项目。

为什么是 Okfsmith

Clean Markdown 已经有不错的 OKF 工具。中间的混乱——200页的 PDF 阅读顺序紊乱、Notion导出、维基导出——

okfsmith

Forge messy documents into OKF v0.2 knowledge bundles.

okfsmith is a Python CLI that ingests PDFs, markdown, wiki dumps, and Notion exports and emits spec-conformant OKF v0.2 bundles: markdown files with YAML frontmatter, plus reserved index.md and log.md. Every concept carries provenance (sources[]), a trust tier, and lifecycle metadata, and every bundle is checked by a built-in §11 validator. Serve it to your agents with one MCP command.

60-second quickstart

pip install okfsmith

okfsmith init ./kb
okfsmith ingest ./kb notes/ report.pdf --no-llm   # offline first pass
okfsmith validate ./kb
okfsmith graph ./kb --format html   # writes ./kb/viz.html — open in a browser

Point any MCP-capable agent at the bundle:

pip install "okfsmith[mcp]"
okfsmith mcp ./kb

Tools exposed: eight read tools (index, list, search, get, neighbors, traverse, provenance, diff) plus four governed write-back tools (preview_write_concept, write_concept, update_concept, audit_log) — every answer traces back to sources[] in the bundle, and every write lands unverified, validator-gated, provenance-stamped, and audit-logged.

⭐ If okfsmith helped you, a star means a lot — it helps other developers find the project.

Why okfsmith

Clean markdown already has good OKF tooling. The messy middle — 200-page PDFs with broken reading order, sprawling Notion exports, wiki dumps — is where knowledge usually lives, and that’s what okfsmith ingests first:

parse → section → extract → link → emit → validate → serve

• Tiered parsing, free first. Tier 1 is local and keyless: LiteParse for PDFs, stdlib parsing for markdown/text. Office formats (.docx, .pptx, .xlsx) via the optional okfsmith[office] extra; Docling OCR sidecar via okfsmith[ocr] for scanned pages. PyMuPDF is deliberately avoided (AGPL).
• Two extraction modes. --no-llm writes one draft concept per section — fast, offline, deterministic. With an LLM (Ollama by default, or an