(开源)语义剪贴板

约 1837 字大约 6 分钟

2026-09-10

语义剪贴板

“本地优先、零云依赖”的语义剪贴板。用自然语言搜回你复制过的内容，自动死亡相似主题，并接入OpenAI兼容大模型做总结/翻译/问答。基于Electron，纯JS存储+WASM本地支持检索。

本地优先、零云依赖的语义剪贴板。用自然语言搜回你复制过的内容，自动聚类相似主题，并接入 OpenAI 兼容大模型做总结 / 翻译 / 问答。基于 Electron，纯 JS 存储 + WASM 本地向量检索。

（在新窗口打开）

作者：科技酱

✨ 核心特性

🔍 语义检索 — 向量相似度匹配，不依赖原话；搜"那个 API 文档链接"命中 https 链接
🧩 自动聚类 — 相似主题的历史条目自动归组
🔒 本地优先 — 数据、向量、检索全程本地，无云端
🛡️ 永远可用 — 语义模型不可用时自动降级为本地 n-gram 向量，功能不中断
⚡ 零原生编译 — 纯 JS 存储 + WASM 嵌入，避开原生模块编译地狱
🤖 AI 助手 — 接 OpenAI 兼容大模型，基于剪贴板历史总结、翻译、归类、问答，流式输出
📋 托盘 + 全局快捷键 — Ctrl+Shift+V 随时唤起
🏷️ 自动分类 — 链接 / 代码 / 错误 / 数据 / 文本徽章
📌 置顶 / 使用次数 / 持久化
🌸 粉色系主题 — 优雅舒适的 UI，自定义粉色品牌 Logo
👩‍💻 作者中心 — 顶栏作者按钮一键弹出，直达 GitHub / 文档 / 博客 / B 站 / 论坛 / 赞助

📥 下载

前往 Releases 下载：

Windows 安装版：Semantic Clipboard-Setup-0.1.0-x64.exe
Windows 绿色版：Semantic Clipboard-Portable-0.1.0-x64.exe（免安装，双击即用）
macOS / Linux：CI 产物 .dmg / .AppImage --- 暂无

🚀 源码运行

npm install
npm start

📖 用法速查

操作	说明
复制任何文本	自动入库（去重 + 类型识别）
`Ctrl+Shift+V`	全局唤起 / 隐藏窗口
搜索框输入自然语言	实时语义匹配
`Enter`	复制结果首条
`/`	聚焦搜索
`Esc`	清空搜索 / 停止 AI 生成
卡片悬停	★置顶 / ⧉复制 / ✕删除
顶栏「聚类」	查看相似内容分组
顶栏「AI 助手」	基于剪贴板历史对话（需配置）
顶栏作者按钮	弹出作者卡片，直达社交平台
托盘右键	显示/隐藏 · AI 设置 · 模型状态 · 清空历史 · 退出

底栏圆点：🟢 绿 = 语义模型就绪，🟡 黄(闪) = 模型下载中，🟡 黄(常亮) = 降级模式

🏗️ 打包发行

npm install
npm run icon        # 生成粉色主题图标
npm run dist        # 产出 ./release/ 下安装包
npm run dist:win    # 仅 Windows：NSIS + Portable

产物（Windows）：

Semantic Clipboard-Setup-0.1.0-x64.exe — NSIS 安装版
Semantic Clipboard-Portable-0.1.0-x64.exe — 绿色免安装版

国内网络打包：

$env:ELECTRON_MIRROR='https://cdn.npmmirror.com/binaries/electron/'
$env:ELECTRON_BUILDER_BINARIES_MIRROR='https://cdn.npmmirror.com/binaries/electron-builder-binaries/'
$env:ELECTRON_CACHE='./.electron-cache'
$env:ELECTRON_BUILDER_CACHE='./.electron-builder-cache'
$env:CI='false'
node node_modules/electron-builder/cli.js --win --publish never

📂 项目结构

./
├─ package.json               依赖/脚本/electron-builder 配置
├─ README.md                  本文件
├─ docs/
│  ├─ 开发文档.md             架构/模块/打包/扩展
│  ├─ 使用文档.md             功能/操作/FAQ
│  └─ 教程.md                 10 分钟入门
├─ scripts/generate-icon.js   纯 JS 生成粉色主题图标
├─ .github/workflows/release.yml  CI 多平台构建发布
├─ build/                     图标产物（icon.ico / icon.png）
├─ src/
│  ├─ main/                   主进程（窗口/托盘/IPC/引擎）
│  ├─ preload/preload.js      contextBridge 受控 API
│  ├─ renderer/               渲染进程（HTML/CSS/JS UI）
│  └─ assets/                 asar 打包的图标资源
├─ .app-data/                 运行时数据（gitignored）
└─ release/                   打包产物（gitignored）

📚 详细文档