# AI Tools

一个运行在 uTools 内的 AI 工具箱插件，围绕“聊天、笔记、自动化、扩展接入”四条主线组织能力。项目基于 Vue 3 + Vite 构建，适合把个人 AI 助手、知识沉淀和工具调用整合到一个桌面工作台里。

## 它能做什么

### 1. 聊天工作台

- 支持多会话管理、新建会话、保存会话、会话列表浏览与继续对话
- 支持服务商、模型、智能体、提示词、技能、MCP 服务自由组合
- 支持附件参与上下文，包括常见文档、图片等内容解析
- 支持 Markdown 渲染、代码高亮、工具调用过程展示、思考过程折叠查看
- 支持编辑后重发、重新生成、复制消息、会话媒体库等高频操作
- 支持图片/视频生成参数配置与媒体结果管理
- 支持上下文窗口策略，控制历史消息、附件与前导信息的注入方式
- 支持聊天记忆，可沉淀事实、偏好、风格、约束等长期信息

### 2. 笔记系统

- 支持普通 Markdown 笔记与 Notebook 式“超级笔记”
- 支持文件树、标签页、多笔记并行编辑
- 支持 Mermaid、ECharts、数学公式等增强内容
- 支持附件清理、笔记链接复制、Markdown 链接复制、HTML 导出
- 支持单篇笔记密码保护
- 支持通过全局配置密码为笔记提供恢复能力，便于忘记单篇密码时重置

### 3. Notebook Runtime

- 为超级笔记提供独立运行时能力
- 支持配置 Python 路径、虚拟环境目录、Kernel 名称、启动超时、执行超时
- 支持 Python LSP 检测与补全能力检查
- 支持按笔记绑定运行环境
- 支持 notebook magic 指令、受管虚拟环境创建与依赖安装

### 4. 配置中心

#### 服务商

- 可接入兼容 OpenAI 风格接口的模型服务
- 支持拉取模型列表并选择启用模型
- 内置 uTools 官方 AI 服务商入口，可直接同步 uTools 已配置模型

#### 智能体

- 可为智能体绑定默认模型、提示词、技能、MCP 服务
- 支持设置高级模型参数，如 temperature、top_p、max_tokens、reasoning effort 等

#### 提示词

- 支持新增、编辑、删除本地提示词
- 可作为默认系统提示词或智能体专属提示词使用

#### 技能

- 支持内联技能
- 支持导入目录型技能或单独导入 `SKILL.md`
- 支持为技能绑定触发词、标签、正则、意图和 MCP 依赖

#### MCP

- 支持 `stdio`、`sse`、`streamableHttp`、`http` 四种接入方式
- 支持请求头、环境变量、工作目录、超时、keep-alive 等配置
- 支持工具启用范围控制
- 支持在界面中直接测试工具、查看 prompts、查看 resources

#### 笔记配置

- 支持模板与图表相关配置
- 用于统一管理笔记侧的增强编辑体验

#### 全局配置

- 支持主题切换
- 支持数据存储根目录切换
- 支持默认系统提示词配置
- 支持联网搜索代理与搜索 API 配置
- 支持图片/视频生成默认模式配置
- 支持聊天上下文窗口配置
- 支持聊天记忆配置、向量重建、清洗与目录管理
- 支持云同步配置
- 支持配置导入/导出
- 支持全局配置密码与安全问题重置

### 5. 自动化与同步

#### 定时任务

- 支持单次执行、间隔触发、每日、每周、每月定时任务
- 可指定执行智能体、任务内容、附带技能、附带 MCP 服务
- 可自动保存任务执行会话
- 当前定时任务仅在插件运行期间触发

#### 云同步

- 支持备份到云端
- 支持以本地为准同步到云端
- 支持从云端恢复到本地
- 支持自动备份和自动恢复开关
- 当前实现面向 S3 兼容存储

### 6. uTools 集成

- 通过 `AI Tools` 入口打开完整工作台
- 通过超级面板 `问 AI` 直接把输入带入聊天场景
- 使用 preload 能力桥接文件操作、会话、笔记、MCP、Notebook Runtime、云同步等本地功能

## 适合的使用场景

- 把多个模型服务统一放进一个桌面入口
- 边聊天边沉淀笔记、图表和 Notebook 内容
- 让智能体按固定配置调用本地或远程工具
- 为日常重复任务建立轻量自动化
- 在本地维护自己的 AI 知识工作流