个人游戏脚本，采用卡密授权制进行内购分发，随着用户增多，手工用 Excel 记录卡密、再手动上传到云端供客户端校验的方式效率低下且容易出错：哪些卡已售出、是否已被使用、是否到期、换绑了几次，全部靠人工核对，经常出现重复发卡、过期卡仍能使用、台账与云端数据不一致等问题。本项目旨在解决个人开发者在虚拟商品授权场景下的卡密全生命周期管理问题，覆盖卡密批量生成、分级定价（基础款 / VIP/SVIP）、有效期与首次激活计时、设备首绑锁定与换绑次数控制、售出状态跟踪、台账导出以及云端卡库同步等业务环节，让不具备技术背景的使用者也能通过浏览器页面完成全部发卡、管卡、销卡操作，实现 "双击即用、数据不丢、一键上云"。
系统以本地 Web 页面形式提供管理界面，双击 exe 即自动启动服务并打开浏览器，主要功能模块包括：
1. 卡密生成：按 key（基础款）、vip、svip 三种等级批量生成不重复卡密，支持永久卡与限时卡两种时长，限时卡可设置首次激活后才开始计时（ttl_first），避免库存卡提前过期；
2. 授权管控：每张卡记录有效期（exp）、换绑次数（rebind），支持首绑锁定、限制换绑、手动封禁（rebind=-1）等状态，客户端校验时据此放行或拒绝；
3. 卡库管理：在页面上查看、搜索、筛选全部卡密，跟踪每张卡是否已使用、是否到期、换绑情况，支持删除与作废；
4. 台账导出：卡密数据自动同步写入 cards.json（程序读写）与 cards.csv（Excel/WPS 直接打开，中文不乱码），便于线下对账和交付；
5. 云端同步：内置腾讯云 COS 推送能力，页面点击即可将最新卡库上传到 COS，供脚本客户端远程拉取校验；
6. 免环境部署：整体打包为单文件 exe，无需安装 Python 和任何依赖，拷贝整个目录即可换机器使用。
我独立负责整个项目的需求设计、编码实现、打包与交付。后端使用 Python 内置 HTTP 服务在本地（127.0.0.1:8765）提供 Web 管理界面与 REST 风格接口，卡密数据以 JSON 持久化并同步生成带 BOM 的 CSV 台账，保证 Excel 打开中文不乱码；云端对接使用腾讯云 cos-python-sdk-v5，实现卡库一键推送。客户端校验侧配合 Java 环境完成卡密拉取与授权校验。实现上的亮点与难点：一是用 PyInstaller 将 Python 解释器、Web 服务及 COS SDK（含 crcmod 等依赖）全部打包进单文件 exe，实现免安装双击运行；二是做了健壮的运行环境处理，8765 端口被占用时自动尝试 8765~8770，程序目录不可写时自动回退到 % LOCALAPPDATA% 存储数据；三是设计了 "首次激活计时 + 换绑次数 + 封禁状态" 的授权模型，兼顾发卡库存与设备绑定防滥用；四是云密钥通过独立凭证文件外置并给出安全提示，随 exe 分发时可按需删除。
评论