Files
Hua.Todo/docs/project/v1.2.0-tasks/07-文档同步与验收清单.md
2026-04-13 23:10:07 +08:00

1.7 KiB
Raw Permalink Blame History

07 - 文档同步与验收清单(v1.2.0)

目标

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

范围

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

必做同步点(结合当前仓库现状)

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

验收清单(建议逐项勾选)

Linux

  • Linux 上可启动并打开主界面
  • WebView 能渲染 Vue 前端且路由可用(刷新不 404)
  • 前端能成功请求本地 /api/* 并加载任务列表
  • 有至少一种自包含交付产物(AppImage/Flatpak 二选一)可运行(见 pack/linux/README.md
  • 主界面有搜索框
  • 输入关键字后列表实时过滤(层级策略符合 03-* 定义)
  • 清空后恢复原列表

云同步(基础可用)

  • 可手动配置服务端地址,并有基础校验与风险提示
  • 登录后能拉取该用户任务并展示
  • 服务端策略 allowPersist=false 时客户端不落盘,退出后数据不保留
  • 高风险操作触发二次认证(服务端支持时)