v1.3.5

坤支付 KunPay v1.3.5

✨ 新增(安卓监控APP): 挂机可靠性全家桶

• 扫码配对后自动连接: 手机扫管理后台「扫码配对」二维码 → 自动填入并直连平台,
  授权齐全时监控自动启动,全程零手动输入;并修复 APP 开着时再次扫码不生效的问题
• 开机自启: 手机重启后监控自动恢复(云手机 7×24 挂机刚需)
• 看门狗闹钟: 每 5 分钟一次可穿越休眠的拉活闹钟(正常心跳每 30 秒续期),
  进程被系统杀掉后最多 5 分钟自动复活
• 划掉自动拉活: 从最近任务划掉 APP 时立即重新拉起监控
• 「必要授权」卡新增说明:已配置的设备支持开机自启 · 断开自动重连 · 意外被杀自动拉活

🛡 挂机稳定性体系(v1.3.2 ~ v1.3.5 累积)

风险场景	对策
聚合通知 "[10条]" 被当成金额	三级回退金额提取(v1.3.2)
系统断开通知监听(静默失聪)	自动重连 + 状态可视化(v1.3.3)
用户漏授权导致收不到	授权门禁:缺项点名,补齐自动启动(v1.3.4)
手机重启 / 进程被杀 / 划掉任务	开机自启 + 看门狗 + 划掉拉活(v1.3.5)

⬇ 升级监控APP(二选一)

• APP 内会自动提示「发现新版本 v1.3.5」→ 点「下载更新」
• 或直接下载下方 KunPayMonitor.apk 覆盖安装(配置自动保留)

⬇ 下载与部署

curl -fsSL https://raw.githubusercontent.com/kungec/kunpay/main/scripts/install.sh | bash

文件	用途
kunpay_linux_amd64.tar.gz / kunpay_linux_arm64.tar.gz	Linux 服务器
kunpay_windows_amd64.zip / kunpay_windows_arm64.zip	Windows
kunpay_darwin_amd64.tar.gz / kunpay_darwin_arm64.tar.gz	macOS
KunPayMonitor.apk	安卓监控APP
kunpay-v1.3.5-all.zip	全部产物打包

平台主程序(服务端)本版无代码变更,服务端无需升级;只需升级手机上的监控APP。

全部提交

Full Changelog: v1.3.4...v1.3.5

v1.3.4

坤支付 KunPay v1.3.4

✨ 新增(安卓监控APP): 授权启动门禁

• 三项授权不齐,监控不启动:通知使用权 / 允许通知 / 电池白名单全部完成后才会开始监控,
  从此不会再出现"没授权也显示在线、实际收不到"的迷惑状态
• 缺哪项、点名哪项:缺授权时「必要授权」卡显示黄色提示
  「⚠ 监控未启动 —— 还差: ①通知使用权、②电池白名单」(动态点名缺失项)
• 补齐即自动启动:用户完成授权后 5 秒内监控自动开始,无需重启APP
  (模拟器全流程实测:缺三项拦截 → 逐项授权 → 自动启动心跳上线)
• 电池白名单按钮状态化(已授权显示绿色 ✓)

💡 关于"能不能自动授权"

电池优化白名单受安卓安全模型限制,无法静默自动授予(否则任何APP都能偷偷给自己加白名单)。
但本版点击「③ 电池白名单」按钮会直接弹出系统确认框,用户点一次「允许」即完成,
无需到设置页翻找;通知使用权同理一键直达系统开关页。

⬇ 升级监控APP(二选一)

• APP 内会自动提示「发现新版本 v1.3.4」→ 点「下载更新」
• 或直接下载下方 KunPayMonitor.apk 覆盖安装(配置自动保留)

⬇ 下载与部署

curl -fsSL https://raw.githubusercontent.com/kungec/kunpay/main/scripts/install.sh | bash

文件	用途
kunpay_linux_amd64.tar.gz / kunpay_linux_arm64.tar.gz	Linux 服务器
kunpay_windows_amd64.zip / kunpay_windows_arm64.zip	Windows
kunpay_darwin_amd64.tar.gz / kunpay_darwin_arm64.tar.gz	macOS
KunPayMonitor.apk	安卓监控APP
kunpay-v1.3.4-all.zip	全部产物打包

平台主程序(服务端)本版无代码变更,服务端无需升级;只需升级手机上的监控APP。

全部提交

Full Changelog: v1.3.3...v1.3.4

v1.3.3

坤支付 KunPay v1.3.3

🛠 修复(安卓监控APP,挂机用户必升)

• 严重: 挂机一段时间后收款无反应——系统省电策略会单独断开通知监听绑定,
  此时进程/心跳仍在线、APP 显示"设备在线",但通知再也收不到(静默失聪)
• 新增自动重连: 系统一断开监听,APP 立即重新请求绑定(requestRebind)
• 兜底保险: 每 10 次心跳(约 5 分钟)重申一次监听绑定
• 状态可视化: 顶部卡片显示「监听正常」;监听被断开时变为黄色
  「⚠ 监听已断开,重连中」,日志同步记录断开与重连事件,不再静默

⬇ 升级监控APP(二选一)

• APP 内会自动提示「发现新版本 v1.3.3」→ 点「下载更新」
• 或直接下载下方 KunPayMonitor.apk 覆盖安装(配置自动保留)

⬇ 下载与部署

curl -fsSL https://raw.githubusercontent.com/kungec/kunpay/main/scripts/install.sh | bash

文件	用途
kunpay_linux_amd64.tar.gz / kunpay_linux_arm64.tar.gz	Linux 服务器
kunpay_windows_amd64.zip / kunpay_windows_arm64.zip	Windows
kunpay_darwin_amd64.tar.gz / kunpay_darwin_arm64.tar.gz	macOS
KunPayMonitor.apk	安卓监控APP
kunpay-v1.3.3-all.zip	全部产物打包

平台主程序(服务端)本版无代码变更,服务端无需升级;只需升级手机上的监控APP。

💡 挂机稳定性小贴士

• 把监控APP加入电池优化白名单(APP 内「必要授权」第 2 步有入口)
• 部分国产 ROM(小米/OPPO/vivo 等)还需在系统设置中允许自启动
• 升级 v1.3.3 后若再遇到"没反应",先看顶部状态卡:若显示
  「⚠ 监听已断开」说明系统拦截强度很高,请重新开关一次「通知使用权」

全部提交

Full Changelog: v1.3.2...v1.3.3

v1.3.2

坤支付 KunPay v1.3.2

🛠 修复(安卓监控APP,建议所有用户升级)

• 严重: 微信「收款助手」聚合通知的标题含 "[10条]" 聚合计数,旧版解析把 "10条" 当成金额上报 ¥10,导致真实到账(如 ¥0.01)无法匹配订单、收银台支付后不跳转
• 金额提取改为三级回退:① "N元" 后缀(真实到账通知标准格式)→ ② "¥/￥" 前缀 → ③ 关键词就近取数(排除 条/个/位/笔 等聚合计数单位)
• 12 个真实通知样例回归测试全过(聚合通知 / 千分位 / 无小数 / 纯符号格式)

⬇ 升级监控APP(二选一)

• APP 内会自动提示「发现新版本 v1.3.2」→ 点「下载更新」
• 或直接下载下方 KunPayMonitor.apk 覆盖安装(服务器地址与 Token 无需重新配置)

⬇ 下载与部署

curl -fsSL https://raw.githubusercontent.com/kungec/kunpay/main/scripts/install.sh | bash

文件	用途
kunpay_linux_amd64.tar.gz / kunpay_linux_arm64.tar.gz	Linux 服务器
kunpay_windows_amd64.zip / kunpay_windows_arm64.zip	Windows
kunpay_darwin_amd64.tar.gz / kunpay_darwin_arm64.tar.gz	macOS
KunPayMonitor.apk	安卓监控APP
kunpay-v1.3.2-all.zip	全部产物打包

平台主程序(服务端)本版无代码变更,服务端无需升级;只需升级手机上的监控APP。

全部提交

Full Changelog: v1.3.1...v1.3.2

v1.3.1

坤支付 KunPay v1.3.1

📱 安卓监控APP

• 新手教程引导:步骤标签(① 通知使用权 → ② 允许通知)+ 一键配对码按钮,按提示即可完成配对
• 权限警告横幅:Android 13+ 缺「允许通知」时明确提示(监听已授权但通知被关,事件会被系统停发)
• 通知接收日志:每条到账推送与忽略原因可视化,挂机状态一眼可查
• 严格来源模式:微信通知仅放行「微信支付」服务通知,聊天文本伪造到账一律拦截

🛠 修复

• 管理员调整余额改用事务,并发调整不再令资金流水 before/after 链错位(金额与守恒不受影响)
• CI 发布打包路径修复:Linux/macOS 压缩包此前未随 Release 自动上传,本版起 7 类产物全部自动发布
• 设备页模板结构修复

📦 变更

• 桌面监控助手停止随版发布(源码保留),统一「安卓监控APP + 服务器」模式
• 安卓APP versionName 与平台版本号对齐(1.3.1)

⬇ 下载与部署

curl -fsSL https://raw.githubusercontent.com/kungec/kunpay/main/scripts/install.sh | bash

文件	用途
kunpay_linux_amd64.tar.gz / kunpay_linux_arm64.tar.gz	Linux 服务器
kunpay_windows_amd64.zip / kunpay_windows_arm64.zip	Windows
kunpay_darwin_amd64.tar.gz / kunpay_darwin_arm64.tar.gz	macOS
KunPayMonitor.apk	安卓监控APP
kunpay-v1.3.1-all.zip	全部产物打包

全部提交

Full Changelog: v1.3.0...v1.3.1

v1.3.0

Full Changelog: v1.2.1...v1.3.0

v1.2.1 — 金额解析严重修复 + 安卓协议升级

🚨 重要

本版本修复一个 v1.2.0 引入的严重金额解析 bug:一位小数金额(如 12.5)被解析为 12.05 元,商户少收约 45%。使用 v1.2.0 的请立即升级。

修复

• ParseMoney 一位小数补零丢失(资金函数单元测试当场抓获,18 用例覆盖)
• SMTP 密码不再回显到设置页 HTML;留空保存=保持原值
• 数据清理移除 balance_logs 台账删除入口(防守恒被破坏)
• login_logs / audit_logs 纳入 90 天自动清理
• 交易小票 /receipt 强制校验金额后两位(修空参绕过)
• Dockerfile 非 root 运行 + healthcheck 改用 /healthz

新增

• AST 巡检绊线: 事务内调用 s.DB(单连接池自死锁类)全仓扫描
• 资金函数单元测试;安卓监控APP改 POST 上报(token 不进 URL)+ 断网队列冲刷
• 设备级 V免签兼容协议开关;严格模式微信匹配收紧;-db-sync=FULL 断电零丢失

完整变更见 CHANGELOG.md。升级注意: 首次登录 admin/admin123 将被强制要求修改默认密码。

v1.2.0 — 安全加固 + 性能优化版

新增

• 商户登录日志(/user/logs)、收银台自定义公告、提现自动审核(默认关闭,阈值可配)
• 订单事件 Webhook(支付/过期/退款,MD5 签名)、快捷收款二维码(/user/qr)
• 仪表盘账户健康提醒、今日成功率;提现记录分页与汇总;订单快捷日期筛选
• 管理员默认密码强制修改;TOTP 防同窗重放;会话空闲超时与会话数上限
• 优雅关停 + HTTP 超时加固(Slowloris 防护);外部审计 23 项 + 多轮深查全部修复

优化

• 首页/收入页趋势 GROUP BY 化;渠道页统计 N+1 消除;SQLite synchronous(NORMAL)+ 补索引
• SQLite 函数单测、并发回归 v3(17 项)

⚠️ 注意

v1.2.0 含一位小数金额解析 bug,请直接使用 v1.2.1。

完整变更见 CHANGELOG.md。

坤支付 KunPay v1.0.0

首个正式版本。

平台主程序(kunpay)

单文件部署,前端/数据库全内嵌。下载对应平台包,解压后直接运行:

• kunpay_linux_amd64 / kunpay_linux_arm64 — Linux
• kunpay_windows_amd64.zip / kunpay_windows_arm64.zip — Windows
• kunpay_darwin_arm64 / kunpay_darwin_amd64 — macOS

默认账号: admin / admin123(请立即修改)

收款监控客户端

• KunPayMonitor.apk — 安卓自动监听(推荐,配合云手机可实现云端挂机)
• KunPayMonitor_win64.exe / KunPayMonitor_mac — 桌面心跳保活助手

详细部署说明见仓库 README 与 deploy/ 目录。