文档设计(刷新经济改版·用户裁四案): 刷新门槛按每轮预算一半设定、储备点改整局冒险保留(只有弃图刷新消耗)、条款⑤退役为行为说明并内嵌两条路 SVG、新增两件储能秘宝(每关开始+4 RAP／挖对·标中+1 RAP)。

落文: 行动经济 v1.7／秘宝 v1.3／奇物 v1.8／冒险结构 v1.6／术语表 v1.29／核心循环／教学引导／ux battle·interaction-patterns／clear_dominance_audit 头注(判式降为历史读数)。待办清单: QQ-04 整条删除、新条目登记并推进文档设计已闭合。
凭据: 流水线闸 PASS(36条目/57行/交叉核4链)、文档域闸【验收通过】无新增红、工具 py_compile 过。表值与新秘宝数据行留实现批。

design/ux/battle.md

@@ -67,7 +67,7 @@
 
 | Exit Destination | Trigger | Notes |
 |---|---|---|
-| 关卡画面（选路枢纽） | 敌方全灭（战斗结算判定段判胜）且非末节点 | 不可逆：战斗结束已发生，RAP 清零；落地奖励/恢复节点时开节点覆盖层确认（关卡画面域） |
+| 关卡画面（选路枢纽） | 敌方全灭（战斗结算判定段判胜）且非末节点 | 不可逆：战斗结束已发生，RAP 原样保留；落地奖励/恢复节点时开节点覆盖层确认（关卡画面域） |
 | 关卡结算 | Boss 战胜利 → 关卡完成（spec：[level-clear.md](level-clear.md)） | 不可逆：关卡收束无清库面——现行秘宝 = 营地同调装配、整局冒险生效（见秘宝.md）。旧关卡域库存 treasure_inventory 为投放渠道全退役后恒空的机械惰性承载，拆线待实装清理（见战斗结算「轮次生命周期」节注） |
 | 冒险落幕 | 主角 HP=0（判负） | 不可逆：Roguelike 死亡重开（art-bible §2.5 温柔惋惜调性） |
 | 无中途退出 | — | MVP 不设战斗内放弃/暂停菜单（回合制无时间压力；如需暂停留 Playtest 诊断按钮，调试用） |
@@ -202,7 +202,7 @@
 | C | 攻击数据框 | 直角细线数据框 | 攻击值 + 修正来源角标 + 护甲 AC（AC 二轮拍板 2026-09-26 补入——我方 AC 唯一展示面；HP 与状态归 B 区站桩、RAP 归 D 区右栏，不在本组件） | 只读 | HUD 视图拆分 |
 | C | 秘宝槽 | 图标槽 ×4 | 四槽壳在役、空槽占位（标题「秘宝」，悬停「秘宝槽（空）」）；局内两步使用与关卡域库存随秘宝过渡形态退役——现行秘宝 = 营地同调装配件（秘宝.md），本区展示重接归装配面 | 悬停 tooltip | 已实装 |
 | C | 奇物列表（现行标题「特性」） | 列表/图标行 | 已实装——逐件行「件名 ×N」呈现、零内部分类字样；锻造/大奖励/关卡奖励节点获得的属性提升——中循环数据，因改变战斗数学且无其他展示面准入战斗屏；与战斗内状态效果（B 区站桩）分区，防「战斗结束被清」误读 | 只读 | 已实装 |
-| D | 行动资源侧栏（原 AP 条） | 两侧点阵 + 按钮组 | 左栏：本轮 AP 点阵、停手按钮；右栏：**RAP 点阵+数字（RAP 唯一消费口 = 弃图刷新，资源数字贴消费按钮——2026-09-26 拍板；RAP 清零可见反馈〔行动经济〕）**、图例按钮、弃图刷新按钮（RAP−8 · 本轮剩 N 次，上限 2 次为行动经济口径）。2026-11-07 顶栏搬两侧——原顶部整条 AP 条退役，数据按左/右栏分置，D 区全高归棋盘 | 点击提交意图 | HUD 视图拆分改造 |
+| D | 行动资源侧栏（原 AP 条） | 两侧点阵 + 按钮组 | 左栏：本轮 AP 点阵、停手按钮；右栏：**RAP 点阵+数字（RAP 唯一消费口 = 弃图刷新，资源数字贴消费按钮——2026-09-26 拍板；RAP 冒险收束清零可见反馈〔行动经济〕）**、图例按钮、弃图刷新按钮（RAP−4 · 本轮剩 N 次，上限 2 次为行动经济口径）。2026-11-07 顶栏搬两侧——原顶部整条 AP 条退役，数据按左/右栏分置，D 区全高归棋盘 | 点击提交意图 | HUD 视图拆分改造 |
 | D | 棋盘地形层 | 合并岩体/连续地面 | 地面连续无缝；连通未开格（四邻）合并为抬升岩体（岩顶大板＋南/东崖面＋四段投影＋整板悬崖）；岩顶向北偏西抬升（LIFT/ESHIFT 比例见 art-bible §3.2）；三关八色见 art-bible §4.1「三关棋盘环境八色」；不铺逐格瓦片；深度对象按脚底 y 排序，南侧岩体可遮住小人脚底（2026-11-07 用户裁） | 只读 | 新建（替换 cell_base_layer/tile_palette） |
 | D | 棋盘浮空数字层 | 最顶层文字层 | 数字与格面字形（危/?）浮在格上方：字高 21px、2px 深墨描边、1px 浮空投影、暖白字芯、2px 双色引导线；字底阴影圆 10×6 画在开启格地面（格顶＋7，位于小人之下，小人站该格时遮住圆）；顶行数字越出棋盘上缘（D 区上方预留 44px）；数字与引导线 z 最高，任何地形/小人/特效不遮数字与引导线；封印格身份字形走色牌、不进浮空层；普通数字色牌退役 | 只读 | 新建 |
 | D | 棋盘视图 | 网格 | 棋盘全部格态 + 小人 + 封印印记 + 变异纹带 + 奖励身份 icon（已开格；信息层叠放序 浮空数字>小人>封印印记>奖励徽章/类型微光>交互反馈>变异纹带>地形底色——浮空数字永不被遮，徽章不进数字区；屏幕层序按脚底行分档：北侧贴花低于小人、南侧随岩体在前；封印印记与封印格身份色牌固定低于小人，样张验收项） | 左/右键意图提交 | 改造 |
@@ -219,7 +219,7 @@
 **布局决策 3 — 移动路径预览 = 合法性指示**（排雷玩法×6⑤ 悬案裁决）：悬停已开格时高亮 BFS 路径（小人蓝细线点迹），移动执行为 ≤150ms 短滑。
 - 备选（不采纳）：穿行动画轨道——移动免费高频，动画时间税违反 P4 点击摩擦护栏（每轮输入动作:AP ≤2 的观测假设）；正式版若 playtest 反馈"移动太瞬"再议
 
-**布局决策 4 — 弃图刷新 = 挖掘期当场换图（2026-09-12 用户拍板；2026-11-07 按钮位随顶栏搬两侧改到 D 区右栏）**：按钮置 D 区右栏（贴棋盘右缘）。点击即当轮就地换新图继续挖——AP 不重置、剩余 AP 保留，RAP−8，本轮上限 2 次。
+**布局决策 4 — 弃图刷新 = 挖掘期当场换图（2026-09-12 用户拍板；2026-11-07 按钮位随顶栏搬两侧改到 D 区右栏）**：按钮置 D 区右栏（贴棋盘右缘）。点击即当轮就地换新图继续挖——AP 不重置、剩余 AP 保留，RAP−4，本轮上限 2 次。
 - **上游修订（OQ11）**：① 行动经济 Active 相位受理刷新意图 + 每轮上限 2 次（Waiting 代理退役）② 排雷玩法装板受理域增 Active·仅刷新路径 ③ 编排 owner = **战斗结算的挖掘期刷新编排**（行动经济扣费 → 排雷玩法退役旧板 → 棋盘生成出新图 → 排雷玩法装板 → 地图战斗资源摇奖励恰一次；无结算段、无轮次结束——战斗结算编排唯一性原则保持）④ 旧板封印印记随旧板**作废**（零兑付、封印 AP 不返还——排雷玩法 EC11 全量重置承载；确认微交互须显式提示）。**经济预警**：当场刷新无结算发生，原「敌方时间税」自惩失效——行动经济 OQ3 弃图率/刷新率预警阈值联动复核。
 - 备选（已否决）：结算期决策提示（Waiting 内联）——结算期不做刷新决策（用户拍板）；挖掘期预承诺 stop+reroll 复合——决策即终轮，不符「换图继续挖」语义。
 
@@ -288,7 +288,7 @@
   <text x="944" y="76" font-size="15" fill="#CBE4FA">3</text>
   <rect x="852" y="100" width="100" height="34" rx="5" fill="#342B20" stroke="#60503A"/><text x="902" y="122" font-size="14" fill="#E8DCC8" text-anchor="middle">图例</text>
   <rect x="852" y="144" width="150" height="34" rx="5" fill="#342B20" stroke="#60503A"/><text x="927" y="166" font-size="14" fill="#E8DCC8" text-anchor="middle">弃图刷新</text>
-  <text x="852" y="198" font-size="12" fill="#9C8A6C">RAP−8 · 剩 2 次</text>
+  <text x="852" y="198" font-size="12" fill="#9C8A6C">RAP−4 · 剩 2 次</text>
 
   <rect x="200" y="0" width="636" height="548" fill="#221C15"/>
   <line x1="279" y1="44" x2="757" y2="44" stroke="#F2C14E" stroke-width="2" stroke-dasharray="6 4"/>
@@ -390,7 +390,7 @@
 | 未开格 | 封印 | 右键 | **受理即揭示**：墙格换已揭示地面 + 封印印记落下（封印黑）+ 格下身份揭显（危／数字，垫色牌） | 意图入批（1 AP / 免费；受理当场零兑付——兑付在轮末判定批） |
 | 已封印格（已揭示） | 无 | 左键/右键 | 禁止光标 + 悬停说明（封印格无可用动作） | 零意图（不入批——封印格拒绝挖掘、不可通行、不可再封印；封印印记无移除手段，封印不可逆） |
 | 停手按钮 | 主动结束轮次 | 左键 | 按钮下压 + AP→RAP 飞行数字 | 停手随当帧意图批次提交（**经排雷玩法批次，不直调行动经济**——单意图帧批次契约） |
-| 弃图刷新按钮（D 区右栏） | 当轮就地换图继续挖 | 左键 | 确认微交互（RAP−8 代价显式 + 旧板弃置提示）；RAP<8 → 资源面拒绝可见（行动经济 EC13） | 刷新意图提交（**Active 相位当场换图继续挖**——AP 不重置、本轮剩 N 次扣减；受理口径见布局决策 4/OQ11） |
+| 弃图刷新按钮（D 区右栏） | 当轮就地换图继续挖 | 左键 | 确认微交互（RAP−4 代价显式 + 旧板弃置提示）；RAP<4 → 资源面拒绝可见（行动经济 EC13） | 刷新意图提交（**Active 相位当场换图继续挖**——AP 不重置、本轮剩 N 次扣减；受理口径见布局决策 4/OQ11） |
 | 图例按钮 | 开图例 | 左键 | 模态 overlay | 恒可开（图例条目恒在） |
 | 状态小图标（B 区站桩） | 悬停 | hover | 状态 tooltip（来源+语义+剩余结算次数） | 只读 |
 | 胜利 overlay | 下一节点 | 左键 | → 关卡画面（选路枢纽）/ 关卡结算（末节点） | 关卡推进方推进 |
@@ -431,9 +431,9 @@
 | 挖掘→结算 | 明细带自底展开（150ms）+ 棋盘去饱和 + 金橙色相偏移 + 阶段指示翻转 | §2.2 色彩转金橙主导、饱和拉高、明度不变（状态区分经饱和/色相——art-bible §2） |
 | 结算逐行兑现 | 光带自棋盘行起点横扫 → 开格化箭雨/印记化暴击弹道飞向敌人立绘 → 受击闪白 + 血条直角递减 | §2.2 承载元素；因果全程可见可归因（P2） |
 | 清图换新图 | 金粒喷泉 3–5s → 旧图碎裂淡出 → 新图 install 淡入 | §2.3 短促丰收不拖节奏 |
-| RAP 清零（战斗结束） | RAP 数字滚动归零（D 区右栏）+ 「随战斗结束消散」微文案 | 行动经济可见反馈义务 |
+| RAP 清零（冒险收束） | RAP 数字滚动归零（D 区右栏）+「随冒险结束消散」微文案 | 行动经济可见反馈义务 |
 | 敌人死亡 | 血条直角递减至零 → 卡体灰化 + 碎裂退场（禁瞬消） | 敌人系统资产下限（同等 blocking）；动画密度归战斗表现 |
-| 状态图标行全清（战斗结束） | 状态逐枚化光收回（B 区站桩图标行）+ 「状态随战斗结束消散」微文案 | 增益状态×4④；RAP 清零同款先例 |
+| 状态图标行全清（战斗结束） | 状态逐枚化光收回（B 区站桩图标行）+ 「状态随战斗结束消散」微文案 | 增益状态×4④；RAP 不在本行清空（整局冒险保留） |
 | 胜利 | 蜡封自上落下弹跳定格 → 碎砖拼纹章 → overlay 暖金渐显 | §2.4 克制不狂欢 |
 | 失败 | 全屏明度不变转暮蓝色相 → 印记化光点 800ms 逐枚收回 → overlay | §2.5 最静一拍 |
 | 减动效选项 | 上述全部动画提供时长减半/直接跳终态开关（基线权威 = HUD框架「可访问性基线」节；开关承载 = 设置面——2026-09-27 拍板不另立无障碍专项文档） | 动议：结算逐行兑现为信息载体不可整体跳过，可加速 |
@@ -472,7 +472,7 @@
 - **对比**：浮空数字按 art-bible §1.4 第一验收项的复合判据过门（四类底上 max(字芯对底,描边对底) ≥4.5 且字芯对描边 ≥4.5；最亮底岩顶实测描边对底 5.1:1）；UI 数据一律墨族素面对面板底 ≥4.5:1
 - **色弱冗余**：无任何信息仅靠色相承载——格态靠完整/碎裂形；奖励金 vs 危险红靠剪影+运动；UI 红/金强调对加图标+文案冗余；Boss 靠形状独占（art-bible §4.5 清单逐项成立）
 - **灰度可辨**：变异格纹带、格态在灰度截图下可分类（art-bible §3.2 验收标准）
-- **非色彩破坏性确认**：弃图刷新（消耗 RAP 8 点）的确认交互与常规确认**不同位**（位置通道，色弱清单 #7）
+- **非色彩破坏性确认**：弃图刷新（消耗 RAP 4 点）的确认交互与常规确认**不同位**（位置通道，色弱清单 #7）
 - **字号下限**：浮空数字字高 21px（固定，含描边视觉 25px）、明细带正文 ≥14px、tooltip ≥13px（1280×800 基座）
 - **运动**：无闪烁 >3次/秒；结算光带为方向性扫动非频闪；提供减动效选项（§Transitions）
 - **键盘/Gamepad**：MVP 纯鼠标可完成全部操作（technical-preferences 平台注记）；**MVP 纯键盘导航/焦点序不做**（2026-09-12 拍板——回合制点击驱动，平台仅承诺纯鼠标）；gamepad 导航序延后（Open Questions）
@@ -508,8 +508,8 @@
 
 - [ ] 挖/移/封印/停手/刷新全部操作纯鼠标可完成；stop 意图经意图批次提交（代码走查 + 探针断言）
 - [ ] 每次拒绝（棋盘面/资源面/相位）玩家可感知且两源可区分；voided（至少 stop 作废）可感知（排雷玩法×6⑥、行动经济双源）
-- [ ] 弃图刷新消耗 RAP 8 点、本轮上限 2 次可见（按钮文案实时「剩 N 次」；上限 2 次为行动经济口径）；RAP<8 资源面拒绝可见（行动经济 EC13）；确认交互与常规确认不同位；换图后 AP 不重置、剩余次数扣减可见（受理口径见布局决策 4）
-- [ ] 战斗结束时 RAP 清零有可见反馈（行动经济）
+- [ ] 弃图刷新消耗 RAP 4 点、本轮上限 2 次可见（按钮文案实时「剩 N 次」；上限 2 次为行动经济口径）；RAP<4 资源面拒绝可见（行动经济 EC13）；确认交互与常规确认不同位；换图后 AP 不重置、剩余次数扣减可见（受理口径见布局决策 4）
+- [ ] 冒险收束时 RAP 清零有可见反馈（行动经济）
 - [ ] 战斗结束时状态图标行全清有可见反馈（B 区站桩逐枚化光 + 微文案）（增益状态×④）
 - [ ] 敌人死亡瞬间可辨识（卡体灰化 + 碎裂退场，禁瞬消）；战斗段短路被掐灭的重击由行序可推断（敌人系统资产下限）
 

design/ux/interaction-patterns.md

@@ -163,14 +163,14 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
 ### 7. 破坏性确认异位（destructive-confirm position offset）
 
 **Category**: Feedback
-**Used In**: 弃图刷新（RAP−8 消耗 + 旧板弃置）
+**Used In**: 弃图刷新（RAP−4 消耗 + 旧板弃置）
 
 **Description**: 消耗性/不可逆操作的确认交互与常规确认**不同位**——位置通道是色盲安全冗余（art-bible §4.5 清单 #7：UI 红/金强调对需图标+文案冗余，且破坏性确认禁止与常规确认同位）。
 
 **Specification**:
-- 弃图刷新：确认微交互显式呈现全部代价（RAP−8 · **旧板封印印记随旧板作废**提示）；确认交互位置与常规确认不同位
+- 弃图刷新：确认微交互显式呈现全部代价（RAP−4 · **旧板封印印记随旧板作废**提示）；确认交互位置与常规确认不同位
 - 双通道：图标 + 文案冗余
-- 拒绝路径：RAP<8 → pattern 1 的资源面（EC13 合法拒绝可见）
+- 拒绝路径：RAP<4 → pattern 1 的资源面（EC13 合法拒绝可见）
 
 **When to Use**: 任何消耗资源/不可逆的操作确认
 **When NOT to Use**: 无代价操作（直接执行 + 直接反馈）