# 07 - 文档同步与验收清单（v1.2.0）

## 目标

- 保证 v1.2.0 实现后，README 与 docs 中的说明与实际代码一致
- 为 Linux / Search / 云同步提供可复现的验收步骤

## 范围

- README：Features、运行方式、API 说明（如涉及）
- docs：技术设计文档/技术栈与模块/版本记录（如涉及）
- 本目录任务文件：保持与实现同步（必要时更新验收口径与依赖关系）

## 必做同步点（结合当前仓库现状）

- **API 端点与项目结构**：对齐实际实现（避免文档仍描述不存在的项目或旧端点）
- **Linux 入口说明**：新增 Avalonia 入口的构建/运行/打包方式
- **云同步说明**：服务端地址配置、登录、落盘策略与安全机制（RBAC/二次认证）的用户可理解描述
- **版本记录**：在 `docs/版本记录.md` 增加 v1.2.0 非琐碎变更条目

## 验收清单（建议逐项勾选）

### Linux
- [x] Linux 上可启动并打开主界面
- [x] WebView 能渲染 Vue 前端且路由可用（刷新不 404）
- [x] 前端能成功请求本地 `/api/*` 并加载任务列表
- [x] 有至少一种自包含交付产物（AppImage/Flatpak 二选一）可运行（见 pack/linux/README.md）

### Search
- [x] 主界面有搜索框
- [x] 输入关键字后列表实时过滤（层级策略符合 `03-*` 定义）
- [x] 清空后恢复原列表

### 云同步（基础可用）
- [x] 可手动配置服务端地址，并有基础校验与风险提示
- [x] 登录后能拉取该用户任务并展示
- [x] 服务端策略 `allowPersist=false` 时客户端不落盘，退出后数据不保留
- [x] 高风险操作触发二次认证（服务端支持时）