What is Aetherlink

AetherLink is a cross-platform AI assistant application built on modern web technologies. It supports interaction with various AI models such as OpenAI, Google Gemini, Anthropic Claude, Grok, Silicon Flow, and Volcano Ark, providing a seamless conversational experience and is deployable on Android platforms.

Use cases

Use cases for AetherLink include providing instant answers to user queries, facilitating learning through interactive dialogues, assisting in decision-making processes, and enhancing user engagement in applications requiring conversational AI.

How to use

Users can download the AetherLink mobile application on their Android devices. After installation, they can start interacting with different AI models by selecting their preferred model and initiating conversations through text or voice input.

Key features

Key features of AetherLink include customizable model configurations, multi-theme chat management, visualization of AI thought processes, text-to-speech (TTS) capabilities, speech recognition, MCP tool support, and knowledge base management.

Where to use

AetherLink can be used in various fields such as customer support, education, personal assistance, and any domain requiring interactive AI engagement.

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、Vue 3（混合架构）
• 构建工具: 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能力的工具生态
• Vue+React混合架构：充分利用两个生态优势

构建与部署

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的开源义务，请联系我们获取商业许可证：

📧 商业授权联系：[email protected]

详细许可条款请查看 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元素和手势
• 性能优化：减少不必要的渲染和计算，确保在移动设备上流畅运行
• 原生功能集成：相机、文件系统、剪贴板等原生功能无缝集成

🎨 Vue + React 混合架构

• React主框架：使用React 19作为主要UI框架
• Vue组件集成：通过桥接组件无缝集成Vue 3组件
• 类型安全：完整的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/ # 语音识别组件目录
│   │   ├── VueComponents/  # Vue组件集成目录
│   │   ├── 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 # 设置页面入口
│   │   ├── VueDemo/        # Vue组件演示页面目录
│   │   └── 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服务器集成目录
│   │   │   ├── vue/        # Vue相关服务目录
│   │   │   └── 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代码规范配置