用 React 做了一个国风围棋学习网站,让新手看懂“为什么这样下”

0 阅读6分钟

我自己是围棋新手。

学了一点落子、气和提子的规则之后,我以为可以开始下棋了。但真正跟电脑下起来,体验往往是:落下一颗棋,过几手被吃掉,再落一颗,又被吃掉。

规则似乎认识了,棋盘上发生的事情却还是看不懂。

于是我做了 The Go Room,一个面向零基础学习者的开源围棋网页,希望把“试一下”和“弄懂为什么”放在一起。

在线体验 · GitHub 源码

The Go Room 首页

最想做好的交互:先试下,再确认

新手很难只凭一句“这步不好”理解自己的问题。

比如,一块黑棋快被吃了。向外接一颗,看起来像是在逃跑,但接出去之后,真的增加了气吗?如果先提掉旁边的白棋,结果会不会不同?

在练习里,用户可以:

  1. 选择一个下法,查看试下的棋形。
  2. 确认选择,观察对方回应后的结果。
  3. 阅读解释,换一种下法重新比较。
  4. 最后回答:为什么这个选择能救棋?

下面是其中一道题的实际操作:

救棋练习演示

这里我很在意的一点是:答错之后,用户应该得到一个可以继续观察和尝试的结果。

比如,页面会说明哪块棋只剩一口气、对方下在哪里会把它提走。用户可以回看原图,再试另一种选择,把解释和棋盘上的变化对应起来。

把学习过程分成“学、练、弈、复”

目前网站有四个入口:

入口主要内容
学从落子、气、提子开始,逐步学习救棋、连接、两眼、围地和终局
练22 道练习,按能力分类,可以跳回相关讲解
弈与简单电脑对手下九路棋,默认开启陪练,支持试下和最近一回合重试
复保存已完成的棋谱,逐手回看提子、劫和终局等过程

“练”页的一部分题目来自课程,两边共用完成记录。用户从练习入口做题,不会改变课程的续读位置。

完成记录也区分独立完成、重试和借助提示,每题保留最好的一次结果。这样回来看时,可以知道哪些题值得再试一次。

技术实现:纯前端,无后端

项目使用 React、TypeScript、Vite 和 Vitest。规则计算、课程交互、电脑对手、进度保存都在浏览器中完成。

规则引擎与页面分开

围棋规则放在独立的纯函数模块中,负责落子、提子、禁入点、全局同形禁止、停一手、死子标记和数子。

页面根据规则计算的结果展示棋盘与反馈。这样,同一个规则引擎可以用于对局,也可以用于课程里的试下和结果核验。

目前项目有 330 个自动化测试,覆盖规则和多种交互流程。不过,测试通过只能说明程序符合已有检查,教学解释是否容易理解,仍然需要实际使用反馈。

棋盘使用 SVG

棋盘由 SVG 绘制,方便把棋子、目标棋块、气和试下位置放在同一套坐标里。

课程中可以给某块棋加标记,帮助新手把文字里的“这块棋”对应到棋盘上;进入独立练习时,再逐步减少这些提示。

进度保存在本地

学习记录和已完成棋谱保存在当前浏览器中,无需注册账号。

课程记录使用稳定的题目 ID,避免课程顺序调整之后,旧进度对应到错误的题目。读取时也会检查数据,遇到损坏记录不会让整个学习页面无法使用。

目前还没有跨设备同步,清除浏览器数据也会清除这些记录。

两个实际遇到的体验问题

1. 手机上,解释就在屏幕外

最初在桌面上看起来正常的布局,到了手机上就出了问题:用户点完棋盘,反馈出现在屏幕下方,需要往下滚才能看到。

尤其答错时,棋盘可能没有明显变化,用户会以为自己没点上。

后来把当前任务放到棋盘上方,把每一步的反馈放到棋盘附近。短解释直接显示,较长的分析再展开阅读。反馈已经在视野内时,不额外滚动页面。

这个问题也提醒我: “程序已经给出反馈”和“用户看到了反馈”是两件事。

2. GIF 有鼠标了,却加载不出来

最初的 README 动图像几张幻灯片,步骤变化有点突然。后来重新录制,加入连续鼠标移动、点击提示和阅读停顿,过程更容易跟上了,但文件也涨到了约 6.1 MB。

最后改成直接捕获浏览器的无损画面,使用统一调色板,并合并静止画面的停留时间,避免有损视频里的细微噪点让 GIF 重复保存大量画面。

优化后,约 40 秒的演示降到了 628 KB,体积减少约 90% ,鼠标动作和阅读停顿都保留了。上面的动图就是这个版本。

关于界面

我希望它看起来有一点翻棋谱的感觉,所以用了纸色背景、墨色文字和朱红强调,把课程组织成卷目。

这套风格也带来了需要权衡的地方:留白多了,手机上的操作可能离棋盘太远;文字过小,解释又不容易读。实际调整时,还是要保证当前任务、棋盘和关键反馈能一起被看到。

目前的边界

电脑对手使用简单的启发式策略,提示主要解释局部后果,不提供最佳手、胜率或可靠的长期死活判断。

终局时需要用户标记死子,程序按标记进行数子,不会自动核验死活。

我希望先把“看懂规则、看懂局部变化、试着完成一盘棋”这段过程做好。

欢迎试试,也欢迎指出讲不清楚的地方

项目以 MIT 许可证开源,打开网页即可使用,没有付费课程。

如果你也是围棋新手,很想知道:有没有哪道题做完了,仍然不明白为什么?

如果你会下围棋,也欢迎指出题目或解释中不够准确的地方。可以直接在评论里交流,或到 GitHub 提 Issue。