日期:2026-11-02。按用户要求,将原 docs 根目录的 33 份主题文档实际移到分类文件夹,并新增 Web3 小白入门章节。根目录只保留总 README;历史报告和 evidence 继续位于 docs/reports。
原位置与新位置#
迁移时同步了什么#
文档相对链接重新按新目录计算,包括指向源码、接口、goal 和报告的链接;根 README、goal 中的路径及手写源码注释同步更新。发布脚本使用新位置并保留所选文件的层级,仍只打包原有的六份链交易资料,不把本次文档整理当成一次发布。
历史报告只修改必要的 Markdown 跳转,事实正文、日期、失败记录与成绩不改。279 份原始证据文件不移动,迁移前后通过摘要比对;自动化脚本继续向原 evidence 位置写入。
没有在旧位置保留第二套正文,避免两份文档分叉。旧聊天中的文件链接或外部书签需按上表更新;归档日志中的旧路径属于历史记录,不批量改写。当前入口统一从分类 README 进入。
后续维护规则#
新增主题资料放对应文件夹并更新该目录 README;面向初学者的章节放 01-beginner,旧阶段设计放 07-history,实际执行报告按日期放 reports。修改路径同时核对 Markdown 跳转、源码注释、发布和测试脚本。时间线按真实日期记录,不用文件修改时间替代执行日期。
本轮只调整教学说明和文档路径;业务源码只同步注释引用,未改变接口、合约或数据库规则。验证范围是本地链接/目录覆盖、原始证据摘要、历史报告正文、源码引用差异和发布脚本语法/文件复制,不以此声称业务重新验收通过。
本轮检查结果#
本地文档链接、代码围栏、分类入口覆盖与 33 份文档迁移检查通过;12 份历史报告去除链接目标后与迁移前逐字一致,279 份原始证据摘要一致。现存业务源码的差异仅为文档路径引用。发布脚本 Bash 语法检查和六份所选文档的实际复制检查通过,未执行完整发布。
检查记录:文档与迁移核对 ↗、发布文档复制核对 ↗。这些是本轮文档整理证据,不替代原有业务测试报告。