Duobox 教程

从本地 Space、文档与 Chat 入门，再按需配置协作、扩展和服务端。

Duobox 是一个面向文档、代码仓库、上下文和 AI Agent 的本地优先工作区。内容保存在你选择的普通文件夹中；可以从个人项目开始，再按需配置模型、扩展能力或团队协作。

按你的角色开始

独立使用 App

加入团队协作

了解账户与登录；
按照协作快速开始选择 Organization；
理解 Organization 与权限的角色和权限；
学习 Remote Space 与同步。

部署协作服务

先阅读 Duobox Server，理解服务端职责；
根据环境选择使用 Dokploy 部署或使用 Dokploy Compose 部署；
遇到登录、同步或服务端问题时查看协作与服务端故障排查。

定制与开发

从 Extensions 与 Skills了解两种扩展机制；
使用自定义模型连接本地或私有模型服务；
按照开发自定义插件创建 App 扩展；
通过 CLI 命令参考完成终端操作。

教程体系

开始使用：完成安装和模型设置，建立 Space，并走通第一次文档与 Chat 工作流。
核心工作流：覆盖文档、Chat、Shell、Agent、导入导出和 Cloud Page。
账户与定制：管理身份、模型、设置、Extensions 和 Skills。
团队协作：围绕 Organization、项目权限和 Remote Space 同步展开。
服务端部署：安装和运行 Duobox Server，并完成生产部署。
开发与参考：提供插件开发、CLI 和系统排障资料。

Duobox 的核心始终是本地 Space。Remote Space 在完整本地文件与 Git clone 之上增加 Organization 权限和同步；Downcity Federation 负责身份、Organization、Membership 与模型发现，Duobox Server 负责 Space、项目 ACL 和 Git 同步。