AetherLink

AetherLink

项目概述

官方交流群Q群 点击链接加入群聊【AetherLink 官方群】：http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=V-b46WoBNLIM4oc34JMULwoyJ3hyrKac&authKey=q%2FSwCcxda4e55ygtwp3h9adQXhqBLZ9wJdvM0QxTjXQkbxAa2tHoraOGy2fiibyY&noverify=0&group_code=930126592

AetherLink移动应用是一个基于现代Web技术构建的跨平台AI助手应用。该应用支持与多种AI模型（如OpenAI、Google Gemini、Anthropic Claude、Grok、硅基流动、火山方舟等）的交互，提供流畅的对话体验，并支持Android平台部署。应用采用React、TypeScript和Capacitor框架开发，具有高度可定制的模型配置、多主题聊天管理、AI思考过程可视化、语音合成、语音识别、MCP工具支持、知识库管理等特色功能。

技术栈

• 前端框架: React 19、Material UI 7
• 构建工具: Vite 6、SWC编译器
• 编程语言: TypeScript 5.8
• 移动框架: Capacitor 7
• 状态管理: Redux & Redux Toolkit 2.8
• API集成: OpenAI、Google Gemini、Anthropic Claude、Grok、硅基流动、火山方舟等AI模型
• 存储: IndexedDB (Dexie)、localStorage
• 样式: MUI组件 + Tailwind CSS + 自定义CSS
• 语音技术: 硅基流动TTS API、OpenAI TTS、Azure TTS、Web Speech API、Capacitor语音识别
• 代码高亮: Shiki语法高亮引擎
• 工具支持: MCP (Model Context Protocol) 工具集成

系统要求

• Node.js: v22.x 或更高
• npm: v10.x 或更高
• Android Studio: 用于Android平台开发
• JDK: Java 11 或更高版本
• Vite: 6.x 或更高版本
• Capacitor CLI: 7.x 或更高版本
• React: 19.x
• TypeScript: 5.8.x

安装指南

1. 克隆仓库

git clone https://github.com/1600822305/AetherLink.git
cd AetherLink

2. 安装依赖

npm install

3. 初始化Capacitor

npx cap init

开发指南

启动开发服务器

npm run dev

构建选项

npm run build              # 快速构建（推荐）
npm run build:ultra        # 完整构建（包含类型检查）

移动端开发

# 构建并同步到Android
npm run build
npx cap sync android
npx cap open android

主要功能

• 多模型AI对话：支持OpenAI、Claude、Gemini、Grok等主流AI模型
• 语音交互：语音识别输入 + TTS语音播放
• 移动端优化：原生Android应用体验
• 知识库管理：文档上传、智能检索
• MCP工具集成：扩展AI能力的工具生态
• React架构：现代化的React 19应用架构

构建与部署

Android APK构建

# 在Android Studio中构建
npx cap open android
# 然后在Android Studio中: Build > Build Bundle(s) / APK(s) > Build APK(s)

APK将保存在 android/app/build/outputs/apk/debug/ 目录

许可证

AetherLink 采用分层许可模式，根据使用者规模提供不同的许可方案：

• 个人用户及8人以下团队：适用 GNU Affero 通用公共许可证 v3.0 (AGPLv3)
• 8人以上的组织机构：必须获取商业使用许可证

商业许可

如果您的组织超过8人，或需要规避AGPLv3的开源义务，请联系我们获取商业许可证：

📧 商业授权联系：1600822305@qq.com

详细许可条款请查看 LICENSE 文件。

贡献指南

1. Fork本仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建一个Pull Request

注意：所有代码贡献将被视为在AGPLv3许可证下提供。

特色功能

🤖 自动获取模型列表

AetherLink支持从各大AI提供商API自动获取可用模型列表：

• 支持OpenAI、Claude (Anthropic)、Gemini (Google)、Grok (xAI)、硅基流动和火山方舟等主流AI提供商
• 自动处理不同API格式和端点路径
• 智能适配自定义中转站API
• 提供优雅的回退机制，当API请求失败时使用预设模型列表
• 支持的API端点:
  • OpenAI: /v1/models
  • Claude: /v1/models
  • Gemini: /v1beta/models
  • Grok: /v1/models
  • 硅基流动: /v1/models
  • 火山方舟: /api/v3/models
  • 自定义中转站: 自动检测并适配

🎙️ 语音识别功能

AetherLink支持多种语音识别方案：

• Capacitor语音识别：移动端原生语音识别，支持实时转录
• OpenAI Whisper：高精度语音转文本，支持多语言
• Web Speech API：浏览器原生语音识别作为备选方案
• 智能提供商切换：根据环境自动选择最佳识别方案
• 实时反馈：支持部分结果显示和实时状态更新
• 按住说话：直观的语音输入交互方式

🔊 增强语音合成

AetherLink提供多层级的语音合成解决方案：

• Azure TTS：微软Azure认知服务，支持SSML和高质量语音
• OpenAI TTS：OpenAI语音合成，支持流式和非流式输出
• 硅基流动TTS：高质量中文语音合成
• Web Speech API：浏览器原生语音合成作为备选
• 智能降级：自动尝试多种TTS服务，确保语音播放成功
• 语音控制：播放/暂停、语速调整、语音选择等功能

🛠️ MCP工具支持

集成Model Context Protocol (MCP)工具生态：

• Fetch工具：支持网络请求和数据获取
• 跨平台兼容：移动端使用原生HTTP，Web端使用代理
• 工具块渲染：可视化工具执行结果
• 错误处理：完善的错误处理和重试机制

📱 移动端优化

AetherLink针对移动设备进行了多项优化：

• 返回键智能处理：根据当前页面上下文智能处理Android返回键行为
  • 在聊天和欢迎页面显示退出确认对话框
  • 在其他页面返回上一级页面
  • 防止意外退出应用
• WebView版本检测：自动检测WebView版本并提供升级建议
• 响应式布局：自适应不同屏幕尺寸和方向
• 触摸优化：针对触摸交互优化的UI元素和手势
• 性能优化：减少不必要的渲染和计算，确保在移动设备上流畅运行
• 原生功能集成：相机、文件系统、剪贴板等原生功能无缝集成

🎨 React架构

• React主框架：使用React 19作为主要UI框架
• 类型安全：完整的TypeScript支持

📚 知识库管理

• 文档管理：支持多种文档格式的上传和管理
• 智能检索：基于AI的语义搜索和内容检索

💻 代码编辑器

• 语法高亮：基于Shiki的高质量语法高亮
• 多语言支持：支持主流编程语言

🧠 AI思考过程

• 支持显示AI的思考过程（主要支持Grok模型）
• 可视化思考时间和过程，改善用户体验

🛠️ 开发者工具

• 控制台日志查看
• 网络请求监控
• API请求和响应分析

项目结构

AetherLink/
├── android/                # Android平台相关代码和配置
│   ├── app/                # Android应用主要代码
│   │   ├── src/            # 源代码目录
│   │   │   ├── main/       # 主要代码
│   │   │   │   ├── assets/ # Web资源和配置文件
│   │   │   │   ├── java/   # Java代码
│   │   │   │   └── res/    # Android资源文件(布局、图标等)
│   │   │   └── test/       # 测试代码
│   │   └── build.gradle    # 应用级构建配置
│   ├── build.gradle        # 项目级构建配置
│   ├── capacitor.settings.gradle # Capacitor插件配置
│   └── variables.gradle    # 全局变量和版本配置
├── public/                 # 静态资源文件和公共资产
│   └── assets/             # 图标、图片等公共资源
├── src/                    # 源代码目录
│   ├── assets/             # 应用内图片、字体等资源
│   ├── components/         # 可复用UI组件
│   │   ├── AIDebateButton.tsx # AI辩论功能按钮组件
│   │   ├── AppInitializer.tsx # 应用初始化组件
│   │   ├── BackButtonHandler.tsx # Android返回键处理组件，管理返回键行为
│   │   ├── ChatInput.tsx   # 聊天输入框组件，处理消息输入和发送
│   │   ├── ChatToolbar.tsx # 聊天工具栏组件，提供聊天页面顶部操作
│   │   ├── CitationsList.tsx # 引用列表组件，显示消息引用
│   │   ├── CodeEditor/     # 代码编辑器组件目录
│   │   ├── CompactChatInput.tsx # 紧凑型聊天输入框
│   │   ├── DevTools/       # 开发者工具组件目录
│   │   ├── EnhancedToast.tsx # 增强型提示组件
│   │   ├── ExitConfirmDialog.tsx # 退出确认对话框，防止意外退出应用
│   │   ├── FilePreview.tsx # 文件预览组件
│   │   ├── ImageGeneration/ # 图像生成功能组件目录
│   │   ├── IntegratedFilePreview.tsx # 集成文件预览组件
│   │   ├── KnowledgeManagement/ # 知识库管理组件目录
│   │   ├── ModelManagementDialog.tsx # 模型管理对话框
│   │   ├── MultiModelSelector.tsx # 多模型选择器组件
│   │   ├── RouterWrapper.tsx # 路由包装组件，提供路由转换和动画
│   │   ├── SearchResultsCollapsible.tsx # 搜索结果折叠组件
│   │   ├── Sidebar/        # 侧边栏组件目录
│   │   ├── SystemPromptBubble.tsx # 系统提示气泡组件
│   │   ├── SystemPromptDialog.tsx # 系统提示对话框
│   │   ├── TTS/            # 语音合成组件目录
│   │   ├── ToolsSwitch.tsx # 工具开关组件
│   │   ├── TopicManagement/ # 话题管理组件，包含分组和拖拽功能
│   │   │   ├── AssistantTab.tsx # 助手标签页组件
│   │   │   ├── GroupComponents.tsx # 分组相关组件
│   │   │   ├── GroupDialog.tsx # 创建/编辑分组对话框
│   │   │   ├── Sidebar.tsx # 侧边栏主组件
│   │   │   ├── SidebarTabs.tsx # 侧边栏标签页组件
│   │   │   ├── TopicTab.tsx # 话题标签页组件
│   │   │   └── index.ts # 导出组件
│   │   ├── TopicStats/     # 话题统计组件目录
│   │   ├── UpdateNoticeDialog.tsx # 更新通知对话框
│   │   ├── UploadMenu.tsx  # 上传菜单组件
│   │   ├── UrlScraperStatus.tsx # URL抓取状态组件
│   │   ├── VoiceRecognition/ # 语音识别组件目录

│   │   ├── WebSearchProviderSelector.tsx # 网络搜索提供商选择器
│   │   ├── chat/           # 聊天相关子组件
│   │   ├── common/         # 通用组件目录
│   │   ├── message/        # 消息相关子组件
│   │   │   ├── ThinkingProcess/ # AI思考过程展示组件
│   │   │   └── MessageActions/  # 消息操作按钮组件
│   │   ├── settings/       # 设置相关组件
│   │   │   └── ModelCard/  # 模型卡片组件，展示单个模型信息
│   │   └── test/           # 测试组件目录
│   ├── pages/              # 页面级组件
│   │   ├── ChatPage/       # 聊天主界面
│   │   │   ├── components/ # 聊天页面子组件
│   │   │   │   ├── ModelSelector.tsx # 模型选择器组件
│   │   │   │   └── ... # 其他聊天页面子组件
│   │   │   ├── hooks/      # 聊天页面自定义钩子
│   │   │   │   ├── useModelSelection.ts # 模型选择逻辑钩子
│   │   │   │   ├── useChatFeatures.ts # 聊天功能钩子
│   │   │   │   └── ... # 其他聊天页面钩子
│   │   │   └── index.tsx   # 聊天页面主组件
│   │   ├── DevToolsPage.tsx # 开发者调试工具页面，提供日志和API调试
│   │   ├── KnowledgeBase/  # 知识库管理页面目录
│   │   ├── Settings/       # 设置相关页面
│   │   │   ├── AppearanceSettings/ # 外观设置，主题和字体配置
│   │   │   ├── BehaviorSettings/   # 行为设置，如发送方式和通知
│   │   │   ├── DefaultModelSettings/ # 默认模型设置页面
│   │   │   ├── ModelProviderSettings/ # 模型提供商设置页面
│   │   │   ├── AddProviderPage/ # 添加提供商页面
│   │   │   ├── DataSettings/ # 数据管理设置，包括备份和恢复
│   │   │   ├── VoiceSettings/ # 语音设置，TTS和语音识别配置
│   │   │   ├── index.tsx   # 设置主页面
│   │   │   └── AboutPage/  # 关于页面，显示应用信息
│   │   ├── SettingsPage.tsx # 设置页面入口

│   │   └── WelcomePage.tsx # 欢迎/引导页面，首次使用时显示
│   ├── routes/             # 路由配置和导航逻辑
│   │   └── index.tsx       # 路由定义和配置
│   ├── shared/             # 共享代码和业务逻辑
│   │   ├── api/            # API接口封装
│   │   │   ├── anthropic/  # Anthropic Claude API集成
│   │   │   ├── google/     # Google Gemini API集成
│   │   │   ├── grok/       # Grok API集成
│   │   │   ├── openai/     # OpenAI API集成
│   │   │   ├── siliconflow/ # 硅基流动API集成
│   │   │   ├── volcengine/ # 火山方舟API集成
│   │   │   └── index.ts    # API统一入口和路由
│   │   ├── config/         # 配置文件目录
│   │   ├── constants/      # 常量定义目录
│   │   ├── data/           # 静态数据和预设配置
│   │   │   ├── models/     # 预设模型配置
│   │   │   └── presetModels.ts # 预设模型数据
│   │   ├── hooks/          # 自定义React Hooks
│   │   │   ├── useAppState/ # 应用状态管理Hook
│   │   │   ├── useModels/  # 模型管理Hook
│   │   │   └── ... # 其他自定义Hook
│   │   ├── middlewares/    # Redux中间件目录
│   │   ├── prompts/        # 提示词模板目录
│   │   ├── providers/      # 提供商相关代码目录
│   │   ├── services/       # 业务服务层
│   │   │   ├── APIService.ts # API服务，处理模型获取和消息发送
│   │   │   ├── AssistantService.ts # 助手服务，管理AI助手配置
│   │   │   ├── LoggerService.ts # 日志记录服务，统一日志管理
│   │   │   ├── SystemPromptService.ts # 系统提示词服务
│   │   │   ├── ThinkingService.ts # AI思考过程处理服务
│   │   │   ├── TopicService.ts # 话题管理服务
│   │   │   ├── TTSService.ts # 文本到语音转换服务
│   │   │   ├── VoiceRecognitionService.ts # 语音识别服务
│   │   │   ├── VersionService.ts # 版本管理服务
│   │   │   ├── ImageUploadService.ts # 图片上传服务，处理图片选择和压缩
│   │   │   ├── assistant/  # 助手相关服务目录
│   │   │   ├── mcpServers/ # MCP服务器集成目录

│   │   │   └── storageService.ts # 存储服务(IndexedDB/localStorage)
│   │   ├── store/          # Redux状态管理
│   │   │   ├── messagesSlice.ts # 消息状态管理
│   │   │   ├── settingsSlice.ts # 设置状态管理
│   │   │   ├── slices/     # 其他状态切片
│   │   │   │   ├── groupsSlice.ts # 分组状态管理
│   │   │   │   └── ... # 其他状态切片
│   │   │   └── index.ts    # Store配置和导出
│   │   ├── styles/         # 样式文件目录
│   │   ├── types/          # TypeScript类型定义
│   │   │   ├── Assistant.ts # 助手类型定义
│   │   │   └── index.ts    # 核心类型定义，包含消息、模型等类型
│   │   └── utils/          # 工具函数和辅助方法
│   │       ├── api/        # API相关工具函数
│   │       ├── format/     # 格式化工具函数
│   │       ├── storage/    # 本地存储工具函数
│   │       └── index.ts    # 通用工具函数，如ID生成、Token计算等
│   ├── App.tsx             # 应用根组件，包含主题和路由配置
│   ├── main.tsx            # 应用入口文件，渲染根组件
│   └── index.css           # 全局样式
├── capacitor.config.ts     # Capacitor移动应用配置，定义应用ID和插件设置
├── index.html              # 应用入口HTML文件
├── package.json            # 项目依赖和脚本配置
├── tsconfig.json           # TypeScript编译配置(引用配置)
├── tsconfig.app.json       # 应用代码TypeScript配置
├── tsconfig.node.json      # Node环境TypeScript配置
├── vite.config.ts          # Vite构建工具配置，包含优化和分包策略
├── tailwind.config.js      # Tailwind CSS配置
└── eslint.config.js        # ESLint代码规范配置