Spire for LinkChat — 0.4.2

按需安装的频道合作卡牌爬塔 TUI。需要支持扩展 API 1 的 LinkChatCLI 0.7.0-beta.2 及以上（旧宿主只支持键盘）；推荐使用 0.7.4 及以上以包含备用屏幕行定位修复；路线图与目标的颜色要 0.7.3 及以上，更旧的宿主会把颜色剥离，以及管理员安装并启用 linkchat-spire 后端包；后端规则版本 spire-tui-4、内容版本 0.1.0-alpha.2.dev17，存档版本不一致时明确拒绝加载，不会静默升级进行中的局。

离线包安装：linkchat extension install spire --from /绝对路径/linkchat-extension-spire-0.4.2.tgz；省略 --from 时从官方 registry 安装 linkchat-extension-spire@latest。安装后重新打开 LinkChat，输入 /spire。2–4 人同频道创建或加入房间，各自准备后开始。断线或退出会暂停整局；所有人重新准备后继续。

操作

战斗：我方在左、敌人在右（只保留左右分组和上下排列两种布局；至少 68×24 时按 G 切换，窗口不足时自动上下排列，放大后恢复所选布局）；每个信息块自上而下是意图、名称、格挡与血条、生命、Buff、DeBuff，多个意图字段会换行而不是被截断。手牌竖排，选中项显示箭头，不显示列表序号；方向键选择、Enter 执行；方向键跨页时列表自动跟随焦点。能量右侧是固定的 [E 结束回合 X]（X 为当前回合数） 按钮，和 E 键共用同一套校验，按钮会显示 [已结束回合] 或 [等待队友]。

选择单体目标：不再弹出目标名单。使用需要目标的牌或药水后，合法目标会加上边框，直接用键鼠选中战场上的那个实体（名称、血条、状态都属于同一目标）：左右键循环、Enter 或单击提交、Esc 取消本地未提交的操作且不消耗任何东西。目标死亡、牌被消耗或阶段变化时会重新校验，点击不会因为列表重排落到别的身份上。战斗之外使用单体药水时仍给出目标列表。

地图：开局先确认当前角色或选择其他角色，再显示路线。M 打开／关闭地图，战斗中查看地图不会提交路线投票。普通视图按真实七列格位纵向分层，起点在下、向上前进；每个房间保留编号（如 05-C）和类型。● 当前位置、✓ 已走过、黄色强调选中房间、普通出边和目标，投票人数仍在房间名后显示。↑ 查看更高层、↓ 查看更低层，←/→ 浏览同层房间，数字键定位可选路线，Enter 对选中的可达房间提交本人路线投票；悬停只查看，单击可达房间即投票。详情显示带编号的真实后继，飞靴额外可达单独列出，不画成普通地图边。C 回到当前位置，F 切换紧凑连接表，滚轮向上查看更高层、向下查看更低层；窄屏或高度不足时自动显示连接表，每行保留来源和目标编号、类型。地图阶段不再显示底部节点列表；直接在地图选点，底部保留详情和操作提示，方向键在地图边缘继续移动可进入装备或顶部入口。地图视图最低支持 40 列、12 行；暂停和缺少地图数据时仍保留操作列表。未知房间始终显示为未知。

商店：分类页签（卡牌 / 遗物 / 药水 / 删牌服务）+ 竖向商品列表 + 右侧详情（窄窗口改为列表下方的展开页）。详情显示当前实际价格、半价状态、购买后余额；买不起时显示还差多少并禁止提交，药水栏满时给出"管理药水栏"入口。选中商品后点击 [购买] 或按 Enter 即成交，不再二次确认。删牌服务会先给出价格，选完牌再确认费用与目标。离开商店 始终在列表里。[、] 切换分类。

奖励：战后奖励是一张总清单，每项标注待领取 / 待选择 / 已领取 / 已跳过（这些标记只是显示，不作为幂等凭据）。卡牌奖励点开是三选一候选，选中候选后由"领取所选卡牌"提交；其他奖励由该行本身领取。跳过剩余奖励并离开 只确认一次，并列出将放弃的项目，然后按奖励逐项执行服务器的跳过动作，遇到新选择会停下来重新展示。重连后以服务器剩余奖励为准。

宝箱：单人时点选遗物即为一次明确的领取，客户端会在服务端确认后接着领取同一件遗物（按 reward ID 精确匹配，结果不明时不会猜）；多人保留投票、分配、领取三个阶段，投票按钮本身就是确认。

装备与详情：顶部常驻本人遗物、药水实际槽位（含空槽）及“牌组 N · D”。遗物显示计数；过长的栏可横向翻页。悬停或方向键选择在底部显示完整说明，移出恢复键盘焦点；? 查看全文。药水点击或 Enter 打开“使用／丢弃”，丢弃需确认；自动药水及事件锁定状态会明确标注。火堆升级列表悬停或键盘选中即可查看升级前后，确认才执行升级。

快捷键：D 总牌组、A 抽牌堆、S 弃牌堆、X 消耗堆、M 地图、E 结束回合、V 完整战斗日志、G 切换战斗布局。地图仍用 C 定位当前位置。方向键按画面位置在主操作、单位、装备、牌堆和顶部入口间移动；Enter 确认，Esc 返回主操作或关闭弹窗。Tab、PageUp、PageDown 已移除。牌堆查看、日志与弹窗用 Esc 返回并恢复位置。D 不再丢弃药水。请求结果不明时 R 重试原操作。

战斗日志：每场独立保存完整记录，战后结算保留至下一战；常规快照仅带最近 20 条。默认隐藏底部日志预览；V 或点击顶部“战斗日志”打开按回合分组的完整记录，最新记录在最上方，打开从顶部开始，↑↓ / 滚轮滚动，在记录首尾继续按 ↑↓ 自动读取相邻页，← 较新 / → 较旧读取前后页（每页 100 条）。抽牌等私有信息仅本人可见，不显示洗牌顺序；旧局早期日志可能不完整。敌人意图按原作声明顺序显示剑、盾、强化、减益等符号，攻击显示对本人伤害与次数，隐藏底层执行参数。

列表与地图节点前均不显示数字定位标号。

鼠标（需要客户端宿主 0.7.0 及以上）：鼠标移到某行即高亮该行（等同选中），单击即生效；点顶部牌组或日志入口打开查看；遗物悬停查看，药水点击打开操作菜单；滚轮滚动列表（地图页滚动地图），弹窗有长说明时滚轮翻页。游戏界面会接管鼠标，想在终端里选中或复制文本请按住 Shift 拖拽。旧宿主上鼠标点击不会生效。

内容

五位角色：铁甲战士（80 生命）、静默猎手（70）、故障机器人（75）、储君（75）、亡灵契约师（66）。三幕路线：首幕在蔓生之地与地下码头之间抽取，随后进入巢穴与荣光，每幕 13–15 层，各有自己的事件池与古神。

规则参考 v0.111.0 并与之一致：596 张牌（攻击 198、技能 246、能力 113，另有状态 17、诅咒 18、任务 4）、298 件遗物、64 种药水、80 组遭遇、108 种敌人、57 个事件。中文文本自行编写；分支地图与内容抽取为精选内容适配，不兼容原作种子、存档及联机。无原游戏程序、美术、音频或反编译源码。

其他

扩展只提供游戏界面，存档在服务器，卸载扩展不会删除存档。正式客户端 0.6.3 不包含扩展功能。此版本为正式版。

协议 6 配套更新

本版必须与协议 6 的 Spire 后端一起更新。协议 1–4 会明确提示版本不匹配并阻止游戏操作。聊天 CLI 主程序无需重新发布。

升级预览按当前牌堆读取卡牌，保留战斗中的临时费用；队友面板关闭后恢复原选择。水晶球支持方向键、Enter、空格和鼠标操作。

进阶 A0–A10 全部开放，默认 A0。在创建房间前选择“新局难度”，创建后固定；继续已有单人存档保留原等级。扩展 0.4.2 使用游戏协议 6，需要配套后端。

悬停详情靠窗口底部对齐，长说明最多预览三行，? 查看全文。

单位格挡值以盾牌显示（例如 ⛨ 12），我方、敌人及详情使用相同格式。