# cherry-studio-utools

**Repository Path**: IronManCantFix/cherry-studio-utools

## Basic Information

- **Project Name**: cherry-studio-utools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🍒 Cherry Studio uTools 插件版

<div align="center">
  <img src="public/logo.png" width="120" height="120" alt="Cherry Studio uTools Logo" />
  <p align="center">
    <b>基于优秀开源 AI 客户端 Cherry Studio 深度定制与二次开发的 uTools 极致体验版</b>
  </p>
  <p align="center">
    一个深度融入 uTools 生态的轻量化 AI 助手，保留多大模型对话、划词翻译、AI 绘画、富文本笔记等核心生产力能力。
  </p>
  <p align="center">
    <a href="./README.md">简体中文</a> | <a href="./README_EN.md">English</a>
  </p>
</div>

---

## 🌟 项目简介

**Cherry Studio uTools 插件版** 旨在解决传统桌面客户端启动慢、占用内存大、不便随手唤醒的痛点。通过拥抱纯前端路由分割以及 uTools 原生的跨进程与数据持久化 API，我们打造了一个**极致轻量、随唤随用、即开即走**的 AI 提效助手。

本项目完美保留了原版强大的 AI 对话、划词翻译、AI 绘画和富文本笔记等能力，并在此基础上针对 uTools 插件沙箱进行了深度的性能调优与生态集成。

---

## ✨ 深度适配与 uTools 定制功能

### 1. 🚀 uTools 划词「超级面板」深度集成
深度适配 uTools 系统的超级面板动作。用户在操作系统的任何地方（网页、编辑器、PDF等）选中任意文字，即可一键直达：
- **AI 翻译** ➜ 自动跳转翻译页面并**自动开始高精度流式翻译**。
- **AI 总结** ➜ 自动新开独立会话，填装总结模版并**自动流式生成**。
- **AI 润色** ➜ 自动新开独立会话，填装润饰模版并**自动流式生成**。
- **AI 解释代码** ➜ 自动新开独立会话，填装代码逻辑诊断模版并**自动流式生成**。

### 💡 2. uTools 主输入框直接粘贴智能快捷动作面板
针对部分场景划词不方便的痛点，注册了全局正则匹配拦截指令（输入/粘贴字符数 $\ge 3$ 即可匹配）。
- 当您把任意一段文本、代码段或段落复制并粘贴到 **uTools 主输入框**时，即可在匹配列表中看到 **“AI 助手快速处理”**。
- 调起后将弹出极具视觉品质的毛玻璃（Glassmorphism）浮空面板，提供精致的 Code Block 文本预览，并支持一键**填入对话编辑**或**一键自动流式处理（翻译/总结/润色/代码分析）**。

### ⚡ 3. uTools 数据库增量同步还原 (I/O 性能大跃升)
- **旧版缺陷**：每次启动插件时，若在 uTools 宿主库中检测到数据，便会强制擦除清空本地 IndexedDB，并重新做成千上万条记录的全量覆盖写入（`clear()` + `bulkPut()`），在大聊天的历史记录下会导致严重的启动白屏和卡顿。
- **增量方案**：引入内存级 `isDeepEqual` 高精度深度 Diff 算法。启动时自动提取本地与远程主键进行 Mapping 比对，精细识别并仅对修改项执行 `bulkPut`、对废弃项执行 `bulkDelete`。**在 99% 的有缓存日常使用场景下，启动写操作数量降为 0**，完美实现毫秒级零延迟极速启动！

### 🔌 4. 轻量化包体积与路由分割 (Route-level Code Splitting)
- 彻底移除了原 Electron 专属的 Node.js 进程服务文件，全面轻量化打包。
- 对所有的次级功能路由（设置、绘画、笔记、Agent 市场等）全数实施 `React.lazy()` + `Suspense` 延迟加载设计。**首屏主包加载体积骤降 40% ~ 60%**，为插件运行瘦身到了极致。

### ☁️ 5. 多模态与丰富 LLM 服务接入
原生继承并保留了 Cherry Studio 强大的 AI SDK 底座（`@cherrystudio/ai-core`）：
- **全主流厂商适配**：原生支持 OpenAI, Anthropic, Google Gemini, DeepSeek, Qwen (通义千问), Ollama 等十余家主流大模型服务及各类自定义中转 API。
- **助手预设**：内置 300+ 现成的实用 AI 助手模板。
- **流式对话**：完美的 Markdown 渲染、LaTeX 数学公式解析及代码高亮。

---

## 📦 安装与本地开发调试

### 🔌 插件市场安装 (推荐)

直接在 uTools 的插件市场中搜索 **“AI助手-CherryStudio”**，点击安装即可使用。

### 💻 本地开发步骤

1. **克隆项目并安装依赖** (需要 Node $\ge 22$, pnpm $\ge 10.27$)：
   ```bash
   pnpm install
   ```

2. **启动 Vite 开发服务器**（默认监听 3000 端口）：
   ```bash
   pnpm dev
   ```

3. **在 uTools 中加载调试**：
   - 打开 uTools 客户端。
   - 输入 `插件管理` 或 `plugin` 进入插件应用管理。
   - 点击 **「开发者」** ➜ **「加载本地插件」**。
   - 选择并选中本项目目录中的 `public/` 文件夹（对应开发调试，直接指向 `localhost:3000`）。
   - 在开发者工具中点击 **「运行」** 或 **「旁路测试」** 以开启超级面板的本地调试。

### 构建打包

1. **执行生产构建**（使用 Vite 对前端资源打包）：
   ```bash
   pnpm build
   ```

2. **在 uTools 中加载生产产物**：
   - 同样在开发者中心点击「加载本地插件」，并选中打包出来的 `dist/` 目录。
   - 您可以直接将 `dist/` 目录打包成 `cherry-studio-utools.zip` 并发布到 uTools 插件市场。

---

## 🤝 特别致谢

本项目能够顺利诞生，离不开卓越的著名开源 AI 桌面客户端——**[Cherry Studio](https://github.com/CherryHQ/cherry-studio)**！

我们在此对 **Cherry Studio 团队**（**[CherryHQ](https://github.com/CherryHQ)**）以及所有优秀的开源贡献者表达最诚挚的敬意与谢意：
- **感谢** 你们设计并贡献了如此高性能、极具美感且功能极其丰富的大模型接入 SDK 与高品质对话 UI。
- **感谢** 开源社区的繁荣生态，正是有了如此优秀的开源底座，我们才得以将 AI 的边界在 uTools 生态中以极低的延迟和极致的便携性进一步拓宽。

我们深信，好工具能为创造者插上翅膀。我们将密切保持与原项目的生态兼容，并持续共同推进中国 AI 生产力工具生态的开源与繁荣！

---

## 📜 许可证

本项目开源版遵循标准 GNU Affero General Public License v3.0 (AGPL-3.0) 许可证。