Files
lab/ts/web/nextjs/polaris/docs/plans/2026-10-19-navigation-additions.md
T
labmem b72b14a818
Polaris CI / verify (push) Successful in 3m40s
Polaris CI / publish (push) Successful in 5m7s
feat(polaris): 新增三个导航网站并更新游戏资料图标
2026-10-19 11:35:53 +08:00

2.4 KiB

新增导航与游戏资料分类图标

范围与决定

  • 用户已明确要求执行;从干净的 main 新建 feat/polaris-navigation-additions 分支,不提交代码。
  • 新增 OpenRouter(AI 工具)、菜鸟教程(学习资料)、Lucide(设计资源),保持原有条目不变。
  • 新条目沿用现有数据结构,填写简短描述、关键词和分类内排序,不置顶;图标沿用既有 favicon 与首字母兜底,不新增依赖或资源。
  • 仅将游戏资料分类的 icon 改为 book-search,前端映射增加 Lucide 的 BookSearch,保留学习资料的 BookOpen。
  • 不调整布局、样式或其他分类图标。

执行顺序与责任

  1. 协调者创建分支并记录计划(已完成)。
  2. fixer 负责 src/data/links.json、src/data/categories.json、src/features/navigation/components/category-icon.tsx 及必要的局部回归测试;编辑前确认编码、缩进与换行,阅读适用的 Next.js 本地文档。
  3. fixer 运行数据与图标相关测试、类型检查、修改文件的 lint 和格式检查,报告证据;协调者复核最终差异和关键行为。

验证路径与预算

  • 新增导航:断言三个 ID/URL 唯一、分类正确、字段满足现有契约,现有条目不变。
  • 分类图标:断言游戏资料为 book-search 且渲染实际 BookSearch,学习资料仍为 book-open;类型检查确认当前 lucide-react 导出可用。
  • 工程检查:优先运行现有测试套件(若成本较低则全部)、pnpm typecheck、修改文件的 ESLint 与 Prettier 检查、git diff --check。
  • 不以外部站点的 favicon 网络可达性作为本次完成门槛;其失败沿用已有兜底机制。
  • 无框架/API/布局变更,不重复执行完整生产构建或截图验证,除非检查暴露相关风险。

状态

  • 实施完成,未提交代码。
  • fixer 验证:全量测试 17 个文件、117 个用例通过;类型检查、修改文件 ESLint 与 Prettier 检查通过。环境使用 corepack pnpm 执行项目命令。
  • 协调者复核:原有 51 条链接与 HEAD 完全一致,恰好新增 3 条;分类数据除游戏资料的 icon 外与 HEAD 完全一致;图标组件测试覆盖 BookSearch、BookOpen 与默认兜底;git diff --check 通过。
  • 外部 favicon 可达性未测试,不影响本次数据及图标映射变更结论。