313 lines
27 KiB
Markdown
313 lines
27 KiB
Markdown
# ShareServer 实施进度
|
||
|
||
## 当前状态
|
||
|
||
ShareServer 包含 Web 控制台、可持久化的本地共享目录和真实模型网关。GoodBuddy 已能注册
|
||
设备、发布与撤销元数据，Web 能查看真实目录。模型网关支持 OpenAI 兼容上游的发现、映射与
|
||
Chat Completions 转发，以及 B1 加密凭据、访问 Key 和模型授权。B1 代码已实现、验收部分完成；
|
||
生产身份、组织隔离、设备控制连接、组织授权及任务路由仍未实现。
|
||
|
||
### 2026-10-07：前端真实目录完善
|
||
|
||
- `GoodBuddy 接入` 已接入本地共享 API，显示真实登记设备、登记时间、版本和关联发布数量；支持搜索、详情和跳转到该设备的共享内容。页面明确登记记录不代表在线、所有权或身份认证。
|
||
- `共享中心` 新增真实发布记录的撤销确认和刷新流程。撤销调用 `POST /api/v1/sharing/publications/:id/revoke`，保留服务端撤销记录，不提供能力执行、知识正文读取或下载。
|
||
- 其他规划页面改为按模块展示专属待接入边界和可用入口，不显示示例数据或不会生效的创建、审批、导出和配置操作。模型网关调用元数据仍从模型网关页面查看。
|
||
- 新增共享 API 请求封装，统一错误信息和请求取消处理。前端自动化测试覆盖设备目录、待接入边界、共享筛选和撤销入口；本轮尚未进行浏览器视觉验收。
|
||
- 顶部移除“技术预览 · 非生产服务”常驻文字；侧栏按业务重排为工作台、GoodBuddy 服务、共享资源、组织管理、运营与审计、系统和成员自助。各页面内部仍保留必要的实现边界说明。
|
||
- 工作台增加服务拓扑，读取真实设备、发布记录和模型网关配置，展示 GoodBuddy 设备、ShareServer 与外部模型上游的关系及数量。空数据仅显示零接入状态，不生成示例节点；当前尚未进行浏览器视觉验收。
|
||
|
||
### 2026-10-05：B1 实现与部分验收
|
||
|
||
- 上游表单接收真实 API Key，支持保留、替换和清除；AES-256-GCM 密文随配置保存，主密钥位于
|
||
数据目录外并单独备份。旧环境变量引用继续可读、可调用，前缀导入界面与 `/import-env` 已移除。
|
||
- 客户端模型列表和聊天要求 Bearer Key，Key 原文仅创建时返回，持久化 SHA-256 摘要。
|
||
授权绑定模型记录 UUID，修改别名不改变范围；审计关联 Key ID，不将其名称当作用户身份。
|
||
管理与旧目录 API 校验实际回环 socket，并拒绝转发头；Vite `/api` 也只允许回环来源。
|
||
容器／反向代理管理尚不支持，等待 B2 登录。
|
||
- 实现轮验证记录：103 项测试通过，`npm run typecheck`、`npm run lint`、前后端构建通过。
|
||
自动化覆盖不等于 GoodBuddy Desktop 或浏览器端到端验收。
|
||
- 实现轮真实供应商验证共 5 次上游请求：1 次模型发现；1 次非流式请求使用 16 Token 上限，
|
||
输出过短，未形成有效结论；1 次 SSE 请求成功，包含 reasoning 内容和 Token 用量；1 次非流式
|
||
请求使用 1024 Token 上限并成功；1 次工具选择返回有效调用参数并在本地执行。工具结果未再次
|
||
发送给上游，因此未完成完整工具往返。
|
||
- 实际 API 验证确认重启后配置与访问 Key 保留，撤销后拒绝调用；存储含加密凭据而无明文秘密。
|
||
上述真实验证由实现轮提供，本次文档同步没有新增供应商请求或读取环境秘密。
|
||
- 浏览器已读取独立服务的网关页快照，确认空目录、访问密钥和客户端设置区域；点击被工具判定为超出视口，截图超时，未完成交互与视觉验收。独立服务已停止，默认数据未改动。
|
||
- 本轮没有验证 GoodBuddy Desktop。B1 剩余验收包括从空存储经浏览器配置、刷新
|
||
与重启，Desktop 连接测试和真实 SSE 会话，完整工具结果回传、用户停止时上游取消，以及真实
|
||
环境下超时、流中断、错误主密钥、内网 HTTP 和部署来源限制。后端基础设计第 4.5 节继续保留完整
|
||
清单；历史浏览器和旧网关结果不追溯成为 B1 验收。
|
||
- 文档同步轮重新运行 `npm test`，9 个文件、103 项测试通过；lint、含类型检查的前后端构建
|
||
通过。已阅读 deai-writing 并扫描相关文档，阻断项为 0；本次修改段落的字段枚举和验收限制
|
||
按技术含义保留，未借审校改写历史记录。`git diff --check` 通过，仅编辑 README 与文档。
|
||
|
||
以下按原日期保留历史记录，其中“当前”“本轮”均指对应日期的实现，不描述 2026-10-05 的状态。
|
||
|
||
### 2026-10-04：基于 GoodBuddy 源码的后端基础设计
|
||
|
||
- 新增[后端基础设计](./backend-foundation-design.md)，核对模型 profile、协议 URL、Main 凭据保存、
|
||
设备共享 HTTP、资源发布字段、统一知识检索入口和 Office 设计状态。按实际客户端契约安排 B1 至 B6。
|
||
- 首个实施单元为正常模型网关接入：密钥录入与服务端保存、开放模型、独立访问 Key、手工配置
|
||
GoodBuddy 和真实对话验证。自动组织模型导入、身份权限、资源绑定、知识检索及文档归属另列依赖。
|
||
- 修正功能入口、PRD、逻辑和技术文档中仍将模拟页面描述为当前实现的段落；保留历史验证记录。
|
||
新接口与凭据方案标记待实现，未把当前无认证网关描述成已有访问 Key。
|
||
- 本轮仅改 ShareServer 文档，未修改 GoodBuddy 或服务代码，未读取环境秘密、启动服务或调用模型。
|
||
相邻仓库链接目标及新增章节锚点已核对，`git diff --check` 通过。新增设计的 deai-writing 扫描
|
||
为 0 个阻断项；复核项涉及字段枚举和实施边界，按技术含义保留。未运行业务测试或进行运行时验收。
|
||
|
||
### 2026-10-02：移除界面模拟数据
|
||
|
||
- 控制台不再加载原型快照，移除虚构身份、组织、统计数量、活动以及模拟操作。
|
||
概览改为服务入口，共享中心直接读取本地目录；未接入模块保留菜单并显示待实现说明。
|
||
- 模型网关及共享目录继续使用真实 API，保留加载、空状态、失败重试和筛选。
|
||
未删除本地持久化数据，未改动 GoodBuddy 仓库。旧原型源码及接口未在本轮删除，已退出控制台路由。
|
||
- `npm test`：7 个文件、87 项测试通过；类型检查、lint 和前后端构建通过。
|
||
浏览器访问本地开发地址返回 `Request blocked`，本轮未完成视觉复查。
|
||
|
||
### 2026-10-01：本地模型网关与真实上游联调
|
||
|
||
- `/model-gateway` 改为真实 API 页面，移除网关样例上游、模型和模拟调用。新增配置持久化、
|
||
环境引用导入、模型发现、映射编辑与启停、网页请求测试及调用元数据。配置下发移除虚构模型、
|
||
用户组与设备回执，改为待接入说明；文档及其他示例模块仍保留明确的演示边界。
|
||
- API 支持模型列表、非流式 JSON 和流式 SSE 转发，透传工具调用数据和上游用量，不执行工具。
|
||
具体路径、资源限制和存储契约见[技术设计第 4.2 节](./technical-design.md#42-本地模型网关契约已实现)。
|
||
凭据只引用服务端环境变量，`scripts/dev.mjs` 支持显式 `--env-file`，加载值仅传给 API 子进程。
|
||
- 测试使用 `../goodbuddy/.env.deepseek.local`，经用户授权加载；未修改 GoodBuddy 仓库。
|
||
在独立端口 8792 和临时数据目录完成联调，保留原有 8787／5174 开发服务及项目数据。
|
||
浏览器从空目录导入配置，发现接口返回 2 个模型，包含已配置模型 `deepseek-flash`。
|
||
- 网页非流式请求返回预期内容，上游报告输入 41、输出 26 Token；另一条 SSE 请求收到 `[DONE]`
|
||
和预期内容，用量为输入 37、输出 20 Token。停用映射后请求返回 403，错误请求 ID 与审计一致，
|
||
被拒请求的未知用量未计为零。真实工具调用与 GoodBuddy 桌面端模型调用未在本轮验收。
|
||
- Playwright／Edge 验证模型发现、网页请求、停用与启用、刷新后保留配置并清除测试正文；
|
||
1440px 和 390px 的深浅主题未见横向溢出或页面脚本错误，并复核截图。重启独立 API 后，
|
||
1 个上游、1 个模型和 3 条审计与重启前一致；持久化文件不含测试凭据、提示词或响应正文。
|
||
独立测试服务已停止，测试配置未导入项目默认数据目录。
|
||
- `npm test`：7 个文件、77 项测试通过；`npm run lint`、`npm run build`（含类型检查）通过。
|
||
测试覆盖坏存储、上游错误、超限、流中断、超时、取消、审计写入失败和前端失败重试。
|
||
设计文档已按真实接口更新并使用 deai-writing 复核；历史演示验证记录保留原有时间与范围。
|
||
|
||
### 2026-10-01：本地仓库同步与开发入口
|
||
|
||
- 已逐项核对本地未提交代码和未跟踪源码：另一台机器提交的 `c9d5e63` 已包含这些功能与测试，
|
||
代码差异仅为目录迁移后的引用和构建输出路径调整；`9fa8f3e` 进一步补充 Office 私有部署设计。
|
||
- 按用户要求将本地 `main` 对齐 `origin/main` 的 `9fa8f3e`，清理旧路径重复源码，未产生合并提交。
|
||
同步后工作区干净；本地数据、依赖和忽略文件保留，GoodBuddy 仓库单独处理，本轮未操作。
|
||
- 本地开发在仓库根目录运行 `npm run dev`，入口为 `scripts/dev.mjs`，同时启动 `dev:api` 与
|
||
`dev:web`。API 使用 Node watch，前端使用 Vite 热更新；默认 Web 地址为 `http://127.0.0.1:5174`，
|
||
GoodBuddy 连接 API 地址 `http://127.0.0.1:8787`，Web 的 `/api` 请求代理到该端口。
|
||
- 首次安装依赖用 `npm ci`，终端按 `Ctrl+C` 停止开发服务。开发时先停止占用同一 API 端口或
|
||
数据目录的旧预览／容器实例；共享记录默认保存在 `data/sharing.json`。
|
||
- 本轮核对 Git 差异与启动配置，未重新启动服务或运行测试、构建。
|
||
|
||
### 2026-10-01：Office 私有部署第一阶段设计
|
||
|
||
- 本轮仅更新文档：PRD 限定可信私有网络的 DOCX 浏览器往返范围，逻辑设计定义编辑轮次与保存
|
||
状态，UI 设计补充真实试验入口，技术设计集中维护容器、地址、JWT、回调和本地文件提交契约。
|
||
- 明确本阶段不以身份源、组织数据库、S3/MinIO 或独立 callback worker 为依赖；完整组织权限、
|
||
Desktop／Agent 和三格式能力仍属后续目标，不能从私有试验推定用户授权或组织隔离。
|
||
- 当前 Compose 仍只有 ShareServer，使用宿主 `data/` bind mount，无 named volumes。
|
||
`docker/compose.office.yaml` 仅为拟议路径，镜像 edition／固定版本及协议兼容性待核验。
|
||
- 未修改代码、容器或配置，未启动 ONLYOFFICE，也未验证真实上传、编辑、callback 或保存。
|
||
`git diff --check` 通过，已复核新增内部引用及阶段约束，并查阅官方 JWT／callback 文档；
|
||
未选定镜像版本，运行与端到端验证需在实现后完成。
|
||
|
||
### 2026-10-01：Web 与服务端目录整理
|
||
|
||
- Web 源码与测试迁至 `web/src/`，HTML、Vite 和 Web TypeScript 配置置于 `web/`；
|
||
Hono 源码与测试迁至 `server/src/`，服务端配置置于 `server/tsconfig.json`。根 `shared/` 保留。
|
||
- 根目录统一管理依赖、脚本、Vitest、ESLint 与 TypeScript 项目引用，未新增依赖或 workspace。
|
||
构建产物为 `dist/web/` 和 `dist/server/`，启动入口为 `dist/server/server/src/index.js`。
|
||
- 根 Node v24.16.0 环境下，`npm test` 的 5 个文件、51 个测试通过；`npm run typecheck`、
|
||
`npm run lint`、`npm run build` 和 `git diff --check` 通过。
|
||
- `docker compose -f docker/compose.yaml build` 与
|
||
`docker compose -f docker/compose.yaml up -d --wait --wait-timeout 60` 通过，现有服务重建后健康。
|
||
HTTP 验证覆盖首页、JS/CSS 资源、共享中心路由回退、health、ready 和本地元数据读取。
|
||
- Compose 的 `../data` 保持不变，实际挂载为仓库根 `data/` 到 `/app/data`；重启前后
|
||
`sharing.json` 的 SHA-256 一致。Vite 开发服务验证前端模块、根共享模块及 API 代理可访问。
|
||
- 本轮未做浏览器视觉验收。Docker 安装时完整依赖集报告 4 项 audit 问题，运行时依赖报告 0 项；
|
||
本轮未调整依赖版本。原型与本地元数据服务边界不变，readiness 仍报告 `productionReady: false`。
|
||
|
||
### 2026-10-01：本地目录与 GoodBuddy 联调
|
||
|
||
- 新增五个本地共享 HTTP 接口，覆盖设备注册和查询、发布查询和创建、撤销。JSON 文件保存真实
|
||
记录，重启后仍可查询；API 的输入限制、错误与部署范围见技术设计第 4.1 节。
|
||
- GoodBuddy 应用中心新增设备共享入口，通过生产页面、preload、可信 IPC 与 Main HTTP 服务
|
||
操作本地目录，持久化服务配置和本机 ID。两仓分别构建，没有源码跨仓依赖。
|
||
- Web 共享中心新增“本地服务目录”，提供真实设备与发布记录、组合筛选、错误重试和刷新；
|
||
既有组织示例保留。注册时间不解释为在线状态，来源及知识权限按声明显示。
|
||
- ShareServer `npm test`：5 个文件、51 个测试通过；`npm run typecheck`、`npm run lint`、
|
||
`npm run build` 和 `git diff --check` 通过。服务测试包含真实 HTTP 和独立进程重启持久化。
|
||
- Web 使用隔离临时数据及真实 API 完成发布、撤销、筛选、重载、刷新和空目录验证；注入 503 后
|
||
重试通过。Edge/Playwright 检查 1440px 桌面和 390px 手机深浅主题，无横向溢出或脚本错误。
|
||
- GoodBuddy 真实 Electron 组件组合联调通过，覆盖应用中心入口、注册、知识独立权限、发布、
|
||
撤销、刷新、设备 ID 重读及 480px 深浅主题。未验收完整生产 App、安装包或跨平台原生窗口。
|
||
定向检查与全仓测试差异见[桌面验证记录](../../../../goodbuddy/docs/features/device-sharing/progress.md#2026-10-01桌面实现轮次的独立验证)：
|
||
全仓测试曾有两项失败，修正配置样例及单独复跑后通过，未将全仓结果记为一次全绿。
|
||
|
||
本轮完成本地元数据流程；设备认证、组织归属、能力执行、知识正文检索和同步、模型转发、
|
||
OnlyOffice 编辑与真实配置下发仍待实现。测试使用独立端口和临时目录，不修改既有服务数据。
|
||
本次中文文档经过 deai-writing 扫描，无阻断项；枚举、权限边界和历史验证限制按原义保留。
|
||
最终本地预览在 `http://127.0.0.1:8787` 启动，readiness 返回本地 JSON 元数据模式。
|
||
浏览器打开 `/capabilities?view=local` 正常读取空目录，显示 0 台设备和 0 项发布，未填入测试样例。
|
||
|
||
### 2026-09-30：共享中心交互原型
|
||
|
||
- 既有 `/capabilities` 扩展为共享中心，提供能力目录、共享知识库、按用户查看、按设备查看。
|
||
本地示例包含 3 项能力和 4 项知识，关联现有成员与设备；搜索、筛选、详情及主体定位由 URL 保存。
|
||
- 知识详情分别展示来源模式、可用性及搜索／读取原文／下载权限，覆盖离线服务器副本、离线
|
||
远程取用和仅元数据可见场景。内容操作均未接入，管理员身份不增加内容权限。
|
||
- `/devices` 详情可跳转对应设备共享视图，内容详情可跳转发布用户与提供设备。修复顶栏搜索
|
||
按钮在手机宽度下无法收缩造成的横向溢出，保留本轮之前的服务演示改动。
|
||
- `npm test` 通过 3 个文件、16 个用例，其中新增 7 个共享中心用例；`npm run lint`、
|
||
`npm run build` 通过，构建包含前后端类型检查。测试覆盖离线语义、独立权限、组合筛选与重置、
|
||
URL 恢复、用户／设备跳转、既有设备入口、键盘页签及无效详情链接。
|
||
- 构建后使用现有 8791 服务完成 HTTP 冒烟和 Edge 浏览器检查。1440×1000、390×844 的深浅
|
||
主题均无页面横向溢出，详情在视口内；设备详情到共享设备、知识详情及发布用户的跳转通过，
|
||
无页面脚本错误。截图复核了桌面深色列表、手机浅色列表和手机深色详情；现有服务保持运行。
|
||
- 中文文档经 deai-writing 扫描与本次修改范围复核；无阻断项，字段枚举和权限限制按原义保留。
|
||
当前没有新增内容 API、真实同步、内容检索、读取、下载或生产授权，也未进行真实设备集成验证。
|
||
|
||
### 2026-09-30：GoodBuddy 服务联动演示
|
||
|
||
- 新增模型网关、文档与协作、配置下发三个管理员页面，并在导航和概览中集中展示入口。
|
||
模型网关只转发其他模型服务，不提供模型托管或推理。
|
||
- 网关演示支持添加上游、启停、模型映射、用户组策略和模拟调用审计。停用上游或限制用户组
|
||
后，相应模型无法用于配置发布。
|
||
- 文档演示支持本人将个人文档转交组织、删除至回收站、恢复，以及 OnlyOffice 实例配置与
|
||
预设健康检查。转交后个人删除权失效，组织文档删除与恢复依赖显式模拟角色；不展示个人正文。
|
||
- 配置演示支持草稿、按组发布、在线设备模拟生效、离线待下发和回退版本及默认模型。
|
||
三页共享内存状态，跨页导航保留，刷新重置；没有真实转发、文件存储、Office 编辑或客户端下发。
|
||
- 修复既有列表页切换路由时沿用上一页数据分类的问题。前端测试显式清理组件，避免测试间
|
||
留存的对话框和路由影响后续用例。
|
||
- `npm test` 通过 2 个文件、9 个用例；类型检查、lint 和前后端生产构建通过。
|
||
新增用例覆盖跨页数据、网关停用阻止发布、离线等待、版本与模型回退、归属与删除权限、
|
||
回收恢复、拒绝审计和成员菜单范围。
|
||
- 构建服务在回环地址通过浏览器加载验证；实际操作验证了文档转交和 OnlyOffice 模拟检查，
|
||
截图复核了折叠导航布局及深浅主题。尚未完成指定桌面／手机尺寸的完整视觉回归，
|
||
也未进行真实 GoodBuddy、上游模型或 OnlyOffice 集成测试。
|
||
|
||
### 2026-09-09：Office 编辑目标设计
|
||
|
||
- PRD 新增 `FR-14`，将 ONLYOFFICE Docs、编辑会话、工作副本、保存检查点和 callback 定义为
|
||
ShareServer 可选托管能力。
|
||
- 功能逻辑明确服务端 checkpoint 不等于 Desktop 源文件已保存，并定义单用途凭据、会话状态、
|
||
callback 幂等、冲突结果和保留规则。
|
||
- 技术设计增加 Office 模块、API audience、数据模型、对象存储、部署依赖、编辑器插件、安全
|
||
边界和三平台集成测试要求；管理界面设计增加 Office 健康、策略和会话管理。
|
||
- 这些变更只有设计文档，没有修改当前 Hono/React 原型。仓库仍未集成 ONLYOFFICE、对象存储、
|
||
callback、Office API 或 GoodBuddy Desktop 文档 Tab，不能视为功能实现。
|
||
|
||
### 2026-09-06：独立仓库迁移
|
||
|
||
- 源码、测试、锁文件、构建及容器配置从 GoodBuddy 的 `shareserver/` 移至
|
||
`goodbuddy-shareserver` 仓库根目录，六份功能文档随迁，保留原型行为不变。
|
||
- 跨端共享网络总体设计保留在 GoodBuddy 仓库。双向文档链接采用同级克隆布局，
|
||
服务安装、测试、构建和运行不依赖桌面端仓库。
|
||
- 原桌面工作区的依赖和构建产物未搬动或删除；其测试/lint 排除项保留以避开这些本地产物。
|
||
- 新仓库执行 `npm ci`、`npm test`（2 个文件、5 个测试）、`npm run typecheck`、
|
||
`npm run lint` 和 `npm run build` 全部通过。安装报告 1 个 low 级依赖漏洞，
|
||
未在本次迁移中升级依赖。
|
||
- 构建后的独立服务在回环地址通过健康、就绪、快照、无持久化操作确认、SPA 回退和
|
||
JS/CSS 静态资源 HTTP 冒烟验证，随后停止测试进程；未重跑浏览器交互或容器运行测试。
|
||
- 31 个非 README 源码/配置文件与来源提交逐字节一致，35 个相对 Markdown 链接均可解析。
|
||
- GoodBuddy 桌面仓库 `npm test`、`npm run typecheck`、`npm run lint` 全部通过；
|
||
首次全量验证达到 200 秒超时后，延长时限重跑通过。
|
||
- 历史来源记录于根 README。此次迁移不代表生产功能、Desktop 集成或容器运行已验收。
|
||
|
||
### 2026-09-06：桌面发布与测试边界
|
||
|
||
ShareServer 功能尚未完成，不属于本次 Desktop `0.12.5` / Agent `0.11.19`
|
||
的产品交付或发布验收范围。用户确认本次发布不需要单独测试 ShareServer，
|
||
其原型测试通过也不代表生产功能已完成。以下记录对应拆仓前的发布操作。
|
||
|
||
桌面端根测试和 lint 配置排除 `shareserver/**`，桌面发布 CI 不为其单独安装测试依赖。
|
||
ShareServer 独立项目自身的测试配置保留，供后续功能开发使用；本次不运行其独立测试。
|
||
此前候选 `89a81dd` 临时加入的 `npm ci --prefix shareserver` 步骤已撤除。
|
||
|
||
ShareServer 的实现与验证在后续功能开发中单独推进；真实 Desktop 集成验收仍属于
|
||
下文的剩余生产工作。
|
||
|
||
## 已验证实现
|
||
|
||
### 2026-09-05：全控制台交互原型
|
||
|
||
- `shareserver/` 是独立 Node.js/TypeScript 项目，不依赖 Electron Main 或
|
||
`src/shared`。
|
||
- Hono 同源提供健康、就绪、原型快照和无持久化操作确认 API。
|
||
- 管理控制台覆盖概览、组织与成员、设备、能力目录、权限策略、审批、发布与更新、网关联邦、
|
||
任务与中继、审计和系统设置。
|
||
- 成员自助覆盖自己的设备、授权和申请；角色切换后导航和 URL 范围同步变化。
|
||
- 控制台支持深浅主题、组织范围、全局搜索、列表搜索、状态筛选、详情、表单、确认、成功/
|
||
失败反馈、响应式侧栏和键盘对话框。
|
||
- 构建后的 Web 由 Hono 同源托管；`docker/Dockerfile` 使用多阶段构建和非 root 运行用户。
|
||
- readiness 明确返回 `interactive-prototype` 与 `productionReady=false`，避免把 fixture
|
||
误认为生产服务。
|
||
|
||
验证证据：
|
||
|
||
```text
|
||
cd shareserver
|
||
npm test # 2 files, 5 tests passed
|
||
npm run lint # passed
|
||
npm run build # typecheck + Vite Web + server TypeScript passed
|
||
```
|
||
|
||
浏览器实际验收：
|
||
|
||
- 生产构建在 `http://127.0.0.1:8787` 启动并成功加载 API 快照。
|
||
- 宽屏管理员概览、审批详情、批准确认和原型 API 提交流程通过。
|
||
- `390 × 844` 成员自助页面、筛选区和列表布局通过。
|
||
- 深色与浅色审批页的 WCAG 2 A/AA 自动检查均为 0 个确定违规；半透明侧栏被检查器列为
|
||
需人工判断项，已通过实际截图复核文字可读性。
|
||
- 仓库级 `npm test` 通过 325 个测试文件、3501 个测试，另有 8 个文件和 55 个测试按既有
|
||
条件跳过；仓库级 `npm run typecheck` 与 `npm run lint` 通过。
|
||
|
||
## 剩余生产工作
|
||
|
||
按技术设计从以下纵向切片开始，不能把原型 fixture 逐步演变为权威状态：
|
||
|
||
以下顺序用于组织生产服务；Office 私有部署第一阶段可按技术设计第 10.1 节独立推进，不等同于第 7 项交付。
|
||
|
||
1. FR-1 一次性初始化、本地管理员身份、Web session 和 CSRF。
|
||
2. PostgreSQL migration、实例/组织/成员表、强制 organization repository 作用域和事务审计。
|
||
3. 真实组织与成员管理 API，再将对应原型页面切换到权威数据。
|
||
4. 设备挑战注册、凭据和出站 WebSocket 连接。
|
||
5. Publication、目录、拒绝优先策略、审批和任务路由。
|
||
6. Package、可选中继、联邦、保留、导出、备份恢复和真实 Desktop 端到端验证。
|
||
7. `FR-14` Office 会话、所选持久存储、ONLYOFFICE、callback、checkpoint、策略、管理界面和三平台
|
||
Desktop 文档 Tab 端到端验证。
|
||
8. `FR-15` 至 `FR-18` 本地空间共享关联、资料定期／按需同步、实时消息、显式处理请求和共享来源授权；
|
||
对照用户故事完成服务端契约与 Desktop 集成，不能把静态 demo 当作真实消息服务。
|
||
|
||
当前尚未满足 PRD 的组织产品验收；本地元数据范围的真实 Desktop/ShareServer 联调记录见上文。
|
||
|
||
2026-09-05 PRD `FR-13` 新增组织数字人发布和 `@数字人` 调用。当前交互原型尚无“数字人”
|
||
目录、发布管理、提及选择器或 Agent 记忆边界展示，因此这些能力仍属于剩余生产与原型工作，
|
||
不能由现有通用能力目录或原型操作确认替代。
|
||
2026-09-09 PRD `FR-14` 新增 Office 编辑服务；当前原型同样没有对应导航、配置或服务端路径。
|
||
|
||
## 2026-09-28：客户端协作 US 与逻辑审查
|
||
|
||
- 新增 `user-stories.md`，补充本地工作空间、组织共享、同步、成员消息、分身处理和来源授权的
|
||
验收场景。PRD 新增 FR-15 至 FR-18，逻辑设计补充分离的共享、同步、交付与处理状态。
|
||
- 修订 `@数字人` 与 `@成员` 的范围，保留直接能力调用，同时定义发给成员后由本人或已授权
|
||
分身处理的流程。补充本人确认优先、草稿可见范围和接手时的并发检查。
|
||
- `docs/demo/client` 已有个人共享、设置及组织工作空间的本地交互演示；只使用浏览器存储和
|
||
固定回复，没有身份校验、服务端持久化、同步或真实模型执行。本轮仅修改设计文档。
|
||
- demo 仍需按最新 US 调整：统一创建本地空间及共享属性，增加同步与撤销状态；回顾原文
|
||
阅读仍依赖回答授权，尚未覆盖 US 要求的“仅阅读”组合；空间分身尚未绑定真实 Publication。
|
||
- 默认同步周期、容量和保留期限待定；匿名分享仍为概念演示，不纳入首期已登录组织协作验收。
|
||
|
||
### 同日补充：轻量 IM 与实时组件提案
|
||
|
||
- FR-16 区分实时消息与资料同步：普通消息、公开回复及处理状态实时更新，资料定期／按需同步。
|
||
暂停资料自动同步不停止消息收发、通知或断线补收。
|
||
- FR-17 区分提及和请求处理。`@成员` 只通知；显式选择处理人后才进入本人／分身处理流程。
|
||
新增 US-MSG-04，覆盖普通消息、线程、实时更新、确认丢失、离线补收和旧连接撤销。
|
||
- 技术设计记录 ShareServer + PostgreSQL + Centrifugo 为优先验证提案，并比较 Matrix、OpenIM
|
||
和 Socket.IO；没有确定组件或版本，没有安装依赖，也没有运行候选服务验证。
|
||
- 补充消息与 outbox 同事务、至少一次投递、数据库补收、草稿私有事件及权限撤销的设计要求。
|
||
这些是待实现契约，不是现有 API 或数据库能力。
|
||
- 本轮仅更新文档。静态 demo 仍要求选择接收人并自动进入处理流程，尚未支持普通消息、提及与
|
||
请求处理分离、真实实时推送及离线补收；需在后续原型迭代中对齐。
|