# NexaOffice 十版本全面检查记录

版本：v2026.06.20.80  
日期：2026-06-20  
规则：每 10 个版本进行一次全面检查，并进行一次较大的优化和更新。

## 本次重点问题

本轮用户要求继续优化“版本隔离、网络服务器搭建准备等功能”。因此 v80 作为十版本里程碑，重点从登录页视觉微调转向产品架构稳定性：个人版 / 企业版登录后完全隔离、未来服务器上线前准备、网络 cutover dry-run 和部署契约。

## 主要优化

1. 个人版 / 企业版登录后隔离加强
   - 任务列表按当前模式过滤。
   - AI 新增任务自动写入当前模式 scope。
   - 全局搜索只搜索当前模式可见任务和文件。
   - Personal 模式不搜索企业员工和企业通知。
   - 切换 Personal / Enterprise 时同步 chat scope、企业通知和企业快捷入口。
   - Files / Cloud 内部不再允许跨模式切换查看另一套数据。

2. 网络服务器搭建准备
   - 新增服务端契约：`server_cutover_contract`。
   - 部署计划 dry-run 增加 `server_contract`。
   - server 目录新增/完善接口：
     - `POST /api/bootstrap`
     - `POST /api/sync/batch`
   - `server_config.template.json` 增加 client_contract、required_scopes、retry/backoff/cache 参数。
   - `docs/SERVER_DEPLOYMENT_CN.md` 补充上线流程、scope 隔离要求、部署前检查命令。

3. 新增守护检查
   - 新增 `tools/server_deployment_readiness_check.py`。
   - self_check 已纳入 Server Deployment Readiness。
   - network_deployment_plan_check 增加 server contract / bootstrap / batch endpoint 检查。
   - personal_enterprise_isolation_check 增加登录后 scope 过滤、Files/Cloud scope 锁定检查。

4. 联网前安全原则继续保留
   - 默认 local-first / offline-first。
   - 没有系统部署配置不联网。
   - Token 不显示、不写入报告。
   - HTTP 仅允许 localhost 测试。
   - 上线前必须先 dry-run。

## 全面检查项目

- Python 编译检查：通过
- 版本一致性检查：通过
- 登录适配检查：通过
- 登录布局保护检查：通过
- 个人版 / 企业版隔离检查：通过
- System server config：通过
- Network readiness：通过
- Network deployment plan guard：通过
- Server deployment readiness：通过
- Sync queue repair：通过
- Data integrity：通过
- Offline maintenance：通过
- Performance guard：通过
- Package cleanliness：通过
- Package structure：通过

## 后续规则

下一次十版本全面检查版本：v2026.06.20.90。  
后续继续优化时，优先保持：不要未经用户允许大改 logo / 主视觉；个人版和企业版不能互相看到数据；服务器部署继续只走系统托管配置。
