From c879f8effcb641a48db152c4fdfbae8ea963b135 Mon Sep 17 00:00:00 2001
From: WangLJ-SEU <827006477@qq.com>
Date: Fri, 9 Oct 2026 12:16:55 +0800
Subject: [PATCH] Prepare npm registry release for Moyu 0.2.0

---
 CHANGELOG.md               | 15 +++++++++++----
 README.md                  |  6 +++---
 README.zh-CN.md            |  8 ++++----
 docs/troubleshooting.en.md |  2 +-
 docs/troubleshooting.md    |  4 ++--
 package.json               |  2 +-
 6 files changed, 22 insertions(+), 15 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 854ae33..bed0705 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,12 @@
 
 ## [Unreleased]
 
+暂无。
+
+## [0.2.0] - 2026-10-09
+
+### Since the September candidate
+
 - 统一七套剑法的英文名称；新增 `moyu --lang en|zh`，单次运行即可覆盖游戏语言，包裹 CLI 时不吞掉 `--` 后的参数。
 - 新增可录屏的中英文自动演示脚本，固定节奏展示七套剑法和终章头目，无需手动操作。
 - 英文 README 作为仓库首页，中文版保留旧版详细结构；两版补全七套剑法谱，并列出目前已知支持高清的终端。
@@ -32,24 +38,25 @@
 - 修复分块方向键输入、未满模拟步丢失攻击、极矮画布抬刀越界；增加原子自动存档和旧存档迁移。
 - Boss 增加受击闪白、击退、生命刻度与有预警的地裂；九种地域妖物匹配章节场景。
 - 右侧文字使用完整终端宽度、中文折行与方括号翻页，不再截掉剑谱尾部。
+- 新增真实游玩录屏，首页提供先试玩再包裹 Codex / Claude Code 的简短上手路径；首次通过 npm registry 发布 `moyu-game`。
 
-## [0.2.0] - 2026-09-15
+### Earlier 0.2.0 work (2026-09-15)
 
-### Added
+#### Added
 
 - 十个确定性 30 秒章节、章节检查点和跨章节 RNG 恢复。
 - 独立 supervisor 与认证 terminal lease，用于 worker 崩溃后的终端恢复。
 - Source/dist 启动 smoke、完整章节视觉基线和更严格的发布物一致性检查。
 - Cartridge 微型/展开视图声明、原生设备像素渲染接口和宿主事件生命周期。
 
-### Changed
+#### Changed
 
 - 候场状态缩减为右下安全边缘的单个 `·` / `•`，稳定状态不再产生周期输出。
 - Codex 游戏视图优先覆盖在 composer 正上方两行，无法确认位置时安全回退到底部区域。
 - stdout 背压优先保证内层 CLI 字节，并暂停 PTY 直到 drain。
 - `MOYU_TIER=graphics` 改为安全尝试；仅 `MOYU_FORCE_GRAPHICS=1` 跳过保护。
 
-### Fixed
+#### Fixed
 
 - 修复退出竞态、PTY listener 泄漏、信号退出码和 supervisor 完成握手。
 - 修复 `doctor --gfx` 非 TTY lease 错误，并在正常完成后保留诊断图片。
diff --git a/README.md b/README.md
index 2b51920..509a5b4 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ Requires **Node >= 20** and an interactive terminal. macOS, Linux, and native Wi
 On macOS or Linux with Node installed:
 
 ```sh
-npm install --global 'https://codeload.github.com/PrometheusTT/moyu/tar.gz/refs/heads/main'
+npm install --global moyu-game@0.2.0
 moyu demo
 ```
 
@@ -34,7 +34,7 @@ moyu -- codex
 moyu -- claude
 ```
 
-On Windows, install the native Windows version of the CLI you want to wrap. Moyu currently installs from GitHub `main`, not the npm registry.
+On Windows, install the native Windows version of the CLI you want to wrap. For the latest development commit instead of the npm release, install `https://codeload.github.com/PrometheusTT/moyu/tar.gz/refs/heads/main` with `npm install --global`.
 
 ## See it in action
 
@@ -120,7 +120,7 @@ Codex uses `~/.codex/hooks.json`; Claude Code uses `~/.claude/settings.json`. Th
 
 ## Update
 
-To get the latest GitHub commit even when the package version is unchanged, remove and reinstall the package. Saves are kept. On macOS / Linux:
+To update the npm release, run `npm install --global moyu-game@latest` (`npm.cmd` in Windows PowerShell). Saves are kept. If you installed directly from GitHub and want the latest `main` commit even when its package version is unchanged, remove and reinstall that source. On macOS / Linux:
 
 ```sh
 npm uninstall --global moyu-game
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 8521ed8..6b09ab7 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -13,8 +13,8 @@
 macOS / Linux：
 
 ```sh
-npm install --global 'https://codeload.github.com/PrometheusTT/moyu/tar.gz/refs/heads/main'
-moyu play stick-slash
+npm install --global moyu-game@0.2.0
+moyu demo
 ```
 
 macOS 尚未安装 Node 时，可使用 [安装脚本](./install/macos.sh)。
@@ -36,7 +36,7 @@ moyu -- codex
 moyu -- claude
 ```
 
-Windows 上使用 `moyu -- codex` 或 `moyu -- claude` 前，先安装相应 CLI 的 Windows 原生版。目前从 GitHub `main` 安装，尚未发布到 npm registry。
+Windows 上使用 `moyu -- codex` 或 `moyu -- claude` 前，先安装相应 CLI 的 Windows 原生版。若想试最新开发提交，也可用 `npm install --global 'https://codeload.github.com/PrometheusTT/moyu/tar.gz/refs/heads/main'` 从 GitHub 安装。
 
 ## 操作
 
@@ -108,7 +108,7 @@ Codex 使用 `~/.codex/hooks.json`，Claude Code 使用 `~/.claude/settings.json
 
 ## 更新
 
-当前从 GitHub `main` 安装，同版本号也可能有新提交。先卸载 npm 包再重装，存档会保留。macOS / Linux：
+更新 npm 正式版时运行 `npm install --global moyu-game@latest`（Windows PowerShell 用 `npm.cmd`），存档会保留。如果此前从 GitHub 安装，想获取 `main` 的最新提交，即使版本号不变也要先卸载再重装。macOS / Linux：
 
 ```sh
 npm uninstall --global moyu-game
diff --git a/docs/troubleshooting.en.md b/docs/troubleshooting.en.md
index 9062728..6fea178 100644
--- a/docs/troubleshooting.en.md
+++ b/docs/troubleshooting.en.md
@@ -8,7 +8,7 @@ First run `node --version`, `moyu doctor`, and `moyu doctor --caps`. When report
 
 Use the [native PowerShell installer](../README.md#quick-start); WSL is not required. If an older WSL installer gets HTTP 403, switch to the native installer instead of retrying the blocked Ubuntu download. Open a new WezTerm PowerShell tab after installation so PATH updates take effect.
 
-To update an existing installation, follow the [remove-and-reinstall commands](../README.md#update). The package is installed from GitHub, not the npm registry, and running Moyu processes must be restarted.
+To update an existing installation, follow the [update commands](../README.md#update). The npm package is `moyu-game`; a GitHub `main` install remains available for development commits. Restart running Moyu processes after updating.
 
 ## No `moyu` command
 
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index fa580dc..b37413b 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -45,10 +45,10 @@ npm list --global --depth=0
 
 ```sh
 npm uninstall --global moyu-game
-npm install --global 'https://codeload.github.com/PrometheusTT/moyu/tar.gz/refs/heads/main'
+npm install --global moyu-game@latest
 ```
 
-当前 `moyu-game` 尚未发布到 npm registry。安装时不需要本机 TypeScript。如果错误提到 `tsc`、`prepare` 或临时目录死软链，
+正式版从 npm registry 安装；GitHub `main` 仍可用于试最新开发提交。安装时不需要本机 TypeScript。如果错误提到 `tsc`、`prepare` 或临时目录死软链，
 请附上 Node/npm 版本创建 Bug Report。
 
 ## `--lang en` 后游戏 HUD 仍是中文
diff --git a/package.json b/package.json
index 861d3ac..d92f5af 100644
--- a/package.json
+++ b/package.json
@@ -45,7 +45,7 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "compile": "tsc -p tsconfig.build.json",
-    "test": "node --import ./test/setup.mjs --test --experimental-strip-types \"test/**/*.test.ts\"",
+    "test": "node --import ./test/setup.mjs --test --test-concurrency=4 --experimental-strip-types \"test/**/*.test.ts\"",
     "docs:check": "node scripts/check-docs.mjs",
     "check": "npm run typecheck && npm run docs:check && npm test",
     "verify": "npm run check && npm run compile",