2.3 KiB
2.3 KiB
dcalc Agent Guide
本仓库前端迁移主线是将 frontend 迁移到 frontendNew。
Scope
- 主线目录：frontendNew
- 对照目录：frontend（仅用于行为对照，不作为新实现落点）
- 本仓库优先维护 Dcalc Character 模块：equipment、skill、forge、result
Runbook
- frontendNew 开发：
cd frontendNew && pnpm install && pnpm dev - frontendNew 质量检查：
pnpm type-check && pnpm lint && pnpm build - backend 开发：
cd backend && uv sync && python main.py
Non-Negotiables
- 不要改动 /calc 的 API 契约与 IResult 数据结构。
- 不要打破配置链路：config 变化 -> result.execute -> saveConfig。
- 不要为了 UI 重构而改写 Skill/Forge 的核心业务逻辑。
- 优先复用 frontendNew 现有 shadcn-vue 组件，不引入新的 UI 框架。
Frontend Migration Priorities
- P0：Skill 配置回写完整（VP/UP 约束与持久化一致）。
- P0：Forge 配置编辑完整（装备/誓约/时装/徽章联动计算）。
- P0：Result 完整展示（loading/error/empty/success 四态与伤害明细）。
- P1：响应式体验优化（桌面双栏，移动端结果抽屉）。
- P1：Tab 汇总（装备详情/结果、技能详情/结果切换）。
Design/Docs Entry
Key Code Entry
Implementation Bias
- 同页配置 + 结果展示优先。
- Skill/Forge 在交互上尽量小改，优先行为兼容。
- 新增交互优先使用低侵入方式：Tab、Sheet、折叠区。
- 文档遵循 link-not-embed：链接现有文档，不重复长文说明。