echo-nexus/agent-ctx/7-full-stack-developer.md

Task 7: 角色属性系统（探索力/智慧/勇气/灵感）

Agent: full-stack-developer

完成状态: ✅ 全部完成

创建的文件

1. /home/z/my-project/src/lib/game/attributes.ts — 属性逻辑层（~330 行）
2. /home/z/my-project/src/components/game/AttributesPanel.tsx — 属性 UI 面板（~330 行）

修改的文件

1. /home/z/my-project/src/lib/game/types.ts — GameState 新增 attributes/attributeProgress/pendingAttrPoints
2. /home/z/my-project/src/lib/game/config.ts — INITIAL_STATE 补全新字段默认值
3. /home/z/my-project/src/lib/game/engine.ts — recomputeStats 聚合属性加成；performPrestige 发放属性点
4. /home/z/my-project/src/store/gameStore.ts — 新增 allocateAttribute/gainAttributeExp action；pulse/clickNode/autoDecodeTick/resolveCurrentNode/grantCruiseReward/tickTide/init 接入属性逻辑；旧存档兼容
5. /home/z/my-project/src/lib/game/achievements.ts — 新增 2 项属性成就
6. /home/z/my-project/src/app/page.tsx — 新增第 8 个「角色」标签页 + grid-cols-7→8 + 红点提示 + 统计面板新增属性行 + 版本号 v0.6→v0.7

关键实现细节

attributes.ts 逻辑层

• 类型系统：AttributeKey（4 个键）/ CharacterAttributes（0-100 数值）/ AttributeProgressEntry（exp + level）
• 加成公式：
  • 0-50 线性区：每点 +0.5% 加成（0..50 → 0..25%）
  • 50-100 递减区：每点 +0.2% 加成（50..100 → 25..35%）
  • 超过 100 仍按 100 计算加成（软上限）
• getAttributeBonus(attr) 单属性加成百分比
• getAllBonuses(attrs) 返回 12 个修饰器：探险力倍率/巡航速度/解码步数/洞见倍率/自动解码周期/探险生命/BOSS 胜率/巡航护盾/接触率/星潮触发/脉冲连击/产能加成
• levelUpCheck(progress) 自动跨多级升级，安全上限 200 次循环
• expRequiredForLevel(level) = 10 × level（最低 10）
• computePrestigeAttrPoints(ascensions) = ascensions × 2 + 1（飞升前次数计算）
• migrateAttributes(state) 旧存档兼容：补全缺失字段、夹紧越界值、同步 level 与 attributes

engine.ts 改造

• recomputeStats 末尾追加 getAllBonuses(state.attributes ?? {}) 聚合：
  • crystalsPerSec *= am.crystalsPerSecMult
  • insightMult += am.insightMultAdd
  • contactRateMult *= am.contactRateMult
  • decodeStepsBonus += am.decodeStepsBonus
• performPrestige：
  • 保留 attributes 数值（跨周目永久）
  • 清空 attributeProgress（新周目重新累积经验）
  • pendingAttrPoints += computePrestigeAttrPoints(ascensions) = ascensions × 2 + 1
• createInitialState：每次返回全新 attributes/attributeProgress 对象，避免引用共享

gameStore.ts 集成（核心）

• pulse：连击 ≥3 给灵感经验（expGain = 1 + floor(combo/2)）；脉冲威力乘以灵感连击加成
• clickNode 完成：给智慧经验（expGain = puzzle.tier × 2）
• autoDecodeTick：自动解码也给智慧经验 +1；自动解码周期受智慧 am.autoDecodeIntervalMult 影响
• startExpedition：探险力乘 am.expeditionPowerMult；探险生命加 am.expeditionHpBonus
• resolveCurrentNode：
  • BOSS 节点用包装 RNG 提升 +am.bossWinRateBonus 胜率（单次 rng 调用，B% 概率返回 0，其余返回 r-B 保持均匀分布）
  • 战斗胜利给勇气+探索力经验（中途战斗 +2/+1，BOSS 击破 +8/+6，探险胜利 +4）
• grantCruiseReward：按总奖励量缩放给探索力+勇气经验（expBase = max(2, totalReward/30)）
• tickTide：灵感 am.tideTriggerBonus 缩短星潮间隙（gap × (1 - bonus)），上限 30%
• doPrestige：performPrestige 后用 next.attributes 重算 stats
• allocateAttribute(attr, points=1)：分配属性点，同步 attributeProgress[attr].level
• gainAttributeExp(attr, amount)：通用经验获取（自动升级）
• init()：调用 migrateAttributes 补全旧存档字段，并传 attributes 到 syncStats
• 所有 syncStats 调用点（10+ 处）都补充 attributes: ... 参数

AttributesPanel.tsx UI

• 四维属性卡片网格（小屏 2×2，大屏 1×4）：
  • 图标（Compass/Brain/Swords/Sparkles）+ 中文名 + 英文名 + Lv.{value} badge
  • 数值 /100 + 加成百分比
  • 经验进度条（gradient + glow）+ "递减区"标记
  • 加成影响列表（3 条）
  • 「+分配」按钮（pendingAttrPoints > 0 时可点，hover scale 105）
• 顶部：标题 + 待分配点数 badge（pendingAttrPoints > 0 时 echo-pending-pulse 动画）
• 底部：总等级 + 总加成概览 + 12 个修饰器明细行
• 配色：4 色全息（emerald/fuchsia/amber/rose），辉光边框 + 顶角光晕装饰
• 完全响应式（2 列 → 4 列），overflow-y-auto + 自定义 scrollbar

page.tsx 集成

• 新增 User 图标导入
• 新增 pendingAttrPoints store selector
• TabsList: grid-cols-7 → grid-cols-8
• 新增第 8 个 TabsTrigger「角色」（value="attributes"），主题色用 emerald→fuchsia→rose 渐变
• pendingAttrPoints > 0 时显示 rose 红点
• 新增 TabsContent 渲染 AttributesPanel
• StatsPanel 新增 5 行属性行（探索力/智慧/勇气/灵感/待分配属性点）
• 版本号 v0.6 → v0.7

achievements.ts 新增

• ach_attr_total_50（四维觉醒）：四维属性总和 ≥ 50 → 产能+6%/洞见+6%
• ach_attr_max_100（维度精通）：任一属性 ≥ 100 → 产能+12%/洞见+10%

QA 验证结果

• ✅ bun run lint 零错误
• ✅ dev 服务器 HTTP 200
• ✅ 编译 < 250ms（177ms 实测）
• ✅ 7 标签页 + 巡航按钮完好保留，新增第 8 个「角色」标签页
• ✅ data-tut 锚点（tab-expedition/tab-tech/prestige-btn/crystal-orb/decode-panel）保留
• ✅ 色彩规范：严格 emerald/fuchsia/amber/rose 四色全息，零蓝色/靛色
• ✅ 旧存档兼容：migrateAttributes 补全 attributes/attributeProgress/pendingAttrPoints 字段
• ✅ 飞升后 pendingAttrPoints = ascensions × 2 + 1（飞升前次数）
• ✅ pulse/clickNode/resolveCurrentNode/grantCruiseReward/autoDecodeTick 均接入属性经验获取

注意事项

• BOSS 胜率 RNG 包装：仅在 boss 节点生效，单次 rng 调用保持均匀分布；+am.bossWinRateBonus 上限 +30%
• 灵感星潮触发：通过缩短 gap 间接提升触发频率（上限 30%）
• 属性加成与现有所有系统（技术树/蓝图/成就/星图/星潮）叠加，不冲突
• migrateAttributes 同步 attributeProgress[attr].level 与 attributes[attr] 数值，避免漂移