clipboard-tool

项目概述

剪贴板（clipboard-tool）是一款多用户的剪贴板管理工具，属于 tools-center 平台工具，后端基于 Node.js 且零第三方依赖。它提供一个「万能入口」：只要把内容粘贴进来就会被自动识别并保存——URL 存为链接，其他文本存为文本，拖放或按 Ctrl+V 的文件存为文件条目，复制的图片也能直接存入。软件采用暗黑新拟态（Neumorphism）界面，配色为黑金奢华风格，首页为极简墙布局，支持多用户、标签体系、拼音首字母搜索、智能排序，以及通过 WebDAV 进行备份与多设备同步。它解决的是日常复制粘贴的内容散落各处、难以检索、跨设备无法共享、重要内容容易丢失的问题。

主要功能

• 单一万能入口：粘贴时自动识别类型（URL 存为链接，其他存为文本）、拖放或选择文件生成文件条目、按 Ctrl+V 粘贴图片或文件；检测到复制内容会自动弹出大窗口
• 一键复制与双击编辑：文本和链接可一键复制内容，图片点击后直接写入系统剪贴板，其他文件点击即可下载
• 富文本双格式复制：从网页或 Word 复制带格式内容时自动检测 text/html，卡片内容区左右分栏，点左栏复制纯文本、点右栏粘贴到 Word 或飞书可保留格式；Word 私有属性与文档级设置均字符串级保真；编辑弹窗提供「清除格式」一键转纯文本
• 智能排序：星标置顶，其次按使用次数，再次按最近更新，点击次数越高越靠前
• 拼音首字母搜索：内置 3755 个常用字映射表，输入 sf 即可搜到「身份」
• 标签体系：可点选已有标签或输入新建，支持按标签过滤列表，标签较多时自动换行并全部可见
• 多用户：采用双名模型，账号名（创建后不可变，作为跨设备迁移与同步的身份键）与显示名（可随时修改，仅影响展示）；支持无密码零摩擦进入或可选密码锁，会话持久化（重启不掉线，30 天有效）
• WebDAV 备份同步：单向全量备份与双向合并同步，墓碑机制防止删除后复活，全部清空不传播删除，默认 12 小时定时自动同步，可选同步文件实体，地址留空默认使用局域网服务器；快照按账号名寻址，新设备创建相同账号名并配置 WebDAV 后同步即可拉回全部数据
• 滚动归档：活跃区上限为每用户 500 条，超出自动移入归档且零丢失，勾选「含归档」可搜索历史，归档参与 WebDAV 完整备份，卡片可恢复或删除
• 本地备份：一键导出全部数据（含归档）为 JSON，导入时合并（同一 id 取较新者），不依赖 WebDAV
• 其他实用功能：保存链接时自动剔除 UTM 等追踪参数、在设置里重命名或删除标签、文本为 JSON 时一键格式化预览、顶栏一键切换彩色或灰度配色
• 安全措施：UUID 白名单防路径穿越、原子写、登录限流、上传黑名单（拒绝可执行与脚本类文件）、下载强制 attachment

适用人群

• 需要在多台设备间共享剪贴板内容的用户
• 经常复制网页或 Word 富文本并希望保留格式的用户
• 希望把零散复制的文本、链接、图片、文件统一整理并长期保存的用户
• 注重数据自主可控、希望自建 WebDAV 备份的用户
• 喜欢自托管、单文件零依赖工具的开发者

快速上手

1. 确认机器已安装 Node.js 22.7 或以上版本。
2. 在项目根目录运行 node server.mjs [port] 启动服务，默认端口为 8130；数据目录默认为 ./.data，可用环境变量 CAP_STORAGE_DIR 覆盖。
3. 用浏览器打开对应地址即可使用：粘贴内容会自动识别并保存，复制的图片或文件也会自动弹出大窗口；文本条目为 JSON 时还能一键格式化预览。
4. 使用本地服务版可直接解压后双击 delivery/server/start-server.cmd 启动（需 Node.js 22.7 及以上，零依赖无需 npm install）；使用平台版可把整个 clipboard 目录放到 tools-center 的 tools 挂载目录，平台重扫即可。
5. 需要多设备同步时，在「数据管理」到「WebDAV」中填写同一个地址并使用相同的账号名，然后各点一次「一键同步」；两台设备要能互相拉取，建议先在存有图片或文件的设备上同步一次，把这些实体推上云。
6. 启动后控制台首行会打印版本指纹，例如 clipboard v0.7.6 加提交号，可用来确认运行的是哪个版本。

核心优势

• 零第三方依赖：后端只用 Node.js 内置的 http 与 fetch，部署简单
• 万能入口：粘贴即存，自动识别文本、链接、图片、文件，几乎无需手动分类
• 富文本保真：网页与 Word 复制的内容可保留格式，也可一键取纯文本
• 数据自主可控：通过标准 WebDAV 自建备份与同步，快照按账号名寻址，设备迁移零配置
• 单文件前端：原生 HTML 与 JS 无框架，界面精致且易于二次定制

系统要求

• 操作系统：macOS、Linux、Windows 等可运行 Node.js 的平台
• 支持架构：跨平台（依赖 Node.js 运行环境）
• 额外依赖：Node.js 22.7 及以上；服务端零第三方依赖，无需 npm install；多设备同步需自备 WebDAV 服务

注意事项

• 文档中的 /tmp 路径为类 Unix 写法，Windows 下请改用绝对路径，例如 C:/Temp/clip-test。
• 运行冒烟测试或 WebDAV 测试时请使用独立的数据目录，不要对真实数据目录执行。
• exe 桌面版（clipboard-exe 目录）为 C# WPF 重写，目前处于规划或开发阶段，可能需要 .NET 9 Desktop Runtime。
• WebDAV 同步中的「同步文件实体」默认开启：它只决定本地有实体时是否上传备份，从云端拉回缺失实体为无条件执行，因此新设备即使未开启该开关也能下载到文件。