0.2.5-dev: an optional 「官方伤害数字」 setting (default off) shows only the numbers the official game shows per the PRTS red-number rule (#412, the owner's decision of 2026-10-12); a small link to the project's GitHub repository on the title page (#543); golden: unchanged

docs/PLAYING.md

@@ -176,10 +176,14 @@
 
 刷新、冻结、升级、撤退、出售和准备只在休整期有效，撤退 / 出售要先点选一名干员。方向轮盘（方向键预览、`Enter` 确认、`Esc` 取消；按 Tab 先到轮盘上的「点击取消」，在它上面按 `Enter` 是取消，Tab 到其他按钮上按 `Enter` 没有反应）、「玩法说明」和「干员调配」的翻页键是这些界面自己的按键，不能修改。
 
+**伤害数字**：标题画面、大厅、房间和对局里的「设置」有「显示伤害数字」（默认打开，每一次命中和治疗都跳出数字）和「官方伤害数字」（默认关闭）。打开「官方伤害数字」后，只在伤害达到 [PRTS 作战机制](https://prts.wiki/w/作战机制)「伤害红字（暴击）」的条件时显示红色整数（最终伤害不低于期望伤害的 1.5 倍；闪避了本应显示红字的一击时显示黄色 MISS）。关掉「显示伤害数字」则什么数字都不显示。无敌时官方客户端会显示红色 0，本作目前不会为这种未击中补一条伤害事件，因此这种红色 0 暂时看不到。
+
 **修改快捷键**：标题画面的「设置」按钮、大厅和房间顶栏的「设置」（玩法说明左边）或对局左下角的「设置」→「快捷键」。点一下要改的按键（只用键盘时按 Tab 移到它上面再按 Enter），出现「按下新按键…」后按新的键；按 `Esc` 取消，设置窗口不会关闭。可以用字母、数字、空格、标点符号键和 Delete / Insert / Home / End / PageUp / PageDown；`Esc`、`Tab`、`Enter`、方向键和 F1–F12 留给界面使用，也不能搭配 Ctrl / Alt / ⌘。新按键已被另一个快捷键使用时两者互换，列表下方会写明（例如把「撤退选中干员」改成 `X`，「出售选中干员」就换成原来的 `Q`）。「恢复默认」改回上表的按键。修改立即生效，商店栏、准备按钮和单位底部「撤退 / 出售」按钮上显示的按键也跟着变；设置和音量等一起保存在当前浏览器里（换浏览器或清除网站数据后回到默认）。按键按键帽上印的字符识别（AZERTY 等键盘按印着的字母），俄文等非拉丁布局按键位识别。手机等纯触屏设备要连接键盘才能用快捷键，设置里的快捷键列表默认折叠。
 
 ## 12. 反馈问题
 
+标题画面页脚的「项目仓库」在新标签页打开本项目的 [GitHub 仓库](https://github.com/sganggs/Stronghold-Protocol)。
+
 遇到报错、卡住或结果不对时，打开「设置」→「问题反馈」，点「复制诊断信息」，再到 [GitHub issue](https://github.com/sganggs/Stronghold-Protocol/issues) 里描述发生了什么并粘贴进去。诊断信息包括游戏版本、浏览器和设备、当前所在的阶段与回合，以及打开页面以来记录到的错误（最多保留最近 40 条）。战斗中复制时，默认附上这场战斗的数据，开发者可以用它重现这场战斗；不想附上可以关掉「附上本场战斗」。诊断信息只在你的浏览器里生成，不会自动上传；你和其他玩家的名字、房间号会被替换成 `<me>`、`<player2>`、`<room>` 这样的占位符。剪贴板不可用时（部分 App 内置浏览器），内容会显示在下方的文本框里，手动全选复制即可。
 
 ## 13. 统计（本机）

docs/design/client.md

@@ -170,3 +170,9 @@ the actor returns to base/skill idle. Late operator events still start at the st
 
 Connection recovery sits above the AI-away overlay and below global modals (§30.8), so a replaced session can
 be reclaimed by pointer while away. This does not change the stacking behavior of modals nested inside a screen.
+
+§30.17: 设置 →「官方伤害数字」 defaults off. Off, damage numbers stay the typed every-hit popups. On, and only
+while 「显示伤害数字」 is also on, the field draws a red integer for a `dmg` tuple marked `'r'` and a yellow MISS
+for a dodge fx whose payload is `num: 'm'` (PRTS 作战机制 「伤害红字（暴击）」). Ordinary hits and heals draw no
+digits in that mode. The mark is computed in the sim; the random offset above the model is client-side. The
+simplified board uses the same mark with a fixed slot. The title footer links the project repository in a new tab.

docs/history/0.2.5.md

@@ -271,3 +271,55 @@ the preceding digest exactly; the changed partner/side also changes preparation
 All five already differed from 0.2.4, so the final release-relative total remains 45 scenarios (§30.9 plus these
 additional pairing effects). There are no new corpus cases or removals. The other follow-up fixes do not move this
 corpus; their dedicated regressions cover the reported and newly found cases.
+
+### 30.17 Official damage numbers and the title-page repository link
+
+Issues #412 and #543. #412's font swap, element-colour pass and bold crit type are not part of this change.
+The new setting 「官方伤害数字」 (`officialDamageNumbers`) defaults off. While it is off, every rounded hit and
+heal still pops the existing typed number (merge, colours, 90-number ceiling, sparks and slashes unchanged).
+Turning 「显示伤害数字」 off still hides every digit, including official ones. The value is sanitised with the
+other settings (a missing or non-boolean saved value stays off) and copied into the live field view.
+
+The official rule is PRTS [作战机制](https://prts.wiki/w/作战机制) 「伤害红字（暴击）」 (fetched 2026-10-12): show a
+red integer of the final damage when 最终伤害 ≥ 期望伤害 × 1.5, or when a skill forces red. Expected damage follows
+the normal formula except that DEF/RES penetration, post-mitigation bonuses (temporary attack-scale increases,
+damage-scale increases such as 脆弱, amount rewrites, barrier absorption), final-damage resets and special HP
+mechanisms are not counted. Invulnerable targets multiply expected damage by 0, and 0 ≥ 0 × 1.5 still shows red 0.
+A dodge of a hit that would have been red shows yellow MISS (`#ff9000`) instead. After 卫戍协议：盟约 the official
+client no longer caps red numbers at 10; this client does not restore that cap. The existing 90-number ceiling
+stays as a renderer limit [ASSUMED: 「无限制」 means the old cap of 10 is not brought back].
+
+In this sim the comparison runs inside `dealDamage` and does not change HP, shields, hooks or RNG:
+
+- Expected damage is mitigation of `dmg.amount` with penetration forced to 0, times `dmg.mul` only.
+- The compared total is the pre-shield amount after source and target multipliers. The integer on the existing
+  `dmg` tuple — what both modes display — is what remains after shields and an `hpDamage` rewrite.
+- A qualifying tuple that already fires (`amount >= 0.5`, not silent) gains a fifth element `'r'`. Other tuples
+  stay four elements. Element gauge fills are not marked. Heals are not marked, so official mode hides them.
+- A dodge that already fires sets `num: 'm'` on its fx payload only when the same test says the landed hit would
+  be red. That test does not roll RNG again and does not refresh a dirty attacker's stats (a dirty `source.s`
+  read rescales HP).
+
+[ASSUMED] gaps, left unmarked rather than guessed:
+
+- `dmg.amount` already includes the attack's stated ATK × 攻击倍率 (`atkScaleMul` is baked in by callers). It is
+  not divided back out. `dmg.mul` stays on both sides of the comparison.
+- Cached-ATK expected damage (raw ATK, ignoring the attack scale and the target's DEF/RES), forced red, blue
+  numbers and yellow BLOCK are not represented on DamageInfo. The three wiki examples are not hard-coded.
+- An invulnerable or sleeping hit, and a qualifying total below 0.5, still emit no `dmg` event, so official mode
+  cannot show that red 0. Emitting one would increment `events.dmg` and could play an impact. The renderer can
+  draw a red 0 when a tuple `['dmg', id, 0, type, 'r']` is supplied. Liftoff and a cancelled or hit-capped attack
+  are not red 0.
+- PRTS does not say that ordinary hits are silent. That is the requested setting: official mode shows only the
+  marked red integer and the yellow MISS. The sentence in the issue comment is not a PRTS sentence.
+- The random position is about ±0.35 tiles across and 0.15–0.55 tiles above the head. The simplified board keeps
+  its fixed slot and only changes the colour / the MISS label.
+- Sparks and the melee slash stay in both modes.
+
+#543: the title footer carries a text link labelled 「项目仓库」 to
+`https://github.com/sganggs/Stronghold-Protocol`, `target="_blank"` and `rel="noopener noreferrer"`. It does not
+replace 设置 → 问题反馈.
+
+Tests: `test/sim/official-damage-numbers.test.js`, `test/ui/official-damage-numbers.test.js`,
+`test/render/official-numbers.test.js`. Golden digests do not move: no new event kind is emitted, and the extra
+tuple field is not part of the digest. Player notes: PLAYING; client notes: design/client.md.