🎙️ AiRecord

✨ 产品简介

🎯 核心价值

📱 功能一览

🔴 录音与转写

🤖 AI 智能分析

📚 RAG 知识库

📊 数据洞察

🎯 面试对比矩阵

⚡ 更多特性

🏗 技术架构

┌─────────────────────────────────────────────────┐
│ 📱 Expo SDK 54 / React Native │
│ ┌──────────┐ ┌──────────┐ ┌─────┐ ┌──────────┐ │
│ │ 录音首页 │ │ 录音历史 │ │ 待办 │ │ 设置 │ │
│ └──────────┘ └──────────┘ └─────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│ │ 知识库 │ │ 面试对比 │ │ 知识图谱 │ │
│ └──────────┘ └──────────┘ └──────────────────┘ │
├─────────────────────────────────────────────────┤
│ 🌐 REST API (31 端点) │
├─────────────────────────────────────────────────┤
│ ⚡ FastAPI 0.115.12 + Uvicorn │
│ ┌────────────────────────────────────────────┐ │
│ │ Routers │ │
│ │ recordings · todos · stats · knowledge │ │
│ │ interviews · shortcuts │ │
│ ├────────────────────────────────────────────┤ │
│ │ Services │ │
│ │ asr_service → 火山引擎 ASR │ │
│ │ ai_service → DeepSeek LLM │ │
│ │ knowledge_svc → ChromaDB RAG │ │
│ │ storage_svc → 文件管理 │ │
│ ├────────────────────────────────────────────┤ │
│ │ Storage │ │
│ │ SQLite (FTS5) · ChromaDB · 本地文件系统 │ │
│ └────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────┤
│ 🐳 Docker + Nginx (生产) │
└─────────────────────────────────────────────────┘

📂 项目结构

AiRecord/
├── client/ # 📱 前端 (Expo SDK 54 / React Native 0.81)
│ ├── app/
│ │ ├── (tabs)/
│ │ │ ├── _layout.tsx # 🧭 Tab 导航布局
│ │ │ ├── index.tsx # 🎙️ 录音首页
│ │ │ ├── history.tsx # 📋 录音历史 + 语音搜索
│ │ │ ├── todos.tsx # ✅ 待办管理
│ │ │ └── settings.tsx # ⚙️ 设置 + 功能入口
│ │ ├── recording/[id].tsx # 📄 录音详情 + 分析报告
│ │ ├── knowledge.tsx # 💬 知识库对话查询
│ │ ├── interviews.tsx # 🎯 面试对比矩阵
│ │ ├── topic-graph.tsx # 🌐 知识图谱可视化
│ │ ├── _layout.tsx # 📐 根导航布局
│ │ ├── +html.tsx # 🌐 Web 模板
│ │ └── +not-found.tsx # 404 页面
│ ├── components/
│ │ ├── Waveform.tsx # 🌊 录音波形动画
│ │ ├── Themed.tsx # 🎨 主题化组件
│ │ └── ... # 其他通用组件
│ ├── services/
│ │ ├── api.ts # 🔗 Axios API 客户端
│ │ ├── audioPlayer.ts # 🔊 音频播放服务
│ │ └── audioRecorder.ts # 🎤 录音服务封装
│ ├── stores/
│ │ └── recordingStore.ts # 📦 Zustand 状态管理
│ ├── constants/
│ │ ├── theme.ts # 🎨 设计令牌
│ │ └── Colors.ts # 🎨 色彩常量
│ └── types/index.ts # 📝 TypeScript 类型定义
│
├── server/ # ⚡ 后端 (FastAPI 0.115.12)
│ ├── app/
│ │ ├── main.py # 🚀 应用入口 + 生命周期 + 日志
│ │ ├── config.py # ⚙️ Pydantic Settings 配置
│ │ ├── database/
│ │ │ └── connection.py # 🗄️ SQLite + FTS5 初始化
│ │ ├── models/
│ │ │ └── recording.py # 📋 Pydantic 数据模型
│ │ ├── routers/
│ │ │ ├── recordings.py # 🎙️ 录音 CRUD + 转写/分析
│ │ │ ├── todos.py # ✅ 待办 CRUD + 逾期检测
│ │ │ ├── stats.py # 📊 仪表盘 + 周报 + 僵尸议题
│ │ │ ├── knowledge.py # 📚 RAG 查询 + 语义搜索 + 图谱
│ │ │ ├── interviews.py # 🎯 候选人对比 + HR 报告
│ │ │ └── shortcuts.py # 🍎 iOS Shortcuts 纯文本接口
│ │ └── services/
│ │ ├── asr_service.py # 🎤 火山引擎 ASR 集成
│ │ ├── ai_service.py # 🧠 DeepSeek LLM 分析
│ │ ├── knowledge_service.py # 📚 ChromaDB RAG 管道
│ │ └── storage_service.py # 💾 文件存储管理
│ ├── logs/ # 📜 运行日志(自动轮转)
│ ├── uploads/ # 📁 录音文件存储
│ ├── requirements.txt
│ ├── Dockerfile
│ ├── .env.example # 🔒 环境变量模板
│ └── .env # 🔒 环境变量(不入库)
│
├── deploy/ # 🐳 部署配置
│ ├── nginx.conf # Nginx 反向代理
│ ├── deploy.sh # 一键部署脚本
│ └── ssl/ # HTTPS 证书目录
│
├── docker-compose.yml # 容器编排
└── .gitignore # Git 忽略规则

🚀 快速开始

前置要求

1️⃣ 克隆项目

git clone https://github.com/your-username/AiRecord.git
cd AiRecord

2️⃣ 启动后端

cd server
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp .env.example .env
# 编辑 .env 填入以下密钥:
# VOLCANO_ACCESS_KEY=你的火山引擎AccessKey
# VOLCANO_SECRET_KEY=你的火山引擎SecretKey
# VOLCANO_APP_ID=你的火山引擎AppId
# DEEPSEEK_API_KEY=你的DeepSeek密钥
# 启动服务(开发模式)
DEV_MODE=1 python -m app.main
# 或
DEV_MODE=1 uvicorn app.main:app --reload --port 8000

3️⃣ 启动前端

cd client
# 安装依赖
npm install
# 启动 Expo 开发服务器
npx expo start

4️⃣ 生产部署(Docker)

# 一键启动
docker-compose up -d
# 或使用部署脚本(rsync 到远程服务器)
bash deploy/deploy.sh

🔌 API 概览 (31 端点)

⚙️ 环境变量

# 🎤 火山引擎 ASR(语音识别)
# 获取方式: https://console.volcengine.com/speech/service/8
VOLCANO_ACCESS_KEY=your_access_key
VOLCANO_SECRET_KEY=your_secret_key
VOLCANO_APP_ID=your_app_id
# 🧠 DeepSeek LLM(AI 分析)
# 获取方式: https://platform.deepseek.com/api_keys
DEEPSEEK_API_KEY=your_deepseek_key
# 📦 可选配置
# DATABASE_URL=sqlite+aiosqlite:///./airecord.db
# HOST=0.0.0.0
# PORT=8000

🍎 iOS Shortcuts 集成

🛠 技术栈

📈 项目进度

总进度: █████████████████████ 96% (101/105)
✅ 已完成 & 联调通过:
 Phase 1-9 基础架构 + 录音 + 转写 + 分析 + UI
 Phase 11-12 UI 优化 + 待办管理
 Phase 13 语音搜索 + 高光回放
 Phase 14 RAG 知识图谱
 Phase 15 面试对比矩阵
 Phase 16 待办闭环 + iOS Shortcuts
 Phase 17 部署方案 (Docker/Nginx)
 Hotfix 火山 ASR 长音频分片 + 前端显示同步
⬜ 待完成 (需要真实设备/服务器):
 Phase 10 真机测试验收 (2 项)
 Phase 17 生产部署 + HTTPS (2 项)

🧪 联调验证

修复记录

🖥 界面预览

🤝 贡献

📄 License