LLM知识库：本地云端修改统一方案
NoteDeep Desktop 在构建 LLM 知识库时，面临如何统一本地与云端修改的复杂挑战。其核心目标是让本地知识库不仅是云端缓存，用户可离线编辑 Markdown，AI 工具（如 Codex、Claude Code、Cursor）能直接修改文件，同时云端保留富文本编辑、历史版本与协作能力。真正的难点在于同时处理本地用户、本地 AI 和云端三类修改，包括确定修改入口、优先级、断网恢复及云端领先时的合并策略。 为解决此问题，NoteDeep 团队将所有修改收敛到同一套本地状态和 JSON0 同步链路中。该方案确立了两个关键产品边界：本地目录必须在无网络甚至未登录时正常工作；Markdown 必须是人与 AI 工具都能直接读写的开放文件格式。为此，系统明确区分了本地与云端的事实源：页面正文的本地事实源是 Markdown 文件，页面树的本地事实源是 `.notedeep/manifest.json`。而云端事实源则基于 ShareDB 的 `workspaces/{workspaceUuid}` 与 `pages/{pageUuid}`。此外，`.notedeep/state/` 用于保存同步基线和待提交操作，而非业务事实源，`sync-index.json` 仅用于跳过未变化文件。这种对事实源的清晰区分是实现本地与云端修改统一的关键。