---
name: frontend-migration
applyTo: "frontendNew/src/pages/Dcalc/Character/**/*.vue,frontendNew/src/stores/**/*.ts,frontendNew/src/api/**/*.ts"
description: "Use when migrating frontend Character pages to frontendNew, preserving config->execute->save flow, keeping /calc and IResult contract stable, and implementing same-page config+result with minimal behavior changes for Skill/Forge."
---

# Frontend Migration Rules (frontend -> frontendNew)

## Core Target

- 迁移目标是行为保真，不是推倒重做。
- 结果必须保持：配置变化可触发计算，结果区稳定刷新，配置可持久化。

## Required Data Flow

- 保持以下链路成立：
  - config mutate
  - Character 容器 watch config
  - `result.execute()`
  - `saveConfig()`
- 不在 Skill/Forge 子页直接做并发调度或替代容器级触发策略。

## API/Type Contract

- 不修改 `/calc` 入参与返回结构。
- 不破坏 `IResult` 的关键字段语义：`skills`、`info`、`suits`、`buffer`。

## Skill/Forge Migration Constraints

- Skill、Forge 优先沿用现有业务逻辑与限制条件（例如 VP/UP 数量限制、等级限制）。
- 允许替换 UI 结构与组件，但不改核心规则语义。
- 新行为必须可追踪到 `pushChangeSource`，便于结果回溯。

## Result Panel Requirements

- 必须具备 4 态：loading、error、empty、success。
- 同页可查看结果，不依赖跳页。
- 允许以 Tab 汇总展示（如详情/结果切换），但不得导致计算链路断开。

## Source of Truth

- 迁移策略以以下文件为准：
  - [frontendNew Migration Plan](frontendNew/MIGRATION_PLAN.md)
  - [角色信息与结果链路专项分析](frontend-角色信息与计算结果展示链路-专项分析.md)
  - [装备技能打造交互与布局设计](frontend-装备技能打造-完整交互与布局设计文档.md)

## Existing Pattern to Reuse

- 优先参考已迁移页面模式：
  - [EquipmentDictionary](frontendNew/src/pages/Dcalc/Character/EquipmentDictionary/Index.vue)
  - [Character Container](frontendNew/src/pages/Dcalc/Character/Index.vue)
  - [Config Store](frontendNew/src/stores/config.ts)