核心用法
Gumroad Analytics 是一款专为 Gumroad 创作者设计的轻量级数据同步工具。用户需先在本地配置 ~/.config/gumroad/credentials.json 凭证文件并设置 600 权限，随后执行 fetch_metrics.sh 脚本即可自动获取前一日销售与产品数据。默认模式下仅输出聚合统计摘要（订单数、收入总额等），如需保留原始数据可添加 --store-raw 参数，系统会自动脱敏处理（移除 email、full_name 等字段）。输出文件按日期归档于 memory/metrics/gumroad/ 目录，便于构建个人数据看板或自动化报表流程。
显著优点
隐私优先架构：默认不存储任何原始 API 响应，从源头规避 PII 泄露风险；即使显式开启原始存储，也会通过内嵌 Python 脚本自动剥离敏感字段。这种"opt-in"设计理念在同类工具中较为罕见。
零依赖轻量实现：仅需系统内置工具（curl、python3、date），无第三方包管理负担，部署成本极低，适合在受限环境（如容器、CI/CD）中运行。
合规友好：通过 GDPR 数据最小化原则检查，网络流量全程 HTTPS 加密，凭证读取与 API 调用分离，符合安全最佳实践。
可追溯可审计：代码结构清晰，使用 Bash 严格模式（set -euo pipefail），所有外部调用均可审查，无动态代码加载或隐藏网络行为。
潜在缺点与局限性
功能边界明确：仅支持每日批量同步，无实时 webhook 机制；不提供趋势分析、可视化图表或竞品对比，需要用户自行二次处理数据。
平台锁定：仅兼容 Gumroad 官方 API，无法迁移至 Lemon Squeezy、Gumroad 替代品或其他电商平台。
凭证管理手动化：目前缺乏自动化的 Token 轮换提醒或 OAuth 流程，长期运维需用户自行维护凭证有效性。
错误处理待完善：当前版本未对 API 限流、网络超时或无效 JSON 响应做健壮性处理，极端场景可能静默失败或产生不完整数据。
适合的目标群体
- 独立创作者/数字商品卖家：需要定期追踪销售表现，但对复杂 BI 工具无需求
- 隐私敏感型用户：希望最小化个人数据足迹，拒绝 SaaS 仪表盘的数据收集
- 技术爱好者：倾向于本地优先、可脚本化的数据工作流，愿意自建分析管道
- 小型团队运营：需要低成本、可审计的营收数据源接入内部系统
常规使用风险
网络依赖风险：脚本执行需稳定访问 api.gumroad.com，网络波动或 API 变更可能导致同步中断；建议在生产环境添加超时参数与重试逻辑。
凭证泄露风险：虽建议 600 权限，但脚本未强制校验，多用户系统或误操作可能导致凭证暴露；建议配合密钥管理工具（如 pass、1Password CLI）使用。
数据完整性风险：默认摘要模式仅保留计数与金额，历史明细不可追溯；若未来需要客户分析或退款追溯，需提前规划原始数据存储策略。
维护可持续性：作为个人开发者项目（T3 来源），长期更新依赖作者精力，Gumroad API 重大变更时可能存在适配延迟。