linkchat-extension-spire 0.1.9 → 0.4.2

package/README.md

@@ -1,16 +1,16 @@
-# Spire for LinkChat — 0.1.9
+# Spire for LinkChat — 0.4.2
 
-按需安装的频道合作卡牌爬塔 TUI。需要支持扩展 API 1 的 LinkChatCLI **0.7.0-beta.2 及以上**（旧宿主只支持键盘）；路线图与目标的颜色要 **0.7.3 及以上**，更旧的宿主会把颜色剥离，以及管理员安装并启用 `linkchat-spire` 后端包；后端规则版本 `spire-tui-2`、内容版本 `0.1.0-alpha.2.dev17`，存档版本不一致时明确拒绝加载，不会静默升级进行中的局。
+按需安装的频道合作卡牌爬塔 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.1.9.tgz`；省略 `--from` 时从官方 registry 安装 `linkchat-extension-spire@latest`。安装后重新打开 LinkChat，输入 `/spire`。2–4 人同频道创建或加入房间，各自准备后开始。断线或退出会暂停整局；所有人重新准备后继续。
+离线包安装：`linkchat extension install spire --from /绝对路径/linkchat-extension-spire-0.4.2.tgz`；省略 `--from` 时从官方 registry 安装 `linkchat-extension-spire@latest`。安装后重新打开 LinkChat，输入 `/spire`。2–4 人同频道创建或加入房间，各自准备后开始。断线或退出会暂停整局；所有人重新准备后继续。
 
 ## 操作
 
-**战斗**：我方在左、敌人在右（默认 80×25 终端使用紧凑双栏，队友在左、敌人在右；有效宽度不足 68 列或高度不足 24 行时改为上下分区）；每个信息块自上而下是意图、名称、格挡与血条、生命、增益、减益，多个意图字段会换行而不是被截断。手牌竖排并编号 1–9、0：数字键只把光标移到该位置，Enter 才是执行；每页最多十项，PgUp/PgDn 翻页，方向键跨页时页码同步。能量右侧是固定的 `[E 结束回合]` 按钮，和 E 键共用同一套校验，按钮会显示 `[已结束回合]` 或 `[等待队友]`。
+**战斗**：我方在左、敌人在右（只保留左右分组和上下排列两种布局；至少 68×24 时按 G 切换，窗口不足时自动上下排列，放大后恢复所选布局）；每个信息块自上而下是意图、名称、格挡与血条、生命、Buff、DeBuff，多个意图字段会换行而不是被截断。手牌竖排，选中项显示箭头，不显示列表序号；方向键选择、Enter 执行；方向键跨页时列表自动跟随焦点。能量右侧是固定的 `[E 结束回合 X]`（X 为当前回合数） 按钮，和 E 键共用同一套校验，按钮会显示 `[已结束回合]` 或 `[等待队友]`。
 
 **选择单体目标**：不再弹出目标名单。使用需要目标的牌或药水后，合法目标会加上边框，直接用键鼠选中战场上的那个实体（名称、血条、状态都属于同一目标）：左右键循环、Enter 或单击提交、Esc 取消本地未提交的操作且不消耗任何东西。目标死亡、牌被消耗或阶段变化时会重新校验，点击不会因为列表重排落到别的身份上。战斗之外使用单体药水时仍给出目标列表。
 
-**地图**：开局先确认当前角色或选择其他角色，再显示路线。M 打开／关闭地图，战斗中查看地图不会提交路线投票。普通视图按真实七列格位纵向分层，起点在下、向上前进；每个房间保留编号（如 `05-C`）和类型。`●` 当前位置、`✓` 已走过、数字为当前可选路线；黄色强调选中房间、普通出边和目标，投票人数仍在房间名后显示。↑ 查看更高层、↓ 查看更低层，←/→ 浏览同层房间，数字键定位可选路线，Enter 对选中的可达房间提交本人路线投票；悬停只查看，单击可达房间即投票。详情显示带编号的真实后继，飞靴额外可达单独列出，不画成普通地图边。`C` 回到当前位置，`F` 切换紧凑连接表，滚轮向上查看更高层、向下查看更低层；窄屏或高度不足时自动显示连接表，每行保留来源和目标编号、类型。地图阶段不再显示底部节点列表；直接在地图选点，底部保留详情和操作提示，Tab 查看其他面板。地图视图最低支持 40 列、12 行；暂停和缺少地图数据时仍保留操作列表。未知房间始终显示为未知。
+**地图**：开局先确认当前角色或选择其他角色，再显示路线。M 打开／关闭地图，战斗中查看地图不会提交路线投票。普通视图按真实七列格位纵向分层，起点在下、向上前进；每个房间保留编号（如 `05-C`）和类型。`●` 当前位置、`✓` 已走过、黄色强调选中房间、普通出边和目标，投票人数仍在房间名后显示。↑ 查看更高层、↓ 查看更低层，←/→ 浏览同层房间，数字键定位可选路线，Enter 对选中的可达房间提交本人路线投票；悬停只查看，单击可达房间即投票。详情显示带编号的真实后继，飞靴额外可达单独列出，不画成普通地图边。`C` 回到当前位置，`F` 切换紧凑连接表，滚轮向上查看更高层、向下查看更低层；窄屏或高度不足时自动显示连接表，每行保留来源和目标编号、类型。地图阶段不再显示底部节点列表；直接在地图选点，底部保留详情和操作提示，方向键在地图边缘继续移动可进入装备或顶部入口。地图视图最低支持 40 列、12 行；暂停和缺少地图数据时仍保留操作列表。未知房间始终显示为未知。
 
 **商店**：分类页签（卡牌 / 遗物 / 药水 / 删牌服务）+ 竖向商品列表 + 右侧详情（窄窗口改为列表下方的展开页）。详情显示当前实际价格、半价状态、购买后余额；买不起时显示还差多少并禁止提交，药水栏满时给出"管理药水栏"入口。选中商品后点击 `[购买]` 或按 Enter 即成交，不再二次确认。删牌服务会先给出价格，选完牌再确认费用与目标。`离开商店` 始终在列表里。`[`、`]` 切换分类。
 
@@ -18,9 +18,15 @@
 
 **宝箱**：单人时点选遗物即为一次明确的领取，客户端会在服务端确认后接着领取同一件遗物（按 reward ID 精确匹配，结果不明时不会猜）；多人保留投票、分配、领取三个阶段，投票按钮本身就是确认。
 
-**其他**：Tab 依次查看行动、牌组、遗物、药水、状态、日志，标签随窗口宽度换行；抽牌堆、消耗堆和弃牌堆仅在战斗中显示于能量栏下一行，依次位于左、中、右，点击或按 A / S / D 查看（药水面板的 D 仍为丢弃药水），Esc 返回；Esc 返回或暂停退出；药水面板 D 丢弃药水；多选可用数字键定位、空格勾选、确认行提交，规则允许空选时会给出明确的取消项。请求结果不明时按 R 重试同一操作，不会重复出牌。
+**装备与详情**：顶部常驻本人遗物、药水实际槽位（含空槽）及“牌组 N · D”。遗物显示计数；过长的栏可横向翻页。悬停或方向键选择在底部显示完整说明，移出恢复键盘焦点；`?` 查看全文。药水点击或 Enter 打开“使用／丢弃”，丢弃需确认；自动药水及事件锁定状态会明确标注。火堆升级列表悬停或键盘选中即可查看升级前后，确认才执行升级。
 
-**鼠标**（需要客户端宿主 0.7.0 及以上）：鼠标移到某行即高亮该行（等同选中），**单击即生效**；点顶部面板名切换面板；滚轮滚动列表（地图页滚动地图），弹窗有长说明时滚轮翻页。游戏界面会接管鼠标，想在终端里选中或复制文本请按住 Shift 拖拽。旧宿主上鼠标点击不会生效。
+**快捷键**：`D` 总牌组、`A` 抽牌堆、`S` 弃牌堆、`X` 消耗堆、`M` 地图、`E` 结束回合、`V` 完整战斗日志、`G` 切换战斗布局。地图仍用 `C` 定位当前位置。方向键按画面位置在主操作、单位、装备、牌堆和顶部入口间移动；Enter 确认，Esc 返回主操作或关闭弹窗。Tab、PageUp、PageDown 已移除。牌堆查看、日志与弹窗用 Esc 返回并恢复位置。`D` 不再丢弃药水。请求结果不明时 `R` 重试原操作。
+
+**战斗日志**：每场独立保存完整记录，战后结算保留至下一战；常规快照仅带最近 20 条。默认隐藏底部日志预览；`V` 或点击顶部“战斗日志”打开按回合分组的完整记录，最新记录在最上方，打开从顶部开始，↑↓ / 滚轮滚动，在记录首尾继续按 ↑↓ 自动读取相邻页，← 较新 / → 较旧读取前后页（每页 100 条）。抽牌等私有信息仅本人可见，不显示洗牌顺序；旧局早期日志可能不完整。敌人意图按原作声明顺序显示剑、盾、强化、减益等符号，攻击显示对本人伤害与次数，隐藏底层执行参数。
+
+列表与地图节点前均不显示数字定位标号。
+
+**鼠标**（需要客户端宿主 0.7.0 及以上）：鼠标移到某行即高亮该行（等同选中），**单击即生效**；点顶部牌组或日志入口打开查看；遗物悬停查看，药水点击打开操作菜单；滚轮滚动列表（地图页滚动地图），弹窗有长说明时滚轮翻页。游戏界面会接管鼠标，想在终端里选中或复制文本请按住 Shift 拖拽。旧宿主上鼠标点击不会生效。
 
 ## 内容
 
@@ -31,3 +37,15 @@
 ## 其他
 
 扩展只提供游戏界面，存档在服务器，卸载扩展不会删除存档。正式客户端 0.6.3 不包含扩展功能。此版本为正式版。
+
+## 协议 6 配套更新
+
+本版必须与协议 6 的 Spire 后端一起更新。协议 1–4 会明确提示版本不匹配并阻止游戏操作。聊天 CLI 主程序无需重新发布。
+
+升级预览按当前牌堆读取卡牌，保留战斗中的临时费用；队友面板关闭后恢复原选择。水晶球支持方向键、Enter、空格和鼠标操作。
+
+进阶 A0–A10 全部开放，默认 A0。在创建房间前选择“新局难度”，创建后固定；继续已有单人存档保留原等级。扩展 0.4.2 使用游戏协议 6，需要配套后端。
+
+悬停详情靠窗口底部对齐，长说明最多预览三行，`?` 查看全文。
+
+单位格挡值以盾牌显示（例如 `⛨ 12`），我方、敌人及详情使用相同格式。