ClipHub：基于 ShortX 的 Android 全局悬浮剪贴板与分词工具

ClipHub 是一套运行在 Android、ShortX 与 Rhino ES5 环境中的全局悬浮剪贴板工具。它可以在后台保存文本剪贴板历史，再通过悬浮窗口完成搜索、筛选、标签、排序、编辑、翻译和分词。

本文根据 GitHub 仓库 7015725/ClipHub 的 main 分支整理。当前模块集版本为 20260819.08，入口版本为 8，Manifest Schema 为 2，正式运行模块数量为 20。

ClipHub 能解决什么问题

• 把多条文本剪贴板历史保留下来，方便再次查找、复制和整理。
• 在任意应用上方打开悬浮剪贴板，减少应用来回切换。
• 通过关键词、来源应用、标签、置顶状态、敏感状态和正则规则筛选历史内容。
• 对长文本直接分词，选中片段后复制、输入或编辑。
• 把选中的剪贴板内容发送到百度、有道或 Google 翻译流程。

20260819.08 更新重点

• 新增文本分词：首页长按剪贴板词条，或从编辑页进入分词页面，支持普通分词和正则精确分词。
• 新增正则分词规则：支持预制规则、自定义规则、临时正则和规则抽屉，正则模式会按命中区间切块，并完整保留原文。
• 新增 Google 翻译模式：可通过 Android Intent 把完整文本交给 Google 翻译，成功打开后自动隐藏 ClipHub 界面。
• 统一页面返回：系统 Back、侧滑返回、Toolbar Back、Predictive Back 和输入法优先返回进入同一套页面栈。
• 优化窗口生命周期：新增显隐意图守卫，处理外部 Intent、延迟回调和重复 hook，提升隐藏、返回和再次打开时的稳定性。
• 升级模块体系：Manifest Schema 升至 2，正式运行模块从 15 个扩展到 20 个，入口最低版本升至 8。

主要功能

• 后台监听：监听系统文本剪贴板，处理重复事件和自身回写形成的循环。
• 本地存储：数据写入 ClipHub 自己的 SQLite 数据库，支持历史清理和数量限制。
• 悬浮窗口：支持拖动、调整尺寸、置顶、收起、关闭和位置保存。
• 搜索筛选：支持关键词、来源应用、自定义标签、置顶状态、敏感状态和高级正则筛选。
• 记录操作：支持一键复制、新增、编辑、置顶、拖动排序、删除和撤销删除。
• 文本分词：支持普通分词、正则精确分词、词块点击选择、拖动连续选择、长按更多操作、复制、输入和编辑。
• 翻译：支持百度翻译、有道翻译和 Google 翻译；百度和有道使用内置结果页，Google 走系统 Intent。
• 主题与设置：支持跟随系统、亮色和暗色主题，并提供搜索历史、复制后关闭、敏感内容策略、忽略应用和翻译配置。

正则精确分词怎么用

ClipHub 的正则精确分词适合从一段长文本里快速挑出 URL、邮箱、命令、编号、金额、日期或自定义格式。进入分词页后，可以切换到正则规则模式，勾选已有规则，也可以临时输入一条正则表达式。

• 正则命中的内容会独立显示为词块。
• 未命中的文本会按原文位置连续保留。
• 空格、换行和制表符会用可见占位符显示，复制和输入时保留真实字符。
• 多个规则重叠时，按优先级、更长匹配和规则顺序裁决。
• 临时正则拥有最高优先级，适合临时处理一次性文本。

分词结果通过逐字符还原校验，成功结果可以完整拼回原文。遇到无效正则、零宽匹配或超限结果时，ClipHub 会给出提示，避免展示缺失或乱序的词块。

两个 ShortX 脚本各做什么

正式版日常使用主要由两个 ShortX JavaScript 脚本组成：

• ClipHub.js：后台入口。负责环境检查、读取远程 Manifest、校验 Git Blob SHA、同步 20 个模块、初始化数据库和剪贴板监听。
• tasks/ClipHub_全局剪贴板开关.js：前台开关。负责打开、隐藏或切换 ClipHub 悬浮界面，关闭界面后后台监听和数据库继续运行。

模块集合、运行角色、导出名、生命周期顺序和资源列表以根目录 module-manifest.json 为准。当前正式版 resources=[]，生产运行只依赖入口脚本、Manifest 和 20 个声明模块。

安装与使用

1. 打开文末 GitHub 项目页，获取 ClipHub.js。
2. 在 ShortX 中新建一个 ExecuteJS 任务，将 ClipHub.js 作为“ClipHub 剪贴板后台”运行。
3. 首次运行会从 main 分支同步 Manifest 和模块。返回结果里出现 entryVersion=8、moduleSetVersion=20260819.08 可确认入口与模块版本。
4. 再新建一个 ExecuteJS 任务，使用 tasks/ClipHub_全局剪贴板开关.js。
5. 执行开关任务即可打开剪贴板窗口，再次执行会隐藏 ClipHub 界面。
6. 把开关任务绑定到 ShortX 桌面快捷方式、悬浮球、快捷设置磁贴、按键或手势，日常调用会更顺手。

后台脚本适合绑定到设备启动完成后的 ShortX 规则。开关脚本负责日常打开和隐藏界面，两者职责独立。

日常操作

• 点击记录卡片：把原始文本重新写入系统剪贴板。
• 左滑记录：置顶或取消置顶。
• 右滑记录：删除，并通过提示条撤销最近一次删除。
• 卡片右侧按钮：编辑、翻译、复制或删除当前记录。
• 长按记录：进入分词页面，对当前完整文本进行切块处理。
• 顶部搜索：按正文、来源应用和标签查找历史内容。
• 筛选面板：组合来源、标签、置顶、敏感状态和高级正则规则，并切换排序方式。
• 底部“新增”：手动保存一条本地剪贴板记录，并为它选择标签。

翻译设置

ClipHub 当前支持百度翻译、有道翻译和 Google 翻译。百度和有道需要在设置页填写对应 App ID、App Key 或密钥；Google 模式需要设备已有可处理文本 Intent 的 Google 翻译。中文内容默认翻译为英文，其他语言内容默认翻译为中文。

Google 翻译启动成功后，ClipHub 会隐藏悬浮界面，让翻译页面获得完整显示空间。空文本、未安装或启动失败时，ClipHub 会保持当前界面并显示提示。

数据与隐私

• 剪贴板记录保存在 ClipHub 运行目录下的 data/cliphub.db。
• 主数据库 Schema 保持为 2，升级保留现有剪贴板、标签和分页数据。
• 高级筛选正则规则使用独立 regex_rules 功能表。
• 分词规则保存在独立规则状态中，与剪贴板主表分开管理。
• 敏感剪贴板默认采用跳过保存策略，也可在设置页调整。
• 百度、有道和 Google 翻译只处理用户主动发起翻译的文本。

当前 main 分支说明

当前 main 分支已经以 20260819.08 作为正式基线，重点合并分词系统、正则规则管理、Google 翻译、Navigation Contract v2、统一页面宿主和显隐生命周期守卫。仓库当前 HEAD 为 f71a6ca，功能合并提交为 97d334e。

项目保持 Rhino ES5 写法，运行模块使用 var、function 和 ES5 兼容结构。ColorOS/Rhino 颜色调用通过 Theme 安全桥处理，当前发布预检结果为 HIGH=0 WARN=0 SAFE=10。

自动化验证结果

• Rhino ES5 validation：通过。
• 展开后的压缩模块 Node 语法检查：通过。
• Manifest Schema、export、SHA 和 lifecycle contract：通过。
• Navigation regression suite：24 项通过。
• Tokenizer regression suite：13 项通过。
• Translation provider contract：通过。
• bash scripts/release_preflight.sh --main：通过。

更新日志

• 新增普通分词与正则精确分词，可从首页长按和编辑页进入。
• 新增分词规则管理，支持预制规则、自定义规则、临时正则和规则迁移。
• 新增 Google 翻译模式，完整文本可通过系统 Intent 交给 Google 翻译。
• 修复了因跨层返回链分散导致词块编辑页返回异常的问题。
• 修复了因旧分词页面残留导致回到首页后无法再次长按进入分词页的问题。
• 修复了因固定词块高度导致长 URL、长邮箱和连续长文本显示裁切的问题。
• 优化了显隐、外部 Intent、输入法返回和 Predictive Back 的生命周期边界。

项目与脚本下载

作者：林深见鹿
博客：xin-blog.com