v2.0.0

2.0.0 — 一眼看懂

照 docs/REVIEW-v1.76.md 做。三个待定项都按建议：版本号用 2.0.0；新局卡片里的「思考」去掉；战绩表只留一行汇总。

不动的：

• 引擎与四档棋力、规则本身；
• 存储格式：旧存档、对局库、战绩、练习进度、设置都照读；
• 题库与判题、复盘内容；
• v1.75 / v1.76 的布局与进出方式；
• 四套主题的棋盘与棋子。

一句话：棋盘之外，只说棋盘说不了的；每句话只在一个地方说一次。

---

对阵条：两个座位代替状态文字

顶栏左边换成两个座位：

• 人机：「● 你」「○ 电脑 · 普通」；双人：「● 黑」「○ 白」。
• 轮到谁，谁的座位亮。
• 电脑思考时，它的座位里三个点在动；想过 3 秒，后面写秒数。
• 下完了，赢的一方座位亮着、写「胜」，输的一方变淡；和棋两边都写「和」。
• 规则：非「自由」时，座位后面挂一个「禁手」或「swap2」标签。
• 还没开局，两个座位都不亮；顶栏不再写「黑棋落子」（B23）。
• 练习时，座位让位，左边写「练习」。

状态胶囊、「你执黑 · 普通」那一行、棋盘角上闪烁的思考圆点一起退役。原来那句状态仍写在一个只给读屏的播报里，读屏用户听到的和以前一样。

一句话只在一处说

• toast 只留给「做了但看不见结果」的事：

  • 导入、导出、备份、恢复的成功或失败；
  • 存储出错、引擎降级；
  • 禁手点上落子被拦下时说明原因；
  • 「提示」没算出建议、「推演」没东西可摆。

  其余一律删掉，或者改成直接做、干脆不让做。按源码里出现的提示文案数：64 种 → 19 种。

• 一局普通对局走一遍（下棋 · 翻看时点棋盘 · 提示 · 终局 · 重下 · 回原局 · 复盘 · 新局），弹出的 toast 3 条 → 0 条。

• 翻看前面的手时点棋盘，直接回到最新一手；不再弹「请先『回到最新一手』再落子」（B24）。

• 重下开始、回到原局都不再弹 toast，重下卡片和棋盘已经说了（B26）。

• swap2：说明只留在棋盘上的提示条里。人机下，提示条里写清「布完由电脑挑边，它几乎总选黑，你执白」，这句话原来在 toast 里。

  • 此前同一个意思出现在状态胶囊、对阵行、toast、提示条四处，而且 toast 压着提示条（B22）。
  • toast 也挪到了顶栏下方，不再压棋盘底边和时间线。

• 换规则、开关音效 / 坐标、打开旧局、恢复上次的对局、导入完成、续下，都不再弹 toast：座位、规则标签、开关本身已经说明了。

「重下」只有一个名字

• 终局卡、复盘卡、重下线下完，一律写「从第 N 手重下」；「再试一次」并进这个名字。
• 「练这一手」退役：你对局里的失着本来就会自动进练习题库，在练习里照样会遇到。
• 复盘卡上只剩两个动作：从第 N 手重下 · 推演。

练习：一条路

• 一排六个题型按钮和「错题本」并成卡片头右边一个「题型」下拉：今日 · 全部 · 成五 · 防守 · VCF · 禁手 · 错题本（带题数）。
• 卡片头左边是进度「第 1 / 5 题 · 答对 0」。
• 题目来自你自己的对局时，才写一行来源；「内置题」不再显示。
• 练习时看得见的控件 10 → 5（⋯ · 题型 · 提示 · 看答案 · 回到对局）。

「记录」改成「对局」

• 菜单项和弹层都叫「对局」。打开就是你下过的棋：
  • 最上面一行汇总「12 局 · 胜 7 · 负 4 · 平 1 · 连胜 3」；
  • 下面一局一行「胜 · 今天 12:31 · 普通 · 23 手」，点整行以复盘打开（没下完的接着下），删除收在行尾、悬停才显出来。
• 棋谱：
  • 底部「导入棋谱… · 粘贴」，拖进窗口照旧；
  • 导出在复盘卡片上；
  • 「复制 SGF」退役。
• 备份 / 恢复挪到设置，作为最后一行「数据」。设置管外观、声音和数据，对局管你的棋。
• 按难度分行的战绩表、「清空战绩」退役；每日打卡那一行不再写在这里（做完当天五题时会说）。

新局卡片

• 「思考」（快 · 标 · 深）退役：困难、极限固定用「标」，每手约 2 秒 / 5 秒，现有棋力闸门测的就是这一档。旧设置里存的思考档忽略。
• 卡片里剩模式 · 难度 · 执子 · 规则。

收尾

• 快捷键说明 10 行 → 6 行：H 提示 · ← → Home End 翻看 · 方向键 + Enter 在棋盘上下棋 · Z 悔棋 · N 新局 · Esc / ?。
  ⌘1 / ⌘2（绕过新局卡片切模式）与 ⌘⌃F / F（全屏提示）退役。
• 重下卡片的颜色走主题强调色（B25）：此前四套主题都是同一个写死的金色。练习看答案的说明也换成主题色。

修

#	现象	现在
B22	swap2 开局时 toast 压在棋盘底部的提示条上	说明只在提示条里；toast 挪到顶栏下方
B23	空棋盘一打开，顶栏就写「黑棋落子」	两个座位都不亮
B24	翻看前面的手时点棋盘，挨一句「请先回到最新一手」	直接回到最新一手
B25	重下卡片四套主题同一个金色	跟主题
B26	重下 / 回原局时卡片和 toast 说同一句话	只有卡片

另外两处，是改写闸门时量出来的：

• 练习卡片里的「回到对局」在「练习本」主题下对比度只有 4.03:1（不到 AA 的 4.5）。v1.75 起就是这样，只是此前没人量过练习卡片。卡片里的文字链改用正文色。
• 对比度闸门 AJ 自己的一个错：两层半透明底叠在一起时，它把结果当成了不透明，于是练习卡片里的按钮被算成「浅字压在纯白底上」（1.2:1）。改成按 source-over 正确合成；底层不透明时与原算法完全等价。

闸门

test-surface S18（v2.0 一眼看懂）在 v1.76 上失败：

项	v1.76 上实测	v2.0
空棋盘的顶栏看得见的字	「黑棋落子 · 你执黑 · 普通」	「你 · 电脑 普通」，两个座位都不亮
电脑思考时	状态胶囊 + 棋盘圆点	电脑座位亮、里面三个点；没有圆点
终局	「白棋胜」胶囊	电脑座位亮、写「胜」，你的座位变淡
翻看时点棋盘	停在 1 / 2，弹 toast	回到 2 / 2
一局普通对局弹出的 toast	3 条	0 条
toast 种类（按源码数）	64	19
swap2（人机）开局时说明出现几处	3 处 + 1 条 toast，且没说你执白	1 处，说了你执白
「重下」的名字	「重下第 13 手」「重下这一手」，另有「练这一手」	都是「从第 13 手重下」
练习时看得见的控件	10	5
「对局」弹层的按钮（不算每局一行）	8（清空 · 复制 · 导出 · 导入 · 粘贴 · 备份 · 恢复 · 关闭）	3（导入棋谱… · 粘贴 · 关闭）
快捷键说明	10 行	6 行
重下卡片底色（木纹 / 练习本）	同一个金色	各随主题

随之改写或退役的旧闸门（测的是旧界面本身；测功能的照旧通过）：

闸门	处理
test-surface S11	「复制 / 导出 / 导入 / 粘贴在记录里」→「导入 / 粘贴在『对局』里、导出在复盘卡片上」；「今日」从按钮变成下拉的一项
test-surface S13	设置弹层 4 → 5 行（多了「数据」）；对局行的文字从 .game-name 改读整行
test-surface S14	「打开没下完的局弹『接着下』」→「座位亮着、停在最后一手」
test-surface S15	「选困难出思考时长」→「『思考』一行不存在」
test-surface S16	题型「6 个按钮」→「下拉里 7 项（含错题本）」；「错题本」按钮 → 下拉里的一项
test-cross X	量测字体的取样从状态胶囊换成座位上的名字
test-cross T / W	顶栏左边从「状态 · 对阵 · 时钟」换成「座位 · 时钟」
test-cross AC	「两个思考脉动同周期」→「思考指示器只有一个」
test-cross AG	「战绩表表头压在数字上」退役 →「对局头上一行汇总：在、跟语言、数字对」
test-cross AH	对局行的两个按钮改为「整行打开 + 删除」
test-cross AI	⑧ ⌘1 / ⌘2 退役
test-cross AJ	战绩表退役后弹层文字变少，补量快捷键说明与练习卡片、对局放到六局（80 的覆盖线与判据都不动）；修半透明合成
test-cross AP	快捷键表覆盖线 10 → 6 行
test-daily 5	「战绩里有每日打卡一行」→「『对局』里不再有它，没下完一局时汇总不显示」
test-loop 7	对局行文字改读整行
test-game	swap2「你执白」的诚实检查从 toast 改查提示条文案；「清空」判据随按钮退役；Windows 快捷键说明只剩悔棋 / 新局两行带修饰键

底层依赖

核对过：@native-sdk/core 最新仍是 0.10.1，这一版无需升级。