Repository navigation
Releases
0.2.1 · 海大取件码
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 区从「一整块(只能定位到东侧通道口)」升级为精确到子位。
- S 区补齐:
- 通道网更新:可走格 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 · 海大取件码
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 · 海大取件码
海大取件码 0.1.9
这一版把取件路线整个重做了:场地模型不再靠我手写通道假设,而是直接照抄你平面图 Excel 里给通道填的颜色。
取件路线:数据驱动重做
- 可走通道逐格来自你的 Excel(3362 格),自动识别出 3 条纵向干线(西侧靠闸机那条 / 主通道 / 东侧)
与 9 条横向走廊带;取件点投影时绕开墙与货架(J 柜列三面是墙、朝南开,不会被投进主通道) - 最短路 = 网格 BFS(每步相邻)⇒ 结构上不可能穿货架、不可能斜穿
- 快递站 / J 柜列区 / 顺丰 S 区 / 大件 Y 区四类全部纳入;S 按格位横向、J 柜列按格位纵深
(柜列内走位stub计入距离) - 顺丰规则(你 2026-09-29 的两条):
- 只要取了 S(顺丰)件,就必须先在「顺丰专用闸机」出库;有普通件时出库后继续取,
最后从「7个普通闸机」出库并出站,出完直接走人 - 出库 ≠ 出站:只有顺丰件时,出库机不能出站 ⇒ 还要走到「顺丰和无快递出口」出站才结束
- 只要取了 S(顺丰)件,就必须先在「顺丰专用闸机」出库;有普通件时出库后继续取,
- 顺序是精确最优解(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 里细分
0.1.8 · 海大取件码
海大取件码 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
取件码海大版 0.1.7
取件码海大版 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
取件码海大版 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 已完成签名校验,可直接下载安装。
- 如果设备上已安装旧版本,后续覆盖安装要求继续使用同一签名密钥。