fix(examples): 修正 random_quests 示範的迴圈與跳躍節奏

[aionyx02]

這個 PR 做什麼

修正 examples/quests/random_quests/ 十五題參考解答裡三類會讓學員實際跑不出結果的問題：

• README 的「進度跨重連累積」寫反了。 基準是登入那一刻抓的，重跑程式＝斷線重連＝基準重抓，做到一半的進度會歸零。所以一次執行就要做滿門檻。
• 拿掉 t03 / t04 / t05 / t06 的 while True。 既然進度不累積，迴圈只是重複送出同一件事。
• t03 / t13 補 bot.wait(0.5)。 bot.jump() 按完鍵就返回、不等落地（一次跳躍約 0.6 秒），而跳躍鍵只在站在地上時有作用 —— 連續呼叫大約有一半是在半空中按的，for i in range(10) 只跳得出約五下，門檻十下永遠達不到。t09 的轉向同理補 bot.wait(0.6)。
• t05 / t08 / t14 / t15 的密文改成佔位字串，並補上解密迴圈與 print，讓學員自己判讀後再 bot.chat 送答案。

驗證

只動 examples/，沒有碰 src/，不影響 stub / lint / type-check 範圍。跳躍節奏那條是實機觀察（十次呼叫只跳出約五下）得到的結論。

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

The PR adds the random bonus-quest examples and corrects their pacing and per-session instructions while also bringing dev forward with release metadata and a Mineflayer velocity-packet compatibility repair.

• Adds 15 straight-line random-quest reference scripts and learner guidance.
• Adds delays needed between jump and rotation commands.
• Installs and tests a Node-side repair for nested entity_velocity packets.
• Updates the package version and validates release tags against it.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code failure established.

The velocity repair preserves legacy packets and repairs the current nested packet shape synchronously, while the quest timing and editable placeholders align with the documented instructional workflow.

Important Files Changed

Filename	Overview
src/minethon/_bot_runtime.py	Adds a guarded Node-side nested-velocity packet repair during bot initialization; no actionable defect was established.
tests/integration/test_velocity_repair_js.py	Exercises nested, legacy, and unknown-entity packet cases using a fixed, non-shell subprocess invocation.
examples/quests/random_quests/README.md	Documents reconnect-reset behavior, required pacing, and intentional per-round ciphertext placeholders.
examples/quests/random_quests/t03_jump/main.py	Spaces jump commands so each requested jump can occur after landing.
examples/quests/random_quests/t09_spin/main.py	Spaces quarter-turn commands to make server-observed rotation progression reliable.
examples/quests/random_quests/t13_nest/main.py	Adds landing time between jumps in the nested jump-and-turn sequence.
.github/workflows/publish.yml	Prevents publishing when the release tag and project version disagree.
pyproject.toml	Advances package metadata from version 0.4.9 to 0.4.11.

Sequence Diagram

sequenceDiagram
    participant Server as Minecraft server
    participant Client as Mineflayer client
    participant Repair as Velocity repair listener
    participant Physics as Mineflayer physics
    participant Python as Minethon script
    Server->>Client: entity_velocity packet
    Client->>Client: Existing handler parses packet
    Client->>Repair: Same synchronous EventEmitter dispatch
    Repair->>Client: Restore velocity from nested x/y/z
    Physics->>Client: Integrate repaired velocity
    Python->>Client: Read valid position

Loading

_{Reviews (1): Last reviewed commit: "fix(examples): 修正 random_quests 示範的迴圈與跳躍..." | Re-trigger Greptile}