# 代码片段 - uTools 插件

一个简洁高效的 uTools 代码片段管理工具，支持多语言语法高亮、快速搜索和一键粘贴。

## 功能介绍

- **代码片段管理** — 创建、编辑、删除代码片段，支持标题和语言分类
- **Monaco 编辑器** — 内置 VS Code 同款编辑器，提供语法高亮和智能提示
- **快速搜索粘贴** — 通过 uTools 输入框直接搜索片段，回车即粘贴到当前光标位置
- **双击复制** — 在列表中双击片段即可复制代码到剪贴板
- **亮/暗主题** — 自动跟随系统主题切换
- **15 种语言** — JavaScript、TypeScript、Python、Java、C#、HTML、CSS、JSON、SQL、XML、YAML、Markdown、Shell、Vue、纯文本

## 安装

1. 确保已安装 [uTools](https://u.tools/)
2. 将本项目构建后的 `dist/` 目录打包为 uTools 插件
3. 在 uTools 开发者工具中导入 `plugin.json` 即可使用

## 使用教程

### 管理模式

在 uTools 中输入 `代码片段`、`code snippet` 或 `cs` 进入管理模式：

1. **新建片段** — 点击左上角 `+` 按钮，在右侧编辑区填写标题、选择语言、编写代码，点击「保存」
2. **编辑片段** — 在左侧列表点击任意片段，右侧编辑区加载内容，修改后点击「保存」
3. **删除片段** — 选中片段后点击「删除」按钮，或右键点击选择「删除」
4. **复制代码** — 在列表中双击片段复制代码到剪贴板，或右键选择「复制代码」
5. **搜索筛选** — 在左侧顶部搜索框输入关键词，按标题或语言筛选片段

### 搜索粘贴模式

在任何输入框中，选中一段文字后通过 uTools 超级面板进入「搜索代码片段」：

1. 输入关键词搜索匹配的代码片段
2. 使用 `↑` `↓` 方向键选择目标片段
3. 按 `Enter` 确认，代码自动粘贴到原光标位置并退出插件

> 也可直接在 uTools 中输入 `代码片段` 进入搜索界面。

## 技术栈

- Vue 3（Composition API）
- Naive UI 组件库
- Monaco Editor（VS Code 编辑器内核）
- uTools DB / dbStorage 持久化存储

## 开发

```bash
npm install # 安装依赖
npm run dev # 启动开发服务器（uTools 开发模式下指向 localhost:5173）
npm run build # 构建生产版本到 dist/
```

## 数据存储

- 片段元数据（标题、语言等）存储在 `utools.db`，前缀 `code_snippets/`
- 代码内容存储在 `utools.dbStorage`，键名格式 `code_snippets_code_xxxxx`
- 所有数据保存在本地，不涉及网络传输