text-replace

跨文件批量替换 — 多文件批量查找替换（字面量/正则），默认统计命中不写盘 --apply 才改，改前自动 .bak 备份（零依赖） 适用场景：当需要跨文件批量替换能力时使用本技能；触发词：text-replace。

凡自治之物 · LGD 治理学 · 创造术家族 ｜ 评测协议：skill-quality-gate

English

text-replace v1.0.1 · LGD-Powered productivity family · zero-dependency

The pain

Renaming / bumping versions / changing API hosts — opening dozens of files one by one until your eyes burn.

When to use

When the user needs bulk find-and-replace across files.

Usage

bash

python scripts/text_replace.py --help

• Success → rc=0; findings → rc=1; usage error → rc=2
• --json for machine-readable output
• Writing operations default to dry-run preview; add --apply to execute (a .bak backup is made per file first)

Workflow

1. Trigger: identify a bulk text-replace task (see When to use).
2. Execute: run text_replace.py per Usage.
3. Verify: check output / exit code against expectations.
4. Deliver: present results / artifacts.

Safety design

• Moves / renames only; never deletes content files.
• Auto-backup before writing (text-replace writes a .bak; rollback is available).

LGD-Powered

This is an LGD Three-Laws productivity-family piece: high-frequency file operations made previewable, rollback-able, traceable deterministic tools.

Disclaimer

Efficiency aid; back up important data and preview before --apply.

中文

text-replace v1.0.1 · LGD-Powered 效率工具家族 · 零依赖

痛点

改名/改版本号/改接口地址，几十个文件一个个开编辑器改到眼瞎

何时用

• 当用户需要跨文件批量替换相关能力时。

用法

bash

python scripts/text_replace.py --help

• 成功 → rc=0；发现问题 → rc=1；用法错误 → rc=2
• 支持 --json 机器可读输出
• 涉及写盘的操作默认 dry-run 预览，加 --apply 才执行（写盘前自动 .bak 备份）

流程

1. 触发：识别跨文件批量替换相关任务（见「何时用」）。
2. 执行：按「用法」运行text_replace.py。
3. 校验：核对脚本输出/退出码是否符合预期。
4. 交付：向用户呈现结果/产物。

安全设计

• 只替换内容，不删除文件。
• 写盘前自动备份（生成 .bak，可回滚）。

证据与安全声明

• 证据：TBD（暂无评测/徽章链接；产生后在此更新实际链接）
• 版本：1.0.1
• 安全：未做独立安全扫描（TBD），结论待补；补全前不作推荐背书。

免责

本工具为效率辅助；对重要数据请先备份并在预览确认后再 --apply。