XianYuSmart v2.0.7

这次升级解决什么

v2.0.7 重点补齐自动发货闭环、连接状态真实性和历史数据完整性。多规格商品更容易找到配置入口，私聊是否真正送达可以直接查看，仅私聊发卡后平台订单也不会再一直停留在“待发货”。

自动发货与订单闭环

• 动态识别闲鱼商品详情中的规格数组，兼容嵌套响应、priceInCent 和字符串 SKU ID。
• 商品列表增加“发货配置”入口；规格缺失时可直接同步，多规格商品未同步完整时会阻止误配。
• 自动发货页和订单页新增买家私聊发送状态，区分“已发送”和“待重试”。
• 发货凭证与买家私聊继续共用同一份实际交付内容，私聊发送前会自动恢复账号连接。
• 关闭发货凭证、仅开启买家私聊时，消息实际发送成功后自动确认平台发货；消息仍在重试时不会提前确认，凭证开启时不会重复确认。

连接状态更可信

• WebSocket 加入心跳时效判断，心跳超时立即显示离线并触发重连，不再长期显示虚假在线。
• 连接异常后的发货私聊继续走持久化重试链路，避免网络波动直接丢失交付消息。

卡密历史更完整

• 新增 Flyway V17 数据库迁移。
• 删除已使用的卡密库存项时，继续保留使用记录、订单号和卡密快照。
• 历史订单的交付状态不再依赖已经删除或重置的库存项。

文档与社区

• 新增英文 README，补齐能力范围、部署方式、配置入口和使用边界。
• 修复 Star History 日期刻度重叠和 README 跳转，明暗主题趋势图继续每日更新。
• 更新微信群二维码，保持交流和问题反馈入口可用。

升级提醒

1. 升级前备份 MySQL 数据库和运行环境配置。
2. 首次启动 v2.0.7 时会自动执行 V17 数据库迁移。
3. 升级后建议检查一个多规格商品，确认实际销售的每个 SKU 都有对应发货配置。
4. 建议分别验证“凭证与私聊同时开启”和“仅私聊开启”两种订单。
5. 账号心跳超时后会显示离线并自动重连，这是新的真实连接状态，不是页面异常。

获取方式

• GitHub Release：xianyusmart-2.0.7.jar、SHA256SUMS.txt
• 容器镜像：ghcr.io/evvvvvvvan/xianyusmart:v2.0.7
• 滚动镜像：ghcr.io/evvvvvvvan/xianyusmart:latest

完整更新日志见 CHANGELOG.md。

完整提交差异：v2.0.6...v2.0.7

XianYuSmart v2.0.6

多规格自动发货

• 自动发货配置页支持加载并切换商品规格，单规格与多规格商品均可逐项配置固定内容或卡密发货。
• 展示规格配置进度、加载状态、失败原因和重试入口，并完善移动端布局与未保存内容提醒。
• SKU 查询增加闲鱼账号与商品归属校验，避免不同账号下相同商品编号发生规格串用。
• 有规格商品严格按订单 SKU 匹配配置，不再回退商品默认配置，避免错误规格消耗卡密库存。
• 订单规格缺失、规格失效或配置缺失时停止自动发货并保留明确失败原因；无规格商品继续兼容原有配置。

滑块验证稳定性

• 滑块拖动改用 CDP 鼠标事件并携带真实位移增量，CDP 不可用时回退 Playwright 鼠标。
• 自动验证轮换三种拖动轨迹，增加最小加加速度曲线、自然鼠标预动作和轨迹扰动。
• 自动与手动验证统一浏览器指纹，刷新历史风险 Cookie，并保留验证后生成的新 Cookie。
• 增加错误页、假成功、页面刷新中断和“下载消息失败”检测，连续确认验证码消失后才判定成功。

升级说明

1. 升级前备份 MySQL 数据库和运行环境配置。
2. 本版本没有新增数据库迁移。
3. 有规格商品需要为实际销售的每个 SKU 配置自动发货。
4. 升级后建议检查一个多规格商品的配置进度，并在平台自然触发验证码时确认滑块处理结果。

完整更新日志见 CHANGELOG.md。

XianYuSmart v2.0.5

AI 配置与第三方接口兼容

• 支持 OpenAI Chat Completions 与 Anthropic Messages 两种主流协议。
• 内置 OpenAI、Anthropic、DeepSeek、阿里云百炼和 Google Gemini 官方预设，官方服务默认只需填写 API Key。
• 新增第三方中转站配置，可自定义名称、协议、Base URL 和模型名称。
• Base URL 支持根地址、/v1 地址和完整 endpoint，避免重复拼接 /v1/v1。
• DeepSeek 默认模型更新为 deepseek-v4-flash。
• 配置页新增真实连通性测试，可自定义发送内容并查看模型回复、最终 endpoint 和请求延时。

独立能力与可靠性

• Embedding 与 AI 商品图调整为默认关闭的独立高级配置。
• 新增 Flyway V16，保留已有自定义 AI 服务配置。
• 无效 Base URL 会在保存和状态检查阶段直接拒绝。
• 修复注册密码错误反馈和仓库趋势图更新流程。
• 更新微信群聊二维码。

升级说明

1. 升级前备份 MySQL 数据库和运行环境配置。
2. 首次启动会自动执行 V16 数据库迁移。
3. 升级后建议在系统设置中执行一次连通性测试。

完整更新日志见 CHANGELOG.md。

XianYuSmart v2.0.4

修复

• 修复 OpenWrt、飞牛等 Docker 环境启动时缺少本地行政区划数据的问题。
• 修复商品经过 AI 润色后偶发无法识别可发布类目的问题：标题未命中时使用完整详情重试一次，并动态兼容嵌套响应及 catId、cid、categoryId 字段。
• 同步发布本阶段已完成的验证码处理、Cookie 账号解析与平台风控保护增强。

升级

固定镜像标签请切换到 ghcr.io/evvvvvvvan/xianyusmart:v2.0.4。本版本没有新增数据库迁移。

校验

xianyusmart-2.0.4.jar SHA-256：94b8b87890dbe92df7cb7621cd7a67398a0f16f482ab092607d022714b83f994

XianYuSmart v2.0.3

2.0.3 聚焦商机发现、货源沉淀、商品发布和在线接待闭环，让商家可以从市场分析与选品开始，完成素材生成、商品发布、消息沟通和履约异常处理。

用户可感知能力

• 新增数据看板，集中展示实时成交额、今日订单、交付成功、AI 回复和近 7 天服务趋势。
• 新增商机发掘，支持关键词搜索、店铺商品采集、机会分析和一键沉淀货源。
• 新增全站比价，集中查看同类商品价格、销量、卖家资料和卖家口碑。
• 新增货源库，统一管理商机采集结果并继续进入素材与发布链路。
• 新增商品发布工作台，支持账号、类目、地址、SKU、图片和商品信息配置，并展示真实平台校验与发布结果。
• 商机素材支持调用已配置的 AI 能力生成商品图，减少商品上架前的素材准备工作。
• 新增可视化工作流，支持按“商机搜索、机会筛选、写入货源、生成素材、商品发布”编排单路径流程并查看逐节点结果。
• 消息管理升级为在线接待工作台，支持会话列表、历史消息补拉、消息发送和上下文查看。
• 商品下架删除改用闲鱼平台接口，平台成功后再同步本地状态。
• 订单与异常履约入口补充失败原因、重试和确认发货处理，异常订单更容易继续完成。

发布可靠性与数据安全

• 商品发布增加请求级幂等键和数据库唯一约束，重复提交不会重复创建同类发布任务。
• 发布成功后补齐商品、SKU 与属性落库，详情同步与本地数据更新链路更完整。
• 历史消息解析、WebSocket 消息路由和会话资料补全经过修复，降低漏消息、错位和页面闪屏。
• 自动更新代理修复状态文件权限，应用用户可以持续读取更新进度。
• 商机货源名称扩展到 512 字符，并增加代码侧长度保护，避免超长标题导入失败。
• 数据库新增 Flyway V14、V15 迁移，用于发布请求幂等和货源名称长度调整。

升级说明

1. 升级前备份 MySQL 数据库和运行环境配置。
2. 首次启动 v2.0.3 时会自动执行 V14、V15 数据库迁移。
3. 升级后建议检查商机发掘、商品发布、在线消息和异常订单处理链路。
4. 原有租户、闲鱼账号、商品、订单、模板和卡密库存不会被清空。
5. 数据库迁移完成后不建议直接降级到旧版本。

获取与部署

• 容器镜像：ghcr.io/evvvvvvvan/xianyusmart:v2.0.3
• 滚动标签：ghcr.io/evvvvvvvan/xianyusmart:latest
• GitHub Release 提供 xianyusmart-2.0.3.jar 与 SHA256SUMS.txt。

完整提交差异：v2.0.2...v2.0.3

XianYuSmart v2.0.2

2.0.2 ??????????????????????????????????????????????????????????????????????????????

???????

• ????????????????????????????
• ????????????????????????????????????????????
• ???????????????????????????????????????????????
• ????????????????????????????????????????
• ?????????????????????????????????????????????????????
• ??????????????????????????????????
• ?????????????????????????????????????
• README ??????? Star History ????????????????????

???????????

• ????????????????????????????????????????
• ??????????????????????????????????
• ?????????????????????????????????????
• ???????????????????????????????????????
• ????? Flyway V12?V13 ?????????????????

????

1. ????? MySQL ???????????
2. ???? v2.0.2 ?????? V12?V13 ??????
3. ???????????????????????????
4. ?????????????????????????????
5. ????????????????????

?????

• ?????ghcr.io/evvvvvvvan/xianyusmart:v2.0.2
• ?????ghcr.io/evvvvvvvan/xianyusmart:latest
• GitHub Release ?? xianyusmart-2.0.2.jar ? SHA256SUMS.txt?

???????v2.0.1...v2.0.2

XianYuSmart v2.0.1

版本定位

v2.0.1 聚焦长期运行稳定性、断线补偿和异常处理闭环。商家可以更快发现连接、发货、回复和库存问题，并在确认无需继续处理后消除历史异常提示。

使用体验

• WebSocket 断开后自动重连，并补偿断线期间遗漏的消息和订单。
• 支持手动补发与确认发货，异常订单可以回到可控流程。
• 通知渠道提供常用平台模板，减少重复查找参数和配置格式的成本。
• 新增买家管理、外部卡密供货与通知诊断能力。
• 异常待办支持单条或批量“标记已处理”；相同业务再次失败会重新提醒，不会被旧处理记录永久隐藏。
• 系统通过 GitHub 官方 Release 检查新版本，并提供更新前校验、失败回滚和状态反馈。

稳定性与数据安全

• 使用持久化同步游标与幂等处理链，降低断线恢复后的重复处理风险。
• 为发货、自动回复和外部供货异常增加单调递增的异常版本，准确区分历史失败与新失败。
• 异常处理记录按租户隔离，批量操作只处理当前页面提交的异常。
• 数据库升级由 Flyway 自动执行，本版本新增 V11__exception_acknowledgement.sql。

升级说明

1. 升级前备份 MySQL 数据库和运行环境配置。
2. 首次启动 v2.0.1 时会自动执行数据库迁移。
3. 原有固定内容模板、卡密仓库、商品和账号配置不受影响。
4. 数据库迁移完成后不建议直接降级到旧版本。

发布资产

• xianyusmart-2.0.1.jar
• SHA256SUMS.txt
• 容器镜像：ghcr.io/evvvvvvvan/xianyusmart:v2.0.1

完整差异：v2.0.0...v2.0.1

XianYuSmart v2.0.0

XianYuSmart v2.0.0

这是 XianYuSmart 从单商家自动交付工具升级为多租户虚拟商品运营平台的首个大版本。相较 v1.0.0，本次更新覆盖商品、订单、发货、评价、运营配置和任务可靠性，重点解决多账号经营中配置分散、交付结果不一致、卡密重复使用、异常任务难恢复等问题。

本次更新能带来什么

• 一套系统服务多个商家：账号、商品、订单、库存、配置、任务和 AI 知识库按租户隔离。
• 两类发货场景更清楚：固定内容与卡密发货严格二选一，网盘链接、使用说明等固定资源不再依赖卡密库存。
• 交付渠道按需组合：发货凭证与买家私聊分别控制；同时开启时复用同一份实际发货内容。
• 售后跟进更自然：模板可引用会员名称、订单号、发货内容和卡密；确认收货后可分多次发送引导话术。
• 评价策略更符合经营需要：支持满足订单条件后自动评价，或仅在买家先评价后触发；文案池、批量配置、手动评价和双方评价查看均已补齐。
• 运营配置集中管理：商品自动化入口归一，新增固定内容模板及素材、货源、选品、发布、删除、补偿、分销等运营能力。

可靠性与性能

• WebSocket 实时事件与订单接口补偿统一进入幂等任务链路，避免同一订单重复交付。
• 卡密通过 MySQL 行级锁整单预占，成功后核销，失败时释放或进入人工复核。
• 发货、回复和运营任务持久化，支持租约回收、失败退避与服务重启恢复。
• 完善普通卖家待发货订单兼容、真实发货与评价状态同步、失败任务安全重排队。
• 增加有界线程池、批量任务领取、连接池上限和订单查询索引，降低高峰期资源占用。
• Cookie 手动更新或重新登录后立即刷新连接状态；滑块验证使用外部浏览器指引。

交互、文档与合规

• 重构自动发货、订单评价、商品管理、连接管理、仪表盘和系统设置流程。
• 移除重复的自动化配置入口，模板只在统一入口维护，商品仅选择策略并控制开关。
• README 补充商家收益、技术亮点、镜像部署、交流群、赞赏入口和官方 Star History。
• 许可证调整为 PolyForm Noncommercial License 1.0.0，仅授权非商业用途，并完善免责声明。

升级前必读

1. 备份 MySQL 数据库。
2. 本版本包含 Flyway V2 至 V8 迁移，首次启动后请等待迁移完成再访问系统。
3. 固定内容与卡密已改为互斥交付模式，升级后请逐个检查商品的交付模式、模板和发送通道。
4. 自动评价新增两种触发策略，升级后请确认每个商品采用哪一种模式。
5. 数据结构、索引和唯一约束已经调整，不支持将 2.0.0 数据库直接降级给 1.0.0 程序使用。
6. 本版本不授权 SaaS、代运营、收费服务及其他直接或间接商业用途。

获取与部署

Release 附件提供：

• xianyusmart-2.0.0.jar
• SHA256SUMS.txt

Release 发布后，GitHub Actions 会自动构建并推送 linux/amd64 容器镜像：

docker pull ghcr.io/evvvvvvvan/xianyusmart:v2.0.0
docker pull ghcr.io/evvvvvvvan/xianyusmart:latest

使用仓库中的 Compose 配置更新：

export APP_IMAGE=ghcr.io/evvvvvvvan/xianyusmart:v2.0.0
docker compose pull app
docker compose up -d --no-build

容器镜像在 Release 发布后的自动工作流完成后可用。

完整更新记录请查看 CHANGELOG.md。

完整差异：v1.0.0...v2.0.0

XianYuSmart v1.0.0

XianYuSmart v1.0.0

首个正式版本，面向单商家私有部署的闲鱼虚拟商品经营场景，聚焦卡密库存、自动交付、客服自动化与异常处理。

核心能力

• 商品、SKU、发货规则与卡密库存管理
• 文本、卡密及多数量商品自动发货
• 订单幂等处理、库存原子预占与失败重试
• 关键词、商品配置与 AI 自动回复
• 人工接管、异常待办与发货人工复核
• 收入、交付、回复、库存及操作日志工作台
• MySQL 持久化、Docker Compose 与 Nginx HTTPS 部署

技术基线

• Java 21 / Spring Boot 3.5
• Vue 3 / TypeScript / Vite
• MySQL 5.7+
• Docker Compose / Nginx

部署提醒

• 首次启动前必须修改数据库密码与 JWT 强密钥
• 公网部署必须启用 HTTPS，并避免直接开放 MySQL 和应用端口
• 闲鱼接口、Cookie 与风控策略可能变化，需持续关注账号状态和异常待办