AIOffice

AI Office

浏览器访问的多租户办公套件 SaaS。文档 / 幻灯片 / 表格 / PDF / Markdown 五大编辑器 + 内置 AI 对话生成与编辑，编辑引擎全部在浏览器端运行，后端只做鉴权、存储、模型与搜索代理。

架构参考 genoffice 桌面版，弃用 ONLYOFFICE / OpenSandbox 沙箱 / 旧 office-op 桥。实施计划见 docs/plan.md，实现逻辑与 API 见 docs/architecture.md，部署运维见 docs/deploy.md。

界面预览

·

功能

• 5 个原生编辑器：文字（Tiptap + docx-engine）、演示（canvas + pptx-engine）、表格（Univer + Rust xlsx 引擎）、PDF（pdf.js + pdf-lib）、Markdown。
• AI 对话式生成：首页一句话生成整套文档/PPT/表格/思维导图，Agent（ReAct 循环）在浏览器内操作编辑器（块改写、插/改图表、插图、生成整套演示文稿）。
• 思维导图：Markdown 编辑器内置「大纲 / 导图 / 分屏」视图（Markmap 渲染），思维导图本质是 Markdown 大纲，AI 编辑与存储完全复用 Markdown 一套；首页选「思维导图」即一句话生成。
• 模型即插即用：后端 litellm 代理，10 家 provider（deepseek / claude / openai / google / 阿里 / siliconflow / modelscope / 豆包 / vllm / ollama）。
• 多租户：注册即建独立组织，数据强隔离；单写锁 + 只读分享 + 版本历史 + 配额限流。
• 原生文件格式：存储 .docx / .pptx / .xlsx 原文件，改动是窄 patch，版本可回溯。

技术栈

目录结构

├─ frontend/       # 前端 monorepo（apps/* + packages/*，@genoffice/* 保留内部名）
├─ backend/        # FastAPI 薄后端 + xlsx-engine（Rust sidecar 源码）
├─ e2e/            # Playwright 端到端测试
├─ k8s/            # k8s 骨架
├─ docs/           # 文档（architecture / deploy）
├─ start.sh        # 本地开发一键启动
├─ deploy.sh       # 生产 docker compose 部署
├─ docker-compose.yml
└─ docs/plan.md    # 移植实施计划

快速开始（开发模式）

前置：uv、Node ≥ 18。

cp .env.example .env    # 填 MODEL_PROVIDER/MODEL_NAME + <PROVIDER>_API_KEY，改 JWT_SECRET
./start.sh              # 后端 :8585 + 5 个前端 vite dev

启动后访问（需先在文档端注册/登录）：

注：slides/pdf/markdown/sheets 无独立登录，请先在文档端登录，再经 ?doc=/首页最近文件打开。表格本地开发需先构建 Rust sidecar：cd backend/xlsx-engine && cargo build --release（或设 XLSX_SIDECAR_BIN）。

生产部署

cp .env.example .env    # 填模型 key，**必须改 JWT_SECRET**（32+ 随机字节）
./deploy.sh             # docker compose up --build -d，健康检查后输出访问地址

或手动：docker compose up --build -d。访问 http://localhost/ （MinIO 控制台 :9001，aioffice / aioffice-secret）。

docker-compose.yml 组成：frontend(nginx :80，静态 SPA + API 反代 + SSE)、backend(:8585，内部)、postgres:16、minio + createbucket(一次性建桶)。生产 checklist、TLS、托管 PG/S3、水平扩展与 k8s 详见 docs/deploy.md。

配置（.env.example）

测试

cd backend && uv run pytest -q          # 36 passed / 2 skipped（sheets 需先构建 sidecar）
cd frontend && npm test                 # 各 app vitest
cd e2e && npm i && npx playwright install chromium
E2E_BASE_URL=http://localhost:8080 npx playwright test

e2e 分两类：api.spec / docs-ui.spec 确定性、不调模型；generate.spec（Word/PPT/思维导图/表格 一句话生成）走真实模型，慢且依赖 key。测试栈用 e2e/serve.py（stdlib 反代，镜像 nginx 路由）：先构建 5 个 SPA 到 /tmp/aioffice-web/html，起后端 :8585，再 python3 serve.py 8080——本机 Docker Desktop 不稳时用它代替 compose。

开发常见坑

• Clash 代理：shell 若设了 HTTP_PROXY=127.0.0.1:7890，curl localhost:XXXX 会 502。用 curl --noproxy '*'；vite dev 只监听 IPv6，用 http://[::1]:3585/。
• 端口占用：./kill.sh 一键清理 8585 / 3585-3589。

参与贡献

欢迎提交 issue、PR 或功能建议。

# fork 后本地起环境
cp .env.example .env && ./start.sh

# 改动后端：cd backend && uv run pytest -q
# 改动前端：cd frontend && npm test
# 端到端：见上方「测试」，用 e2e/serve.py 代替 docker compose

• 改动范围应贴合 docs/plan.md 的模块边界；本仓库奉行「最小可行」——新增抽象前先看现有代码是否有可复用的。
• 提交前请确保 tsc --noEmit / uv run pytest -q / npm test 通过；涉及 sheets 的测试先构建 Rust sidecar（见「快速开始」）。

License

如有任何问题，请联系我!

Apache-2.0。项目构建时参考了 genoffice 桌面版（Apache-2.0）。