dellweb3's picture
Work OS validated demo local-v0.8 (part 2)
daa4d56 verified
|
Raw History Blame Contribute Delete
4.94 kB

Workspace Service · 可运行实现

本目录是系统设计文档的首版代码。它通过现有 API Gateway 的 13 个 Workspace 路由对外服务;事项、消息、附件、Skill 绑定、草稿历史、确认和 outbox 为真实持久化。Knowledge 已接持久化解析/检索;Identity、Context、LLM、Tool、Notification 仍为桩。已在 PC 本地 SQLite 模式运行并联调;PostgreSQL/腾讯云/麒麟海光尚未实测。

运行

先按相邻 APIGateway/README 安装 requirements.txt,然后执行:

cd D:\codex\direct\workosMvp\base1\APIGateway
.\run.ps1 -Port 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,从本目录执行:

$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、服务启动和全部验收。

检验

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 实现。