fd83834fca
* refactor(utils): 提取 API 调用错误序列化逻辑到独立函数 将 serializeError 中的 API 调用错误处理逻辑提取为独立的 serializeAPICallError 函数，提高代码可维护性 * feat(错误处理): 添加下载错误的序列化支持 新增 SerializedAiSdkDownloadError 接口用于表示下载错误 实现 serializeDownloadError 方法处理 DownloadError 的序列化 在 serializeError 中添加对 DownloadError 的判断处理 * feat(错误类型): 添加序列化AI SDK错误类型检查函数 修改 isSerializedAiSdkAPICallError 新增 isSerializedAiSdkDownloadError 新增 SerializedAiSdkInvalidArgumentError * feat(错误处理): 添加对InvalidArgumentError的序列化支持 添加对InvalidArgumentError类型的序列化处理，包括定义序列化接口和实现序列化函数 * feat(错误处理): 添加对InvalidDataContentError的序列化支持 * feat(错误处理): 添加对InvalidMessageRoleError的序列化支持 新增对InvalidMessageRoleError错误的序列化处理，包括类型定义和序列化函数 * feat(错误处理): 添加对无效提示错误的序列化支持 新增 SerializedAiSdkInvalidPromptError 接口及序列化函数 在 serializeError 中添加对 InvalidPromptError 的处理逻辑 * feat(错误处理): 添加对无效工具输入错误的序列化支持 * feat(错误处理): 添加对JSON解析错误的序列化支持 * feat(错误处理): 添加消息转换错误的序列化支持 添加 SerializedAiSdkMessageConversionError 接口及序列化函数，用于处理消息转换错误的序列化 * feat(types): 添加 SerializedAiSdkNoAudioGeneratedError 类型及校验函数 * feat(错误处理): 添加对NoObjectGeneratedError的序列化支持 新增SerializedAiSdkNoObjectGeneratedError接口及序列化函数，用于处理AI SDK中对象未生成的错误情况 * feat(错误处理): 添加对NoSuchModelError的序列化支持 添加对AI SDK中NoSuchModelError类型的序列化支持，包括类型定义和序列化函数 * feat(错误处理): 添加对NoSuchProviderError的序列化支持 * feat(错误处理): 添加对NoSuchToolError的序列化支持 新增SerializedAiSdkNoSuchToolError接口及序列化函数，用于处理工具不存在错误 简化isSerializedAiSdkNoSuchProviderError的校验逻辑 * feat(错误处理): 添加序列化重试错误类型和函数 添加 SerializedAiSdkRetryError 接口和序列化函数，用于处理重试错误的序列化 * feat(types): 添加SerializedAiSdkTooManyEmbeddingValuesForCallError类型 添加未由aisdk导出的SerializedAiSdkTooManyEmbeddingValuesForCallError类型及其类型守卫，用于处理嵌入值过多错误 * feat(错误处理): 添加工具调用修复错误的序列化支持 * feat(错误处理): 添加类型验证错误的序列化支持 * feat(错误处理): 添加对不支持功能的错误序列化支持 * feat(types): 添加 AiSdkErrorUnion 类型用于聚合所有 AI SDK 错误类型 * refactor(types): 移除未使用的AiSdkErrorUnion类型并清理导入 * refactor(error): 重构错误处理逻辑，统一序列化方法 简化错误序列化逻辑，使用统一的方法处理所有可能的错误类型 移除重复的序列化函数，提高代码可维护性 更新错误类型定义，添加缺失的错误类型 * feat(error): 添加对InvalidToolInputError和NoSuchToolError的序列化支持 新增对AI SDK中InvalidToolInputError和NoSuchToolError错误的序列化处理，完善错误处理逻辑 * feat(错误处理): 完善AI SDK错误类型和错误详情展示 添加SerializedAiSdkNoSpeechGeneratedError类型并重命名相关函数 实现isSerializedAiSdkErrorUnion函数统一检查所有AI SDK错误类型 在ErrorBlock中扩展错误详情展示逻辑，支持所有AI SDK错误类型 * feat(i18n): 添加缺失的翻译字段 * docs(i18n): 添加待翻译的多语言文本字段 * fix(ErrorBlock): 修复重复的错误类型检查条件 * feat(types): 添加AISDKError到AiSdkErrorUnion类型中 * refactor(ErrorBlock): 移除未使用的类型验证错误显示逻辑 * fix(i18n): Auto update translations for PR #9960 * docs(i18n): 更新多语言翻译文件中的缺失翻译 * fix(i18n): 修正多语言文件中的翻译错误 更新法语、葡萄牙语、日语和俄语翻译文件，将中文词汇替换为正确的目标语言词汇 * fix(类型): 修正SerializedError和SerializedAiSdkJSONParseError的类型判断 移除SerializedAiSdkJSONParseError类型判断中冗余的'message'检查，因为父类型SerializedAiSdkError已包含此检查 * fix(错误处理): 修复类型验证错误判断并添加缺失的错误类型 修复 isSerializedAiSdkTypeValidationError 判断逻辑，排除包含 parameter 属性的情况 在 SerializedAiSdkErrorUnion 联合类型中添加缺失的 SerializedAiSdkNoSpeechGeneratedError 类型 --------- Co-authored-by: GitHub Action <action@github.com> |
||
|---|---|---|
| .github | ||
| .husky | ||
| .vscode | ||
| .yarn | ||
| build | ||
| docs | ||
| packages | ||
| resources | ||
| scripts | ||
| src | ||
| tests | ||
| .editorconfig | ||
| .env.example | ||
| .git-blame-ignore-revs | ||
| .gitattributes | ||
| .gitignore | ||
| .npmrc | ||
| .prettierignore | ||
| .prettierrc | ||
| .yarnrc.yml | ||
| CLAUDE.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| dev-app-update.yml | ||
| electron-builder.yml | ||
| electron.vite.config.ts | ||
| eslint.config.mjs | ||
| LICENSE | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| SECURITY.md | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| tsconfig.web.json | ||
| vitest.config.ts | ||
| yarn.lock | ||
English | 中文 | Official Site | Documents | Development | Feedback
🍒 Cherry Studio
Cherry Studio is a desktop client that supports multiple LLM providers, available on Windows, Mac and Linux.
👏 Join Telegram Group｜Discord | QQ Group(575014769)
❤️ Like Cherry Studio? Give it a star 🌟 or Sponsor to support the development!
🌠 Screenshot
🌟 Key Features
- Diverse LLM Provider Support:
- ☁️ Major LLM Cloud Services: OpenAI, Gemini, Anthropic, and more
- 🔗 AI Web Service Integration: Claude, Peplexity, Poe, and others
- 💻 Local Model Support with Ollama, LM Studio
- AI Assistants & Conversations:
- 📚 300+ Pre-configured AI Assistants
- 🤖 Custom Assistant Creation
- 💬 Multi-model Simultaneous Conversations
- Document & Data Processing:
- 📄 Supports Text, Images, Office, PDF, and more
- ☁️ WebDAV File Management and Backup
- 📊 Mermaid Chart Visualization
- 💻 Code Syntax Highlighting
- Practical Tools Integration:
- 🔍 Global Search Functionality
- 📝 Topic Management System
- 🔤 AI-powered Translation
- 🎯 Drag-and-drop Sorting
- 🔌 Mini Program Support
- ⚙️ MCP(Model Context Protocol) Server
- Enhanced User Experience:
- 🖥️ Cross-platform Support for Windows, Mac, and Linux
- 📦 Ready to Use - No Environment Setup Required
- 🎨 Light/Dark Themes and Transparent Window
- 📝 Complete Markdown Rendering
- 🤲 Easy Content Sharing
📝 Roadmap
We're actively working on the following features and improvements:
- 🎯 Core Features
- Selection Assistant with smart content selection enhancement
- Deep Research with advanced research capabilities
- Memory System with global context awareness
- Document Preprocessing with improved document handling
- MCP Marketplace for Model Context Protocol ecosystem
- 🗂 Knowledge Management
- Notes and Collections
- Dynamic Canvas visualization
- OCR capabilities
- TTS (Text-to-Speech) support
- 📱 Platform Support
- HarmonyOS Edition (PC)
- Android App (Phase 1)
- iOS App (Phase 1)
- Multi-Window support
- Window Pinning functionality
- 🔌 Advanced Features
- Plugin System
- ASR (Automatic Speech Recognition)
- Assistant and Topic Interaction Refactoring
Track our progress and contribute on our project board.
Want to influence our roadmap? Join our GitHub Discussions to share your ideas and feedback!
🌈 Theme
- Theme Gallery: https://cherrycss.com
- Aero Theme: https://github.com/hakadao/CherryStudio-Aero
- PaperMaterial Theme: https://github.com/rainoffallingstar/CherryStudio-PaperMaterial
- Claude dynamic-style: https://github.com/bjl101501/CherryStudio-Claudestyle-dynamic
- Maple Neon Theme: https://github.com/BoningtonChen/CherryStudio_themes
Welcome PR for more themes
🤝 Contributing
We welcome contributions to Cherry Studio! Here are some ways you can contribute:
- Contribute Code: Develop new features or optimize existing code.
- Fix Bugs: Submit fixes for any bugs you find.
- Maintain Issues: Help manage GitHub issues.
- Product Design: Participate in design discussions.
- Write Documentation: Improve user manuals and guides.
- Community Engagement: Join discussions and help users.
- Promote Usage: Spread the word about Cherry Studio.
Refer to the Branching Strategy for contribution guidelines
Getting Started
- Fork the Repository: Fork and clone it to your local machine.
- Create a Branch: For your changes.
- Submit Changes: Commit and push your changes.
- Open a Pull Request: Describe your changes and reasons.
For more detailed guidelines, please refer to our Contributing Guide.
Thank you for your support and contributions!
🔧 Developer Co-creation Program
We are launching the Cherry Studio Developer Co-creation Program to foster a healthy and positive-feedback loop within the open-source ecosystem. We believe that great software is built collaboratively, and every merged pull request breathes new life into the project.
We sincerely invite you to join our ranks of contributors and shape the future of Cherry Studio with us.
Contributor Rewards Program
To give back to our core contributors and create a virtuous cycle, we have established the following long-term incentive plan.
The inaugural tracking period for this program will be Q3 2025 (July, August, September). Rewards for this cycle will be distributed on October 1st.
Within any tracking period (e.g., July 1st to September 30th for the first cycle), any developer who contributes more than 30 meaningful commits to any of Cherry Studio's open-source projects on GitHub will be eligible for the following benefits:
- Cursor Subscription Sponsorship: Receive a $70 USD credit or reimbursement for your Cursor subscription, making AI your most efficient coding partner.
- Unlimited Model Access: Get unlimited API calls for the DeepSeek and Qwen models.
- Cutting-Edge Tech Access: Enjoy occasional perks, including API access to models like Claude, Gemini, and OpenAI, keeping you at the forefront of technology.
Growing Together & Future Plans
A vibrant community is the driving force behind any sustainable open-source project. As Cherry Studio grows, so will our rewards program. We are committed to continuously aligning our benefits with the best-in-class tools and resources in the industry. This ensures our core contributors receive meaningful support, creating a positive cycle where developers, the community, and the project grow together.
Moving forward, the project will also embrace an increasingly open stance to give back to the entire open-source community.
How to Get Started?
We look forward to your first Pull Request!
You can start by exploring our repositories, picking up a good first issue, or proposing your own enhancements. Every commit is a testament to the spirit of open source.
Thank you for your interest and contributions.
Let's build together.
🏢 Enterprise Edition
Building on the Community Edition, we are proud to introduce Cherry Studio Enterprise Edition—a privately-deployable AI productivity and management platform designed for modern teams and enterprises.
The Enterprise Edition addresses core challenges in team collaboration by centralizing the management of AI resources, knowledge, and data. It empowers organizations to enhance efficiency, foster innovation, and ensure compliance, all while maintaining 100% control over their data in a secure environment.
Core Advantages
- Unified Model Management: Centrally integrate and manage various cloud-based LLMs (e.g., OpenAI, Anthropic, Google Gemini) and locally deployed private models. Employees can use them out-of-the-box without individual configuration.
- Enterprise-Grade Knowledge Base: Build, manage, and share team-wide knowledge bases. Ensures knowledge retention and consistency, enabling team members to interact with AI based on unified and accurate information.
- Fine-Grained Access Control: Easily manage employee accounts and assign role-based permissions for different models, knowledge bases, and features through a unified admin backend.
- Fully Private Deployment: Deploy the entire backend service on your on-premises servers or private cloud, ensuring your data remains 100% private and under your control to meet the strictest security and compliance standards.
- Reliable Backend Services: Provides stable API services and enterprise-grade data backup and recovery mechanisms to ensure business continuity.
✨ Online Demo
🚧 Public Beta Notice
The Enterprise Edition is currently in its early public beta stage, and we are actively iterating and optimizing its features. We are aware that it may not be perfectly stable yet. If you encounter any issues or have valuable suggestions during your trial, we would be very grateful if you could contact us via email to provide feedback.
Version Comparison
| Feature | Community Edition | Enterprise Edition |
|---|---|---|
| Open Source | ✅ Yes | ⭕️ Partially released to customers |
| Cost | Free for Personal Use / Commercial License | Buyout / Subscription Fee |
| Admin Backend | — | ● Centralized Model Access ● Employee Management ● Shared Knowledge Base ● Access Control ● Data Backup |
| Server | — | ✅ Dedicated Private Deployment |
Get the Enterprise Edition
We believe the Enterprise Edition will become your team's AI productivity engine. If you are interested in Cherry Studio Enterprise Edition and would like to learn more, request a quote, or schedule a demo, please feel free to contact us.
- For Business Inquiries & Purchasing: 📧 bd@cherry-ai.com
🔗 Related Projects
-
one-api: LLM API management and distribution system supporting mainstream models like OpenAI, Azure, and Anthropic. Features a unified API interface, suitable for key management and secondary distribution.
-
ublacklist: Blocks specific sites from appearing in Google search results
🚀 Contributors
📊 GitHub Stats
