96 lines
4.0 KiB
Markdown
96 lines
4.0 KiB
Markdown
# FAQ 文档
|
||
本文档适用于：产品手册、官网页面、课程测验、现场 Q&A。
|
||
|
||
## 问题1：Cherry Studio 支持哪些操作系统？
|
||
- **答案**：Cherry Studio 支持 Windows、Mac 和 Linux 操作系统。
|
||
|
||
## 问题2：Cherry Studio 的主要功能有哪些？
|
||
- **答案**：Cherry Studio 的主要功能包括：
|
||
1. 支持多个 LLM 提供商
|
||
2. 允许创建多个助手
|
||
3. 支持创建多个主题
|
||
4. 允许在同一对话中使用多个模型来回答问题
|
||
5. 支持拖放排序
|
||
6. 代码高亮
|
||
7. Mermaid 图表支持
|
||
|
||
## 问题3：Cherry Studio 的主要目录结构是怎样的？
|
||
- **答案**：Cherry Studio 的主要目录结构如下：
|
||
- `/src`: 主要源代码目录
|
||
- `/build`: 构建相关文件
|
||
- `/docs`: 文档目录
|
||
- `/resources`: 资源文件目录
|
||
- `/scripts`: 脚本文件目录
|
||
|
||
## 问题4：如何在 Windows 环境下 fork Cherry Studio 并修改部分功能？
|
||
- **答案**：在 Windows 环境下 fork Cherry Studio 并修改部分功能的步骤如下：
|
||
1. 在 GitHub 上 fork Cherry Studio 仓库
|
||
2. 克隆 fork 的仓库到本地：`git clone https://github.com/your-username/cherry-studio.git`
|
||
3. 进入项目目录：`cd cherry-studio`
|
||
4. 安装依赖：`yarn install`
|
||
5. 修改所需的功能代码
|
||
6. 测试修改：`yarn dev`
|
||
7. 提交修改：`git add .` 和 `git commit -m "描述你的修改"`
|
||
8. 推送到你的 fork 仓库：`git push origin main`
|
||
|
||
## 问题5：Cherry Studio 使用了哪些主要技术栈？
|
||
- **答案**：Cherry Studio 主要使用了以下技术栈：
|
||
- TypeScript
|
||
- SCSS
|
||
- Electron
|
||
- Vite
|
||
- Sequelize
|
||
|
||
## 问题6：如何贡献代码到 Cherry Studio 项目？
|
||
- **答案**：贡献代码到 Cherry Studio 项目的步骤如下：
|
||
1. Fork 项目仓库
|
||
2. 创建你的特性分支：`git checkout -b feature/AmazingFeature`
|
||
3. 提交你的修改：`git commit -m 'Add some AmazingFeature'`
|
||
4. 推送到分支：`git push origin feature/AmazingFeature`
|
||
5. 打开一个 Pull Request
|
||
|
||
## 问题7：Cherry Studio 的 `/src` 目录主要包含哪些内容？
|
||
- **答案**：Cherry Studio 的 `/src` 目录主要包含以下内容：
|
||
- 主进程代码（Electron 主进程）
|
||
- 渲染进程代码（用户界面）
|
||
- 组件
|
||
- 工具函数
|
||
- 状态管理
|
||
- 样式文件
|
||
|
||
## 问题8：如何在 Cherry Studio 中添加新的 LLM 提供商？
|
||
- **答案**：要在 Cherry Studio 中添加新的 LLM 提供商，你需要：
|
||
1. 在 `/src/services` 或类似目录下创建新的服务文件
|
||
2. 实现与新 LLM 提供商 API 的集成
|
||
3. 在用户界面中添加新提供商的选项
|
||
4. 更新配置和状态管理以支持新提供商
|
||
|
||
## 问题9：Cherry Studio 的构建过程是怎样的？
|
||
- **答案**：Cherry Studio 的构建过程主要包括：
|
||
1. 使用 Vite 构建前端资源
|
||
2. 使用 Electron Builder 打包桌面应用
|
||
3. 根据不同平台（Windows、Mac、Linux）生成相应的安装包
|
||
|
||
## 问题10：如何在 Cherry Studio 中实现新的 UI 主题？
|
||
- **答案**：在 Cherry Studio 中实现新的 UI 主题的步骤：
|
||
1. 在 `/src/styles` 目录下创建新的主题 SCSS 文件
|
||
2. 定义新主题的颜色变量和样式
|
||
3. 在主样式文件中导入新主题
|
||
4. 更新主题切换逻辑以包含新主题
|
||
5. 在用户界面中添加新主题的选项
|
||
|
||
## 问题11：Cherry Studio 如何处理多语言支持？
|
||
- **答案**：Cherry Studio 可能通过以下方式处理多语言支持：
|
||
1. 使用 i18n 库进行国际化
|
||
2. 在 `/src/locales` 或类似目录下存储不同语言的翻译文件
|
||
3. 实现语言切换功能
|
||
4. 在组件中使用翻译函数或组件来显示多语言文本
|
||
|
||
## 问题12：如何为 Cherry Studio 编写单元测试？
|
||
- **答案**：为 Cherry Studio 编写单元测试的步骤：
|
||
1. 在 `/tests` 目录下创建测试文件
|
||
2. 使用测试框架（如 Jest）编写测试用例
|
||
3. 模拟 Electron 环境和其他依赖
|
||
4. 运行测试命令：`yarn test`
|
||
5. 确保测试覆盖主要功能和组件
|