使用说明User guide

01快速开始Getting started

打开 计算器页面 即可使用，不需要安装、注册或登录。所有计算都在你自己的浏览器里完成，棋局不会上传到任何服务器。

Open the calculator page and start. There is no install, account or sign-in. Everything runs in your own browser and no position is uploaded anywhere.

首次加载需要下载约 41 MB 的引擎与神经网络权重。页面顶部的状态条会显示「引擎待命 · 按需加载」；第一次点「计算分析」「计算一手」或开启 AI 时才开始加载，进度会显示在加载面板里。下载完成后会被浏览器缓存，之后再打开通常只需几秒。首次等待时请不要反复刷新。

The first visit downloads roughly 41 MB of engine and NNUE weights. The status chip reads “Engine idle · loads on demand”; loading starts on your first Analyse, Play-one or AI move and the progress is shown on the loader. The download is cached by the browser, so later visits are usually ready in seconds. Please don’t keep refreshing while it loads.

推荐流程：先摆几手 → 点「计算分析」看引擎的候选路线 → 用「AI执黑 / AI执白」对照下棋 → 需要开局研究时用「平衡点」。

Suggested flow: place a few stones → Analyse to see the engine’s main lines → enable AI black / AI white to play against it → use Balance when studying openings.

02棋盘与落子Board & moves

棋盘固定为 15×15。列用字母 A–O（从左到右），行用数字 1–15（从下到上），横竖坐标都画在棋盘边缘，所以 H8 就是第 H 列、第 8 行。

The board is a fixed 15×15 grid. Columns are A–O left to right and rows are 1–15 bottom to top. Both axes are labelled on the board, so H8 means column H, row 8.

• 落子：单击（或触屏点按）任意空交点。黑方先手，双方交替。
• 预览：鼠标悬停时显示半透明落子预览与当前分析路线，不会真的落子。
• 撤回：在棋盘上右键或长按，撤回最后一手；也可用「上一步」按钮或 Ctrl+Z。
• 手数：设置里可打开「显示手数」，棋子上会标出第几手，最新一手标红。
• 非法位置：已有棋子或黑方禁手点不会被接受，页面底部的状态行会给出提示。

• Place: click (or tap) an empty intersection. Black moves first and sides alternate.
• Preview: hovering shows a translucent ghost stone and the current line without committing.
• Undo: right-click or long-press the board; the Undo button and Ctrl+Z do the same.
• Move numbers: enable “Show move numbers” to label each stone; the latest move is red.
• Illegal points: occupied points and Black’s forbidden points are rejected with a short notice in the top-right corner.

03功能键Controls

行棋与局面Moves & position

分析与 AIAnalysis & AI

「计算分析」和「平衡点」都会一直加深，直到你再次点击、停止或改变局面。改变局面时会先安全停止旧搜索，再按新局面对齐重算。

Analyse and Balance keep deepening until you press again, stop, or change the position. On a new position the old search is stopped first, then the new one starts from the new board.

04胜负与规则Rules & win

设置里可切换三种规则，均由引擎按官方口径判定：

Three rule sets are available and all are judged by the engine:

任意一方连成有效五子时，对局立即结束：状态条显示「黑方获胜 / 白方获胜」，AI 自动关闭，棋盘保留，可撤回或重开。结束后再落子会提示先重开一局。

As soon as a valid five is formed the game ends: the status shows “Black wins / White wins”, the AI switches turn off, the board stays for review, and you can undo or start a new game. Placing after the end asks you to start a new game first.

05设置项Settings

右上角齿轮打开设置。所有设置会自动保存在本机，下次打开仍然生效。

The gear in the top-right opens Settings. Every option is stored locally and survives a reload.

06胜率与评分Win rate & score

胜率卡片只有一行：左侧「胜率」，中间是两枚评分块，右侧是「黑 xx% / 白 xx%」。两枚评分块一直都在——黑子套紫白框、白子套蓝白框，还没算出来就显示 -；窄到 320px 也不会换行或互相挤压。

The win-rate card is a single row: “Win rate” on the left, two score chips in the middle and the Black / White percentages on the right. Both chips are always present — black with a purple-white frame, white with a blue-white one — showing - until a score exists; nothing wraps even at 320 px.

• 分数口径：显示黑方视角的评估。正数表示黑方占优，负数表示白方占优；形式如 +405、-123。
• 绝杀分：已经算到的必胜/必败显示为 ±M，例如 +M56，数值越小越接近终局。同时胜率直接记 100%：整条胜率条只剩必胜那一方的颜色，不会再留一条对面的缝隙。
• 持久显示：切换 AI、停止分析、打开或关闭设置都不会把分数清空，也不会让这一行跳动或闪一下。只有新的评分数据到达时才覆盖当前值，棋盘变化时归零。
• 暂无数据：还没算出来时两枚评分块都显示 -，胜率条保持 50% / 50%。

• Perspective: scores are shown from Black’s point of view. Positive means Black is better, negative means White is better, e.g. +405 or -123.
• Mate scores: forced wins/losses appear as ±M, e.g. +M56; a smaller number is closer to the end. A mate also pins the bar to 100%: the whole strip takes the winning side's colour with no sliver left for the opponent.
• Persistent: toggling AI, stopping the search or opening Settings never blanks the row and never makes it jump or flash. Only fresh evaluation replaces the numbers, and a board change clears them.
• No data: before a score exists both chips show - and the bar stays at 50% / 50%.

分析路线的深度与评分（d24 胜）紧跟在标题后面；下面的坐标最多显示三行，超出可以用滚轮或手指上下滑动；点一下某个坐标可以把那条后续走法暂时固定在棋盘上，再点一次取消。

Depth and score of the main line (d24 胜) sit right after the panel title; the coordinates below use up to three rows and scroll beyond that. Click one to pin its continuation on the board, click again to release it.

07九种变换Nine transforms

点「变换」展开九宫格。九个按键只改变坐标，手数、先后手与撤回记录都保留；变换后会按新局面重新分析。

Press Transform to open the nine-key panel. The keys only change coordinates; move order, sides and undo history are kept, and analysis restarts on the new position.

四个对称变换分别是：顺时针旋转 90°、关于竖直轴镜像、关于水平轴镜像、关于两条对角线镜像。四个平移会把整个局面推到对应边缘；已经贴边时提示无法继续。空盘时变换没有可移动的棋子，会给出提示。

The four symmetries are: a 90° clockwise rotation, a mirror about the vertical axis, a mirror about the horizontal axis, and a mirror about each diagonal. The four shifts push the whole position against the chosen edge and report when it is already touching that edge. On an empty board there is nothing to transform.

变换后局面代码、坐标行与棋盘会同步更新；Esc 或再点「变换」关闭面板。

The position code, coordinate row and board update together; Esc or a second press on Transform closes the panel.

08局面代码与坐标Code & coordinates

局面代码的格式是「小写列字母 + 行号」，按落子顺序直接拼接，不带分隔符，例如 h8h9g7i7。这与 gomocalc 的格式一致，可以直接互相粘贴。

A position code is a lowercase column letter plus a row number, concatenated in move order with no separators, e.g. h8h9g7i7. It matches the gomocalc format and can be pasted between the two.

• 载入：把代码粘进「局面代码」框，回车立即载入；粘贴动作也会自动载入。
• 复制：点复制按钮复制当前代码；失败时会选中文字并提示手动复制。
• 坐标行：代码框下方给出可读坐标（如 黑 H8 · 白 J6），最新一手高亮。
• 错误：无法识别的代码会提示「无法识别局面代码」，棋盘保持不变。
• 先后手：黑先白后，按手数交替；载入后由手数决定轮到哪一方。

• Load: paste into the Position code box and press Enter, or paste and it loads automatically.
• Copy: the copy button copies the current code; if the clipboard is blocked it selects the text and asks you to copy manually.
• Coordinates: the row under the box shows readable coordinates such as Black H8 · White J6, with the latest move highlighted.
• Errors: an unrecognised code reports “Unrecognised position code” and leaves the board untouched.
• Side to move: Black first, then alternating by move count; after loading, the parity decides whose turn it is.

09提示与落子记录HUD & move log

棋盘右上角的留白带里只用和坐标字符同样的字体写着最新一手的坐标（例如 K12），没有底色、边框或图标；鼠标悬停到棋盘某一格时，会在这串坐标左边再多一个略淡的悬停坐标，离开即恢复。

The top-right margin of the board shows the coordinate of the newest stone (e.g. K12) in exactly the same face as the axis labels — no background, border or icon. Hovering an intersection adds that coordinate, dimmer, just to its left; it disappears on leave.

短提示（「AI 执黑已开启」「黑方禁手点」「已复制」等）不再盖在棋盘上，而是显示在页面底部的状态行里，约 2.6 秒后淡出，棋盘始终干净。

Short notices (“AI now plays Black”, “Forbidden point for Black”, “Code copied”) no longer float over the board: they appear in the footer status line and fade after about 2.6 seconds, leaving the board clean.

10快捷键Shortcuts

在输入框、代码框里打字时，撤回/前进快捷键不会生效，避免误操作。

While typing in an input or the code box, undo/redo shortcuts are ignored to avoid accidents.

11常见问题FAQ

第一次打开很慢 / 一直显示加载中First open is slow / loading seems stuck

首次需要下载约 41 MB 的引擎包，取决于网络可能需要几十秒。加载面板会显示进度；若长时间没有进展，可用面板上的重试按钮。完成后浏览器会缓存，下次打开很快。

The first visit downloads a ~41 MB engine package; this can take a while. The loader shows progress and offers a retry button if it stalls. After that the browser caches it and later visits are quick.

线程数只能是 1Threads stay at 1

多线程依赖 SharedArrayBuffer，要求页面处于隔离环境。本站通过 service worker 注入所需响应头；若浏览器禁用 service worker、页面被嵌入其他站点或使用不支持的浏览器，会自动回退单线程并给出提示，计算仍然可用，只是更慢。

Threads need SharedArrayBuffer and an isolated page. This site adds the required headers through a service worker. If service workers are disabled, the page is embedded elsewhere, or the browser does not support it, the page falls back to one thread with a notice — still usable, just slower.

切换 AI / 停止分析后分数怎么还在Why does the score survive toggling AI / stopping?

这是刻意的：胜率区的分数会持久保留，只有新的评分到达或棋盘变化时才更新，避免一按按钮就变回 —。

Deliberate: the score is sticky and only changes when fresh evaluation arrives or the position changes, so pressing a button never wipes it back to —.

AI 不动The AI does not move

检查：对局是否已经结束、引擎是否仍在加载、是否轮到该 AI 的颜色。状态条与诊断区会给出当前状态。

Check whether the game is over, the engine is still loading, or it is simply not that AI’s turn. The status line and diagnostics show the current state.

能离线用吗Does it work offline?

首次完整加载后，页面外壳与引擎会被缓存；在浏览器允许的前提下可以离线打开。清除站点数据后需要重新下载。

After a complete first load, the shell and engine are cached and the page can open offline where the browser allows it. Clearing site data means downloading again.

手机上能用吗Does it work on a phone?

可以：布局会适配窄屏，点击交点即可落子。手机通常只有 1–2 个线程，深层搜索会比桌面慢，建议降低哈希与线程数。

Yes: the layout adapts to narrow screens and taps place stones. Phones usually get 1–2 threads, so deep searches are slower; lower the hash and thread count if needed.

12性能与浏览器要求Performance & browsers

• 引擎为 WebAssembly 构建；多线程时用 1–8 个线程，线程数越多搜索越快，但会占用更多 CPU。
• 哈希表 64–1024 MB；加上约 41 MB 权重，建议桌面至少 4 GB 可用内存。
• 推荐近两年的 Chrome / Edge / Firefox / Safari；需要 WebAssembly。Safari 16.4+ 才具备较完整的多线程支持。
• 首次下载约 41 MB，之后由缓存提供；离线可用取决于浏览器策略。
• 深度、节点、速度与用时实时更新；无限分析会持续加深，停止命令会立即中断搜索。

• The engine is a WebAssembly build; multi-thread mode uses 1–8 threads. More threads search faster but use more CPU.
• The hash table ranges from 64 to 1024 MB; with ~41 MB of weights, 4 GB of free desktop memory is recommended.
• Recent Chrome / Edge / Firefox / Safari with WebAssembly; full multi-threading needs Safari 16.4+.
• The first download is about 41 MB and then comes from the browser cache; offline use depends on browser policy.
• Depth, nodes, speed and time update live; analysis keeps deepening and Stop interrupts the search immediately.

13关于与许可About & licence

Meter Gomoku Web 是 Meter Gomoku 项目的网页版本：界面、调度与计分由本项目编写，搜索引擎使用 Rapfi（作者 dhbloo）的官方 WebAssembly 构建与 NNUE 权重，搜索行为不做修改。

Meter Gomoku Web is the web edition of the Meter Gomoku project: the interface, scheduling and scoring are ours, while the search engine is the official WebAssembly build of Rapfi (by dhbloo) with its NNUE weights; search behaviour is unmodified.

完整说明书见本页；版本、引擎与授权另见 关于页，设置里的「关于」直接打开该页。左侧目录由章节自动生成，滚动时高亮当前一节。

This page is the full manual; version, engine and licence live on the About page, which the About entry in Settings opens. The contents rail is generated from the sections and highlights the one you are reading.