文本批量查找替换 · 正则清洗与编码转换【律令·本地零联网】

文本处理与批量替换：批量查找替换（含正则）、行级清洗、大小写、GBK 批量转 UTF-8、多文件合并、字数统计，默认预览不写盘。

这个技能做什么

本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

文本文件批量查找替换与清洗

子命令（全部实测通过）

replace — 批量查找替换（默认预览）

text_batch.py replace ./文案 --find hello --to 你好 --glob "*.txt"

真实输出：

匹配文件 2 个 / 共 6 处替换（hello -> 你好）
  a.txt                                    3 处  [utf-8-sig]
  c.txt                                    3 处  [utf-8-sig]
[预览模式] 未写盘。确认后加 --execute，输出目录默认 <源目录>_out，源文件绝不动。

加 --execute 才写盘，写到 <源目录>_out，源文件一个字节都不动。支持 --regex 正则与反向引用：

text_batch.py replace ./文案 --find '第(.)行' --to '【\1】' --regex --glob "a.txt"

匹配文件 1 个 / 共 2 处替换（第(.)行 -> 【\1】，正则）

正则写错会直接报 错误: 正则写错了 -> ...，绝不硬着头皮跑。

lines — 行级清洗

text_batch.py lines 名单.txt --strip-blank --dedup blank --number

真实输出：

行处理: 5 行 -> 4 行（减少 1 行）
[预览] 未写盘，加 --out 指定输出文件。前 4 行预览:
  1. 第一行 hello
  2. hello WORLD
  3. 第三行
  4. hello world

可选：--trim 去首尾空格、--sort [--desc] 排序、--reverse、--prefix/--suffix 加前后缀、--ignore-case 忽略大小写去重、--out 写到新文件。

case — 大小写转换

text_batch.py case 名单.txt --mode upper

真实输出：

大小写转换: upper（原编码 utf-8-sig，39 字符）
[预览] 未写盘，加 --out 指定输出文件。前 3 行:
  第一行 HELLO
  HELLO WORLD

encoding — GBK / BIG5 批量转 UTF-8（治乱码）

text_batch.py encoding ./台账 --to utf-8-sig --glob "*.txt" --execute

真实输出：

待转换 1 个 / 共 3 个文件
  a.txt                          utf-8-sig    已是目标编码，跳过
  b.txt                          gbk          转 -> utf-8-sig
  c.txt                          utf-8-sig    已是目标编码，跳过
已写出 1 个文件到: C:/.../Temp/tb_out

源编码自动探测顺序：utf-8-sig → utf-8 → gbk → big5，四个都失败会如实报 识别失败 并跳过，绝不猜着解码。

merge — 多文件合并

text_batch.py merge a.txt c.txt --header ====== --out 合集.txt

真实输出：

合并 2 个文件 -> 104 字符
已写出: 合集.txt

count — 字数统计

text_batch.py count ./文案 --glob "*.txt"

真实输出：

文件                                       行数       字符       中文       英词
a.txt                                     5       39        6        5
b.txt                                     2       18        9        1
c.txt                                     5       39        6        5
合计                                       12       96       21       11

中文字数按 CJK 区间统计，英词按 [A-Za-z0-9_'-]+ 统计，规则写在明处，不玩"智能估算"。

工作流建议

1. 先 count 摸底（文件数、编码、规模）
2. 有乱码先 encoding 转成 utf-8-sig，再谈别的
3. replace 一律先跑预览，把"几个文件几处"给用户确认后再 --execute
4. 输出目录 _out 检查无误，再考虑替换原目录（这一步由人工做，本包不动源文件）

自检清单

• 预览模式下确实没写盘
• 输出在 _out，源文件没被改
• 编码识别失败的文件如实跳过，没有编造内容

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。 未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。 各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。

与相邻技能的关系

边界说明：本包只吃纯文本（txt/md/csv/log 等）。.docx/.xlsx 是压缩包不是纯文本，本包不假装能读，需要用户先另存为 txt/csv。

标签

批量替换文本处理批量查找替换编码转换多文件合并

安装方式

1. 打开 SkillHub 上的技能页，点击安装；
2. 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
3. 在你的 Agent 里直接说出使用场景即可触发，例如「批量替换文本、多个文件查找替换、批量去空行去重行」。

同类技能

常见问题

按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。