[GarupanOjisan]

何が変わるか

RUNBOOK に、長い CUDA 実行向けの GB10 GPU クロック上限（2,200 MHz）と、負荷中の実クロックで確認する手順を足す。

Closes #8

ベースは main。v1.1.2 取り込みブランチ（cursor/sync-upstream-1.1.2-9631）へ試しにマージしても、RUNBOOK のハンクは重ならなかった。先に取り込みが入っても、この差分はそのまま載る。

内容

• upstream 6774777f（RUNBOOK: a GPU clock cap for GB10s, with what it cost and lowered for GLM-5.3-Flash NVFP4 at TP=2 ashhart/TensorFold#1110）を cherry-pick した。sudo nvidia-smi -lgc 300,2200 と、oneshot の gb10-clock-cap.service（RemainAfterExit=yes、停止時は nvidia-smi -rgc）。GLM-5.3-Flash NVFP4、v1.1.1、TP=2 での測定もそのまま残してある。draft ありの decode は約 1% 遅く、draft: false は約 1.5%、コールドプロンプトは 2–5% 遅い。トークン ID は同じ。GPU ピークは約 60 W（上限なしは 89–92 W）。最も熱い区画は 88.6–90.7 C（上限なしは 96.8–98.1 C）。
• 追記した確認手順。nvidia-smi -q の Applications Clocks と Max Clocks は -lgc の後も古い値のまま残る。応答の decode 中に nvidia-smi --query-gpu=clocks.gr,power.draw,temperature.gpu --format=csv -l 2 を見る（上記のサーブでは約 2,190 MHz）。oneshot ユニットは、ドライバの再読み込みや GPU リセットの後には上限を掛け直さない。その後は実クロックを見るか、ユニットが走るよう再起動する。
• 1,800 MHz の報告（5 台の GB10、125B 以上）。上限なしの 2,455 MHz は 56.0 W、84 C、73.4 tok/s。sudo nvidia-smi -lgc 0,2200 は 40.1 W、78 C、72.5 tok/s。sudo nvidia-smi -lgc 0,1800 は 23.5 W、68 C、70.5 tok/s。ユニットが掛ける上限は 2,200 MHz のまま。

検証

ドキュメントだけなので、ビルドとテストは走らせていない。

実機で確認すること

両方の GB10 で上限を掛け、decode、コールドプロンプト、ピーク温度を、上限ありとなしで比べる。負荷中の clocks.gr が約 2,190 MHz であること。ドライバを読み直したあと、実クロックが上限の外に戻っていないこと。