2.2 KiB
2.2 KiB
遵照您的指示,我将在迁移代码之前,先梳理并输出详细的需求文档和架构文档。
更新后的详细执行计划:
第一阶段:文档编写 (Documentation)
- 需求文档 (
documents/Requirement_Analysis.md):- 基于源码(
router.ts,types.ts等)深度解析现有功能。 - 详细列出功能模块:单词练习(多种模式)、文章练习(音频同步)、词典管理(本地/在线)、用户系统(VIP/同步)、快捷键系统等。
- 明确数据结构:Word, Article, Dict, User 等核心实体的定义。
- 基于源码(
- 架构文档 (
documents/System_Architecture.md):- 技术栈: Vue 3 -> Nuxt 4, Pinia, UnoCSS, IndexedDB。
- 目录结构: 详细对比
TypeWords和nuxt-tw的目录映射关系。 - 数据流: 描述前端与后端 (API)、本地存储 (IndexedDB) 的交互流程。
- 路由设计: 规划 Nuxt 的文件路由结构。
第二阶段:基础设施与依赖 (Infrastructure & Dependencies)
- 清理与配置:
- 移除
nuxt-tw中的临时文件和@nuxt/ui及其 Tailwind 依赖。 - 配置
nuxt.config.ts:移除 UI 模块,添加@unocss/nuxt。 - 创建
uno.config.ts。
- 移除
- 依赖安装:
- 安装核心依赖:
unocss,pinia,sass,idb-keyval,dayjs,lodash等。
- 安装核心依赖:
第三阶段:核心逻辑迁移 (Core Logic)
- 类型与工具: 迁移
types和utils/libs。 - 状态管理: 迁移
stores到 Nuxt Pinia 模块。 - Composables: 重构
hooks和apis为 Nuxt Composables。
第四阶段:资源与组件 (Assets & Components)
- 静态资源: 迁移
assets和public。 - 组件迁移: 迁移并适配所有 Vue 组件。
第五阶段:页面与路由 (Pages & Routing)
- 页面重构: 将 Vue Router 配置转换为
pages/目录结构。 - 元数据适配: 使用
definePageMeta和useHead。
第六阶段:验证 (Verification)
- 功能测试: 验证核心业务流程(登录、练习、词典加载)。
- 样式检查: 确保 UnoCSS 样式正确应用。
确认执行? 如果同意,我将首先生成两份文档,供您查阅和存档。