Docs：面向实时协作的开源协同文本编辑器（suitenumerique/docs）

项目定位

Docs（配图 1）是一个开源协同编辑器，帮助团队实时地共同撰写、组织与分享知识。官方将其描述为 Notion、Google Docs 一类工具的开源替代品，重点关注：

• 实时协作
• 干净、结构化的文档
• 知识组织
• 数据所有权与自托管

主要面向公共组织、公司和开放社区。

功能概览

**写作**

• 富文本与 Markdown 编辑
• 斜杠命令与块（block）系统
• 排版格式化
• 离线编辑
• 可选的 AI 写作助手（改写、摘要、翻译、修正错别字）

**协作**（配图 2 为实时协作演示）

• 实时光标与在线状态（presence）
• 评论与分享
• 细粒度访问控制

**知识管理**

• 子页面与层级结构
• 内容可搜索

**演示（Presentations）**

• 基于分隔符（ --- ）的简单结构
• 全屏选项
• PDF 导出
• 键盘导航
• 可从某个块开始演示
• 演示链接（配图 3 为幻灯片模式演示）

**导出/导入**

• 导入：.docx、.md
• 导出：.docx、.odt、.pdf

AI 功能

Docs 的 AI 功能是可选的，且与模型、网关无关（model agnostic、gateway agnostic）：既可以自建，也可以直接使用自己的 AI 服务商。配置只需一个 API key 和一个 URL。

• **V1：选中即替换（配图 4）**。简单的工作流：你的选区既是上下文也是给模型的指令，AI 的反馈替换你的选区，并针对 Docs 的格式做了优化。
• **V2：AI 工具栏、AI 光标（beta，配图 5）**。基于 BlockNote AI 集成，包含：选区处出现可输入提示词、接受、拒绝、迭代 AI 反馈的 AI 工具栏；一个像另一位协作者那样与文档交互的 AI 光标；以及在选区之上叠加使用文档上下文。

互操作性

Docs 提供资源服务器 API 和服务器到服务器（server to server）API，可实现丰富的集成。一个具体例子是 Meet 的会议转录（配图 6）：如果你运行了 Meet 实例，只需简单配置（DJANGO_SERVER_TO_SERVER_API_TOKENS），就可以把会议转录推送到 Docs，并授权给请求该内容的用户。

许可与 GPL 组件提示

本项目以 MIT 许可证发布（见 LICENSE）。官方说明：Docs 是公共驱动的倡议，选择该许可证是为了邀请私营部门使用、销售并为项目做出贡献。

**警告**：部分高级功能（例如“导出为 PDF”）依赖 BlockNote 的 XL 包，这些包以 GPL 授权，与 MIT 不兼容。可以使用以下方式在缺少这些包的条件下构建 Docs：

PUBLISH_AS_MIT=true

这会构建一个不含非 MIT 功能的 Docs 镜像。更多细节见环境变量说明。

技术栈

Docs 构建于 Django Rest Framework、Next.js、ProseMirror、BlockNote.js、HocusPocus 和 Yjs 之上。项目方是 BlockNote.js 与 Yjs 的赞助者。

生态与合作（配图 7）

Docs 是法国政府（DINUM）与德国政府（ZenDiS）共同领导的联合倡议成果，目前正在引入荷兰（荷兰 🇳🇱 正在 onboarding），并持续寻找新的公共合作伙伴。

参与贡献

项目由社区驱动，欢迎 PR。提供贡献指南、翻译入口与 Matrix 聊天渠道；公开路线图可查看即将推出的功能、优先级与长期方向。

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。