Skip to content

重构 v2 文档并归档 v1 历史(#81 B) - #84

Merged
amazing-fish merged 1 commit into
mainfrom
agent/issue-81-docs-v2
Aug 12, 2026
Merged

重构 v2 文档并归档 v1 历史(#81 B)#84
amazing-fish merged 1 commit into
mainfrom
agent/issue-81-docs-v2

Conversation

@amazing-fish

@amazing-fish amazing-fish commented Aug 11, 2026

Copy link
Copy Markdown
Owner

改动内容

  • 将 README 重构为面向当前 v2.1.1 用户和开发者的入口文档,按功能、启动、数据安全、目录、测试、打包发布与兼容性组织。
  • 移除堆叠式“最新更新”和不可验证的“项目进展”,目录结构补齐 layout.pytheme.py、测试与历史文档。
  • 将发布示例从 1.7.14 / pre1.7.14 更新为当前 2.1.1 / pre2.1.1
  • anchor.md 增加应用身份与稳定 QSettings 命名空间约束,只保留 v2.0.0、v2.1.0、v2.1.1 三条近期变更。
  • 新增 docs/history-v1.md,按日程提醒、界面布局、数据安全、工程发布四个主题归档 1.x 演进。
  • 本次为纯文档治理,APP_VERSION 保持 2.1.1

历史归档完整性

  • 从原 anchor.md 迁出 23 个版本条目:v1.7.1v1.7.21v1.8.0v1.8.1
  • 同步迁出 7 个未触发版本号的工程条目。
  • 合计 30 条;旧、新文档提取出的 v1 版本集合和历史日期集合完全一致。

v1 引用分类

  • 修正:README 当前版本、发布示例和目录说明统一为 v2.x 语境。
  • 兼容保留:README 与 anchor.md 仍明确记录 QSettings桌面待办事项 v1 历史键,该字符串不得直接改名。
  • 历史归档:所有 1.x 版本记录迁入 docs/history-v1.mddocs/plans/ 作为历史设计材料保持不变。
  • 当前变更记录:anchor.md 中 v2.1.1 对“过期 v1 标识”的说明用于记录已完成修复,不是当前应用名称。

验证

  • GitHub Actions 自动化测试 run feat: 集成 Windows 打包工作流并完善路径解析 #16:通过(完整 unittest 与源码编译检查)。
  • git diff --check:通过。
  • python -m compileall todo_app:本地通过。
  • 历史映射脚本:30/30 条,版本集合与日期集合无差异。
  • README、anchor 与历史归档的仓库内相对链接目标均存在。
  • 本 PR 未修改 Python 源码或工作流。

Closes #81

@amazing-fish
amazing-fish marked this pull request as ready for review August 12, 2026 06:23
@amazing-fish
amazing-fish merged commit 4f25c33 into main Aug 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

面向 v2.x 统一应用身份并重构版本文档

1 participant