Skip to content

Latest commit

 

History

History
296 lines (252 loc) · 9.88 KB

README_zh-CN.md

File metadata and controls

296 lines (252 loc) · 9.88 KB

The ClipboardFilter

一键安装 English

描述

监听剪贴板，在剪贴板写入时过滤指定字符，并且支持 变量 和 正则表达式 替换匹配的文本。

更新日志

2023 年 12 月

  • 发布 版本 $\text{v}1.0.0$；

2024 年 9 月

  • 修复 一些 Bug 和逻辑漏洞；
  • 添加 状态栏和日志框；
  • 移除 C 风格的转义字符（可以用 变量 替代）；
  • 添加 对 变量 的支持；
  • 发布 版本 $\text{v}1.1.0$；

什么是变量？

2024 年 10 月

  • 修复 在某些控件中未解析变量的问题；
  • 添加 before 和 after 按钮；
  • 取消 日志栏中每条日志日期的显示；
  • 添加 变量解析的结果将在日志栏中显示；
  • 添加 图标的背景颜色；
  • 发布 版本 $\text{v}1.1.1$；

2024 年 10 月底

  • 修复 一些 Bug 和逻辑漏洞；
  • 添加 小型浮动窗口；
  • 添加 shrink to floating window 按钮在标题栏中；
  • 完善 日志输出；
  • 添加 多个变量，用于进制转换、文本变换、随机选择等，和 parse、buffer；
  • 添加 MatchOptions 可选择是否区分大小写；
  • 发布 版本 $\text{v}1.1.2$；

下载

git clone https://github.com/huanhuanonly/ClipboardFilter.git

下载封装后的文件

点击 一键安装 下载可执行文件 ClipboardFilter.exe，可以直接 双击 运行。

它使用 Enigma Virtual Box 进行打包，防火墙可能报毒属于正常现象，如果介意请选择第二种方法。

下载未封装的文件

需要下载 ./bin/v1.1.2/ 目录下的所有文件。

另外的，无论使用哪种方法您的配置文件都将存储在 %temp%/ClipboardFilter.ini。

如果您是 Windows 以外的系统，则需要手动编译。

在目前，编写、测试和维护工作都在 Windows $11$ 平台上进行。

页面展示

Home.png

使用教程

  • 过滤字符

只需在 Character set to use for filtering 的输入框中添加需要过滤的字符，输入顺序并不重要。

  • 替换匹配的模式字符串

在 Replacer's Rule Item 组中使用 insert 按钮插入并设置对应的规则，按顺序匹配和替换。

关于变量

变量在每次使用前被解析，将会被解析为一段指定的字符串，同时也用于特殊字符的替代品。

语法

${ variable-name [: parameter] }

变量名 variable-names 不区分大小写。

内置变量

获取外部文本
  • env: 获取环境变量；
    • param: 要获取的环境变量名称。
    • 例如：${env:WINDIR} 可能结果 C:\WINDOWS。
  • file: 获取文件中的文本内容；
    • param: 包含文件名的文件路径。
    • 例如：${file:C:\file.txt}，注意，只有第一个 : 作分隔符。
  • clipboard: 获取剪贴板中的文本数据（替换前）；
获取当前时间
  • hour
  • minute
  • second
  • msec
  • year
  • month
  • day
  • week
  • date
    • param: （可选）格式。
  • time
    • param: （可选）格式。
  • datetime
    • param: （可选）格式。
编码转文本
  • escape: 获取对应于 C 风格转义字符的字符；
    • param: C 风格转义字符，例如，\n 是换行符。
  • linebreak: 换行符的替代品；
    • param: （可选）CRLF（在 Windows 上默认）或 LF（在其他系统上默认）。
  • unicode: 获取对应 Unicode 编码的字符；
    • param: 一个非负整数，Unicode 编码。
文本转编码
  • tounicode: 输入一串文本，转换为 Unicode 码，中间使用空格分割。
    • param: 输入文本。
    • 例如：${tounicode:abc} 返回 97 98 99。
  • tohtml: 输入一串文本，转换为 HTML 转义。
    • param: 输入文本。
    • 例如：${tohtml:<abc>} 返回 &lt;abc&gt;。
  • hex: 输入一个非负整数，转换为十六进制。
    • param: 非负整数。
    • 例如：${hex:5201314} 返回 4f5da2。
  • oct: 同上，转换为八进制。
  • bin: 同上，转换为二进制。
  • dec: 同上，转换为十进制。
动态变量
  • random: 获取指定范围内的随机数（整数）；
    • param: （可选）有以下两种格式：
      • lowerBound, upperBound: 返回范围 $\left[lowerBound, upperBound\right]$ 内的随机数。
      • upperBound: 返回范围 $\left[0, upperBound\right]$ 内的随机数。
    • 例如：
      • ${random} 返回一个 $64$ 位随机数；
      • ${random:-10,99} 返回一个范围在 $-10$ 到 $99$ 之间的随机数（包含两端）；
      • ${random:99} 返回一个范围在 $0$ 到 $99$ 之间的随机数（包含两端）；
  • rsoc: RandomlySelectOneChar 的简写，随机选择一个字符。
    • param: 字符集。
    • 例如：${rsoc:abc} 可能返回 a、b、c 中任意一字符。
  • rsow: RandomlySelectOneWord 的简写，随机选择一个单词。
    • param: 单词集，可以用任意英文符号和空白字符分隔。
    • 例如：${rsow:like,love} 可能返回 like、love 中任意一单词。
  • rsol: RandomlySelectOneLine 的简写，随机选择一行。
    • param: 行集，换行符分隔。
  • index: 返回上一次调用的结果 加一。此外，第一次调用返回整数 $1$。
    • param: （可选）一个字符串，可以使用多个索引器。
    • 例如：
      • ${index}, ${index} and ${index} 返回 1, 2 and 3；
      • ${index:a}, ${index:a} and ${index:b} 返回 1, 2 and 1；
      • ${index:a}, ${index:b}, ${index:a}, ${index:b} 返回 1, 1, 2, 2；
  • iota: 返回一个连续的子序列；
    • param: 一个字符串，如果两端是数字，则返回一系列数字，否则返回一系列字符；
    • 例如：
      • ${iota:15} 返回 15，数字序列必须用_非数字_字符分隔，否则将被视为单个数字；
      • ${iota:1-5} 返回 1-2-3-4-5；
      • ${iota:5-1} 返回 5-4-3-2-1；
      • ${iota:10+=13} 返回 10+=11+=12+=13；
      • ${iota:ae} 返回 abcde；
      • ${iota:a,e} 返回 a,b,c,d,e；
      • ${iota:e,a} 返回 e,d,c,b,a；
      • ${iota:aUc} 返回 aUbUc，除了首尾字符外，其余字符均视为分隔符；
文本变换
  • shuffle: 打乱文本顺序。
    • param: 文本。
    • 例如：${shuffle:ILoveYou} 可能返回 oYeLIuov。
  • sort: 文本排序。
    • param: 文本。
    • 例如：${sort:ILoveYou1314} 返回 1134ILYeoouv。
  • reverse: 反转文本。
    • param: 文本。
    • 例如：${reverse:ILoveYou1314} 返回 4131uoYevoLI。
  • hash: 将文本映射为一个十六进制的哈希值，基于 md5 算法。
    • param: 文本。
    • 例如：${hash:ILoveYou1314} 返回 c52393bda98d849cc966a830f17f4cab。
  • tolower: 文本转小写。
    • param: 文本。
    • 例如：${tolower:ILoveYou1314} 返回 iloveyou1314。
  • toupper: 文本转大写。
    • param: 文本。
    • 例如：${toupper:ILoveYou1314} 返回 ILOVEYOU1314。
  • trimmed: 文本去掉两端空白字符。
    • param: 文本。
    • 例如：${trimmed: ILoveYou1314 } 返回 ILoveYou1314。
  • simplified: 文本去掉两端空白字符，并且每个内部空格序列都替换为一个空格。
    • param: 文本。
    • 例如：${simplified: I Love You 1314 } 返回 I Love You 1314。
特殊变量
  • parse: 解析文本中的变量，支持嵌套。
    • param: 文本。
    • 例如： ${parse:${buffer}}。
  • buffer: 获取缓冲区的文本。

在进行每一项规则替换后，会将结果暂存到缓冲区，进行完所有规则替换后再将最后的结果一次性写入剪贴板中。

项目结构

.
│  .gitignore
│  ClipboardFilter.exe
│  ClipboardFilter.pro
│  ClipboardFilter.pro.user
│  LICENSE
│  README.md
│  README_zh-CN.md
│
├─bin
│  ├─v1.0.0
│  │      ClipboardFilter_1.0.0.exe
│  │
│  ├─v1.1.0
│  │  │   ClipboardFilter_1.1.0.exe
│  │  │
│  │  └─...
│  │
│  ├─v1.1.1
│  │  │   ClipboardFilter_1.1.1.exe
│  │  │
│  │  └─...
│  │
│  └─v1.1.2
│      │  ClipboardFilter_1.1.2.exe
│      │  
│      └─...
│
├─build
│
├─data
│  │  res.qrc
│  │
│  ├─Font
│  │      CascadiaCode.ttf
│  │
│  ├─Icon
│  │      exit.svg
│  │      MainIcon.ico
│  │      MainIcon.png
│  │      MainIcon.svg
│  │      shrink.svg
│  │      topmost.svg
│  │      topmost2.svg
│  │
│  ├─Screenshot
│  │      home.png
│  │      home_1.1.1.png
│  │
│  ├─Source
│  │      MainIcon.ai
│  │      Shrink.ai
│  │
│  ├─Ts
│  │      ClipboardFilter_zh_CN.ts
│  │
│  └─Ui
│         maindialog.ui
│
├─include
│      ClickableLabel.h
│      Exception.h
│      Logger.h
│      MainDialog.h
│      MainFloatingWindow.h
│      StatusBarLabel.h
│      TextEditWithVariables.h
│      TextReplacer.h
│      TextReplaceRuleListView.h
│      Titlebar.h
│      Trie.h
│      VariableParser.h
│      VariablesShader.h
│
└─src
       Logger.cpp
       main.cpp
       MainDialog.cpp
       MainFloatingWindow.cpp
       TextReplaceRuleListView.cpp
       VariableParser.cpp

版权归 huanhuanonly 所有。