声智禁拟 - 音频隐私保护系统

最新更新: 已完成从Python到TypeScript的完整迁移！🚀

声智禁拟是一个先进的音频隐私保护系统，通过添加人耳难以察觉的保护性噪声来防止音频被恶意录制和AI识别学习。

👥 项目协作

本项目为协作开发，主要参与者：

• @snozzz — 主要开发者（相关工作 snozzz/AS）
• @lsdogXG (AsuTroyes) — 共创者，参与前端 / TypeScript 迁移

✨ 核心特性

• 🛡️ 智能音频保护: 添加错误最小化噪声和超声波
• 🎙️ 实时保护模式: Scene模式实时处理麦克风音频
• 📁 文件处理模式: 批量处理音频文件
• 🎯 多种保护策略: 误差最小化、超声波、综合保护
• 🚀 现代化架构: TypeScript + React + Express.js

🏗️ 技术架构

后端 (TypeScript)

• 框架: Express.js + TypeScript
• 音频处理: FFmpeg
• API设计: RESTful
• 端口: 5001

前端 (React)

• 框架: React + TypeScript
• 样式: Tailwind CSS
• 状态管理: React Hooks
• 端口: 3000

🚀 快速启动

1. 安装系统依赖

brew install portaudio ffmpeg

2. 启动服务

# 启动后端 (在 /web/src/api 目录下)
cd web/src/api
npm install
npm run dev

# 在另一个终端启动前端 (在 /web 根目录下)
cd /web
npm install
npm start

3. 访问应用

• 🌐 前端界面: http://localhost:3000
• 🔌 API服务: http://localhost:5001
• 📊 健康检查: http://localhost:5001/api/check

🎮 使用方法

1. 文件处理模式

1. 点击 "Get Start" 按钮
2. 上传音频文件 (支持: WAV, MP3, M4A, FLAC, OGG)
3. 选择保护类型 (推荐: 综合保护)
4. 自动处理并可下载保护后的音频

2. Scene模式 (实时保护)

1. 点击 "Scene" 按钮
2. 配置保护参数
3. 启动实时音频保护
4. 系统自动录制和处理环境音频

🔧 API文档

音频处理

Scene模式

📊 性能对比

项目	Python版本	TypeScript版本	提升
启动时间	5-10秒	2-3秒	60%+
内存占用	200-300MB	100-150MB	50%+
容器大小	~800MB	~300MB	62%+
响应速度	一般	优秀	显著提升

🛠️ 开发指南

项目结构

测试

🔒 安全特性

• ✅ 文件类型验证
• ✅ 文件大小限制 (500MB)
• ✅ 安全的文件路径处理
• ✅ 自动临时文件清理
• ✅ CORS跨域保护
• ✅ 错误信息过滤

🌟 技术亮点

• 现代化技术栈: TypeScript + React + Express.js
• 高性能音频处理: FFmpeg音频管道
• 实时音频流: WebAudio + MediaRecorder
• 类型安全: 完整TypeScript类型定义
• 响应式设计: Tailwind CSS + 现代UI

🚧 系统要求

开发环境

• Node.js 18+
• FFmpeg
• npm 或 yarn

生产环境

• Docker
• Docker Compose
• 2GB+ RAM
• 1GB+ 磁盘空间

📝 更新日志

v2.0.0 (2025-06-09) - TypeScript迁移

• ✨ 完全迁移到TypeScript + Express.js
• 🚀 性能提升60%+，容器缩小62%
• 🎯 保持API完全兼容
• 🛡️ 增强错误处理和安全性

v1.0.0 - Python版本

• 🎵 基础音频处理功能
• 🎙️ Scene模式实时处理
• 🐍 Python Flask后端

🆘 问题反馈

如果遇到问题或有建议，请：

1. 查看故障排除指南
2. 运行健康检查 curl http://localhost:5001/api/check
3. 提交 Issue 描述问题

---

🎉 声智禁拟 v2.0 - 更快、更强、更现代！