repo-rename-desensitizelisted
Install: claude install-skill xingtu1996/xingtu-skills
# 全库更名 + 真名脱敏 SOP
> 动因来源:行途 `text2vido → book2vido` 更名(2026-09-16)。
> 那次踩到的四个真坑全部沉淀在下面 §【硬教训】里。
## 何时用
- 项目/包/应用改名(`oldname → newname`),且改名要覆盖代码 + 文档 + 打包产物 + 目录
- 开源/公开前要清洗「本机绝对路径 / 用户名 / 真名 / 公司标识」
- 仓库要从 private 转 public 前的准备
## 铁律(先做这三件,再动手)
1. **先纠事实,再执行。** 用户对"改名历史"的记忆常是错的。
在动任何一行之前,先取证:`git log --all -S"<旧名>"`、首提交 README 首行、仓创建时间 vs 首提交时间、
`gh search repos <新名>`(查撞名)。
**若结论是"从未改名",就要在交付里明确纠正,别顺着用户的假设做。**
2. **先备份,走工作区自带脚本。**
`bash tools/safety/backup-before-op.sh "<描述>" <path...>`(行途工作区)。
另加一个 tarball 兜底并 `tar -tzf` 验证可读。
3. **删除一律走 `safe-delete.sh`(mv 到回收站),绝不 `rm -rf`。**
---
## 执行顺序(顺序错了会返工)
### 第 0 步 · 影响面盘点
```bash
find . -iname "*<旧名>*" -not -path "./.git/*" # 名字含旧名的路径
git grep -l -i "<旧名>" # 被跟踪文件
grep -ril "<旧名>" --exclude-dir=.git --exclude-dir=dist . # 含未跟踪
```
把结果分成四类:**路径** / **内容** / **产物** / **外部引用(含定时任务、其他项目、memory)**。
### 第 1 步 · 确认"缓存/指纹"是否与名字耦合 ★硬教训①
**改名最常见的隐性代价是缓存全失效或静默错位。**
先读缓存键生成逻辑:
```bash
grep -rn "cache_key\|fingerprint\|sha256\|hexdigest" src/
```
- 若键是**内容指纹** → 改名不影响缓存,无需清理(本次结果:样本 sha256 前缀 `09bd9369…` 恰是缓存目录名 → 反证)。
- 若键**含包名/路径** → 必须清缓存或迁移,否则表现为"变慢了"或读错缓存。
> 判定法:拿一个已知样本算它的指纹,看是否等于现有缓存目录名。
### 第 2 步 · 路径改名(保 git 历史)
```bash
git mv src/<旧> src/<新>
git mv src/<旧>.egg-info src/<新>.egg-info # 建议顺手移出跟踪:它是 pip 再生元数据
git mv specs/<日期>-<旧>-<主题> specs/<日期>-<新>-<主题>
```
**用 `git mv`,不要 `mv`** —— 否则 git 记成"删除+新增",历史断掉。
### 第 3 步 · 内容批量替换(**三个大小写变体都要覆盖**)★硬教训②
```python
REPL = [('o