Skip to content

Releases

v0.1.5

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:47

这一版主要解决「App 详情页只画 4 个必经点位、实际有 5 个」。没有新功能。

少画的那个点:报文键序错了

App 拿到的必到点是 5 条,详情页只画出 4 个。查了很久,一直按「数据不对」的方向找——position 该发什么、id 该从几起、runAreaId 发 -1 还是真实围栏 id、geoFencesJson 要不要带 distance/id/name。每一条都改过、都实跑验证过,每次都是「还是 4 个」。

真正的原因是键序。

把项目退回到 11 月 11 日那个 commit(13f7fdf)单独编出来,用同一个账号、同一个时间段跑一条,App 里 5 个点全出来了。两版报文逐字段比对,差异只剩三处,逐个改、逐个实跑:

id 从 1 起 + 键序字母序(flag 开头)  → App 显示 4 个
id 从 1 起 + 键序 lon 开头           → App 显示 5 个

fivePointJson 里每个点的键序改回 lon / lat / isFixed / pointName / glon / glat / position / flag / id / isPass / state。

原因是 App 不按 JSON 键名取值,而是按字段位置解析每个点。serde_json 开了 preserve_order,键序直接决定序列化字节,顺序一错,从第 8 个字段起全部错位,最后那条点就读不出来。所以数据看着每个字段都对,App 看到的却少一条。

字母序那版是照真机样本 rrid 1328288734 排的——那份样本没有 App 截图佐证,谁也没验证过它显示几个点。以实测为准。

顺带把必到点 id 从 81 起改回 1 起。这个值在同一批真机数据里有三个量级(81..85 / 400..404 / 1..5),本身不承载语义,按 11-11 那版原样保留。需要说明的是:id 和键序是同时改的,没有单独归因,我确认的只是「键序错会少画点」,没确认「id 必须从 1 起」。分开验证每跑一次要占用一个时间段、还要重启服务,账号容易触发风控锁,没做。

拐角补位之后又把间距顶回去了

本地体检报「第 130 点间距 50.1m,超过 50m」挡住提交,但采样本身就是按 50 米上限生成的。

原因是顺序:clamp_sample_gaps 跑在 nudge_to_corners 之前,拐角补位会把已经压好的间距重新撑开,而后面没有再检查。现在补位之后再压一次,两次的统计合并进一条日志,最后再加一道残差告警。实测最大间距从 50.1 米降到 27.3 米。

提交前核对当前会话账号

调试期间为了对比报文,中途登录过别的账号,回来忘了切,连着几条记录落到别人账号下。本地没有删除接口,只能去 App 里手动删。

/api/run 加了 expectUid:调用方显式给了就核对当前会话 uid,对不上直接拒,两边的 uid 都写进错误信息。不传则行为不变。

(这个校验第一版加错了位置——加到了 handle_batch,而 /api/run 走的是 handle_run,等于没加,又跑串了一条。已经挪到正确入口并验证过能拒。)

采样点 type 按最新真机口径

真机(实测账号,rrid 1362483656)的 allLocJson 里没有任何打卡标记,104 个点全是 {0: 101, 3: 1, 5: 1, 6: 1},5 个必经点完全靠 fivePointJson 渲染。早先要求撒 type=2 是照 10-02 那份老样本写的,那套口径服务端已经不用了。

撤掉 type=2,type 改按 {0, 3, 5, 6} 分布。连带删掉因此变死的代码:point_json_full 的 checkpoint_idxs 参数、build_points 的 fixed 参数、reserved 集合、重复下标告警,净删 49 行。

验证

398 个测试通过,clippy 零警告。

实跑验证(实测账号):rrid 1367193291,14 号 09:20,2166 米,id 1..5、键序 lon 开头、position 0/29/33/37/40,App 详情页5 个点位全部画出,其中 isFixed=1 那个显示为橙色(与真机一致)。

已知未解决

isFixed=1 对应的点被画成橙色,而 11-11 那条真机记录同样位置上 isFixed=1 却是绿色。两条报文的该字段、isPass、state、键序、runAreaId、geoFencesJson 形状完全一致——既然报文里没有能区分它们的东西,橙色就不是报文决定的。最可能跟跑步时段有关:11-11 那条是白天 11:36 正常计分跑,而测试记录都落在 11016 不在有效跑步时间内 的兜底分支。未验证。

Contributors

  • @IRmsk — 全部代码与修复
  • @Qziky — Windows/Linux 预编译包与自动发布工作流(#5)。这一版的两个包就是他那套工作流打出来的。

v0.1.4

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:46

主要是修 issue #4 和 #6 报的几个问题。没有新功能。

禁区整个没用:坐标少转了一道,偏了 950 米

装配障碍数据的时候,我把三种坐标直接堆在一起就送去避让了:你手绘的禁区是高德底图上的 GCJ-02,OSM 的建筑水体是 Overpass 原始 WGS84,轨迹和围栏是 BD-09。避让函数里一次转换都没有。

华南一带 GCJ-02 转 BD-09 要偏 900 米以上(实测河源 950 米)。所以避让一直在跑,绕的是几百米外另一块地——这就是「禁区完全没用、挪走也不变」的原因。

现在按来源分别转:OSM 的走 WGS84→BD-09,本地标注走 GCJ-02→BD-09。转换放在读取时做,之前存的 blockers.json 不用重画。

另外补了一次兜底推出:等时间采样取的点落在原折线的弦上,两条弦的交点会切进多边形角部,修好坐标之后仍有 2 个点擦着边界 0.6 米。现在上报点在算里程之前会再推一次,只挪不增删(点数一变,按索引贴的时间戳就错位了)。

生成路线把已查到的点位刷没了

后端在手绘、操场这些分支回的是空点集,而空数组在 JS 里算真值,drawPreview 一句 if (checkpoints) 就把已经查到的点位整个覆盖成空——图上点位全消失,手绘面板的「点位 N/M」也归零。

改成只有非空点集才更新。

顺带把点位缓存从单槽改成按围栏/锚点/距离分开存:原来只留最后一份,切一次围栏另一份就被顶掉,切回来必须重拉,而服务端每次给的点位集合不一定一样。

跑道穿进足球场

算操场半径时有个 clamp(20, 30),而标准 400m 跑道第 1 道的运行半径是 36.8——整圈往里缩 6.8 米,直段正好压在中央足球场上。三种打卡点分布(落在外沿、内场边线、内场里面)算出来全是 30,一个都没跑掉。

只放开上限不够,那个放大系数本身反推不准。改成先认标准尺寸:

  • 外框约 177 × 92.5 米 → 按第 1 道生成(半径 36.8、直道 84.39)
  • 外框约 160 × 75 米 → 按 280 米校内小场(半径 26、直道 55)
  • 都不像 → 退回比例拟合,并把拟合结果打进日志

多校区只有一个场地可选

服务端对多校区学校是下发多个围栏的,问题在界面:把所有围栏并成一个视野框之后,一个能选的地方都没有,你能用的场地只有定位锚点碰巧落在的那一个。

加了「校区/场地」下拉,列出账号下所有围栏,选中就把定位锚点挪到那个围栏中心、视野跟过去。只有一个场地时直接选中不打扰,多个才在状态栏提示可以在左上角切换。

验证

397 个测试通过,clippy 零警告,前端 JS 过 node --check,两个平台在 CI 上完成构建、打包、校验和。

Contributors

  • @IRmsk — 全部代码与修复
  • @Qziky — Windows/Linux 预编译包与自动发布工作流(#5)

v0.1.3

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:47

issue #4 里报的两个问题,一个是一直就有的,一个是我这边的疏忽。没有新功能。

禁区盖住打卡点,绕了等于没绕

生成路线的时候,绕完楼之后要把打卡点插回路径上,插的时候不管你刚才绕过了什么,直接插回原位。所以禁区只要盖住打卡点,刚绕出去又被拽回来。

拿一条直线穿一栋 24 米宽的楼、打卡点放楼正中量了一下:避让完楼里一个点都没有,插完打卡点又变回六个。

这事没法两全——打卡点必须经过,楼又不能穿。所以没去改那个插点的函数(改了打卡就失败了),改成把话说清楚:

  • 生成的时候日志里会写「第几个打卡点落在禁区内部,那块禁区的避让对它无效」
  • 存禁区之前会先比对已有的打卡点,被盖住的当场列出来,让你决定缩小区块还是硬存

想真绕开就把禁区缩小,或者挪开不要压住打卡点。

顺带说一句,另一个同类工具是把打卡点直接当路网的必经点去算路线的,压根不做绕行这一步,所以不会打架。我们走真实路网的那条路也是这么干的,只有几何兜底那条做不到。

一生成路线,点位就变了

点位缓存只存了一份。切一下围栏,之前那份就被顶掉,切回来只能重新问服务端;服务端每次给的点位集合又不一定一样,看着就是「生成一下点就变了」。

改成按围栏、锚点、目标距离分开存了,各留各的。上限 64 份,满了先清过期的,再淘汰最老的那一份,不会整表清空。

验证

392 个测试通过,clippy 零警告。两个平台在 CI 上完成构建、打包、校验和。

Contributors

  • @IRmsk — 全部代码与修复
  • @Qziky — Windows/Linux 预编译包与自动发布工作流(#5)

v0.1.2

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:47

还是修 bug,没有新功能。这一版基本都在控制台和几条平时碰不到的路径上。

控制台

上游返回的文字被直接塞进页面

围栏名、打卡点名、账号昵称和学校、上游的错误信息、流程日志,这些都是服务端给的,原来十几处直接拼进 innerHTML 和地图弹窗。上游只要在名字里混一段标签,页面就会执行它——而 sessionStorage 里正存着控制台口令。

现在这些取值全部先转义再插入。页面里本来就有个 esc(),写完一直没人调用,这次是真用上了。数值字段没动,免得把格式搞乱。

按钮会一直卡着

给每个请求加了超时和主动取消,后端没响应时不再无限等,直接报「后端长时间无响应」。超时定在 180 秒而不是常见的 60 秒:批量跑和单场提交里含路网、瓦片拉取,串行时几十秒才返回是正常的,定太短会在「服务端还在提交、前端已经判超时」的时候让人去重试,那就变成重复提交了。

账号行的切换、重登、退出、停用、删除共用一个进行中标记,请求没结算前再点直接忽略。这里有个自己踩的坑:一开始只在结束后解锁,没把按钮放回可用,一旦操作失败,那行按钮就一直灰着;现在按操作前的原状态还原。

少见但会咬人的

一张坏瓦片能把整格网废掉

缓存文件超过 512 字节但解码失败时,原来只是报错,坏字节留在原地,下次还读它。等于这一格图永远拉不到,只能手动去清缓存目录。现在解码失败就把文件删了,下次重新拉。

空的水域/建筑结果被缓存三十天

上游偶尔会回一个空集合(这一带暂时拉不到数据),旧代码照样落盘,然后按 30 天有效期锁死。之后规划一直缺楼缺水,路口和水域都绕不出来。空结果现在不写缓存,下次重新问。

点位响应的深嵌套会爆栈

data.result.data.result… 这种畸形链,解析时一层层往里钻,深度大了直接耗尽调用栈。虽然被 unwind 兜住不至于整进程退出,但那次请求必失败。现在最多钻 5 层,超了明确报错。

验证码两个坑

lot_number 是按固定位置切的,上游给个短的就越界 panic——被兜住了,但那轮登录也就废了。现在先量长度,不够直接报错换图重试。

PoW 找 nonce 原来没有次数上限,参数异常时会一直转下去占满一个线程。加了 20 万次上限,正常几百次内就命中,超了明确失败。

机器标识空白、设备标识写盘失败

拿机器标识时只要文件存在就算取到,内容为空也照用;三处全空时退化成常量 unknown+root,所有这样的机器算出同一把 key。现在先 trim,空值继续往下一个来源退。

设备标识写盘失败原来是 let _ 吞掉的,下次启动读不到文件就换个随机 id,服务端判「新设备」接着锁一小时。现在至少留一条告警。

顺手

  • 几处注释写的是旧实现(isFixed 的规则、起步窗口的 0、海拔默认区间、起步段的 t^1.5、瓦片缓存 30 天、围栏裁剪),代码是对的,注释在骗人,一并改回真实情况
  • 补了 4 条回归测试:验签比的是字节末尾而不是 hex 字符串、补跑时刻要按校时偏移、登出认不出的响应不能算成功、步频回退区间
  • 发版工作流的 publish job 补了 checkout,docs/release-notes/<tag>.md 才会被用上

没动的

密码学那几处(请求 key 熵、全零 IV、硬编码 GT_KEY)是跟着上游对齐的,改一边就通不了,只补了说明。并发模型、阈值启发式、缓存 key 量化、绕行和插点几何、桶里程这些也都没碰——不是不知道,是改了要重新验证全部真机样本,收益在本机单用户场景里是零。

验证

389 个测试通过,clippy 零警告。两个平台在 CI 上完成构建、打包、校验和。

Contributors

  • @IRmsk — 全部代码与修复
  • @Qziky — Windows/Linux 预编译包与自动发布工作流(#5)

v0.1.1

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:47

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 19:47