文档是协作的共同状态

人与 Agent 协作, 从同一份文档开始。

Doco 是人机协作文档的通用基础设施:人用浏览器里的富文本编辑器,Agent 用 MCP、CLI、Skill 或 REST API。双方读取、修改和审阅同一份文档,让知识从一次对话走进长期协作。

共享文档层

一次接入,多种 Agent,持续协作

文档不只是一份生成结果,也是团队与 Agent 可以共同维护的工作状态。Doco 提供文档、知识库、稳定块寻址与实时同步;你决定使用哪个 Agent,以及哪些内容允许它读取或修改。

人有直接编辑的界面

用标题、列表、表格与图表表达思路,按知识库和文件夹组织文档。在浏览器中查看 Agent 的修改,并继续编辑。

Agent 有明确的读写接口

通过 MCP 工具、终端 CLI 或 REST API 搜索和读取内容,再用稳定块 ID 精确修改目标段落。接口不绑定某个模型。

双方共享同一份状态

Agent 写入进入与浏览器相同的 Yjs 协同文档。在线客户端接收更新,版本记录帮助审阅和回滚;无需把导出的副本再上传。

协作契约

定位、校验、写入、审阅

让 Agent 维护文档,需要能够识别目标、发现并发修改,并核验写入结果。

  1. 01

    搜索与读取

    在已授权的知识库中找到文档,读取需要的内容与版本。把文档和块引用带回工作流,便于人核对依据。

  2. 02

    按块定位

    稳定的 block ID 标识目标段落。移动或重排段落后仍可寻址,修改范围可以收敛到一个块。

  3. 03

    带版本写入

    使用读取到的版本进行 If-Match 校验。版本冲突返回 409;重新读取、合并意图后再写入,避免静默覆盖并发修改。

  4. 04

    人审阅与继续协作

    在编辑器中核对修改,按需创建版本快照或回滚。版本校验解决并发覆盖问题,内容是否正确仍需要审阅。

四种入口

从交互式 Agent 到自动化工作流

MCP 服务

让支持 MCP 的 Agent 使用 Doco 工具读取和维护文档。Claude Code、Cursor 等客户端共享同一套文档契约。

选择你的 MCP 客户端

CLI

在终端或脚本中登录、搜索和编辑文档。适合把文档维护放进已有的开发与自动化流程。

查看 CLI 与通道

Agent Skill

为 Agent 提供 Doco 的使用约定与工作步骤,帮助它按正确顺序读取、校验和更新文档。

查看 Skill 安装方式

REST API

用 OpenAPI 3.1 描述的接口构建自定义集成。通过 Bearer Token 和权限范围控制访问,支持块级读写与批量事务。

查阅 REST API

协作场景

让文档留在工作流里

Agent 长期记忆

把值得保留的背景、决策与经验写成可读文档。人能够修正和整理,后续 Agent 可以重新读取并引用。

了解可审阅的 Agent 记忆

团队 Wiki 与项目文档

人负责知识判断与审阅,Agent 协助维护说明、汇总进展和更新执行手册。团队共同读取和编辑同一份知识。

了解人机共同维护的 Wiki

个人知识库

把笔记、资料与草稿放在可编辑的知识库中。按需授权 Agent 整理内容,用 Markdown 导出保留迁移能力。

了解 Agent 协助整理知识

选择与边界

通用文档层,开放的工作方式

Doco 提供编辑、存储、协同和读写接口;Agent 的推理、模型与任务编排由你选择的客户端或系统负责。搜索和知识维护能力以当前 API 为准,不等同于任意外部数据源的 RAG 服务。

  • 版本校验能发现并发修改,不能证明 Agent 生成的内容正确。需要写入时,再授予相应权限。
  • 浏览器本地状态支持离线编辑;Agent API 读写与跨端同步需要网络和服务端连接。
  • 编辑器开源,自托管范围与 SaaS 服务区别见仓库说明;Markdown 和知识库 ZIP 导出提供开放的迁移路径。
比较不同文档工具

常见问题

把协作方式说明白

01Doco 和聊天里的 AI 文档有什么区别?

聊天可以产生草稿,Doco 提供可长期维护的共享文档。人直接编辑,外部 Agent 通过受授权的接口读取和修改,更新进入同一份在线文档。

02必须使用某个模型或某个 Agent 吗?

不需要。支持 MCP 的客户端可以接入 Doco MCP 服务;自定义程序可以使用 CLI 或 REST API。接入指南列出了已提供配置示例的客户端。

03可以把 Doco 作为自己产品的文档基础设施吗?

可以通过开放 API 将文档与知识库读写接入你的产品或工作流。先核对认证、权限、限流与部署条件;具体接口以 API 文档为准。

04数据如何迁移到其他工具?

文档可以导出 Markdown,知识库和文件夹可打包为 ZIP;打包时支持导出附件与重写图片相对路径。特殊富文本节点在其他工具中的展示能力可能不同。