内容
# Takos Office
**Takos Office** 是 Takos 生态系统的生产力套件 — **在一个可自行托管的 worker 中提供文档、幻灯片和电子表格**，可在您自己的 Takos 工作区中运行，并通过单个 MCP 端点**与代理原生集成**。它取代了以前独立的 `takos-docs`、`takos-slide` 和 `takos-excel` 应用程序，这些应用程序现在已合并到这个应用程序中。
它是 Google Workspace / Microsoft 365 的自行托管、支持 AI 操作的替代方案，您拥有所有权。
## 布局
```
takos-office/
app/
docs/ 编辑器 SPA + Hono 路由（挂载在 /docs） — 前身为 takos-docs
slide/ 编辑器 SPA + Hono 路由（挂载在 /slide） — 前身为 takos-slide
sheet/ 编辑器 SPA + Hono 路由（挂载在 /sheet） — 前身为 takos-excel
shared/ 应用程序身份验证、MCP 工厂和 Takos 存储库的单一副本
server.ts 统一的 Hono worker（挂载三个编辑器 + /mcp + /healthz）
mcp.ts 统一的 MCP 服务器（在一个端点上提供 docs、slide、sheet 工具）
build-worker.ts 将三个 SPA 构建和 worker 捆绑到 dist/worker.js
site/ 独立的营销网站（office.takos.jp）
docs/ 路线图
outputs.tf 一个 OpenTofu 应用程序部署（“takos-office”）
```
## 运行时契约
Takos Office 发布用户面向的办公界面，并使用对象存储服务：
| 方向 | 服务标识 / 能力 |
| --------- | ----------------------------- |
| 发布 | `protocol.mcp.server` 在 `/mcp` |
| 发布 | `interface.ui.surface` 用于 `/docs`、`/slide`、`/sheet` |
| 发布 | `interface.file.handler` 用于 `.takosdoc`、`.takosslide`、`.takossheet` |
| 消费 | `storage.object` 通过 `OBJECT_STORAGE_API_URL`；承载者来自 `OBJECT_STORAGE_ACCESS_TOKEN` |
## 服务方式
一个 Cloudflare Worker，一个 Capsule 安装单元，三个编辑器界面：
| URL | 界面 |
| ---------- | ---------------------------------------- |
| `/` | 办公壳（跨编辑器导航、最近的项目、跨应用程序搜索） |
| `/docs` | 文档编辑器（`.takosdoc`） |
| `/slide` | 演示文稿编辑器（`.takosslide`） |
| `/sheet` | 电子表格编辑器（`.takossheet`） |
| `/api/office/{items,search}` | 跨应用程序最近 / 搜索提供给壳 |
| `/mcp` | 统一的 MCP（约 80 个 `docs_*`/`slide_*`/`sheet_*` 工具） |
| `/healthz` | 就绪探测 |
每个编辑器 SPA 都使用自己的 vite `base`（`/docs/`、`/slide/`、`/sheet/`）和 SolidJS 路由器基数构建，因此资产和路由在子路径下解析。存储保留对象存储 HTTP API（文件夹 `/takos-docs/`、`/takos-slide/`、`/takos-excel/`），不变。
## 构建
```sh
bun install
bun run build # 3 vite 构建（build:spa）+ 统一的 worker（build:worker）→ dist/worker.js
bun run check # tsc --noEmit
bun test # 编辑器测试在 app/*/src/__tests__ 下
```
在本地使用 `bun run start` 运行（需要 `OBJECT_STORAGE_API_URL`、`OBJECT_STORAGE_ACCESS_TOKEN`、`TAKOS_SPACE_ID`、`MCP_AUTH_TOKEN`）。
## 边界
Takos Office 是**一个**可安装的 Capsule 应用程序（`jp.takos.office`）。它可以从商店或 Git 安装链接显式添加，并作为一个整体删除。三个编辑器不再独立可安装 — 它们是此应用程序的界面。它仍然可替换：作为“office”授予的架构特权不高于 Takos 核心。参见 [`AGENTS.md`](AGENTS.md)、[`docs/roadmap.md`](docs/roadmap.md)和生态系统 [`AGENTS.md`]( ../../AGENTS.md)。
前独立仓库（`takos-apps/takos-docs`、`takos-apps/takos-slide`、`takos-apps/takos-excel`）已退休；它们的历史存在于自己的 git 远程仓库中。
## 网站部署
参见 [`site/DEPLOY.md`](site/DEPLOY.md)。
