|
| 1 | +# 墨染江湖项目夜间实施方案 |
| 2 | + |
| 3 | +> 生成时间:2026-04-30 23:00 |
| 4 | +> 项目:墨色江湖:无尽武林 |
| 5 | +
|
| 6 | +--- |
| 7 | + |
| 8 | +## 一、项目现状总览 |
| 9 | + |
| 10 | +### 1.1 Git 状态 |
| 11 | +- 分支:main(与 origin/main 同步) |
| 12 | +- 最新提交:`8ddfa01` feat: 添加 R2 CDN 配置支持与跨时代移动设备方案文档 |
| 13 | + |
| 14 | +### 1.2 待处理变更 |
| 15 | +- 无工作树变更 |
| 16 | + |
| 17 | +### 1.3 构建状态 |
| 18 | +- ✅ `npm run build` — 通过(8.65s) |
| 19 | +- ⚠️ `npm run lint` — 通过但有 22 errors, 1108 warnings |
| 20 | + |
| 21 | +### 1.4 已完成任务追踪 |
| 22 | + |
| 23 | +| 任务 | 状态 | 备注 | |
| 24 | +|------|------|------| |
| 25 | +| Phase 0.1 (Vitest) | ✅ | | |
| 26 | +| Phase 0.4 (CI lint) | ✅ | | |
| 27 | +| Phase 0.5 (.backup) | ✅ | | |
| 28 | +| Phase 0.6 (Error Boundary) | ✅ | | |
| 29 | +| Phase 1.6 (storyResponseParser 去重) | ✅ | 消除内部重复代码 | |
| 30 | +| **本轮** | ✅ | R2 CDN 配置 + 文档 | |
| 31 | + |
| 32 | +--- |
| 33 | + |
| 34 | +## 二、Task 1.7 分析结论 |
| 35 | + |
| 36 | +### 2.1 现状 |
| 37 | +Task 1.7 原计划"提取跨文件重复工具函数到 `utils/stringNormalizers.ts`"。 |
| 38 | + |
| 39 | +### 2.2 分析结果 |
| 40 | +经核查: |
| 41 | +- `storyResponseParser.ts` 内部重复函数(计算括号平衡、清理命令尾部分隔符等)已在 **Task 1.6** 中消除 |
| 42 | +- `apiConfig.ts`、`githubSync.ts`、`systemPromptBuilder.ts` 中的"归一化"函数均为**领域相关**函数,非直接重复 |
| 43 | + - `apiConfig.ts`: 规范化 API 配置参数(temperature、maxTokens 等) |
| 44 | + - `githubSync.ts`: 规范化仓库名、路径段 |
| 45 | + - `systemPromptBuilder.ts`: 规范化游戏文本(地点、建筑名匹配) |
| 46 | +- 各文件内的工具函数规模较小,提取收益不明显 |
| 47 | + |
| 48 | +### 2.3 建议 |
| 49 | +**跳过 Task 1.7**,转向 **Task 1.2(拆分 sendWorkflow)** 或 **Task 2.4(Vite chunk 优化)**,这两项有明确的重构目标和可衡量的收益。 |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +## 三、推荐下一批次任务 |
| 54 | + |
| 55 | +### 3.1 Task 1.2 — 拆分 sendWorkflow(推荐优先) |
| 56 | +**文件**: `hooks/useGame/sendWorkflow.ts` (1122 行) |
| 57 | + |
| 58 | +**拆分目标**: |
| 59 | +``` |
| 60 | +hooks/useGame/sendWorkflow/ |
| 61 | +├── index.ts # 主调度 (~200行) |
| 62 | +├── memoryRecallPhase.ts # 回忆检索阶段 (~250行) |
| 63 | +├── responseProcessingPhase.ts # 响应处理阶段 (~350行) |
| 64 | +└── independentStages.ts # 独立阶段调度 (~300行) |
| 65 | +``` |
| 66 | + |
| 67 | +**收益**: |
| 68 | +- 单文件 1122 行 → 最大子文件 350 行 |
| 69 | +- 改善可维护性和可测试性 |
| 70 | + |
| 71 | +### 3.2 Task 2.4 — Vite Chunk 分割优化 |
| 72 | +**文件**: `vite.config.ts` |
| 73 | + |
| 74 | +**当前问题**: |
| 75 | +- `vendor` chunk 3614 KB(巨大) |
| 76 | +- `game-runtime` chunk 885 KB |
| 77 | +- `prompts-runtime` chunk 590 KB |
| 78 | + |
| 79 | +**优化目标**: |
| 80 | +- 将 AI SDK 按提供商独立拆分 |
| 81 | +- 将 react 核心独立拆分 |
| 82 | +- 预计减少首屏加载体积 15-20% |
| 83 | + |
| 84 | +--- |
| 85 | + |
| 86 | +## 四、本轮执行记录 |
| 87 | + |
| 88 | +| 时间 | 操作 | 结果 | |
| 89 | +|------|------|------| |
| 90 | +| 23:00 | git status + log 分析 | ✅ 完成 | |
| 91 | +| 23:02 | PLANS.md + TASK_TRACKER.md 分析 | ✅ 完成 | |
| 92 | +| 23:04 | npm run build | ✅ 通过 8.65s | |
| 93 | +| 23:05 | npm run lint | ⚠️ 22 errors, 1108 warnings | |
| 94 | +| 23:06 | 分析 Task 1.7 可行性 | 结论:跳过,收益低 | |
| 95 | +| 23:08 | R2 CDN 变更 git commit + push | ✅ 完成 | |
| 96 | +| 23:10 | InsiteWebsite 分析 | ✅ 工作树干净 | |
| 97 | +| 23:12 | 生成文档 | ✅ | |
| 98 | + |
| 99 | +--- |
| 100 | + |
| 101 | +## 五、墨染江湖项目进度总览 |
| 102 | + |
| 103 | +| 阶段 | 任务 | 状态 | |
| 104 | +|------|------|------| |
| 105 | +| Phase 0 | 基础设施加固 | ✅ 完成 | |
| 106 | +| Phase 1 | 代码质量重构 | 进行中(1.6 ✅, 1.7 跳过) | |
| 107 | +| Phase 2 | 性能优化 | 待启动 | |
| 108 | +| Phase 3 | 测试覆盖 | 待启动 | |
| 109 | +| Phase 4 | 功能增强 | 待启动 | |
| 110 | +| Phase 5 | 长尾优化 | 待启动 | |
| 111 | + |
| 112 | +**下一任务推荐**: Task 1.2(拆分 sendWorkflow)或 Task 2.4(Vite chunk 优化) |
| 113 | + |
| 114 | +--- |
| 115 | + |
| 116 | +*本文件由 Hermes Router Agent 自动生成* |
0 commit comments