Merge pull request #9 from Tonnodoubt/mobile-app-v1

收口移动端 v1

Author: Tonnodoubt

.agents/skills/source-command-build-debug-apk/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: "source-command-build-debug-apk"
+description: "编译 Android debug APK，使用 Gradle 本地构建，不启动模拟器"
+---
+
+# source-command-build-debug-apk
+
+Use this skill when the user asks to run the migrated source command `build-debug-apk`.
+
+## Command Template
+
+# /build-debug-apk — 编译 Debug APK
+
+使用 Gradle 本地编译 Android debug APK。
+
+## 执行流程
+
+### 1. 检查项目配置
+
+确认以下文件存在：
+- `android/gradlew` — Gradle wrapper
+- `android/app/build.gradle` — 应用构建配置
+- `eas.json` — EAS 配置（可选）
+
+### 2. 执行编译
+
+```bash
+cd android && ./gradlew assembleDebug --no-daemon
+```
+
+### 3. 验证输出
+
+检查 APK 文件是否生成：
+- 标准路径：`android/app/build/outputs/apk/debug/app-debug.apk`
+
+### 4. 输出结果
+
+显示：
+- APK 文件路径
+- 文件大小
+- 安装命令示例
+
+## 输出格式
+
+```
+✅ Debug APK 编译成功！
+
+路径：android/app/build/outputs/apk/debug/app-debug.apk
+大小：XXX MB
+
+安装到设备：
+adb install -r android/app/build/outputs/apk/debug/app-debug.apk
+```
+
+## 注意事项
+
+- 首次编译可能需要下载依赖，耗时较长
+- 确保已安装 Android SDK 和 Gradle
+- 如需清理后重新编译，使用 `./gradlew clean` 后再 assembleDebug

.agents/skills/source-command-review/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: "source-command-review"
+description: "提交前代码审查。检查 staged 变更的质量、架构规范、RN 最佳实践，输出问题列表。在 /commit 前运行以保证代码质量。"
+---
+
+# source-command-review
+
+Use this skill when the user asks to run the migrated source command `review`.
+
+## Command Template
+
+# /review — 提交前代码审查
+
+对即将提交的变更做系统性检查，避免把问题带入 commit 历史。
+
+## 执行步骤
+
+### 1. 收集变更上下文
+
+```bash
+git status                   # 查看 staged / unstaged 文件列表
+git diff --staged            # 分析 staged 变更内容
+git diff                     # 确认是否有未暂存的相关变更
+```
+
+### 2. 运行 Lint
+
+```bash
+npx expo lint
+```
+
+如有错误，先列出并说明修复方向，再继续后续检查。
+
+### 3. 逐项检查
+
+对每个 staged 文件按下列维度审查，只报告**实际存在的问题**，没有问题的维度跳过。
+
+#### A. TypeScript 类型安全
+- 有无 `any` 类型滥用（尤其是 API 响应、事件回调）
+- 有无缺失 `undefined` / `null` 处理
+- 泛型使用是否合理
+
+#### B. React Native 最佳实践
+- StyleSheet 是否在组件外定义（避免每次渲染重建对象）
+- 平台差异处理：`Platform.OS` 分支、`.android.tsx` / `.ios.tsx` 文件分离
+- `FlatList` 是否提供 `keyExtractor`；长列表是否启用 `getItemLayout`
+- 异步操作是否在组件卸载后有 cleanup（防止 `setState` on unmounted）
+- 图片资源是否使用 `require()` 而非网络 URI 直接展示静态资产
+
+#### C. 项目架构规范（`docs/arch/design.md`）
+- **Service 层**（`services/`）：不得直接依赖 React 组件生命周期；纯 TS Class，无 hooks 调用
+- **Hook 桥接层**（`hooks/`）：不得包含业务逻辑，只做事件→状态映射
+- **Manager 单例**（MainManager）：跨 Service 协调逻辑统一放在 Manager，不散落到 UI 层
+- `components/` 不应直接 import Service 实例，应通过 Hook 消费
+
+#### D. 包依赖边界
+- `@project_neko/*` 内部包的修改是否需要同步运行 `npm run sync:neko-packages`
+- 有无引入新的外部依赖但未更新 `package.json`
+
+#### E. 遗漏项
+- 修改了功能但没有更新对应的 `docs/` 文档
+- 有无调试用的 `console.log` / `TODO` 未清理
+- 新增文件是否加入了正确的 TypeScript path alias
+
+### 4. 输出格式
+
+```
+## 审查结果
+
+### Lint
+✅ 无错误  /  ❌ N 个错误（列出文件和行号）
+
+### 问题列表
+
+🔴 [严重] services/AudioService.ts:42
+   直接在 Service 内调用了 useState，违反 Service 层规范
+   建议：将状态提升到 useAudio hook
+
+🟡 [警告] components/VoiceButton.tsx:18
+   StyleSheet 定义在组件函数内部，每次渲染会重建
+   建议：移到组件外顶层定义
+
+🔵 [建议] hooks/useLive2D.ts:95
+   缺少卸载时的 cleanup，可能导致内存泄漏
+
+### 结论
+
+⛔ 建议修复严重问题后再提交  /  ✅ 可以提交（附注意事项）
+```
+
+严重性说明：
+- 🔴 严重：架构违规、潜在 crash、类型不安全
+- 🟡 警告：性能问题、代码质量问题
+- 🔵 建议：可选优化，不阻断提交

.gitmodules

@@ -1,6 +1,6 @@
 [submodule "packages/react-native-pcm-stream"]
 	path = packages/react-native-pcm-stream
-	url = https://github.com/noahzaozao/react-native-pcm-stream.git
+	url = https://github.com/Tonnodoubt/react-native-pcm-stream.git
 [submodule "packages/react-native-live2d"]
 	path = packages/react-native-live2d
-	url = https://github.com/noahzaozao/react-native-live2d.git
+	url = https://github.com/Tonnodoubt/react-native-live2d.git

AGENTS.md

@@ -0,0 +1,25 @@
+# N.E.K.O.-RN
+
+## Build
+
+```bash
+# 编译 debug APK（唯一方式，不要用 expo run:android）
+cd android && ./gradlew assembleDebug
+```
+
+APK 输出：`android/app/build/outputs/apk/debug/app-debug.apk`
+
+## 项目结构
+
+- `app/` — Expo Router 页面
+- `components/` — 通用 UI 组件
+- `services/` — 业务服务层
+- `hooks/` — React hooks
+- `packages/` — 原生模块（react-native-pcm-stream, react-native-live2d 等）
+- `android/` — Android 原生工程
+- `i18n/` — 国际化
+
+## 关键约定
+
+- 嘴形同步：JS 层做平滑（LipSyncService），Kotlin 层做时间对齐（PCMStreamPlayer 按 playbackHeadPosition 取振幅）
+- 修改 Kotlin 原生代码后需要 `./gradlew assembleDebug` 重新编译，Metro 热更新不生效

CLAUDE.md

@@ -0,0 +1,25 @@
+# N.E.K.O.-RN
+
+## Build
+
+```bash
+# 编译 debug APK（唯一方式，不要用 expo run:android）
+cd android && ./gradlew assembleDebug
+```
+
+APK 输出：`android/app/build/outputs/apk/debug/app-debug.apk`
+
+## 项目结构
+
+- `app/` — Expo Router 页面
+- `components/` — 通用 UI 组件
+- `services/` — 业务服务层
+- `hooks/` — React hooks
+- `packages/` — 原生模块（react-native-pcm-stream, react-native-live2d 等）
+- `android/` — Android 原生工程
+- `i18n/` — 国际化
+
+## 关键约定
+
+- 嘴形同步：JS 层做平滑（LipSyncService），Kotlin 层做时间对齐（PCMStreamPlayer 按 playbackHeadPosition 取振幅）
+- 修改 Kotlin 原生代码后需要 `./gradlew assembleDebug` 重新编译，Metro 热更新不生效

app/(tabs)/_layout.tsx

@@ -1,21 +1,102 @@
 import { Tabs } from 'expo-router';
 import React from 'react';
 import { Ionicons } from '@expo/vector-icons';
+import { Platform, StyleSheet, TouchableOpacity, View, Text } from 'react-native';
+import { BlurView } from 'expo-blur';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import * as Haptics from 'expo-haptics';
 
-import { HapticTab } from '@/components/haptic-tab';
-import { Colors } from '@/constants/theme';
-import { useColorScheme } from '@/hooks/use-color-scheme';
+import { useTheme } from '@/constants/ThemeContext';
+
+function GlassTabBar({ state, descriptors, navigation }: any) {
+  const theme = useTheme();
+  const cc = theme.colors;
+  const insets = useSafeAreaInsets();
+
+  return (
+    <BlurView
+      intensity={theme.isDark ? 40 : 60}
+      tint={theme.isDark ? 'dark' : 'light'}
+      style={[
+        styles.tabBar,
+        {
+          paddingBottom: Math.max(insets.bottom, 8),
+          borderColor: cc.border,
+        },
+      ]}
+    >
+      {state.routes.map((route: any, index: number) => {
+        const { options } = descriptors[route.key];
+        const isFocused = state.index === index;
+        const label = options.title ?? route.name;
+        const Icon = options.tabBarIcon;
+
+        const onPress = () => {
+          if (Platform.OS === 'ios') {
+            Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
+          }
+          const event = navigation.emit({ type: 'tabPress', target: route.key, canPreventDefault: true });
+          if (!isFocused && !event.defaultPrevented) {
+            navigation.navigate(route.name);
+          }
+        };
+
+        return (
+          <TouchableOpacity
+            key={route.key}
+            onPress={onPress}
+            style={[
+              styles.tabItem,
+              isFocused && { backgroundColor: cc.accentSoft },
+            ]}
+            activeOpacity={0.7}
+          >
+            {Icon && <Icon size={22} color={isFocused ? cc.accent : cc.textMuted} />}
+            <Text
+              style={[
+                styles.tabLabel,
+                { color: isFocused ? cc.accent : cc.textMuted },
+              ]}
+            >
+              {label}
+            </Text>
+          </TouchableOpacity>
+        );
+      })}
+    </BlurView>
+  );
+}
+
+const styles = StyleSheet.create({
+  tabBar: {
+    flexDirection: 'row',
+    borderTopWidth: 1,
+    paddingTop: 6,
+  },
+  tabItem: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    gap: 3,
+    paddingVertical: 6,
+    borderRadius: 12,
+  },
+  tabLabel: {
+    fontSize: 11,
+    fontWeight: '500',
+  },
+});
 
 export default function TabLayout() {
-  const colorScheme = useColorScheme();
+  const theme = useTheme();
 
   return (
     <Tabs
+      tabBar={(props) => <GlassTabBar {...props} />}
       screenOptions={{
-        tabBarActiveTintColor: Colors[colorScheme ?? 'light'].tint,
         headerShown: false,
-        tabBarButton: HapticTab,
-      }}>
+      }}
+    >
       <Tabs.Screen
         name="index"
         options={{