Spaces:
Sleeping
Sleeping
File size: 4,943 Bytes
daa4d56 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 | # Workspace Service · 可运行实现
本目录是[系统设计文档](../docs/11_Workspace_Service/README.md)的首版代码。它通过现有 API Gateway 的 13 个 Workspace 路由对外服务;事项、消息、附件、Skill 绑定、草稿历史、确认和 outbox 为真实持久化。Knowledge 已接持久化解析/检索;Identity、Context、LLM、Tool、Notification 仍为桩。**已在 PC 本地 SQLite 模式运行并联调;PostgreSQL/腾讯云/麒麟海光尚未实测。**
## 运行
先按相邻 [APIGateway/README](../APIGateway/README.md) 安装 `requirements.txt`,然后执行:
```powershell
cd D:\codex\direct\workosMvp\base1\APIGateway
.\run.ps1 -Port 8771
```
浏览器打开 [http://127.0.0.1:8771/](http://127.0.0.1:8771/);接口文档在 `/docs`。默认数据库及附件保存在 `D:\codex\outputs\workos-workspace`;这符合本机生成数据放 `D:\codex\outputs` 的约定。可设置:
| 环境变量 | 用途 |
|---|---|
| `WORKOS_WORKSPACE_DATA_DIR` | 默认 SQLite 和文件根目录;默认 `D:\codex\outputs\workos-workspace` |
| `WORKOS_WORKSPACE_DB_URL` | 数据库 URL;设置 `postgresql+psycopg://...` 可用 PostgreSQL |
| `WORKOS_WORKSPACE_FILE_ROOT` | 独立附件根目录;不从客户端传入物理路径 |
| `WORKOS_WORKSPACE_AUTO_SCHEMA` | 演示默认 `1`:缺表时创建;正式迁移设 `0` 并运行 Alembic |
| `WORKOS_TEST_TMP` | 自动化测试临时目录,默认 `D:\codex\cache\workos-workspace-tests` |
默认身份为 `lin/zhou` 两个演示账号。每人有一个唯一 Home 和自己的事项。重启后 Workspace 数据仍在;桩模块的登录会话、Skill 目录中的个人自建 Skill、工具/通知回执仍会清空。因此重启后能继续查看事项、消息、附件和草稿,Runtime 已持久化并能恢复正常节点或等待确认的任务。`/health/ready` 会把 Workspace 标为 `sqlite-persistent` 或 `postgresql-persistent`,Runtime 为 sql-persistent,其余模块保持 `fixture`,整体状态 `degraded`。
## PostgreSQL 与迁移
在空数据库上设置 `WORKOS_WORKSPACE_DB_URL`,从本目录执行:
```powershell
$env:WORKOS_WORKSPACE_DB_URL = 'postgresql+psycopg://user:password@host:5432/workos'
$env:WORKOS_WORKSPACE_AUTO_SCHEMA = '0'
D:\codex\cache\workos-apigateway-venv\Scripts\python.exe -m alembic -c alembic.ini upgrade head
```
请勿把示例数据库密码写进仓库。`migrations/versions/0001_initial_workspace_schema.py` 是冻结的首版迁移;本机已验证全新 SQLite 库升级到 head,`alembic check` 无模型漂移。PostgreSQL 连接路径已实现但本机没有服务器,不能声称 PostgreSQL 实测通过。已由自动建表启动过的演示 SQLite 库没有 Alembic 版本记录;后续正式迁移应从空库执行迁移并导入数据,或先核对 schema 后手动 stamp,不能直接重复执行初始建表。
## 已实现的边界
- **WS01**:个人空间唯一、事项 CRUD 中的创建/列表/读取/重命名,双用户隔离,Skill ID/版本绑定,幂等创建。
- **WS02**:用户消息与内部助手消息持久化、顺序分页、幂等。Runtime 使用真实消息输入。
- **WS03**:10 MiB/5 件限制,类型/内容初检,随机逻辑键和 SHA-256,授权下载,上传失败清理。Knowledge 经 outbox 实际解析并存储片段后标为 `ready`;失败为 `failed`,错误码见知识文档状态接口。
- **WS04**:草稿不可变版本、乐观锁、历史内容读取、当前版 hash 人工确认;Runtime 和 Tool 桩只使用对应版本。工具仍只返回演示回执,不生成 DOCX。
- **事件**:事项、消息、附件、草稿操作同 DB 事务写 outbox;当前演示用进程内 dispatcher 仅投递 `document.ingest.requested` 给 Knowledge Service;其它事件留在 outbox 待后续 broker 适配器发布。投递失败保留待重试,尚未接 RabbitMQ/Kafka。
- **部署**:PC SQLite 模式为当前已验证环境。PostgreSQL 驱动和 Alembic 迁移可用于下一阶段;麒麟/海光需在目标机重测 native wheel、服务启动和全部验收。
## 检验
```powershell
cd D:\codex\direct\workosMvp\base1\WorkspaceService
D:\codex\cache\workos-apigateway-venv\Scripts\python.exe -m unittest discover -s tests -v
```
另外在 Gateway 运行时执行 `tests/smoke_live.py`、`tests/contract_surface.py`、`tests/browser_live.py`。本次结果:4 个 Workspace 合同测试、35 项 HTTP/SSE 检查、37 个公共 PC 操作覆盖、Edge 浏览器链路通过;同一数据库重启后事项可读、B 访问 A 的事项返回 404。测试数据使用合成内容。
新增 `ws_runtime_binding` 为事项绑定发布工作流与知识库范围;管理员通过 Gateway 配置,Runtime 开始时读取。0002 迁移包含该表及 ar_ 系列表;见 [Runtime 实现](../AgentRuntime/README.md)。
|