AgileLabs 文档迁移说明
本页记录 agilelabs.docs 迁移到 agilelabs.mkdocs 的边界、默认决策和结果。迁移目标不是复刻 Docusaurus 站点，而是建立面向开发者和 AI Agent 的长期文档系统。
迁移来源
- 原始文档源：
agilelabs.docs/docs - 目标仓库：
agilelabs.mkdocs - 服务仓库：
/agilelabs与/agilelabs.aspnet
已迁移内容
- 框架介绍、起步、门户、升级说明。
- 原理类文档：
fundamentals/、workcontexts/、activity/ - 特性类文档：
features/、data-access/、automapper/、biz-design-patterns/ - 类库参考：
acl/ - 工程实践：
tutorial/、testing/、logging/、topics/utility/、releases/
排除项
tutorial-basics/tutorial-extras/postgresql/redis/blog/i18n/- 所有
_category_.json - 仅为 Docusaurus 生效的 frontmatter 字段
迁移规则
- 所有站内链接统一改成真实存在的相对
.md路径。 - 目录型主题补
README.md作为稳定入口页。 - 删除
slug、sidebar_position、sidebar_label、generated-index等 Docusaurus 噪音。 - 旧文档中缺失或不可用的页面，在迁移时补成可维护的 Markdown 页面。
当前结果
agilelabs.mkdocs已具备首页、导航页、AI Agent 约定页和各主题目录首页。- 文档结构以长期维护和 MkDocs 发布为目标，不再依赖 Docusaurus sidebar。
- 后续新增文档时，应优先延续当前的目录入口、相对链接和导航约定。