用途:把混合敏感度的逆向研究仓库拆分为私有事实源与公开镜像,使方法论与可推广模式可以对外发布,而具体发现保持私有。适用于发布对闭源 CLI 工具的方法论发现、向非自有项目提交上游提案或缺陷报告、把私有研究仓库归档为公开参考、把调查笔记提升为公开指南,以及在任何发现积累之前先建立发布流水线。
主要能力与核心规则:先把每个候选事实分为四类——方法论(始终可发布)、通用模式(可发布)、版本相关发现(需经过版本滞后冷却期)、活跃内部信息(压缩后名称、字节偏移、暗标志名、当前版本门控逻辑、PRNG/盐常量、内部代号等,永不发布,除非厂商已文档化;此时仅其名称可重新归类为通用模式条目,且允许清单只授权名称,不授权取值、行为、共现关系或来源)。随后设置版本滞后冷却策略(典型为当前版本加一个先前版本保持私有),把策略写入 REDACTION_POLICY.md,并把“当前版本”绑定到安装二进制的基线扫描输出而非日历。
使用方式:1)维护单一可执行的拒绝清单扫描脚本 tools/check-redaction.sh,每个敏感标识形状一条“标签+正则”,并先于草稿更新扫描器(扫描器是“什么太敏感”的可执行规范);2)用 tools/public-allowlist.txt 定义同步到公开镜像的文件白名单,新文件默认私有,提升需先过脱敏检查;3)用孤儿提交发布:在公开镜像中 git checkout --orphan、清空索引、按白名单同步、提交并强制推送,使公开仓库每次发布只有一个提交,防止 git log 暴露发布前草稿;4)在 CI 中对公开发布分支运行扫描器,非零退出即阻断发布;扫描器本身从私有仓库拉取,避免拒绝清单进入公开仓库;5)对误报优先收窄正则而非添加忽略行,若必须抑制则附日期与理由;6)定期(通常每月)执行脱敏巡检,重新分类新增发现并重跑扫描器。
限制:资料未提供具体收费、价格、平台与效果信息;仓库本身不附带 REDACTION_POLICY.md,需各消费方自行提供。扫描器真实退出约定为 0 干净 / 1 有任何发现(计数只出现在输出中,不在退出码)/ 2 无法运行,2 绝不能被当作通过;若无法用私有仓库令牌,只能在公开仓库嵌入不标识厂商的宽泛形状模式,并在推送前从私有仓库运行完整扫描器。