refactor: npm to yarn

Author: tobenot

.github/workflows/deploy-pages.yml

@@ -29,13 +29,13 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'npm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: npm ci
+        run: yarn install --frozen-lockfile
 
       - name: Build for GitHub Pages
-        run: npm run build:pages
+        run: yarn build:pages
 
       - name: Setup Pages
         # 使用官方 Action 配置 GitHub Pages
@@ -58,4 +58,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4 
+        uses: actions/deploy-pages@v4

docs/05-build-and-deploy.md

@@ -6,11 +6,11 @@
 
 所有构建相关的命令都定义在 `package.json` 的 `scripts` 部分。
 
--   **`npm run dev`**: 启动开发服务器，用于日常开发。
--   **`npm run build`**: 创建一个标准的生产版本，输出到 `dist/` 目录。
--   **`npm run build:itch`**: 为 **itch.io** 平台构建、打包，并自动管理版本号。
--   **`npm run build:pages`**: 为 **GitHub Pages** 构建一个生产版本。
--   **`npm run deploy`**: 构建并部署到 **GitHub Pages**。
+-   **`yarn dev`**: 启动开发服务器，用于日常开发。
+-   **`yarn build`**: 创建一个标准的生产版本，输出到 `dist/` 目录。
+-   **`yarn build:itch`**: 为 **itch.io** 平台构建、打包，并自动管理版本号。
+-   **`yarn build:pages`**: 为 **GitHub Pages** 构建一个生产版本。
+-   **`yarn deploy`**: 构建并部署到 **GitHub Pages**。
 
 ---
 
@@ -21,7 +21,7 @@
 执行以下命令：
 
 ```bash
-npm run build:itch
+yarn build:itch
 ```
 
 该命令会自动执行以下操作：
@@ -57,7 +57,7 @@ npm run build:itch
 配置好 `name` 字段后，只需运行：
 
 ```bash
-npm run deploy
+yarn deploy
 ```
 
 该命令会：
@@ -71,7 +71,7 @@ npm run deploy
 如果您想在本地测试生产构建的效果，可以运行：
 
 ```bash
-npm run preview
+yarn preview
 ```
 
 此命令会在本地启动一个静态文件服务器，预览 `dist` 目录的内容。
@@ -109,4 +109,4 @@ npm run preview
 2.  将您的代码推送到 `main` 分支。
 3.  稍等片刻，GitHub Actions 完成后，您的游戏就会在 GitHub Pages 网址上生效。
 
-这个自动化流程取代了原有的 `npm run deploy` 手动部署方式，让部署过程更可靠、更高效。 
+这个自动化流程取代了原有的 `yarn deploy` 手动部署方式，让部署过程更可靠、更高效。

docs/06-contributing.md

@@ -22,9 +22,9 @@
 
 1.  Fork 本仓库，并从 `main` 分支创建您的开发分支。
 2.  在您的分支上进行修改。
-3.  确保您的代码通过了 lint 检查 (`npm run lint`)。
+3.  确保您的代码通过了 lint 检查 (`yarn lint`)。
 4.  如果适用，为您的改动添加或更新测试。
-5.  确保所有测试都已通过 (`npm run test`)。
+5.  确保所有测试都已通过 (`yarn test`)。
 6.  如果您更改了行为或添加了新功能，请务必更新 `docs/` 目录下的相关文档。
 7.  向主仓库的 `main` 分支提交 Pull Request。
 
@@ -36,4 +36,4 @@
 
 ## 代码风格
 
-请遵循项目现有的代码风格。本项目使用 ESLint 和 Prettier 来保持代码风格的一致性。建议您在提交代码前先格式化代码。 
+请遵循项目现有的代码风格。本项目使用 ESLint 和 Prettier 来保持代码风格的一致性。建议您在提交代码前先格式化代码。

docs/07-optional-backend-integration.md

@@ -29,7 +29,7 @@
 3.  **安装契约包**：
     安装后端发布的类型包：
     ```bash
-    npm install @tobenot/basic-web-game-backend-contract@latest
+    yarn add @tobenot/basic-web-game-backend-contract@latest
     ```
 
 4.  **在代码中使用类型**：
@@ -56,35 +56,29 @@
 
 #### **1.2 配置`.npmrc`**
 
-在您的前端项目根目录下（与`package.json`同级）创建一个名为 `.npmrc` 的文件。这个文件会告诉npm去哪里寻找 `@<您的GitHub用户名>` 作用域下的包。
+在您的前端项目根目录下（与`package.json`同级）创建一个名为 `.npmrc` 的文件。这个文件会告诉Yarn去哪里寻找 `@<您的GitHub用户名>` 作用域下的包，并提供认证。
 
 文件内容如下：
-```
+```ini
 @<您的GitHub用户名>:registry=https://npm.pkg.github.com/
+//npm.pkg.github.com/:_authToken=您的PAT令牌
 ```
+将 `您的PAT令牌` 替换为您在 **步骤 1.1** 中创建的 GitHub Personal Access Token (PAT)。
 
-#### **1.3 登录到GitHub Packages**
-
-打开您的终端，运行以下命令以登录到 GitHub Packages。这将把您的凭证保存在本地，以便将来 `npm install` 时使用。
-
-```bash
-npm login --scope=@<您的GitHub用户名> --registry=https://npm.pkg.github.com
-```
-
-当提示时，请输入：
-*   **Username**: 您的GitHub用户名。
-*   **Password**: 您刚刚创建的 **Personal Access Token (PAT)** (注意，不是您的GitHub密码)。
-*   **Email**: 您的GitHub账户关联的邮箱。
+> **重要提示**: 包含令牌的 `.npmrc` 文件非常敏感。请务必将其添加到 `.gitignore` 文件中，以防止被提交到版本控制中。
+> ```bash
+> echo ".npmrc" >> .gitignore
+> ```
 
-#### **1.4 安装契约包**
+#### **1.3 安装契约包**
 
-一切准备就绪后，像安装任何其他npm包一样安装后端的类型契约包：
+一切准备就绪后，使用 `yarn` 安装后端的类型契约包：
 ```bash
-npm install @<您的GitHub用户名>/basic-web-game-backend-contract@latest
+yarn add @<您的GitHub用户名>/basic-web-game-backend-contract@latest
 ```
 `@latest` 标签可以确保您总是获取最新版本的类型定义。
 
-#### **1.5 在代码中使用类型**
+#### **1.4 在代码中使用类型**
 
 现在，您可以在项目的任何地方导入和使用后端定义的类型，享受完整的IDE自动补全和类型检查。
 
@@ -144,7 +138,7 @@ export const trpc = createTRPCProxyClient<AppRouter>({
 ```
 
 #### **2.3 创建GitHub Actions工作流**
-后端仓库中会有一个GitHub Actions工作流 (`.github/workflows/publish-contract.yml`)，用于在代码推送到 `main` 分支时自动构建和发布npm包。
+后端仓库中会有一个GitHub Actions工作流 (`.github/workflows/publish-contract.yml`)，用于在代码推送到 `main` 分支时自动构建和发布包。
 
 ```yaml
 # Backend's .github/workflows/publish-contract.yml
@@ -167,10 +161,10 @@ jobs:
           node-version: '18'
           registry-url: 'https://npm.pkg.github.com'
           scope: '@<您的GitHub用户名>'
-      - run: npm ci && npm run build
+      - run: yarn install --frozen-lockfile && yarn build
         env:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - run: npm publish
+      - run: yarn publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```