01
笔记只在一台设备，Agent 却运行在别处，只拿到正在变旧的复制上下文。
Doco 使用场景
Agent 能安全维护的个人知识库
如果你想跨设备使用真正的 WYSIWYG 文档空间，同时让外部 Agent 通过受控 API 搜索、引用和维护部分笔记，可使用 Doco 作为个人知识库；若文件、插件和完全离线独立更重要，则选择本地 Markdown。
真实失败模式
个人笔记会变成运行上下文
私有 vault 很简单，直到另一台设备上的 Agent 必须找到当前事实、精确引用，并在不破坏附近内容的情况下更新。
02
段落移动和笔记重组后，文件名或行号不再是有效引用。
03
授予文件系统权限会暴露比任务真正需要的文档更宽的目录。
操作循环
保持以人的写作为先
- 01
在富文本编辑器中使用标题、表格、图片、图表、电子表格、折叠区和快捷键写作。
- 02
浏览器保存本地状态以快速打开和离线编辑；联网后通过共享 Yjs 文档同步。
- 03
先给 Agent 只读 Token，让它浏览、搜索并引用指定知识库或文档。
- 04
只有被证明的流程才升级写 scope，强制版本检查，并以 Markdown/原生导出作为退出路径。
Doco 是有服务层的个人工作区，不是纯文件夹应用。如果完全本地文件控制是第一需求，Markdown vault 更合适。
能力地图
系统必须提供什么
| 维度 | 真实需求 | Doco 如何处理 |
|---|---|---|
| 权威事实源 | 舒适的日常写作与组织 | 富 WYSIWYG 文档、文件夹、图表、表格和导入 |
| 检索 | 无需把整个库塞给 Agent 也能查找 | 知识树、目录、结构化搜索和有预算读取 |
| 证据 | 重排后仍耐久的引用 | 存储在文档模型中的稳定块 ID |
| 写入 | 有限 scope 的可选 Agent 维护 | API Token、CLI、MCP、文档/块工具与评论 |
| 并发 | 浏览器与 Agent 会话之间安全编辑 | 本地 IndexedDB + Yjs 同步 + 版本保护 API 写入 |
| 可迁移性 | 避免单向厂商锁定 | Markdown、ZIP、原生迁移与自托管 |
适合
长笔记、研究、学习日志、个人 runbook、项目日志、写作草稿，以及允许指定 Agent 读取或维护的精选资料库。
不适合
要求每篇笔记都是可直接编辑的本地 Markdown 文件、重度依赖成熟插件生态，或永远不希望协作服务器参与的用户。
01Doco 笔记保存为 Markdown 文件吗？
不是。权威正文是结构化 Yjs/ProseMirror 文档；Markdown 用于导入、导出、发布和 Agent 往返。
02断网能编辑吗？
浏览器保留本地 IndexedDB 状态，可在短时断线中继续编辑，协作连接恢复后自动合并。
03什么时候 Obsidian 更适合？
当本地 Markdown vault、广泛插件、图谱流程和用户自管同步比共享 Agent 服务更重要时，选择 Obsidian。