fix: stabilize audio, GH Pages preview, and build workflow

Author: lila233

.dockerignore

@@ -1,5 +1,6 @@
 node_modules
 dist
+gh-pages-preview
 .expo
 .git
 .github

.github/workflows/build-apk.yml

@@ -43,13 +43,22 @@ jobs:
         id: build
         run: |
           echo "::group::Starting EAS Build"
-          BUILD_JSON=$(eas build --platform android --profile preview --non-interactive --json 2>&1) || {
+          # 运行 eas build，将 stderr 重定向到文件以便调试
+          eas build --platform android --profile preview --non-interactive --json > build_output.json 2> build_stderr.txt || {
             echo "::error::EAS build command failed"
-            echo "$BUILD_JSON"
+            cat build_stderr.txt
+            cat build_output.json
             exit 1
           }
-          echo "$BUILD_JSON"
-          BUILD_ID=$(echo "$BUILD_JSON" | jq -r '.[0].id // empty')
+
+          # 显示输出用于调试
+          echo "Build stderr:"
+          cat build_stderr.txt || true
+          echo "Build output:"
+          cat build_output.json
+
+          # 解析 JSON 获取 build ID
+          BUILD_ID=$(jq -r '.[0].id // empty' build_output.json)
           if [ -z "$BUILD_ID" ]; then
             echo "::error::Failed to extract build ID from response"
             exit 1
@@ -86,7 +95,7 @@ jobs:
               continue
             fi
 
-            STATUS=$(echo "$BUILD_INFO" | jq -r '.status // "unknown"')
+            STATUS=$(echo "$BUILD_INFO" | jq -r '.status // "unknown"' | tr '[:upper:]' '[:lower:]')
             echo "Current status: $STATUS"
 
             case "$STATUS" in
@@ -128,7 +137,7 @@ jobs:
           else
             VERSION="dev-$(date +%Y%m%d-%H%M%S)"
           fi
-          FILENAME="gojuon-${VERSION}.apk"
+          FILENAME="gojuon-${VERSION}-universal.apk"
           echo "filename=$FILENAME" >> $GITHUB_OUTPUT
           echo "APK will be saved as: $FILENAME"
 

.gitignore

@@ -5,6 +5,7 @@ node_modules/
 .expo/
 dist/
 web-build/
+gh-pages-preview/
 
 # Native builds
 android/

App.tsx

@@ -10,7 +10,9 @@ import Constants from 'expo-constants';
 import { audioService } from './src/utils/audio';
 
 // 获取 baseUrl（用于 GitHub Pages 等子路径部署）
-const baseUrl = Constants.expoConfig?.web?.baseUrl || '';
+const rawBaseUrl = Constants.expoConfig?.web?.baseUrl || '';
+const normalizedBaseUrl = rawBaseUrl.endsWith('/') ? rawBaseUrl.slice(0, -1) : rawBaseUrl;
+const baseUrl = resolveBaseUrl();
 
 import { StudyProvider } from './src/contexts/StudyContext';
 import { ThemeProvider, useTheme } from './src/contexts/ThemeContext';
@@ -39,7 +41,7 @@ type RootStackParamList = {
 
 // Linking configuration with proper typing
 const linking: LinkingOptions<RootStackParamList> = {
-  prefixes: [baseUrl],
+  prefixes: baseUrl ? [baseUrl] : [],
   config: {
     screens: {
       Main: {
@@ -56,12 +58,26 @@ const linking: LinkingOptions<RootStackParamList> = {
   },
 };
 
-// Tab 图标配置
+function resolveBaseUrl(): string {
+  if (Platform.OS !== 'web') return '';
+  if (!normalizedBaseUrl) return '';
+  if (typeof window === 'undefined') return normalizedBaseUrl;
+
+  const path = window.location.pathname || '';
+  if (path === normalizedBaseUrl || path.startsWith(`${normalizedBaseUrl}/`)) {
+    return normalizedBaseUrl;
+  }
+
+  // 当部署在根路径时，不应用 baseUrl
+  return '';
+}
+
+// Tab 图标配置 - 使用日语汉字
 const TAB_CONFIG: Record<string, { icon: string }> = {
-  Home: { icon: '○' },
-  Browse: { icon: '田' },
-  Stats: { icon: '〓' },
-  Settings: { icon: '◎' },
+  Home: { icon: '学' },    // 学習 - 学习
+  Browse: { icon: '表' },  // 五十音表 - 图表
+  Stats: { icon: '績' },   // 成績 - 成绩
+  Settings: { icon: '設' }, // 設定 - 设置
 };
 
 // 自定义浮动 TabBar 组件

README.md

@@ -49,7 +49,7 @@ docker-compose up -d
 - **导航**：React Navigation (stack + bottom-tabs)
 - **状态管理**：React Context API
 - **存储**：AsyncStorage 本地存储
-- **音频**：expo-av (本地 MP3) + expo-speech (TTS 备用)
+- **音频**：expo-av (104个预生成 MP3 文件)
 - **构建**：EAS Build (Android) / GitHub Actions (Web + Docker)
 
 ## 开发指南
@@ -95,6 +95,22 @@ eas build --platform android --profile preview
 npx expo export --platform web
 ```
 
+### 本地预览 GH Pages 路径
+
+Expo 导出的 `index.html` 默认使用根路径（例如 `/_expo/...`），而 GitHub Pages 部署在 `/<repo>` 子路径下。
+为了避免本地预览 404，使用下面的脚本会自动重写 `index.html` 的资源路径到 `/<repo>`：
+
+```bash
+# 生成 GH Pages 预览目录并修正资源路径
+npm run preview:gh-pages
+
+# 启动本地静态服务器（任选其一）
+py -m http.server 4175 --directory gh-pages-preview --bind 127.0.0.1
+# 或 npx serve gh-pages-preview
+```
+
+打开 `http://127.0.0.1:4175/gojuon/` 查看效果。
+
 ## 项目结构
 
 ```
@@ -154,7 +170,6 @@ gojuon/
 
 - 使用 Google Cloud TTS (Wavenet 日语女声) 预生成 104 个高质量发音文件
 - Web 端自动加载 MP3 文件，原生端使用预打包资源
-- 支持 TTS 实时合成作为备用方案
 - 播放速度 0.85x，发音更清晰
 
 ## 许可证

eas.json

@@ -1,6 +1,7 @@
 {
   "cli": {
-    "version": ">= 7.0.0"
+    "version": ">= 7.0.0",
+    "appVersionSource": "local"
   },
   "build": {
     "development": {

package-lock.json

@@ -6,7 +6,9 @@
     "start": "expo start",
     "android": "expo start --android",
     "ios": "expo start --ios",
-    "web": "expo start --web"
+    "web": "expo start --web",
+    "export:web": "expo export --platform web",
+    "preview:gh-pages": "npm run export:web && node scripts/gh-pages-preview.mjs"
   },
   "dependencies": {
     "@react-native-async-storage/async-storage": "^2.2.0",
@@ -21,7 +23,6 @@
     "expo-clipboard": "~8.0.8",
     "expo-linear-gradient": "^15.0.8",
     "expo-notifications": "~0.32.15",
-    "expo-speech": "~14.0.8",
     "expo-status-bar": "~3.0.9",
     "react": "19.1.0",
     "react-dom": "19.1.0",