/** * 桌面客户端更新日志(面向用户的通俗说明,桌面端更新面板展示)。 * * 数据来源:app_client 仓库 git 历史——以 `version.txt` 每次变更提交为界 * (4.0.43 起提交信息不再统一为 chore(release),锚点改用文件本身), * 取该窗口内的 feat/fix 提交,自动整理成"用户能看懂的一句话"后追加到本文件(新版本放最前)。 * 取某版本区间的原始提交: * git -C app_client log --oneline <上一版 version.txt 提交>..<本版提交> * * 注意:version 必须与 web_config 发布记录 / /api/version/latest 的版本号 * 完全一致(不带 v 前缀),否则按本机版本筛选时匹配不到条目。 */ import { compareVersions, normVersion } from './utils/version-compare.ts' export interface ClientChangelogEntry { /** 客户端版本号,与线上发布记录一致 */ version: string /** 发布日期 yyyy-MM-dd */ date: string /** 面向用户的更新说明,一条一行,不用技术术语 */ items: string[] } /** 更新日志数据(新版本在前;发版时在数组最前追加一条) */ export const CLIENT_CHANGELOG: ClientChangelogEntry[] = [ { version: '4.0.59', date: '2026-10-21', items: [ '任务多时不再丢失已领取的任务,减少无故失败', '商品采集:搜索一直失败时如实报错,不再当成没搜到', '品牌检测:翻页中途失败不再当作无冲突,避免漏检', '相似ASIN:查不到结果时明确提示原因,不再静默无反应', '审批:缺少筛选条件时如实报错,不再显示成功却没结果', '手动停止采集时如实标记,不再显示为正常完成', ], }, { version: '4.0.58', date: '2026-10-17', items: [ '跟价:0 元商品自动补报价,不再一直改不动价格', '巡店删除:草稿类商品需确认后才删,降低误删风险', ], }, { version: '4.0.57', date: '2026-10-17', items: [ '巡店删除:修复非在售商品可能被批量误删的严重问题', '巡店删除、指定删除ASIN:适配新版「管理商品」页面', '指定删除ASIN:修复页面被弹回首页、找不到商品', ], }, { version: '4.0.56', date: '2026-10-17', items: [ '跟价:全量模式可按勾选的多种商品状态分别执行', '跟价:修复商品状态筛选失效、提示未收到有效数据', '巡店删除:修复部分国家打不开商品页、被登录墙挡住', ], }, { version: '4.0.55', date: '2026-10-16', items: [ '恢复巡店删除与指定删除ASIN 功能', '紫鸟浏览器统一使用新版,旧版不再支持', ], }, { version: '4.0.54', date: '2026-10-15', items: [ '全面切换到新版亚马逊后台界面,旧版界面不再支持', ], }, { version: '4.0.53', date: '2026-10-14', items: [ '上架:修复被误判为不兼容界面而直接失败的问题', ], }, { version: '4.0.52', date: '2026-10-13', items: [ '货源查询:未送达的结果保留 24 小时,不再提前丢弃', ], }, { version: '4.0.51', date: '2026-10-13', items: [ '紫鸟已手动打开时也能正常开店,不用先退出紫鸟', '遇到亚马逊后台改版时明确提示,不再空转后报错', ], }, { version: '4.0.50', date: '2026-10-11', items: [ '任务进度显示更准确:各类任务都能看到总量和百分比', '商品采集进度改为按国家统计,更贴近实际进度', ], }, { version: '4.0.49', date: '2026-10-10', items: [ '掉登录后自动识别并恢复,不用再关掉浏览器重开', ], }, { version: '4.0.48', date: '2026-10-09', items: [ '审批:掉登录后先自动恢复,不再空转后判失败', '数字人启动失败的提示改为中文', ], }, { version: '4.0.47', date: '2026-10-09', items: [ '品牌检测:自动去掉查询词里多余的 Brand: 前缀', ], }, { version: '4.0.46', date: '2026-10-08', items: [ '任务结果回传更可靠,服务器未确认时会自动补发', ], }, { version: '4.0.45', date: '2026-10-08', items: [ '升级或退出客户端时不再打断正在跑的任务', '结果没被服务器收下时不会显示为已完成', '品牌检测遇到无法解析的商品会明确报错,不再反复重试', '任务被拒绝或凭据异常时提示具体原因', '金额留空不再导致整单采集失败', ], }, { version: '4.0.44', date: '2026-10-03', items: [ '更新前校验安装包完整性,防止下载到损坏或被替换的包', '登录凭据改为连上服务器后领取,不再保存在安装包里', ], }, { version: '4.0.43', date: '2026-10-03', items: [ '开店失败时写明真实原因,不再统一提示未收到数据', '任务很多时客户端不再卡住', ], }, { version: '4.0.42', date: '2026-10-02', items: [ '跟价、店铺采集:提交任务时带上当前登录账号,代理用量不再记错人', '代理密钥等登录信息不再写入日志与上报,保护账号安全', ], }, { version: '4.0.41', date: '2026-09-30', items: [ '跟价、上架、巡店删除:修复打开店铺后切换到目标国家偶尔失败、任务查不到商品的问题', '店铺账号未开通目标国家商城时会明确提示原因,不再反复重试后空跑', ], }, { version: '4.0.40', date: '2026-09-30', items: [ '采集商品:修复新版库存页上采集结果 ASIN 列为空的问题', '产品风险处理、状态查询:修复新版库存页上任务跑完却查不到商品的问题', '任务失败时会写明具体原因,如目标国家切换失败、店铺未能打开', '账号密码等登录信息不再写入日志,保护账号安全', '品牌检测:代理余额不足或套餐到期时立即提示,不再整批白跑', '货源查询:遇到环境异常时立即停止并提示,不再长时间空转', ], }, { version: '4.0.39', date: '2026-09-30', items: [ '产品风险处理:适配亚马逊新版库存页,修复任务跑完却没有处理结果的问题', '状态查询、删除品牌、店铺匹配、采集商品:同步适配新版库存页', ], }, { version: '4.0.38', date: '2026-09-29', items: [ '跟价:适配亚马逊新版库存页,修复任务报「未收到有效跟价数据」', '跟价:新版库存页上的改价流程同步适配,改价保存后回读确认', ], }, { version: '4.0.37', date: '2026-09-25', items: [ '采集商品:修复图书类商品的品牌被误抓成作者名的问题', '采集商品:图书品牌优先取出版社,数据更准确', ], }, { version: '4.0.36', date: '2026-09-25', items: [ '产品风险审批:修复弹窗加载慢时部分商品被跳过、未提交的问题', '产品风险审批:提交前先等弹窗内容加载完成,提交更稳定', ], }, { version: '4.0.35', date: '2026-09-24', items: [ '产品风险审批:修复整批商品「未保存」问题(适配亚马逊弹窗改版)', '产品风险审批:有现成合规记录时自动选中并提交,不再跳过', '提交成功会显示「审核中」;需手动填表的会明确提示,不假装成功', '产品风险审批:处理速度加快,无用等待减少了', ], }, { version: '4.0.34', date: '2026-09-23', items: [ '货源查询:采集未跑完不再被提前结束,已采到的数据不会白丢', '货源查询:停止任务后客户端立刻停下,已采到的部分照样交回', '货源查询:任务进度显示更及时,能看到正在采集的 ASIN 与国家', ], }, { version: '4.0.33', date: '2026-09-22', items: [ '产品风险审批:修复面板记录选不上、提交按钮常灰、存不进去的问题', '产品风险审批:存不进去时会记录面板实际内容,方便定位原因', ], }, { version: '4.0.32', date: '2026-09-20', items: [ '相似货源:采集环境异常(如扩展未加载)时会立刻停下并说明原因', '相似货源:结果里没采到的行,「状态」列会标「未检测」,不再是一片空白', '相似货源:只跑出一部分时,任务会写明「仅完成 N/M 行」', '相似货源:客户端缺少采集扩展资源时会明确提示重新安装客户端', ], }, { version: '4.0.31', date: '2026-09-19', items: [ '跟价:没抓到购物车信息的商品,低于最低保护线时也会自动调回', ], }, { version: '4.0.30', date: '2026-09-19', items: [ '跟价:低于最低保护线的商品会自动调回,价格不再一直上不来', ], }, { version: '4.0.29', date: '2026-09-18', items: [ '修复任务跑一半被误判「已结束」而自己停下的问题', '任务执行中的数据回传遇到短暂网络问题会多试几次,不再因一次超时就中断', '客户端重启后,正在执行的任务会自动上报给服务端,便于接着处理', ], }, { version: '4.0.28', date: '2026-09-17', items: [ '修复多个任务同时操作同一店铺导致「打开店铺失败」的问题', '同一店铺的任务改为排队执行,不会再互相打断', '紫鸟更新内核期间不再直接报「打开店铺失败」,而是等待完成', ], }, { version: '4.0.27', date: '2026-09-17', items: [ '跟价:修复部分商品「价格读取异常就整行中断」导致该商品没跟上的问题', '相似货源:个别货源没取到价格时,不再丢失整行结果', '设备日志上传更省流量,云端查看日志更快', ], }, { version: '4.0.26', date: '2026-09-16', items: [ '跟价:修复「商品多的大店铺只跟了第一页、任务却显示成功」的问题', '跟价:掉登录后会自动重新登录并接着跑,不再白等十几分钟', '跟价:任务没跑完时会如实报失败并说明原因,已跟出来的部分结果仍可下载', ], }, { version: '4.0.25', date: '2026-09-16', items: [ '跟价:修复「指定ASIN模式」大量商品「查询不到」、结果表空白', ], }, { version: '4.0.24', date: '2026-09-16', items: [ '跟价:新版商品页改价改为在商品列表直接改、点底部「全部保存」提交', '改价提交后亚马逊后台约 15 分钟才显示新价格,属正常现象', ], }, { version: '4.0.23', date: '2026-09-16', items: [ '跟价:修复部分店铺所有商品都改价失败的问题(亚马逊新版商品页)', ], }, { version: '4.0.22', date: '2026-09-16', items: [ '升级包体积减少约 38%,下载更新明显更快', '启动时自动清理本地缓存与临时文件,长期使用不再越来越占磁盘', '优化启动速度与网络连接复用,运行更顺畅', ], }, { version: '4.0.21', date: '2026-09-15', items: [ '客户端目录会生成 code.txt,遇到问题时把它发给客服,可快速查本机日志', ], }, { version: '4.0.20', date: '2026-09-15', items: [ '本地日志会自动上传到云端(保留 7 天),遇到问题客服可远程排查,不用手动发日志', ], }, { version: '4.0.19', date: '2026-09-15', items: [ '修复:变体采集提交任务时报「未配置 MinIO 凭据」导致无法开始采集的问题', ], }, { version: '4.0.18', date: '2026-09-15', items: [ '数据采集:价格固定当地币种(英国英镑、欧洲欧元),不再错显成人民币', '数据采集:采集前自动设置当地配送地址,价格与配送信息更准确', '跟价:兼容亚马逊新版页面,当前价格读取更稳定', '修复:启动时不再误关闭你手动打开的紫鸟浏览器', ], }, { version: '4.0.17', date: '2026-09-15', items: [ '跟价修复:购物车归属判断不出来时不再改价,避免价格被改错方向', '跟价结果里「购物车店铺名」不再因个别字段缺失而整列丢失', '跟价失败会显示真实原因(例如代理余额不足),不用再反复重试等待', '代理欠费或套餐到期时不再重复派发任务,并提示检查代理设置', ], }, { version: '4.0.16', date: '2026-09-14', items: [ '品牌检测更省代理:线路被限流时不再反复更换,减少不必要的消耗', '代理线路在有效期内被更充分地复用,减少重复提取次数', ], }, { version: '4.0.15', date: '2026-09-14', items: [ '任务卡住时自动识别并收尾,已采集到的数据可以正常下载', '网络不稳定时自动更换线路重试,采集成功率更高', '跟价修复:购物车归属判断更准确,避免误改商品价格', '页面没推送成功的任务会自动接管执行,不再一直停在等待中', '品牌检测更稳定:遇到限流会自动等待后重试', ], }, { version: '4.0.14', date: '2026-09-14', items: [ '登录后任务会带上你的账号身份,服务端校验更严格', ], }, { version: '4.0.13', date: '2026-09-14', items: [ '图片生成的历史记录写入失败时会正常释放连接,长时间使用不会拖慢客户端', '运行过的任务记录会自动收敛,长时间挂机不再持续占用内存', ], }, { version: '4.0.12', date: '2026-09-14', items: [ '启动采集/跟价时不再关闭你自己打开的 Chrome 浏览器', '密码检测不再打断其它正在运行的任务', '任务失败或被停止后会正常结束,不会一直卡在"处理中"', '长时间挂机不再持续占用磁盘空间(缓存会自动清理)', '多个品牌检测任务同时提交时会排队执行,代理额度不会互相错记', '日志和配置目录更稳定,升级后设置不会"找不到"', ], }, { version: '4.0.11', date: '2026-09-13', items: [ '代理失效会自动切换并暂停购买,减少花冤枉钱', '风险审批结果自动保存,网络波动也不白干(断开后自动补交)', '品牌检测连续失败时自动停止,不再反复无效尝试', ], }, { version: '4.0.10', date: '2026-09-13', items: [ '修复切换国家时页面断开后一直卡住不动的问题', '修复产品风险审批"批准"数量一直不减(处理了却没算数)的问题', ], }, { version: '4.0.9', date: '2026-09-13', items: [ '修复长时间使用后电脑越来越卡的问题(浏览器进程不再越积越多)', '修复窗口最大化、还原时客户端偶尔没反应的问题', ], }, { version: '4.0.7', date: '2026-09-13', items: [ '跟价、风险审批的"旧版/新版"选项恢复真实生效(选哪个就走哪个)', '店铺界面已是新版时选"旧版"会明确提示,不再假装处理成功', ], }, { version: '4.0.6', date: '2026-09-13', items: ['跟价指定 ASIN 时严格按指定范围执行,未指定 ASIN 的国家不再全量改价'], }, { version: '4.0.5', date: '2026-09-13', items: [ '重做产品风险审批的保存流程:保存结果如实反馈,不再"显示成功其实没保存"', '修复风险审批多条待处理记录只处理第一条的问题', ], }, { version: '4.0.4', date: '2026-09-13', items: [ '修复风险审批新界面里"提交"按钮从未被点击、选了记录也不保存的问题', '修复跟价提示改价成功、实际没改价的问题;未设置最低价时不再漏处理商品', ], }, { version: '4.0.3', date: '2026-09-12', items: [ '货源查询改用真实浏览器采集,结果更准确', '修复跟价把购物车里已加购的商品误判为"没有卖家"的问题', '修复部分电脑提示"更新程序缺失"无法自动更新;更新显示真实下载进度', ], }, { version: '4.0.2', date: '2026-09-12', items: ['修复跟价等任务只处理第一页商品、其余被跳过的问题'], }, { version: '4.0.1', date: '2026-09-12', items: ['修复货源查询结果中"阿里巴巴"商品图片整列空白的问题'], }, { version: '4.0.0', date: '2026-09-11', items: [ '修复产品风险审批新界面频繁提示"处理失败"的问题', '修复商品翻页加载慢时只处理第一页的问题', ], }, { version: '3.0.73', date: '2026-09-11', items: ['修复集采数据、跟价等功能因接口鉴权失败无法使用的问题'], }, { version: '3.0.71', date: '2026-09-11', items: ['升级支持断点续传,并显示真实的下载进度'], }, ] /** 数据文件里最新的版本号(无数据时空串)。 */ export function newestChangelogVersion(entries: ClientChangelogEntry[] = CLIENT_CHANGELOG): string { return entries.length ? normVersion(entries[0].version) : '' } /** * 挑选本次要展示的更新日志:本机版本之后、最新版本(含)之间的条目,新的在前。 * * - latestVersion 为空(检测未完成/失败)时按数据文件里最新版本兜底; * - currentVersion 为空(旧客户端无版本桥)时只给最新版本一条,不把整段历史倒给用户; * - 本机版本已高于线上(灰度/回滚)时返回空数组,由调用方隐藏该区块; * - includeCurrent 为 true(面板展示用)时,本机 == 线上(无更新可看)退回展示 * 本机版本自身的条目——刚升级完的用户最想知道"这个版本改了什么"。 */ export function selectChangelogEntries(options: { currentVersion?: string latestVersion?: string entries?: ClientChangelogEntry[] includeCurrent?: boolean } = {}): ClientChangelogEntry[] { const entries = options.entries ?? CLIENT_CHANGELOG if (!entries.length) return [] const current = normVersion(options.currentVersion) const upper = normVersion(options.latestVersion) || newestChangelogVersion(entries) const inRange = entries.filter((entry) => compareVersions(entry.version, upper) <= 0) if (!inRange.length) return [] if (!current) { const newest = inRange.find((entry) => compareVersions(entry.version, upper) === 0) return [newest ?? inRange[0]] } const newer = inRange.filter((entry) => compareVersions(entry.version, current) > 0) if (newer.length || !options.includeCurrent) return newer // 本机 == 线上:展示本机版本条目;本机高于线上时 inRange 里没有它,仍为空(不展示低版本日志) return inRange.filter((entry) => compareVersions(entry.version, current) === 0) } /** * 取指定版本自身的条目("指定版本更新"下拉选中时展示,升级/回退/同版统一语义)。 * 版本未收录或版本号为空时返回空数组——不倒推相邻版本,避免张冠李戴。 */ export function selectVersionEntry( version: string, entries: ClientChangelogEntry[] = CLIENT_CHANGELOG, ): ClientChangelogEntry[] { const target = normVersion(version) if (!target) return [] return entries.filter((entry) => compareVersions(entry.version, target) === 0) }