自托管 · 需求协作 × 本机 AI 开发
需求在团队，
代码留在本机。
SuDuo 把团队共享的需求与讨论，接到每个人电脑上的 Codex。从一条需求直接开工，代码和会话留在本机；服务端部署在你们自己的服务器上。
把团队共享的需求与讨论接到每个人电脑上的 Codex。从需求直接开工，代码和会话留在本机。
客户端 macOS · Windows ｜ 服务端 Ubuntu / Linux
团队 · 需求
- 支付回调失败后自动重试
- 导出报表支持 CSV
本机 · Codex 会话
› 读取需求 REQ-128
› 编辑 src/payment/callback.ts
› 运行测试
✓ 测试全部通过
SuDuo 的三个特点
共享需求与讨论
需求、附件、项目房间放在团队服务器上，所有人看到的是同一份
从需求一键开工
在需求上直接拉起本机 Codex 会话，需求卡和查需求的工具随会话带入
部署在你们自己手里
服务端装在自己的服务器，代码仓库和个人会话不会传上去
工作原理
需求在服务器上，代码在你手里
团队服务器管需求和讨论，每个人的电脑管代码和 Codex。在一条需求上开工时，SuDuo 把它交接给你本机的会话。
团队服务器
你们自己部署
- 项目与需求
- 评论、附件与确认版
- 讨论房间与消息
- 账号与活动记录
每个人的电脑
运行 SuDuo 客户端
- 代码仓库
- Codex 会话与审批
- Codex 配置与模型凭据
- 项目对应的本机目录
Codex 直接请求
你配置的模型服务OpenAI 或兼容服务
代码仓库和个人会话不会上传到团队服务器，也不经过 SuDuo 的任何中心服务——SuDuo 本来就没有中心服务。Codex 干活时，会把它需要的上下文（包括读到的代码片段）直接发给你配置的模型服务。你把 Agent 共享进讨论房间时，它的回答和执行过程会发到房间里，可能包含代码。
了解工作原理和数据边界产品
需求、讨论、会话，在一个工作台里
下面是中文界面的实际截图，演示数据是虚构的。
需求详情：左边是描述、材料与确认版、讨论和活动记录；右边是状态、本机代码目录和本机会话，右上角是「开始会话」。
项目讨论：每个项目一个房间，支持 @ 提及、话题和文件；右上角的「共享 Agent」可以把你的 Codex 共享进来。
本机会话：从需求开工的会话和这条需求关联在一起；右侧面板列出 Codex 改动的文件，也可以随时查看需求。
平台
支持的平台
客户端在每个人的电脑上从源码运行，服务端用 Docker 部署在一台 Linux 服务器上。
客户端
- macOS 13.5 及以上（Apple 芯片 / Intel）
- Windows 10 / 11（x64）
需要 Node.js 24、pnpm 10.25 和 git。暂时没有安装包。
服务端
- Ubuntu 22.04 / 24.04
- 其他装有 Docker 的 Linux（尽力支持）
至少 2 核 CPU、4 GB 内存，装好 Docker（含 Compose）和 git。
- 模型：Codex 的 ChatGPT 登录，或 OpenAI / 兼容服务的 API Key。
- 在 macOS（Apple 芯片）和 Ubuntu 上测试得最多；Windows 和 Intel Mac 也支持，测试得少一些。
开始使用
三步部署服务端
每个团队只需部署一次。升级、备份和 HTTPS 的做法见部署指南。
准备一台 Linux 服务器
Ubuntu 22.04 / 24.04，装好 Docker（含 Compose）和 git，至少 2 核 CPU、4 GB 内存。
运行安装脚本
取最新的发布版本，在
cloud/目录运行sudo ./scripts/suduo-cloud.sh install；在国内加上--mirror cn。首次构建约 3–8 分钟。连上客户端
脚本会打印访问地址。每个人在 SuDuo 客户端的「设置 → 需求服务」里填入地址并注册，就可以从需求开工。
目前没有管理员和邀请机制，能访问到服务器的人都能注册。请只在内网或 VPN 内开放，或者放在带访问控制的反向代理后面。
在公司里用？
可以直接开始用，开始使用后 30 天内发一封邮件登记，目前登记免费。个人学习、研究和业余项目（且没有任何商业用途预期），以及学校、公共研究机构、公益组织和政府机构使用，免费且不用登记。