桌面应用跨平台前端【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址https://gitcode.com/gh_mirrors/re/readest点击查看免费下载在公开仓库如 readest/readest中维护项目时没有泄露密钥并不等于没有泄露敏感信息。本指南基于 Readest 项目沉淀的工程记忆 feedback-no-prod-metrics-in-public.md系统讲解为什么生产运营指标库表规模、实例规格、查询速率、用户量属于敏感信息如何在公开 Issue/PR 中做到只给技术论证、不给生产数字以及如何防止 PII个人身份信息通过 Agent 记忆文件进入 git 历史。读完你将掌握一套可复制的公开仓库信息隔离检查清单与提交前扫描流程。背景公开仓库里没有密钥不等于没有泄露readest/readest 是公开仓库。对于其背后的生产 Supabase/Cloudflare 部署运营层面的数字同样是敏感的即使其中不包含任何密钥secret或 PII数据库/表的大小、增长速度实例的内存/磁盘规格按用户分布的行数查询调用速率与耗时占比。这份工程记忆feedback类型2026-08-23 记录明确给出了原因仓库公开后任何进入 Issue、PR 描述或提交信息的内容都会长期驻留在 git 历史中而项目使用的gstack 脱敏扫描只覆盖 secrets/PII例如密钥、令牌、身份证号、邮箱不会拦截表大小、增长率、实例规格这类运营数字。从仓库自身的忽略规则也能印证这一点apps/readest-app/.gitignore 排除了.env*.local、*.pem、/private_keys等凭据类文件但这类规则天然只防凭据防不了运营统计数字后者需要靠作者的信息边界意识来把关。核心规则技术论证与生产数字分离这条规则可以浓缩为一句话公开的 Issue 和 PR 描述中只写技术论证rationale不写生产数字numbers。以文档中的对照为例应该写技术论证不应该写生产数字该查找会为每个数组元素重新遍历 PK 范围2.27M 次调用 / 占数据库时间 17% / 数据库 39 GB原则是把为什么这么做讲清楚把生产环境里有多大、多快、多贵留在本地。案例复盘一次因泄露生产指标而删除的 Issue该规则并非理论而是来自一次真实事故。2026-08-23用户删除了 issue #5834stat_pages R2 分层存储规格说明stat_pages R2 tiering spec原因是该 issue 在公开仓库中暴露了过多生产信息包括表大小与增长率实例内存/磁盘规格按用户的行分布查询调用速率。处理方式是该规格说明改为仅存本地磁盘。同一批处理的还有 PR #5832 和 #5833——这两个 PR 的描述在当天通过gh pr edit被清除掉所有生产数字。而被合并进 main 分支的提交信息中仍残留少量短语如 about 9 req/s in production、~70k page events出于不做历史改写no history rewrite的原则这些残留被保留下来——这恰恰说明提交信息与 PR 描述一样难以事后补救最好的防线是写之前就不放。PII 是更难的一半Agent 记忆文件是泄漏路径生产指标之外PII 的处理更严格而最隐蔽的泄漏路径是Agent 记忆文件memory files。工作流中chore: update agent memories这类提交会把 apps/readest-app/.claude/memory/ 目录整体发布到公开仓库注意.gitignore只忽略了.claude/settings.local.json、.claude/skills、.claude/plansmemory 目录是被跟踪的。如果一条记忆是在处理支持工单support case时写下的那么购买者的信息会顺着该提交直接进入 git 历史。真实案例2026-09-03storage-purchase-account-transfer.md 在 PR #6037 提交前被迫紧急脱敏redact。当时文件中包含两个购买者的邮箱两个 Supabase 用户 UUID支付 UUIDapple_original_transaction_id苹果原始交易号。而实际上这些标识符一个都不需要——同样的操作步骤完全可以用Apple 登录的免费账户the Apple-sign-in free account这样的描述性称谓再加一个指向工具脚本的指针来复现即 inspect-accounts.mjs。这条案例沉淀出的教训是标识符会过时机制才长期有效。memory 文件应首写即脱敏redacted in the first place而不是提交前才亡羊补牢。提交前扫描清单可操作的检查步骤工程记忆给出了明确的扫描要求每次 memory 提交前扫描新增行 新增文件而不仅是工作区状态重点识别以下五类模式类别识别特征/示例邮箱nameexample.com形式UUID[0-9a-f]{8}-...形式可忽略originSessionId运行 ID9 位以上数字串run idsStripe 密钥sk_live前缀Supabase/服务密钥sbp_前缀项目源码中也能看到这些前缀的语义佐证在 stripe-server.live.test.ts 的测试注释中密钥以STRIPE_SECRET_KEYsk_live_xxx的占位符形式出现——真实环境中应以sk_live开头的实际值存在于本地环境变量而任何进入公开仓库的该前缀串都应被当作事故处理。敏感资料的本地存放规范被判断为包含生产规格的资料应放在本地私有位置绝不能放进公开仓库跟踪的目录树✅ 允许~/.gstack/projects/readest-readest/specs/gstack 归档目录或用户的本地记忆目录❌ 禁止apps/readest-app/.claude/包括.claude/memory/该树在公开仓库中被跟踪。这条规范与工程记忆索引 MEMORY.md 中specs stay local (~/.gstack/projects/readest-readest/specs/), NOT in the tracked .claude/ tree的说明一致生产规格只进本地归档公开仓库只保留技术结论。源码佐证脱敏不是口号是代码里的习惯Readest 仓库的工程实践在代码层面同样体现了最小暴露原则可以在写类似支持类工具时直接借鉴交易号只留尾部在 inspect-accounts.mjs 的支付记录输出中apple_original_transaction_id只打印后 6 位apple_tx …123456Google 的google_purchase_token只打印google_token占位完整值绝不进终端输出。只读优先该脚本头部注释明确 Never writes anything它只做查询GoTrue 用户解析、各用户键表行数统计、plans/payments 导出、R2 对象清单并在双邮箱场景下报告book_hash/文件键重叠——专门用于支持工单场景同时把输出的敏感度降到最低。本地环境变量驱动脚本通过node --env-file.env --env-file.env.local scripts/db/inspect-accounts.mjs email运行密钥来自本地.env*.local已被 .gitignore 排除而不是写死在代码中。这也解释了 memory 文件中以 Apple 登录的免费账户 指向 inspect-accounts.mjs 的指针来描述复现步骤的做法工具能完成的事就不需要在记忆里留下任何标识符。总结四条可立即执行的边界纪律把这份工程记忆压缩成日常工作可直接照做的四条纪律公开内容只写技术论证Issue/PR 描述、提交信息里不出现表大小、实例规格、查询速率、用户数、增长率、基础设施内部名称。敏感规格只存本地完整规格与调查记录进~/.gstack/projects/readest-readest/specs/或本地记忆目录不进apps/readest-app/.claude/。记忆首写即脱敏支持工单类记忆用描述性称谓替代邮箱/UUID/交易号必要标识符一律省略用工具指针代替数据本身。每次 memory 提交前全量扫描覆盖新增行 新增文件重点检查邮箱、UUID忽略originSessionId、9 位以上数字串、sk_live、sbp_前缀。公开仓库的维护是一场持久的信息边界管理密钥扫描只是底线对生产运营数字与用户标识符的纪律性隔离才是避免信息随 git 历史永久扩散的关键。Readest 用一次 issue 删除和两次 PR 描述清洗换来的这套规则值得每个多端同步、依赖云端服务的开源项目参考。赞分享桌面应用跨平台前端【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址https://gitcode.com/gh_mirrors/re/readest点击查看免费下载相关推荐Docs 如何用 profile_volumetry 与 generate_volumetry 在隔离数据库复现生产数据量Docs 如何用 profile_volumetry 与 generate_volumetry 在隔离数据库复现生产数据量 Docs开源文档编辑器Djang协同办公知识库后端前端即时通讯Recordly扩展API完全指南开发光标特效、渲染钩子与设备框架扩展Recordly扩展API完全指南开发光标特效、渲染钩子与设备框架扩展 Recordly 是一款开源的屏幕录制与演示视频编辑工具它的 扩展 API 允许开发桌面应用音视频屏幕录制视频处理GitHub CLI 如何用 gh develop 为 Issue 或 PR 创建独立 worktree 隔离开发GitHub CLI 如何用 gh develop 为 Issue 或 PR 创建独立 worktree 隔离开发 当你需要在同一个仓库里并行处理多个 IssCLI开发工具上一篇Jazzer进阶自定义sanitizers开发指南与最佳实践下一篇Blender角色绑定架构选型指南从技术挑战到生产级解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考