Spaces:
Sleeping
Download WorkspaceService/README.md from dellweb3/workos-office: direct link, hf CLI and curl.
- Browser
- Download file 4.94 kB
-
https://huggingface.co/spaces/dellweb3/workos-office/resolve/main/WorkspaceService/README.md
- Command line
-
hf download hf://spaces/dellweb3/workos-office/WorkspaceService/README.md
-
curl -L -o README.md https://huggingface.co/spaces/dellweb3/workos-office/resolve/main/WorkspaceService/README.md
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 实现。