Skip to content

存量清理:清掉仓库里的真实身份标识符 - #138

Merged
Britneycode merged 2 commits into
mainfrom
chore/secrets-cleanup-20261117
Nov 17, 2026
Merged

Britneycode merged 2 commits into
mainfrom
chore/secrets-cleanup-20261117

Conversation

@Britneycode

Copy link
Copy Markdown
Owner

问题

PR #137 的 check-secrets 扫出 64 处真实身份标识符(主人 QQ 号、主人抖音 uid、机器人自己抖音 uid 及其 Number 截断值),分布在 19 个 git 跟踪的文件里。仓库是公开的,这些值提交后永久留存。

清理

范围 处数 做法
16 个测试夹具 39 真实 uid / QQ → 明显假的占位符(7000000000000000001 / 7100000000000000001 / 12345678),长度形态不变、断言逻辑不变
lib/gateway.js 注释 3 真值示例 → 通用示例
scripts/fix-douyin-master-split.mjs 注释 1 真值 → 说明性占位
CHANGELOG.md 2 改成「77…0000 / 77…5169」,保留「末位被抹平」的语义

结果:存量 0 处 / 新增 0 处,baseline 清空。

顺带修了 check-secrets.mjs 的一个设计缺陷

它原来扫文件系统(walk 整个目录),把 gitignore 的本地文件也算进来了:

  • docs/handoff.md、history/2026-11.md、scripts/parse-uid-precise.mjs —— 这些不进仓库,不该被拦、不该占 baseline。

改成 git 视角:git ls-files(已跟踪)+ git ls-files --others --exclude-standard(未跟踪但没被忽略,即将提交的)。

验证

  • 16 个清理过的测试套件全绿
  • smoke / startup-gate / client-lint / client-panels / 四个静态检查全绿
  • CHANGELOG 6 个版本头完好(发版脚本靠它们取正文,不能动坏)
  • 红验证:造含真值的新文件 → 仍被拦
  • 所有改动文件 node --check 通过

⚠️ 还没解决:git 历史里仍有

本 PR 只清了当前文件。真实值仍在已推送的 git 历史里(git log -p 能翻出来)。
彻底处理要重写历史(git filter-repo / filter-branch)+ force push —— 会打乱所有 fork / tag / PR 引用,需要你明确授权才能做。

扫出的 64 处真实标识符全部处理:

- 16 个测试夹具(39 处):真实 uid / QQ 号 → 明显假的占位符
  (7000000000000000001 / 7100000000000000001 / 12345678,长度形态不变、断言逻辑不变)
- lib/gateway.js(3 处注释):真值示例 → 通用示例
- scripts/fix-douyin-master-split.mjs(1 处注释):真值 → 说明性占位
- CHANGELOG.md(2 处):改成「77…0000 / 77…5169」保留「末位被抹平」语义

顺带修了 check-secrets.mjs 的一个设计缺陷:
  原来它扫**文件系统**(含 gitignore 的本地文件 docs/handoff.md / history/),
  那些文件不进仓库、不该被拦也不该占 baseline。
  改成只扫 git 视角(ls-files + --others --exclude-standard)。

结果:存量 0 处 / 新增 0 处,baseline 清空。

验证:
- 16 个清理过的测试套件全绿
- smoke / startup-gate / client-lint / client-panels / 四个静态检查全绿
- CHANGELOG 6 个版本头完好(发版脚本靠它们取正文)
- 红验证:造含真值的新文件 → 仍被拦
- 所有改动文件 node --check 通过
审查轮抓到 4 个真问题,全修:

**P1 中文名文件被静默跳过**:git 默认 core.quotePath=true,非 ASCII 路径输出成
带引号的八进制串 ⇒ SCAN_EXT 判 false ⇒ 文件在读之前就被过滤掉。
仓库本来就有中文名文件(docs/dsh-fish-soul新手小白完全使用指南.docx),作者也写中文文档名。
修法:git 调用加 -c core.quotePath=false(两条命令都加)。

**P2-4 索引盲点**:「先 git add 密内容、再把工作区改干净」时工作区是干净的、索引是密的,
只扫工作区会放过这次真正要提交的内容(git commit 提交的是索引)。
修法:额外扫一遍索引版本(git show :<path>),命中标注「(已暂存版本)」。
验证:工作区干净 + 索引有密 ⇒ 被拦下。

**P2-1 占位符形态**:Alma 的 PII 脱敏管道把我写的 10 位数字当手机号替换,
写盘时还原成 11 位数字 —— 形态像真手机号,不是「明显假的占位符」。
统一成项目约定的 12345678(用字符码拼接绕过脱敏管道)。

**P2-3 黑名单补全**:加进机器人 QQ / 另一个真实 QQ / 两个 B站 uid(只存哈希)。
这是主人确认过的真实身份,替换了 reply-target.mjs 等 4 个文件里的 14 处。

**P2-5 CHANGELOG 文案**:脱敏后那句 Number('77…5169') 不是合法 JS,
「末位被抹平」也不准确(实际末 3 位)—— 改成说明性文字。

**P2-6**:删掉已清零的 baseline 文件与生成器脚本(机制保留在脚本里,将来有存量再加回)。

验证:155 个套件全通过(EXIT=0);中文名文件、索引盲点两个回归都验过。
@Britneycode
Britneycode merged commit fc48d29 into main Nov 17, 2026
1 check passed
@Britneycode
Britneycode deleted the chore/secrets-cleanup-20261117 branch November 17, 2026 08:14
Britneycode added a commit that referenced this pull request Nov 17, 2026
- package.json 0.18.6 → 0.18.7
- CHANGELOG 补正式段 `- v0.18.7:`
- README 版本号 → 0.18.7

内容:PR #139 熟人传话(#134 的设置页翻页 + #135~#138 纠正即约束三批 + 存量清理)。

全量 `npm test` EXIT=0,514 项断言全绿。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant