开发记录：Nuxt应用公共层与共享能力治理重构

这篇开发记录用于复盘 M5-16 的背景、目标、执行过程和最终结果。

为什么在 M5-16 补 Nuxt应用公共层与共享能力治理

前面的案例已经覆盖了页面、基础组件、SSR、Nuxt 页面数据、状态管理、复杂交互、认证权限、路由壳层、错误隔离、异步加载、Nuxt 运行时边界、Nuxt 响应策略、Nuxt 执行时机、Nuxt 依赖边界、Nuxt 页面编排边界、Nuxt 接口边界、Nuxt 模块组织边界，但在真实 Nuxt 项目里，还有一条会持续穿透这些内容的主线：即使 feature 已经分出来了，如果应用公共层没有被严格治理，业务私有实现仍然会不断重新上浮到全局。

只要这条链路没有收口，前面任何一类场景都会逐渐出现问题：

• 公共 composable、公共组件和公共 store 越来越多，但稳定共享协议越来越少
• 业务桥接层被误放到全局，导致公共 API 越来越抽象
• 自动导入和应用公共入口让 feature 私有实现重新变得隐式
• 共享能力一旦上浮就很难回收，公共层逐渐变成历史负担

所以 M5-16 选择 Nuxt 应用公共层与共享能力治理，是为了把“应用基础设施、稳定共享协议、feature 私有桥接、提升标准与回收机制”这一条非常常见的横向架构线补齐。

这轮做了什么

这轮主要完成了这些事情：

• 新增 Nuxt 应用公共层与共享能力治理案例文档
• 新增 M5-16 任务拆解文档
• 新增 M5-16 详细设计文档
• 更新里程碑、入口、导航与统一框架
• 将 Nuxt 公共层治理型案例正式纳入当前方法库

这轮最重要的决策

决策一：先讲共享协议，再讲“抽公共”动作

这轮没有把重点放在“哪些代码可以抽成公共”，而是放在：

• 哪些能力已经形成稳定共享协议
• 哪些能力仍然只是模块内部桥接，不该提前上浮
• 为什么公共层必须允许回收，而不是只进不出
• 为什么共享能力应该先经过真实复用验证

决策二：选模块组织、自动导入和页面编排案例共同作为素材来源

这组素材非常适合作为案例来源，因为它刚好覆盖了：

• feature 私有实现和应用公共层的暴露边界
• 页面业务编排与共享协议的协同方式
• 自动导入和公共入口对隐式依赖的放大作用
• 长期项目里伪复用能力的常见来源

它很适合作为“从业务模块治理，走向共享能力治理”的过渡案例。

决策三：把提升和回收设计成双向路径

这轮没有把公共层继续视作“最终归宿”，而是把重点放在：

• feature 内部能力如何逐步验证复用价值
• 共享协议如何稳定后再上浮到应用层
• 伪复用能力如何允许降级回模块内部

这样新案例就能直接挂到当前已经形成的统一框架里。

本轮自测怎么做

这轮仍然只修改文档，因此自测继续聚焦文档完整性：

• 检查新增 Markdown 文件是否生成成功
• 检查本地链接是否全部可解析
• 检查入口页、导航图和总框架是否已经接入新案例
• 检查 M5-16 的任务拆解、详细设计和开发记录是否齐全

本轮结果

M5-16 完成后，当前方法库已经不只覆盖状态、渲染、交互、认证、路由、容错、异步加载、运行时边界、响应策略、执行时机、依赖组织、页面编排、接口治理和模块组织问题，也开始覆盖 Nuxt 项目长期演进时的一条基础主线：应用公共层收口、稳定共享协议治理、伪复用回收与共享能力升级路径。

这意味着后续如果继续扩展：

• 大型管理端项目的共享协议治理
• 设计系统层与业务桥接层的边界控制
• 自动导入暴露面与公共层回收机制协同
• 全局 store、公共 composable 和组件库的瘦身治理
• Nuxt 项目级应用公共层架构治理

都已经有了稳定挂载点。