正在打开每日关注
正在打开每日关注
轻量 OKF 以 YAML front matter 结构化 OpenWiki 文档，改善确定性搜索，并为未来 UI 的发现与预览铺路。
Who’s actually using OKF? What’re your reasons behind it/thoughts? We’re going to adopt it in OpenWiki for a couple reasons: - it’s a simple spec. Supporting it doesn’t mean changing much (basically just yaml front matter in each .md file) - the front matter spec should make it easier to build & use deterministic search & filtering tools against the docs (keyword, full text, etc) - when we eventually build a UI for OpenWiki, it’ll likely help with exposing content to humans (better sectioning, discovery, preview details, etc) Anyone else started using it yet? Super curious to hear more
是什么 这是一条围绕 OKF 采用经验的纯观点推文。Brace Sproul 介绍 OpenWiki 计划采用它，但没有给出 OKF 的完整定义、字段表或兼容性细节，因此重点不在规范本身，而在低成本结构化文档的价值判断。
核心设计 方案把 YAML front matter 放进每个 Markdown 文件，用少量机器可读元数据补充正文。这样既保持 Markdown 的轻量编辑方式，又为关键词、全文搜索和过滤提供更稳定的输入；未来 UI 还可以借助这些信息做内容分段、发现和预览。
关键洞察 推文的逻辑链是：简单规范带来低迁移成本，结构化文档便于确定性处理，进而让搜索与人类阅读体验更可控。它把文件格式选择连接到检索、信息架构和产品界面，而不是把文档只当作静态文本。
边界与风险 目前没有说明字段如何定义、是否强制、如何校验、版本如何演进，也没有证明检索质量必然提升。若元数据缺失或写法不一致，过滤结果仍会失真；未来 UI 的收益也取决于信息模型和索引实现。适合先在 OpenWiki 小范围试用，再用真实搜索场景验证规范。