Vue3.5+Electron+大模型 跨平台AI桌面聊天应用

本软件名称：智聊（跨平台 AI 桌面聊天应用），AI聚合工具「智聊」！桌面端集成百度、阿里、DeepSeek等多家AI模型，填个Key就能自由切换文心一言、通义千问～图文交互、多会话管理样样行！ 但它还不够完美～大家觉得界面、功能还有哪些可以优化的地方？比如想不想加更多模型？操作流程还能怎么简化？评论区甩建议，每一条我都认真看！一起把它打磨成真正的AI效率神器🚀

技术栈

渲染进程

• Vue3.5
• Vite
• Pinia
• Vue Router
• TypeScript
• Tailwind CSS
• Radix Vue
• VueI18n
• Deixe.js

主进程

• Electron 30+
• Electron Forge

大模型

• OpenAI 标准
• DeepSeek
• 文心一言
• 通义千问

安装依赖

• pnpm install
• pnpm install electron --force 如果electron有问题请用此命令

运行环境版本

• Node：20.10.x（已在 .nvmrc / .node-version 指定，package.json engines 为 >=20.10 <21）
• pnpm：9.x（package.json packageManager 指定为 pnpm@9.12.3）
• 使用 nvm 切换版本：
  • nvm install 20.10.0
  • nvm use 20.10.0
• 校验版本匹配：
  • node -v → v20.10.0
  • pnpm -v → 9.x

Electron 安装与启动问题排查

如果启动项目时提示 Electron 未正确安装，请按以下步骤操作：

1. 使用 PowerShell 删除 electron 文件夹并重新安装 electron：

Remove-Item -Recurse -Force node_modules\electron; npm install electron --save-dev

2. 重新启动项目：

npm run start

3. 启动日志如未出现 Electron 报错且本地开发服务器已启动，可通过 http://localhost:5173/ 访问预览页面。

4. 若终端日志仅有 devtools Autofill 相关警告，无需处理，不影响主应用功能。

项目结构与作用

• src/ 主代码目录
• src/main.ts Electron 主进程入口，窗口/菜单/IPC、配置读写、协议注册
• src/preload.ts 预加载脚本，暴露 electronAPI 给渲染进程
• src/renderer.ts 渲染进程入口
• src/App.vue 应用根组件
• src/views/ 页面组件：Home.vue、Settings.vue、Conversation.vue
• src/components/ 通用组件：输入框、消息列表、模型选择等
• src/router/ 路由配置
• src/stores/ Pinia 状态：对话与消息
• src/providers/ 模型提供器封装：OpenAIProvider、DeepSeekProvider、ClaudeProvider、QianfanProvider，以及 CreateProvider 工厂
• src/data/ 示例与数据库代码（如 demo.ts、db.ts）
• src/utils/config.json 配置模板（脱敏），用户真实配置写入系统用户目录
• src/locales/ 多语言文案（zh-CN.json、en-US.json）
• src/styles/ 全局样式与 Tailwind 入口
• vite.*.config.ts 多入口构建配置（主进程/预加载/渲染）
• forge.config.ts Electron Forge 配置
• tailwind.config.js Tailwind 配置
• .gitignore Git 忽略规则
• .env.example 环境变量示例，占位所有模型密钥

密钥管理与安全

• 不再使用环境变量或 dotenv 读取密钥，所有密钥均通过“应用设置”管理。
• 存储位置：Electron app.getPath('userData')/config.json（仅本机），示例模板位于 src/utils/config.json（始终脱敏）。
• 读写逻辑：主进程合并模板与用户配置，优先使用用户配置；保存时会写入用户目录，并将模板中的敏感字段清空。
• 仅从 asar 加载应用代码（Forge Fuses 已启用），不会从散文件或外部 node_modules 读取依赖。
• 仓库不包含任何密钥，提交前请确保未将用户目录的 config.json 复制到仓库。
• 清除密钥：在设置页删除对应提供器的密钥即可，或手动删除用户目录的 config.json。
• 备份迁移：备份用户目录 config.json 到新机器的相同路径即可恢复配置。
• 提供器必填项：
  • 千帆：accessKey、secretKey；模型列表 models
  • 通义 / OpenAI / DeepSeek / Claude：apiKey、baseUrl；模型列表 models
  • 未填写或缺失必填项时，该提供器不可用，界面会给出提示。

版权与许可

• 本仓库为专有软件，版权归属作者所有，保留所有权利。
• 未经作者书面授权，禁止复制、分发、公开传播、二次打包或商用使用。
• 未经作者书面授权，禁止修改本仓库代码并提交到公开或私有仓库。
• 如需获得授权或商业合作，请联系作者邮箱 2496943860@qq.com 或微信 f7148715。

贡献指南

• 本仓库不接受未经授权的贡献。未经书面许可的 PR/Issue 将被直接关闭。
• 获得授权后：
• 遵循代码风格与目录约定，避免泄露任何密钥或机密信息。
• 提交前需通过本地构建与基本自测，确保功能正常。

联系与加群

• 请扫码联系作者加入技术交流群：

密钥管理与安全

• 项目不依赖环境变量；请在“应用设置”填写密钥与 BaseUrl。
• 用户密钥仅保存在 userData/config.json，模板始终脱敏；打包产物不会包含真实密钥。
• 删除/更换密钥可在设置页操作，或删除 config.json 后重启应用。