← ClaudeAtlas

repo-rename-desensitizelisted

项目/仓库「全库更名」+「真名脱敏」的一体式 SOP,附带公开前的历史暴露面核查与分发产物重打包。当用户说「项目名是不是该改」「全库改名」「改名成 X」「把这个清一下别泄漏真名」「开源前脱敏」「仓库别带上我的名字」「包名/应用名换掉」时触发。覆盖:改名影响面盘点 → 缓存耦合确认 → 路径 git mv → 内容批量替换(三大小写变体)→ 分类脱敏 → 历史暴露面核查 → 产物重打包 → 台账回写。
xingtu1996/xingtu-skills · ★ 2 · AI & Automation · score 71
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