开发指南
A
admin
! 开发指南总览

本指南将帮助你快速将客户端软件对接到卡密管理系统。系统提供 9 个核心 API 接口,覆盖 版本检查 → 软件公告 → 充值链接 → 免费试用 → 卡密认证 → 心跳保活 → 试用心跳 → 自助解绑 → 卡密加时 完整生命周期。所有接口均无需登录认证,使用固定的 /api/client 前缀。

🔒
所有接口的入参都会经过格式校验 + 注入检测:不符合字符集规则会返回 422, 夹带 SQL 注入 / XSS / 命令注入 / 路径穿越特征会返回 403 并记入后台的 「安全中心 → 注入动向记录」(含来源 IP、访问路径与原始载荷)。 对接前请务必先阅读 第 12 章「安全与输入规范」,避免客户端代码被误判为攻击。
快速导航
对接流程 版本检查 软件公告 充值链接 免费试用 卡密认证 心跳保活 试用心跳 自助解绑 卡密加时 实战 UI 示例 安全与输入规范 错误码参考 注意事项
1 对接流程
一、用户使用流程(用户视角)
用户拿到你的EXE软件或APK软件后,从头到尾会发生什么:
1
用户打开软件 → 软件自动连接你的服务器,检查版本是否最新。如果服务器上有新版本,弹窗提示用户下载更新。
2
试用还是输入卡密? → 如果你在后台开启了免费试用,软件会自动帮用户开启试用,用户可以直接用,不用输入卡密。试用到期后,软件弹出输入框要求用户输入卡密。
3
用户输入卡密 → 用户把你发给他的卡密填进去,软件把卡密+本机机器码一起发给服务器验证。服务器检查:卡密存不存在?过期了没?绑定的设备数超了没?都没问题就通过,用户进入软件主功能。
4
软件持续运行 → 软件在后台每隔5分钟自动给服务器发一次心跳,告诉服务器"我还在用"。如果心跳失败(卡密过期、被禁用、设备被解绑),软件立即停止运行,提示用户重新输入卡密。
5
设备超限怎么办? → 如果用户换了新电脑,新设备认证时服务器会检查绑定的设备数是否超过卡密的设备限制(默认1台)。超过了会提示"设备数量已达上限"。如果后台开启了自助解绑,用户可以在旧设备上解绑后再在新设备上激活;否则需要联系管理员解绑。
6
卡密到期/被禁用 → 卡密过期后心跳返回403,软件停止运行。用户可以:① 点击充值按钮跳转到购买页面买新卡密;② 如果有充值卡密,使用"卡密加时"功能把时长叠加到当前卡密上(永久卡不可加时);③ 如果是被管理员禁用,只能联系管理员解封。
二、开发者对接流程(你的视角)
开发软件时,你需要做这几步:
1
后台创建应用 → 在「应用管理」页面创建一个应用,填好软件名称、版本号、下载链接。系统会自动生成一个应用密钥(app_key),这是一个32位的随机字符串,相当于你这个软件的身份证号。
2
后台生成卡密 → 在「卡密管理」页面生成卡密,选择卡密类型(天卡/月卡/年卡/永久等)、设备限制(一机一码=1台,最多3台=3)。生成的卡密发给你的用户,用户拿这个卡密激活软件。
3
软件里写入SDK代码 → 把本指南提供的Python/C#/Go等SDK代码复制到你的软件里,填入服务器地址 http://cdk.bcwlgzs.top 和应用密钥。SDK会自动处理版本检查、公告、试用、认证、心跳、充值跳转、卡密加时、自助解绑。
4
软件里生成机器码 → 在软件启动时调用 generate_machine_code() 获取本机机器码(基于CPU+主板+硬盘+MAC生成的唯一标识),每次调用API时带上这个机器码,服务器靠它判断"是不是同一台电脑"。
5
编译发布软件 → 把写好的软件编译成EXE或APK,发给用户。用户打开后自动走上面的"用户使用流程"。
三、API调用链路(技术视角)
软件启动后代码层面的调用顺序:
1
版本检查 → 调用 GET /api/client/version,传 app_key + 当前版本号,返回是否有新版本
2
软件公告 → 调用 GET /api/client/notice,传 app_key,获取公告内容展示给用户
3
试用查询 → 调用 POST /api/client/trial,传 app_key + machine_code。返回试用有效 → 进入软件;返回试用到期 → 跳到第4步
4
卡密认证 → 调用 POST /api/client/auth,传 app_key + key_code + machine_code。首次使用自动激活,自动绑定设备。成功 → 进入软件
5
充值链接(可选)→ 调用 GET /api/client/recharge,传 app_key,获取官方充值页面地址,用户点击跳转到购买卡密
6
卡密加时(可选)→ 调用 POST /api/client/recharge-key,传 app_key + 当前卡密 key_code + 充值卡密 recharge_key + machine_code。把充值卡密的时长叠加到当前卡密上(永久卡不可加时)
7
心跳保活 → 进入软件后每隔 5分钟 调用 POST /api/client/heartbeat,传 app_key + key_code + machine_code。试用用户调 POST /api/client/trial/heartbeat。心跳失败 → 停止运行
8
自助解绑(可选)→ 用户换电脑时调用 POST /api/client/unbind,解除旧设备绑定,释放设备名额。需在后台开启自助解绑功能
⚠️
所有接口的 app_key 参数来自「应用管理」页面中每个应用自动生成的应用密钥(32位随机字符串)。机器码 machine_code 需要客户端自行生成(Python 示例见第11章完整代码中的 generate_machine_code() 函数)。
2 版本检查接口
GET /api/client/version 无需认证

查询应用最新版本号,判断客户端是否需要更新。

参数类型必填说明
app_keystring是应用密钥
current_versionstring否客户端当前版本号,如 "1.0"。不传时 update_available 固定返回 false(仅获取最新版本号)
✅ 成功响应
{ "status": "success", "app_name": "测试应用", "app_key": "a1b2c3d4...", "latest_version": "2.0", "current_version": "1.0", "update_available": true, "force_update": true, "update_required": true, "update_url": "https://example.com/download", "update_note": "1.修复已知bug\n2.新增XX功能\n3.优化界面体验", "api_note": "认证接口 POST /api/client/auth,参数: app_key、key_code、machine_code", "update_tip": "发现新版本 2.0", "notice": "欢迎使用本软件!如有问题请联系客服。", "recharge_url": "https://example.com/buy" }
❌ 错误响应
HTTP 400 {"status": "error", "message": "缺少必要参数:app_key"} HTTP 404 {"status": "error", "message": "应用密钥无效"}
响应字段说明:
• update_available — 是否有新版本,为 true 时弹窗提示用户更新
• force_update — 后台「编辑应用」里是否开启了强制更新
• update_required — force_update 开启且客户端版本落后时为 true:客户端必须更新到最新版才能使用(示例代码会把全部功能按钮锁死,且更新弹窗无法跳过)
• update_url — 新版本下载链接,弹窗里「立即更新」按钮跳转用
• update_note — 更新介绍(本版更新了什么),弹窗里展示给用户
• update_tip — 现成的提示文案("发现新版本 2.0" / "当前已是最新版本"),可直接展示
• api_note — API 说明,notice — 软件公告,recharge_url — 充值链接(一次请求全部带回,无需再调公告/充值接口)
版本号比较规则:按数字逐段比较(1.0 < 1.1 < 2.0,段数不齐自动补 0,如 1.0 与 1.0.1 比较时 1.0 补成 1.0.0);若版本号含非数字字符(如 "v1.2"),退化为字符串比较,不同即提示更新。
在哪里设置:后台「应用管理 → 编辑」中的 版本号、更新下载链接、更新介绍、API说明,以及 强制更新 开关。发布新版本时:把新安装包传到下载链接 → 后台把版本号改成新版本号 → 用户端下次调用此接口即收到更新提示;若开启了强制更新,旧版本客户端会被锁死功能,直到「重新检测」通过。
建议调用时机:软件启动时调用一次,之后每隔 30~60 分钟轮询一次即可;无需认证,不会消耗卡密验证次数。
📥 检测版本代码(Python,可直接复制)

判断逻辑全在服务端:返回 update_required = true 就是「旧版本且强制更新已开启」,客户端锁死功能只给更新;只返回 update_available = true 则是普通更新提示,用户可选择暂不更新。

Python 版本检测(需安装 requests)
# -*- coding: utf-8 -*- import requests API_BASE = "http://你的域名或IP:8080" # 你的卡密系统地址 APP_KEY = "你的应用密钥" # 后台「编辑应用」里的应用密钥 CURRENT_VERSION = "1.0" # 你软件的当前版本号 def check_update(): """检测版本:返回服务端判定结果。 update_available = 有新版本(普通更新提示) update_required = True 表示旧版本已被强制更新锁定,必须更新后才能使用 """ r = requests.get(API_BASE + "/api/client/version", params={ "app_key": APP_KEY, "current_version": CURRENT_VERSION, }, timeout=10) return r.json() # ── 软件启动时调用 ── info = check_update() if info.get("update_required"): # 强制更新:锁死全部功能,只允许更新,不能跳过 print(f"⚠ 版本 v{CURRENT_VERSION} 已停用,必须更新到 v{info['latest_version']} 才能使用") print(f"下载地址:{info['update_url']}") print(f"更新说明:{info['update_note']}") # 1) 打开下载页 / 自动下载新版本安装包 # 2) 用户安装新版后重新运行软件(或循环调用 check_update 直到 update_required 变 False) # 在此之前:禁用软件全部功能按钮,只保留更新入口 import sys input("按回车键打开下载页面...") import webbrowser webbrowser.open(info.get("update_url", "")) sys.exit(0) # 旧版本直接退出,不进入主功能 elif info.get("update_available"): # 普通更新:提示用户,允许跳过 print(f"发现新版本 v{info['latest_version']}:{info['update_note']}") print(f"下载地址:{info['update_url']}(可稍后更新,不影响本次使用)") else: print(f"当前已是最新版本 v{info.get('latest_version', CURRENT_VERSION)},正常启动") # ... 版本检测通过后,再走卡密认证 / 试用流程(见第 11 节完整示例)
🔄 自动更新代码(下载新版 → 自动删除旧版 → 自动重启)

原理:Windows 不允许删除正在运行的 exe,所以本程序先把新版下载到临时目录,然后启动一个独立的替换脚本(bat),本程序退出释放文件锁 → 脚本等 2 秒后删除旧版 → 新版自动改名顶替原位置原名 → 自动启动新版 → 脚本自删。用户改名过(如 我爱你.exe)、放 C 盘/E 盘都没关系——程序用 sys.executable 拿到自己的真实完整路径传给脚本。旧版会先备份为 .bak,更新失败改回来即可回滚。

Python 自动更新(需安装 requests, tkinter 自带)
# -*- coding: utf-8 -*- """自动更新:下载新版 → 自动删除旧版 → 新版顶替原名 → 自动重启""" import requests import hashlib import os import sys import subprocess import tempfile import webbrowser API_BASE = "http://你的域名或IP:8080" APP_KEY = "你的应用密钥" CURRENT_VERSION = "1.0" def check_update(): """版本检测:返回 update_required(强制)/ update_available(普通)等""" r = requests.get(API_BASE + "/api/client/version", params={"app_key": APP_KEY, "current_version": CURRENT_VERSION}, timeout=10) return r.json() def download_new_version(url, save_to): """下载新版安装包,带百分比进度""" with requests.get(url, stream=True, timeout=60) as r: r.raise_for_status() total = int(r.headers.get("content-length", 0)) done = 0 with open(save_to, "wb") as f: for chunk in r.iter_content(chunk_size=65536): f.write(chunk) done += len(chunk) if total: print(f"\r下载中... {done * 100 // total}% ({done}/{total} 字节)", end="") print("\n下载完成:", save_to) def do_auto_update(update_url): """完整自动更新:下载 → 校验 → 备份 → 替换 → 重启""" old_path = os.path.abspath(sys.executable) # 关键:拿到自己真实的完整路径(改名/换盘都能删) if not old_path.lower().endswith(".exe"): print("仅在打包成 exe 后支持自动替换,脚本方式请手动替换文件") return # 1) 下载新版到临时目录 new_file = os.path.join(tempfile.gettempdir(), f"update_{CURRENT_VERSION}.exe") download_new_version(update_url, new_file) # 2) 校验:必须是有效的 Windows 程序(MZ 文件头),防止下载出错 with open(new_file, "rb") as f: if f.read(2) != b"MZ": print("下载的文件不是有效程序,已取消更新") os.remove(new_file) return # 3) 备份旧版为 .bak(更新失败把它改回原名即可回滚) backup = old_path + ".bak" subprocess.run(["cmd", "/c", f'copy /y "{old_path}" "{backup}"'], creationflags=subprocess.CREATE_NO_WINDOW) # 4) 生成替换脚本:等旧程序退出 → 删旧版 → 新版顶替原名 → 启动新版 → 脚本自删 bat = ( "@echo off\r\n" f"timeout /t 2 /nobreak\r\n" f"del \"{old_path}\"\r\n" f"move /y \"{new_file}\" \"{old_path}\"\r\n" f"start \"" \"{old_path}\"\r\n" "del %~f0\r\n" ) bat_file = os.path.join(tempfile.gettempdir(), "auto_update.bat") with open(bat_file, "w", encoding="gbk") as f: f.write(bat) # 5) 启动替换脚本(独立进程),本程序退出释放文件锁 subprocess.Popen(["cmd", "/c", bat_file], creationflags=subprocess.CREATE_NO_WINDOW) print("更新中,程序将自动重启为新版本...") sys.exit(0) # ── 软件启动时 ── info = check_update() if info.get("update_required"): # 强制更新:不允许跳过,直接开始自动更新 print("⚠ 当前版本已停用,开始自动更新...") do_auto_update(info.get("update_url", "")) elif info.get("update_available"): ans = input(f"发现新版本 v{info['latest_version']},是否立即更新?(y/n):") if ans.lower() == "y": do_auto_update(info.get("update_url", "")) else: print("当前已是最新版本,正常启动")
💡
注意事项:① 若下载的是 zip 压缩包,把 move 换成解压到原目录即可;② 程序装在 C:\Program Files 时需要管理员权限(安装包声明 requireAdministrator);③ 个别杀毒软件可能拦截 bat 替换行为,专业方案是独立更新器 exe 或数字签名;④ 更新后启动异常时,把 程序名.exe.bak 改回原名即回滚到旧版。
版本落后是怎么判定的:服务端比较 current_version 与后台设置的应用版本号(如后台 1.1、客户端 1.0 → 判定旧版)。所以发布新版本 = 上传新安装包 + 后台把应用版本号改高,客户端下次检测就会收到更新指令;若开启了强制更新,旧版本客户端直接锁死。
带界面的完整示例:见下方第 11 节(含强制更新锁死 UI、更新弹窗、重新检测按钮)。
3 软件公告接口
GET /api/client/notice 无需认证

获取软件公告内容,可在软件启动时展示给用户(如维护通知、活动公告等)。

🛡️
notice 字段是纯文本:服务端已剥离 HTML 标签、javascript: 等危险协议、 on*= 事件属性与控制字符,并截断到 500 字。请用纯文本控件展示,不要用 WebView / 富文本 / innerHTML 渲染。
参数类型必填说明
app_keystring是应用密钥
✅ 成功响应
{ "status": "success", "app_name": "测试应用", "app_key": "a1b2c3d4...", "notice": "欢迎使用本软件!\n如有问题请联系客服QQ:123456789\n\n【公告】9月15日凌晨2点系统维护,预计1小时。" }
说明:公告内容在后台「应用管理 → 编辑 → 软件公告」中设置,支持换行。
4 充值链接接口
GET /api/client/recharge 无需认证

获取充值购买链接,用户点击充值按钮时跳转到此链接进行购买续费。

参数类型必填说明
app_keystring是应用密钥
✅ 成功响应
{ "status": "success", "app_name": "测试应用", "app_key": "a1b2c3d4...", "recharge_url": "https://example.com/buy" }
说明:充值链接在后台「应用管理 → 编辑 → 充值链接」中设置。
5 免费试用接口
POST /api/client/trial 无需认证

每台设备每个应用可免费试用一次,到期后需输入卡密继续使用。

参数类型必填说明
app_keystring是应用密钥
machine_codestring是设备机器码
✅ 试用有效 / 首次开启
{ "status": "success", "message": "试用已开启,有效期 24 小时", "app_name": "测试应用", "start_time": "2026-09-10 10:00:00", "expire_time": "2026-09-11 10:00:00", "remaining_hours": 24.0 }
❌ 试用到期
HTTP 403 { "status": "error", "message": "试用已到期,请输入卡密继续使用" }
❌ 未开启试用
HTTP 403 { "status": "error", "message": "该应用未开启免费试用" }
6 卡密认证接口
POST /api/client/auth 无需认证

核心认证接口:验证卡密有效性,绑定设备,首次使用自动激活。

参数类型必填说明
app_keystring是应用密钥
key_codestring是用户输入的卡密
machine_codestring是设备机器码
ip_addressstring否设备IP,不传则使用请求来源IP
✅ 认证成功
{ "status": "success", "message": "认证成功", "key_info": { "key_code": "A1B2C3D4E5F6G7H8", "app_name": "测试应用", "key_type": "month", "start_time": "2026-09-10 10:00:00", "expire_time": "2026-10-10 10:00:00", "device_limit": 2, "used_count": 1 }, "app_info": { "app_name": "测试应用", "app_key": "a1b2c3d4...", "latest_version": "2.0", "update_available": false, "update_url": "", "update_note": "", "api_note": "认证接口 POST /api/client/auth,参数: app_key、key_code、machine_code", "notice": "欢迎使用本软件!如有问题请联系客服。", "recharge_url": "https://example.com/buy" } }
key_type 可选值:hour / day / week / month / quarter / year / permanent / custom
device_limit 为该卡密允许绑定的最大设备数,used_count 为已绑定设备数
❌ 卡密不存在
HTTP 404 { "status": "error", "message": "卡密不存在" }
❌ 卡密已过期
HTTP 403 { "status": "error", "message": "卡密已过期,请去官方重新购买" }
❌ 设备超限
HTTP 403 { "status": "error", "message": "设备数量已达上限(2台)" }
❌ 卡密被禁用
HTTP 403 { "status": "error", "message": "卡密已被管理员禁止使用" }
7 心跳保活接口
POST /api/client/heartbeat 无需认证

认证成功后每 5 分钟调用一次,维持在线状态并检查卡密有效性。

参数类型必填说明
app_keystring是应用密钥
key_codestring是已认证的卡密
machine_codestring是已绑定的设备机器码
client_versionstring否客户端当前版本号,建议每次心跳都带上:后台设备管理页据此显示版本并标出旧版,针对设备的「强制更新」也依赖它
✅ 心跳成功
{ "status": "success", "message": "心跳更新成功", "key_code": "A1B2C3D4E5F6G7H8", "app_name": "测试应用", "machine_code": "1A2B3C...", "last_heartbeat": "2026-09-10 10:05:00", "expire_time": "2026-10-10 10:00:00", "remaining": "720.0 小时", "device_limit": 2, "notice": "", "force_update": false, "update_required": false, "latest_version": "1.1", "update_url": "https://example.com/update.zip", "update_note": "1.修复已知问题" }
💡
心跳接口同时也会检查卡密是否过期/禁用。update_required 为 true 时必须锁死全部功能并弹出不可跳过的更新窗口(见第 11 节示例)。notice 非空时弹窗展示——这是管理员从后台「设备管理 → 详情 → 发公告」给你单独发的公告,展示一次即可。
7+ 启动上报接口
POST /api/client/launch 无需认证

客户端每次打开软件时调用一次(认证成功、进入主窗口后调用)。服务端累计「打开软件次数」、记录最近打开时间(后台设备详情页展示),并下发管理员给你的单独公告与强制更新状态。

参数类型必填说明
app_keystring是应用密钥
key_codestring是已认证的卡密
machine_codestring是设备机器码
client_versionstring否客户端当前版本号,建议必带
✅ 成功响应
{ "status": "success", "message": "启动成功", "launch_count": 37, "last_launch_at": "2026-10-05 09:00:00", "notice": "您使用的版本存在严重问题,请立即更新", "force_update": false, "update_required": false, "latest_version": "1.1", "update_url": "https://example.com/update.zip", "update_note": "1.修复已知问题", "online_seconds": 3600, "offline_count": 2, "expire_time": "2026-10-10 10:00:00" }
响应字段说明:
• launch_count — 该设备累计打开软件次数
• notice — 管理员从后台「设备管理 → 详情 → 发公告」下发的一次性公告,非空时弹窗展示给用户(展示后服务端自动清除,不会重复弹)
• update_required — 强制更新状态(被管理员单独标记或版本落后且应用开启强制更新),为 true 时锁死全部功能弹更新窗
• online_seconds — 本次连续在线时长(秒);offline_count — 历史离线次数,可在软件里展示给用户
💡
试用设备没有绑定卡密,不需要调用此接口(试用用户的管理操作在设备管理页直接进行)。
8 试用心跳保活接口
POST /api/client/trial/heartbeat 无需认证

免费试用用户的专用心跳接口,试用期间每 5 分钟调用一次,维持试用在线状态。

参数类型必填说明
app_keystring是应用密钥
machine_codestring是试用设备机器码
client_versionstring否试用客户端当前版本号,建议带上:后台设备管理页据此显示版本并标出旧版
✅ 心跳成功
{ "status": "success", "message": "心跳更新成功", "app_name": "测试应用", "machine_code": "1A2B3C...", "start_time": "2026-09-10 10:00:00", "expire_time": "2026-09-11 10:00:00", "remaining_hours": 23.5, "last_heartbeat": "2026-09-10 10:05:00" }
❌ 试用已到期
HTTP 403 { "status": "error", "message": "试用已到期,请输入卡密继续使用" }
💡
试用心跳与普通心跳独立,仅用于免费试用设备。试用到期后应切换为卡密认证流程。
9 自助解绑接口
POST /api/client/unbind 需应用开启

客户端自助解除当前设备与卡密的绑定,释放设备名额。需应用开启自助解绑功能,且受30天内次数限制。

参数类型必填说明
app_keystring是应用密钥
key_codestring是卡密码
machine_codestring是要解绑的设备机器码
✅ 解绑成功
{ "status": "success", "message": "解绑成功", "remaining_unbinds": 2, "limit_30d": 3 }
❌ 解绑失败
HTTP 403 { "status": "error", "message": "30天内解绑次数已达上限(3次),请联系管理员" }
⚠️
remaining_unbinds 表示该卡密30天内剩余可解绑次数。limit_30d 为30天解绑次数上限。解绑次数限制由应用配置决定,默认为3次/30天。
10 卡密加时接口
POST /api/client/recharge-key 无需认证

用一张新的充值卡密给当前正在使用的卡密叠加时长,无需解绑设备。日卡/周卡/月卡/季卡/年卡可叠加,永久卡不能加时,自定义卡不能用来加时。

参数类型必填说明
app_keystring是应用密钥
key_codestring是当前正在使用的卡密(被加时的卡)
recharge_keystring是用来加时的新卡密(用完即标记已使用)
machine_codestring是当前设备机器码,需已激活此卡密
✅ 加时成功
{ "status": "success", "message": "加时成功", "added_days": 30, "new_expire_time": "2026-11-10 10:00:00", "key_type": "month" }
❌ 加时失败
HTTP 400 { "status": "error", "message": "永久卡无需加时" }
❌ 充值卡已被使用
HTTP 403 { "status": "error", "message": "充值卡密已被使用或已过期" }
❌ 自定义卡不支持
HTTP 400 { "status": "error", "message": "自定义时长卡密不支持加时" }
💡
加时规则:若目标卡未过期,在原过期时间上叠加;若已过期,则从当前时间开始算。充值卡密使用后立即标记为「已使用」,不可再次使用。加时后过期卡自动恢复为「已激活」状态。小时卡、自定义卡不能用来加时。
11 实战 Python UI 对接示例(带界面)

打开软件后先弹出验证窗口,用户可以选择「免费试用」直接进入,或者输入卡密点「激活」进入。界面美观,开箱即用。后台开启「强制更新」后,版本落后的客户端会在启动时锁死全部功能按钮,只有完成更新并通过「重新检测」才会解锁:

🖥️ 机器码生成
自动生成16位机器码,本地持久化
🔐 卡密激活
输入卡密一键激活,绑定机器码
🎁 免费试用
每台设备限试用一次,防刷
💓 心跳保活
后台自动心跳,掉线自动退出
⏳ 卡密加时
新卡密叠加时长,不用解绑
🔓 自助解绑
用户可自行解绑,换设备用
🔄 强制更新
版本落后锁死全部功能,必须更新才能用
📢 软件公告
后台发布公告,实时推送
🆙 版本更新
启动自动检测,弹窗提示升级
💰 充值跳转
一键跳转到购买页面
💾 自动登录
记住卡密,下次自动填
Python (需安装 requests, tkinter 自带)
# -*- coding: utf-8 -*- """ 卡密授权客户端 - 精美 UI 版 """ import requests import threading import time import hashlib import hmac import uuid import os import sys import ctypes import json import webbrowser import tkinter as tk # ═══════════════════════════════════════════════ # 配置区 # ═══════════════════════════════════════════════ SERVER_URL = "http://cdk.bcwlgzs.top" APP_KEY = "77752870ae7091240e92e8d1d63a1631" CURRENT_VERSION = "1.0" HEARTBEAT_INTERVAL = 300 # 心跳间隔(秒),官方推荐 5 分钟 = 300 秒 CONFIG_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "auth_config.json") # 主题色 PRIMARY = "#6366f1" # 主色 - 靛蓝 PRIMARY_DARK = "#4f46e5" # 主色深 PRIMARY_LIGHT = "#818cf8" # 主色浅 ACCENT = "#ec4899" # 点缀色 - 粉 SUCCESS = "#10b981" WARNING = "#f59e0b" ERROR = "#ef4444" BG = "#f8fafc" CARD = "#ffffff" TEXT = "#1e293b" TEXT_SEC = "#64748b" TEXT_MUTE = "#94a3b8" BORDER = "#e2e8f0" # ═══════════════════════════════════════════════ # 工具函数 # ═══════════════════════════════════════════════ def generate_machine_code(): mac = uuid.getnode() name = os.environ.get('COMPUTERNAME', '') vol = '' if sys.platform == 'win32': try: serial = ctypes.c_ulong(0) ctypes.windll.kernel32.GetVolumeInformationW( ctypes.c_wchar_p("C:\\"), None, 0, ctypes.byref(serial), None, None, None, 0 ) vol = f"{serial.value:08X}" except: pass raw = f"{mac}_{name}_{vol}" # 取MD5哈希前16位,生成16位机器码(如 EB960B9F216353FD) return hashlib.md5(raw.encode()).hexdigest()[:16].upper() def save_config(key_code="", remember=False, auto_login=False, is_trial=False): config = {"key_code": key_code, "remember": remember, "auto_login": auto_login, "is_trial": is_trial} try: with open(CONFIG_FILE, "w", encoding="utf-8") as f: json.dump(config, f, ensure_ascii=False, indent=2) except: pass def load_config(): try: if os.path.exists(CONFIG_FILE): with open(CONFIG_FILE, "r", encoding="utf-8") as f: return json.load(f) except: pass return {} def format_expire_time(time_str): """格式化到期时间为中文格式:2026年9月12日 01:53:44""" if not time_str: return "未知" try: # 支持 2026-09-12 01:53:44 格式 if " " in time_str and "-" in time_str: date_part, time_part = time_str.split(" ", 1) parts = date_part.split("-") if len(parts) == 3: y, m, d = parts return f"{int(y)}年{int(m)}月{int(d)}日 {time_part}" except: pass return time_str # 当前设备机器码(generate_machine_code 对同一台机器结果固定,与窗口实例一致) MACHINE_CODE = generate_machine_code() def _signed(data): """附加 时间戳/随机数/HMAC签名(与真实客户端一致,签名内容 = 时间戳|随机数|机器码,密钥 = app_key。 服务器当前不强制校验;若服务器开启验签,此函数保证对接不中断)""" try: ts = str(int(time.time())) nonce = uuid.uuid4().hex base = f"{ts}|{nonce}|{MACHINE_CODE}" sign = hmac.new(APP_KEY.encode(), base.encode(), hashlib.sha256).hexdigest() data = dict(data or {}) data["_ts"] = ts data["_nonce"] = nonce data["_sign"] = sign except Exception: pass return data def api_post(path, data): """POST 请求。返回 (状态码, json);状态码=0 表示网络异常(服务器没连上),可与服务器明确拒绝区分开""" try: resp = requests.post(f"{SERVER_URL}{path}", json=_signed(data), timeout=10) return resp.status_code, resp.json() except Exception as e: return 0, {"status": "error", "message": str(e)} def api_get(path, params): """GET 请求。注意:返回 json 字典本身(与 api_post 不同,不返回元组)""" try: resp = requests.get(f"{SERVER_URL}{path}", params=_signed(params), timeout=10) return resp.json() except Exception as e: return {"status": "error", "message": str(e)} # ═══════════════════════════════════════════════ # 精美圆角按钮 # ═══════════════════════════════════════════════ class FancyButton(tk.Canvas): def __init__(self, master, text, command=None, width=160, height=44, bg=PRIMARY, fg="white", hover_bg=PRIMARY_DARK, active_bg="#3730a3", shadow_color="#e0e7ff", font=("Microsoft YaHei", 10, "bold"), radius=12, icon=None, **kwargs): super().__init__(master, width=width, height=height, bg=master["bg"], highlightthickness=0, **kwargs) self.command = command self.bg_color = bg self.hover_color = hover_bg self.active_color = active_bg self.shadow_color = shadow_color self.fg_color = fg self.radius = radius self.text = text self.font = font self.width = width self.height = height self.icon = icon self._disabled = False self._current_color = bg self.bind("<Enter>", self._on_enter) self.bind("<Leave>", self._on_leave) self.bind("<Button-1>", self._on_click) self.bind("<ButtonRelease-1>", self._on_release) self._draw(self.bg_color) def _draw(self, color): self._current_color = color self.delete("all") r = self.radius w, h = self.width, self.height # 底部阴影(模拟) shadow_y = h - 2 sc = self.shadow_color self.create_arc((2, shadow_y - r*2 + 2, r*2 + 2, shadow_y + 2), start=180, extent=90, fill=sc, outline="") self.create_arc((w-r*2 - 2, shadow_y - r*2 + 2, w - 2, shadow_y + 2), start=270, extent=90, fill=sc, outline="") self.create_rectangle((r+2, shadow_y, w-r-2, shadow_y+2), fill=sc, outline="") self.create_rectangle((2, shadow_y - r + 2, w-2, shadow_y + 2 - r + r), fill=sc, outline="") # 主体圆角矩形 self.create_arc((0, 0, r*2, r*2), start=90, extent=90, fill=color, outline=color) self.create_arc((w-r*2, 0, w, r*2), start=0, extent=90, fill=color, outline=color) self.create_arc((0, h-r*2 - 2, r*2, h - 2), start=180, extent=90, fill=color, outline=color) self.create_arc((w-r*2, h-r*2 - 2, w, h - 2), start=270, extent=90, fill=color, outline=color) self.create_rectangle((r, 0, w-r, h-2), fill=color, outline=color) self.create_rectangle((0, r, w, h-r-2), fill=color, outline=color) # 顶部高光 self.create_arc((4, 2, r*2 - 4, r*2 - 4), start=90, extent=90, fill=self._lighten(color, 20), outline="") self.create_arc((w-r*2 + 4, 2, w - 4, r*2 - 4), start=0, extent=90, fill=self._lighten(color, 20), outline="") self.create_rectangle((r, 2, w-r, r-2), fill=self._lighten(color, 20), outline="") # 文字 + 图标 display_text = f"{self.icon} {self.text}" if self.icon else self.text self.create_text(w//2, h//2 - 1, text=display_text, fill=self.fg_color, font=self.font) def _lighten(self, hex_color, amount): """颜色变亮""" # 处理英文颜色名 color_map = { "white": "#ffffff", "black": "#000000", "red": "#ff0000", "green": "#00ff00", "blue": "#0000ff", } if hex_color.lower() in color_map: hex_color = color_map[hex_color.lower()] if not hex_color.startswith("#") or len(hex_color) != 7: return hex_color try: r = int(hex_color[1:3], 16) g = int(hex_color[3:5], 16) b = int(hex_color[5:7], 16) r = min(255, r + amount) g = min(255, g + amount) b = min(255, b + amount) return f"#{r:02x}{g:02x}{b:02x}" except: return hex_color def _on_enter(self, event): if not self._disabled: self._draw(self.hover_color) self.config(cursor="hand2") def _on_leave(self, event): if not self._disabled: self._draw(self.bg_color) self.config(cursor="") def _on_click(self, event): if not self._disabled: self._draw(self.active_color) def _on_release(self, event): if not self._disabled: self._draw(self.hover_color) if self.command: self.command() def config(self, **kwargs): if "state" in kwargs: state = kwargs["state"] if state == tk.DISABLED: self._disabled = True self._draw("#9ca3af") elif state == tk.NORMAL: self._disabled = False self._draw(self.bg_color) super().config(**kwargs) # ═══════════════════════════════════════════════ # 精致输入框 # ═══════════════════════════════════════════════ class FancyEntry(tk.Frame): def __init__(self, master, placeholder="", icon=None, show=None, **kwargs): super().__init__(master, bg=master["bg"], **kwargs) self.placeholder = placeholder self.has_focus = False self.show = show # 外层边框容器 self.border_frame = tk.Frame(self, bg=BORDER) self.border_frame.pack(fill="x", ipady=1) # 内层白色背景 self.inner = tk.Frame(self.border_frame, bg="white") self.inner.pack(fill="x", padx=1, pady=1) # 图标 if icon: self.icon_label = tk.Label(self.inner, text=icon, font=("Segoe UI Emoji", 13), bg="white", fg=TEXT_MUTE) self.icon_label.pack(side="left", padx=(12, 6), pady=8) # 输入框 self.entry = tk.Entry(self.inner, font=("Microsoft YaHei", 11), relief="flat", bd=0, bg="white", fg=TEXT, insertbackground=PRIMARY, show=show or "") self.entry.pack(side="left", fill="x", expand=True, padx=(0, 12), pady=8) # 占位符 self._show_placeholder() # 事件绑定 self.entry.bind("<FocusIn>", self._on_focus_in) self.entry.bind("<FocusOut>", self._on_focus_out) def _show_placeholder(self): if not self.entry.get(): self.entry.insert(0, self.placeholder) self.entry.config(fg=TEXT_MUTE) if self.show: self.entry.config(show="") def _hide_placeholder(self): if self.entry.get() == self.placeholder: self.entry.delete(0, tk.END) self.entry.config(fg=TEXT) if self.show: self.entry.config(show=self.show) def _on_focus_in(self, event): self.has_focus = True self.border_frame.config(bg=PRIMARY_LIGHT) self._hide_placeholder() def _on_focus_out(self, event): self.has_focus = False self.border_frame.config(bg=BORDER) if not self.entry.get(): self._show_placeholder() def get(self): text = self.entry.get() if text == self.placeholder: return "" return text.strip() def set(self, text): self.entry.delete(0, tk.END) self.entry.insert(0, text) self.entry.config(fg=TEXT) if self.show: self.entry.config(show=self.show) def bind(self, event, callback): self.entry.bind(event, callback) # ═══════════════════════════════════════════════ # 自定义复选框 # ═══════════════════════════════════════════════ class FancyCheckbox(tk.Frame): def __init__(self, master, text="", variable=None, **kwargs): super().__init__(master, bg=master["bg"], **kwargs) self.var = variable if variable else tk.BooleanVar(value=False) self.text = text self.box = tk.Label(self, text="☐", font=("Segoe UI Emoji", 12), bg=master["bg"], fg=TEXT_MUTE, cursor="hand2") self.box.pack(side="left") self.label = tk.Label(self, text=text, font=("Microsoft YaHei", 9), bg=master["bg"], fg=TEXT_SEC, cursor="hand2") self.label.pack(side="left", padx=(4, 0)) self.box.bind("<Button-1>", self._toggle) self.label.bind("<Button-1>", self._toggle) self._update_display() def _toggle(self, event=None): self.var.set(not self.var.get()) self._update_display() def _update_display(self): if self.var.get(): self.box.config(text="☑", fg=PRIMARY) self.label.config(fg=PRIMARY) else: self.box.config(text="☐", fg=TEXT_MUTE) self.label.config(fg=TEXT_SEC) def get(self): return self.var.get() def set(self, value): self.var.set(value) self._update_display() # ═══════════════════════════════════════════════ # 版本更新对话框 # ═══════════════════════════════════════════════ class UpdateDialog(tk.Toplevel): def __init__(self, master, latest_version, tip, update_url="", update_note="", on_skip=None, on_update=None, force=False, on_recheck=None): super().__init__(master) self.master_window = master self.update_url = update_url self.on_skip = on_skip self.on_update = on_update self.force = force # 强制更新模式:无「先不更新」,只能更新或重新检测 self.on_recheck = on_recheck self.title("版本更新") self.resizable(False, False) self.configure(bg=BG) self.transient(master) self.grab_set() w, h = 420, 340 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() self.geometry(f"{w}x{h}+{(sw-w)//2}+{(sh-h)//2}") # 顶部紫色标题区 header = tk.Frame(self, bg=PRIMARY, height=70) header.pack(fill="x") header.pack_propagate(False) # 图标 + 标题 head_inner = tk.Frame(header, bg=PRIMARY) head_inner.pack(expand=True) icon_canvas = tk.Canvas(head_inner, width=36, height=36, bg=PRIMARY, highlightthickness=0) icon_canvas.pack(side="left", padx=(0, 10)) icon_canvas.create_oval(2, 2, 34, 34, fill="white", outline="") icon_canvas.create_text(18, 20, text="ℹ", font=("Segoe UI", 16, "bold"), fill=PRIMARY) title_col = tk.Frame(head_inner, bg=PRIMARY) title_col.pack(side="left") tk.Label(title_col, text=(f"必须更新 v{latest_version}" if self.force else f"检测到新版本 v{latest_version}"), font=("Microsoft YaHei", 12, "bold"), fg="white", bg=PRIMARY).pack(anchor="w") tk.Label(title_col, text=(f"必须完成更新才能继续使用" if self.force else tip), font=("Microsoft YaHei", 8), fg="#c7d2fe", bg=PRIMARY).pack(anchor="w", pady=(1, 0)) # 白色卡片内容区(可滚动) card = tk.Frame(self, bg="white") card.pack(fill="both", expand=True, padx=16, pady=(0, 10)) # 滚动容器 canvas = tk.Canvas(card, bg="white", highlightthickness=0) scrollbar = tk.Scrollbar(card, orient="vertical", command=canvas.yview) content = tk.Frame(canvas, bg="white") content.bind("<Configure>", lambda e: canvas.configure(scrollregion=canvas.bbox("all"))) canvas.create_window((0, 0), window=content, anchor="nw") canvas.configure(yscrollcommand=scrollbar.set) canvas.pack(side="left", fill="both", expand=True) scrollbar.pack(side="right", fill="y") # 更新介绍 if update_note: tk.Label(content, text="更新介绍:", font=("Microsoft YaHei", 9, "bold"), fg=TEXT_MAIN, bg="white").pack(anchor="w", pady=(10, 4)) note_box = tk.Frame(content, bg="#f0f9ff") note_box.pack(fill="x", pady=(0, 10)) tk.Label(note_box, text=update_note, font=("Microsoft YaHei", 8), fg="#0369a1", bg="#f0f9ff", wraplength=340, justify="left").pack( anchor="w", padx=8, pady=6) # 下载地址 if update_url: tk.Label(content, text="更新包下载地址:", font=("Microsoft YaHei", 8), fg=TEXT_SEC, bg="white").pack(anchor="w", pady=(0, 4)) url_box = tk.Frame(content, bg="#f8fafc") url_box.pack(fill="x", pady=(0, 10)) tk.Label(url_box, text=update_url, font=("Consolas", 8), fg=PRIMARY, bg="#f8fafc", wraplength=340, justify="left").pack( anchor="w", padx=8, pady=6) # 按钮区:同一行两个按钮 btn_row = tk.Frame(content, bg="white") btn_row.pack(fill="x", pady=(4, 0)) # 立即更新(蓝色按钮) update_btn = FancyButton(btn_row, text="立即更新", command=self._do_update, width=130, height=36, bg=PRIMARY, hover_bg=PRIMARY_DARK, active_bg="#3730a3", radius=8, font=("Microsoft YaHei", 9, "bold")) update_btn.pack(side="left", fill="x", expand=True, padx=(0, 5)) # 第二个按钮:普通模式=先不更新(可跳过);强制模式=重新检测(更新完点这个) if self.force: recheck_btn = FancyButton(btn_row, text="重新检测", command=self._do_recheck, width=130, height=36, bg="#10b981", fg="white", hover_bg="#059669", active_bg="#047857", radius=8, font=("Microsoft YaHei", 9, "bold")) recheck_btn.pack(side="left", fill="x", expand=True, padx=(5, 0)) else: skip_btn = FancyButton(btn_row, text="先不更新", command=self._do_skip, width=130, height=36, bg="#ef4444", fg="white", hover_bg="#dc2626", active_bg="#b91c1c", radius=8, font=("Microsoft YaHei", 9, "bold")) skip_btn.pack(side="left", fill="x", expand=True, padx=(5, 0)) # 居中到父窗口 self.update_idletasks() mx = master.winfo_rootx() + (master.winfo_width() - w) // 2 my = master.winfo_rooty() + (master.winfo_height() - h) // 2 self.geometry(f"+{mx}+{my}") # 强制模式:点 X 视为放弃更新 → 打开下载页并退出(不允许跳过更新继续用) if self.force: self.protocol("WM_DELETE_WINDOW", self._do_update) def _do_update(self): """立即更新:打开浏览器并关闭程序""" if self.update_url: import webbrowser webbrowser.open(self.update_url) self.destroy() if self.on_update: self.on_update() def _do_skip(self): """先不更新:关闭弹窗,执行回调""" self.destroy() if self.on_skip: self.on_skip() def _do_recheck(self): """强制模式:用户更新完软件后点「重新检测」,重新走版本检查""" self.destroy() if self.on_recheck: self.on_recheck() # ═══════════════════════════════════════════════ # 解绑确认对话框 # ═══════════════════════════════════════════════ class UnbindDialog(tk.Toplevel): def __init__(self, master, on_confirm): super().__init__(master) self.master_window = master self.on_confirm = on_confirm self.result = False self.title("确认解绑") self.resizable(False, False) self.configure(bg=BG) self.transient(master) self.grab_set() w, h = 340, 240 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() self.geometry(f"{w}x{h}+{(sw-w)//2}+{(sh-h)//2}") # 顶部橙色警告区 header = tk.Frame(self, bg=WARNING, height=70) header.pack(fill="x") header.pack_propagate(False) head_inner = tk.Frame(header, bg=WARNING) head_inner.pack(expand=True) icon_canvas = tk.Canvas(head_inner, width=36, height=36, bg=WARNING, highlightthickness=0) icon_canvas.pack(side="left", padx=(0, 10)) icon_canvas.create_oval(2, 2, 34, 34, fill="white", outline="") icon_canvas.create_text(18, 20, text="!", font=("Segoe UI", 18, "bold"), fill=WARNING) title_col = tk.Frame(head_inner, bg=WARNING) title_col.pack(side="left") tk.Label(title_col, text="确认解绑", font=("Microsoft YaHei", 13, "bold"), fg="white", bg=WARNING).pack(anchor="w") tk.Label(title_col, text="解绑后需要重新激活", font=("Microsoft YaHei", 8), fg="#fef3c7", bg=WARNING).pack(anchor="w", pady=(1, 0)) # 白色卡片 card = tk.Frame(self, bg="white") card.pack(fill="both", expand=True, padx=16, pady=(0, 10)) content = tk.Frame(card, bg="white") content.pack(fill="both", expand=True, padx=14, pady=14) tk.Label(content, text="确定要解绑当前设备吗?", font=("Microsoft YaHei", 10, "bold"), fg=TEXT, bg="white").pack(pady=(4, 4)) tk.Label(content, text="解绑后该卡密可在其他设备上激活", font=("Microsoft YaHei", 8), fg=TEXT_MUTE, bg="white").pack() # 按钮区 btn_row = tk.Frame(content, bg="white") btn_row.pack(fill="x", pady=(12, 0)) cancel_btn = FancyButton(btn_row, text="取消", command=self._on_cancel, width=110, height=36, bg="white", fg=TEXT_SEC, hover_bg="#f1f5f9", active_bg="#e2e8f0", radius=8, font=("Microsoft YaHei", 9, "bold")) cancel_btn.pack(side="left", fill="x", expand=True, padx=(0, 5)) confirm_btn = FancyButton(btn_row, text="确认解绑", command=self._on_confirm, width=110, height=36, bg=WARNING, fg="white", hover_bg="#d97706", active_bg="#b45309", radius=8, font=("Microsoft YaHei", 9, "bold")) confirm_btn.pack(side="left", fill="x", expand=True, padx=(5, 0)) # 居中 self.update_idletasks() mx = master.winfo_rootx() + (master.winfo_width() - w) // 2 my = master.winfo_rooty() + (master.winfo_height() - h) // 2 self.geometry(f"+{mx}+{my}") def _on_confirm(self): self.result = True if self.on_confirm: self.on_confirm() self.destroy() def _on_cancel(self): self.result = False self.destroy() # ═══════════════════════════════════════════════ # 精美消息弹窗(替换系统 messagebox) # ═══════════════════════════════════════════════ class FancyDialog(tk.Toplevel): """精美弹窗,支持 info/success/warning/error/confirm 五种类型。""" TYPES = { "info": {"icon": "ℹ️", "color": PRIMARY, "bg_light": "#eef2ff"}, "success": {"icon": "✓", "color": SUCCESS, "bg_light": "#ecfdf5"}, "warning": {"icon": "⚠", "color": WARNING, "bg_light": "#fffbeb"}, "error": {"icon": "✕", "color": ERROR, "bg_light": "#fef2f2"}, "confirm": {"icon": "❓", "color": PRIMARY, "bg_light": "#eef2ff"}, } def __init__(self, master, title="提示", message="", dialog_type="info", on_ok=None, on_cancel=None, ok_text="确定", cancel_text="取消"): super().__init__(master) self.result = False self.on_ok = on_ok self.on_cancel = on_cancel cfg = self.TYPES.get(dialog_type, self.TYPES["info"]) self.title(title) self.resizable(False, False) self.configure(bg="white") self.transient(master) self.grab_set() # 计算消息行数,自适应高度 lines = message.count("\n") + 1 msg_height = max(60, lines * 26 + 20) w, h = 340, 160 + msg_height - 60 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() # 定位到父窗口中心 try: mx = master.winfo_rootx() + (master.winfo_width() - w) // 2 my = master.winfo_rooty() + (master.winfo_height() - h) // 2 except: mx, my = (sw - w) // 2, (sh - h) // 2 self.geometry(f"{w}x{h}+{mx}+{my}") self._build_ui(title, message, cfg, dialog_type, ok_text, cancel_text) def _build_ui(self, title, message, cfg, dialog_type, ok_text, cancel_text): # 顶部色条 top_bar = tk.Frame(self, bg=cfg["color"], height=4) top_bar.pack(fill="x") # 标题栏 header = tk.Frame(self, bg="white") header.pack(fill="x", padx=16, pady=(12, 4)) # 图标 + 标题 title_row = tk.Frame(header, bg="white") title_row.pack(fill="x") icon_canvas = tk.Canvas(title_row, width=28, height=28, bg="white", highlightthickness=0) icon_canvas.pack(side="left", padx=(0, 8)) icon_canvas.create_oval(1, 1, 27, 27, fill=cfg["bg_light"], outline="") icon_canvas.create_text(14, 15, text=cfg["icon"], fill=cfg["color"], font=("Segoe UI Emoji", 11, "bold")) tk.Label(title_row, text=title, font=("Microsoft YaHei", 12, "bold"), fg=TEXT, bg="white").pack(side="left", pady=2) # 消息内容区 content = tk.Frame(self, bg=cfg["bg_light"]) content.pack(fill="both", expand=True, padx=16, pady=(8, 12)) inner = tk.Frame(content, bg=cfg["bg_light"]) inner.pack(fill="both", expand=True, padx=14, pady=12) tk.Label(inner, text=message, font=("Microsoft YaHei", 9), fg=TEXT, bg=cfg["bg_light"], wraplength=280, justify="left").pack(anchor="w") # 按钮区 btn_frame = tk.Frame(self, bg="white") btn_frame.pack(fill="x", padx=16, pady=(0, 14)) if dialog_type == "confirm": cancel_btn = FancyButton(btn_frame, text=cancel_text, command=self._on_cancel, width=120, height=36, bg="#f1f5f9", fg=TEXT_SEC, hover_bg="#e2e8f0", active_bg="#cbd5e1", shadow_color="#e2e8f0", radius=8, font=("Microsoft YaHei", 9, "bold")) cancel_btn.pack(side="right", padx=(8, 0)) ok_btn = FancyButton(btn_frame, text=ok_text, command=self._on_ok, width=120 if dialog_type == "confirm" else 140, height=36, bg=cfg["color"], fg="white", hover_bg=self._darken(cfg["color"], 15), active_bg=self._darken(cfg["color"], 30), shadow_color=cfg["bg_light"], radius=8, font=("Microsoft YaHei", 9, "bold")) ok_btn.pack(side="right") # 回车确定 self.bind("<Return>", lambda e: self._on_ok()) if dialog_type == "confirm": self.bind("<Escape>", lambda e: self._on_cancel()) def _darken(self, hex_color, amount): """颜色变暗""" if not hex_color.startswith("#") or len(hex_color) != 7: return hex_color try: r = max(0, int(hex_color[1:3], 16) - amount) g = max(0, int(hex_color[3:5], 16) - amount) b = max(0, int(hex_color[5:7], 16) - amount) return f"#{r:02x}{g:02x}{b:02x}" except: return hex_color def _on_ok(self): self.result = True if self.on_ok: self.on_ok() self.destroy() def _on_cancel(self): self.result = False if self.on_cancel: self.on_cancel() self.destroy() def fancy_showinfo(master, title, message): """显示信息弹窗""" dlg = FancyDialog(master, title=title, message=message, dialog_type="info") master.wait_window(dlg) def fancy_showerror(master, title, message): """显示错误弹窗""" dlg = FancyDialog(master, title=title, message=message, dialog_type="error") master.wait_window(dlg) def fancy_showwarning(master, title, message): """显示警告弹窗""" dlg = FancyDialog(master, title=title, message=message, dialog_type="warning") master.wait_window(dlg) def fancy_askyesno(master, title, message, on_yes=None, on_no=None): """确认弹窗,返回 True/False""" result = {"value": False} def _yes(): result["value"] = True dlg = FancyDialog(master, title=title, message=message, dialog_type="confirm", on_ok=_yes, ok_text="确定", cancel_text="取消") master.wait_window(dlg) return result["value"] # ═══════════════════════════════════════════════ # 激活窗口 # ═══════════════════════════════════════════════ class AuthWindow(tk.Tk): def __init__(self): super().__init__() self.machine_code = generate_machine_code() self.key_code = "" self.is_trial = False self.expire_time = "" self.heartbeat_running = False self.heartbeat_thread = None self.main_window = None self.notice_text = "" # 软件公告内容 self.title("软件激活") self.resizable(False, False) self.configure(bg=BG) w, h = 400, 520 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() self.geometry(f"{w}x{h}+{(sw-w)//2}+{(sh-h)//2}") self.config_data = load_config() self._build_ui() self.bind("<Return>", lambda e: self.do_auth()) # 启动版本检查(自动登录会在版本检查后决定是否执行) self.after(300, self._check_version) def _check_version(self): """检查版本更新 + 获取公告""" has_update = False # ── 获取软件公告 ── try: notice_data = api_get("/api/client/notice", {"app_key": APP_KEY}) if notice_data.get("status") == "success": self.notice_text = notice_data.get("notice", "") except: pass # ── 版本检查(含强制更新) ── try: data = api_get("/api/client/version", { "app_key": APP_KEY, "current_version": CURRENT_VERSION, }) if data.get("status") == "success": latest = data.get("latest_version", "") tip = data.get("update_tip", "发现新版本") url = data.get("update_url", "") note = data.get("update_note", "") required = data.get("update_required", False) # 服务端判定:必须更新 if data.get("update_available"): has_update = True UpdateDialog( self, latest, tip, url, note, force=required, on_recheck=self._check_version, on_skip=None if required else self._try_auto_login, on_update=self._quit_for_update, ) # 强制更新且版本落后:锁死全部功能按钮,更新达标前无法激活/试用/加时/解绑 if required: self._lock_for_update(latest) except: pass # 没有更新(或版本已达标),直接尝试自动登录 if not has_update: self._try_auto_login() def _lock_for_update(self, latest): """强制更新锁定:禁用激活/试用/加时/解绑全部按钮,只允许完成更新""" self._set_buttons_enabled(False) self.status_label.config( text=f"⚠ 检测到新版本 v{latest},必须更新后才能使用", fg=ERROR) def _try_auto_login(self): """尝试自动登录""" if not self.config_data.get("auto_login"): return # 卡密自动登录 if self.config_data.get("key_code"): self._auto_login() return # 试用自动登录:先验证试用是否还有效 if self.config_data.get("is_trial"): self.status_label.config(text="正在验证试用状态...", fg=TEXT_SEC) self._set_buttons_enabled(False) def worker(): code, data = api_post("/api/client/trial/heartbeat", { "app_key": APP_KEY, "machine_code": self.machine_code, }) self.after(0, lambda: self._handle_trial_auto_login(code, data)) threading.Thread(target=worker, daemon=True).start() def _handle_trial_auto_login(self, code, data): """处理试用自动登录验证结果""" if code == 200 and data.get("status") == "success": # 试用有效,自动登录 self.is_trial = True self.heartbeat_running = True self.expire_time = data.get("expire_time", "") self.destroy() main = MainApp(self) self.start_heartbeat(main) main.mainloop() else: # 试用过期了,清除自动登录 save_config(key_code="", remember=False, auto_login=False, is_trial=False) self._set_buttons_enabled(True) self.status_label.config(text="试用已过期,请重新激活", fg=ERROR) def _quit_for_update(self): """点击立即更新后关闭程序""" self.destroy() def _build_ui(self): # ── 顶部紫色标题区 ── header = tk.Frame(self, bg=PRIMARY, height=120) header.pack(fill="x") header.pack_propagate(False) # Logo logo_frame = tk.Frame(header, bg=PRIMARY) logo_frame.pack(pady=(16, 4)) logo_bg = tk.Canvas(logo_frame, width=44, height=44, bg=PRIMARY, highlightthickness=0) logo_bg.pack() logo_bg.create_oval(2, 2, 42, 42, fill="white", outline="") logo_bg.create_text(22, 24, text="🔐", font=("Segoe UI Emoji", 18)) tk.Label(header, text="欢迎使用", font=("Microsoft YaHei", 13, "bold"), fg="white", bg=PRIMARY).pack() tk.Label(header, text="请输入卡密以激活软件", font=("Microsoft YaHei", 8), fg="#c7d2fe", bg=PRIMARY).pack(pady=(1, 0)) # ── 白色卡片 ── card = tk.Frame(self, bg="white") card.pack(fill="both", expand=True, padx=20, pady=(0, 8)) content = tk.Frame(card, bg="white") content.pack(fill="both", expand=True, padx=18, pady=12) # 标题 tk.Label(content, text="卡密激活", font=("Microsoft YaHei", 13, "bold"), fg=TEXT, bg="white").pack(anchor="w") tk.Label(content, text="输入您的卡密码开始使用", font=("Microsoft YaHei", 8), fg=TEXT_MUTE, bg="white").pack(anchor="w", pady=(2, 10)) # 1. 卡密输入框(在上面) self.key_entry = FancyEntry(content, placeholder="请输入卡密码", icon="🔑") self.key_entry.pack(fill="x", pady=(0, 8)) if self.config_data.get("remember") and self.config_data.get("key_code"): self.key_entry.set(self.config_data["key_code"]) # 2. 机器码(在下面) mc_wrap = tk.Frame(content, bg="#f1f5f9") mc_wrap.pack(fill="x", pady=(0, 10)) mc_inner = tk.Frame(mc_wrap, bg="#f1f5f9") mc_inner.pack(fill="x", padx=10, pady=6) tk.Label(mc_inner, text="💻", font=("Segoe UI Emoji", 10), bg="#f1f5f9").pack(side="left", padx=(0, 6)) tk.Label(mc_inner, text="机器码:", font=("Microsoft YaHei", 8), fg=TEXT_SEC, bg="#f1f5f9").pack(side="left") tk.Label(mc_inner, text=self.machine_code[:18] + "...", font=("Consolas", 9), fg=TEXT, bg="#f1f5f9").pack(side="left", padx=(2, 0)) copy_lbl = tk.Label(mc_inner, text="复制", font=("Microsoft YaHei", 8, "bold"), fg=PRIMARY, bg="#f1f5f9", cursor="hand2") copy_lbl.pack(side="right") copy_lbl.bind("<Button-1>", lambda e: self._copy_machine_code()) # 记住卡密 / 自动登录 opt_row = tk.Frame(content, bg="white") opt_row.pack(fill="x", pady=(0, 10)) self.remember_cb = FancyCheckbox(opt_row, text="记住卡密") self.remember_cb.set(self.config_data.get("remember", False)) self.remember_cb.pack(side="left") self.auto_cb = FancyCheckbox(opt_row, text="自动登录") self.auto_cb.set(self.config_data.get("auto_login", False)) self.auto_cb.pack(side="right") # 3. 立即激活 + 免费试用(一行两个按钮) btn_row = tk.Frame(content, bg="white") btn_row.pack(fill="x", pady=(0, 8)) self.auth_btn = FancyButton(btn_row, text="立即激活", command=self.do_auth, width=130, height=38, bg=PRIMARY, hover_bg=PRIMARY_DARK, active_bg="#3730a3", radius=8, icon="✨", font=("Microsoft YaHei", 9, "bold")) self.auth_btn.pack(side="left", fill="x", expand=True, padx=(0, 5)) self.trial_btn = FancyButton(btn_row, text="免费试用", command=self.do_trial, width=130, height=38, bg=PRIMARY, hover_bg=PRIMARY_DARK, active_bg="#3730a3", radius=8, icon="🎁", font=("Microsoft YaHei", 9, "bold")) self.trial_btn.pack(side="left", fill="x", expand=True, padx=(5, 0)) # 4. 充值卡密 + 自助解绑(一行两个按钮) bottom_btn_frame = tk.Frame(content, bg="white") bottom_btn_frame.pack(fill="x", pady=(0, 8)) self.recharge_btn = FancyButton(bottom_btn_frame, text="充值卡密", command=self.do_recharge, width=130, height=38, bg="#10b981", fg="white", hover_bg="#059669", active_bg="#047857", shadow_color="#a7f3d0", radius=8, icon="💰", font=("Microsoft YaHei", 9, "bold")) self.recharge_btn.pack(side="left", fill="x", expand=True, padx=(0, 5)) self.unbind_btn = FancyButton(bottom_btn_frame, text="自助解绑", command=self.do_unbind, width=130, height=38, bg="#f59e0b", fg="white", hover_bg="#d97706", active_bg="#b45309", shadow_color="#fde68a", radius=8, icon="🔓", font=("Microsoft YaHei", 9, "bold")) self.unbind_btn.pack(side="left", fill="x", expand=True, padx=(5, 0)) # 状态提示 self.status_label = tk.Label(content, text="", font=("Microsoft YaHei", 8), fg=TEXT_MUTE, bg="white") self.status_label.pack(pady=(4, 0)) # 5. 底部版本号 bottom = tk.Frame(self, bg=BG) bottom.pack(fill="x", pady=(0, 8)) tk.Label(bottom, text=f"版本号:{CURRENT_VERSION}", font=("Microsoft YaHei", 8), fg=TEXT_SEC, bg=BG).pack() def _copy_machine_code(self): self.clipboard_clear() self.clipboard_append(self.machine_code) self.status_label.config(text="✓ 机器码已复制到剪贴板", fg=SUCCESS) def do_recharge(self): """充值卡密 - 获取充值链接并打开""" self._set_buttons_enabled(False) self.status_label.config(text="正在获取充值链接...", fg=TEXT_MUTE) self.update() def worker(): data = api_get("/api/client/recharge", {"app_key": APP_KEY}) self.after(0, lambda: self._on_recharge_result(data)) threading.Thread(target=worker, daemon=True).start() def _on_recharge_result(self, data): self._set_buttons_enabled(True) if data.get("status") == "success": url = data.get("recharge_url", "") if url: webbrowser.open(url) self.status_label.config(text="✓ 已打开充值页面", fg=SUCCESS) else: self.status_label.config(text="⚠ 未获取到充值链接", fg=ERROR) else: msg = data.get("message", "获取失败") self.status_label.config(text=f"❌ {msg}", fg=ERROR) def do_unbind(self): """激活页的自助解绑""" key = self.key_entry.get().strip() if not key: self.status_label.config(text="⚠ 请先输入卡密", fg=ERROR) return def confirm_callback(): self.status_label.config(text="正在解绑...", fg=TEXT_SEC) self._set_buttons_enabled(False) self.update() def worker(): code, data = api_post("/api/client/unbind", { "app_key": APP_KEY, "key_code": key, "machine_code": self.machine_code, }) self.after(0, lambda: self._handle_unbind_result(code, data)) threading.Thread(target=worker, daemon=True).start() UnbindDialog(self, confirm_callback) def _handle_unbind_result(self, code, data): self._set_buttons_enabled(True) if code == 200 and data.get("status") == "success": remaining = data.get("remaining_unbinds", 0) limit = data.get("limit_30d", 0) fancy_showinfo(self, "解绑成功", f"设备解绑成功!\n剩余解绑次数: {remaining}/{limit}") self.status_label.config(text="✓ 解绑成功", fg=SUCCESS) else: msg = data.get("message", "解绑失败") self.status_label.config(text=f"✕ {msg}", fg=ERROR) def _auto_login(self): key = self.config_data.get("key_code", "") if key: # 演示模式:如果是演示卡密,直接模拟登录成功 if key == "DEMO_SHOW_UI": self.is_trial = False self.key_code = key self.heartbeat_running = True self.expire_time = "2026-10-12 23:59:59" self.destroy() main = MainApp(self) self.start_heartbeat(main) main.mainloop() else: self.key_entry.set(key) self.do_auth() def _set_buttons_enabled(self, enabled): state = tk.NORMAL if enabled else tk.DISABLED self.auth_btn.config(state=state) self.trial_btn.config(state=state) self.recharge_btn.config(state=state) self.unbind_btn.config(state=state) def do_auth(self): key = self.key_entry.get().strip() if not key: self.status_label.config(text="⚠ 请输入卡密码", fg=ERROR) return self.status_label.config(text="正在验证卡密...", fg=TEXT_SEC) self._set_buttons_enabled(False) self.update() def worker(): code, data = api_post("/api/client/auth", { "app_key": APP_KEY, "key_code": key, "machine_code": self.machine_code, "client_version": CURRENT_VERSION, # 上报版本:后台据此识别旧版/下发强制更新 }) self.after(0, lambda: self._handle_auth_result(code, data, key)) threading.Thread(target=worker, daemon=True).start() def _handle_auth_result(self, code, data, key): self._set_buttons_enabled(True) if code == 200 and data.get("status") == "success": # 强制更新:认证成功但版本落后(或被管理员单独标记)→ 锁死功能,先更新 app_info = data.get("app_info", {}) if app_info.get("update_required"): self._set_buttons_enabled(False) self.status_label.config( text=f"⚠ 当前版本 {CURRENT_VERSION} 已过期,必须更新到 v{app_info.get('latest_version', '')} 才能使用", fg=ERROR) UpdateDialog( self, app_info.get("latest_version", ""), "必须完成更新才能使用", app_info.get("update_url", ""), app_info.get("update_note", ""), force=True, on_recheck=lambda: self.do_auth(), # 更新完点「重新检测」重新认证 ) return self.key_code = key self.is_trial = False self.heartbeat_running = True key_info = data.get("key_info", {}) self.expire_time = key_info.get("expire_time", "") remember = self.remember_cb.get() auto_login = self.auto_cb.get() save_config(key_code=key if remember else "", remember=remember, auto_login=auto_login, is_trial=False) self.status_label.config(text="✓ 激活成功,正在进入...", fg=SUCCESS) self.update() time.sleep(0.5) self.destroy() main = MainApp(self) self.start_heartbeat(main) main.mainloop() else: msg = data.get("message", "验证失败") self.status_label.config(text=f"✕ {msg}", fg=ERROR) def do_trial(self): self.status_label.config(text="正在申请试用...", fg=TEXT_SEC) self._set_buttons_enabled(False) self.update() def worker(): code, data = api_post("/api/client/trial", { "app_key": APP_KEY, "machine_code": self.machine_code, "client_version": CURRENT_VERSION, # 上报版本(后台识别旧版) }) self.after(0, lambda: self._handle_trial_result(code, data)) threading.Thread(target=worker, daemon=True).start() def _handle_trial_result(self, code, data): self._set_buttons_enabled(True) if code == 200 and data.get("status") == "success": self.is_trial = True self.heartbeat_running = True self.expire_time = data.get("expire_time", "") # 保存自动登录状态 remember = self.remember_cb.get() auto = self.auto_cb.get() save_config(key_code="", remember=remember, auto_login=auto, is_trial=True) self.status_label.config(text="✓ 试用开启成功", fg=SUCCESS) self.update() time.sleep(0.5) self.destroy() main = MainApp(self) self.start_heartbeat(main) main.mainloop() else: msg = data.get("message", "试用不可用") self.status_label.config(text=f"✕ {msg}", fg=ERROR) def start_heartbeat(self, main_window=None): self.main_window = main_window def _loop(): while self.heartbeat_running: time.sleep(HEARTBEAT_INTERVAL) if not self.heartbeat_running: break try: if self.is_trial: code, data = api_post("/api/client/trial/heartbeat", { "app_key": APP_KEY, "machine_code": self.machine_code, "client_version": CURRENT_VERSION, # 上报版本 }) else: code, data = api_post("/api/client/heartbeat", { "app_key": APP_KEY, "key_code": self.key_code, "machine_code": self.machine_code, "client_version": CURRENT_VERSION, # 上报版本(后台识别旧版/强制更新) }) if code == 200 and data.get("status") == "success": # 管理员单独公告:弹窗展示(一次性) if data.get("notice") and self.main_window: notice_text = data.get("notice") self.main_window.after(0, lambda: AdminNoticeDialog(self.main_window, notice_text)) # ── 强制更新:管理员后台下发,或版本落后且应用开启强制更新 ── if data.get("update_required"): self.heartbeat_running = False def _lock_ui(): # 锁死主窗口:禁用一切交互,弹出不可跳过的更新窗 try: for child in self.main_window.winfo_children(): pass # 主窗口内容保留但被更新窗全屏遮挡 self.main_window.attributes("-disabled", True) except: pass UpdateDialog( self.main_window, data.get("latest_version", ""), "管理员要求必须更新才能继续使用", data.get("update_url", ""), data.get("update_note", ""), force=True, on_recheck=self.start_heartbeat, # 更新完重新心跳验证 on_update=self._quit_for_update, ) self.main_window.protocol("WM_DELETE_WINDOW", lambda: None) self.main_window.after(0, _lock_ui) break # 心跳成功,更新到期时间 + 剩余解绑次数显示 new_expire = data.get("expire_time", "") if new_expire: self.expire_time = new_expire if self.main_window: try: self.main_window.after(0, lambda: self.main_window.update_expire_time(new_expire)) except: pass if self.main_window and data.get("unbind_remaining") is not None: ub_left = data.get("unbind_remaining") ub_total = data.get("unbind_limit", 3) try: self.main_window.after(0, lambda: self.main_window.update_unbind_left(ub_left, ub_total)) except: pass elif code == 0 or code >= 500: # 网络异常 / 服务器错误:可重试,不要踢用户下线,下个心跳周期再试 continue else: # 服务器明确拒绝(禁用/过期/未授权等)→ 授权失效,退出到登录窗 self.heartbeat_running = False msg = data.get("message", "授权已失效") if self.main_window: try: self.main_window.after(0, lambda: self.main_window.on_auth_lost(msg)) except: pass break except: pass self.heartbeat_thread = threading.Thread(target=_loop, daemon=True) self.heartbeat_thread.start() class AdminNoticeDialog(tk.Toplevel): """管理员单独公告弹窗(后台「设备管理 → 详情 → 发公告」下发,一次性展示)""" def __init__(self, master, content): super().__init__(master) self.title("管理员公告") self.resizable(False, False) self.configure(bg=BG) self.transient(master) self.grab_set() w, h = 380, 240 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() self.geometry(f"{w}x{h}+{(sw-w)//2}+{(sh-h)//2}") header = tk.Frame(self, bg="#b45309", height=56) header.pack(fill="x") header.pack_propagate(False) tk.Label(header, text="📢 管理员公告", font=("Microsoft YaHei", 11, "bold"), fg="white", bg="#b45309").pack(expand=True) body = tk.Frame(self, bg="white") body.pack(fill="both", expand=True, padx=16, pady=(10, 12)) tk.Label(body, text=content, font=("Microsoft YaHei", 9), fg="#334155", bg="white", wraplength=330, justify="left").pack(anchor="w", pady=(0, 10)) ok_btn = FancyButton(body, text="我知道了", command=self.destroy, width=120, height=34, bg="#b45309", fg="white", hover_bg="#92400e", active_bg="#78350f", radius=8, font=("Microsoft YaHei", 9, "bold")) ok_btn.pack() self.update_idletasks() mx = master.winfo_rootx() + (master.winfo_width() - w) // 2 my = master.winfo_rooty() + (master.winfo_height() - h) // 2 self.geometry(f"+{mx}+{my}") # ═══════════════════════════════════════════════ # 主程序窗口 # ═══════════════════════════════════════════════ class MainApp(tk.Tk): def __init__(self, auth): super().__init__() self.auth = auth self.title("软件主程序") self.resizable(False, False) self.configure(bg=BG) w, h = 440, 640 sw, sh = self.winfo_screenwidth(), self.winfo_screenheight() self.geometry(f"{w}x{h}+{(sw-w)//2}+{(sh-h)//2}") self._build_ui() self.protocol("WM_DELETE_WINDOW", self.on_close) # 启动上报:累计打开次数 + 接收管理员单独公告/强制更新(见 /api/client/launch) self.after(600, self._report_launch) # 加载公告 self._load_notice() def _build_ui(self): # ── 顶部渐变紫色标题区 ── header = tk.Frame(self, bg=PRIMARY, height=140) header.pack(fill="x") header.pack_propagate(False) # 装饰性光晕 deco = tk.Canvas(header, width=440, height=140, bg=PRIMARY, highlightthickness=0) deco.place(x=0, y=0) deco.create_oval(350, -30, 480, 80, fill=PRIMARY_LIGHT, outline="") deco.create_oval(-40, 60, 80, 160, fill=PRIMARY_DARK, outline="") # Logo logo_frame = tk.Frame(header, bg=PRIMARY) logo_frame.pack(pady=(18, 4)) logo_bg = tk.Canvas(logo_frame, width=56, height=56, bg=PRIMARY, highlightthickness=0) logo_bg.pack() logo_bg.create_oval(2, 2, 54, 54, fill="white", outline="") logo_bg.create_text(28, 30, text="🚀", font=("Segoe UI Emoji", 22)) tk.Label(header, text="软件主程序", font=("Microsoft YaHei", 15, "bold"), fg="white", bg=PRIMARY).pack() tk.Label(header, text="TG炒群机器人 · 智能高效", font=("Microsoft YaHei", 8), fg="#c7d2fe", bg=PRIMARY).pack(pady=(2, 0)) # ── 白色卡片:授权信息 ── card = tk.Frame(self, bg="white") card.pack(fill="both", expand=True, padx=20, pady=(0, 10)) # 状态徽章(悬浮在卡片顶部) mode_text = "试用模式" if self.auth.is_trial else "已激活" mode_color = "#8b5cf6" if self.auth.is_trial else SUCCESS mode_bg = "#f5f3ff" if self.auth.is_trial else "#ecfdf5" badge_wrap = tk.Frame(card, bg="white") badge_wrap.pack(fill="x", pady=(14, 8)) badge = tk.Frame(badge_wrap, bg=mode_bg) badge.pack(anchor="center") tk.Label(badge, text=f"● {mode_text}", font=("Microsoft YaHei", 9, "bold"), fg=mode_color, bg=mode_bg).pack(padx=20, pady=5) content = tk.Frame(card, bg="white") content.pack(fill="both", expand=True, padx=22, pady=(0, 14)) # 公告区域 notice_wrap = tk.Frame(content, bg="#f5f3ff") notice_wrap.pack(fill="x", pady=(0, 16)) # 左侧紫色装饰条 tk.Frame(notice_wrap, bg=PRIMARY, width=4).pack(side="left", fill="y") notice_inner = tk.Frame(notice_wrap, bg="#f5f3ff") notice_inner.pack(side="left", fill="both", expand=True) notice_content = tk.Frame(notice_inner, bg="#f5f3ff") notice_content.pack(fill="x", padx=12, pady=10) # 顶部:图标 + 标题 notice_header = tk.Frame(notice_content, bg="#f5f3ff") notice_header.pack(fill="x", pady=(0, 6)) # 图标背景圆 icon_canvas = tk.Canvas(notice_header, width=26, height=26, bg="#f5f3ff", highlightthickness=0) icon_canvas.pack(side="left", padx=(0, 8)) icon_canvas.create_oval(1, 1, 25, 25, fill=PRIMARY, outline="") icon_canvas.create_text(13, 15, text="📢", font=("Segoe UI Emoji", 11)) tk.Label(notice_header, text="信息公告", font=("Microsoft YaHei", 10, "bold"), fg=PRIMARY, bg="#f5f3ff").pack(side="left") tk.Label(notice_header, text="OFFICIAL", font=("Consolas", 7, "bold"), fg="#a5b4fc", bg="#f5f3ff").pack(side="right") # 公告内容 self.notice_label = tk.Label(notice_content, text="加载中...", font=("Microsoft YaHei", 9), fg="#4c1d95", bg="#f5f3ff", wraplength=300, justify="left") self.notice_label.pack(fill="x") # 标题:授权信息 info_header = tk.Frame(content, bg="white") info_header.pack(fill="x", pady=(0, 10)) tk.Label(info_header, text="授权信息", font=("Microsoft YaHei", 13, "bold"), fg=TEXT, bg="white").pack(side="left") tk.Label(info_header, text="AUTH INFO", font=("Consolas", 7, "bold"), fg=TEXT_MUTE, bg="white").pack(side="right", pady=(6, 0)) # 信息行 - 卡片式 self._build_info_card(content, "机器码", self.auth.machine_code[:22] + "...", TEXT, copy_btn=True, copy_text=self.auth.machine_code, icon="💻") self._build_info_card(content, "卡密信息", "免费试用" if self.auth.is_trial else (self.auth.key_code[:14] + "..."), PRIMARY if not self.auth.is_trial else "#8b5cf6", icon="🔑") self.expire_label = self._build_info_card( content, "到期时间", format_expire_time(self.auth.expire_time), WARNING, icon="⏰") # 分割线 tk.Frame(content, bg=BORDER, height=1).pack(fill="x", pady=14) # 卡密加时区域(仅已激活用户显示) if not self.auth.is_trial: recharge_section = tk.Frame(content, bg="#f0fdf4") recharge_section.pack(fill="x", pady=(0, 12)) tk.Frame(recharge_section, bg=SUCCESS, width=4).pack(side="left", fill="y") recharge_inner = tk.Frame(recharge_section, bg="#f0fdf4") recharge_inner.pack(side="left", fill="both", expand=True, padx=12, pady=10) recharge_title = tk.Frame(recharge_inner, bg="#f0fdf4") recharge_title.pack(fill="x", pady=(0, 8)) tk.Label(recharge_title, text="⏳ 卡密加时", font=("Microsoft YaHei", 10, "bold"), fg=SUCCESS, bg="#f0fdf4").pack(side="left") tk.Label(recharge_title, text="叠加时长", font=("Consolas", 7, "bold"), fg="#6ee7b7", bg="#f0fdf4").pack(side="right", pady=(3, 0)) recharge_row = tk.Frame(recharge_inner, bg="#f0fdf4") recharge_row.pack(fill="x") self.recharge_entry = FancyEntry(recharge_row, placeholder="输入新卡密叠加时长", icon="🎫") self.recharge_entry.pack(side="left", fill="x", expand=True, padx=(0, 8)) self.recharge_btn = FancyButton(recharge_row, text="加时", command=self.do_recharge_key, width=70, height=36, bg=SUCCESS, fg="white", hover_bg="#059669", active_bg="#047857", shadow_color="#a7f3d0", radius=8, font=("Microsoft YaHei", 9, "bold")) self.recharge_btn.pack(side="right") # 操作按钮区 btn_row = tk.Frame(content, bg="white") btn_row.pack(fill="x") if not self.auth.is_trial: unbind_btn = FancyButton(btn_row, text="解绑机器码", command=self.do_unbind, width=140, height=40, bg="white", fg=WARNING, hover_bg="#fffbeb", active_bg="#fef3c7", shadow_color="#fef3c7", radius=8, icon="🔓", font=("Microsoft YaHei", 9, "bold")) unbind_btn.pack(side="left", fill="x", expand=True, padx=(0, 6)) logout_btn = FancyButton(btn_row, text="退出登录", command=self.do_logout, width=140, height=40, bg="white", fg=ERROR, hover_bg="#fef2f2", active_bg="#fee2e2", shadow_color="#fee2e2", radius=8, icon="🚪", font=("Microsoft YaHei", 9, "bold")) logout_btn.pack(side="left", fill="x", expand=True, padx=(6, 0)) else: tk.Label(content, text="🎁 试用模式不支持设备解绑", font=("Microsoft YaHei", 8), fg=TEXT_MUTE, bg="white").pack(pady=6) # ── 底部版本号 ── bottom = tk.Frame(self, bg=BG) bottom.pack(fill="x", pady=(0, 10)) tk.Label(bottom, text=f"版本号:{CURRENT_VERSION}", font=("Microsoft YaHei", 8), fg=TEXT_SEC, bg=BG).pack() def _build_info_card(self, parent, label, value, value_color, copy_btn=False, copy_text="", icon=""): """创建一个卡片式信息行,返回值标签引用""" card = tk.Frame(parent, bg="#f8fafc", highlightbackground=BORDER, highlightthickness=1) card.pack(fill="x", pady=5) inner = tk.Frame(card, bg="#f8fafc") inner.pack(fill="x", padx=12, pady=9) # 图标 if icon: tk.Label(inner, text=icon, font=("Segoe UI Emoji", 12), bg="#f8fafc").pack(side="left", padx=(0, 8)) tk.Label(inner, text=label, font=("Microsoft YaHei", 8), fg=TEXT_MUTE, bg="#f8fafc").pack(side="left") value_label = tk.Label(inner, text=value, font=("Consolas", 9, "bold"), fg=value_color, bg="#f8fafc") value_label.pack(side="right") if copy_btn: copy_lbl = tk.Label(inner, text="复制", font=("Microsoft YaHei", 8, "bold"), fg=PRIMARY, bg="#f8fafc", cursor="hand2") copy_lbl.pack(side="right", padx=(0, 8)) copy_lbl.bind("<Button-1>", lambda e: self._copy_to_clipboard(copy_text)) return value_label def _copy_to_clipboard(self, text): self.clipboard_clear() self.clipboard_append(text) def do_recharge_key(self): """卡密加时 - 用新卡密叠加时长""" new_key = self.recharge_entry.get().strip() if not new_key: fancy_showwarning(self, "提示", "请输入要叠加的新卡密") return self.recharge_btn.config(state=tk.DISABLED) def worker(): code, data = api_post("/api/client/recharge-key", { "app_key": APP_KEY, "key_code": self.auth.key_code, "recharge_key": new_key, "machine_code": self.auth.machine_code, }) self.after(0, lambda: self._on_recharge_key_result(code, data)) threading.Thread(target=worker, daemon=True).start() def _on_recharge_key_result(self, code, data): self.recharge_btn.config(state=tk.NORMAL) if code == 200 and data.get("status") == "success": new_expire = data.get("new_expire_time", "") added_days = data.get("added_days", 0) # 更新显示 self.expire_label.config(text=format_expire_time(new_expire)) # 同步到 auth 对象 self.auth.expire_time = new_expire fancy_showinfo(self, "加时成功", f"时长已叠加成功!\n增加:{added_days} 天\n新到期时间:{format_expire_time(new_expire)}") self.recharge_entry.set("") else: msg = data.get("message", "加时失败") fancy_showerror(self, "加时失败", msg) def _load_notice(self): """加载公告""" def worker(): try: data = api_get("/api/client/notice", {"app_key": APP_KEY}) if data.get("status") == "success": notice = data.get("notice", "") self.after(0, lambda: self._update_notice(notice)) except: pass threading.Thread(target=worker, daemon=True).start() def _update_notice(self, notice): """更新公告显示""" if hasattr(self, 'notice_label') and notice: self.notice_label.config(text=notice) def update_unbind_left(self, remaining, total): """更新剩余解绑次数显示""" if hasattr(self, 'unbind_left_label'): self.unbind_left_label.config( text=f"🔓 剩余自助解绑:{remaining} / {total} 次", fg=("#16a34a" if remaining > 0 else "#dc2626")) def _report_launch(self): """启动上报:累计打开次数 + 接收管理员单独公告/强制更新状态(每次打开软件调用一次)""" key_code = getattr(self.auth, "key_code", "") if not key_code: return def worker(): code, data = api_post("/api/client/launch", { "app_key": APP_KEY, "key_code": key_code, "machine_code": self.auth.machine_code, "client_version": CURRENT_VERSION, }) self.after(0, lambda: self._handle_launch_result(code, data)) threading.Thread(target=worker, daemon=True).start() def _handle_launch_result(self, code, data): if code == 200 and data.get("status") == "success": # 管理员单独公告:弹窗展示(一次性) if data.get("notice"): notice_text = data.get("notice") AdminNoticeDialog(self, notice_text) # 强制更新:锁死主窗口,必须更新后才能使用 if data.get("update_required"): self.attributes("-disabled", True) UpdateDialog( self, data.get("latest_version", ""), "管理员要求必须更新才能继续使用", data.get("update_url", ""), data.get("update_note", ""), force=True, on_recheck=self._report_launch, # 更新完重新上报验证 on_update=self._quit_for_update, ) def update_expire_time(self, expire_time): """更新到期时间显示""" if hasattr(self, 'expire_label'): self.expire_label.config(text=format_expire_time(expire_time)) def do_unbind(self): def confirm_callback(): def worker(): code, data = api_post("/api/client/unbind", { "app_key": APP_KEY, "key_code": self.auth.key_code, "machine_code": self.auth.machine_code, }) self.after(0, lambda: self._handle_unbind_result(code, data)) threading.Thread(target=worker, daemon=True).start() UnbindDialog(self, confirm_callback) def _handle_unbind_result(self, code, data): if code == 200 and data.get("status") == "success": remaining = data.get("remaining_unbinds", 0) limit = data.get("limit_30d", 0) fancy_showinfo(self, "解绑成功", f"设备解绑成功!\n剩余解绑次数: {remaining}/{limit}") # 解绑成功后清除记住的卡密和自动登录 save_config(key_code="", remember=False, auto_login=False) self.auth.heartbeat_running = False self.destroy() app = AuthWindow() app.mainloop() else: msg = data.get("message", "解绑失败") fancy_showerror(self, "解绑失败", msg) def do_logout(self): if not fancy_askyesno(self, "确认", "确定要退出登录吗?"): return save_config(key_code="", remember=False, auto_login=False) self.auth.heartbeat_running = False self.destroy() app = AuthWindow() app.mainloop() def on_close(self): self.auth.heartbeat_running = False self.destroy() def on_auth_lost(self, message="授权已失效"): self.auth.heartbeat_running = False fancy_showwarning(self, "授权失效", f"{message}\n\n软件将退出,请重新激活。") save_config(key_code="", remember=False, auto_login=False) self.destroy() app = AuthWindow() app.mainloop() # ═══════════════════════════════════════════════ # 启动 # ═══════════════════════════════════════════════ if __name__ == "__main__": try: from ctypes import windll windll.shcore.SetProcessDpiAwareness(1) except: pass app = AuthWindow() app.mainloop()
12 安全与输入规范

服务端对所有接口入参做「格式校验 + 注入检测」两层把关。客户端只要按本规范传参,就不会被误拦; 如果收到 422 / 403,请对照本章排查客户端代码。

一、各字段允许的字符集(不符合直接返回 422)
参数允许字符长度示例
app_key 字母、数字、下划线 _、连字符 - 1 ~ 64 a1B2c3D4e5F6g7H8
key_code 字母、数字(不含 0 1 I O,卡密生成时已规避) 1 ~ 64 84YA2A9S5MVMA4BJ
machine_code 字母、数字、点 .、下划线 _、连字符 - 1 ~ 64 A1B2C3D4E5F6.7A8B9C0D
client_version 数字与点,形如 1.0 / 2.3.1,最多 4 段 ≤ 24 1.0.2
ip_address 十六进制字符、点 .、冒号 :(IPv4 / IPv6) ≤ 45 203.0.113.7
⚠️
机器码请务必做编码处理。机器码是「硬件特征拼接」时最容易出问题的一环: 如果拼接结果里带了 '、"、<、>、空格、中文或换行, 就会因为不符合上表字符集而返回 422。推荐做法:拼接硬件特征后取 SHA256 / MD5 摘要再上传。
二、注入检测:命中特征直接 403

入参会做注入特征匹配,命中以下任意一类即直接拦截,接口返回 403,同时把来源 IP、IP 归属地、 访问路径、原始载荷、User-Agent 一并写入后台「安全中心 → 注入动向记录」:

类型典型特征
SQL 注入单引号 '、--、UNION SELECT、OR 1=1、sleep(、information_schema
XSS / 脚本注入<script、<img、onerror=、javascript:、eval(、document.cookie
命令注入;、|、&&、$(、wget、curl、/etc/passwd
路径穿越../、..\、%2e%2e%2f
HTTP 403 {"status": "error", "message": "检测到非法输入,已被安全拦截并记录"}
客户端遇到该错误时不要重试(重试只会继续被拦截并留痕),应当检查是哪个字段把用户输入原样透传了。 常见错误:把用户输入的卡密/机器码直接塞进参数、把用户昵称或备注当作 machine_code 上传。
三、公告内容契约:只保证纯文本

GET /api/client/notice 以及认证、心跳接口返回的 notice 字段, 服务端会做净化后才下发:剥离全部 HTML 标签、去掉 javascript: / vbscript: / data:text/html 协议与 on*= 事件属性、剔除控制字符,并截断到 500 字(保留中文、标点与换行)。

🛡️
请把 notice 当作纯文本展示(Label / MessageBox / 只读文本框)。 不要用 WebView、富文本框或 innerHTML 直接渲染服务端返回的内容, 否则一旦服务端净化规则出现遗漏,脚本会在你的用户电脑上执行。
四、频率限制(按来源 IP 计算,超限返回 429)
接口限制
GET /api/client/version120 次 / 分钟
GET /api/client/notice120 次 / 分钟
GET /api/client/recharge120 次 / 分钟
POST /api/client/auth10 次 / 分钟
POST /api/client/trial5 次 / 分钟
POST /api/client/launch10 次 / 分钟
POST /api/client/heartbeat30 次 / 分钟
POST /api/client/trial/heartbeat30 次 / 分钟
POST /api/client/unbind5 次 / 分钟
POST /api/client/recharge-key10 次 / 分钟
正常客户端按 5 分钟心跳绝无压力。请勿把认证接口放在循环里做"保活",也请勿让多个用户共用同一个出口 IP 高频轮询 —— 例如同机房多台机器共用 NAT 出口时,建议错峰或做本地缓存。
五、响应格式约定

所有接口(含参数校验失败)都返回统一的 JSON 结构,客户端只需读 message 即可拿到可展示的中文提示:

{ "status": "error", "message": "machine_code 参数不合法:仅允许字母/数字/._-,长度 1-64" }
判断成功与否请以 HTTP 状态码 为准(2xx 为成功),不要只判断 status 字段。
13 错误码参考

所有接口的错误响应统一格式(含参数校验失败):

{ "status": "error", "message": "具体错误描述" }
HTTP状态码message触发场景
400缺少必要参数:{field}必填参数未传
400卡密与应用不匹配卡密不属于该应用
400请求数据格式错误请求体不是合法 JSON(如手工拼接字符串漏了引号)
400参数超出允许范围数值参数超出允许范围(如超大整数)
403卡密已过期,请去官方重新购买超过卡密有效期
403卡密已被管理员禁止使用管理员在后台禁用了卡密
403设备数量已达上限(N台)绑定设备超过卡密限制
403试用已到期,请输入卡密继续使用免费试用过期
403该应用未开启免费试用应用未开启试用功能
403设备未授权,请先认证心跳时设备未绑定
403该应用未开启自助解绑功能调用解绑接口但应用未开启
40330天内解绑次数已达上限(N次)超过30天解绑次数限制
403检测到非法输入,已被安全拦截并记录入参含 SQL 注入 / XSS / 命令注入 / 路径穿越特征,详见第 12 章
404设备未绑定解绑的设备不存在绑定关系
404应用密钥无效app_key 不存在
404卡密不存在key_code 不存在
422缺少必要参数:{field}必填字段未提交(服务端校验阶段拒绝)
422{field} 参数不合法:{原因}字段字符集或长度不符合第 12 章规则,如机器码含空格/引号/中文
429请求过于频繁,请稍后再试超过频率限制,见第 12 章第四节
💡
排错建议:先在浏览器或 Postman 里用同一份参数复现一次,再对照 422 的 message 定位到具体字段。 422 一定是参数本身的问题,403「检测到非法输入」一定是参数里带了攻击特征字符,两者都不是服务端故障,重试无效。
14 注意事项与最佳实践
1. 卡密首次使用自动激活,有效期从激活时刻开始计算,非从创建时间算起。
2. 心跳间隔建议 5 分钟,过短会增加服务器压力,过长可能导致在线状态判断不准确。
3. 心跳返回 403 时,应立即停止软件运行,提示用户卡密已过期或被禁用。
4. 同一设备多次认证不增加设备计数,仅更新心跳时间。
5. 所有时间字段均为北京时间(UTC+8)。
6. 频率限制:认证、启动上报、卡密加时 10次/分钟,试用 5次/分钟,心跳、试用心跳 30次/分钟,解绑 5次/分钟,版本/公告/充值链接 120次/分钟(完整清单见第 12 章)。
7. 建议客户端对网络请求做超时处理(10秒),避免网络异常导致界面卡死。
8. 机器码应持久化保存,避免每次启动都不同。建议组合多个硬件特征值取 MD5。
9. 自助解绑功能需应用管理员在后台开启,每张卡密30天内有次数限制(默认3次)。
10. 设备绑定限制以卡密为单位,同一卡密可绑定的设备数由卡密的 device_limit 字段决定。
11. 永久卡(key_type=permanent)的 expire_time 为空,永不过期,心跳和认证时跳过过期检查。但永久卡不能使用卡密加时功能。
12. 机器码、卡密、应用密钥不要携带引号、尖括号、空格、中文或换行。机器码建议由硬件特征拼接后取 SHA256/MD5 摘要,既稳定又天然满足字符集要求(详见第 12 章)。
13. 收到 422 说明参数格式不合规、收到 403「检测到非法输入」 说明参数里带了攻击特征字符。两者都不要重试,应定位是哪个字段把用户输入原样透传了。
14. 公告 notice 只保证是纯文本,请用 Label / MessageBox / 只读文本框展示,不要用 WebView 或 innerHTML 渲染服务端返回的任何字段。
15. 所有外部输入(卡密输入框、用户昵称、反馈内容等)在提交前都应做本地字符集约束,既提升体验,也避免把畸形数据传到服务端被拦截、并在安全中心留下攻击记录。
16. 判断接口是否成功请以 HTTP 状态码 为准(2xx 成功),不要只判断响应体里的 status 字段。