新版本 四大工坊 能力 数据与云端 客户端 下载 更新日志 下载客户端
CHANGELOG 遵循 Keep a Changelog

每一次出发与沉淀,
都留在这条时间轴上。

从前身「12306 火车票票根编辑器」,一路走到四个工坊、十种票面、账号与加密备份的 V6.0.4,共五个阶段、47 组版本记录。这里写下每次技术取舍、视觉重塑,也写下那些被修掉的坑;最新一版修掉了强制更新提醒反复弹出的问题,把行程地图的线路绘制与拖动做了性能优化,并给珍藏册的票面预览补上了骨架屏占位与真实生成进度。

47收录迭代版本
5大演进阶段
V6.0.4当前稳定版本
MIT全部源码公开
五

第五阶段 · V5 视觉与体验重塑

2026-10-16 ~ 11-19 · 34 条

V6.0.4

最新稳定版网页端桌面端
强制更新提醒不再反复弹

旧页面把安卓 APK 清单里的版本号当成了网页版本,切回前台、页面重建都会重新判定「有新版」并再次拦截。本版改为只比对网页本体清单 release/latest.json 的版本,落盘结论与前台重断言都按同一口径,安卓升号不再影响网页端与桌面端。

行程地图性能优化

同一条线路只画一次并去重,动画在页面不可见时暂停,拖动改走快路径;长账本下拖动、缩放与切换年份更稳,不再重复叠加绘制。

珍藏册预览有加载反馈

票面尚未生成的位置先铺与票面同尺寸的骨架屏(浅色底 + 流光 / 呼吸动画),出图后原位替换,不跳动也不塌陷;底部显示「已生成 N / 总数」的真实进度,只随真实回图推进,生成完自动消失;列表刷新重渲染不再整表重建,骨架动画不会被重置。

详细条目 (Changes) 8
  • 门禁数据源收口:胶囊、关于面板与全屏强制层三处统一读 https://jidiandian.top/release/latest.json 的 version,不再读 app/latest.json 的 apk.versionName。

  • 珍藏册预览加载体验:未出图的票面先用与票面同尺寸的骨架屏占位(浅色底 + 流光 / 呼吸动画),出图后原位替换,媒体区高度固定,不跳动也不塌陷。

  • 真实生成进度:底部显示「已生成 N / 总数」与进度条,分母是整册票面数、分子只随真实回图增长,不按时间估算;生成完自动淡出移除,失败超过重试上限才显示「预览暂不可用」。

  • 刷新不再整表重建:列表中票面未变时直接跳过重建,只补齐缺失预览,骨架动画不会被复位,已出图的票面也不再闪一下。

  • 落盘结构同步改名:localStorage 里保存的强制结论由 apkVersion 改为 ver,启动重建弹层时按新键判断,旧键不再命中。

  • 在线网页端与桌面端内容:https://jidiandian.top/app/ 与 release/TraceDot-V6.0.4.html 均为 V6.0.4;release/latest.json 与 latest-beta.json 指向新页面,壳启动后自动拉取并提示重启。

  • 旧页面替换:长期停在 5.5.x 的桌面客户端,会在壳拉取到本页面后一次性换到 V6.0.4,反复弹窗随之停止;无需重装安装包。

  • 安卓端不变:安卓正式渠道仍为 V6.0.3(versionCode 603),本次未改动清单与 APK;安卓原生更新仍按 versionCode 拦。

V6.0.3

网页端桌面端安卓端
火车票工坊导入字段修正

粘贴导入改为按显式标签识别字段,不再靠位置猜列;CSV 表头统一为「取票机号」,票号与取票机号不再错位。

网页端与安卓端统一 V6.0.3,安卓转正式

网页端、桌面端与安卓端统一到 6.0.3;安卓正式清单升到 versionCode 603,可直接覆盖 5.5.2 与 6.x 内测包,票根、计划与激活状态不受影响。

详细条目 (Changes) 5
  • 在线网页端与桌面端:https://jidiandian.top/app/ 与 release/TraceDot-V6.0.3.html 均为 V6.0.3;release/latest.json 指向新页面,壳启动后自动拉取,重启生效。

  • 安卓转为正式渠道:app/latest.json 升到 603 / 6.0.3,APK 为 jidiandian-6.0.3.apk,签名与线上历史包一致,可直接覆盖安装。

  • 内测清单一并补齐:app/latest-beta.json 同样指向 603,已装 6.0.1 / 6.0.2 内测包的设备能直接收到这一版,不会卡在旧号。

  • 更新门禁按平台分流:网页端与桌面端只比对网页本体清单 release/latest.json 的版本号,不再因安卓 APK 升号被拦;安卓客户端仍按 APK versionCode 拦截。

  • 官网与下载入口:首页与更新日志更新到 V6.0.3,安卓下载指向新 APK;桌面安装包资产仍是 5.5.2,文案如实标注「启动后热更新到 V6.0.3」。

V6.0.0

网页端桌面端
V6 界面重构:纸面质感、克制描边与双色强调

网页端与桌面端的应用本体换成 V6 设计系统:票面、地图、工坊、珍藏册与年度报告统一到同一套排版、留白与强调色规则,去掉多余的阴影与渐变。

工坊草稿修复 + 更新门禁对齐

已有草稿时只读不写,导入与恢复不再覆盖正在填写的表单,旧票据草稿按原键名迁移;强制更新门禁统一读页面自身的版本常量,避免写死的旧版本号导致误报。

详细条目 (Changes) 4
  • 在线网页端换新:https://jidiandian.top/app/ 直接可用,页面内版本号为 V6.0.0,免安装、数据仍留在本机浏览器。

  • 桌面端热更新:release/latest.json 升到 6.0.0 并指向 release/TraceDot-V6.0.0.html;壳不重打包,5.5.2 用户启动后自动下载,重启即生效。

  • 门禁不误伤:页面自身的强制更新门禁读正式清单 /app/latest.json(安卓 5.5.2 / 554),6.0.0 不会被判为「有新版本」而挡住用户。

  • 安卓两条线不动:安卓正式版仍为 5.5.2(versionCode 554),安卓 V6 内测仍为 6.0.2,本次只升网页端与桌面端应用内容。

V5.5.2

网页端桌面端安卓端内测
恢复「申请内测版」入口,申请目标为安卓端 6.0.1 内测

网页端、桌面端与安卓端恢复 V5.4.x 的「我的 → 更多 → 申请内测版」:用途、通知邮箱、抖音关注与邮件通知字段保持一致,提交仍走 POST /api/beta/apply,后台「内测审批」实时出现待审记录。弹窗明确提示:本次申请的是安卓端内测,桌面与网页没有内测包。

通过后看状态与 6.0.1 内测包下载地址

申请页通过 GET /api/beta/status 展示待审 / 通过 / 拒绝 / 撤销状态;已通过或已授权用户直接拿到 latest-beta.json 对应的 6.0.1 安卓内测包下载地址。V5.5.2 自身仍走正式更新通道,不恢复会把整条链路短路的内测切换逻辑。

详细条目 (Changes) 5
  • 三端恢复入口:网页端 / 桌面端回到「我的 → 账号菜单 → 更多 → 申请内测版」,安卓端回到「我的 → 更多 → 申请内测版」;位置、文案、字段与 V5.4.x 一致,不新造 UI。

  • 申请链路接回云端:POST /api/beta/apply 生成 pending 记录,后台「内测审批」可见;生产 /api/beta/availability 与 latest-beta.json 已指向 jidiandian-6.0.1-beta1.apk。

  • 审批状态与下载:已通过 / 已授权用户可在申请页看到审核状态,并直接下载 6.0.1 安卓内测包;被拒绝或撤销后新版本可重新申请。

  • 仍走正式通道:V5.5.2 不切换本机内测通道,激活码云端校验、强制更新门禁与站内消息逻辑保持不变;三端版本统一 V5.5.2(APK versionCode 554)。

  • 强制更新影响:latest.json 升到 5.5.2 后,现网 V5.5.1 用户会被强制更新门禁要求升级到 V5.5.2,无法继续停留在 5.5.1。

V5.5.1

网页端桌面端安卓端激活码
激活码改为云端校验,内置本地码彻底移除

在线网页端、桌面端与安卓端统一提交 POST /api/activate 换发凭证,冷启动 POST /api/activate/verify 复验一次;只有云端明确返回停用 / 吊销 / 过期 / 耗尽才回激活门,网络失败不锁已激活用户。旧内置码 ajietudou-2026-jidiandian 的本地直放逻辑(含去空格 / 转小写的归一化命中路径)在三端一并删除。

后台可停用 / 吊销 / 延期 / 改备注

/admin 的「激活码管理」支持新建与批量生成、修改有效期、延期、启用 / 停用、吊销与备注;被停用或吊销的码在下一次校验即回激活门。强制更新门禁同步收紧,旧入口不再能跳过更新。三端版本统一 V5.5.1(APK versionCode 553)。

详细条目 (Changes) 4
  • 激活码改为云端校验:POST /api/activate 换发 token,已激活用户冷启动时 POST /api/activate/verify 复验一次;只有云端明确返回 CODE_DISABLED / CODE_REVOKED / CODE_EXPIRED / CODE_EXHAUSTED 才回到激活门,网络失败保持已激活状态。

  • 移除内置本地码:三端删掉 ajietudou-2026-jidiandian 的本地直放逻辑,该码不再能激活,也不能绕过门禁。

  • 激活码后台可控:新建 / 批量生成、改有效期、延期、启用 / 停用、吊销与备注都在 /admin 完成,改动即时生效。

  • 强制更新门禁与版本号:三端以云端清单为准检查更新,旧入口不再能绕过;在线网页端、桌面端、安卓端统一 V5.5.1,APK versionCode 553。

V5.5.0

上一版本网页端影演票工坊电影票
影演票工坊加入五套电影票面

幸福蓝海、猫眼·CGV、中影、万达、淘票票五套真实票面接入既有「样式」条,与经典 / 票根 / 数字票 / 邀请函 / 场记票并列,可切换、可出图;猫眼猫头与淘票票满版水印按原设计保留。

入册信息新增影厅服务费 / 售票时间 / 工号

电影票「入册信息」新增三个字段:影厅服务费(venueFee)、售票时间(saleTime)、工号(staffNo,中影与万达票面显示)。保存、再次编辑回填与珍藏册详情同步;字段为空时票面整体隐藏该行,不再出现空白占位。

详细条目 (Fixes) 4
  • 五套新票面补实心纯白底:票面容器与票面本体都铺 #fff,带 mix-blend-mode:screen 的反射光晕在新票面下关闭,下沿不再透出淡绿。

  • 入册信息改动后票面即时刷新:输入走 80ms 防抖,切换样式与保存立即重绘,不用再手动切一次票。

  • 手机端排版:360 / 390 / 430px 下票面不溢出、样式芯片正常换行、新增字段不挤压、底部按钮不被导航栏遮挡。

  • 版本检测与账号面板:「检查新版本」跟随本机 APP_VER,不再误报「有新版本」;网页端短接内测层只保留激活码门禁;账号面板补回「修改密码」、昵称头像云同步与 syncEnabled 判断(与 V5.4.1 对齐)。

V5.4.2

上一稳定版安卓端铁路查询布局修正
查询区收到导航栏顶边

铁路查询内容区高度改为「屏幕高 − 浮岛高 − 浮岛下边距 − 安全区」,列表与结果卡片到导航栏上方即结束,最后一行不再被底部浮岛压住。

数据来源收成一行,页签贴住屏头

屏头的橙色说明条收成单行「数据来源:RailGo 开放数据」,挂到「铁路查询」标题右侧最边上;正文整体上移,车次查询 / 车站查询 / 动车组查询 / 列车图鉴四个页签框定在屏头下方。

详细条目 (Fixes) 2
  • 修复铁路查询底部遮挡:查询区止于浮岛顶边,底部的车次 / 车站结果最后一行的文字与操作完整可见,不再被导航栏压住。

  • 屏头改版与页签收口:数据来源文案精简为「数据来源:RailGo 开放数据」,经 noteInHead 挂到屏头右侧;.ws-note-head 单行药丸不挤压标题,四个查询页签固定贴在屏头下方。

V5.4.1

稳定版网页端桌面端安卓端云端同步
云端同步正式开放:备份 / 恢复 / 历史回滚

原先只在预发线开放的零知识加密备份并入正式版:网页端 NO_SYNC = false、安卓端 CLOUD_SYNC_ENABLED = true。密码与数据密钥都不出本机,云端只存密文备份包;新增自动同步——启动时补拉昵称与头像,数据改动后自动上传,换设备也能接着用。

激活码门禁保留,启动链收口

首次打开仍需输入激活码:网页端单文件的门禁脚本与激活码清单原样保留(通过一次写入本机记忆,之后不再询问),安卓端 gate-screen 照旧是启动第一步。启动链固定为激活码 → 云端账号登录 → 主界面,未激活时只渲染激活门、应用其余部分整体不显示。

详细条目 (Features & Fixes) 6
  • 云端同步正式开放:备份到云端、从云端恢复、历史版本回滚全量可用;网页端与安卓端同一套密文格式,跨端可互相恢复。

  • 自动同步:进入主界面即补拉一次云端资料(昵称 / 头像),账本改动后自动上传,不需要再手动点「备份」。

  • 激活码门禁保留:网页端单文件的激活门脚本、激活码清单与 jdd-beta-gate.v1 记忆逻辑原样保留;安卓端 src/screens/gate-screen.js 与路由 / 屏元数据一并保留,启动时先读激活记忆,未通过只渲染激活门,通过后再按「本机数据密钥 + 会话」决定进主界面还是账号登录门。

  • 安卓端图标全部重绘并视觉对齐:45 枚内联 SVG sprite 按 24 网格 / 1.8 描边 / 3.4–20.8 安全框统一重画;显示尺寸收口到 12 / 14 / 16 / 18 / 20 / 24 偶数档,图标间距两档(6 / 10),下拉箭头与返回箭头共用同一枚。

  • 修复安卓端顶部泛白:删掉 body::after 那层全屏白色斜向流光(position:fixed;inset:0,沉浸式下状态栏区域没有卡片压住就成了白膜),并把顶部极光收紧、透明度下调。

  • 修复行程地图 / 铁路查询全屏:界面大小调到「宽松 / 更多」后按钮不再被裁掉,全屏跟随界面尺寸自适应;底部改用与行程地图一致的模糊遮罩,去掉滚动进度条与多余的限位框。

V5.3.1

稳定版网页端桌面端安卓端账号体系
云端账号上线:注册 / 登录 / 找回密码 / 内测申请

网页端、桌面端与安卓端首次接入统一账号:邮箱 + 密码注册,注册后立即给出恢复码用于找回密码;登录后账号邮箱常显,可申请内测版并从云端读取审批状态。密码不出本机,账号与内测状态存云端,行程账本、快照与设置继续只存本机——稳定版不写云端。

「我的」界面改版:顶栏账号面板

头像改成点头即换(本机裁方压到 192px 再落库),昵称就地编辑、失焦即保存;修改密码、申请内测版与退出登录收进右上角「三道横杠」账号菜单,旧「编辑我的资料」弹窗下线。安卓端同步这套版式(versionCode 548 / versionName 5.3.1)。

详细条目 (Features & Fixes) 5
  • 云端账号(网页端 / 桌面端 / 安卓端):邮箱注册、登录、找回密码(注册时下发恢复码);登录后昵称与头像从云端回填,换设备也能认出是你。数据密钥与密文不落云端,密码不出本机。

  • 「我的」界面改版:顶栏换成账号面板——头像点一下就换(选图 → 本机裁方 → 192px 落库),昵称就地编辑,账号邮箱常显;修改密码、申请内测版、退出登录收进「三道横杠」菜单,旧「编辑我的资料」弹窗整体下线。

  • 内测通道:登录后可查看当前通道(正式 / 内测)与内测版本号,提交内测申请,审批状态从云端读取;内测权限被撤销时回到正式通道。

  • 云端同步暂未开放:稳定版保持零云端写入——安卓端「备份到云端」提示「暂未开放该功能」,网页端云端同步区块整块关闭(NO_SYNC = true),行程数据仍只存本机。

  • 发布方式:网页端单文件 release/TraceDot-V5.3.1.html(约 12.2 MB);安卓完整包 app/jidiandian-5.3.1.apk(versionCode 548),更新清单 app/latest.json 同步指向新版。

V5.3.0

稳定版安卓端网页端桌面端全量覆盖更新
导出图片直接进系统相册

票面与行程地图导出的 PNG 原来只落在应用私有的 Documents/迹点点/导出/,安卓 10+ 分区存储下系统相册扫不到。新增原生插件 GallerySaver:Android 10+ 走 MediaStore 写 Pictures/迹点点/(RELATIVE_PATH + IS_PENDING),9 及以下写公共 Pictures 目录后触发媒体扫描;Web 侧只把 CACHE 临时文件的路径交给原生(不过 bridge 传 base64),写完即删,旧底包缺该插件时自动回退到「Documents + 分享面板」。

行程地图:GPU 拖动 + 双指缩放

拖拽 / 捏合期间不再逐帧改 viewBox(整幅 SVG 每帧重栅格化正是卡顿主因),改为给包裹层 .jdd-map-layer 挂 translate3d / scale 走合成器,抬手时把位移与缩放一次性并进 viewBox,视觉位置一致且边缘不回弹;双指捏合以两指中点为锚点,松掉一指自动回落拖拽,假横屏的 90° 旋转也做了逆旋转换算。

详细条目 (Features & Fixes) 13
  • 网页端 / 桌面端换上安卓同款「液态玻璃」皮肤(2026-10-28):不做逻辑改动,只在页头注入一层覆盖样式并替换地图底色的两处 SVG 渐变,把设计令牌换成安卓端口径——暖灰底、墨色四级文字、荧光黄高亮、橙色主按钮、高模糊高饱和的玻璃面板。主操作橙渐变实心、次级操作玻璃幽灵、状态芯片选中态荧光黄实心;输入框统一 36px 高白玻璃配橙色聚焦光晕;底部导航坞与地图工具条改为近白玻璃浮岛。内容文件 release/TraceDot-V5.3.0.html,桌面端热更新清单同步指向 Gitee Release 资产。

  • 更新方式改为「全量覆盖更新」:取消内容包热更新,每次发版都是完整 APK。原生侧移除 HotUpdater / HotUpdatePlugin 与底包内容目录映射,Web 侧移除 hot-update.js、内容更新弹窗与构建号模块,打包脚本 pack-hot-bundle.mjs 一并删除——底包 APK 即完整应用,不再有「内容包」这一层。

  • 「我的 → 版本更新」直接给下载链接:点「版本更新」拉 app/latest.json,只比 apk.versionCode;有新版弹应用内卡片「发现新版本 vX.Y.Z」,按钮「立即下载」直接打开 APK 下载直链——不进官网、不发浏览器首页;没有新版提示「已是最新」。清单只剩 apk 段(versionCode / versionName / url)。

  • 状态栏不再压住正文(全色沉浸):原来只靠 env(safe-area-inset-top) 让顶部内容避让,而 Chromium 的 safe-area 只反映「屏幕刘海」——没有刘海的机型算出来是 0,edge-to-edge 下标题直接顶到状态栏上,于是「有的机型正常、有的机型重叠」。现启动时读状态栏真实高度(StatusBar 插件 getInfo().height,已按 density 换算成 CSS px)写进 --safe-top,只抬高不降低;底图(极光 / 卡片底)依旧铺满到屏幕最顶端,只对正文限位。

  • 版本号只显示产品版本:我的 → 版本更新、页面底部品牌行、「关于迹点点」统一显示 v5.3.0,去掉 · VC 539 这段构建号——构建号只参与更新判断,不再给用户看。

  • 老底包收不到更新:「版本更新」原来只比 versionName,构建号变了但版本名没变(vc533 → vc536 就是这种情况)会一直判成「已是最新」。现改为比 versionCode(App.getInfo().build),并换成应用内确认卡(window.confirm 在安卓 WebView 上不可靠)。

  • 官网与文档同步:官网首页、更新日志页、README、致谢与仓库目录树中的「内容包 / 热更新」章节统一改写为「全量覆盖更新」,发布路径简化为 app/latest.json + 完整 APK 两个文件。

  • 暗色模式:跟随系统 prefers-color-scheme。玻璃体系只翻 token(墨色四级 / 白玻璃三档 / 表面层 / 描边 / 阴影),另补底栏、选中态白片、下拉、弹窗、日期时间面板、珍藏册、计划、导入卡片与行程地图(暖海纸面 → 深海夜色,国土渐变、标签描边、南海诸岛附图一并换暗色同族)的暗色覆盖;票面预览保持亮色纸面。状态栏改 DEFAULT 随系统切图标明暗,首帧底色与 theme-color 也分了深浅两套。

  • 长行程 AI 规划(15 / 30 天都能排):原来固定 max_tokens: 3500 把整份行程塞进一次回复,超长必然被截断——用户要 15 天只回 8 天正是这个原因。现在先解析需求里的天数(支持「15 天 / 十五天 / 两周 / 一个月」,上限 45 天),超过 6 天改为每 5 天一批分批生成、逐批合并并按天重编号;生成中显示真实进度「已排好 x / y 天」,不足天数会标记并提示。

  • 年度报告间距:年份胶囊与下方「行程段数 / 累计里程 / 到访城市 / 累计花费」统计大卡之间补 12px 间距,不再贴在一起。

  • 行程地图屏头瘦身:去掉「搜索行程」「添加行程」两个旧入口及其跳转(老旧代码),空态文案改为指向账本与工坊。

  • 发布方式(全量覆盖更新):完整 APK https://jidiandian.top/app/jidiandian-5.3.0.apk(versionCode 540);更新清单 https://jidiandian.top/app/latest.json(只有 apk 段)。每次发版都要抬 versionCode,判断只认「大于本机 versionCode」。

  • 致谢补充安卓运行环境:Capacitor 8 及其官方插件(MIT)、AndroidX(Apache-2.0),已在官网致谢与 CREDITS.md 同步。

V5.2.4

稳定版热更新
火车票智能联想恢复

站点补全面板调用的 stationsData 从未被定义——真正的数据在 JDD_STATION_CITY 对象里,从未被转换成 ||| 分隔的 0|站名|城市|~|~ 格式,输入车站时下拉菜单永远为空。现由 jddBootInto() 在加载火车票载荷时同步构建 stationsData 并注入 iframe head,中文 / 拼音 / 首字母三种匹配全部恢复。

车次自动填充走双域名容错

原 __autoFillTrain() 在 file:// 协议下请求外部 API 被 CORS 静默拦截。现改为双域名容错(rail.moefactory.com → sharyou.moefactory.com),请求带 credentials: 'omit' 与 Accept: application/json,兼容 data.data / data.list / data.result 三种返回包裹与 beginStationName / startStation / departureStation 等常见字段别名。

详细条目 (Fixed) 4
  • 智能联想补全:jddBootInto() 加载火车票载荷时从 JDD_STATION_CITY 构建 stationsData(||| 分隔的 0|站名|城市|~|~),以 <script> 片段注入 iframe head;中 / 拼音 / 首字母三种匹配全恢复。

  • 车次查询双域名容错:__autoFillTrain() 依次尝试 rail.moefactory.com 与 sharyou.moefactory.com,请求带 credentials: 'omit' 与 Accept: application/json;返回结构兼容 data.data / data.list / data.result 三种包裹,字段名兼容 beginStationName / startStation / departureStation。

  • 三态用户提示:toast 显示「正在查询车次信息…」/「车次信息已自动填充」/「车次查询失败」,失败时 console 输出域名、状态码与响应体便于排查。

  • base85 载荷编码器修正:早期版本的截断逻辑 out[:-(5-pad)] 多砍一位,导致 gzip 解压报 EOFError;现改为按 (4-pad)*5 + 3 计算保留位数,编码长度与 RFC 1924 一致,往返校验通过。本版为纯内容热更新(清单号 5.2.4),体积 12,490,080 B(+856 B)。

V5.2.3

稳定版热更新
珍藏册「重新编辑」跳转按票种路由

珍藏册点「重新编辑」会按记录票种跳回对应工坊:船票此前因路由表漏判被误送至火车票工坊,现修正为交通票工坊,且跳转后表单自动切回船票票种(船名/航次/出发港/到达港等字段一并预填,航次框不再被船名前缀污染)。同时补上船票在珍藏册里的独立筛选 chip、专属船形图标与配色——此前筛选条里没有「船」,卡片只能落到「其他」图标。公交/地铁/出租车/客运/火车/航班/影演票种路由与呈现不变。

自动化回归验证

playwright 端到端对比测试:同一船票记录分别驱动 V5.2.2(修复前,复现误跳火车票)与 V5.2.3(修复后,正确跳交通票工坊),路由结果与字段预填状态全部符合预期。

详细条目 (Features & Fixes) 5
  • 珍藏册「重新编辑」路由表补充船票种,与外壳侧票种映射保持一致,船票不再落入火车票默认分支。

  • 珍藏册筛选条票种顺序补入船,船票拥有独立筛选 chip;同步补上船形图标与专属配色(#2F6BD8),卡片不再显示「其他」图标。

  • 珍藏册单点路线行的交通类判定补入船:缺到达站的船票改为显示出发港,不再把「船名 + 航次」当主标题。

  • 交通票工坊预填优先按账本 kind 字段精确定位票种(船 → ferry),修掉「跳转正确但表单停留公交」的次生问题;航次框填值前剥掉船名前缀,船名单独回填。

  • 本版为纯内容热更新:已安装桌面客户端自动更新内核;热更新清单版本号 5.2.3。playwright 端到端验收 15 项全通过。

V5.2.2

稳定版热更新
登机牌模板切换不再串色变形

修复切换票面模板后切回经典票无法恢复默认设计的问题——卡片上会残留上一个模板的类名与布局属性,经典票面被新模板样式渲染导致串色、变形。切回经典时现会同步重置卡片模板态,6 样式 × 10 组多轮切换全部回到各自默认设计。

渲染入口增加白名单校验

模板渲染函数入口增加模板名白名单校验,异常模板名自动回退经典票面,防止未来样式表扩展时的渲染错乱。

详细条目 (Fixed) 2
  • 修复模板切换状态残留:切回经典票时重置卡片模板 className 与 data-layout,不再被上一个模板的 CSS 规则污染。

  • 纯内容热更新:清单号 5.2.2 大于 5.2.1,已安装客户端启动自动拉取;6 样式 × 27 组合 FIT 探针全部 PASS。

V5.2.1

稳定版热更新
火车票票面字体修复

票面基准字体栈去除系统字体别名(-apple-system / BlinkMacSystemFont)——系统默认字体被设置为 MiSans 的设备上,票面不再被同化,恢复确定性票面字体;工坊界面字体不受影响。

登机牌新票面补齐 Logo 与头部布局

P1–P5 新票面支持 Logo 展示三模式(矩形框 / 纯图 / 圆形)与头部四布局(纵向居左 / 居中、横向居左 / 居中)切换;修复 Logo 显示不完整(系统 / 自定义 Logo 均受影响);两项设置随珍藏册记录全链路持久化。本版为覆盖更新(清单号 5.2.1,下载地址沿用 v5.2.0 资产)。

详细条目 (Fixed) 3
  • 修复新票面 Logo 溢出裁切:图标按容器尺寸等比缩放,系统航司 Logo 与自定义上传 Logo 均完整显示。

  • 6 样式 × Logo 模式 / 头部布局 / 缺省字段 / 自定义 Logo 共 42 组合自动化探针全部 PASS,经典票回归通过。

  • 覆盖更新:清单号 5.2.1 大于 5.2.0,已安装客户端启动自动拉取;下载地址与文件名保持不变。

V5.2.0

稳定版热更新
登机牌工坊新增 5 套纪念票面

P1 瑞士极简(大留白细线、84px 航段码)、P2 夜航航显(深色信息屏 + 机型/注册号/准点率仪表行)、P3 复古纸票(米纸双线框 + 打孔边 + 航司圆章 + 点线引导)、P4 晨曦渐变(航司色渐变头 + 玻璃药丸 + 统计条)、P5 登机口存根(主票 + 竖排存根双联、冲孔虚线、三级大字)。全部 MiSans 字体、跟随航司主题色换色。

样式选择条 + 自定义 Logo

与交通 / 影演票工坊同规格的「样式」选择条(经典 + P1–P5),样式随草稿与珍藏册记录持久化、缩略图全链路同款;Logo 区新增自定义上传(任意图片压至 128px,优先于 40+ 航司预设,可一键恢复,随记录入册还原)。新样式读取起降时间 / 航站楼 / 机型 / 里程 / 票价 / 准点率等入册字段增强展示,未填自动隐藏。

详细条目 (Features & Fixes) 4
  • 五套新票面以航司主题色驱动换色(自定义主题色同样生效),入册详情字段未填写时对应展示位自动隐藏,不留空坑。

  • 自定义 Logo 图片等比压缩至 128px 存储,三种 Logo 展示模式(矩形框 / 纯图 / 圆形)继续可用。

  • 6 样式 × 常全字段 / 缺省字段 / 自定义 Logo 共 18 组合自动化探针(内容溢出 + 日期/时间折行双检测)全部 PASS,经典样式回归通过。

  • 本版为纯内容热更新:已安装桌面客户端自动更新内核;热更新清单跳板号 5.2.0 与界面显示版本重新对齐。

V5.1.6

稳定版热更新
32 套纪念票面进工坊

交通票工坊新增20 套(公交 / 地铁 / 出租 / 船票 / 客运各 4 套),影演票工坊新增12 套(电影 / 演唱会 / 景区各 4 套)。新票面内置真二维码与 Code39 条码渲染,换色跟随城市自动配色,条码 / 票号 / 大写金额按填写内容实时生成;海报与景区图沿用工坊图片层(含裁剪定位)。

全局 MiSans 视觉对齐

32 套新票面字体栈统一切换为MiSans并整体上调字号等级;公交「班车票」重构为上下车站左右并排、站名放大铺满整行;修复取票码区域样式泄漏形成的黑块、「长卷」景区票右侧信息区缺失、启用日期折行与 6 张固定高度票面底行裁切。32 案例自动化探针(溢出 + 折行双检测)全部归零。

详细条目 (Features & Fixes) 4
  • 工坊配色条下新增「样式」选择条(经典 + 新样式,双主题适配);所选样式随记录持久化,珍藏册缩略图与示例图全链路透传同款样式。

  • 电影「数字票」取票码区域被工坊同名根类样式污染的问题修复(类名冲突导致深色药丸背景、文字不可读)。

  • 地铁「一日通票」启用日期折行、公交「班车票」日期时间整行被裁等问题修复;固定高度票面按实测溢出量逐一补偿。

  • 本版为纯内容热更新:已安装桌面客户端的用户无需重新下载安装包,启动应用后自动更新到最新内核。

V5.1.5

稳定版回归修复
放大后站名不再爆大

缩放补偿写成了 CSStransform,而 CSS 的translate()必须带单位 —— 无单位写法属于无效声明,会被浏览器静默丢弃,于是整组补偿从未生效:放大时城市圆点、站点圆点、站名一起跟着地图放大。改用 SVG 原生transform属性后,放大21.9 倍站名仍 15 px、圆点仍 5.7 px。

内容更新看得到进度

桌面端内容热更新只换约 12 MB 的 HTML,原来从点「下载」到「重启生效」中间毫无反馈,慢网下像卡死。现在有无边框进度窗(进度条 + 百分比 + 已下载 / 总大小),进度同步到任务栏 / Dock 图标;壳安装包更新也复用同一个进度窗。

详细修补条目 (Bug Fixes & Refinements) 3
  • 巨型文字回归已修:站名、城市名、站点圆点的缩放补偿改用 SVG 原生transform属性,放大到 21.9 倍屏幕上尺寸仍恒定。

  • 下载进度可感知:内容更新与壳更新都显示进度条、百分比与已下载 / 总大小;任务栏 / Dock 图标同步进度,完成或失败自动关闭并清空进度。

  • 下载器两处隐患:重定向的Location为相对路径时不再抛Invalid URL;跟随重定向前先等旧流关闭并清理半成品,不再出现rename报ENOENT。

V5.1.4

历史版本深度修复
城市不再点错省

城市匹配原来是子串判断,昆山南会命中西藏「山南」、大兴命中「大兴安岭」。现在改为前缀锚定,并新增构建期「站点 → 城市」显式映射表3267 站(由 12306 所属城市 + 底图市级轮廓判定生成),运行时 O(1) 查表,跨省误配彻底消失。

缩放拖动更跟手

SVG 实时滤镜每帧重栅格化是卡顿主因 —— 交互期自动摘除、松手 180 ms 后恢复。城市与站点改父级整组transform补偿(DOM 写入由 3~4N 降到 N),绘图加数据签名跳过重复重建,滚轮布局读取并入 rAF。

详细修补条目 (Bug Fixes & Refinements) 9
  • 首屏空白已修:输完激活码进入首页,地图与列表原来不渲染,桌面端还得关掉软件重开才生效。根因是激活门禁只把「已通过」标志设上、没有回调应用启动(启动段在页面加载时早已按空标志跳过)。现在通过后立即启动,并且在布局恢复、地图拿到真实尺寸之后再绘制。

  • 激活码不再明文:输入即显示为圆点,旁人看不到你输的是什么。

  • 登机牌舱位可自定义:舱位下拉原来只有 13 个固定选项,P / D / R / E 这类常旅客舱位填不进去。现在多了「自定义…」,选中后直接填字母;从账本回填时,舱位不在预设里也不会再被悄悄清空。

  • 姓名拼音全自动:拼音字典从约 350 字扩到20892 字,「晓 / 蕊 / 钰 / 珩」这类字不再漏拼;并按姓氏读音处理曾 ZENG、单 SHAN、解 XIE、仇 QIU,欧阳 / 尉迟等 44 个复姓整段连写。改中文名时拼音会一直跟随,只有你自己动过拼音框才停止覆盖。

  • 有点不亮:城市坐标表补 54 城(景洪、香格里拉、康定、瑞丽、喀什等),坐标表 377 → 431;就近吸附容差 130 km →65 km,另立 150 km 专管误配排除,偏远小站不再丢点。

  • 城市归属可手动指定:编辑器补「出发城市 / 到达城市 / 出发三字码 / 到达三字码」四个字段;归属优先级改为 显式填写 > 权威映射表 > 站名推断(过 150 km 校验)> 记录 city > 最近城市。

  • 21 站归属与 2 处坐标纠正:逐站「轮廓判定 + 行政归属」复核,修正大兴安岭 3 站、抚远 3 站、酒泉 8 站等共 21 处;磨丁坐标原错标在香格里拉旁、冠豸山南原错标在南昌市中心,均已按真实经纬度重投影。

  • 安全加固:年份下拉、颜色字段、备份导入的数值字段全部收口转义 —— 一份恶意备份不再能在行程列表或年度报告里执行脚本。

  • 稳健性:快照键改为严格递增,同毫秒连续快照不再互相覆盖;删除从未生效的.g-lit死代码查询。

V5.1.3

历史版本问题修复
航司 Logo 不再串票

珍藏册缩略图由离屏登机牌 iframe 逐条「采样渲染」,采样载荷planeSample()漏了airline字段,渲染时沿用上一张票的航司状态。现在采样与「重新编辑」预填都带上航司,采样前显式清空,预览缓存pv1 → pv2旧图整体作废。

出发 / 到达不再标反

落点函数原来无条件优先记录里的机场三字码,改过城市、旧码没清掉时点会落到另一座城。现在名称与三字码各算一份坐标,相距超过 300 km 以名称为准;同名车站按「站名 + 空/铁」分开,地名匹配取最长(最具体)的键。

详细修补条目 (Bug Fixes & Refinements) 5
  • 航司 Logo 与所选航司不一致:采样与预填带上airline,采样前显式清空航司与配色,不再继承上一张;预览缓存版本pv1 → pv2,旧图作废重画。

  • 地图出发地 / 到达地标反:名称与三字码相距超过 300 km 时以名称为准,地图点选定位tripEndXY()同步改为同一口径。

  • 同名车站被合并:按「站名 + 空/铁」区分,「上海虹桥」机场与火车站不再合成一个点;坐标完全相同时仍只保留一个,避免叠点。地名子串匹配统一取最长键。

  • 官网 logo 在线加载失败:顶部与页脚 4 处 logo 原为 Google 外链,改为内联品牌 SVG(data URI),零外部请求、离线可用。

  • 桌面端同步到 5.1.3:package.json/package-lock.json/main.js版本号改为 5.1.3,打包源指向release/TraceDot-V5.1.3.html。

V5.1.2

问题修复
六处问题一次修完

AI 设置弹窗的四个关闭监听原本挂在TV.init()末尾,初始化抛错时永远绑不上;三个工坊的预览票面 sticky 吸顶,与「入册信息」分两层滚动;香港西九龙站坐标误写成山东半岛;火车票工坊站点表仍是「重庆南」;跨城行程终点沿用起点城市导致香港不点亮;站名拼音把「重庆东」拼成 Chongqing。

bindModal()Xianggangxijiulong
地图拖动 / 缩放更顺滑

标签不再逐帧改font-size+x/y(会让每个文本重新排版取字形),改为transform围绕所属点缩放;屏幕矩形缓存 120ms;线路流光只在缩放变化 ≥3% 时更新;视角无变化时整帧跳过。外观与交互结果不变。

transform120ms cache
详细修补条目 (Bug Fixes & Refinements) 5
  • 弹窗关不掉:改为幂等的bindModal(),初始化开头与设置面板打开前各兜一次;历史数据强制归一为数组,单条坏记录不再中断整个init()。

  • 票面与入册信息一起滚动:撤掉登机牌 / 交通票 / 影演票三个工坊的吸顶,票面与入册信息成为一个整体,向上滑动时一起上移。

  • 地图数据修正:香港西九龙按真实经纬度重算为[907.8,767.2],与深圳北、深圳相邻;城市归属改为「先看地名、再信记录的 city」,并补香港中心坐标与省色。

  • 二维码叠图:每次重绘分配画布代次、一帧只允许贴一张码,新重绘先clearTimeout掉上一帧定时器,透明底旧码不再从新码空隙里露出来。

  • 桌面端同步到 5.1.2:package.json/package-lock.json/main.js版本号改为 5.1.2,打包源指向release/TraceDot-V5.1.2.html。

V5.1.1

激活码门禁
首次打开需激活码

未授权的分发与传播现在有了一道闸门:首次打开需要输入激活码,通过一次后本机记住、之后直接进入;未通过时应用整体不启动。校验在本机完成,不联网、不上传任何信息。

jdd-beta-gate.v1__JDD_BETA_OK__
网页版与桌面版同一套门禁

门禁不是只加在网页版:桌面端打包的是同一份文件,同一套判定、同一种记忆方式。单文件离线可用,同时单机校验意味着不依赖服务端,离线环境也能正常通过。

Electron 33Web + Desktop
详细修补条目 (Bug Fixes & Refinements) 4
  • 不落明文:激活码本身不进代码,只存一份 djb2 摘要做比对;记忆写进 localStoragejdd-beta-gate.v1,并提供window.jddBetaReset()便于重新验证。

  • 未通过时不执行任何启动逻辑:原 V5.1.0 的启动调用(TV.init()、TICKET.init()、years()、render()、select(0, true))整体包进if (window.__JDD_BETA_OK__),锁屏期间不会先渲染再收起。

  • 桌面端同步到 5.1.1:package.json/main.js版本号改为 5.1.1,打包源指向release/TraceDot-V5.1.1.html;主进程去掉 V5.0.48 专属的「切换性能模式」菜单,保留ignore-gpu-blocklist/enable-gpu-rasterization两个 Chromium 开关、ready-to-show启动、v8CacheOptions: 'code'与刷新率注入(都是通用优化,V5.1.1 仍受益)。

  • V5.0.48 入口关闭:新版本发布后,V5.0.48 的下载入口与在线访问入口同时下架(GitHub Release 资产移除、官网在线应用改指 V5.1.1),避免新旧两条线并行分发。

V5.1.0

次版本 · 数据契约变更
车站坐标 14 → 3267

STATION_XY由 14 个站扩到3267 个(12306 现役客运站 99.8%),45 个主要枢纽全部有坐标(含此前缺的常州、沧州、香港西九龙、成都天府);JDD_APT_XY591 →592(国内 319 换 OurAirports Unlicense,境外 273 条原样保留)。放大后终于能落到具体车站,而不是只到城市级。

STATION_XY · 3267ODbL
足迹分母与线路详情

统计条不再只有绝对值:「点亮城市2 / 369 座」「点亮省份1 / 33 个」——分母从底图实算(数市级面,直辖市与特别行政区合并计 1),不写死在代码里。行程每行新增「详情」,给出历时 / 均速 / 单价:G1234 北京南→上海虹桥 08:00→12:30、1318 km、¥553 → 历时 4 小时 30 分、均速 293 km/h、单价 42.0 元/百公里。

369 / 33Detail Modal
详细修补条目 (Bug Fixes & Refinements) 4
  • 年份图例与 A4 打印:图层开关打开后线路改按出行年份上色,图例列出「年份 → 颜色 → 段数」,12 色固定分配、同一年永远同色;打印走纯 CSS@media print(不引任何库),打印态自动隐去地图与导航,只留报告正文。

  • 内嵌投影能力装回:经纬度 ⇄ 画布坐标互转(geoXY/geoLL,二次多项式,挂window.jddGeoXY)。没有套残差修正表——留一法实测不修正平均误差 1.75px,任何修正方式 1.91~2.72px 反而更差;根因是重庆残差模长 20.78px 而中位数仅 1.06px,且「真值」是市区中心、底图「重庆」是整个直辖市重心,语义不同,硬修会把小误差城市的点带偏。

  • ODbL 义务落实:数据源与署名写进代码内注释块与文档数据源与署名_V5.1.0.md(含「如何确认遵守义务」自检三条):OSM 节点 2870 站 ODbL 1.0、CC0 补缺 394 站、OurAirports 机场 Unlicense、12306 站名册 3269 站。CC0 库含过期条目(如「济南东」为胶济线老站),只用于补缺,并通过「距 12306 所属城市中心 >120km 则弃用」筛掉 3 个可疑坐标。

  • 版本号为什么是 5.1.0:本次改了坐标数据契约(车站表换源扩容、机场表换源),按既定规则属「数据契约变更」,升次版本而非补丁号。基线为 V5.0.47,V5.0.x 全部 47 个版本 HTML + 31 份过程文档已归档至归档_V5.0/。

V5.0.48

性能优化 · 弱显卡适配
自适应性能模式

在 Intel 核显的 Mac 上「特别卡」的机型,现在会自己降级:启动后采样 90 帧,拿实测帧时间对比屏幕刷新率折算的标准帧长,p75 超过 1.75 倍且高于 22ms、或长帧占比过三分之一,连续两轮命中才切性能模式;命中 WebGL 软件渲染(SwiftShader / 基础渲染驱动)则直接切。降级只动大面积滤镜与装饰动画——整窗blur(80px)光晕、26–34px 毛玻璃收到 8–10px、logo 三层 240px 投影收成一层、导航流光与地图循环动画暂停——不改布局、不改配色。

jddPerfAuto Eco
拖拽缩放不再掉帧

地图的投影滤镜挂在.g-land整组上,而组里还有无限循环的线路动画 —— 等于缩放时整块 1100×800 的drop-shadow每帧重算。现在viewBox连续变化期间只关滤镜(不隐藏任何图层,阴影色块不会中途消失),停顿 180ms 后自动恢复,静态观感不变。

map-busyMap Filter
详细修补条目 (Bug Fixes & Refinements) 3
  • 桌面端显卡兜底:主进程加ignore-gpu-blocklist与enable-gpu-rasterization—— Chromium 会按驱动版本把一批 Intel 核显列进黑名单,命中后整窗退回软件合成,这是「特别卡」最常见的根因;窗口改为首帧就绪后再显示(ready-to-show),并开启v8CacheOptions: 'code'缓存 12 MB 内联脚本的编译结果。

  • 不会误伤 30Hz / 120Hz 屏:判定不看绝对帧时间,而由主进程把displayFrequency注入渲染进程,按刷新率折算基准帧长再看倍数;22ms 的绝对下限则保证 ProMotion 屏只跑 60fps 时不会被当成卡顿而降级。

  • 随时能改回来:桌面端「帮助 → 切换性能模式」,应用内Ctrl/Cmd + Alt + P,网页版?perf=eco/?perf=full;自动降级时会弹一条带「改回原样」的提示,选择记进 localStorage。

V5.0.47

液态玻璃 · 安全收口
液态玻璃导航

右上导航胶囊由「半透明白胶囊」改成四层玻璃:半透明渐变底 +blur(34px) saturate(200%)、上缘受光 / 下缘收光、静态镜面高光,再叠一层 14s 极慢流光(只动 transform,走合成层,不逐帧重算模糊)。选中项保留品牌绿但改为透光绿玻璃珠(顶部镜面 + 内白边 + 绿色外发光),下拉菜单同步同一套玻璃语言。

Liquid GlassDock · Pop
线路动效与图标可见

飞机 / 火车图标「看不见」的根因找到了:一条prefers-reduced-motion: reduce把.rail-flow / .air-flow整层display:none,系统一开「减少动效」就一个不剩。现在改成图标始终沿线路运行,铁路虚线自己流动(1.35s/周期),航班实线上再叠一条 3s 周期的流光虚线,不动发光层以免每帧重算模糊。

rail-flowMap Motion
详细修补条目 (Bug Fixes & Refinements) 4
  • 摄像头扫描下线:登机牌工坊删掉整条拍照链路(页面区块、相机弹窗、.scan-*样式、getUserMedia与拍照识别、四处事件绑定、Esc 关闭),保留图片上传 + AI 视觉识别。

  • 导出图不再留白边:预览靠 CSSscale(1.015)+overflow:hidden裁掉四周,导出走的却是不裁的原始画布。新增__jddCropCanvas()(1.5% 居中裁切再放回原尺寸),接入单张保存、批量 2x、双面合并、PDF 正背面、缩略图共 6 处,端到端实测四边边缘带1/1/4/4px → 0/0/0/0。

  • 票面材质与 PWA:交通票 / 影演票的 HTML 票面叠加 SVGfeTurbulence纸张颗粒(零位图开销);补齐 theme-color / SVG 图标 / apple 全屏声明 / data-URI manifest,放到 http(s) 上即可被安装。

  • 全链版本号同步:官网、更新日志、单文件网页版、本地缓存与离线 ServiceWorker 全线统一至V5.0.47正式生产标号;本日志第五阶段同步补齐 V5.0.2 → V5.0.47 共 46 次迭代。

V5.0.43

安全评审 · 第一批修复
存储型 XSS 修复

年度报告「这一年之最」三张卡没有转义(车次 / 出发站 / 到达站),导入一份恶意备份就能在年报里执行脚本。已用esc()收口,PoC 复测由「能执行」降至0 次。

S1 · XSSesc()
导入上限与 CSP

备份导入加 30MB / 5000 条上限(原本定 2 万条,压测发现upsert是 O(n²) 会把页面拖死);补上object-src / base-uri / form-action三条低风险 CSP 指令,挡住插件内嵌、<base>劫持与表单外发。

S4 · LimitCSP
详细修补条目 (Bug Fixes & Refinements) 2
  • 云 OCR 有提示:选用联网 / Agnes 引擎时会明确提示「这张照片会上传到对应服务商」,不再静默上传。

  • 按决定保留(未修):内置 API Key 可被静态提取、本地数据明文且同浏览器任意本地页可读。建议在服务商侧设消费上限并轮换 Key。完整script-src会继承进 iframe,需逐视图回归后再开。

V5.0.37

架构 · 注册表与冷热分层
载荷注册表

新增JDD_PLUGINS一张表(label / payload / frame / env / view / boot),MODS与五个jddBootXxx包装全部由它生成,对外开放window.jddPlugins.all / get / register。加新模块从此只改一处。

JDD_PLUGINSRegistry
账本冷热分层

localStorage 镜像超过 1.1MB 时只存轻索引(列表与地图要用的字段),详情仍在 IndexedDB;IDB 不可用时强制写全量,保证「只有一份数据」的场景不降级。jddStore.stats().mirror可看当前是 full 还是 hot。

1.1MBHot / Cold
详细修补条目 (Bug Fixes & Refinements) 1
  • 修一个真会丢数据的坑(写入时间戳):write()之后立刻刷新,IDB 事务还没提交(还是旧数据),而启动逻辑「IDB 无条件优先」会把更新的镜像覆盖掉——实测400 条变 46 条。现在两边都带时间戳(IDB 的时间戳与 records 在同一事务里,回滚就一起回滚),启动时谁新用谁。

V5.0.34

数据保险 · 快照与回滚
导入前自动快照

存储层新增snapshots表(IDB 1 → 2,只新建表不动 records),保留最近 5 份;每次导入前自动留档,行程地图菜单可直接查看。

snapshotsLast 5
一键回滚,且回滚可撤销

回滚前会把当前状态再存一份「回滚前」,所以回滚本身也能撤销;行程地图菜单新增「回滚上次导入」,导入走错备份不再是无解的单向操作。

RollbackUndoable
详细修补条目 (Bug Fixes & Refinements) 2
  • 老备份终于导得进来(V5.0.31):V4.x / 手机端导出的是{app, version, data:{'trip-ledger.records.v1':'<JSON 字符串>'}},旧解析器只认{records:[…]},老用户一律「格式不支持」。新增通用解析器,逐层解字符串 → 认 records / data / 任意键 → 兜底深扫。

  • 旧草稿迁移、旧会话归档(V5.0.35):票面草稿按 20 个字段映射写回(已有草稿时不写入,绝不覆盖用户正在填的表单);旧 AI 会话与 V5 结构不同,只归档不硬迁,不造空壳条目。

V5.0.28

存储层 · jddStore
三层存储架构

新增jddStore(内存缓存 + IndexedDB 主存 + localStorage 镜像),readLedger / writeLedger改走它、旧实现留作兜底;记录写sv=2,老记录自动补版,回退开关jdd-store-mode='ls'。

jddStoreIndexedDB
干掉 5MB 静默失败

localStorage 撞 5MB 墙时writeLedger会静默失败、记录悄悄丢失——这是最难排查的一类问题。迁 IDB 后账本体量不再受单键限制。

5MB WallSilent Fail
详细修补条目 (Bug Fixes & Refinements) 2
  • 「清除所有数据」真正生效:清不掉的根因是jddStore内存缓存没清,下次写入又把旧数据镜像回去;doWipe现在显式调用jddStore.clear()。

  • 地图跟随筛选:drawMap与render不在同一个闭包里,render 里的 drawMap 恒为 undefined、调用被静默吞掉,所以筛选一直不同步;现在把 drawMap 挂到window.__jddDrawMap,跨闭包打通。

V5.0.22

交互重排 · 视觉统一
预览操作行重排

票面设置 / 文字设置 / 二维码 / 细节调整 / 导入 / 删除数据 / 导出图片 / 导入珍藏册,前六个只留图标,后两个实心绿带文字;PDF + 图片 + 文本三个导入合成一个三页签弹层,不再三处分散入口。

Toolbar3-in-1 Import
图标按功能重画

六个图标按钮统一成「透明底 + hover 泛青」并去掉遗留的.btn白底:票面设置 = 票 + 色点、文字 = A、细节调整 = 四角框 + 十字、导入 / 导出 = 托盘进出、删除 = 垃圾桶。

IconsV5.0.27
详细修补条目 (Bug Fixes & Refinements) 2
  • 粘贴框三连修(V5.0.19 → 21):先是聚焦时出现很重的绿环 → 改成虚线框;再是悬停「冒出一个框」(主题.card:hover加边框 + 大投影);最后不再用.card容器、换成.paste-pane,彻底不继承卡片悬停。

  • 视觉去层(V5.0.15):工坊与珍藏册各叠了一层整页柔光雾,票面预览脚下还铺了白色柔光底板,五个视图「像另起了一张纸」。撤掉后七个视图底色统一落在--paper上。

V5.0.17

真实码制 · 粘贴即录入
登机牌 PDF417 + BCBP

条带码制由 Code128 换成真票面码制PDF417,内容改用 BCBP,与二维码同源、可被真实扫码枪回扫;不再是「看起来像条码」的拼贴画。

PDF417BCBP
火车票二维码自指

二维码不再固定指向 12306 首页,改成「这张票自己」(车次 / 日期 / 区间 / 席别 / 票价 / 票号);顺带给重算加了 200ms 防抖——原来每敲一个字都要重算一次二维码。

Self-QR200ms Debounce
详细修补条目 (Bug Fixes & Refinements) 2
  • 粘贴即录入(V5.0.18):贴一段 12306 短信 / 订单邮件正文就能自动填票面,复用既有解析与回填链路,并补上短信特有写法(无年份的「10月11日」、- / 至 / →区间、订单号)。

  • 票面白边改了四版才收(V5.0.23 → 26):前三次都在治症状(反光层 / 底图死白 / 两层叠加),第四次才实测出根因——把画布放大 1.5%、让最外圈 2px 被边框裁掉就干净了,同时撤掉前面那段没生效的抠圆角代码,不留误导性死代码。

V5.0.12

新视图 · 年度报告
第 8 个视图:年度报告

年度大数字 / 12 格月度热力 / 榜单 / 准点率一次看完;按月的「这一年」纵向时间轴合并在报告里,不另开第 9 个 tab,避免导航继续膨胀。

YEAR IN REVIEWView #8
排版对齐既有体系

年报标题改用显示字体 34px / -.026em(同.doc h2),卡片圆角 14→16、内嵌格 6→8、卡片底 .68→.66、描边改var(--line)、小标签字距 .16em→.14em,与既有 token 完全对齐。

TokensV5.0.14
详细修补条目 (Bug Fixes & Refinements) 3
  • AI 规划必然超时(V5.0.3):需求解析与行程生成共用 60s 预算,而实测一次 5 天行程生成单独就要 56s,等于必然走到离线兜底。现在改成需求解析 30s / 生成 180s / 外层 210s 兜底,并给出「需要 40–90 秒」的预期提示。

  • 天数被砍成 7(V5.0.4):两处硬编码Math.min(7,…),连 AI 正确识别的 10 天行程也被压回 7 天;抽MAX_DAYS = 15统一口径,并给「模型偶发输出非法 JSON」加了结构修复 + 一次重试。

  • 计划页补上时间轴(V5.0.36):菜单里一直有「按天时间轴」这个词却点不出界面,现在计划页顶部有「按天行程 / 时间轴」两个页签。计划数据里没有日历日期(只有 Day N + 时刻),所以不硬造日期、不假装合并排序,真实票据单独成节。

V5.0.9

真条码 · 数据导出
bwip 真实 Code128

bwip-js 作为按需载荷(gzip + base85)注入交通票 / 影演票 iframe,票面条码由「伪随机宽度拼<i>」换成真正的 Code128;库解不出来时自动回退旧画法,不阻塞出图。

bwip-jsCode128
数据导出三件套

行程地图菜单新增导出 CSV / ICS / 备份 JSON,账本可以离开浏览器进入日历与表格。(GPX 需要投影逆变换,本文件没有,本轮未做。)

CSVICS / JSON
详细修补条目 (Bug Fixes & Refinements) 2
  • 直辖市终于点亮(V5.0.8):北京 / 天津 / 上海 / 重庆 / 香港 / 澳门 原被continue跳过——它们的轮廓在区级而非市级。改按省码整片点亮后,重庆不再是一个孤零零的圆点。

  • 票种点可见(V5.0.38 → 40):公交 / 地铁 / 出租车 / 客运 / 电影 / 景区 / 演唱会 原来画在.g-detail层,那层opacity:0,全国视图等于没有。先试「同城重合画同心环」反而叠成水波纹,最终改为一城一点:按坐标合并、颜色取张数最多的票种、明细走悬停。

V5.0.2

启动性能 · 载荷按需解压
PDF 库按需加载

pdf.js 主库 + worker 原本在启动时就解析编译(共 1.37 MB JS)。改成 gzip + base85 载荷,点「导入 PDF」时才解出来跑,顺带文件本体小了 914 KB。

1.37MB JSOn Demand
base85 解码重写

原来往普通数组 push 247 万个元素再整体拷贝,峰值内存约 20MB;改定长Uint8Array后降到约 5MB,耗时降七成。

20MB → 5MBUint8Array
详细修补条目 (Bug Fixes & Refinements) 3
  • 顺手清掉一批:字体 CSS 只注入一次(离屏工坊原来被注入两遍,每个少背 1.3 MB CSS);列表渲染去掉 O(n²);城市坐标表缓存;票面重绘合并到一帧 + 草稿防抖写;离屏样式清理由 6 轮减为 3 轮。

  • iframe 消息收口:只接受由本页 boot 出来的 iframe 发来的消息(原先只要 origin 为 null 一律放行);用户自己的 AI Key 在「清除数据」时刻意保留。

  • 体积:解析编译体积比上一版缩小约 2.9%。中间一度掉到 11.68 MB,后面工坊与地图能力上线又长回来。

V5.0.1 → V5.1.5

51 次迭代总索引

V5.0.1 是未改动的原件基线(保留作回退),因此本阶段实为51 次更新。同一件事反复改过的(比如票面白边改了四版)在上方卡片里只写最终结论;这里给出逐版本一句话索引,方便回溯「某一版到底动了什么」。

六个打磨阶段 63
六个打磨阶段
① 打底
5.0.2 – 5.0.8 先解决「慢」和「报错」
② 工坊成形
5.0.9 – 5.0.21 真条码、数据导出、年度报告、粘贴即录入
③ 打磨
5.0.22 – 5.0.30 操作行重排、图标重画、存储迁 IndexedDB
④ 数据与地图
5.0.31 – 5.0.39 老备份兼容、快照回滚、账本冷热分层、地图精度
⑤ 收口
5.0.40 – 5.0.48 按反馈回改、动效、安全修复、液态玻璃
⑥ 次版本
5.1.0 – 5.1.3 坐标数据契约变更、车站库扩容、激活码门禁、六处修复与地图性能、航司 Logo 与地图标反修复
版本索引(一句话 / 版)
5.0.2
载荷按需解压(−914 KB)、解码重写、清数据保留 AI Key
5.0.3
AI 规划超时:预算不够,调到够用
5.0.4
天数上限 7 → 15;AI 非法 JSON 容错
5.0.5
入册字段按票种自适应;新增船票
5.0.6
历史行程行内空胶囊只渲染有值的
5.0.7
点历史行程自动放大,公交 / 地铁 / 出租 / 船票同样生效
5.0.8
重庆等直辖市没被点亮(改按省码整片点亮)
5.0.9
bwip 真条码;CSV / ICS / 备份 JSON 导出
5.0.10
修「启动即弹导出菜单」
5.0.11
地图年份回放滑杆;1080×1440 分享卡
5.0.12
第 8 个视图:年度报告
5.0.13
票面纸张颗粒;PWA 声明
5.0.14
年报排版对齐既有 token
5.0.15
去掉工坊 / 珍藏册的整页柔光雾与票面底板
5.0.16
恢复柔光雾;撤掉年份滑杆
5.0.17
登机牌 PDF417 + BCBP;火车票二维码自指;重算防抖
5.0.18
粘贴即录入(短信 / 邮件正文)
5.0.19
粘贴框聚焦不出现绿环
5.0.20
粘贴框悬停不再「冒框」
5.0.21
粘贴面板换掉.card容器(根因)
5.0.22
预览区操作行重排;三个导入合成一弹层
5.0.23
白边:以为是反光层
5.0.24
白边:擦圆角外的死白
5.0.25
白边:关反光层
5.0.26
白边定稿:画布放大 1.5% 裁掉最外圈
5.0.27
六个图标按钮重画 + 去.btn遗留
5.0.28
账本迁 IndexedDB(jddStore)
5.0.29
清数据无效 / 珍藏册时间轴抽搐 / 地图筛选不同步
5.0.30
drawMap跨闭包(挂window.__jddDrawMap)
5.0.31
通用备份解析器(认 V4 / 手机端格式)
5.0.32
删掉从未执行的死代码块(报 SyntaxError)
5.0.33
复活交互层(补})();)+ 导出图裁白边
5.0.34
导入前快照 + 一键回滚(可撤销)
5.0.35
旧备份的票面草稿迁移 + 旧会话归档
5.0.36
计划页「按天行程 / 时间轴」双视图
5.0.37
载荷注册表 + 冷热分层 + 写入时间戳(修丢数据)
5.0.38
航班真实大圆;其他票种点全部可见
5.0.39
票种点与城市重合时改画外环
5.0.40
回改:弧线回来、一城一点、删分享卡
5.0.41
图标消失根因:减少动效时整层display:none
5.0.42
铁路虚线流动 + 航班流光;图标始终动画
5.0.43
安全:年报 XSS 修复、导入上限、OCR 提示
5.0.44
安全:三条低风险 CSP
5.0.45
登机牌去掉摄像头扫描
5.0.46
右上导航改液态玻璃
5.0.47
液态玻璃第二遍(更透、绿珠玻璃化)
5.0.48
性能:自适应性能模式、交互期停地图滤镜、桌面端 GPU 兜底
5.1.0
次版本:车站坐标 14 → 3267、足迹分母、线路详情、年份图例、A4 打印
5.1.1
激活码门禁(网页 / 桌面同一套)、桌面端版本号同步、V5.0.48 入口关闭
5.1.2
六处问题修复(AI 弹窗 / 工坊滚动 / 西九龙站 / 重庆站名 / 香港点亮 / 站名拼音)、二维码叠图、地图拖动与缩放性能
5.1.3
登机牌航司 Logo 串票、地图出发 / 到达标反、同名车站合并、地名短键匹配、官网 logo 外链改内联
已知遗留(V5 结束时未做)
·
GPX 导出:可行性已验证(投影可逆,平均误差约 2px),系数按反馈删了,要做需重新生成
·
暗色模式:底图填充写死在 SVG defs,反色会毁掉线路配色
·
完整 CSP:只上了三条低风险指令,script-src需逐视图回归
·
内置 API Key:按决定保留,建议在服务商侧设消费上限 + 轮换
·
本地数据加密:按决定保留明文(同浏览器任意本地页可读)
·
车站 / 机场表:已于 V5.1.0 扩容(STATION_XY14 → 3267、JDD_APT_XY591 → 592);剩 3 个 OSM 限流批次待重跑fetch-osm-stations.js补
四

第四阶段 · V4 八大模块与设计系统

2026-10-01 ~ 10-15 · 10 条

V4.1.8

快照对账 · 字段修复
快照对账修复

工坊导入时冻结的 tk.data / pv.sample 只作「底层字段来源」,记录当前字段(珍藏册详情 / 行程地图编辑器中的最新保存)非空即覆盖;记录字段为空则保留快照旧值,快照也没有该键时显置空,避免离屏工坊表单默认值泄漏进预览。

overlayFieldsArchive Preview
记录字段源切换

火车记录改为优先使用记录自带的工坊字段快照 tk(它一定对应该记录本身),pv 降级为缺少 tk 时的底层字段来源并与记录当前字段对账后使用,不再整体优先返回——陈旧快照会让预览停在改动前。

tk / pvSnapshot
详细修补条目 (Bug Fixes & Refinements) 3
  • 「图文不对号」修复:票号 / 身份证号 / 乘车人姓名等字段在详情编辑保存后不再被旧快照覆盖,卡片文字与预览图文保持同步;空表单值(如默认车次 K1020)不再泄漏进预览。

  • 多工坊接入对账:登机牌 / 交通票 / 影演票记录同样接入 overlayFields 快照对账;登机牌新增 airline 原样透传,工坊支持中文名 / 英文名 / 二字码 / 自定义航司,归一化白名单同步收录。

  • 全链版本号同步:官网、桌面单文件应用全线统一升级至 V4.1.8 正式生产标号;桌面端应用同步升级(Electron 打包,Mac arm64 / x64 dmg + zip)。

V4.1.7

设计重画 · 弹窗交互
手机端设计重画(V5)

模块注入层整体重写:新一套设计令牌、卡片纯白细描边单层柔影、表单与按钮 48px 高、芯片胶囊形;行程地图图层芯片 + 底部居中控制岛、珍藏册时间轴压缩留白、旅游计划输入胶囊。

JDD_V5_CSSMobile V5
弹窗与工坊交互优化

行程编辑器弹窗手机端整屏化(内部分区滚动);详情弹窗票面预览与详情面板分区滚动;四个票务工坊悬浮返回钮移至标题行让位;票种 chips 特异性裁决恢复胶囊 + 玻璃面 + 选中反白。

Dialog UXWorkshop
详细修补条目 (Bug Fixes & Refinements) 3
  • 底栏选中态修复:侧栏选中 / 悬停底色改为仅桌面侧栏生效,手机端底栏选中态恢复为深绿实心方块(此前注入层底色曾压过它导致浅绿药丸底)。

  • 编辑器弹窗整屏化:修复弹窗上线框 851px 超过 iframe 视口 774px 导致的裁切;面板内部独立滚动、操作条常驻底部。

  • 工坊操作条优化:底部吸附操作条改不透明玻璃 + 单行三键;四个票务工坊返回钮停在标题行,标题行左侧留 64px 让位。

V4.1.6

手机端 UI 修复
手机端底栏让位

工坊模块整体上移,底部预留悬浮令牌条高度 + 安全区,修复手机端底栏遮挡地图控制按钮与旅游计划输入栏的问题。

Safe AreaMobile Layout
选中态与控制岛修复

底栏选中态 ::before 补 display:block,修复选中高亮方块偶发不显示;地图控制岛改 flex-wrap:nowrap,防止控件换行被挤压错位。

Tab BarMap Ctrl

V4.1.5

系统重构 · 珍藏册增强
珍藏册时间轴滚轮横滚

电脑端珍藏册时间轴新增鼠标滚轮控制前后滚动:普通鼠标的垂直滚轮转换为时间轴横向位移,触控板横向滑动优先使用 deltaX;滚到最前 / 最后时放行事件、交还整页滚动;滚动期间临时关闭 scroll-snap 让滚动更跟手;Ctrl / ⌘ + 滚轮保留缩放与系统手势。

Archive TimelineDesktop UX
手机端设计系统级重构

自 V4.1.2 起累积交付:外壳按设计稿重写,引入一整套设计令牌(画布 / 玻璃面 / 描边 / 墨色 / 深绿渐变 / 圆角 / 阴影),底栏改为悬浮令牌条;「添加票面」与「我的」两页全面改版,版本更新红点挂到「我的」标签。

Design TokensMobile Shell
详细修补条目 (Bug Fixes & Refinements) 5
  • 移动端注入层样式修正:满铺画布去掉奶油色边框、行程地图统计卡恢复 2×2、地图控制岛改为底部居中胶囊、图层 chips 改为胶囊形并强化选中 / 未选中对比。

  • 珍藏册详情字段补全:影院 / 影厅 / 人数 / 票区 / 发票号 / 经由线路 / 票面配色等此前可编辑却被字段白名单静默丢弃的字段现随记录保存,修复「填了却在保存 / 刷新 / 重进详情后丢失」;交通票据工坊的客运座位号、出租车发票号此前只进备注 / 只用于票面渲染,现一并写入记录。

  • 珍藏册缩略图链路修复:单条记录规格化(spec)抛异常不再中断整批入队(此前会导致其后所有记录都不生成缩略图);外壳回写记录时不再无条件继承旧快照,修复「详情改完保存后时间轴仍显示旧信息」;保存时先同步落盘再做异步里程补全;预览图渲染失败改为计数重试(上限 3 次,未达上限自动重试)。

  • 外壳顶栏层级修复:顶栏 z-index 提升至 50,修复被内容层遮挡的问题。

  • 全链版本号同步:官网、桌面单文件应用、本地缓存与离线 ServiceWorker 全线统一升级至 V4.1.5 正式生产标号;桌面端应用同步升级(Electron 打包,Mac arm64 / x64 dmg + zip)。

V4.1.4

缩略图链路修复
规格化失败隔离

单条记录规格化(spec)抛异常时立即回执空结果并释放队列,交由珍藏册按失败计数自动重试(上限 3 次);此前一条记录失败会导致其后所有记录都不生成缩略图。

spec()Queue
快照继承规则

保存时按记录 ID 匹配,仅当新记录缺 tk 时才从旧记录补齐工坊快照,随后删除陈旧渲染快照 pv 由外壳重绘——修复「点了图片进去改了,外面还是旧的」。

tk / pvSnapshot
详细修补条目 (Bug Fixes & Refinements) 1
  • 顶栏层级修复:外壳顶栏 z-index 由 1 提升至 50,修复被内容层遮挡的问题。

V4.1.3

设计系统级重构
令牌层与悬浮底栏

新增完整设计令牌(--ds-*:画布 / 玻璃面 / 描边 / 墨色 / 深绿渐变 / 圆角 / 阴影);隐藏品牌顶栏大标题直达;底栏改为悬浮令牌条(圆角 22、玻璃面 + 内高光),选中态为深绿实心方块。

Design TokensFloating Bar
页面改版与裁决层

「添加票面」改大标题 + 竖向令牌卡、「我的」改用户卡 + 分组列表;新增 JDD_OVERRIDE 设计还原裁决层(特异度 0,4,1)压过模块主题层;版本更新红点镜像到「我的」tab。

JDD_OVERRIDEPages
详细修补条目 (Bug Fixes & Refinements) 2
  • 时间轴与输入优化:统计卡改单卡四格(324×79 设计稿);筛选行标签与两个下拉同高同胶囊;AI 输入区改胶囊输入框 + 深绿圆形发送钮;工坊悬浮返回钮改绿色系并上移避让安全区。

  • 满铺画布脚本:新增 jdd-fix413-boot(html/body 归零外内边距、去奶油色边框、.page 满铺 padding 13px)。

V4.1.2

重要体验修复
移动端页面架构精简

手机端新增独立的「添加票面」与「我的」两页,底部软 UI 悬浮标签栏精简重构为 5 个核心入口,操作半径大幅优化。

UI FrameworkMobile Viewport
统一设计语言注入层

仅在移动端视口生效的定制化 Soft-Glass 视觉层,保障桌面端原生工坊布局不受影响的同时,移动端拥有丝滑原生体验。

Cross-Platform
详细修补条目 (Bug Fixes & Refinements) 6
  • 色卡形状校正:修复交通票据与影演票工坊「色彩自定义」色卡在部分移动端布局中的形状畸变问题,恢复为 40×40 正圆 Soft UI 触控胶囊。

  • 滑动锁解除:修复手机端登机牌工坊整页上下无法滑动的问题,解除错误挂载的视口滚动拦截,重获自然弹性阻尼。

  • 火车票吸顶流转:修复手机端火车票工坊中段滚动卡顿及属性调节栏吸顶失效情况,确保长表单平滑操作。

  • 地图全屏防遮挡:修复手机端行程地图中南海诸岛附图与右下角全屏控制按钮重叠的视觉瑕疵,调整绝对层叠偏移度。

  • 弹窗冒泡阻断:修复「我的」页面中点击「软件更新」弹窗引发背景穿透触发的冒泡逻辑。

  • 全链版本号同步:官网、桌面单文件应用、本地缓存与离线 ServiceWorker 全线统一升级至 V4.1.2 正式生产标号。

V4.1.1

隐私及第三方剥离
  • 第三方代码精简:全面移除美团相关关联内容与预载脚本,纯粹化工具应用定位。

  • 高德开放平台密钥自主权:高德地图 Key 改为用户完全自主配置,提供本地 API 设置托盘及一键安全清空缓存记录机制。

V4.1.0

第七模块上线 · AI 赋能

全面加入第七模块「我的旅游计划」,实现从“回忆整理”向“行程出发前规划”的双向闭环。

对话式 AI 规划

七步流式生成体验(目的地解析、游玩节律、偏好定制等)伴随独创实时思考推理展开面板。

天气与清单聚合

生成计划时自动绑定目的地未来 5 天温度预报与针对性智能行李清单检查小卡。

V4.0.10 — V4.0.20 系列更新

地铁库与离线 OCR 引擎
全国地铁库全量注入

48 城 · 370 条线路 · 8,067 座地铁站,支持精确线路拓扑与换乘站点检索。

离线本地 PP-OCRv6

无需调用服务器,在浏览器端安全离线解析纸质火车票和电子发票 PDF。

地图真实票面即刻交互

航线与铁路轨迹悬浮点击时,即刻弹出真实质感 3D 票根卡片进行回顾。

三

第三阶段 · V3 六大工坊确立

2026-09-29 ~ 10-01 · 1 条

第三阶段:迹点点 V3.0.0 → V3.3.9

六大工坊确立期
  • 3D 票根透视展示台:引入陀螺仪与鼠标跟随的 3D 纸张微光反光卡台,票纸支持轻微翻转展示背部乘车须知与磁条。

  • 国家 4A/5A 景区库:收录全国高等级景区数据库,支持景点名称拼音/汉字联想输入并自动带入对应省份防伪戳印。

  • 航空登机牌矩阵:覆盖窄体机与宽体机主流舱位登机牌版式,支持 IATA 国际航协条形码渲染规范。

二

第二阶段 · V2 品牌与骨架孵化

2026-09-28 前后 · 1 条

第二阶段:迹点点 V2.x (内部孵化)

多模块骨架搭建

正式确定「迹点点 TraceDot」品牌命名与几何双圆连线 Logo 体系。构建统一的前端单页应用外壳,首次将地理轨迹高德地图和票根设计器聚合在同一工作区内,完成首版技术预研。

一

第一阶段 · V1 票根编辑器前身

2026-09-24 ~ 09-26 · 1 条

第一阶段:12306 火车票票根编辑器

V4.0 → V6.2.4 前身项目

专注单点需求:还原中国铁路经典的红色纸质车票与蓝色磁介质车票。攻坚矢量底纹、防伪网格、微缩字以及全国客运车站拼音简码库,为迹点点奠定了坚实底层基因。

MIT 开源起源

—— 点点足迹,票记远方 ——