Releases: dboycht/totoro-heaven
Releases · dboycht/totoro-heaven
Release list
1.2.6
龙猫天堂 Totoro Heaven 1.2.6
「研途健行」专页 + 配速按任务允许区间随机 + 路径编辑器改名
发布渠道：建议使用（正式版） · 日期：2026-09-30
本版更新
- ★ 新增「跑步 → 研途健行【建议】」选项卡：任务是「服务端未下发线路」那一类（例如研究生院「研途健行」）时，软件会自动认出来并提示你切到这一页。它和阳光跑、自由跑并列，跑法与阳光跑完全一致（带任务号提交、计入成绩），只是轨迹用你自己画的路径生成。
- ★ 配速不再"每次都一样"（issue #13）：任务的「速度要求」与「时长要求」会各自换算成配速、取交集作为允许区间，每次开跑都在区间内重新取一个值（数值不是整分钟）—— 于是每一笔都不一样，又始终落在任务要求之内。以前的做法是"按你的策略算一个、再硬夹到区间边界"，当策略落在区间之外时（例如任务要求 8'34" 起步、而默认策略是 6'00"），结果就会每次都等于同一条边界。
- ★ 跑步页右侧新增「路径与配速设置」（只在未下发线路的任务里出现）：跑多长（默认取任务下发的里程，可改）、绕几圈（按你画的路径自动算，可改；改圈数会同步换算里程）、配速策略；下方同时给出任务允许的配速区间与「本次将生成」的配速 / 时长 / 速度 / 里程 —— 开跑前就能看出这一趟合不合理。
- ★ 「非官方路径【测试】」改名为「研途健行路径编辑器」（顶栏路径没变，旧书签照旧可用）。它现在只负责"指定路径"：原来的「目标里程」「趟数」输入框与长度读数都移到了跑步页（见上一条）。
- ★ 起跑点固定为你标的第 1 个点（顺序就是你在图上点选的顺序），不用再单独去设。
- ★ 老版本路径会提示更新：旧版本保存过的路径，在路径编辑器与跑步页都会提示"建议重画"，并给一键入口（载入旧形状当底稿）。旧几何照样能用、照旧开跑；软件不会替你自动迁移，也不会删掉你原来的数据。
- 🐞 修掉右侧「配速策略」下拉有时显示成一个没有单位的裸数字（例如 514）—— 现在一律显示成 8'34" /km 这种可读形式。
- 🐞 修掉结算卡里的「时长 / 配速」与本次实际配速不一致的问题（它以前是另算的），现在与本次实际配速同源。
- 🐞 修掉「未下发线路」的任务里，右侧误报"这条几何还没有可用的『一圈长度』"（其实引擎会正常用那条几何生成轨迹）。
- ℹ️ 稳定性：单测 545 → 566 例；npm run verify（单测 + 4 类类型检查 + 接线契约 + 检查器自测）退出码 0；新增浏览器端到端验证 55 条断言全绿。
⚠️ 诚实标注：本版的提交报文口径与 1.2.5 完全一致（报文字段、请求顺序、判定读回都没动）—— 变的只是"本地生成多长的轨迹 / 多长时间"以及界面。配速新口径的真实提交仍建议提交后到「记录」页核对判定结果。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.6-pre1.zip （37.11 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.6-pre1.7z （26.44 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip 16545dd59853378a14eebd94df9b5f72ad192f79e83b71d99b606567f97c2d5b
7z aa9a6f9c54cfa7a9534e30741f07cd75338d625ed6de7418f2d3963cc78c0635
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 研途健行 / 自由跑」在同一个「跑步」入口里；三种跑法都要求先有一个"本机几何"：有官方线路的任务用「我的场地 → 跑道编辑」描内外圈；服务端未下发线路的任务（如研究生院「研途健行」）用「我的场地 → 研途健行路径编辑器」画一条路径。跑多长 / 绕几圈 / 什么配速在跑步页右侧设置。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.*，建议使用）；使用 1.2.5 或更早版本建议升级到本版。
1.2.5
龙猫天堂 Totoro Heaven 1.2.5
支持「服务端未下发线路」的任务（如研究生院「研途健行」）+ 新增「鸣谢」页 + 诊断能力大改
发布渠道：建议使用（正式版） · 日期：2026-09-25
本版更新
- ★ 新增支持「服务端未下发线路」的任务（例如研究生院「研途健行」）：这类任务没有官方路线可选。现在可以在「我的场地 → 非官方路径（测试）」里画一条本机路径（圈型闭合曲线，或折线折返），跑步页就用它生成轨迹。成绩提交与官方线路任务完全同口径：报文里不含任何线路或本机路径信息。
- ✅ 实测结论：这类任务真实提交被服务端判为「有效」（里程与时长都落在任务窗口内）；轨迹明细也已确认正常入库。
- ★ 新增「鸣谢」页（顶栏最右边）：电影片尾式名单（放得下就全显、放不下缓慢滚动，随时可重播）。感谢参与内部测试与协助适配的朋友。
- ★ 「诊断」更全了：遇到问题点「开始记录」→ 按顺序复现一次 → 「结束并导出」，包里带着这次操作的完整事实 —— 任务的原始数据（到底有没有下发线路与阈值）、本机路线库摘要、开跑前门禁的判定依据、你的操作时间线，以及服务端最近的请求记录（响应内容已脱敏；不含 token 明文，学号姓名也打码）。程序在后台每 45 秒留一份状态快照，中途关掉也能看到最后一刻。
- ★ 新增「我的场地 → 非官方路径（测试）」：在地图上点选绘制（圈型闭合曲线 / 折线折返），并且「定位」按钮会真的定位到你的当前位置；保存后在跑步页即可选用。
- ↑ 跑步页新增「本机路径」下拉（只在服务端未下发线路的任务里出现）：默认用你保存的那条，可随时切换，并按任务记住；一条都没有时下拉里也放着「点我去画一条」的入口。
- 🐞 修掉三处会误拦或误判的判据：① 任务响应里没有 taskId 时，不再被判成「缺任务号」而拦下提交（实测那位同学的任务响应只有 paperId / id）；② 任务没有下发拟合度阈值时，不再按 0.6 硬判；③ 服务端未下发线路的任务，不再被当成「你还没描跑道」而阻断开跑。
- 🐞 修掉「没有本机几何」的误报：本机路线库还没读取时，不再把「还没读」当成「确实没有」—— 此前在工作台刚读完数据的那一刻会误报这条，并（在严格门禁下）挡住开跑。
- ↑ 提交链路的其它修复：写操作的超时不再等于失败（超时后自动去服务端核实，已入库就按成功继续并自动补交轨迹明细）；摄像头杆开关的重复查询做了并发去重（一次开跑从二十余次降为一次）；查询成绩归档的条数上限放宽，避免漏查被误判成还没入库。
- ↑ 隐私与性能加固：服务端请求记录里的 token、学号、姓名、手机号一律掩码（有单测守着）；并修掉一处会让超大响应把本机代理卡住的性能问题。
- ℹ️ 稳定性：单测 546 例；接线契约新增一条源码级守卫（本机几何绝不进提交报文）；打包产物端到端 19/19。
⚠️ 诚实标注：对没有下发线路的任务，我们是按官方小程序的口径提交（只带任务号、不带线路标识、路线点列为空）—— 实测服务端判为有效，但不同学校的口径可能不同，请提交后到「记录」页核对判定结果。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.5.zip （41.38 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.5.7z （30.73 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip 08db91e8f8bd147035fe484ef441088431822eb7a83aeae15bc0c5b32bafba7f
7z 8ec54258d6a51ca0ddc9da7ee4b45efe9b8b729e3d539fb64bcc18f674281e36
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.*，建议使用）；使用 1.2.4 或更早版本建议升级到本版。
1.2.4
龙猫天堂 Totoro Heaven 1.2.4
新增「诊断」一键导出（把事实带回来）+ 修掉两处"自己造要求"的判据
发布渠道：建议使用（正式版） · 日期：2026-09-22
本版更新
- ★ 新增「诊断」页（顶栏「数据」组里，与「记录」「日志」并列）：遇到问题点「开始记录」→ 按顺序复现一次 → 点「结束并导出」，会得到一个 zip。包里带你这次操作的完整事实：任务的原始数据（到底有没有下发线路/阈值）、本机路线库摘要、开跑前门禁的判定依据、你的操作时间线，以及最近的服务器日志（由程序自己收集，不用你去翻临时目录）。把它发到 dboycht@qq.com 就能对症修；包里不含 token 明文，学号与姓名也已打码。
- ★ 修掉两处"服务端没提、我们自己却当要求"的判据（来自 issue #12 的实测反馈）：① 任务没有下发拟合度阈值时，以前会按 0.6 硬判（自检表报红、甚至拦住提交）—— 现在按"本任务不判拟合度"处理，数值只作展示并标成「提示」；② 任务没有下发线路（不指定路线）时，以前会被归因成"你还没描跑道"并被门禁卡住 —— 现在两者分开说明，不再阻断开跑。
- ★ 签到记录能读了：此前查记录时少传了学期与月份，服务端当成"没指定"就回空数组；现在按官方小程序的口径补齐，并新增「签到记录（按月）」卡片（已签/未签统计 + 记录列表 + 月份切换，最多列 60 条）。
- ★ 自由跑：真实提交需要学校开通「自由跑任务」（由服务端判定，实测我们发出的报文与官方小程序逐字一致）。现在开跑前就有常驻说明，被拒绝时把服务端原话翻译成人话，并把真实提交入口标灰（旁边留一个「仍要试一次」的出口）；未开通时自由跑仍可用于本地模拟与预览。
- ↑ 提交更稳：写操作的等待上限 15 → 30 秒；超时不再当失败 —— 会延时三次核实（3 / 8 / 20 秒），确认已入库就按成功处理并自动补交轨迹明细；「提交过程」六步清单改为全局状态（换页不再丢、「清空本机数据」能一起清）；「查询判定」加锁（提交在途时不可点，避免重复插入步骤行）。
- ↑ 界面不再"骗人"：「结果未知」不再被渲染成红色失败；提交期间点「退出登录」不会再卡住按钮；会话状态一变就落盘（刷新页面后不用重新获取 token，仍要手动点一下「恢复」重建任务）。
- ↑ 打包版启动更稳：单实例探测改为扫整个候选端口段（此前只看 3000，导致"3000 被别人占用 + 再双击一次"会起第二个实例、让正在运行的那个偶发 500）。
- ↑ 发布链加固（影响的是我们出包，不是你的使用）：EXE 图标改为从产物取证（读 RT_ICON 里是不是我们 logo.ico 的图像，postject 前后各校验一次），附件改为流式上传（含短读守卫与回显大小核对）。
- ℹ️ 稳定性：单测 245 → 332 例；接线契约新增两条源码级守卫（本机地址族 R12、PowerShell 脚本编码 R13），注入自测 16 类；打包产物端到端 19/19。
⚠️ 诚实标注：对没有下发线路的"自由路线任务"（例如研究生院的「研途健行」），我们按官方小程序的口径提交（只带任务号、不带线路标识、路线点列为空）—— 但服务端是否判为有效我们尚未实测。这类任务请用你自己描过的跑道生成轨迹，提交后到「记录」页核对是否判为有效。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.4.zip （40.34 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.4.7z （29.68 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip f630f948169ab1c177dab2f9800b8ca03d7cdf117db7998cd6e97f4e08369ac8
7z be287440df0f5b9e3c8a902ab821f24242ba91c6b9b35e94b52806b038589c54
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.*，建议使用）；使用 1.2.3 或更早版本建议升级到本版。
1.2.3
龙猫天堂 Totoro Heaven 1.2.3
让「超时不再等于失败」真正生效 + 提交过程可见 + 防重复提交的几道闸
发布渠道：建议使用（正式版） · 日期：2026-09-21
本版更新
- ★ 上一版修了「假报错」的判定逻辑，但它的核实动作是"立刻查一次" —— 而实测"提交后马上读归档是读不到的（要过几分钟）"，所以"自动补交轨迹明细"其实几乎不会触发；本版改成延时递进重试（3 秒 / 8 秒 / 20 秒，命中即停），这才让超时后的自动核实真正可用；
- ★ 新增「提交过程」面板（跑步页）：一次真实提交拆成六步逐条显示 —— ① 前置检查（门禁）② 创建场次 ③ 真实等待 ④ 上传成绩（里程/用时/拟合度 + 线路点列）⑤ 上传轨迹明细（跑出来的 GPS 点列）⑥ 读回判定；每一步都写着"正在传什么、传了多少、服务端回了什么、用了多久"，出问题一眼看得出停在哪一步；
- ★ 新增几道"防重复提交 / 防张冠李戴"的闸（都是保守兜底，正常使用感受不到）：① 提交成功后按钮会禁用，并说明"本次已提交，如需再跑请先「重置」"；② 换任务、或从演示数据切到真实任务后，上一笔结算禁止提交（避免把演示的轨迹配到真实任务上）；③ 判定读回按 scantronId 归属写回；④ 查归档从 100 条放宽到 1000 条，避免漏查被误判成"没入库"；
- ★ 自由跑口径说清楚了（实测结论）：真实提交需要学校开通「自由跑任务」（由服务端判定）。实测我们发出的报文与官方小程序逐字一致，未开通时服务端会回「暂无自由跑任务,请选择阳光跑!」—— 现在开跑前就有常驻说明，被拒时也会把服务端原话翻译成人话（并说明"与你的操作无关、阳光跑不受影响"）；未开通时自由跑仍可用于本地模拟与预览；
- ↑ 界面不再把「结果未知」渲染成红色失败：结果卡按 成功 / 超时但已核实入库 / 结果未知 / 确定失败 四态取色与措辞（此前"结果未知"会被写成"成绩未成功"，自相矛盾）；
- ↑ 提交期间如果点了「退出登录」，不再把界面卡在"正在提交"（按钮双双灰死到刷新页面）；提交期间被清掉的上下文也不会被"僵尸写回"；
- ↑ 会话状态一变就落盘：刷新页面后不用重新获取 token（仍按原设计要你手动点一下「恢复」才重建任务）；本机代理报的中文错误原因也能穿到界面了（此前只会显示"无法识别的响应"）；
- ↑ 打包版启动更稳：单实例探测改为扫整个候选端口段（此前只看 3000，导致"3000 被占用 + 再双击一次"会起第二个实例、清掉共享临时目录，让正在运行的那个偶发 500）；
- 🐞 其他修复：写操作的"空响应 / 非 JSON 响应 / 504"也按"结果未知"处理（原先会被当成确定失败、诱导重试）；任务参数自相矛盾（速度窗与时长窗无交集）时如实告警并提示把参数发给开发者；步数估算的偏移参数此前不生效；开发版打包时「版本信息」页贺图报 500；
- ℹ️ 稳定性：单测 245 例增加到 290 例；接线契约新增两条源码级守卫（本机地址族 R12、PowerShell 脚本编码 R13），注入自测 16 类；打包产物端到端 19/19。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.3.zip （34.93 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.3.7z （24.26 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip 8b7789c8829f0b490109ff46e73655022c5ba2e7569b717b146f10787a693b4d
7z 2546929b5c071d4aa28fe8ff46de2435c5f8c08ff8b6a60a724095440d495039
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.*，建议使用）；使用 1.2.2 或更早版本的建议升级到本版。
1.2.2
龙猫天堂 Totoro Heaven 1.2.2
修掉真实提交的「假报错」：超时不再当失败 + 新增「提交过程」实时清单
发布渠道：建议使用（正式版） · 日期：2026-09-21
本版更新
- ★ 修掉用户反馈的「假报错」（他提交后界面说失败、可成绩其实已经入库）：实测厂商回「提交成功」用了 15.4 秒，而客户端等待上限是 15 秒 —— 只比真实响应早放弃 404 毫秒，却被当成"失败"，连带把第二步的轨迹明细也跳过了；
- ★ 写操作的等待上限从 15 秒放宽到 30 秒（读操作仍 15 秒；本机代理等上游的上限同步从 20 秒放宽到 40 秒，保证"等多久"由离你最近的那一层决定）；
- ★ 更关键的是语义改正：超时不再等于失败。超时后程序会「自动去服务端核实这条成绩到底进了没有」—— 已入库就按成功继续，并「自动补交缺掉的轨迹明细」；核实不到才如实说"结果未知"，并明确提醒「不要立即重复提交」（重复提交会多录一条成绩），可以点「查询判定」稍后核实；
- ★ 新增「提交过程」面板（跑步页）：把一次真实提交拆成六步逐条显示，能看到每一步「正在传什么、传了多少、服务端回了什么、用了多久」—— ① 前置检查（门禁）② 创建场次 ③ 真实等待 ④ 上传成绩（里程/用时/拟合度 + 线路点列）⑤ 上传轨迹明细（跑出来的 GPS 点列）⑥ 读回判定；
- ↑ 上面这两步的区别值得记一下：「线路点列」（那条线路的几十个点，用于标识你跑的是哪条道）是在第 ④ 步跟着成绩一起交的；而你真实跑出来的那一千来个 GPS 轨迹点是在第 ⑤ 步单独交的 —— 老版本一旦第 ④ 步被误判失败，第 ⑤ 步就永远不发了，云端记录因此没有轨迹；
- ↑ 代理或上游网关回 504 的情况（我们没等到答复）也按"结果未知"处理，同样会去核实，不会再一口咬定失败；
- 🐞 修掉开发版打包时「版本信息」页贺图报 500（会去请求上一个版本的贺图，而那个文件被打包脚本过滤掉了，页面显示图裂）；
- 🐞 补上一处状态防护：成绩提交等待期间如果你退出登录或清空本机数据，提交结果不会被"僵尸写回"到已经清空的界面上；
- ℹ️ 稳定性：单测从 272 例增加到 286 例（新增超时判定与过程文案的测试），打包产物端到端 19/19 通过。诚实说明：超时分支本身无法在本地按需复现（要上游真的慢 15 秒以上），该分支由单测覆盖 + 读码确认。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.2.zip （36.65 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.2.7z （25.97 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip 1e7986ae55e45d71e7c11c5e476d9bad2cd0edc5e5e6d25277f2787a5f0c81a5
7z 6208ce383ac989726b23beb7e01ca09dd202cd983a8d89db5e4c3f9c0afd7c45
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.*，建议使用）；使用 1.2.1 或更早版本的建议升级到本版。
1.2.1
龙猫天堂 Totoro Heaven 1.2.1
对外推荐的正式版：与 1.1.12 功能一致 + 新增「谢绝公开分享」说明
发布渠道：建议使用（正式版） · 日期：2026-09-21
本版更新
- ★ 本版是首个对外推荐的正式版（此前 1.1.* 均为预览测试版）：功能与 1.1.12 完全一致、没有行为改动，不需要重新熟悉，按原来的用法即可；
- ★ 新增「谢绝公开分享」说明（软件内「关于」与「版本信息」页、以及仓库 README）：本工具仅供本人自用，请不要公开分享、转发或二次分发，也不要代他人运行、代他人提交；
- ↑ 为什么要谢绝公开分享：一是工具的可用性依赖接口保持稳定，传播范围越大，校方与厂商收紧风控越快，最后大家都用不了；二是真实提交是你本人的账号行为，替别人跑等于把风险转嫁给别人；
- ℹ️ 本项目完全免费、无任何收费或推广；若你在别处看到有人收费售卖本工具，那与本项目无关，请勿购买；
- ℹ️ 稳定性：沿用 1.1.12 的全部验证结论（单测 272 例、打包产物端到端 19/19、真实链路与早操签到均已实测通过）。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.2.1.zip （37.05 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.2.1.7z （26.37 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip 8681c2e4f6e3187195960356b39b5b9c85bf2015b8b30734895ba872125fdd84
7z 71ddb76300f913c8819a313a5660681192b78ebd8dcd43feb5aaca71663819c5
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
正式版（1.2.，建议使用）；1.1. 为预览测试版，建议升级到本版。
1.1.12
龙猫天堂 Totoro Heaven 1.1.12
自由跑可自设距离 + 起跑点 + 路线库记录管理
发布渠道：预览测试版 · 日期：2026-09-20
本版更新
- ★ 自由跑可以自己设距离了：在「跑步 → 自由跑 → 开跑设置」里填目标距离（0.5 ~ 42.2 公里，也有一键档位 3 / 5 / 10 / 21.1 公里）；设过一次就会记住，下次不用重填；
- ★ 填完还会告诉你"按你选的这条跑道大约几圈、约合多久"（用的是你自己描的那条车道周长，不是官方模板）；阳光跑的里程仍由任务决定，不受这里影响；
- ★ 跑道编辑新增「起跑点」：在地图上点一下跑道就把起跑点设在那里（自动吸附到你选的那一道），下面可以用滑杆沿跑道微调，并选择顺时针或逆时针；生成轨迹时会从这一点出发；
- ★ 本地路线库的每条记录现在带完整留痕：创建时间与版本、最近一次保存的时间与版本、编辑次数，以及最近 5 次编辑历史（每次改了什么一目了然）；点「详情」可展开明细表（内外圈点数、外圈周长、道次、起跑点坐标与备注）；
- ↑ 旧记录（此前保存过的路线）会如实显示"未记录"，不会替你编造时间或次数；改名也算一次编辑，但没有真正改动时不会重复计数；
- 🐞 修掉开发版「一键获取 token」报"扫描器未回传结果"的问题：原因是开发环境的监听地址与子进程回传地址不在同一个地址族（打包版不受影响）。现在两边都按实际绑定的地址走，并把这条不变量写进了源码检查器 —— 以后谁改错会直接被拦下；
- 🐞 修掉「版本信息」页里 1.1.10 的发布日期（原写 9 月 18 日，按发布记录应为 9 月 19 日）；
- ℹ️ 本轮同时做了代码审计与验证加固：单元测试从 245 例增加到 272 例，接线契约检查新增 1 条规则与 2 条注入自测，CI 全绿。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.1.12.zip （34.28 MB） |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.1.12.7z （23.60 MB） |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
zip ff23cf709de89e3226c9ef63e724a3b45026c8b6bc5d277fa29abe45090da5d8
7z 236c86968a1a57ae52fe3258a88b151cf42391aafd14906db7519d23f21df2aa
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
预览测试版（1.1.）；对外推荐正式版为 1.2.（计划 9.20）。
1.1.11
龙猫天堂 Totoro Heaven 1.1.11
早操签到（看懂 + 自己按按钮提交 + 落点可调）+ 导航分组重构 + 一轮审计修复
发布渠道：预览测试版（1.1.*） · 日期：2026-09-20
本版更新
- ★ 新增「早操签到」页（导航常驻）：把签到任务摊开给你看 —— 时段、今天签了几次、点位在哪、范围多大、离点位还有多远；窗口与点位都取自服务端下发，不写死（不同校区/年级可能不同）；
- ★ 「提交签到」按钮（由你本人按、只在时段内可点、点一次发一次、失败不重发、没有定时器/后台）：这一步会跳过"到场扫码"，页面上有明确说明与确认弹窗，请自行决定是否使用；
- ★ 新增「签到区域编辑」页（已并入导航「我的场地」）：为每个签到点位设置提交时的落点分布 —— 按"走到圈里、停在偏内一点的位置"建模（而不是围着点位圆心均匀撒点，那样最容易被看出是程序特征）；内置 160 次采样预览图与统计，并保证绝不越出服务端围栏；
- ↑ 落点分布里最该调的是「进场方向」（真人每次都从同一个方向过来；方向随机时落点会围成一个整圆）—— 页面给了八方位角度对照表与一键预设；
- ↑ 提交坐标不再逐位回传服务端下发值，而是带 ≤5 m 随机抖动（真手机定位必有抖动），去掉一个"一眼假"的痕迹；点位标识（任务号/点位号/二维码）一律原样不变；
- ★ 自由跑落地真实链路：此前按钮在、真实提交却永远按阳光跑发（会带任务号、计入成绩）；现在按厂商口径走 runType=1、不带任务号；并且两种跑法都要求先用「跑道编辑」描过跑道；
- ★ 导航重构：把「跑道编辑 / 签到区域」并入【我的场地】、「记录 / 日志」并入【数据】，组内小标签各自有独立网址（刷新/分享/后退都正确）；旧网址保留并自动跳转，旧书签不会失效；
- ★ 阳光跑与自由跑合并为【跑步】一个入口（组内小标签：阳光跑 / 自由跑，各自有独立网址）；旧网址 /run、/freerun 保留并自动跳转，旧书签不失效；
- ★ 自由跑现在也能选线路了 —— 你选的线路只决定「本机用哪条几何生成轨迹」（仍然只允许用你自己描过的跑道）；提交时线路标识一律为空、不带任务号，与小程序一致（阳光跑的提交口径完全没变）；
- 🐞 修掉：跑步中或结算后切标签会把「自由跑」当阳光跑提交（会计入成绩）、提交等待期间可以重置导致界面与后台状态不一致、等待期间退出登录会让提交卡死、生成轨迹时可能回落到官方模板（与"只用你自己描的跑道"相矛盾）、内外圈不足 3 点也能存进路线库、真实提交确认框可被双击发两次、日志容量上限失效、主代理请求没有超时；
- ℹ️ 本轮同时做了代码审计（含独立审计）与健壮性加固：单测从 1.1.9 的 138 例增加到 245 例，模块级守卫与自测同步更新；CI 已恢复全绿。
下载与校验
| 文件 | 说明 |
|---|---|
totoro-heaven-1.1.11.zip |
单文件 EXE，解压即用（Windows） |
totoro-heaven-1.1.11.7z |
同上，体积更小（需 7-Zip 等工具解压） |
SHA256：
71FF633B172550EDE8A838969DB948723D9C87DDABC9245784979DE2239379E7 totoro-heaven-1.1.11.zip
247D580819FBC251A8739C2CF3CD07DD64EDD6B7923CA7959A55AC9E9A6B334C totoro-heaven-1.1.11.7z
使用提示
- 双击 EXE 即可，浏览器会自动打开界面；数据与配置都保存在本机，不上传任何服务器。
- 「阳光跑 / 自由跑」在同一个「跑步」入口里；两种跑法都要求先用「跑道编辑」描过你自己的跑道。
- 旧版网址（如
/run、/records）仍可用，会自动跳到新位置。
预览测试版（1.1.）；对外推荐正式版为 1.2.（计划 9.20）。
1.1.10
1.1.10 —— 只跑你自己描的跑道 · 「恢复」真正能重建会话
⚠️ 重要（务必先看）
- 请使用最新版本（1.1.10），不要再使用更早的版本；
📌 特别说明：
1.1.7与1.1.8这两次发布的安装包里实际是更早版本的界面
（打包脚本的缺陷导致旧构建被复用）。该缺陷已在 1.1.9 修复并重新打包，本版继续适用；
如你装过更早的版本，请直接覆盖安装本版。- **本版本只支持「校园跑（校园阳光跑）」**这一条流程（自由跑不在支持范围内）；
- 适配龙猫官方
wx67版本（已逐条核对接口契约）—— 该结论自 1.1.5 起成立，本版继续适用；- 夜间 22:30 ~ 次日 06:00 只停「真实提交」，本地模拟与预览照旧可用
（跑一条看形状、看自检表、看报文预览都没问题）；读取账号 / 取 token / 看记录与日志也仍然可用；- 支持条件（运行时自动判定，非白名单）：① 学校与南航共享同一 API 域（
wxxcx.xtotoro.com）；
② 该校未开启开场人脸 / 随机抽查 / 摄像头杆校验。
⚠️ 「支持」不等于「保证判有效」：仅南航的判分口径经我们实测验证，其他学校请到「记录」页核对判定。⚠️ 本版起，阳光跑页只会列出你自己描过的跑道：请先在「跑道编辑」里描一条，否则会提示去描。
🆕 本版重点
- ★ 只跑你自己描的跑道：阳光跑页现在只列你在「跑道编辑」里描好的路线，并以它的几何为基准生成轨迹。
没描过就不列官方线路、不能开跑，并给出「去跑道编辑描一条」的明确入口。为什么这么改：官方模板与真实操场可差十几米到几十米（南航实测中位 11.6 m、最远 50 m），
拿它当生成基准会把这个偏差直接带进轨迹里。官方路线仍会画在预览里，但只作对照。 - ★ 「恢复」重做 —— 真正的一键恢复：本机会把 token 一起存下来，所以点「恢复」就能
重建会话并自动重新读取（账号 / 任务 / 线路 / 开关全部刷新，并沿用上次选中的线路）。
界面只显示 token 的掩码（例gho_FA…567890），退出登录或「清空本机数据」时一并清除。之前这个按钮其实只是个"检查有没有 token"的触发器：token 丢了就永远恢复不了，现在修好了。
- ★ 跑道编辑页新增提示：描圈请以卫星图为准，不要照着灰虚线（官方路线）描。
- ★ 轨迹预览措辞修正：明确写出"本次轨迹是按你描的跑道生成的"，灰虚线（官方路线）仅作对照；
偏离数值标明是"到官方路线"的距离，偏大不代表你跑偏（官方路线自己就可能差十几到几十米）。
同时保留了按圈着色与局部放大：多圈不再糊成一条粗带，放大图里能看清各圈分开多少米。
🐞 修复
- 跑道编辑页曾出现两个「保存（本机）」按钮：多出来的那个还缺少"内外圈不合法就禁止保存"的保护，
可能导致不合法的跑道被存进路线库 —— 已删除多余的按钮。 - 折返跑（未闭合路线）在折返点出现横向飞线：一趟往返曾被当成两圈，导致折返点横向阶跃约 6 m；已修正。
- 「阳光跑」页此前在没配置跑道时会悄悄列出官方线路（提示不醒目，容易被当成 bug）——现已按上面的口径收紧。
📦 下载与使用
- 下载
totoro-heaven-1.1.10.zip并解压； - 双击
totoro-heaven.exe（免装 Node.js / 免依赖）；启动后自动打开浏览器
（默认http://localhost:3000；若该端口被占用会自动换端口，终端横幅里有实际地址）； - 工作台点「一键获取 token」→ 去「跑道编辑」描一条你常跑的跑道并保存（本版必需）→
进「阳光跑」→ 选线路 → 开始跑步 → 「真实提交」→ 等倒计时结束。
| 项 | 值 |
|---|---|
| 附件 | totoro-heaven-1.1.10.zip（内含单文件 totoro-heaven.exe） |
| 适用 | 微信小程序「龙猫体育锻炼」的校园阳光跑（共享域 + 无风控校验的学校） |
| 渠道 | 预览测试版（1.1.）；对外推荐正式版 1.2.（计划 9.20） |
1.1.9
1.1.9 —— 顶部提示条重做 · 路线可改名 · 轨迹预览看得见跑道
⚠️ 重要（务必先看）
- 请使用最新版本（1.1.9），不要再使用更早的版本；
📌 特别说明：
1.1.7与1.1.8这两次发布的安装包里实际是更早版本的界面
（打包脚本的缺陷导致旧构建被复用，只有版本号变了）。本版已修复该缺陷并重新打包，
界面与功能以本版为准；如你装过 1.1.7/1.1.8，请直接覆盖安装本版。- **本版本只支持「校园跑（校园阳光跑）」**这一条流程（自由跑不在支持范围内）；
- 适配龙猫官方
wx67版本（已逐条核对接口契约）—— 该结论自 1.1.5 起成立，本版继续适用；- 夜间 22:30 ~ 次日 06:00 只停「真实提交」，本地模拟与预览照旧可用
（跑一条看形状、看自检表、看报文预览都没问题）；读取账号 / 取 token / 看记录与日志也仍然可用；- 支持条件（运行时自动判定，非白名单）：① 学校与南航共享同一 API 域（
wxxcx.xtotoro.com）；
② 该校未开启开场人脸 / 随机抽查 / 摄像头杆校验。
⚠️ 「支持」不等于「保证判有效」：仅南航的判分口径经我们实测验证，其他学校请到「记录」页核对判定。
🆕 本版重点
- ★ 顶部提示条重做：成功 / 警告 / 错误各有底色，点一下（或点右侧 ×）立即关闭，
不点则 3 秒自动消失；进出场有淡入淡出与轻微位移（不做位移的偏好在系统里可关）。 - ★ 本地路线库支持「重命名」：给你描好的跑道起自己的名字（最长 24 字，留空即恢复官方名）。
列表会标出官方原名，跑步页的线路下拉也显示你起的名字。
只影响本机显示，不会改动学校线路本身（提交用的线路标识与轨迹口径完全不变）。 - ★ 「轨迹预览」按圈着色 + 局部放大：把轨迹按圈拆开、每一圈一种颜色（细线，不再糊成一条粗带），
并新增一张局部放大图（90 m × 90 m）直接标出"各圈分开约 X m"；
同时画上你描的跑道内外圈与所选车道线 —— 一眼就能看出轨迹有没有跑在自己描的跑道里。 - ★ 多圈不再完全重合：轨迹会以官方模板线为中心、逐圈小幅波动（大小交替、圈内保持笔直），
更像真人在 2~3 条道之间缓慢挪动，而不是所有圈叠成一条。 - 🔧 启动更稳：若 3000 端口已被占用，程序会自动改用下一个可用端口并在横幅里写明；
若检测到本工具已在运行，则直接打开浏览器而不是报错退出。
🆕 其他改进
- 「记录」页新增「异常标记」列（服务端
warnType），并写明：真人真跑也可能带"拟合度异常"标记，
它与是否使用本工具无关；手机端记录详情页那个 ⚠ 是厂商自身的显示问题。 - 「版本信息」页显示当前版本的完整更新日志与贺图（此前 1.1.9 无条目时会退回显示 1.1.8）。
🐞 修复
- 🔴 打包缺陷（影响 1.1.7/1.1.8 两个版本）：打包脚本只检查构建目录"是否被开发模式污染"，
于是旧的构建产物被直接复用，导致那两版装出来是更早版本的界面。现已加入源码新鲜度断言
（包里必须含当前版本的发布条目）与贺图收口（只打包当前版本那一张）。这也是本版体积变化的原因：以前的包里会混入多个历史版本的贺图，现在只保留当前版本。
- 轨迹预览此前不显示内外圈与车道线；多圈同色导致重叠时看不清（已改为按圈着色）。
- 若你描的圈与本次轨迹相距过远（例如描错了线路），预览现在会明确提示相距多少公里以及怎么修，
而不是给出一张看不懂的空白图。
✅ 实测
- 真实提交闭环（1.1.7 起持续验证）：轨迹成功入库（云端
pointList点数 = 提交点数）、判定有效； - 1.1.9 开发版再次实测：
sunrunId20260918938，3.27 km / 00:19:57 / 判定有效 / 云端pointList1112 点； - 确认服务端存的就是客户端上报的拟合度；
- 官方模板与真实跑道/真跑轨迹的偏差实测：中位 11.6 m、P95 39 m、最大 50.2 m
⇒ 这也是轨迹预览里那句"也可能是官方数据偏移较大"的由来。
⚠️ 因此强烈建议先描一次你常跑的跑道再跑：轨迹会贴着真跑道生成，拟合度与观感都会更好。
📦 下载与使用
- 下载
totoro-heaven-1.1.9.zip并解压； - 双击
totoro-heaven.exe（免装 Node.js / 免依赖）；启动后自动打开浏览器
（默认http://localhost:3000；若该端口被占用会自动换端口，终端横幅里有实际地址）； - 工作台点「一键获取 token」→ 去「跑道编辑」描一条你常跑的跑道并保存（可选但强烈建议）→
进「阳光跑」→ 选线路 → 开始跑步 → 「真实提交」→ 等倒计时结束。
| 项 | 值 |
|---|---|
| 附件 | totoro-heaven-1.1.9.zip（内含单文件 totoro-heaven.exe） |
| 适用 | 微信小程序「龙猫体育锻炼」的校园阳光跑（共享域 + 无风控校验的学校） |
| 渠道 | 预览测试版（1.1.）；对外推荐正式版 1.2.（计划 9.20） |