简体中文 | 繁體中文 | English | 日本語

本仓库是 EcoPasteHub/EcoPaste-Pro 的 Fork 版本，原版未提供mac平台打包，故在原版基础上增加些许修改和优化，打包mac平台自己使用

• 🌐 GitHub 主页：EcoPasteHub/EcoPaste
• 📥 官方下载：Releases 页面
• 📚 使用文档：EcoPaste 官网

• 📥 最新版本: 前往 Releases 下载最新构建程序包
• 📚 移动端数据同步指南
  • Android 同步配置指南（以 Tasker 为例提供完整配套文件，使用 MacroDroid 等自动化软件的用户完全可参考其逻辑举一反三自行编写）
  • iPhone 同步配置指南（整理中，待补充...）

• 🎉 基于 Tauri v2 开发，轻量高效，跨平台体验更进一步。
• 💻 支持 Windows、macOS 和 Linux（x11），在多设备间无缝切换。
• ✨ 简洁直观的用户界面，操作简单，零门槛上手，开箱即用。
• 📋 支持纯文本、富文本、HTML、图片和文件类型的剪贴板内容。
• 🔒 数据本地存储，确保用户隐私安全，数据完全掌控在用户手中。
• 📝 支持备注功能，轻松分类、管理和检索，让工作更高效。
• ⚙️ 丰富的个性化设置，满足不同用户需求，打造专属体验。
• 🤝 完善的文档与社区支持，与开发者共同探索与成长。
• 🧩 持续优化中，更多惊喜功能等你发现。

• 🔄 轻量数据同步模块落地：偏好设置加入「数据同步」入口，分为「基础配置 / 推送数据 / 接收数据」三大模块。
• 📤 主动推送能力接入主界面：历史记录头部操作按钮、右键菜单、偏好设置操作按钮均新增「推送」，支持把单条剪贴板内容主动发到外部设备。
• ⚙️ 自动推送策略：支持「关闭 / 仅收藏 / 自定义标签」三种模式；其中仅收藏模式会在条目标星时自动推送，自定义模式支持按内容类型标签筛选。
• 📡 自动接收服务：新增本地 HTTP 接收接口，支持 text / html / rtf / files / image 写入本地历史，并可选自动回写系统剪贴板。
• 🖼️ 图片中转策略：图片推送支持「局域网临时直链 / Webhook 网关 / WebDAV / 本地目录映射 / 直接拦截」五种策略。
• 📍 远端来源标记：远端写入内容会保留来源设备信息，并在列表中显示远端设备图标。

• 💻 代码预览换行优化：代码高亮预览改为真实高度裁切并支持自动换行，长代码不再横向溢出。
• 🎨 HTML 可读性增强：新增主题智能感知与文字对比度自动修正能力，解决明暗主题下文字显示不清的问题。
• ♻️ 防同步回环：新增传输回写指纹保护，避免“接收后自动复制”再次触发本地监听，造成重复入库或重复推送。
• 🖼️ 图片接收稳定化：接收图片统一转存为 PNG，并补充尺寸/体积元数据；针对 SVG / HEIC / HEIF 格式图片需要在上传时统一转换为普通图片。

• 🧵 推送链路队列化：推送改为异步队列处理，避免阻塞主剪贴板监听流程。
• 🔐 配置分层存储：敏感凭据走系统凭据存储，普通配置信息落入用户配置文件内。

• 🧲 操作按钮配置重构：修复了“自定义操作按钮弹窗”中无法拖动调整按钮顺序的问题，重构底层拖拽逻辑以兼容并存的“拖拽导入备份文件”功能。

• 🚀 粘贴为纯文本升级全局快捷键：重构「粘贴为纯文本」快捷键能力，打破仅限界内使用的局限，正式升级为全局快捷键。软件后台时一键粘贴剪贴板最新内容，前台时粘贴选中内容，使用更灵活。

• 📊 重构剪贴板类型识别引擎：修复了因开启「复制为纯文本」模式后，从办公软件（Excel/WPS）复制数据被误存为图片的问题。
• 🎯 复合型表格数据智能探测：针对从办公软件（Excel/WPS）复制数据与浏览器复制图片时极其相似的内容特征，引入了四维探测体系，实现了对办公表格数据的绝对精准定位与纯净化提取。
• 🧹 自动清理表格临时文件：识别表格后，自动删除无用临时图片，避免磁盘产生残留文件。
• 🔘 优化默认快捷按钮：默认开启 9 项常用快捷操作并调整排序（偏好设置 → 剪贴板 → 显示设置 → 操作按钮），全方位提升新用户开箱即用的便捷体验。
• 🖱️ 划词粘贴功能优化：将原「文本片段选取」功能更名为「划词粘贴」（偏好设置 → 剪贴板 → 内容设置 → 划词粘贴），功能意图表达更为直观；同时在偏好设置中将其位置移动至「自动粘贴」下方，设置时更直观。
• 📊 存储统计视图空间优化：深度精简存储统计页面冗余的包裹留白，左侧统计摘要区字号与宽度动态缩窄，为横向统计图表提供最大化可视化空间。

• ⌨️ 修复粘贴为纯文本快捷键失效问题：深度重构底层系统级按键注入逻辑，解决「粘贴为纯文本」和「快速粘贴」时按键异常导致的无响应问题，粘贴操作更稳定。
• 📈 修复统计图表边缘溢出：彻底修复在极窄窗口尺寸下，统计图表右侧内容被强行挤出窗口外的布局溢出问题。
• ⏰ 存储统计时间选择器自适应优化：修复了在选择「自定义」时间范围时，右侧超长的日期区间选择框被强行挤出窗口外的布局溢出问题。

• 📦 本地数据筛选导出：全新重构本地数据导出引擎，新增「范围 (全部 / 仅收藏) + 12 种内容类型」的多维组合筛选导出能力。导出的备份文件仅包含匹配的内容及关联图片，且能直接兼容导入恢复，备份更精准、更实用。
• 🏷️ 全局标准化备份命名体系：统一了 WebDAV 和本地导出的备份文件命名规则（应用名.时间戳.设备名.系统.模式.扩展名），并划分出full（完整）、lite（轻量）、filter（筛选）、favs（仅收藏） 4 种备份模式，备份文件管理更清晰。
• 📥 拖拽导入备份文件：新增拖拽本地备份文件恢复数据的功能，导入成功后自动刷新剪贴板列表，无需手动重启应用，恢复数据更便捷。
• ⌨️ 双击修饰键快捷唤起：打破传统组合键限制，新增「双击修饰键（Ctrl / Alt / Shift）」快捷打开剪贴板窗口，设置面板新增「录制 / 双击」切换开关，明确隔离空间组合键与时间双击键，配置更直观、操作更顺手。

• ✂️ 智能剔除边缘空格：复制邮箱、链接、路径或颜色值时，自动去掉内容首尾不小心复制的多余空格，避免内容被误判为纯文本，保证类型识别精准。
• 🎨 代码语法高亮重构：升级代码高亮效果，采用和 VS Code 一致的专业配色方案，代码可读性大幅提升；同时优化视觉效果，代码块与内容卡片融合更自然，阅读更沉浸。
• 🔄 导入恢复无感重载：重构导入备份文件与从 WebDAV 恢复的数据加载机制，实现导入后无需重启应用，剪贴板历史列表即时刷新的无感热重载体验。
• 🛡️ 精准识别剪贴板真实变化：优化后台监听逻辑，能精准过滤第三方软件或系统导致的假复制事件，只响应真实的剪贴板内容变更，后台运行更精准、更高效。
• 🔍 优化相同内容复制的来源识别：连续在不同应用复制相同的文本 / 图片时，能精准更新内容的来源应用图标和名称，且内容会正常置顶排序，符合使用直觉。
• 🔒 保护历史记录来源准确性：修复自动排序模式下，粘贴操作会错误修改历史记录来源应用的问题，确保记录的来源信息准确无误。
• 📊 清晰显示表格框线：从 Excel 等应用复制表格内容时，新增了安全、原生且不冲突的底层网格线保底样式，极大增强了数据呈现的结构性和可读性。
• ✂️ 优化 HTML 内容显示效果：修复复制 HTML 内容时，列表卡片首尾出现大片空白的问题，自动修剪多余空白，显示更紧凑美观。

• 📧 邮箱分组显示空白修复：修复点击邮箱分组后，实际已正确分类的邮箱记录无法显示的问题。
• 📌 置顶窗口粘贴后异常关闭修复：彻底修复置顶状态的剪贴板窗口，在执行各类粘贴操作后被强制关闭的问题，确保置顶窗口稳固显示。

• 📊 全景图表视界
  • 📋 多维存储统计面板：新增12大核心内容类型存储统计，直观展示空间占用情况；支持「全部/收藏」独立切换，可单独查看收藏记录占用数据。
  • ⚡ 超高性能统计引擎：重构物理体积溯源与大盘统计算法，移除阻塞性磁盘IO遍历，统一改为内存级数据库查询，上万条记录、数百GB数据也能瞬时加载。
  • 📈 动态视觉平衡算法：针对大小悬殊的「长尾数据」，采用开方平滑映射公式，兼顾直观对比的同时，避免小体积数据视觉“隐身”。
  • 🎯 全景数据透传交互：优化柱状图交互区域，鼠标悬停即可弹出悬浮卡片，实时显示对应类型的条目数量与精确体积。
• ⏳ 灵活的时间线流转
  • ⏰ 全局时间智能过滤：内置时间筛选器，支持今天、昨天、近三天、本周、本月及自定义日期范围，快速透视指定时段存储数据。
  • 🔗 全模块联动响应：时间筛选与统计图表、详情列表无缝同步，切换时间即可直观查看数据堆积与变化趋势。
• 🧹 防误删的智能大扫除
  • 🗑️ 按类型精准清理：支持按内容类型多选，一键批量清理 未收藏 / 已收藏 的冗余历史数据。
  • 🖼️ 图片深度联动清理：清理图片时，系统除了抹除数据库指纹，同时支持「同步删除本地图片文件」，真正释放磁盘空间，完美适配自定义存储路径。

• 🌐 网页链接识别修复：优化剪贴板类型判断逻辑，纯文本格式的URL/邮箱会强制识别为纯文本，解决从网页复制带样式链接被误判为HTML的问题。
• 🎨 颜色代码误判修复：重构颜色识别校验引擎，仅标准色值，避免普通英文单词（如 Tan、azure 等）被误判高亮。

• 📂 文件图标路径隔离修复：深度对接tauri-plugin-fs-pro底层API，文件图标将精准保存至用户自定义目录，不再残留到系统默认 AppData 路径。

• 📅 多维组合筛选：新增「日期 + 内容类型」多维度复合筛选能力，点击顶部漏斗图标即可唤起筛选面板。支持按日、按月、自定义时间范围三种独立日期筛选模式，同时支持 12 种内容类型标签多选，打造高效精准的内容检视链路。
• 🧩 代码 (SVG) 智能识别：新增代码层面的 SVG 格式化内容智能识别，依托"正则初筛组件骨架 + DOMParser 解析 XML 结构"双重校验构建安全壁垒，并将 SVG 识别结果归类展示为明确的 代码 (SVG) 标签。
• 📌 详情级全局 Tooltip：鼠标悬停在内容条目头部任意文字区域，即可详尽追溯内容全量核心属性，涵盖来源、内容类型、字符数（文件大小 / 分辨率）、创建时间等信息，详情查看更便捷。

• 📝 精准时间自适应显示：重构剪贴板历史记录时间显示逻辑，当相对时间（如 "3 天前"）跨度超过 3 天时，将自动切换为 YY/M/D H:mm 格式的绝对时间，时间追溯更清晰、更具参考性。
• 🧹 顶部控件布局重组：优化搜索悬浮窗顶部布局，合理收窄搜索输入框视觉宽度，同时将「置顶 / 取消置顶」「偏好设置」功能按钮组前置整合，大幅提升高频操作的触达效率。
• 🏗️ 焦点管理全链路回退：「不夺焦静默窗口」「窗口跟随光标位置」底层实现全量回退至原版 v0.6.0-beta.3 版本，剥离强依赖 Win32 API 的后台轮询线程与额外挂载接口，恢复主窗口原生焦点捕获机制。

• 🚀 激活时分组切换失效：彻底解决「偏好设置 - 剪贴板 - 窗口呼出时切换至全部分组」关键配置失效的问题，确保应用激活时严格遵循用户设定的分组规则。
• 📰 复合型代码误判：彻底修复从 IDE 开发环境或网页中复制同时携带"纯文本代码 + HTML 富文本语义"混合片段时，内容被粗暴定性进而被强制识别为 HTML 超文本类型 的底层优先级越权漏洞，确保复制的代码内容可被精准识别归类。
• 🌐 HTML 代码误判：重构 HTML 代码底层判定逻辑，补全对声明头部、大小写不敏感场景的正则兼容支持，彻底解决因骨架校验失效导致的内容误判问题，识别准确率大幅提升。
• 📝 Markdown 误判：彻底重构 Markdown 检测逻辑，升级为「核心语法正向加权 + 非法特征负向惩罚 + 严格前缀边界校验」的复合型智能判定引擎，有效解决 JS 等其他代码片段被误判为 Markdown 格式的问题。
• 📋 JavaScript 代码误判：重构底层代码语言检测引擎，将 JavaScript 判定优先级调至最高，针对性补充前端构建编译产物的强特征词；同时移除 C++ 检测规则中易与 JS 位移运算冲突的通用操作符（<<、>>），新增 JS 特征词「反向查杀」校验机制，彻底解决混淆、压缩后的前端 JS 生产代码被误识别为 "代码 (C++)" 的顽固问题。
• 🗑️ 历史遗留垃圾清剿：深度比对甄别并彻底清理废弃挂载的残存临时文件，从根源杜绝冗余数据对后续功能重构的干扰。

• 👁️ 条目头部全宽释放：取消了原版界面中为右侧隐形操作按钮强行预留的固定宽度"自留地霸占"行为，未选中状态下的记录头部属性栏可实现 100% 全宽显示，内容展示空间更充足、信息呈现更完整。

• 🔀 分组切换内容显示异常：修复了剪贴板窗口快速连续切换分组时内容显示不正确的竞态条件问题，根源是组件加载状态下第二次分组点击请求被丢弃所导致。

• 🛡️ 向下兼容加固：遵循「发送保守、接收宽容」的鲁棒性原则，解决版本降级时因数据结构不兼容导致的崩溃问题。
• 🗄️ 数据库查询防护：重构数据库查询层，采用「统一列定义 → 按需查询」架构，由 historyColumnDefs 单一数据源同时驱动建表与查询。低版本会自动忽略高版本数据库新增的未知列，彻底杜绝因结构差异导致的降级崩溃。
• ⚙️ 配置文件处理防护：新增 strictDeepAssign 严格深度合并机制，配置同步时仅接受当前版本已定义的配置项，高版本写入的未知配置字段将被静默丢弃，防止状态污染引发的渲染异常。

• 🎨 文本选中高亮优化：将剪贴板内文本片段选取的高亮背景色改为蓝色 #4096FF，文字颜色设为白色 #FFFFFF。
• 📍 返回顶部按钮优化：统一调整剪贴板窗口右下角「返回顶部」按钮位置，底部与右侧边距保持对等。

• 📋 来源应用信息修复：修复剪贴板 autoSort 开启时，最新条目来源图标 / 名称错误显示为当前活动窗口信息的问题，改为保留原始复制时的应用信息。
• 💥 降级安装崩溃修复：修复从高版本降级安装低版本时，剪贴板窗口因数据库多余字段导致 Cannot destructure property 'key' 渲染崩溃的问题（仅对当前及后续版本生效）。

• ✂️ 支持文本片段选取：可在剪贴板窗口中选中指定文本片段，通过自动弹出的浮动工具栏或增强右键菜单快速执行「复制 / 粘贴」操作，且不影响原有“单击 / 双击粘贴”功能，支持纯文本、富文本、HTML类型。
• 🔛 文本片段选取独立开关：可按需启用或禁用部分文本选取功能（偏好设置 → 内容设置 → 文本片段选取）。

• 🎨 CMYK颜色识别：新增 CMYK 颜色格式的智能提取与预览支持。

• 🖱️ 右键菜单重构：
  • 功能分组：按「复制粘贴类 / 操作类 / 编辑类」细分归类，关联功能聚合排布，高频连续操作就近放置，缩短操作距离，提升选择效率。
  • 功能排布：依据操作流程先后与使用频率优化功能排序。
  • 专属定制：针对纯文本、富文本、HTML、图片、文件、Markdown、链接、路径、代码、邮箱、颜色、指令 12 种剪贴板内容类型，分别量身定制专属菜单项。

• ⚙️ 操作按钮配置修复：补齐偏好设置中操作按钮缺失的「运行」选项，支持在设置界面正常配置显隐和顺序。
• 🎨 颜色分组同步修复：修复在颜色专属分组内复制新颜色内容时，列表未动态置顶更新的显示同步问题。

• 🔍 Windows 路径与指令智能识别：自动识别环境变量路径 (%APPDATA% 等)、Shell 文件夹 (shell:startup 等)、文件系统路径 (C:\Windows 等) 和管理工具指令 (regedit 等)，支持右键菜单和操作按钮一键快速打开或运行。
• 🔄 配置文件自动同步：偏好设置变更时自动同步配置到用户自定义目录，确保备份配置始终最新。

• ☁️ WebDAV 云备份体系完善：
  • 精简与完整备份解耦：细分“完整”与“精简”两种备份规则，支持手动、自动备份场景下的独立管控，灵活适配不同备份需求。
  • 自动调度引擎：内置独立的前端任务调度引擎，实现了灵活的“定时”、“间隔”以及“Cron表达式”三种循环模式，实现完整备份与精简备份双线并行调度，提升备份效率。
• 📝 新增 Markdown 支持：采用全新计分权重正则检测法，精准判断Markdown格式，彻底规避普通文本、代码被误判归类的问题，同时支持 Markdown 格式化沉浸编辑，优化编辑体验。
• 🖼️ 图片定位目录：图片类型支持一键拉起资源管理器精准定位原文件所在目录。

• ☁️ 无缝恢复交互：重构WebDAV恢复弹窗唤醒机制，会优先即刻渲染骨架及 Loading UI，后台采用非阻塞式拉取云端记录，彻底解决网络延迟导致的界面假死、无反馈顿挫问题，提升操作流畅度。
• 💾 备份压缩包兼容性优化：运用独立临时隔离区 (Staging Dir) 技术，使得 WebDAV 备份结构与原生本地“导出数据”完全一致，实现双入口无缝兼容，备份与恢复全程无阻碍。

• 🌐 WebDAV 跨端阻断：利用 Rust 原生钩子 (ensure_remote_dir) 自动在目标云端探测并递归构建父级目录，彻底解决了因上级目录丢失而抛出的 405 Method Not Allowed 错误。
• 💾 数据库备份异常截断：防御性修复了因底层 Kysely 历史表中存在 NULL 系列空白字段导致的 Invalid column type Null 报错中止问题，保障数据库备份的完整性与稳定性。
• 📋 类型判断权重优化：彻底修复从 Excel 等表格软件复制单元格时，由于同时持有 Image + HTML 格式组合，导致文本内容被强制降权、误识别为图片的底层漏洞，确保复制内容识别准确。

• ☁️ WebDAV 云端备份：支持通过 WebDAV 协议将剪贴板数据备份到云端（坚果云、NextCloud 等），提供手动备份、自动定时备份、备份数量限制、一键恢复等完整功能。
• 🔒 本地凭据安全存储：WebDAV 的服务器地址、用户名、密码与路径等敏感配置信息均采用原生调用系统级 Windows 凭据管理器（Credential Manager）进行高强度加密安全持久化存储，应用层面不再以明文暴露，彻底杜绝隐私泄露风险。
• 🗑️ 可选删除本地图片：删除图片内容时，二次确认弹窗增加"删除本地文件"选项（默认选中），可选择保留本地文件仅删除剪贴板记录。

• 🎨 独立群组与颜色直出：新增 "链接"、"颜色"、"代码"、"邮箱" 原生专属群组分类。精准提取并高亮显示 RGB/RGBA 等颜色格式，路径链接高亮直击目标。
• 📝 二次沉浸编辑：支持文本等富内容数据的独立二级弹窗编辑与系统级别快速文件定位。
• 💻 高亮代码语法预览：自动侦测复制的代码片段并赋予媲美 IDE 界面的原生级代码语法高亮渲染（偏好设置 → 剪贴板 → 显示设置 → 代码语法高亮）。
• 🎯 数据来源截取：提供来源拷贝 App 的 Icon 与应用名称获取（偏好设置 → 剪贴板 → 显示设置 → 记录应用来源）。
• ⚡️ 原生快速访问：支持在资源管理器中直接打开文件路径，在浏览器中一键打开网页链接，以及调用系统默认图片查看器查看图片内容。
• 🔢 代码/文件显示行数自定义：扩展了行数适配能力，支持代码和文件类型（偏好设置 → 剪贴板 → 显示设置 → 代码/文件显示行数）。

致谢：本项目中“独立群组与颜色直出”、“二次沉浸编辑”、“高亮代码语法预览”、“数据来源截取”与“原生快速访问”的实现思路参考自 EcoPaste-Sync，特此致谢。

• 📸 截屏完美转储：重构 SQLite 日志行为及底层 FS 映射链路，让截屏图片完美保存至指定的自定义本地目录，彻底解决原版截图因内置库限制导致自定义目录崩溃和展示图片白板红叉的问题，杜绝 C 盘资源浪费。
• 🔗 复制链接双重记录：彻底修复复制链接时剪贴板会出现两条完全相同记录的顽固问题。
• 📊 复制文档表格内容双重记录：彻底修复从 Word、Excel 等文档的表格中复制内容时，剪贴板会同时出现两条完全相同重复记录的问题。

• 展开完整数据：当内容超过显示限制时提供展开/收起按钮，图文状态不受虚拟滚动破坏，滚动后状态始终保持。
• 不夺焦静默窗口（Windows）：呼出窗口时原应用保持主焦点，双击条目直接静默粘贴；点击窗口外部立即自动隐藏。
• 自动跟随输入光标：窗口跟随编辑器输入光标位置贴图显示，实现心流体验。
• 偏好设置架构重制：新增「显示设置」分组，精细化分类各项高级设定。

• 文本显示行数自定义：偏好设置 → 剪贴板 → 显示设置 → 文本显示行数（1 - 50 行）
• 图片预渲染高度缩放：支持灵活调整图片高度，超过后智能展开或统一收起（50 - 500 像素）

• 所有新增配置项自动保存到用户数据目录，应用更新后配置不会丢失，无需手动导出/导入。

• 📋 剪贴板类型误判：彻底修复网络图片可能会因 html 权重被错误识别为网页的问题。深度改写判定逻辑，赋予图片层级最高优先级。
• 💾 备份通道恢复：原版中由于权限限制被遗弃的数据备份入口，全面解封并确保导入导出稳定运行。

• 每天自动检查上游 3899/EcoPaste-Pro 的更新
• 有新版本时跨分支自动合并并触发增量构建
• 如遇重构冲突会创建 Issue 提供手工接轨通道

1. 🔍 优先查阅常见问题或浏览已有 issues。

2. ❓ 如果问题仍未解决，请提交新的 issue，并附上详细描述，方便我们快速定位和解决。