Skip to content

Releases

0.2.1 · 海大取件码

Choose a tag to compare

@CorvinYu CorvinYu released this 04 Oct 10:56

0.2.1 · 海大取件码

上海海事大学快递站专用 · 非官方维护分支(上游 shareven/parcel,MIT)。

0.2.0 之后的一版,主要做了两件事:场地地图换到 10-02 更新的精确版(S 区补齐 / Y 区编号 / Y1 横排),
以及修掉全屏出示条码难被出站机扫到的问题。

✨ 新增 / 改进

  • 场地平面图换成 10-02 精确版:接入你 2026-10-02 更新的 Excel ——
    • S 区补齐:S1-1~10 / S2-1~8 / S3-1~8 逐格定位;
    • Y 区编号:Y1~Y8 全部编号,其中 Y2/Y4/Y5/Y7 反向编号、Y8-x-1/2/3 三子位;
    • Y1 横排:最北侧一条横着的独立货架(9 格),不再斜穿;
    • 大件 Y 区从「一整块(只能定位到东侧通道口)」升级为精确到子位。
  • 通道网更新:可走格 3362 → 4765;纵向干线 3 → 4(新增东侧通道);合并区 218 → 281。
  • 寻路随之修正若干处:顺丰/大件区级标签消失导致定位失败的兜底(前缀并集)、
    J 柜列整体西移后的「从南端开口投影」、J 柜列 stub 单位记账、走廊编号错位等。

🔧 修复

  • 全屏出示条码难被出站机扫到(用户实测):根因是「亮度拉满」帮了倒忙 ——
    近整屏纯白 + 最大亮度让扫码枪 CCD 过曝 / 触发 OLED 限流,黑白边缘反而糊掉;
    底部浮窗是正常亮度、面积小,所以好扫。现已去掉全屏出示的亮度拉满,跟随系统亮度
    (条码高度保持 260dp 不变)。

📦 安装说明

  • 正式签名(证书 SHA-256 2aa560d1…126874),可直接覆盖安装 0.2.0 及更早版本,无需卸载。
  • versionCode 122 / versionName 0.2.1。
  • 本分支不是原作者官方发布版本;如需上游原版请到 shareven/parcel。

✅ 验证

  • 单元测试 99 条 / 98 通过 / 0 失败 / 1 跳过(含路径引擎与暴力枚举逐例一致、网格与 Excel 逐格一致、
    顺丰出库规则、闸机带不可通行、J 不穿墙等)。
  • assembleRelease 通过,apksigner verify 证书指纹与历史版本一致。
  • ⚠️ 本机无 Android 设备 ⇒ UI 未做真机验证,欢迎安装后反馈。

⚠️ 已知问题(沿用 0.2.0 的两条,仅记录、下个版本修;详见 ROADMAP「计划中 0 / 0.5」)

  • 顺丰出库被跳过后不会自动重排:出库点位置是规划器一次算定的;手动跳过它之后,
    不会以「你现在走到哪儿」为起点在剩余行程里重新挑一个最合适的点位补上。
  • 旧取件码「没消失」时可能被算进路线:近N天 只是显示过滤,路线只认 App 内的「已取」标记;
    取件前请对照列表把已经取走的旧件点掉「已取」。

0.2.0 · 海大取件码

Choose a tag to compare

@CorvinYu CorvinYu released this 30 Sep 20:36

0.2.0 · 海大取件码

上海海事大学快递站专用 · 非官方维护分支(上游 shareven/parcel,MIT)。

0.1.9 之后的 23 个测试包(0.2.0-beta1 ~ beta23)汇总成这一版,主要围绕
首页地图窗格 / 地图取件页 / 顺丰出库规则 三块打磨。

✨ 新增

  • 首页地图窗格:浮在列表之上的可调高度小地图(四角 16dp 圆角、圆角处露出列表内容),
    顶部把手可拖动改高度(跟手),右上角 ▼ 收起成一颗胶囊,收起时点整颗胶囊展开。
  • 地图取件页(全屏):地图 + 顶部「当前 i/N + 大号取件码 + 本段/全程格数」卡片 +
    下方横向可滑的整段序列(已取的留在原位、灰掉加删除线,点任意一格可翻回去看)。
    点一下 = 标记这一件已取并前进一格,再点可恢复。
  • 首页地图「全屏」:同一套取件码卡 + 序列 + 地图(整屏)。
  • 顺丰出库卡片:点一下即代表已出库(再点撤销;3 小时窗口,隔夜自动失效)。
    未出库时右侧提醒「N 件待出库」(菜单里可关)。出库点位置由路线引擎在
    「所有顺丰件之后」的合法位置里挑最优,保底排在最终出站之前。
  • 出站卡片:写明从哪一台闸机出站,点一下出示取件码。
  • 顺丰出库 / 出站现在是序列里的两步:轮到顺丰出库时,地图高亮正好是「去顺丰专用闸机」那一段;
    已出库后那一步仍保留(灰掉、可撤销),不会凭空消失。
  • 路线取件规则:一次只标记一件(不再同货架一起标记,避免漏件);
    全部取完后地图与提示自动指向「出站」。
  • 条码:没设置条码时,点「入口进站 / 出站」卡片或底部条码卡都会直接进条码设置页;
    已设置则全屏出示(亮度拉满)。
  • 顶栏三个标志(已识别 / 未识别 / 地图)统一尺寸与配色(含老人模式)。

🔧 修复

  • 地图上「道路压在闸机上」:闸机带不再算可通行,出行停靠点改取闸机带外门口的通道格
    (实测每条路线腿在闸机带内的格数为 0)。顺带新增回归测试钉住这一点。
  • 路线图层顺序:当前段改为最后绘制(含光晕)⇒ 未高亮的段不再盖住高亮段。
  • 顺丰出库卡位置稳定:锚点改用「显示出来的顺丰卡片」,标记已取 / 点已出库都不会再跳到列表最上面。
  • 顺丰出库步不会消失:顺丰件取完后那一步仍在(此前会凭空消失)。
  • 拖动「跟手」:首页地图把手与底部条码把手都改成屏幕累计位移换算(不再被自身位移污染)。
  • 其他细节:去处文案里的「表示」写法、关于页不再露出 Markdown 语法、入口卡 1 行 / 出站卡 2 行、
    地址卡间距对称、底部条码卡与地图之间的空隙收窄、地图箭头贴在路线上等。

⚠️ 已知问题(仅记录,下个版本修;详见 ROADMAP「计划中 0 / 0.5」)

  • 顺丰出库被跳过后不会自动重排:出库点的位置是规划器一次算定的;你手动跳过它之后,
    不会以「你现在走到哪儿」为起点在剩余行程里重新挑一个最合适的点位补上(保底仍在出站之前)。
  • 旧取件码「没消失」时可能被算进路线:近N天 只是短信的显示过滤,不参与「这件还要不要取」;
    路线只认 App 内的「已取」标记。所以「显示近 4 天」时,如果那几件旧件没在 App 里点过「已取」,
    它们会被当成待取件进路线(占停靠点、改顺序)—— App 无从知道件其实已经被取走了。
    ⇒ 取件前请对照列表把已经取走的旧件点掉「已取」;下个版本会给出更省事的做法(方案待你确认)。

📦 安装说明

  • 正式签名(证书 SHA-256 2aa560d1…126874),可直接覆盖安装 0.1.9 及更早版本,无需卸载。
  • versionCode 113 / versionName 0.2.0。
  • 本分支不是原作者官方发布版本;如需上游原版请到 shareven/parcel。

✅ 验证

  • 单元测试 98 条全过(路径引擎含「与独立暴力枚举逐例一致」的硬断言、网格与 Excel 逐格一致、
    顺丰出库规则、闸机带不可通行回归、条码、短信解析等)。
  • assembleRelease 通过,apksigner verify 证书指纹与历史版本一致。
  • ⚠️ 本机无 Android 设备 ⇒ UI 未做真机验证,欢迎安装后反馈。

0.1.9 · 海大取件码

Choose a tag to compare

@CorvinYu CorvinYu released this 29 Sep 16:41

海大取件码 0.1.9

这一版把取件路线整个重做了:场地模型不再靠我手写通道假设,而是直接照抄你平面图 Excel 里给通道填的颜色。

取件路线:数据驱动重做

  • 可走通道逐格来自你的 Excel(3362 格),自动识别出 3 条纵向干线(西侧靠闸机那条 / 主通道 / 东侧)
    与 9 条横向走廊带;取件点投影时绕开墙与货架(J 柜列三面是墙、朝南开,不会被投进主通道)
  • 最短路 = 网格 BFS(每步相邻)⇒ 结构上不可能穿货架、不可能斜穿
  • 快递站 / J 柜列区 / 顺丰 S 区 / 大件 Y 区四类全部纳入;S 按格位横向、J 柜列按格位纵深
    (柜列内走位 stub 计入距离)
  • 顺丰规则(你 2026-09-29 的两条):
    • 只要取了 S(顺丰)件,就必须先在「顺丰专用闸机」出库;有普通件时出库后继续取,
      最后从「7个普通闸机」出库并出站,出完直接走人
    • 出库 ≠ 出站:只有顺丰件时,出库机不能出站 ⇒ 还要走到「顺丰和无快递出口」出站才结束
  • 顺序是精确最优解(Held–Karp,≤16 件;已与独立暴力枚举逐例比对,含出库点的全部合法插入位置);
    件数更多时用「最近邻 / 走廊扫描两种子 + 2-opt」近似,并在页面上如实标注非精确
    (一次取 53 件这种量级,2^53 状态不可能精确求解)
  • 路线页现在展示完整停靠序列:逐件 → 顺丰出库 → 逐件 → 出站,每一段都给出步数与通道格
  • 首页「按取件路线排序」共用同一套引擎

场地参数只剩一个可调项

旧的「排字母 / 通道间距 / 入口到主通道 / 出口位置 / 货架宽度」这些估算参数全部删除(模型已由 Excel 决定);
只剩 J 柜列每列格数 可以在界面里改(该值尚未实测,默认 21 —— 实测只到 j5-21)。

修好「同一货架的不同格显示 0 格」

真机实测发现 S3-2-2628 与 S3-3-7606 都定位到同一通道格、两段距离显示 0 格。
根因是投影的「同层取哪一格」判据用了合并区中心,而按格位算出的精确点只用于走位。
现在改用格位点决胜:S 区同货架不同格分别定位到不同通道格。

校验

  • 单元测试 56 条全过(路径 17 / 排序回归 1 / 条码 17 / 条码试验 8 / 短信解析 9 / 真实截图 3 / 模板 1),
    其中包含「与独立暴力枚举逐例一致」「同一货架不同格不得投到同一格」「20 件启发式结构自洽」
  • 网页版同款引擎另有 20 / 30 件压测(页面新增「随机 20 件 / 随机 30 件」按钮)
  • versionCode 89;签名与 0.1.7 / 0.1.8 同一张证书 ⇒ 可直接覆盖安装
  • 完整待办见 ROADMAP.md

仍待确认(不影响使用)

  • J 柜列每列实际格数(界面可改)
  • 大件 Y 区在你这份精确版里是一整块 ⇒ 只能定位到东侧通道最近点;要分 y1~y8 需要在 Excel 里细分

⚠️ 非官方分支:本项目 fork 自 shareven/parcel,不是原作者官方发布版本。

0.1.8 · 海大取件码

Choose a tag to compare

@CorvinYu CorvinYu released this 29 Sep 12:09

海大取件码 0.1.8

本版起,应用名由「取件码海大版」改为「海大取件码」。

取件路线:按现场踩点重建

  • 16 排(无 I / J);每两排背靠背共用一条横向通道;主纵向通道在货架 4 与 5 之间;同一条通道南北两侧可直接横穿
  • J 柜列区 / 顺丰 S 区 / 大件 Y 区全部纳入最优顺序(含 y2/y4/y5/y7 反向编号、y8-行-子位 三段式)
  • 首页列表可按取件路线排序(菜单「海大版功能 → 按取件路线排序」,默认开):卡片标 ①②③,跟着序号取即可
  • 场地参数(排字母、通道间距、入口到主通道、横穿代价、是否折返)界面内可改

修好「取件路线一直是空的」

  • 根因不是算法:上游只从「格口 / N号柜」提取货格号(只对快递柜有值),人工货架的货格号从未被提取
  • 现在取件码本身就是货格号(D8-6、S3-2-2628、Y5-7-1)时会识别并兜底

条码

  • 删除「全屏出示」与「铺满首页背景」两条(效果不好)
  • 「底部浮窗」与「底部填充」合并为一个底部浮窗:高度可拖动调节;修好自动让位(取件码占满屏幕时缩到最小)
  • 卡片不再重复显示冗余的「XXX格口」(人工货架那行)
  • 新增隐藏的条码试验页:五种码制渲染取件码,供到快递柜柜机实测能否扫码取件

校验

  • 单元测试 71 条全过(路径 33 / 条码 17 / 条码试验 8 / 短信解析 9 / 真实截图 3 / 模板 1)
  • versionCode 82;签名与 0.1.7 相同 ⇒ 可直接覆盖安装
  • 完整待办见 ROADMAP.md

⚠️ 非官方分支:本项目 fork 自 shareven/parcel,不是原作者官方发布版本。

取件码海大版 0.1.7

Choose a tag to compare

@CorvinYu CorvinYu released this 28 Sep 18:55

取件码海大版 0.1.7

面向 上海海事大学(临港校区) 快递站场景的取件码应用分支(fork 自 shareven/parcel)。
非原作者官方发布版本。

⚠️ 签名变更(重要)

本版起使用新的签名密钥(v1.0.57-haida.1 的密钥已丢失)。
从旧版本升级必须先卸载,否则会安装失败。

下载

  • parcel-spu-v0.1.7.apk
  • SHA-256:f417670f1ddc65ad028caa2a035dd67616fc645cabac2c14decb6c261e11d42b

本次内容

一、同步上游 16 个提交(基线 v1.0.68)

长按取件码加备注 / 分享、时间过滤、显示隐藏格口号、解析规则与地址识别优化、首页组件化拆分等。

二、快递中心条码(新)

  • 导入微信专属码截图 → 完全离线识别(ZXing,不依赖 Google Play 服务)→ 随时出示
  • 四种出示形态:顶部常驻条 / 底部浮窗 / 底部自动填充(为取件码自动让位)/ 全屏出示(亮度自动拉满)
  • 识别策略三级递进:整图 → 按「深色横带」裁剪 → 中心裁剪

三、取件路线(新)

  • 按货格号(如 D5-23)自动排出一条最短取件顺序
  • 走行距离按场地真实拓扑计算,顺序为精确最优(子集 DP),不是贪心近似
  • 场地参数(排字母序列、是否折返回入口)可在界面内修改

四、列表三分类(新)

  • 快递站 / 快递柜 / 校外,支持横向跟手翻页
  • 快递柜卡片左侧用大号数字标出柜号,自助取件一眼可见
  • 分类按短信正文判定(规则表见 README)

五、界面调整

  • 快递站去掉冗余的地址行(短信碎片),留白收紧
  • 底部条码高度封顶为屏幕 1/4,高度变化带过渡动画
  • 右上角菜单改为可滚动的底部面板(小屏/老人模式下不再溢出)
  • 移除首次启动的老人模式弹窗

已知限制

见仓库 ROADMAP.md(未实现事项与待输入清单)。

取件码海大版 v1.0.57-haida.1

Choose a tag to compare

@CorvinYu CorvinYu released this 02 Jun 17:41

取件码海大版 v1.0.57-haida.1

下载

  • APK: parcel-spu-v1.0.57-haida.1.apk
  • SHA-256: f902e175af9d748aa70f250a3ee529014fd545c1411a1a3077ab215960b1a5d3

应用信息

  • 应用名称: 取件码海大版
  • 包名: com.xxxx.parcel
  • 版本号: 1.0.57-haida.1
  • 版本码: 58
  • 最低 Android 版本: Android 10 (API 29)

说明

  • 本版本为海大版 Release APK。
  • APK 已完成签名校验,可直接下载安装。
  • 如果设备上已安装旧版本,后续覆盖安装要求继续使用同一签名密钥。