Clipboard Master

剪贴板管理大师 - 历史记录、快速搜索、格式转换，让您的剪贴板更强大

简介

Clipboard Master 是 Spark 的剪贴板管理插件，帮您记录剪贴板历史、快速搜索、格式转换和 Pin 重要内容。

核心特性

• 历史记录 - 自动保存剪贴板历史，支持文本、图片、文件
• 快速搜索 - 毫秒级搜索历史记录
• 格式转换 - JSON、HTML、Markdown 等格式转换
• Pin 功能 - 固定重要内容，永不过期
• 云同步 - 跨设备同步剪贴板历史
• 快捷粘贴 - 自定义快捷键快速粘贴常用内容

安装

Spark 插件市场安装

1. 打开 Spark (Cmd/Ctrl + K)
2. 输入 "Clipboard" 或 "剪贴板"
3. 回车进入插件页面
4. 点击安装

命令行安装

spark install spark-plugin-ui--clipboard-master

快速开始

唤起剪贴板历史

安装后，使用快捷键唤起历史记录：

# macOS
Cmd + Shift + V

# Windows/Linux
Ctrl + Shift + V

基本使用

1. 复制内容 - 正常使用 Cmd/Ctrl + C 复制
2. 查看历史 - 按 Cmd/Ctrl + Shift + V 打开历史面板
3. 选择粘贴 - 上下键选择，回车粘贴
4. 搜索过滤 - 直接输入搜索关键词过滤历史

历史记录

记录类型

Clipboard Master 支持多种内容类型：

类型	说明	示例
文本	纯文本内容	代码片段、URL
富文本	带格式的文本	HTML、Word 内容
图片	截图、复制图片	PNG、JPG
文件	文件路径	文件夹路径
颜色	颜色代码	#007aff

历史记录配置

{
  "history": {
    "maxItems": 1000,
    "maxTextSize": 1048576,
    "maxImageSize": 10485760,
    "retentionDays": 30,
    "excludeApps": ["1Password", "Bitwarden"]
  }
}

查看历史

# 打开历史面板
clipboard history

# 查看最近 10 条
clipboard history --limit 10

# 按类型筛选
clipboard history --type image

# 按应用筛选
clipboard history --app "VS Code"

快速搜索

搜索语法

# 关键词搜索
spark plugin

# 正则表达式
/https?:\/\/\w+/

# 按类型搜索
type:image
type:text

# 按时间搜索
today
yesterday
last:7days

# 按应用搜索
app:Chrome
app:VS Code

搜索快捷键

快捷键	功能
/	进入搜索模式
Cmd/Ctrl + F	聚焦搜索框
Up/Down	选择历史记录
Enter	粘贴选中项
Cmd/Ctrl + Enter	粘贴并关闭
Delete	删除选中项
Cmd/Ctrl + P	Pin/Unpin

格式转换

支持的转换

源格式	目标格式
HTML	Markdown
HTML	纯文本
JSON	YAML
JSON	XML
URL 编码	解码后文本
Base64	解码后内容
Markdown	HTML

使用转换

# 转换剪贴板内容
clipboard transform --to markdown

# 转换并复制
clipboard transform --to yaml --copy

# 转换并粘贴
clipboard transform --to plain-text --paste

转换示例

// HTML 转 Markdown
const html = '<h1>Title</h1><p>Content</p>'
const md = await Clipboard.transform(html, 'html-to-markdown')
// 结果: # Title\n\nContent

// JSON 美化
const json = '{"a":1}'
const beautified = await Clipboard.transform(json, 'json-beautify')
// 结果: {\n  "a": 1\n}

// URL 解码
const encoded = 'https%3A%2F%2Fspark.center'
const decoded = await Clipboard.transform(encoded, 'url-decode')
// 结果: https://spark.center

Pin 功能

Pin 功能让您固定重要内容，永不过期。

Pin 内容

# Pin 当前剪贴板内容
clipboard pin

# Pin 指定内容
clipboard pin "重要信息"

# 查看所有 Pin
clipboard pin --list

# 取消 Pin
clipboard pin --remove <id>

Pin 管理

{
  "pinned": [
    {
      "id": "1",
      "content": "API Key: sk-xxxxxx",
      "type": "text",
      "pinnedAt": "2024-01-15T10:00:00Z",
      "tags": ["work", "api"]
    },
    {
      "id": "2",
      "content": "#007aff",
      "type": "color",
      "pinnedAt": "2024-01-15T11:00:00Z",
      "tags": ["design"]
    }
  ]
}

快速访问 Pin

# 唤起 Pin 列表
Cmd/Ctrl + Shift + P

# 搜索 Pin
clipboard pin --search api

命令与快捷键

全局快捷键

快捷键	功能
Cmd/Ctrl + Shift + V	剪贴板历史
Cmd/Ctrl + Shift + P	Pin 列表
Cmd/Ctrl + Shift + D	清空历史
Cmd/Ctrl + C	复制（系统）
Cmd/Ctrl + V	粘贴（系统）

历史面板快捷键

快捷键	功能
j/k 或 ↑/↓	上下选择
Enter	粘贴选中项
Cmd/Ctrl + Enter	粘贴并关闭
Space	预览内容
Delete	删除选中项
Cmd/Ctrl + P	Pin/Unpin
Cmd/Ctrl + E	编辑内容
Esc	关闭面板

命令行

# 查看当前剪贴板
clipboard get

# 设置剪贴板
clipboard set "Hello World"

# 清空历史
clipboard clear

# 导出历史
clipboard export --file history.json

# 导入历史
clipboard import --file history.json

云同步

启用云同步后，剪贴板历史可在多个设备间同步。

配置云同步

# 启用云同步
clipboard sync enable

# 选择同步类型
clipboard sync set-type full  # full | text-only | pinned-only

# 设置同步频率
clipboard sync set-interval 300  # 秒

同步状态

# 查看同步状态
clipboard sync status

# 手动同步
clipboard sync now

# 同步设置
clipboard sync config

隐私与安全

敏感应用排除

Clipboard Master 会自动排除密码管理器等敏感应用：

{
  "excludeApps": [
    "1Password",
    "Bitwarden",
    "LastPass",
    "Keychain Access"
  ]
}

本地加密

剪贴板历史本地加密存储：

# 设置加密密码
clipboard security set-password

# 加密现有历史
clipboard security encrypt-history

自动清理

# 设置保留天数
clipboard config set retention-days 30

# 自动清理敏感内容
clipboard security auto-clean --patterns

API 使用

Clipboard Master 提供 API 供其他插件调用：

import { Clipboard } from '@spark-center/clipboard-master'

// 获取当前剪贴板
const current = await Clipboard.get()

// 获取历史记录
const history = await Clipboard.history({ limit: 10 })

// 搜索历史
const results = await Clipboard.search('spark')

// Pin 内容
await Clipboard.pin('important content', { tags: ['work'] })

// 格式转换
const transformed = await Clipboard.transform(content, 'html-to-markdown')

最佳实践

1. 定期清理 - 定期清理不需要的历史记录
2. 善用 Pin - 将常用内容 Pin 起来快速访问
3. 敏感应用排除 - 确保密码管理器被排除
4. 云同步谨慎 - 仅同步必要的内容

常见问题

剪贴板历史占用了多少空间？

默认配置下，历史记录约占 10-50MB 空间，取决于保存的图片数量。

如何禁用自动记录？

clipboard config set auto-record false

支持跨平台同步吗？

支持。在多个设备上登录同一 Spark 账号即可同步。

相关资源

• Clipboard Master GitHub
• 隐私政策
• 快捷键完整列表