Release v1.4.0

.github/workflows/release-manager.yml

@@ -0,0 +1,51 @@
+name: Release Manager
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  actions: read
+  checks: read
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Release version, for example 1.3.1
+        required: true
+        type: string
+      action:
+        description: Release action
+        required: true
+        default: full
+        type: choice
+        options:
+          - full
+          - prepare
+          - promote
+          - verify
+
+concurrency:
+  group: release-manager
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Release Manager
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.RELEASE_MANAGER_TOKEN || github.token }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Run release manager
+        env:
+          GH_TOKEN: ${{ secrets.RELEASE_MANAGER_TOKEN || github.token }}
+        run: node scripts/release-manager.mjs "${{ inputs.action }}" --version "${{ inputs.version }}"

.gitignore

@@ -13,6 +13,8 @@
 
 # testing
 /coverage
+/test-results
+/playwright-report
 
 # next.js
 /.next/

README.md

@@ -192,8 +192,9 @@ ASR/TTS provider keys (all optional — mock/native fallback works without them)
 ASR_PROVIDER=native
 TTS_PROVIDER=mock
 XUNFEI_APP_ID=
+XUNFEI_API_PASSWORD=              # preferred; sent as the server-side x-api-key header
 XUNFEI_API_KEY=
-XUNFEI_API_SECRET=
+XUNFEI_API_SECRET=                # APIKey + APISecret remain supported as a fallback
 XUNFEI_ASR_PRODUCT=zh_iat
 XUNFEI_TTS_VOICE=                 # default fallback vcn; coach voice is selectable in Settings
 VOLCENGINE_ACCESS_KEY=
@@ -255,6 +256,18 @@ Set the API base URL in `apps/mobile/app.json`:
 }
 ```
 
+## Release Management
+
+Production releases are managed by the GitHub Actions `Release Manager` workflow:
+
+```text
+GitHub -> Actions -> Release Manager -> Run workflow
+```
+
+Use `action=full` with a semantic version such as `1.3.1`. The workflow creates the release issue and PRs, waits for checks, promotes `main` to `release`, waits for Tencent deployment, verifies public URLs, and creates the GitHub Release.
+
+Detailed operation and recovery steps live in `docs/release-manager.md`.
+
 ## TTS Providers
 
 Domestic providers are the recommended real voice path:

README.zh-CN.md

@@ -192,8 +192,9 @@ ASR/TTS 服务商密钥（均可选，不填则使用 mock/native 兜底）：
 ASR_PROVIDER=native
 TTS_PROVIDER=mock
 XUNFEI_APP_ID=
+XUNFEI_API_PASSWORD=              # 推荐；仅由服务端通过 x-api-key 请求头发送
 XUNFEI_API_KEY=
-XUNFEI_API_SECRET=
+XUNFEI_API_SECRET=                # 仍兼容 APIKey + APISecret 作为兜底鉴权
 XUNFEI_ASR_PRODUCT=zh_iat
 XUNFEI_TTS_VOICE=                 # 默认兜底 vcn；具体教练声音在设置页选择
 VOLCENGINE_ACCESS_KEY=
@@ -255,6 +256,18 @@ eas build --platform ios --profile preview
 }
 ```
 
+## 发布管理
+
+生产发布通过 GitHub Actions 的 `Release Manager` workflow 管理：
+
+```text
+GitHub -> Actions -> Release Manager -> Run workflow
+```
+
+选择 `action=full`，输入类似 `1.3.1` 的语义化版本号。workflow 会自动创建 release issue 和 PR，等待检查通过，将 `main` 提升到 `release`，等待腾讯云部署，验证公网 URL，并创建 GitHub Release。
+
+详细操作和中断恢复步骤见 `docs/release-manager.md`。
+
 ## TTS 服务商
 
 国内用户推荐使用以下服务商：

apps/mobile/app.json

@@ -3,15 +3,15 @@
     "name": "MeteorVoice",
     "slug": "meteorvoice-mobile",
     "owner": "junchenmeteors-team",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "orientation": "portrait",
     "scheme": "meteorvoice",
     "userInterfaceStyle": "automatic",
     "icon": "./assets/icon.png",
     "ios": {
       "supportsTablet": true,
-      "bundleIdentifier": "com.tzcpa.meteorvoice",
-      "buildNumber": "2026060601",
+      "bundleIdentifier": "com.jcmeteor.meteorvoice",
+      "buildNumber": "2026071101",
       "deploymentTarget": "18.0",
       "infoPlist": {
         "NSMicrophoneUsageDescription": "MeteorVoice uses the microphone for voice practice sessions.",
@@ -26,7 +26,7 @@
     },
     "android": {
       "package": "com.jcmeteor.meteorvoice",
-      "versionCode": 2026060601,
+      "versionCode": 2026071101,
       "permissions": [
         "android.permission.RECORD_AUDIO",
         "android.permission.MODIFY_AUDIO_SETTINGS",
@@ -37,6 +37,7 @@
       ]
     },
     "plugins": [
+      "expo-router",
       [
         "expo-speech-recognition",
         {

apps/mobile/app/(tabs)/_layout.tsx

@@ -0,0 +1,169 @@
+/**
+ * Four-tab layout using the original MeteorVoice visual language.
+ * The tab bar stays opaque and participates in layout so scroll content never
+ * shows through or underneath it.
+ */
+import { Tabs } from 'expo-router'
+import {
+  Pressable,
+  StyleSheet,
+  Text,
+  View,
+} from 'react-native'
+import { SafeAreaView } from 'react-native-safe-area-context'
+
+import { useSession } from '../../src/SessionContext'
+import { useTheme } from '../../src/ThemeProvider'
+
+const TAB_LABELS: Record<string, string> = {
+  home: 'nav.home',
+  session: 'nav.practice',
+  history: 'nav.history',
+  settings: 'nav.settings',
+}
+
+function TabIcon({ tab, color }: { color: string; tab: string }) {
+  if (tab === 'home') return (
+    <View style={styles.homeIcon}>
+      <View style={[styles.homeRoof, { borderBottomColor: color }]} />
+      <View style={[styles.homeBody, { backgroundColor: color }]} />
+    </View>
+  )
+
+  if (tab === 'session') return (
+    <View style={styles.sessionIcon}>
+      <View style={[styles.microphone, { borderColor: color }]} />
+      <View style={[styles.microphoneBase, { backgroundColor: color }]} />
+    </View>
+  )
+
+  if (tab === 'history') return (
+    <View style={styles.historyIcon}>
+      {[18, 14, 10].map(width => (
+        <View key={width} style={[styles.historyLine, { width, backgroundColor: color }]} />
+      ))}
+    </View>
+  )
+
+  return (
+    <View style={styles.settingsIcon}>
+      <View style={[styles.settingsCenter, { borderColor: color }]} />
+      <View style={styles.settingsDots}>
+        {[0, 45, 90, 135].map(deg => (
+          <View
+            key={deg}
+            style={[
+              styles.settingsDot,
+              { backgroundColor: color, transform: [{ rotate: `${deg}deg` }, { translateY: -8 }] },
+            ]}
+          />
+        ))}
+      </View>
+    </View>
+  )
+}
+
+export default function TabLayout() {
+  const { C } = useTheme()
+  const { tr } = useSession()
+
+  return (
+    <SafeAreaView edges={['top']} style={[styles.shell, { backgroundColor: C.bg }]}>
+      <Tabs
+        screenOptions={{ headerShown: false }}
+        tabBar={({ state, navigation }) => (
+          <SafeAreaView edges={['bottom']} style={[styles.tabBarWrapper, { backgroundColor: C.bg }]}>
+            <View style={[styles.tabBar, { backgroundColor: C.surface, borderColor: C.border }]}>
+              {state.routes.map((route, index) => {
+                const focused = state.index === index
+                const labelKey = TAB_LABELS[route.name]
+
+                return (
+                  <Pressable
+                    key={route.key}
+                    accessibilityRole="button"
+                    accessibilityState={focused ? { selected: true } : {}}
+                    accessibilityLabel={labelKey ? tr(labelKey) : route.name}
+                    onLongPress={() => navigation.emit({ type: 'tabLongPress', target: route.key })}
+                    onPress={() => {
+                      const event = navigation.emit({
+                        type: 'tabPress',
+                        target: route.key,
+                        canPreventDefault: true,
+                      })
+                      if (!focused && !event.defaultPrevented) navigation.navigate(route.name)
+                    }}
+                    style={[styles.tabItem, focused && { backgroundColor: C.accent }]}
+                  >
+                    <TabIcon tab={route.name} color={focused ? C.cream : C.textMuted} />
+                    <Text style={[styles.tabLabel, { color: focused ? C.cream : C.textMuted }]}>
+                      {labelKey ? tr(labelKey) : route.name}
+                    </Text>
+                  </Pressable>
+                )
+              })}
+            </View>
+          </SafeAreaView>
+        )}
+      >
+        <Tabs.Screen name="home" />
+        <Tabs.Screen name="session" />
+        <Tabs.Screen name="history" />
+        <Tabs.Screen name="settings" />
+      </Tabs>
+    </SafeAreaView>
+  )
+}
+
+const styles = StyleSheet.create({
+  shell: { flex: 1 },
+  tabBarWrapper: {
+    paddingHorizontal: 16,
+    paddingTop: 6,
+    paddingBottom: 8,
+  },
+  tabBar: {
+    flexDirection: 'row',
+    borderRadius: 24,
+    borderWidth: 1,
+    paddingVertical: 4,
+    paddingHorizontal: 4,
+    overflow: 'hidden',
+  },
+  tabItem: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    paddingVertical: 8,
+    gap: 2,
+    borderRadius: 20,
+  },
+  tabLabel: { fontSize: 10, fontWeight: '600' },
+  homeIcon: { width: 18, height: 18, alignItems: 'center', justifyContent: 'flex-end' },
+  homeRoof: {
+    width: 0,
+    height: 0,
+    borderLeftWidth: 9,
+    borderRightWidth: 9,
+    borderBottomWidth: 8,
+    borderLeftColor: 'transparent',
+    borderRightColor: 'transparent',
+    marginBottom: 1,
+  },
+  homeBody: { width: 12, height: 8, borderRadius: 1 },
+  sessionIcon: { width: 18, height: 18, alignItems: 'center', justifyContent: 'center', gap: 1 },
+  microphone: { width: 8, height: 11, borderRadius: 4, borderWidth: 2 },
+  microphoneBase: { width: 12, height: 2, borderRadius: 1 },
+  historyIcon: { width: 18, height: 18, justifyContent: 'center', gap: 3 },
+  historyLine: { height: 2, borderRadius: 1 },
+  settingsIcon: { width: 18, height: 18, alignItems: 'center', justifyContent: 'center' },
+  settingsCenter: { width: 10, height: 10, borderRadius: 5, borderWidth: 2 },
+  settingsDots: {
+    position: 'absolute',
+    width: 18,
+    height: 18,
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  settingsDot: { position: 'absolute', width: 3, height: 3, borderRadius: 1.5 },
+})

apps/mobile/app/(tabs)/history.tsx

@@ -0,0 +1,24 @@
+/**
+ * History tab — session history and review screen.
+ * 历史标签页 — 会话历史与回顾界面。
+ */
+
+import { useMobileAuth } from '../../src/mobileAuth'
+import { HistoryScreen } from '../../src/screens/HistoryScreen'
+import { useSession } from '../../src/SessionContext'
+
+export default function HistoryTab() {
+  const { tr, locale, api } = useSession()
+  const auth = useMobileAuth()
+
+  return (
+    <HistoryScreen
+      tr={tr}
+      locale={locale}
+      api={api}
+      getAuthHeaders={auth.getAuthHeaders}
+      handleUnauthorized={() => auth.signOut(null)}
+      defaultApiBaseUrl=""
+    />
+  )
+}

apps/mobile/app/(tabs)/home.tsx

@@ -0,0 +1,26 @@
+/**
+ * Home tab — scenario selection screen.
+ * 首页标签页 — 场景选择界面。
+ */
+
+import { useRouter } from 'expo-router'
+
+import { scenarios } from '@meteorvoice/shared'
+
+import { HomeScreen } from '../../src/screens/HomeScreen'
+import { useSession } from '../../src/SessionContext'
+
+export default function HomeTab() {
+  const { tr, locale } = useSession()
+  const router = useRouter()
+
+  return (
+    <HomeScreen
+      tr={tr}
+      locale={locale}
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      scenarios={scenarios as any}
+      onGoToSession={() => router.replace('/(tabs)/session')}
+    />
+  )
+}