接口厚度

定义

接口厚度（Interface Thickness）是指个人知识系统中"文件 / 协议 / 工具约定"所携带的语义信息量。它构成一条从"纯文本"到"平台绑定"的连续谱，决定一个系统在可移植性与智能深度之间的权衡位置。

要点

• 薄接口：纯 Markdown，无需任何外部约定即可阅读，极强的可移植性，但放弃 agent 深度嵌入能力
• 中等厚度开放接口：结构化到足以被 agent 执行（如 CLAUDE.md、skill 文件夹、MCP 协议），简单到足以被人类手写，依赖"规范持续被支持"
• 厚接口 / 平台绑定：Notion、Evernote 式闭源数据库——同时牺牲文件主权与能动进化，是 File over App〔待补〕 和 Code Agent 两派的公敌
• 接口厚度的选择不是技术问题，而是对未来的押注：押"未来的平台仍在"还是押"未来的文件仍可读"
• 个人知识系统的设计本质上是在这条谱系上选一个点，而非寻找绝对最优

示例

• Obsidian vault 的 .md 文件 = 薄接口极端
• OrbitOS 的 frontmatter + index.md + log.md 协议 = 中等厚度
• Notion database = 厚接口
• CLAUDE.md + .claude/skills/ = 开放规范的中等厚度，可被任何支持该规范的 agent 读取

相关概念

• File over App〔待补〕 - 推崇薄接口的极端立场
• 协议层〔待补〕 - 管理接口厚度的设计手段
• 文件作为协议〔待补〕 - 在薄接口上叠加语义的技术
• LLM Wiki〔待补〕 - 中等厚度开放接口的早期实践
• 知识编译〔待补〕 - 解释"为何需要某种厚度"的认知机制
• 语义层作为工具接口 - 语义层作为"中等偏厚"接口的典型实践
• Harness 嵌合体性 - 接口厚度是判别嵌合体不同层性质的标尺
• 接口折旧速度 - 接口越厚、折旧越快
• Harness 与控制论的关系〔待补〕 - 接口厚度升格为本体判别标尺

参考资料

• brainstorm 圆桌讨论（2026-04-08）：File over App / File-Driven Architecture / Code Agent 三派辩证