ZCard v1.2.110

ZCard v1.2.110

发布日期：2026-10-03

短信接码购买修复

• 修复短信渠道报价成功后，购买请求因价格上限 max_supply_amount_cents 被发送为字符串而遭供货接口 400 CODEC 拒绝，订单持续显示“采购确认中”或最终进入“待人工核对”的问题。
• 普通短信商品与短信渠道商品的购买金额统一按 JSON 整数发送，保留整数精度、最终请求体签名、原购买意图与幂等键。历史意图中的金额字符串和整数继续兼容。
• 对明确的 400 CODEC 请求解析错误停止无效自动重试，转入人工核对并显示 upstream_codec_error 诊断；网络异常、限流和其他结果不明确的错误继续按原规则处理。

旧订单核对与恢复

升级不会自动恢复已经进入“待人工核对”的旧任务。请先核对原供货订单、扣款及退款结果，再在后台接码诊断中填写核对说明并使用“恢复原任务”；恢复沿用已保存的购买意图和幂等键。

上游已经受理的原请求会重放原回执并继续同步会话。此前未受理且原报价已失效的请求，可能返回明确的未扣款拒单回执，再由现有退款协调流程处理买家实际支付金额。升级或恢复任务不保证旧订单能直接取到号码，取号、收码及退款均需按实际结果核对。

升级与验证

本版无新增数据库迁移。请备份数据库、配置和上传文件，保留原加密密钥，更新完整发行包并重启服务端。从旧版本升级仍需执行已有累积迁移。发起短信采购的站点需升级，无需删除货源、商品映射或历史订单。

回归覆盖普通与渠道购买的 HTTP 请求绑定、最终请求体签名、大整数精度、历史意图读取兼容，以及 400 CODEC 诊断、停止自动重试和资金状态保持。相关适配器测试、静态检查和购买契约竞态检查通过；真实供应商付费取号、实际收码、退款到账及客户站点升级仍需分别验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.110

发行验收记录

正式版已发布，Latest 指向 v1.2.110。发行提交及版本标签为 32d5f2a1edec199e8fec6a2a30ea804bbef03f67，购买请求及诊断修复提交为 d4a72bf。9 个公开附件均已匿名下载并与本地逐一核对，ED25519 签名、双架构文件大小、SHA256 与 SHA256SUMS 全部通过；签名清单包含准确的 Docker 发行描述符及数据库迁移指纹。

Linux amd64 / arm64 的构建信息均指向上述发行提交。构建与独立验收时跟踪源码干净；vcs.modified=true 来自原有未跟踪的 docs/plans/，未将该目录纳入发行提交。

Docker 应用与更新器的版本标签均与发行描述符中的 immutable digest 一致，包含 amd64 / arm64。两架构容器运行版本均为 v1.2.110，镜像内二进制的 SHA256 与对应签名发行包一致。隔离环境中的启动、SQLite 安装、前端资源、容器更新保护，以及容器重建后的数据库、配置密钥与上传文件持久化检查全部通过，临时测试容器和卷已清理。

发行提交 CI 最终为失败：4 项作业通过，包括 MySQL/PG 集成、部署脚本与干净 Docker 构建、前端金额及商城首屏与配置恢复。server 作业的生成物无 diff 校验通过，随后在 8 个既有文件的格式检查处失败，后续架构守护及 SQLite 单元测试步骤跳过；开源 schema 红线扫描因既有 license.go 匹配失败。已与 v1.2.109 核对，失败范围相同，本次不宣称 CI 全绿。重复的自动 Release 任务 已取消以避免与手动发行竞争，正式附件使用本地受保护密钥签名发行流程。

频道公告文案已准备，位于 docs/releases/v1.2.110-telegram.txt，由用户手动发送；目前尚未发送。未部署客户生产站点，真实供应商付费取号、收码及退款到账尚未验收。版本发布与隔离验证通过不代表客户站点已升级或实际短信交易已完成。

ZCard v1.2.109 · 短信接码报价修复

ZCard v1.2.109

发布日期：2026-10-03

短信接码报价修复

• 修复对接 zcard-market 短信渠道时，列表和库存正常显示，但点击“确认价格”出现 upstream 400 (CODEC)、country_id 无法解析为整数的问题。
• 报价请求将国家与服务平台标识校验后按整数发送，同时修复 platform_id 的同类错误；空筛选保留原有默认语义。
• 非法、负数或超出整数范围的标识在发送前被拦截。保留原有报价签名、会员权限、零售加价及购买、收码和退款流程。

升级与验证

本版无新增数据库迁移。请备份数据库、配置和上传文件，保留原加密密钥，更新完整发行包并重启服务端。从旧版本升级仍需执行已有累积迁移。

无需重新导入渠道商品、删除货源、重建商品映射或修改正常供货凭据。升级后重新选择国家与服务平台，再点击“确认价格”。仅更新供货端不能修复旧客户端发送字符串字段的问题，发起报价的开源站点需升级。

回归测试覆盖真实供货 HTTP 接口解析、国家与平台的整数类型、空值、零值、大整数精度以及非法标识提前拒绝，已通过相关后端测试、架构检查和静态检查。真实供应商付费取号、实际收码及客户站点升级需分别验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.109

发行验收记录

正式版已发布，Latest 指向 v1.2.109。发行提交与标签为 eb30dbd56c1a75473e1dc600ee28ea0cac12cf86，短信修复提交为 f972eb5。9 个公开附件均已匿名下载并与本地逐一核对，Linux 双架构的 ED25519 签名、文件大小、SHA256 与 SHA256SUMS 全部通过；签名清单包含准确的 Docker 发行描述符。

Docker 标签与发行描述符摘要一致，包含 amd64 / arm64；两架构运行版本均为 v1.2.109。隔离环境中的启动、SQLite 安装、前端资源、容器更新保护，以及容器重建后的数据库、配置密钥与上传文件持久化检查通过。两个仓库后端全量测试、对应 fullstack 检查和本次适配器静态检查通过，未进行客户生产站点部署或真实付费取号。

频道公告已于 2026-10-03 18:23（UTC+7）发布至 https://t.me/ZCardGroup 。原生 Telegram 界面已核对完整正文、v1.2.109 下载链接及发送完成状态；未取得新消息直链。

发行提交 CI 的 4 项作业通过：MySQL/PG 集成、部署脚本与干净 Docker 构建、前端金额、商城首屏与配置恢复。生成物校验通过，server 作业在 8 个既有文件的格式检查处停止，开源 schema 检查同样失败；已与 v1.2.108 日志核对，失败范围相同。本次不宣称 CI 全绿。缺少发行 Secrets 的重复自动 Release 任务已取消，正式附件使用本地签名发行流程。

ZCard v1.2.108

ZCard v1.2.108

发布日期：2026-10-03

实体商品与库存设置

• 商品属性独立选择“虚拟”或“实体”，后台列表正确显示实体商品，不再显示为卡密。分类只用于商品分组；已保存商品如需更换属性，请新建商品。
• 实体商品提供“管理库存”“前台显示库存”“前台显示销量”三个独立开关。关闭库存管理可不限库存接单，并隐藏商品及规格库存输入和商城库存展示；原库存数量保留，重新开启前需核对。
• 商品库存、销量显示同时遵守商城全局开关，关闭后不再显示相应数据。实体表单隐藏卡密、去重等虚拟交付设置。

实体订单与国际地址

• 纯实体订单无需设置查询密码。会员通过账户查看订单；游客填写有效邮箱，保存订单访问链接，用于支付、物流查询及确认收货。
• 换设备或遗失链接时，可用下单邮箱验证码恢复访问。恢复后旧链接失效；虚拟商品、混合订单和历史查询密码继续按原规则使用。
• 收货地址支持地址第一行、选填的地址第二行、郊区或城市、州／省／地区及邮政编码，按所选国家调整字段顺序、必填项和格式，兼容已有地址。
• 实体订单展示配送和包裹进度，隐藏卡密取货流程。取消、退款及退货按下单时的库存记录处理，之后切换库存管理不会让旧订单重复增加或遗漏库存。

升级与验证

本版包含 SQLite / MySQL / PostgreSQL 数据库迁移。请先备份数据库、配置及上传文件，保留原加密密钥，使用完整发行包更新服务端、后台与商城，重启后检查迁移日志并刷新浏览器。已有商品属性、库存及库存显示设置保留；新增库存管理和销量显示默认开启。

内置商城已适配上述功能。商业独立 Gift 主题及其他单独安装的主题不随主程序发布，需分别更新兼容的主题包。游客邮箱找回需在后台配置可用的 SMTP 邮件服务。

本地验证已通过后端回归、三种数据库历史升级与重复迁移、真实 MySQL / PostgreSQL 库存及退款并发回归、前后台类型检查和构建，以及隔离环境中的实体下单、支付回调、发货、收货与邮箱恢复流程。本地验证不代表客户生产站点已升级或真实支付渠道已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.108

发行验收记录

正式版已发布。9 个公开附件已匿名下载并与本地核对，Linux 双架构的 ED25519 签名、大小、SHA256 与 SHA256SUMS 全部通过。Docker 双架构运行版本、镜像摘要、独立安装与数据持久化，以及默认在线更新首装均通过；未进行客户站点部署或跨版本在线升级。

发行提交 594a921 的 CI 有 4 项通过；生成物校验通过，仍保留发布前已有的 8 个文件格式检查和开源 schema 检查失败。详见 CI 运行记录。本版正式附件由本地签名发行流程发布。

ZCard v1.2.107

ZCard v1.2.107

发布日期：2026-10-02

上游商品详情图片

• 导入商品和采集同步统一处理详情中的图片，按上游地址解析相对路径、根路径及协议相对路径，并兼容常见懒加载图片字段。下载成功后改为本站上传目录地址，减少详情页图片指向本站错误路径的问题。
• 封面使用同一套 URL 解析，修正带目录的上游地址和相对图片路径组合；下载失败保留完整上游地址，下一次导入或采集可重试，不将临时失败永久缓存。
• 图片下载只接受 HTTP / HTTPS，校验内网地址及重定向目标，继续限制图片类型、体积与请求时间；安全检查或下载失败不阻断商品导入。
• 拒绝图片路径返回的 HTML 错误页，避免破图被错误保存并缓存；连接阶段复核并固定已验证的 IP，防止 DNS 变化绕过内网地址检查。
• 保留已锁定商品及受保护的详情、封面。价格、库存和上下架等轻量同步继续只更新各自范围，不重写商品详情。

升级与验证

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，更新完整发行包并重启服务端。从旧版本升级仍需执行已有累积迁移。

已有商品中的破图不会在升级时自动重写。升级后执行一次货源采集同步，或在导入页面重新导入相应商品以更新详情；受保护详情需由运营核对原内容，确认允许上游覆盖后解除保护再同步。无需删除货源、商品映射或历史订单。

Go 全量测试和 go vet 通过；回归覆盖相对图片 URL、常见懒加载字段、本地采集、失败重试、下载限制与受保护字段。

以上验证不代表全部真实上游图片已恢复，也不代表客户生产站点已验收；具体上游图片不可用、权限及防盗链仍需按实际响应核对。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.107

ZCard v1.2.106 · MySQL 上游商品目录导入修复

ZCard v1.2.106

发布日期：2026-10-02

上游商品目录导入修复

• 修复 MySQL 环境下导入异次元等上游商品目录时出现 Error 1038 (HY001): Out of sort memory、目录无法展示的问题。
• 最新目录快照先查询记录 ID，再按主键读取完整目录，避免大体积 JSON 参与排序，减少对 MySQL 排序缓冲的依赖。
• 保留站点隔离、货源身份校验、快照有效期、缓存复用、强制刷新和并发刷新锁，已有商品与货源映射无需重新建立。

升级与验证

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，更新完整发行包并重启服务端。升级后重新打开“导入商品”；仍显示旧错误时点击“重新加载”，无需删除货源、已导入商品或原有映射。从旧版本升级仍需执行已有累积迁移。

本次修复不需要全局增大 MySQL sort_buffer_size。上游目录能正常加载后，个别魔改协议、商品类型及自动采购仍需按对应上游单独验证。

Go 全量测试、go vet 与 fullstack 内嵌资源检查通过；真实 MySQL 8.4 在 256 KiB 排序缓冲下，使用 2,250,349 字节目录复现旧查询的 1038 错误，新查询成功读取完整内容。回归同时覆盖站点及货源身份隔离、有效期、强制刷新和未完成目录加载任务的快照复用，并接入 CI。

提供的上游账号认证和目录读取已验证成功，未发起真实付费采购；上述验证不代表所有魔改上游、全部商品自动采购或客户生产站点已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.106

ZCard v1.2.105

ZCard v1.2.105

发布日期：2026-10-02

默认结算货币

• 基础货币统一作为站点默认结算货币。尚未配置商品价格或开始资金业务的站点，添加并启用 AUD 后，可通过下拉或货币列表的“设为默认结算”切换；切换时同事务重新归一全部汇率，基础货币汇率固定为 1。
• 前端显示货币独立于结算货币。订单、钱包账户和流水记录真实基础币种；支付明细区分基础币金额、显示币参考金额和网关实际扣款，充值及提现按基础货币输入。
• 支付渠道按币种能力筛选，Stripe、PayPal 接收明确的扣款币种与金额快照；仅支持 CNY 的支付驱动、独角数卡／ACG 兼容供货协议及接码销售不接受 AUD 基础金额。跨币回调使用建单时的快照，汇率变化不会重新解释已创建的付款。
• 已有商品、订单、资金记录或金额配置时拒绝直接切币，覆盖会员金额门槛、消费积分计价、固定手续费、优惠与供货定价，防止历史金额被改标。切币与首次定价、账户创建共用数据库锁。
• 补齐旧 CNY 订单退款和旧充值回调的币种检查；遇到基础币配置与旧钱包币种不一致时明确要求迁移，不将 CNY 余额显示或记账为 AUD。
• 后台商品、规格、运费、退款、调账、会员门槛、固定手续费和赠送档位等金额输入及图表单位随基础币更新。

简体中文与英语

• 默认语言改为单选下拉，启用语言改为多选，当前支持简体中文与英语；默认语言必须属于启用列表，至少保留一种语言，批量保存统一校验最终状态。
• 默认商城主题覆盖内置页面、按钮、错误、空状态、无图占位、日期及无障碍文案。首次访问使用站点默认语言，客户已保存且仍启用的选择优先；仅启用一种语言时隐藏切换器，停用语言后清除旧选择。
• 切换语言保留表单输入、商品数量和购物车；公告、横幅、文章及详情刷新当前语言内容，请求发送对应语言，HTML 语言及 SEO 同步更新。
• 文章编辑支持分别填写简体中文与英语，并保留其它已存在语言内容；未填写翻译时回退原文，不自动翻译商品名称、店名及商家自定义内容。兼容已有中文、英语地域别名，清空英语时不会恢复旧别名内容。
• 内容查询明确隔离站点，横幅缓存同时区分站点、位置与有效语言，避免语言切换或分站请求混用内容。

升级与验证

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，使用完整发行包同步更新服务端、后台和默认商城主题，并刷新浏览器。从旧版本升级仍需执行已有累积迁移；独立第三方主题需另行适配。

已有价格或资金的站点不能通过修改下拉直接将 CNY 改为 AUD。本版不提供历史金额迁移工具；需要先制定包含价格、余额、订单及汇率的迁移方案。若旧版本已经保存了非 CNY 基础币设置，但钱包或订单实际仍为 CNY，升级后相关操作会拒绝币种错配，请先核对账务及配置。

验证覆盖 Go 全量测试、go vet、AUD 订单与钱包支付、重复回调、充值及退款、旧 CNY 钱包读取与退款回滚、语言策略与内容缓存回归、前后台类型检查和生产构建、fullstack 内嵌资源检查。桌面与手机浏览器验证下拉联动、保存回显、失败重试、切换保留表单和购物车，以及 AUD 结算与 USD 网关扣款的费用展示。

浏览器和支付链路验证使用隔离测试库及本地模拟接口，不代表真实支付网关、上游或客户生产站点已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.105

ZCard v1.2.104 · 实体发货与优惠券修复

ZCard v1.2.104

发布日期：2026-10-02

实体配送与后台发货

• 后台“待发货”同时列出实体快递配送和人工交付，按当前站点筛选并显示剩余待寄数量；实体订单直接进入快递配送面板，发货后自动刷新并移出列表。
• 多商品订单按订单分页，修复商品项数量影响下一页判断的问题；缺少订单详情权限时显示明确提示。
• 包裹、退款明细和退货操作显示商品规格；前后台分别展示购买、取消、寄出、收到和退回入库数量，避免部分取消后数量难以核对。
• 退货入库记录包含商品项、入库数量及验收原因；修复长中文商品名称使事件超过字段限制、导致合法入库失败的问题。

支付授权与优惠券

• 支付报价和创建支付统一验证站点归属及订单访问权限；钱包支付必须由登录的订单所属账户操作，查询密码或报价标识不能授权扣取他人余额。
• 优惠券核销改为原子条件更新，同一张券跨商品并发下单仅一笔成功，失败订单整体回滚。
• 商品及运费全部退款、所有商品数量全部取消且从未交付时返还有效券；部分退款、已寄出、虚拟商品已交付及过期券不返。支付手续费单独处理，零应付订单全部取消也可返券。
• 返券按原使用订单校验，旧退款重放不会清除新订单的优惠券占用；返券失败会回滚退款事务。
• 优惠券页面修正折数显示，例如 9500 为 9.5 折、9850 为 9.85 折；过期券不列为可用，长期券和读取失败状态明确显示。

游客购物车与界面

• 游客可正常打开购物车，显示真实商品规格，优惠与运费在结算时核算；结算失败或关闭地址弹窗后恢复按钮，只清理本次提交的商品。
• 修复零价字段被省略时，付费商品与零元赠品混合的购物车合计显示为零的问题。
• 国内及国际手机号均进入联系方式查单，保留订单号与查询密码直接查询。
• 默认首页、品牌条及页脚文案适配虚拟交付和实体配送，保留商户自定义设置；后台促销门槛说明明确按优惠后的单件商品金额判断，运费不计入。

升级与验证

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，使用完整发行包同步更新服务端、后台与商城，并刷新浏览器。从旧版本升级仍需执行已有累积迁移；独立第三方主题需适配新增数量及待发货分页字段。

历史无查询密码的会员订单仍可由登录本人支付；历史无查询密码的游客订单缺少可验证身份，支付入口将拒绝发起支付。余额支付要求订单所属账户登录，不能凭查询密码扣取他人余额。

验证覆盖 Go 全量测试、go vet、支付授权与优惠券/退款/履约竞态回归、真实隔离 MySQL / PostgreSQL 同券跨商品并发及返券验证、前后台类型检查和生产构建、fullstack 内嵌资源检查。390px 手机与 1280px 桌面浏览器验收覆盖游客混合购物车、优惠券、运费、国际手机号查询及实体 SKU 的取消、发货、收货和退回入库。

浏览器使用隔离测试库和合成账号，零元订单用于验证支付后的履约链路，不代表真实支付渠道、物流或客户生产站点已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.104

ZCard v1.2.103

ZCard v1.2.103

发布日期：2026-10-01

分类与商品删除

• 删除父分类时，事务内同时删除全部子分类并移除其中商品，包括上架、隐藏、下架和锁定商品；批量删除自动合并父子分类，避免重复请求，失败项保留供重试。
• 商品删除立即从后台、商城和供货目录移除，释放分类，关闭自动上下架，清理购物车、运营设置、货源映射和供货定价，并停用关联抽奖奖品。
• 锁定商品、待付款和发货中的订单不再阻止商品删除；保留订单商品快照、已有交付内容、取货、退款及账务记录，已有订单继续处理，账户余额不变。
• 保留已有订单所需的库存和历史商品记录；没有未完成订单时，剩余可售卡密停用。归档商品无法通过上下架或自动同步重新恢复。
• 删除界面统一为“确认删除（保留订单）”；旧客户端请求同时删除订单时，服务端明确拒绝，避免误删历史记录。

MySQL 并发保护

• 修复 MySQL 无变化更新返回零行导致商品或分类被误判为不存在的问题，删除与供货定价使用加锁读取确认当前状态。
• 等待并发事务后读取已提交状态，避免对已删除商品、分类新增专属价；保留 SQLite 写锁保护和租户隔离。

接码渠道导入

• 上游接码能力改用多个 capabilities 参数传递，修复部分上游无法识别能力列表、接码商品目录无法正常导入的问题。
• 货源渠道桌面列表新增直接“导入商品”入口；只有一个接码商品时自动展开分类并选中可导入商品，移动端继续使用操作菜单。

升级与验证

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，更新完整发行包并刷新浏览器。从旧版本升级仍需执行已有累积迁移。

删除父分类会同时删除全部子分类和其中商品，操作前请核对删除范围；订单快照、交付、退款及账务记录继续保留。

验证覆盖 Go 全量测试、受影响模块 go vet 与 race 回归、MySQL / PostgreSQL 删除及定价集成测试、后台类型检查及生产构建、fullstack 内嵌资源检查，以及 390px / 1440px 商品删除、分类批量删除和接码导入页面回归。页面回归使用模拟接口，不代表客户生产数据或真实上游已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.103

ZCard v1.2.102

ZCard v1.2.102

发布日期：2026-10-01

支付宝配置与支付处理修复

• 应用私钥与支付宝公钥改用多行输入，支持裸 Base64、完整 PEM、PKCS1 / PKCS8 私钥，以及粘贴时产生的转义换行；已保存密钥不回显，留空保留原配置。
• 修正请求签名参数和支付宝时间格式，完善通知的应用、订单、金额及 RSA2 签名检查，成功通知返回支付宝要求的纯文本确认。
• 主动查询校验支付宝响应签名与订单信息；异步通知未到达时可按商户订单号核对支付结果，兼容已有商品订单和充值订单。
• 本次继续使用支付宝公钥模式，证书模式需另行适配；配置仍须填写正确的应用私钥与支付宝公钥。

空分类及商品删除修复

• 分类删除与商品计数采用相同口径，已删除商品的历史分类引用不再阻挡空分类删除；清理旧引用、分类运营设置、供货分类定价和货源分类映射。
• 区分仍有子分类、仍有商品、分类不存在和服务异常，显示具体原因；隐藏、下架商品仍算有效商品，未选中的子分类继续保留。
• 上架、隐藏、下架商品均可直接删除，立即从后台、商城和供货目录移除，释放分类，关闭自动上下架并清理购物车、分类运营设置、货源映射和供货专属价。
• 默认保留历史商品归档、订单、已交付卡密和取货内容；未售卡密转为停用，不再销售。实体商品历史订单及退货库存记录继续保留。
• 锁定商品、进行中的订单或退款、被订单占用的卡密、未完成采购及在用抽奖活动继续阻止删除，并显示处理原因。另选删除关联订单仍需核对商品名和订单数量，符合原有保护条件后才执行。
• 供货详情和定价拒绝已删除商品，供货下单与删除共用商品行锁；上游同步不会恢复归档商品。历史供货订单重试继续返回原交付记录，不重复扣款。
• 批量删除按顺序提交，避免 SQLite 写锁竞争，保留失败项供重试；单个或批量删除后同步刷新商品列表和分类信息。

供货账号充值修复

• 修复充值提交字段与接口不一致导致的 missing required field: amount_cents。界面输入元，提交整数分，例如 30 元提交 3000 分。
• 每笔充值使用独立标识，同一账号可多次充值相同金额；同一次请求的失败重试沿用原标识，已入账请求重试返回成功，不重复增加余额或流水。
• 相同标识修改充值金额会被拒绝；补充正数、精度和单笔金额上限校验，提交期间阻止重复操作和更换充值账号。

升级说明

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，使用完整发行包同步更新服务端与内置后台、商城，并刷新浏览器。从旧版本升级仍需执行已有累积迁移。

支付宝配置使用应用私钥与支付宝公钥，已配置密钥无需重复填写；此前已删除商品关联的空分类，升级后可重新尝试删除。进行中的业务需先处理完成，再删除对应商品。

验证覆盖 Go 全量测试、受影响模块 go vet、支付宝及分类、删除、充值的 race 回归、后台类型检查与生产构建、fullstack 内嵌资源检查，以及 390px / 1440px 页面回归。页面测试覆盖金额换算、失败重试、相同金额的独立充值、商品删除、批量失败项保留及分类刷新。接口与模拟页面测试不代表商户真实支付宝交易或客户生产站点已验收。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.102

ZCard v1.2.101 · 分类多选删除与接码游客浏览

ZCard v1.2.101

发布日期：2026-10-01

分类多选删除

• 后台商品分类直接显示多选框，支持全选当前筛选结果、跨搜索保留勾选和清空选择；分类页面与商品管理中的分类弹窗保持一致。
• 删除前确认，仅处理勾选分类，按先子后父顺序逐个删除。有商品或未选中子分类的分类保留，不级联删除商品或未选中的分类。
• 删除期间显示进度并阻止重复操作；失败项保留勾选并展示原因，可只重试剩余项。删除响应丢失时以刷新后的分类列表确认结果，已成功项不会重复提交。
• 分类删除按删除权限控制；仅有删除权限的管理员可使用多选，只有读取权限时不显示勾选或删除操作。认证或权限失败时停止后续请求。

接码游客浏览与公开名称

• 游客可直接筛选国家、服务及分页报价、查看零售价并选择号码选项；点击「登录后购买」进入登录页，保留返回当前商品的地址。
• 冻结购买报价、下单、余额、号码记录及会话操作继续要求会员登录。游客浏览不会请求会员钱包与号码记录，不保存购买报价或分配号码；隐藏、停售和隐藏分类的访问限制继续生效。
• 商品列表、详情、供货商品数据及会员订单的公开显示使用通用接码服务名称，处理旧自动生成的「渠道名 · 接码服务」标题和说明标题；自定义公开名称和服务说明保留，不修改后台供货连接名称或历史结算数据。
• 调整接码页面操作提示，使用公开服务说明，适配电脑和手机，保留登录会员原订单与原操作的响应丢失恢复流程。

升级说明

本版无新增数据库迁移。请备份数据库、配置及上传文件，保留原加密密钥，使用完整发行包同步更新服务端与内置后台、商城，并刷新浏览器。从 v1.2.99 之前升级仍需执行累积迁移；独立第三方主题需自行适配游客浏览和公开商品名称处理。

接码购买仍限定主站登录会员、CNY 余额和单件独立订单，新购继续默认开启；ZCARD_SMS_SALES_ENABLED=false 可暂停新购，历史查单、操作和退款继续运行。供货端仍需支持渠道目录、动态选项、报价及采购接口。

发布验证已通过 Go 全量测试、受影响模块 go vet、分类保护及接码游客鉴权的 race 回归、前后台类型检查与生产构建、fullstack 内嵌资源检查，以及 390px / 1440px 页面测试。页面回归覆盖筛选多选、取消确认、先子后父删除、失败与响应丢失恢复、读取/删除权限、游客浏览和登录跳转，并保留会员原订单重试、收码及退款验证。

发行包提供 Linux amd64 / arm64、SHA256 校验和、ED25519 签名清单及 Docker 镜像，继续支持 Docker 后台在线更新。页面和接口回归不代表真实供应商付费取号、实际收码或资金闭环已验收；版本发布不代表客户站点已自动升级。

版本详情与下载：https://github.com/NovaWorks/zcard-next/releases/tag/v1.2.101