okooooooo/biliup
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,042 Commits 1 Branch 0 Tags
master
Commit Graph
104 Commits
Author SHA1 Message Date
ForgQi dd7bb7a9ee Refine auth policy and migration compatibility 
Centralize authorization into a policy layer so route, field, and user-permission checks all use the same decision point. The frontend now revalidates /v1/me after 403s or dropped connections, and the users page fetches the real role/permission catalog from the backend instead of hardcoding role descriptions. This also tightens field-level protection for sensitive config/template data and avoids exposing user-management controls when auth is off.

The backend and migrations are updated to handle LF/CRLF checkout differences in SQL migration checksums, with compatibility reconciliation for older databases and safeguards to prevent silent drift of previously shipped migrations.
 2026-09-24 19:44:35 +08:00
Noah 67e49354ad fix(recorder): stop stream-gears losing the tail, default to mesio (#1733) 
* fix(stream-gears): write the cached GOP on disconnect, flush before the segment hook

The httpflv loop kept the current GOP in `flv_tags_cache` and only wrote it
when the next keyframe arrived. On EOF, a 30 s read timeout or a parse error
the function returned and the cache was dropped, so every disconnect,
reconnect and stream end lost the last 1-10 s. The loop now runs in an inner
function; whatever way it exits, the complete tags in the cache are written
before the original result (including the error) is returned.

`FlvFile` / `TsFile` renamed the `.part` file and ran the segment hook before
the old `BufWriter` was flushed, so the hook (FileValidator, upload) could see
a truncated file, and a failed final flush (disk full) was swallowed. Both now
go through `finish()`: flush and check the error, then rename, then run the
hook. `create_new` returns the flush error; `Drop` logs it with `error!`.

Tests: the rolling-segment test now expects 120 keyframes on disk (was 119)
and checks the size seen by the hook equals the final size; new cases for a
stream that ends cleanly, a read that times out and a parse error; a TS hook
size test; a failed-flush test.

Ref #1726

* feat(recorder): default to mesio when no downloader is configured

Rooms without a `downloader` setting followed the plugin hint, which is
stream-gears for almost every platform. They now use mesio: its FLV output
carries `onMetaData.keyframes` and every segment starts at timestamp 0, so
players can seek; it also records HEVC / Enhanced-FLV and HLS fMP4, which
stream-gears cannot. Only the hint mapping in `core/live.rs` changes; an
explicit `stream-gears` keeps using stream-gears, and plugins that hint
streamlink / yt-dlp are unaffected.

`DownloaderRuntime::from_type` no longer has a catch-all arm. `ffmpeg-external`
and `ffmpeg-internal` used to fall into it and silently run stream-gears; both
now run ffmpeg (external segmenting, same as `ffmpeg`). The arm for
streamlink / yt-dlp / ytarchive, which need the live stream and are built in
`downloader_runtime`, is listed explicitly and logs a warning.

WebUI, README, sample configs and CHANGELOG now say mesio is the default and
list the behaviour differences: the container follows the source (HLS fMP4 is
saved as .mp4), files are written under their final name without `.part`, and
Douyu Wangsu reconnects leave a 2.6-5.8 s overlap between segments.

Ref #1726

* feat(mesio): pass segment duration and size to the segment callback

mesio's segment-complete callback reports the duration and byte size of each
closed file, but biliup only logged them and built `SegmentInfo` with the path
and index. `SegmentInfo` gains `duration_secs` / `size_bytes` (None for the
other downloaders) and mesio fills them in. The end-to-end mesio test checks
the reported size equals the file size on disk.

Ref #1726

* fix(recorder): parse segment_time the same way in every downloader

`segment_time` was read three different ways. stream-gears indexed
`parts[1]` / `parts[2]` directly, so "3600" or "01:00" panicked the download
task (and an unparsable hour silently became 1); mesio returned 0 for anything
that was not HH:MM:SS and silently recorded without time splits; ffmpeg got
the raw string and accepted both forms.

`parse_segment_time` follows ffmpeg's duration syntax (`[HH:]MM:SS[.frac]`
or plain seconds; minutes and seconds below 60 when colons are used), so all
three downloaders now agree. stream-gears and mesio share
`DownloadConfig::segment_time_limit`: 0 means no time split for both (mesio
already did this; stream-gears used to split at every keyframe), and a value
that still cannot be parsed logs a warning and records without time splits
instead of panicking or being ignored silently. The time-range clamp uses the
same parser, so "3600" is shortened near the window end like "01:00:00".

Ref #1726

* feat(webui): enter file_size as a number with an MB/GB unit

The config still stores bytes. The control converts with 1024 (the same
sizes Windows Explorer shows), keeps an untouched value byte-exact even
when it is not a round MB/GB, and re-picks the unit when the form value
is replaced from outside.

In the streamer override, clearing a value that was already set now
saves null (no size split for that streamer); before, Semi dropped the
emptied key and the old value stayed. Clearing something typed in the
same session still falls back to inheriting the global setting.

* fix(webui): keep the file_size unit beside the number in narrow modals
 2026-09-24 06:24:17 +00:00
Noah d343386fbd feat: 用户管理与分级权限（超级管理员 / 操作员 / 只读观察者） (#1718) 
* feat(web): multi-user accounts with fixed admin/operator/viewer roles

- migration 6 adds web_users and copies the existing single admin with
  the same id and password hash, so upgrades need no action and existing
  sessions stay logged in
- table-driven permission middleware on every business route (default
  deny), 403 for missing permission, 401 when logged out
- hooks/override and secrets redacted for non-admins; operators may only
  pick registered bilibili accounts for templates
- /v1/web-users management API, /v1/me and self password change
- login rate limit: 5 consecutive failures lock the username for 30s
- revoked sessions cut long-lived websocket/stream responses

Refs #1717

* feat(cli): add `biliup user list` and `biliup user reset-password`

Refs #1717

* feat(web-ui): user management page, account menu and editable login name

- /users page (super admin only): create users, change role, reset
  password, disable, force logout, delete; table on desktop, cards on
  mobile, with loading/empty/error states
- sidebar filters menu entries by the permissions from /v1/me and shows
  a no-access state for pages the role cannot open
- account menu in the sidebar footer with change password and logout,
  hidden when --auth is off
- 403 responses show a warning toast instead of redirecting
- login page username is editable (default biliup)

Refs #1717

* feat(web-ui): hide actions the current role cannot perform

Streamer add/edit/delete/pause, hook and override editing, template and
upload actions, bilibili account management and config saving are only
rendered for roles that have the matching permission. Account and type
tree requests are skipped for roles that would get 403.

Refs #1717

* fix(web-ui): wait for permissions on restricted pages, surface pause errors

- pages that need a permission not every role has render a spinner until
  /v1/me returns, so roles without it never fire requests doomed to 403
- user management is hidden when --auth is off, with an explanation if
  the page is opened directly
- the pause button goes through the shared response handler, so a 403
  shows the permission toast instead of failing silently
- permission errors sent as plain text keep their message

Refs #1717

* fix(web-ui): keep user actions reachable on tablet and narrow desktop

Refs #1717

* fix(py): handle the user subcommand in the stream-gears entry point

Refs #1717
 2026-09-23 14:59:58 +00:00
Noah 3ab1a4630b feat: live-url 同一房间 5 秒去抖（失败重取带 fresh=1 绕过）；斗鱼网宿直链追加 expire=0，不再每 5 分钟断流 (#1713) 
* feat(preview): live-url 同一房间 5 秒去抖，播放失败后的重取带 fresh=1 绕过

每次打开预览都向平台 API 取一条新直链（带 cookie 时消耗登录态配额，B 站接口有频控）。同一房间
5 s 内的重复请求（StrictMode 双调用、连点、同一房间多个小窗）复用上一次结果并标 cached: true，
不再打平台；前端播放失败后的重取传 ?fresh=1 一定拿新 token（抖音某节点 404、直链到期都靠它）。
缓存插入时顺手清掉一分钟前的条目，表不会长。

Part of #1708

* feat(douyu): 网宿直链末尾追加重复的 expire=0，不再每 5 分钟断流切文件

斗鱼网宿 CDN 按直链里的 expire=300 每 300 s 关闭一次连接，stream-gears 录斗鱼因此
5 分钟一个文件。实测网宿的 wsAuth 只校验第一个 expire、连接寿命取最后一个：保留原值、
末尾再追加 &expire=0 能通过校验且不再断开；删掉或改写原值都会 403。

- douyu：只对网宿直链（host 为 ws*.douyucdn.cn 或 fcdn=ws）、且只有一个非 0 expire 时追加；
  火山（force_hs）、华为等其它线路与已是 expire=0 的直链不动。
- stream-gears：首连 403 且是追加过的直链时，本次改用原直链再连一次（同一 token 仍有效），
  之后照旧按 300 s 断开续录；每次拉流最多多一次请求，不进外层重试。
- 其它下载器（ffmpeg / mesio / streamlink / 边录边传）与预览直连没有这层兜底，照旧用原直链。
 2026-09-23 11:06:06 +00:00
Noah 48dc8fd65b fix(preview): 中转模式在有 RTT 的链路上频繁缓冲——旁路挪到解析点、掉队原地续播、缓冲分低延迟 2 s / 流畅 5 s 两档 (#1716) 
* fix(preview): stream-gears FLV 在解析点旁路，不等写盘循环整 GOP 落盘

httpflv 的写盘循环把 tag 攒在 flv_tags_cache 里，等下一个关键帧到来才把整个 GOP
一起写出——预览的旁路点原来就挂在这个写出循环里，于是预览端每个 GOP 间隔（B 站
常见 2–4 s）收到一次整 GOP 的突发、其余时间一个字节都不来，且整体落后一个 GOP。
播放器拿到的缓冲恰好在下一个突发到达时耗尽，零余量：同机 0 ms 下勉强连上，链路
上稍有 RTT / 抖动就 waiting；GOP 长于 mpegts.js 的追帧阈值时更是每个 GOP 都跳一次
再停一次（实测 GOP 4.2 s 的房间同机也有 85% 时间处于 waiting）。

把旁路挪到 tag 解析完、进缓存之前：预览按 tag 实时收到，与 mesio 路径（在条目进
管线前 tee）一致。写盘循环一个字节不变；旁路仍只是 push，不 await、不返回错误。

实测（arrival-probe，40 s）：同一斗鱼房间直连 CDN 到达连续（最大静默 0.24 s），
中转修前每 2.0 s 一个 ~940 KB 突发、20 个静默间隙全部 > 1 s。

Refs #1712 #1713

* feat(preview): 快照保留最近 6 s 的 GOP，新订阅者起播就有几秒缓冲

原来快照只含「当前 GOP」：新订阅者从零到一个 GOP 之间的缓冲起步，之后到达 = 消耗，
缓冲永远这么薄，链路上几十到几百毫秒的抖动就 waiting。浏览器直连 CDN 时 CDN 会先
给几秒的 GOP 缓存，中转得给同样的深度。

PreviewSink 里多一个已完成 GOP 的队列（按关键帧到达时刻计，保留 SNAPSHOT_WINDOW = 6 s
以内的），快照 = 文件头 + 序列头 + 队列里的 GOP + 当前 GOP，实际深度在 6 s 到 6 s +
一个 GOP 之间。字节上限 MAX_SNAPSHOT_BYTES = 16 MB（6 s × 20 Mbps），超过先丢最旧的
GOP；单个 GOP 超过 MAX_GOP_BYTES 作废时历史一并放掉（不再连续）；序列头内容变了或
fMP4 换了 init 时历史也放掉（旧 GOP 与新参数不配），内容相同的重发（stream-gears
分段时重放 onMetaData / 序列头）不影响。热路径只多几次 usize 比较与一次 VecDeque
push，仍不 await、不返回错误；无订阅者时同样保留（第一个订阅者也要立刻有缓冲），
每路多占约 6 s 的码率（1080p 2–5 MB）。

`with_snapshot_window(Duration::ZERO)` 给只关心分块判定的测试用。

Refs #1712 #1713

* fix(preview): 客户端掉队时从最近关键帧原地续播，不再断开重连

广播缓冲被覆盖（Lagged）时原来直接结束响应，浏览器看到「连接已断开，2 秒后重连」
的加载态，再花一次 HTTP 往返 + 等下一个关键帧才恢复；带宽长期偏紧的链路上就是
反复「触发加载」。

现在 hub 多一个 `resubscribe(previous, timeout)`：复用原订阅的连接许可（不占第二
个名额），向写入端再要一份从最近关键帧起的快照与新接收端；响应在同一条连接里续
发这份快照——FLV 去掉文件头（`Subscription::snapshot_after_header`，解码器不能中途
再收到文件头；序列头照给，掉队期间可能换过），fMP4 的 init segment 照发（MSE 接受
中途再来一份）。mpegts.js 的 remuxer 会把批次之间的时间戳跳变收平，画面表现为跳
过一段而不是转圈；一次响应最多 MAX_RESYNCS_PER_RESPONSE = 20 次，再多说明客户端
长期跟不上，结束响应交给播放器。每次重对齐 warn 日志带 skipped 与累计次数。

Refs #1712 #1713

* perf(preview): 客户端追赶积压时把广播缓冲里攒着的分块合并写出

实时转发每收到一个分块就写一个 chunked 帧（FLV 一个 tag 几百字节到几十 KB）。
客户端跟得上时缓冲里本来就只有一个，无从合并；追赶积压（起播快照刚发完、链路
抖动之后）时缓冲里攒着几十上百个，逐个写出是几十上百次 socket 写与 chunked 帧。
`coalesce` 在 `recv()` 到手后用 `try_recv` 把已经在缓冲里的后续分块合并成一个
响应块（上限 COALESCE_BYTES = 64 KB），缓冲空着就原样透传不复制，不引入任何等待；
合并途中撞上 Lagged 时把跳过数交回主循环按掉队处理，不吞掉。

Refs #1712 #1713

* fix(ui): 中转模式的播放器维持约 5 s 缓冲，用倍速而不是跳变追帧

mpegts.js 原来对中转、直连一律 liveBufferLatencyMaxLatency 3 s / MinRemain 0.5 s：
缓冲一超过 3 s 就跳到末尾前 0.5 s，等于把服务端刚给的几秒快照直接扔掉，之后只剩
0.5 s 余量，链路一抖就 waiting；GOP 长于 3 s 的流更是每个 GOP 跳一次再停一次。

按取流方式分两套参数（`Players` 新 prop `transport`，LivePreviewPlayer 按实际 source
传）：
- relay：liveSync 倍速追帧——落后 > 9 s 用 1.1× 追到 5 s 附近，≤ 5 s 恢复 1×；
  只在落后 > 20 s（长时间暂停后）才直接跳到末尾前 5 s。与服务端 6 s 的快照窗口配合，
  播放器起播就有约 5 s 缓冲并一直保持。
- direct：沿用原参数（CDN 自带 GOP 缓存，ForgQi 实测异地直连不卡，不动）。

fMP4 的 MediaSource 播放器（只在中转路径上）同样改成：起播对齐到末尾前 5 s、
落后 > 9 s 用 1.1× 追、> 20 s 才跳；另加空洞跳过——服务端掉队重对齐后分片时间戳
前跳，缓冲区出现空洞，停在空洞前沿时跳到下一段起点，不再原地转圈。

Refs #1712 #1713

* style(preview): cargo fmt 与 clippy（len_zero）

* feat(preview): /live 支持 snapshot_ms，起播快照按播放器要的缓冲深度回溯

新订阅者拿到多深的快照，播放器就有多深的起播缓冲，也就是多长的中转延迟。之前一律给整个 6 s
保留窗口，只适合「流畅」档；低延迟档要 2 s 就只该拿 2 s，而不是拿 6–10 s 再用 1.1 倍速追 40 s。

- PreviewHub::subscribe_with_depth(depth)：从当前 GOP 往前取，取到第一个关键帧到达时刻早于
  「现在 − depth」的 GOP 为止（含），起播缓冲落在 depth 到 depth + 一个 GOP 之间；Some(ZERO)
  只给当前 GOP，None 给整个窗口。Subscription 记住 depth，Lagged 重新对齐沿用。
- GET /v1/streamers/{id}/live?snapshot_ms=2000；不带参数行为不变。「开始直播预览」日志多一个
  snapshot_ms 字段。
- 保留窗口 SNAPSHOT_WINDOW 仍是 6 s，服务端内存不变；热路径只在有订阅请求时多一次
  VecDeque::make_contiguous（历史只有几个 GOP）。
- 单测 +2：深度切分的边界（零 / 跨线 / 大于全部历史 / 空历史）、带深度订阅与重对齐沿用深度。

Refs #1713 #1716

* feat(ui): 中转预览分「低延迟 / 流畅」两档，默认低延迟 2 s，卡了自动升档

ForgQi 在 #1713 下问「中转有办法不延迟 5 s 也不卡顿吗」。主因（整 GOP 成坨下发）修掉后 5 s 是
过度配置：同一条模拟链路（60 ms RTT ± 16 ms、丢包重传停顿、20 Mbps）上四路真实房间扫
1 / 1.5 / 2 / 3 / 5 s 目标缓冲各播 180 s，三路 FLV 从 1 s 起就 0 次 waiting；只有 HLS 来的
fMP4 要盖住一个分片（B 站 1–3 s），3 s 起 0 次、4 s 余量最低约 1–2 s。

- app/lib/live-buffer.ts：缓冲控制统一到一处（原来 mpegts.js 的 liveSync 管 FLV、fMP4 播放器
  自己一套 chase）：起播跳到「末尾 − target」，快照落地那几秒里超了再对齐（慢链路上几 MB 要
  几秒才到齐，每对齐一次多看 2 s、最多 15 s），稳态超 max 倍速 / 超 hard 跳 / 跳过重对齐留下的
  空洞，稳态里缓冲耗尽一次报 onStall。档位：low = FLV 2 s / fMP4·TS 4 s，smooth = 5 s
  （目标与原 0d41140 相同，倍速阈值 9 → 7）。mpegts.js 在中转模式下关掉自己的追帧，直连一行未动。
- /live 请求带 snapshot_ms = 目标缓冲，起播就是目标深度，不再从 6–10 s 追回来。
- 低延迟档在稳态里卡一次 ≥ 1 s 或 60 s 内两次，本次播放升到流畅档重连（更深的快照起播），
  角标「卡顿，已切到流畅档」；换房间或改偏好即复位。
- 弹层标题栏与监视器工具栏各一个「低延迟 / 流畅」开关，记 localStorage biliup.preview.latency，
  默认低延迟；直连模式下不显示。

实测（同一模拟链路，180 s，hub 最新时间戳 → 已渲染）：低延迟档三路 FLV 延迟中位 2.1–2.4 s、
fMP4 2.8–3.7 s，四路 0 次 waiting；流畅档 5.1 s。每 18 s 停 2.5 s 的链路上低延迟档卡两次后
自动升档，之后 130 s 0 次。

Refs #1713 #1716
 2026-09-23 06:20:47 +00:00
Noah 486676db29 feat(ui): 直播预览阶段三——录制中房间实时码率折线图 (#1714) 
* feat(api): GET /v1/live-rates 录制中房间的每秒写盘速率瘦端点

/v1/streamers 每次查全表、拼齐全部字段，10 s 一次的节奏不适合调快；码率曲线需要 1 s 粒度，
新加一个只读内存的瘦端点：扫一遍 worker，对每个 Working 的房间读一次阶段一 RateMeter 的窗口均值，
返回 [{id, bytes_per_sec, ts}]。与 /v1/streamers 的 live_bytes_per_sec 同源同值；不新增采样任务、
服务端不存历史、Cache-Control: no-store；注册在 router() 内，--auth 时同一道登录校验。

Part of #1708

* feat(ui): 实时码率数据层与 uPlot 折线组件

- app/lib/use-live-rates.ts：页面内唯一的一份采样源。有订阅者时每秒拉一次 /v1/live-rates，
  全部卸载 / 标签页隐藏即停；历史放模块级环形缓冲（每房间最近 3 分钟），组件卸载不清，
  切走再切回曲线还在；帧里没有的房间补 null 成断口。useSyncExternalStore 订阅，无新帧不重渲染。
- app/ui/RateChart.tsx：uPlot 折线，full（带时间轴 / Y 轴，单位按窗口最大值自动选 KB/s / MB/s，
  Y 从 0 起）与 sparkline（无坐标轴，hover 读数）两种形态；实例在 effect 里建 / 销毁，渲染期不碰 ref，
  StrictMode 双次 effect 不留多余 canvas；配色每次绘制时读 Semi CSS 变量，深浅色切换不重建。
  无采样 / 未录制只显示「—」占位，不画空图。
- app/ui/LiveRateChart.tsx：next/dynamic 懒加载入口 + 当前 / 峰值 / 均值统计条；
  uPlot 与其 CSS 打进独立 chunk（约 23 KB gzip），首屏不含。
- 新依赖 uplot ^1.6.32（本 PR 唯一新依赖）。

Part of #1708

* feat(ui): 三处接入码率折线——弹层可折叠折线、卡片与监视器 sparkline

- 卡片弹层底部新增「写盘速率 · 最近 3 分钟」可折叠区（默认展开，折叠态记 localStorage
  biliup.preview.rateChart）：标题行带当前 / 峰值 / 均值，展开时才轮询与加载 uPlot。
- 控制台 / 直播管理页录制中卡片：名称行下一条 60 s sparkline（28 px，hover 显示时刻与数值）。
- 历史记录页「实时监视」：工具栏新增「码率图」开关（默认关，记 biliup.monitor.rateChart），
  开启后每路小窗下方一条 60 s sparkline；所有小窗共用同一次每秒请求。

Part of #1708

* style(api): live_rates 测试按 rustfmt 换行

* fix(ui): sparkline 的 hover 读数浮在折线上方，不再被容器裁掉

* docs(readme): 功能列表补充直播预览（封面 / 播放器 / 弹幕 / 码率曲线）

#1708 三个阶段至此完整，在 README 的功能列表里加一条说明。

Closes #1708

* feat(api): GET /v1/ws/live-rates 用 WebSocket 每秒推送码率帧

review 1（ForgQi）：复用现有的 WebSocket 机制推送而不是每秒轮询。WebSocket 不占浏览器对同一主机
HTTP/1.1 的六个并发连接（监视器 4 路视频 + 1 条弹幕 SSE 已用掉五个，这正是当初不用 SSE 的原因），
与日志页 /v1/ws/logs 同款：Origin 与 Host 同源校验、进程内连接数上限（16）、Ping 回 Pong、Close 即止。
连上立刻发一帧，之后每秒一帧，形状与 GET /v1/live-rates 相同；HTTP 版保留给 WebSocket 连不上时回退与 curl 核对。
两个路由都在 router() 内，--auth 下同一道登录校验。单测用手写的最小 WebSocket 客户端走完握手 + 两帧，不引新依赖。

* feat(ui): 码率数据改走 WebSocket；卡片 sparkline 加开关并叠在封面上

review 1（ForgQi）：
- use-live-rates.ts 首选一条 WebSocket /v1/ws/live-rates（服务端每秒推一帧，所有图表共用），
  一帧都没收到就断开（反代没放行 upgrade、401）时回退到每秒 GET /v1/live-rates 轮询；中途断开退避重连，
  标签页隐藏时断开、可见时重连；快照新增 transport: 'ws' | 'poll'。
- 控制台「进行中」区块头与直播管理页工具栏新增「码率图」开关（默认关，记 localStorage biliup.cards.rateChart，
  两页共用）；开启后录制中卡片的 sparkline 叠在封面底部（深色渐变垫底、读数条在图区内；点击仍冒泡到封面打开预览），
  封面没有 / 加载失败时退到名称行下方。

* test(api): 码率 WebSocket 连接上限测试改用独立信号量

CI 上与同一二进制里并发跑的 WebSocket 推送测试争用进程级信号量（后者占着一个许可），
上限测试拿不满 16 个而失败；改为像 ws.rs 的日志连接测试那样传入独立的 Semaphore。
 2026-09-23 03:44:43 +00:00
Noah ffa847e1c8 fix(preview): Twitch 不能直连的原因改为实测结论——清单服务器按 Origin 白名单放行 (#1715) 
HLS 直连补测各平台清单 / 分片的跨域头：B 站 fMP4 的 m3u8 / init / .m4s 同域 ACAO *；抖音 TS 的主清单与
媒体清单 + 分片不同域（douyinliving.com → 100ycdn.com）都 *；虎牙 TS 同域、回显 Origin（清单轮询有
边缘节点间歇 403，靠重取 / 回落）。Twitch：usher 主清单无 ACAO，媒体清单 / 分片带 ACAO *，但清单
服务器对 Origin 做白名单——twitch.tv 与 localhost 200、127.0.0.1 / 其它站点 403，所以部署到自己域名
后浏览器直连必 403，仍标不能直连，原因改成这句。弹幕 SSE 两个测试改用各自的信号量，不再与并行
测试抢全局那把（偶发失败）。

Part of #1708
 2026-09-23 03:42:37 +00:00
Noah 072604eed5 feat: 直播预览阶段二——内置播放器复用录制流（卡片弹层 + 历史页监视器） (#1712) 
* feat(downloader): 直播预览 hub 与写盘旁路（httpflv / hls / mesio）

每路录制任务一个 PreviewHub（寿命 = 整场 execute()，跨分段与断流重试），下载器开始拉流时
attach 一个写入端，在写盘点旁边把同一份媒体字节 push 给它：httpflv 在关键帧写出循环、
stream-gears/hls 在分片 chunk 循环、mesio 在条目进入修复管线前。fMP4 分片流与 HEVC 序列头
标为不可预览；ffmpeg / streamlink / yt-dlp / 边录边传明确不可预览并给出原因。

写入端热路径只做三件事：GOP 缓冲追加、try_recv 订阅请求、broadcast::send。没有 .await、
没有锁等待、没有 ?；订阅请求由写入端在下一次推送时回应，快照（文件头 + 序列头 + 当前 GOP）
与随后的实时分块严格衔接。GOP 快照上限 8 MB，广播缓冲 256 槽 × 64 KB 且无订阅者时不占用，
每路订阅者数由信号量限制；慢订阅者收到 Lagged 后由端点断开让其重连。

Part of #1708

* feat(api): GET /v1/streamers/{id}/live 与列表的 preview 字段

新增 chunked 视频流端点：先发关键帧对齐的快照再接实时分块，Content-Type 按容器为
video/x-flv 或 video/mp2t，Cache-Control: no-store。房间不存在 / 未录制 404，下载器不能
旁路 415（带原因），连接数超限 429（每路 4、进程 16），尚未开始拉流或正在重连 503 +
Retry-After。慢客户端 Lagged 或写入端换代时结束响应，由播放器重连。注册在 router() 内，
--auth 时与 /v1/streamers 同一道登录校验。

GET /v1/streamers 每项新增 preview: { available, format: "flv" | "mpegts" | null, reason }，
未录制为 null。

Part of #1708

* feat(preview): fMP4 分片流也能预览——init segment 快照、按分片广播、解出 codecs

mesio 的 HLS 会话拿到 fMP4 分片时不再标为不可预览：init segment（ftyp + moov）作为文件头
进快照，每个 moof + mdat 分片作为一个关键帧分块广播，新订阅者拿到 init + 最近一个完整分片，
端点 Content-Type 为 video/mp4，列表字段 preview.format 为 "fmp4"。

从 init segment 的 moov/trak/…/stsd 解出 RFC 6381 编码串（avc1.PPCCLL、hvc1.…、mp4a.40.N、
av01 / vp09 / ac-3 / ec-3 / opus / flac）放进 preview.codecs，供前端 MediaSource.isTypeSupported()
校验后 addSourceBuffer；解析只在 attach 后收到 init 时做一次，不在逐分块路径上。
stream-gears 的 HLS 路径没有下载 #EXT-X-MAP 初始化分片，遇到非 TS 分片时标为不可预览并说明原因。

按 ForgQi 在 #1708 的要求把 fMP4 纳入阶段二。

Part of #1708

* feat(ui): 直播间卡片的「预览」弹层——复用录制流的内置播放器

Player.tsx 加 isLive / muted / autoplay / type / codecs 与 onEnded / onError：flv 与 mpegts 走
mpegts.js（直播模式：不攒缓冲、追帧、自动清理 SourceBuffer），fmp4 走一个轻量 MediaSource
播放器（fetch ReadableStream → appendBuffer 串行队列，首个缓冲对齐播放位置，落后 > 3 s 追到
末尾，定期 remove 30 s 之前的缓冲），都以 Artplayer customType 挂载保持 UI 一致；
type 未知时用一次 GET 读 Content-Type 再起播。MediaSource.isTypeSupported 不通过时报错并显示
封面 + 原因，不转圈。

StreamerCard 录制中加「预览」图标按钮（不可预览时禁用，tooltip 显示后端给的原因），封面可点
即打开预览；弹层（LivePreview.tsx）关闭即卸载播放器、断开连接。服务端断开（掉队 / 换直链）
自动重连 3 次，之后交给用户手动重试；不可恢复错误 Toast 提示一次。零新依赖。

Part of #1708

* feat(ui): 历史记录页「实时监视」Tab——多路同屏监视器

<LiveMonitor /> 是独立组件：所有正在录制的直播间以小窗网格展示，可预览且在同屏路数内的
直接播放（默认静音），超出的显示封面、点击替换最早开始的一路（先进先出），下载器不能旁路
的显示封面与原因。同屏路数默认 DEFAULT_MONITOR_TILES = 4（可选 1/2/4/6/9，localStorage 记住），
每路小窗占对应直播间的一个预览连接。正在播放的列表由「用户选择 + 当前可预览房间 + 路数」
纯推导，不在 effect 里 setState。

历史记录页改为两个 Tab：「录制文件」（原表格）与「实时监视」，keepDOM=false 切走即卸载全部
播放器。要把监视器挪到别的页面只需换挂载点。

Part of #1708

* test(preview): 让旁路测试不依赖调度时机

rolling 测试先把订阅请求 poll 进写入端队列再开始写盘，源数据按 2 ms 一块限速送入而不是瞬间灌完
（瞬间灌完时订阅者必然掉队，那是慢订阅者测试覆盖的场景）；慢订阅者测试只断言
「收到 + 被告知跳过 = 全部」与写入端不等待，不再对读取任务在负载下的吞吐做假设。

* fix(ui): mpegts.js 的 MSE 解码失败给出可读提示

典型来源是 TS 的 PES 没按访问单元对齐（如 Twitch 的 HLS），mpegts.js 拆出的帧不完整、浏览器拒绝
解码；原文 "Failed to execute 'appendBuffer'…" 对用户没有信息量，改为说明原因并强调录制不受影响。

* fix(preview): fMP4 与 TS 的快照从关键帧起，而不是从分段边界起

B 站 hls_fmp4 的分段（约 1 s）各含多个 moof/mdat 分片、且分段边界不对齐关键帧（实测 10 次冷启动
只有 1 次首帧是 I 帧）：写入端现在把每个分段按 moof/mdat 切开，读 init 里的视频轨 ID 与
trex 默认 flags、trun 的 first_sample_flags / 首样本 flags / tfhd 默认 flags，视频首帧为同步样本的
分片才作为 GOP 起点。TS 分片起点则嗅探第一个视频 PES 的 NAL 类型（IDR/SPS → 起点，只有普通片
→ 追加到上一 GOP，说不准 → 按起点处理）。FLV 路径本来就按关键帧 tag 切，未变。

单测覆盖：分片切分（前导 styp、非同步 / 同步 / trex 默认 / 无视频轨）、跨分段边界的快照、
TS 嗅探（跨包的 PES、音频 PES 在前、非 TS 输入）；另有 #[ignore] 的 B 站真实抓样核对。

* feat(danmaku): 预览播放器的实时弹幕——录制中的弹幕客户端旁路一份到 SSE

danmaku crate 的 RecorderConfig 新增可选的 live_tx（tokio broadcast）：每解出一条事件，在写 XML
之前 send 一份（不等待，无订阅者即丢弃），XML 录制路径不变。DownloadTask 按 stream.danmaku
是否存在建一条 256 槽的广播，传给 danmaku_client；新增 GET /v1/streamers/{id}/danmaku（SSE，
每条 event 为 danmaku / gift / super_chat / guard_buy，data 为 {kind, text, name, color, ts}，
进场消息不进；掉队跳过不断开；进程上限 32 路，超出 429；无弹幕客户端的平台 415）。
/v1/streamers 的 preview 字段新增 danmaku: bool，前端据此启用 / 禁用弹幕开关。

Part of #1708

* feat(ui): 预览弹层装载实时弹幕（开关控制），监视器默认关

Player.tsx 新增 danmaku: { url, enabled }：装 artplayer-plugin-danmuku（新依赖，Artplayer 官方弹幕
插件，5.3.0），开关打开时用 EventSource 连 /v1/streamers/{id}/danmaku，每条事件 emit 进弹幕层
（普通弹幕滚动、礼物 / 醒目留言 / 上舰置顶描边），关闭时断开 SSE 并隐藏弹幕层，不重建播放器。
弹层标题栏加「弹幕」Switch，默认开、记在 localStorage（biliup.preview.danmaku）；平台没有弹幕
客户端时禁用并 tooltip 说明。监视器工具栏加同名开关，默认关（biliup.monitor.danmaku），
对全部小窗生效。localStorage 偏好统一走 useSyncExternalStore（app/lib/use-local-pref.ts），
同屏路数也改用它。

Part of #1708

* fix(preview): FLV 广播缓冲扩到 1024 槽，装得下 CDN 的整 GOP 突发

斗鱼 CDN 把整个 GOP（~4 s、~320 个 tag、~2 MB）一次突发送达，httpflv 解析器 1 ms 内推完；
刚建立的订阅者还没读到第一个实时分块，256 槽的缓冲就已被覆盖，收到 Lagged 被断开，重连后
又赶上下一个突发——冷启动 10 次只有 1 次播起来。FLV 分块是单个 tag，小而多，缓冲按格式分开：
FLV 1024 槽（实测均值 ~10 KB → ~10 MB），TS / fMP4 沿用 256 槽（分块大而少，16 MB 上限）。
回归测试：请求在关键帧回应后紧跟 600 个 tag 同步推完，订阅者仍逐个读到。

Part of #1708

* fix(ui): 弹幕开关禁用时说明是平台不支持还是未开对应 *_danmaku 配置

* feat(danmaku): 多个直播间的实时弹幕可复用一条 SSE（GET /v1/danmaku?ids=…）

浏览器对同一主机的 HTTP/1.1 并发连接只有 6 个：监视器同屏 N 路视频已占 N 个，弹幕若每路再开
一条 SSE，N=4 时就把列表轮询也饿死。新增 /v1/danmaku?ids=1,3,9 把若干路合成一条，事件 JSON
带 id 供前端分发；没有弹幕 / 未录制的 id 静默跳过，一个都没有时 404；一条最多 16 路，占 1 个
连接许可。原 /v1/streamers/{id}/danmaku 保留，走同一实现（事件同样带 id）。

Part of #1708

* feat(ui): 弹幕连接由页面持有并复用，监视器路数按 HTTP 协议限制

浏览器对同一主机 HTTP/1.1 只有 6 个并发连接，监视器 4 路视频 + 每路一条弹幕 SSE 就把列表轮询
饿死；9 路时也只有 6 路能播（实测）。改为 DanmakuFeed：页面（弹层 / 监视器）持有一条
/v1/danmaku?ids=… 连接，各播放器按 id 订阅；构造无副作用、open() 后有订阅者才连，StrictMode
下重复构造无害。同屏路数选项在 HTTP/1.1 下为 1 / 2 / 4，页面经 h2 / h3 加载时放开 6 / 9。
小窗弹幕字号 15px，弹层 22px。

Part of #1708

* fix(ui): 解码失败后关闭弹层必须断开拉流连接

<video>.error 非空时 mpegts.js destroy() 里清 SourceBuffer 的 remove() 抛 InvalidStateError，
后面的 transmuxer.close() 跑不到，连接留在服务端占着该路的预览许可直到刷新页面——真实 Twitch
TS 房间（mpegts.js 放不了）连开 4 次弹层第 4 次就 429。销毁前先把 MediaSource 从元素上摘下
（load() 使其 closed，mpegts.js 对 closed 的 MediaSource 跳过清理），destroy 仍抛则直接关
内部 transmuxer 兜底。

Part of #1708

* fix(ui): mpegts.js 换用可中止的自定义 loader，弹层关闭一定断开拉流

上一提交把 MediaSource 从元素上摘下只避免了 destroy() 抛异常，连接仍未断开：mpegts.js 自带的
FetchStreamLoader 在 Chrome 上处于 buffering 状态时 abort() 不调 AbortController.abort()，
而是等下一个 read() 回来再 reader.cancel()——解码出错后读取链已断，那一次永远等不到，连接留在
服务端占着该路许可（真实 Twitch TS 房间：关闭弹层后用 4 条 curl 探，1 条 429；再开一次 2 条 429，
直到浏览器退出才释放）。改为 customLoader：每次 open() 一个 AbortController，abort() 直接调它，
其余与原 loader 一致（直播不需要 Range）。

Part of #1708

* fix(ui): 忽略 Artplayer 在实例销毁后的自动重连，杜绝孤儿拉流连接

真正的泄漏来源：Artplayer 收到 video:error 后每隔 1 s 重设 art.url 最多 5 次（RECONNECT_TIME_MAX），
不检查自己是否已 destroy。弹层在解码失败时立刻卸载播放器，1 s 后 Artplayer 仍在已销毁的实例上
重设 url → customType 再建一个 mpegts.js 实例、再拉一路流，没有任何人持有它——每次打开泄漏
最多 5 条连接，直到刷新页面。mpegts / fMP4 两个 customType 入口对 art.isDestroy 直接返回；
fMP4 入口同时复用上一次的 dispose（同一实例重设 url 时先清掉旧的 MediaSource）。
mock 上用循环发送的 Twitch 坏样本复现：修前每开一次多 1 条连接（1→2→3），修后开关 4 次始终 0。

Part of #1708

* fix(ui): 自动播放重试前确认播放器还活着

* fix(preview): 最后一个订阅者走后释放广播缓冲

tokio broadcast 的缓冲只在被新数据覆盖时丢旧分块，而没有订阅者时写入端不再 send——最后一个
订阅者走后，缓冲里最后 N 个分块就一直挂着（FLV 1024 槽约 10 MB / 路；7 路真实短测中 RSS 在
一轮预览后从 95 MB 停在 117 MB）。写入端发现订阅者归零且缓冲里有数据时换一条新通道，旧缓冲
整个释放；之后的 subscribe() 拿新通道，对订阅者透明。

Part of #1708

* feat(preview): 直播预览取流方式配置（relay / direct）与浏览器直连的能力判定、直链端点

后端与浏览器不在一台机器时，浏览器直接向 CDN 拉一路能省服务器出口带宽（ForgQi，#1712 review 2）。
全局配置新增 preview_transport：relay（默认，复用录制流经 biliup 中转）/ direct（浏览器直连 CDN），
JSON 配置里可选字段，不需要迁移。/v1/streamers 的 preview 新增 direct: { capable, reason }，按
review 1 实测的平台表判定：B 站 / 抖音 / 虎牙 FLV 能直连；斗鱼一 token 一连接、直连会挤掉录制；
Twitch CDN 无 ACAO；HLS（TS / fMP4）本版本回落——mpegts.js 放不了 m3u8，直连需 hls.js；其它平台
未验证按不能。新增 GET /v1/streamers/{id}/live-url：当前录制中那条流的直链、容器、平台与过期时间
估计（B 站 expires / 抖音 expire 十进制 Unix 秒，虎牙 wsTime 十六进制；斗鱼的相对秒数不算），
Cache-Control: no-store，与 /live 同在登录校验之内。DownloadTask 随每次 check_stream 刷新直链。

Part of #1708

* feat(ui): 直播预览取流方式——全局设置下拉，direct 模式下浏览器直连 CDN、失败自动回落中转

空间配置 → 全局设置新增「直播预览取流方式（preview_transport）」：经 biliup 中转（默认）/ 浏览器直连
CDN，文案说明两者区别与适用场景。LivePreviewPlayer 按（房间, 配置, 能力）派生取流方式：direct 且
平台能直连时先 GET /v1/streamers/{id}/live-url 拿直链（https 页面下 http 直链换 https），mpegts.js
以 cors / 不带凭据拉 CDN；出错或断开时重取一次直链再播，仍失败回落中转；平台不能直连的房间在
direct 模式下直接走中转。播放器左上角角标：「直连 CDN」或「已回落中转：<原因>」。监视器小窗共用
同一组件。异步结果与回落都带 sourceKey，配置切换时不在 effect 里同步 setState。

Part of #1708

* fix(ui): 直连模式下弹层脚注说明取流方式

* feat(preview): 直连模式向平台另取一条直链，不复用录制那条；斗鱼由此也能直连

ForgQi（#1712）：走直连就不要复用链接，直接获取新链接。/v1/streamers/{id}/live-url 改为对该房间的
平台插件再调一次 check_stream，把新拿到的 raw_stream_url（新 token）给浏览器；平台返回未开播或
出错时 503，前端回落中转。实测新 token 的斗鱼 / 虎牙直链各读 25 s 稳定，同时录制那条连接无重试
——review 1 观察到的「斗鱼一 token 一连接」「虎牙第二条连接只给 GOP 缓存即断」都是同一直链两条
连接的问题，另取一条就绕开了。能力表：B 站 / 抖音 / 斗鱼 / 虎牙 FLV 能直连；Twitch 无 ACAO、HLS 需
hls.js 仍回落。Monitor 新增 PluginFor 消息按房间 URL 取插件。

Part of #1708

* fix(ui): 直连播够 60 s 后再断按直链到期处理，重取直链继续直连

斗鱼 CDN 的 token 每 5 分钟切一次连接（录制那条同样如此，日志里每 5:01 一次 StreamEnded → 重连），
B 站直链 1 h 过期。之前直连只允许重取一次，第二次到期就回落中转；现在区分「刚起播就失败」
（重取一次仍失败 → 回落）与「播了一阵才断」（视为到期，照常再取）。

Part of #1708

* feat(preview): HLS 直连——直链是 m3u8 时走 hls.js（按需加载），B 站 hls_fmp4 等也能直连

ForgQi（#1712）：HLS 直连也支持一下。新依赖 hls.js ^1.7（动态 import，只在直连模式打开 HLS 房间时
才下载那一个 chunk，首屏包不变）。live-url 的 format 按新直链后缀给 flv / hls；direct_capability
只看平台的跨域放行，不再因容器排除——B 站 .m4s 分片的 CDN 同样 ACAO: *。Player 新增 hls 分支：
跟到最后 3 个分片、后向缓冲 30 s、分片请求不带凭据；清单 / 分片 404、CORS、解码等致命错误报给
LivePreviewPlayer 走重取直链 / 回落中转，清单变为非直播视为断开。Twitch 仍因无 ACAO 回落。

Part of #1708

* feat(preview): live-url 同一房间 5 秒去抖，播放失败后的重取带 fresh=1 绕过

每次打开预览都向平台 API 取一条新直链（带 cookie 时消耗登录态配额，B 站接口有频控）。同一房间
5 s 内的重复请求（StrictMode 双调用、连点、同一房间多个小窗）复用上一次结果并标 cached: true，
不再打平台；前端播放失败后的重取传 ?fresh=1 一定拿新 token（抖音某节点 404、直链到期都靠它）。
缓存插入时顺手清掉一分钟前的条目，表不会长。

Part of #1708
 2026-09-22 16:25:00 +00:00
Noah 20fe058b15 fix(ui): 修复 React Compiler lint 命中并恢复规则为 error (#1711) 
* fix(ui): 主题与侧栏偏好改用 useSyncExternalStore 读取，去掉 effect 内 setState

react-hooks/set-state-in-effect 命中 4 处，都是「挂载后在 effect 里读浏览器状态再 setState」：

- app/(app)/layout.tsx:117 侧栏折叠偏好、:136 主题模式：两者都是 localStorage 里的值。
  新增 useLocalStorageValue(key)，用 useSyncExternalStore 订阅：服务端与水合期快照固定为
  null（与 SSR 输出一致，不会水合不一致），水合完成后 React 自己用真实值重渲染一次；
  写入走 setter 并通知本页订阅者。localStorage 写失败时退回内存值，本页内仍可切换，
  与原先 try/catch 后照常 setState 的行为一致。
- app/lib/utils/index.tsx:66 useSystemTheme：matchMedia 是外部状态，改为 useSyncExternalStore
  订阅 change 事件，服务端快照 light，与原来 useState('light') 再 effect 校正的结果一致。
- app/ui/ThemeButton.tsx:30：原来点击后先置 switchTrigger，再在 effect 里读标志位切主题、
  setMode、清标志位，图标也在 effect 里 setState。改为点击事件里直接算出下一模式并
  applyThemeMode + setMode，图标由 mode 派生，不再有中间 state 与 effect；切换结果相同，
  少一轮渲染。setMode 的类型收窄为 (mode: string) => void，调用方只传字符串。

useTheme 未改：它的首次跳过逻辑仍然成立（首帧主题由 <head> 内联脚本设置）。

* fix(ui): 日志页、空间配置页、账号列表与模板表单去掉 effect 内同步 setState

react-hooks/set-state-in-effect 其余 5 处：

- app/(app)/logviewer/page.tsx:133：connectWebSocket() 开头同步 setIsLoading(true)/setLogs([])
  再建连接，effect 与「刷新」按钮共用。拆开：effect 只负责建立 WebSocket、把消息写进
  state、cleanup 时关闭（上一条连接不再靠 ref 手动 close）；清空日志 + 进入加载态移到触发
  重连的事件里（切 Tab 的 onChange、刷新按钮），刷新通过 connectSeq 计数器让 effect 重跑。
  首次挂载时两个 state 本来就是初始值，其余时序与原来一致；顺带删掉不再需要的
  exhaustive-deps 禁用注释。
- app/(app)/dashboard/page.tsx:101：校验失败后先切 Tab / 平台，再在 effect 里滚到出错字段并
  把 pendingField 清空。改为 flushSync 同步提交切面板的 state，随后直接 scrollIntoView +
  focus（React 文档推荐的「更新后读 DOM」写法），去掉 pendingField 这个中间 state。
  onSubmitFail 由 Semi 在 Promise.catch 里调用，不在渲染期，flushSync 合法。
- app/lib/use-streamers.ts:26 useBiliUsers：data 为空时同步 setList([])。改为返回值直接派生
  （无账号 → 空数组常量），effect 里只保留异步补全；data 为空数组时 Promise.all 解析为 []
  仍会把上一批结果清掉，之后再有账号不会先闪旧数据。
- app/ui/TemplateFields.tsx:183：挂载后从 formApi.getValue('dtime') 算滚轮初始选中值。
  Semi Form 在构造函数里就把 initValues 放进 store，首次渲染即可读到，改为 useState 的
  惰性初始值（换算逻辑抽成 delayFromDtime），结果与 effect 版本相同。
- app/(app)/components/BackgroundSetter.tsx:71：hasBg / opacity 挂载后从 localStorage 读。
  改为 useState 惰性初始值；两个值只在面板展开后渲染，SSR 首帧输出不受影响。

* fix(ui): 修复渲染期不纯写法：卡片实时时长、平台插件查找、time_range 转换

- react-hooks/purity  app/ui/StreamerCard.tsx:101：渲染期调 Date.now() 算「已直播多久」。
  新增共享时钟 useNowSec()（app/lib/use-dashboard.ts）：模块级 store 由定时器每秒推进，
  组件用 useSyncExternalStore 读取，首个订阅者接入时校准一次。时长拆成 LiveDuration 子组件，
  只有录制中的卡片挂载它，其余卡片不随时钟重渲染。显示值语义不变（开播至今，同一
  formatDuration），刷新节奏从「随 10 s 轮询重渲染时更新」变为每秒更新。timeAgo 内部也用
  Date.now() 但未被规则命中（在工具函数里），本次不动。
- react-hooks/static-components  app/ui/OverrideModal.tsx:297：JSX 里用 IIFE 调 platformSetting()
  拿到组件再渲染，规则把它当成「渲染期创建的组件」。实际是按 url 从模块级常量表
  SupportedPlatforms 取组件。改为先找出匹配的键，再按键从常量表取值，让「同一引用」这一点
  在代码上可见；匹配顺序与结果不变。
- react-hooks/immutability  app/ui/TemplateModal.tsx:121：把 props.entity.time_range 由 JSON
  字串就地改写成 Date[]。改为 useMemo 生成一份本地副本作为 Form 的 initValues，解析失败
  保持原样并 console.error（同原逻辑），不再修改上层传下来的对象。

* chore(lint): 恢复 React Compiler 系列规则为 eslint-plugin-react-hooks 的默认 error

#1710 升级 eslint-plugin-react-hooks 7 时把 set-state-in-effect / static-components /
purity / immutability 四条降为 warn，留给专门 PR 处理。命中的 12 处已在前三个 commit 修完，
这里删掉覆盖，回到插件 recommended 的 error 级别。

* fix(ui): useTheme 不再回写 localStorage，mode 只由 useLocalStorageValue 的 setter 持久化

mode 改由 useSyncExternalStore 从 localStorage 读取后，同一个键有了两个写入方。
StrictMode 下 effect 会在挂载时执行两次，useTheme 的「跳过首次」只能挡住第一次，
第二次会用水合期的默认值 auto 把用户刚保存的主题覆盖掉，再由 store 读回 auto——
`next dev` 里每次刷新主题都会丢（生产构建没有双次 effect，不受影响）。
去掉 useTheme 里的 setItem：切换主题时 setter 已经写过同一个值；系统配色变化时原来会
把 auto 写进去，去掉后键保持缺省，读出来同样按 auto 处理，行为一致。

* fix(ui): 登录页在手机宽度下卡片超出视口、两侧被裁切

review 意见（#1711 下 ForgQi）：手机尺寸下登录页两侧被裁切。
原因：三个输入框写死 style={{ width: 440 }}，卡片宽度由它们撑成 552px（440 + 56×2 内边距），
.main 居中放置、.frame 又是 overflow: hidden，窄于 552 的屏幕上卡片两侧直接被裁掉。
改法：去掉输入框的固定宽度，卡片定宽 552px 并允许 max-width: 100% 收窄到视口，
.inputs 改为 align-items: stretch 让字段撑满卡片内容区（Semi 的 .semi-input-wrapper 默认 width: 100%），
≤480px 时内边距收到 32px 24px。桌面 1440 浅 / 深色截图与修改前像素 0 差异；390px 下卡片 370px、
输入框 322px、无横向溢出，注册模式（三个输入框）同样。
 2026-09-22 08:27:12 +00:00
Noah e988af8268 chore(deps): 升级前端三方依赖至最新稳定版并适配 (#1710) 
* chore(deps): 升级 Next.js 14→16、React 18→19 及 TypeScript/ESLint/sass 工具链

- next 14.2 → 16.3.5(Turbopack 成为默认打包器,`output: 'export'` 与 out/ 页面文件名不变)
- react / react-dom 18.3 → 19.3,@types/react(-dom) 同步到 19.3
- qrcode.react 3 → 4、react-json-tree 0.19 → 0.20:仅为满足 React 19 的 peerDependency,API 用法不变
- typescript 5.9 → 6.0.3;tsconfig `target` es5 → ES2017(TS 6 弃用 es5,TS 7 已移除),
  `jsx` preserve → react-jsx(Next 16 强制),include 补 `.next/dev/types`
- next-env.d.ts 改为由 Next 生成、不再入库(官方文档要求,且 dev/build 会写入不同内容;
  仓库 .gitignore 已有 `/*.ts` 规则覆盖)
- eslint 8 → 9.39.5,eslint-config-next 16,eslint-config-prettier 10:
  Next 16 移除了 `next lint`,`.eslintrc.json` 迁移为 flat config `eslint.config.mjs`,
  `npm run lint` 改为直接调用 `eslint .`;eslint-plugin-react-hooks 7 新增的
  React Compiler 规则暂降为 warn(命中的都是既有写法,与本次升级无关)
- sass 1.97 → 1.104、@types/node 20 → 26(仅类型)
- next.config.js 关闭 Next 16.3 新增的 `agentRules`,避免 `next dev` 在仓库根目录生成 AGENTS.md

未升到最新的两项及原因:
- typescript 7.0.2 为原生实现、不再提供 JS API,eslint-config-next 依赖的 typescript-eslint
  明确拒绝 TS 7(`>=4.8.4 <6.1.0`),故停在 6.0.3
- eslint 10 移除了 `context.getFilename()`,eslint-config-next 依赖的 eslint-plugin-react 7.37.5
  尚未适配(peer `^9.7`),故停在 9.x 最后一版

* fix(ui): 适配 React 19 的类型变更

@types/react 19 带来的四类编译错误,逐个按最小改动处理,不涉及运行时逻辑:

- `useRef<T>()` 不再允许省略初始值 → `useRef<FormApi>(undefined)`(6 处,`.current` 类型不变)
- `useRef<HTMLDivElement>(null)` 现返回 `RefObject<HTMLDivElement | null>`,
  logviewer 的 `LogContent` props 类型同步放宽
- 全局 `JSX` 命名空间被移除 → `React.JSX.Element`(AvatarCard)
- `ReactElement` 的 props 默认类型由 `any` 改为 `unknown`,
  TemplateModal / OverrideModal 里 `cloneElement` 注入 onClick 的地方给 `isValidElement`
  标注具体的 props 形状,替代原来的 `<any>`
- 顺带删掉 layout.tsx 里一条已无作用的 `eslint-disable-next-line react-hooks/exhaustive-deps`
  (eslint-plugin-react-hooks 7 对该处不再报告,ESLint 会提示未使用的 disable 指令)

* chore(deps): 升级 Semi Design 2.89→2.103 及 swr/artplayer/mpegts.js,适配 ArrayField.add 新签名

- @douyinfe/semi-ui 2.89.1 → 2.103.0(semi-icons / semi-foundation 随之同步),同一 major,
  用到的 Form / Tabs / Collapse / Modal / Table / Select 等组件 API 未变
- ArrayField 的 `add` 由 `() => void` 变为 `(index?: number) => void`(支持在指定位置插入),
  原来直接写 `onClick={add}` 会把 MouseEvent 当 index 传入且不再通过类型检查,
  7 处改为 `onClick={() => add()}`,行为仍是追加到末尾
- swr 2.3.8 → 2.5.1、artplayer 5.3.0 → 5.4.0、mpegts.js 1.8.0 → 1.8.2:均为 minor/patch,无 API 变更

* chore(deps): 移除无引用的 ncp

`rg ncp` 在 app/、脚本与配置里均无命中(仅 CHANGELOG 提到 #1265 曾把它移出 dependencies),
是早年从 Svelte 前端遗留下来的复制工具,当前构建链(next build → out/ → rust-embed)用不到。

* fix(ui): 站内 Link 关闭预取,消除 Next 16 预取样式触发的 preload 警告

Next 16 的 Link 进入视口即预取目标路由的 RSC 载荷,载荷里的 `HL` 样式提示会让 React 为
目标页的每个 CSS 分块插入 `<link rel="preload" as="style">`;页面停留数秒后 Chrome 会对每个
未使用的预加载报一条 "was preloaded using link preload but not used" 警告。侧栏 9 个链接常驻
视口,配合 Turbopack 的细粒度 CSS 分块,每页会稳定出现 20+ 条(Next 14 下为 0)。

站内导航共 6 处 Link,全部加 `prefetch={false}`:静态导出由本机 axum 直接服务,点击时再拉取
几 KB 的路由载荷,实测 9 个侧栏页面客户端切换均正常且耗时 <150 ms;之后 6 秒停留 0 警告。

本 commit 可独立丢弃:丢弃后功能不受影响,只是控制台会有上述预加载警告。

* fix(ui): 在根布局最先导入 Semi Design 的 React 19 适配器

React 19 从 `react-dom` 上移除了 `render` / `unmountComponentAtNode`,也不再从 `react-dom`
re-export `createRoot`。Semi 的 Toast / Notification / Spin 图标等命令式渲染走
`_utils/reactRender.js`,在 React 19 下既拿不到 legacy render 也拿不到 createRoot,
会打印 "[Semi UI] createRoot is not available" 并**静默不渲染**——表现为保存成功 / 失败的
Toast 与 Notification 全部消失、日志页 Spin 不显示。

按 Semi 官方文档(semi.design/zh-CN/ecosystem/react19)在根布局第一行导入
`@douyinfe/semi-ui/react19-adapter`,它把 `react-dom/client` 的 createRoot 注入
`semiGlobal.config`。验证:空间配置页保存成功 / 校验失败的 Toast 正常弹出,
日志页 console 0 error。

* fix(ui): 消除 React 19 开发模式下的水合属性与 Fragment props 警告

开发模式(StrictMode)逐页走查 13 个页面,React 19 报两类新错误,均为既有写法在新版本下
被更严格地校验,生产构建不受影响:

- 每页一条 "A tree hydrated but some attributes of the server rendered HTML didn't match":
  差异只有 `<html>` / `<body>` 上由 <head> 内联脚本在水合前写入的 theme-mode 属性
  (React 18 下同一原因表现为 "Extra attributes from the server: theme-mode")。
  这是首屏防闪烁的有意行为,按 React 官方做法给这两个元素加 suppressHydrationWarning,
  只屏蔽元素自身的属性差异,不影响子树校验。
- 直播管理页每张卡片一条 "Invalid prop `disabled` supplied to React.Fragment":
  操作按钮以 Fragment 形式作为 Semi ButtonGroup 的唯一子元素,ButtonGroup 会对直接子元素
  cloneElement 注入 disabled / size / type,React 19 起会对 Fragment 上的这些 props 报错。
  改为返回带 key 的元素数组,DOM 结构与样式不变(子元素均非 Button 类型,不会插入分隔线)。

处理后开发模式 13 页 console 仅剩 mock 环境有意返回的 500。
 2026-09-22 06:42:07 +00:00
Noah 5ce14df240 feat(ui): 录制中房间显示封面、头像与实时码率（直播预览阶段一） (#1709) 
* feat(downloader): 录制写盘字节计数与实时速率，/v1/streamers 新增 live_bytes_per_sec

各下载器在写出点往 `ByteCounter`（Arc<AtomicU64>）累加，写盘路径上只多一次
`fetch_add`，不加锁、不 await、不改任何控制流：

- stream-gears/httpflv：`FlvFile::write_tag` 按 11 + 数据 + 4 字节计
- stream-gears/hls：`download_to_file` 每个 chunk 落盘后计
- mesio：条目进入修复管线前按 `FlvData::size()` / `HlsData::size()` 计
  （writer 来自外部 crate，拿不到逐条写出量；修复只增删极少量 tag）
- ffmpeg / streamlink：子进程自己落盘，改为每秒读一次 `.part` 长度做差分

`DownloadTask` 持有 `RateMeter`：1 秒采样、10 秒滑动窗口取首尾差值。窗口明显长于
GOP，避免 httpflv 按关键帧批量落盘造成的抖动；采样任务随 `execute` 启停。

`GET /v1/streamers` 每项新增 `live_bytes_per_sec`（字节/秒）：未录制、采样不足、
或下载器不经本进程写盘（边录边传、yt-dlp）时为 null。

Part of #1708

* feat(live): 解析主播头像、补斗鱼封面，新增录制中封面/头像的同源代理端点

`LiveStream` 新增 `avatar_url: Option<String>`：
- B 站：`getInfoByRoom` 同一次响应里的 `anchor_info.base_info.face`
- 抖音：房间对象 `owner.avatar_thumb.url_list[0]`（web / H5 两个接口都有）
- 斗鱼：betard 的 `owner_avatar`，缺失时退回 `avatar.{middle,big,small}`；
  封面 `room_pic` 一并补上（此前写死空串）
- 虎牙：`gameLiveInfo` / `liveData` 的 `avatar180`，与 screenshot 一样升到 https
- 其余平台为 None，不改行为

`DownloadTask` 在内存里保存当前录制的封面与头像地址（每次 check_stream 刷新，
随任务消亡，不落库、不加迁移）。`GET /v1/streamers` 每项新增 `live_cover_url` /
`live_avatar_url`（未录制为 null）。

新增 `GET /v1/streamers/{id}/cover` 与 `/avatar`：页面直接引用图片 CDN 会带上 biliup
的 Referer 被 B 站等拒绝（403），改由服务端以直播间页面地址作 Referer 拉取后转发，
按图片 URL 做 5 分钟内存缓存（上限 64 条、单图 4MB）。只按主播 id 取 worker 里已有的
地址，不接受任意 URL；上游不是图片时不转发。路由注册在 `router()` 内，`--auth` 时
与其它 /v1 接口同一道登录校验。

Part of #1708

* feat(ui): 录制中卡片显示直播间封面、主播头像与实时写盘速率

`StreamerCard`（主页「进行中」与直播管理网格共用）在状态为录制中时：
- 顶部加 16:9 封面缩略图，懒加载，图片走 `/v1/streamers/{id}/cover` 同源代理；
  加载中显示占位底色，加载失败整块消失，卡片回到原有样式
- 名称前加 22px 头像圆图（`/v1/streamers/{id}/avatar`），失败则不占位
- 时长右侧加写盘速率，按 B/s、KB/s、MB/s 自动换单位；后端未采样（null）显示「—」

图片地址带原始 URL 的短哈希作查询参数，换一场直播封面变了就不会沿用旧缓存。
未开播 / 暂停的卡片不变。直播管理列表视图新增「码率」列，主播名前带头像。

不引入新依赖：头像与封面用 next/image（项目已配置 unoptimized），速率格式化与
代理地址拼接放在 `use-dashboard.ts`。

Part of #1708

* perf(live): B 站封面/头像经代理时改取 CDN 缩略图

实测 B 站 `user_cover` 原图可达 11520×8640、4 MB，卡片上只显示成 16:9 缩略图和 22px
头像，原样转发既慢又占缓存。对 `*.hdslb.com` 的地址借 CDN 的 `@宽w_高h_1c` 后缀取
640×360 / 128×128 的裁切图（同一张图从 4 MB 降到约 25 KB）；已带后缀或带 query 的
地址、以及其它平台的地址原样使用。

Part of #1708

* refactor(downloader): ffmpeg / streamlink 写盘速率改为解析 stderr 进度行，不再读盘

review 意见：每秒 stat 一次 `.part` 长度会额外占磁盘 IO。改为让子进程自己报告：

- ffmpeg 加 `-progress pipe:2 -nostats`，把 key=value 进度块打到 stderr（不受
  `-loglevel quiet` 影响），`total_size=N` 就是本进程累计写出字节
- streamlink 加 `--progress force`，stderr 不是终端时也按周期打
  `[download] Written 12.34 MiB to <file> (5s @ 2.50 MiB/s)`

都在既有的 `spawn_log` stderr 读取协程里顺带解析（`SubprocessProgress`），进度行降为
debug 日志不再刷 info；累计值只加增量、回退时重置基准。解析不出来只是没有速率，
不影响录制。删掉 `FileSizeProbe`。

Part of #1708

* feat(live): 主播头像开播时下载一次存到 data/avatar/，接口直接读本地文件

review 意见：头像几乎不变，不必每次经代理拉取。

- 新增 `common/live_image.rs`：图片抓取（带 Referer、大小与类型校验、B 站缩略图后缀）
  从 `api/live_media.rs` 挪到这里共用；新增 `AvatarStore`，按主播 id 存
  `data/avatar/<id>.<ext>` + `<id>.json`（记录来源地址与 Content-Type），先写临时文件
  再改名，同一时刻只允许一个下载写盘
- 开播进入录制流程时后台下载一次；后续 check_stream 拿到的地址变了才重新下载；
  下载失败保留旧文件、只记日志
- `GET /v1/streamers/{id}/avatar` 改为读本地文件（`Cache-Control: max-age=3600`）；
  正在录制而本地还没有时现场下载一次再返回，失败退回旧文件；不在录制时只读本地，
  没有就 404。服务重启后凭 `<id>.json` 直接复用，不重复下载
- 封面仍走内存缓存的代理（每场直播都会换，落盘意义不大）

Part of #1708

* fix(downloader): streamlink 进度行打在 stdout，stdout / stderr 都解析

实测 `--output` 到文件时 streamlink 把控制台输出（含 `[download] Written …`）
打在 stdout 而不是 stderr，只解析 stderr 会得到恒为 0 的速率。两条流共用一个
进度跟踪器，避免重复累加。

Part of #1708
 2026-09-22 06:34:11 +00:00
Noah 45ab54ba90 fix(ui): 修复新 UI 侧栏被顶出与平台设置页导航重复 (#1706) 
* fix(ui): 去掉 html/body 的 overflow-x: hidden，恢复侧栏与页头吸顶

#1704 引入的 bg-global.css 给 html、body 加了 overflow-x: hidden，任何非 visible
的 overflow 都会把 body 变成滚动容器，侧栏（layout.module.scss .sider）和
PageHeader 的 position: sticky 于是相对 body 而不是视口定位——主内容一长，
整页滚动就把左侧导航和「保存」按钮一起顶出视口。

- 删除 html/body 的 overflow-x: hidden，并在两处样式注明这条约束
- 两个 position: fixed 的背景层改用 inset: 0 铺满视口，不再依赖 100vw，
  也不会撑出横向滚动条

问题 1 of #1705（侧边导航被顶出）。

* fix(ui): 空间配置「平台设置」只保留左侧平台列表一套导航

#1704 把平台设置改成「左列平台列表 + 右栏 Collapse」后，右栏的手风琴仍然
为每个平台渲染一条带平台名的折叠栏，与左列重复（#1705 第二点）。

- 新增 app/ui/plugins/PlatformPanel.tsx：各平台插件的外壳，传入 bare 时只
  输出字段，否则保持原来的 Collapse.Panel（配置覆写弹窗仍在用）
- 10 个平台插件把 Collapse.Panel 换成 PlatformPanel，并透传 bare
- dashboard 右栏不再用 Collapse，改为每个平台一个 <section hidden>：所有
  字段始终挂载，只切换 hidden，保证 PUT /v1/configuration 整表覆盖时其他
  平台的参数与凭据不会因为字段卸载而丢失
- 左列平台列表在页头下方吸顶（position: sticky），右栏面板很长时列表不再
  随内容滚出视口；PageHeader 把自身高度写入 --page-header-height 供其取用；
  Tabs 关闭 tabPaneMotion 并放开 .semi-tabs-pane 的 overflow，否则 pane 会
  成为 sticky 的滚动容器。移动端横排 chip 行保持随内容滚动
- 左列按钮补 aria-pressed，nav 补 aria-label

Fixes #1705

* feat(ui): 空间配置保存校验失败时自动定位到第一个出错字段

平台设置的字段全部挂载、只切换 hidden，未选中的 Tab / 平台面板里的校验
错误用户看不到，表现为点「保存」没有任何反应。

- Form 加 onSubmitFail：把 Semi 的嵌套 errors 拍平成字段路径，按 DOM 顺序
  找到第一个出错字段，切到它所在的 Tab（Tabs 改为受控）与平台面板，再
  scrollIntoView 并聚焦，同时 Toast 提示未通过的项数
- TabPane 内容加 data-tab、平台 section 加 data-platform，供定位使用；
  不改插件接口

Refs #1705

* refactor(ui): 改用应用壳布局解决侧栏被顶出，移除 sticky 补救与 tabPaneMotion 取舍

按 review 意见（#1706）不再靠 position: sticky 解决问题一，改成简单的应用壳：

- layout.module.scss：.app 改为 height: 100vh（100dvh）+ overflow: hidden 的 flex 容器，
  页面本身不滚动；.sider 是固定宽度的普通子元素（撑满壳高，去掉 sticky/top/100vh）；
  .main 加 min-height: 0 + overflow: auto，成为唯一的滚动容器。侧栏、页脚服务灯
  自然留在视口内，PageHeader 原有的 position: sticky 相对 .main 吸顶，无需改动
- 去掉为让平台列表在 Tab 面板内 sticky 而加的补救：.platformNav 的 sticky /
  --page-header-height / max-height、PageHeader 的 ResizeObserver、Tabs 的
  tabPaneMotion={false} 以及 .semi-tabs-pane 的 overflow 覆盖，Tab 切换动画恢复。
  平台列表改回随内容滚动
- bg-global.css：文档不再滚动，html/body 不需要 overflow 规则，注释改为说明现状；
  两个 fixed 背景层保持 inset: 0

验证：tsc 0 错误、next build 通过；13 页 × 浅色 / 深色 / 折叠 / 移动端 390 / 平板 760，
主区滚到底后 document.scrollHeight == innerHeight（文档不滚）、aside top 0、页脚
bottom == innerHeight、header top 0、main 无横向溢出；Semi Select 下拉（主区预滚 1.2k px
及打开后继续滚动）、Popconfirm、配置覆写 Modal 及其内部 Select、Toast 位置全部正确；
切遍 10 个平台后保存 PUT 73/73 键（3 次）；校验失败自动定位三场景通过（2 轮）。

Refs #1705

* refactor(ui): 平台设置去掉外层嵌套卡片，改两栏独立滚动布局

按 review 第二条意见（#1706）：平台列表不用 sticky，也不随内容滚走——去掉包在
「平台列表 + 面板」外面的嵌套卡片，让两栏并排、各自独立滚动。

- dashboard/page.tsx：删掉 dc.content / rootConfigPanel / main / content 四层包裹和
  平台设置里的 framePlatformConfig 卡片与重复的「平台设置」标题；页面主体改为
  .page（占满页头以下的剩余高度）→ Form → Tabs，每个 Tab 面板在自己内部滚动，
  页面本身不滚，页头「保存」始终可见。去掉底部两个 Space 占位
- dashboard.module.scss：重写。删除 #1704 之前遗留的整段 .rootConfigPanel 嵌套规则
  （其中 frameInside / group / lineStory 等类早已无人引用）；Form / Tabs /
  semi-tabs-content / semi-tabs-pane（含开启动画时的 motion-overlay）改为
  flex: 1 + min-height: 0 的列容器，把高度让给当前面板，并补回
  .semi-tabs-pane-inactive 的 display: none（本模块选择器特异性更高）
- 平台设置：.platformLayout 两栏，.platformNav 160px、align-self: flex-start、
  max-height: 100% + overflow-y: auto（矮视口时列表自己滚），.platformBody
  flex: 1 + overflow-y: auto。右栏再长列表也不动
- 全局设置 / 开发者选项一致处理：frameDownload / frameUpload / frameDeveloper 不再是
  带边框和 50px 内边距的卡片，改为分区标题 + 分隔线的普通分区，面板 .pane 自身滚动
- 移动端（≤680px）：两栏改为上下堆叠，平台列表是横向滑动的标签行，固定在面板顶部
  不随字段滚走
- 自定义背景开启时给两个滚动面板垫一层 75% 的 bg-1 半透明底色，保证文字可读

验证：tsc 0 错误、next build 通过；空间配置页在 1440 / 760 / 390 × 浅 / 深 / 折叠 /
520px 矮视口下：文档与 <main> 均不滚动，页头与「保存」始终在视口内，右栏滚到底
（哔哩哔哩面板 1223px）时平台列表位置不变，矮视口下列表自身可滚；全局设置面板独立
滚动；切遍 10 个平台后保存 PUT 73/73 键（4 次）；校验失败自动定位三场景通过（3 轮，
scrollIntoView 在嵌套滚动容器内正常）；Select 下拉在面板预滚 1k px 及滚动中跟随触发器，
Popconfirm / Modal / Toast 位置正确；其余 12 页布局探针与上一提交一致。

Refs #1705

* fix(ui): 更新日志页内容不再覆盖导航顶栏

应用壳布局下页头真正吸顶后暴露出来的问题（review 第三条，#1706）：更新日志页把
PageHeader 又包在一层 position: sticky; z-index: 1 的 Semi Layout.Header 里，
形成一个层级只有 1 的 stacking context，PageHeader 自己的 z-index: 10 只在这层
内部生效；而版本卡片流 .feed 又设了 position: relative; z-index: 1，DOM 顺序在
后，滚动时就画在页头之上。

- changelog/page.tsx：去掉外层 Header，与其它页一样直接渲染 PageHeader
- changelog.module.scss：删掉 .feed / .center 的 position: relative; z-index: 1

验证：10 个带页头的页面滚到底后对页头内 6 个点做 elementFromPoint 命中测试，
全部命中页头自身（修前 /changelog 有 4 个点命中版本卡片头）；/history 播放器
Modal 居中且在最上层；/logviewer、/status 等无层叠。

Refs #1705
 2026-09-22 04:20:48 +00:00
NoahandAluneu f06efbb3b9 feat(ui): 前端整体重设计与统一（接手 #1653） (#1704) 
* feat(ui): 前端整体重设计与统一（接手 #1653）

来自 Aluneu 的 PR #1653（head bdcfbea），在 master 4e156ac 上重新落地。
相对原 PR 的差异：
- 剔除 logo / favicon / logo.svg 品牌资产变更，侧栏与登录页仍用 public/logo.png
- 解决与 master 的三处冲突：upload-manager add/edit 的 studioEntity 补回 #1699 的 tid_v2；
  global.tsx 下载插件说明补上 mesio（9d02856）
- README.md 相关提交在原 PR 合并上游时已归零，此处不含

主要内容：
- PageHeader / SectionTitle / data-card 统一页头与卡片容器，status.tsx 作为状态视觉的唯一来源
- 侧栏自绘重写：5 组 9 项、服务状态指示、折叠偏好持久化、移动端抽屉
- 首页从外链 iframe 改为本地数据的控制台（KPI / 进行中 / 未开播 / 24h 事件流）
- 直播管理：搜索、平台筛选、网格/列表双视图、批量暂停/删除；接口失败不再被当作空列表
- 新增 /changelog 页，运行时拉取官方 CHANGELOG，带 localStorage 离线缓存
- 全局自定义背景：仅本地图片，canvas 重绘为 JPEG data URL，2MB 上限
- 修复：根 layout 与 (app)/layout 双重 <html>/<body>、主题水合闪烁、扫码登录无保护取值崩溃、
  弹窗内 width:1000 横向溢出、移动端抽屉被遮罩拦截
- 后处理 {cmd,value} ↔ HookStep 转换抽成 lib/postprocessor.ts
- 12 个平台插件文案精简

* fix(ui): 空间配置平台列表改为遍历插件注册表

dashboard 里硬编码的 PLATFORM_LIST 让新增平台插件要改第三个地方，漏了就在 UI 里静默消失。
把顺序与文案登记到 app/ui/plugins/index.ts 的 PlatformPanels，dashboard 只负责渲染。

* fix(ui): 控制台断连判定改为全部接口失败才触发，并放宽轮询频率

- /v1/status 单独失败时原先把整个控制台替换成「无法连接后端」，主播卡片全部消失；
  现在只有四个接口全部失败才判定断连，单个接口失败只显示对应提示条
- 主播状态 4s → 10s；streamer-info（全表）、videos（扫目录）、status（序列化整份配置）
  30s → 60s；侧栏与直播管理页共用同一组常量
- 事件流的平台名复用 status.tsx 的 platformName，删掉 use-dashboard 里的重复实现
- 首页「文档」链接对齐 README 里的 biliup.github.io 地址

* fix(ui): 直播状态文案与配色在卡片和列表视图保持一致

- 列表视图的「未开播」原是红底白字，与卡片的灰色徽章不一致；改为同一套三色
- 补回 Pending →「检测中」（原页面就有，重设计后被吞成「未开播」）
- OutOfSchedule 不再归到绿色录制组，绿色只留给 Working
- 删除无人引用的 statusMeta / platformTag

* fix(ui): 编辑投稿模板页在分区列表加载失败时给出原因而不是空白

/bili/archive/pre 需要可用的 B 站 cookie，没有账号时后端返回 500；原先 isError 为真但
error 为 undefined，页面渲染成一个空 div。现在保留页头并显示服务端返回的 message。

* fix(ui): 更新日志页不再把过时的最后一条标成「最新」

仓库里的 CHANGELOG.md 停在 1.2.1，而运行版本已是 1.2.5。页面现在读取 /v1/status 的版本号：
运行版本比日志最新一条还新时去掉「最新」标签并在顶部如实说明；日志里有当前版本时标「当前运行」。

* chore(ui): 清理重设计遗留的重复代码与死代码

- 直播管理页网格 / 列表两份完全相同的操作按钮合并为一处
- 去掉源码里面向评审工具的注释（「相对 PR 版本的增强」「保留 PR 逻辑」等）
- useGlobalBackground 删除 URL 模式残留的 validateBg / isRemoteUrl，遮罩透明度钳制与滑块范围对齐（0.05–0.8）
- 删除无人引用的 (app)/page.module.css 与 BiliupStatus 类型
- 移除 react-use（useWindowSize 已由 useIsMobile 替代，代码里已无引用）

* fix(ui): 全局设置里 sync_save_dir 输入框随下载插件下拉框即时显示

原先用 useFormApi().getValue() 做条件渲染，useFormApi 不订阅表单值变化，
选了 sync-downloader 之后输入框要先保存再刷新才出现。改用 useFormState 订阅 values。

* chore(ui): 删除原 PR 已移除的两个无人引用样式文件

app/page.module.css 与 app/styles/Home.module.css 是脚手架遗留，#1653 已删除；
接手时从合并树导入文件没有带上删除，这里补齐。

* fix(ui): 按 review 意见重审设置页文案，优先清晰无歧义

回应 #1704 的 review：设置页文案不再追求字数少，改为直观、清晰、无歧义。
逐条对照 master 原文与 Rust 实现重写，凡是精简后丢失默认值、单位、取值格式、
生效条件、依赖关系或风险提示的条目一律补回，用换行分点、加粗标出风险项。

- 12 个平台面板 + 全局「下载插件」说明：恢复多行结构，补回默认值 / 单位 / 格式 /
  生效条件（如 douyin_true_origin 需画质为原画且协议为 flv、twitch_disable_ads /
  twitch_cookie 仅 streamlink / ffmpeg 生效、youtube_cookie 填的是文件路径、
  日期格式 YYYYMMDD、大小格式 100M/5G、编码多选用 | 分隔）
- 与实现对齐并修正原文：bilibili 弹幕不再限定非 stream-gears、且随录像分段；
  bili_cookie 与 bili_cookie_file 同时填写时以文本为准；youtube_prefer_vcodec /
  acodec 是编码而非封装格式；streamlink 现可直接下载 FLV 直链；
  youtube_enable_download_playback「只想录直播的可以开启」笔误改为「关闭」；
  bili_qn 占位符改为 25000（原画），与实现默认值一致
- 空间配置页头描述改为准确描述三个 Tab 并提示需点「保存」
- 链接颜色改用 var(--semi-color-link)（原 rgb(var(...)) 为无效 CSS）

不涉及任何逻辑改动。

---------

Co-authored-by: Aluneu <19215190873@163.com>
 2026-09-21 13:46:15 +00:00
ForgQi 9d02856a50 Integrate mesio (rust-srec) downloader 
Add an in-process mesio downloader using the rust-srec mesio-engine. Introduces crates/biliup-cli/src/server/core/downloader/mesio.rs implementing FLV/HLS pull, timestamp fixes, keyframe indexing, and size/duration-based segmentation with pipeline_common, flv_fix and hls_fix. Wire Mesio into downloader enum/runtime and add UI options and public config docs. Update crates/biliup-cli/Cargo.toml and workspace Cargo.toml/Cargo.lock to include new dependencies and bump version to 1.2.5. Include tests for protocol selection, pipeline behavior and an e2e FLV download. Small helper changes: config enum docs and segment handling.
 2026-09-21 00:24:52 +08:00
Noah 970dfe8b37 feat(upload): support first-class tid_v2 partition id (#1699) 
Add optional tid_v2 across Studio, config/DB, CLI, Web UI, stream-gears,
and Python uploaders so new Bilibili partition IDs can be set alongside
legacy tid. Fixes #1662; related to #1562.
 2026-09-14 16:19:53 +00:00
Noah 40234133e3 fix(webui): 保存配置覆写时保留投稿模板关联 (#1685) 
覆写弹窗的 entity 白名单漏了 upload_streamers_id，PUT 整行覆盖后外键变 NULL，后续录像不再投稿并走默认 rm。
 2026-09-13 15:40:03 +00:00
Mostly_Harmless b438d72415 feat(web): 完善账号管理、稿件查询与安全边界 (#1660) 
启动 Web 服务时自动登记 CLI 指定的 B 站凭据，并为账号登记、刷新和删除统一补上并发去重、原子写入及引用检查。

同时收紧默认监听、管理员初始化、认证路由、静态文件和日志 WebSocket，恢复 server 的 ds_update.log，并避免凭据及上游响应进入日志。

新增按账号查询远程稿件的 API 与 Web 页面，补齐严格分页和响应校验。

关联 biliup/biliup#1624

关联 biliup/biliup#1658

关联 biliup/biliup#724
 2026-08-16 14:05:20 +00:00
dreammu 3e8b55c2c4 fix(upload): update upload lines (#1656) 2026-08-07 09:28:12 +00:00
XuanRan_Nyan 08b96b73f8 feat(douyu): build huos url for forced hs (#1644) 2026-06-26 11:59:42 +00:00
ForgQi 431d1f61ab Support optional segment limits and danmaku files 
Make file_size and segment_time optional and normalize/validate their values so segmentation can be disabled. Frontend: send nulls for empty fields and allow empty segment_time via validation; add showClear to inputs. Downloader: extend SegmentInfo with optional danmaku_file_path and propagate it from various downloaders; DanmakuClient::rolling now returns a bool to signal whether a danmaku file was produced. Uploader: add segment_paths helper to include danmaku files in upload/postprocessing, and preserve processed paths; add unit tests. HookStep: stream child process stdout/stderr as raw bytes to terminal and append to a log file (tee), and simplify run/move logic to use explicit path lists. Cargo.toml: bump reqwest to 0.13.4. Tests and minor adjustments added throughout to support these changes.
 2026-06-04 01:19:27 +08:00
XuanRan_Nyan caf106c3f8 Fix(Huya): refactor anticode generation using getCdnTokenInfoEx API (#1575) 
* Fix(Huya): refactor anticode generation using getCdnTokenInfoEx API

* chore: cleanup

* chore: get random sHuYaUA

* chore: 代码复用
 2025-12-21 13:03:52 +00:00
ForgQi c172efb6cd Add dynamic log level configuration support 
Introduces a new `loggers_level` field in the server config to allow dynamic adjustment of log levels via the API and UI. Updates the developer UI to reflect the new log level controls and ensures the backend applies changes to the logging filter at runtime. Also bumps the version to 1.1.27.
 2025-12-01 02:18:20 +08:00
ForgQi 55370dd87a Add dynamic log level reload support to server 
Introduces tracing_subscriber::reload to enable dynamic log level changes at runtime. Updates the main server initialization and ServiceRegister to accept and store a log handle. Refactors related code to support this feature and removes disabled state from developer UI log level selectors.
 2025-11-27 03:41:09 +08:00
ForgQi a0b6800c0a Refactor async worker status and improve file move logic 
Refactored worker status management to use async RwLock and updated all related methods to be async. Improved file move logic in hook steps to support cross-filesystem moves by falling back to copy+delete when necessary. Updated API endpoints, download/upload logic, and monitor state transitions to be fully async and more robust. Also added a Debug implementation for Credentials to avoid logging sensitive data, and made minor UI tweaks to disable certain developer options.
 2025-10-22 02:13:37 +08:00
ForgQi 92b5a30df5 Add streamer pause/resume feature and UI updates 
Introduces a pause/resume button for streamers in the UI and backend, including API endpoint and status handling. Refactors streamer status display, updates related TypeScript interfaces, and improves modal forms. Also updates @douyinfe/semi-ui and related dependencies to v2.86.0, and bumps workspace version to 1.1.10. Minor logging and trait changes in Rust backend for improved clarity and error handling.
 2025-09-29 03:18:21 +08:00
ForgQi a5faefb533 Add QR code login and user management endpoints 
Introduces endpoints for QR code-based login and user management in the stream-gears server. Adds support for creating, deleting, and listing users, as well as endpoints for QR code generation and login via QR code. Refactors configuration management to use a global LazyLock, updates model serialization for streamer hooks, and improves context and service registration to support stateless clients. Also updates the frontend to handle new user and QR code flows, and adds an image resource for donation display in the README.
 2025-09-20 21:43:51 +08:00
ForgQi 3744c0f14c Refactor to remove legacy Python backend and database 
Removed legacy Python backend modules, database models, and related utilities from the biliup package. Migrated configuration and main loop handling to use stream_gears bindings, simplifying the codebase and shifting backend responsibilities to the Rust implementation. Updated the login page to support registration and login via the new API, and adjusted frontend API base export.

Update Cargo.toml

Update Cargo.lock
 2025-09-19 03:28:17 +08:00
XiaoMiku01 244e03c38a fix: 修复遗漏的接口鉴权 (#1417) 2025-08-11 15:41:06 +00:00
xiaoyu eaca64aa3a 修改充电参数open_elec为charging_pay (#1410) 2025-08-08 05:08:04 +00:00
XuanRan_Nyan e1171c6dc7 fix(blive): parse error (#1405) 2025-08-07 06:36:31 +00:00
XuanRan_Nyan dba7780c3d feat(biliup-rs): 新增 BCut Android 投稿接口 (#1402) 
* remove: blive hack feature

* feat(stream-gears): 支持直播流下载的多条件分割

* 新增 BCut Android 投稿接口

* chore: 优化实现方法

* chore: 完成 Python 实例

* chore: 完善测试用例

* chore: 复用代码

* cleanup
 2025-08-07 03:40:33 +00:00
XuanRan_Nyan 526767257d remove: blive hack feature (#1394) 2025-08-04 14:22:47 +00:00
XuanRan_Nyan 8293b6cd91 feat(Huya): 支持 Huya Wup 协议以获取正确直播流 (#1385) 
* feat(Huya): 支持 Huya Wup 协议以获取正确直播流

* chore: 补充 webui 内容
 2025-08-02 08:59:19 +00:00
某摆烂咸鱼 bd69b76124 feat: 新增上传重试次数限制和上传结果webhook通知 (#1355) 
* feat: 新增重试上传次数限制

* feat: 新增上传后WebHook设置选项

* feat: 新增上传webhook逻辑

* mod: 将功能配置移至直播配置中的更多设置

* mod: 修改webhook传输的信息

* mod: 修正错误的数据类型

Refactor webhook upload logic and update build configs

Replaces the 'uploaded_webhook' field with a 'webhook' postprocessor in the upload workflow, updating both backend and frontend to support this change. Updates the Tauri app to use the correct resource path for the sidecar binary, adjusts process management, and modifies build and workflow scripts for improved compatibility. Also bumps the 'stream-gears' crate version to 1.0.1 and adds '_internal' to .gitignore.

Update pyinstaller-publish.yml

Fix pyinstaller copy metadata (#1357)

* Update tauri.conf.json

* Update biliup.spec

Update pyinstaller-publish.yml

feat: 新增上传重试次数限制和上传结果webhook通知 (#1355)

* feat: 新增重试上传次数限制

* feat: 新增上传后WebHook设置选项

* feat: 新增上传webhook逻辑

* mod: 将功能配置移至直播配置中的更多设置

* mod: 修改webhook传输的信息

* mod: 修正错误的数据类型

Refactor webhook upload logic and update build configs

Replaces the 'uploaded_webhook' field with a 'webhook' postprocessor in the upload workflow, updating both backend and frontend to support this change. Updates the Tauri app to use the correct resource path for the sidecar binary, adjusts process management, and modifies build and workflow scripts for improved compatibility. Also bumps the 'stream-gears' crate version to 1.0.1 and adds '_internal' to .gitignore.
 2025-07-22 02:02:23 +08:00
XuanRan_NyanandForgQi 45839c7e88 fix(Plugins.Huya): Update HuYaUA (#1291) 
* fix(Plugins.Huya): HuYaUA

* add options to disable wup headers

* cleanup

* Update __init__.py

---------

Co-authored-by: ForgQi <34411314+ForgQi@users.noreply.github.com>
 2025-05-12 03:58:19 +00:00
⁢4.435km/sandForgQi b61ff5ed08 feat: 适配TwitCasting,TwitCasting添加Cookie,TwitCasting添加画质选择 (#1282) 
* feat: 适配TwitCasting,TwitCasting添加Cookie,TwitCasting添加画质选择

* Update __init__.py

---------

Co-authored-by: ForgQi <34411314+ForgQi@users.noreply.github.com>
 2025-05-06 03:22:19 +00:00
Gweesin ChanForgQiXuanRan_Nyan
 		bec4f72cc6 feat: 移动端响应式增强 (#1266) 
* feat: 弹出层支持响应式宽度

* feat: 优化折叠效果

* feat: 优化移动端折叠体验

* fix: ssr 编译报错

* fix: 修复 PC 切移动端时不会自动折叠的问题

* feat: 支持仅自己可见开关 (#1261)

* feat: 支持仅自己可见开关

* fix: 私密视频投稿失败

* chore: 移除迁移脚本

* fix: 修复 is_only_self 覆盖界面原先额外字段配置问题

* fix: ncp and sass should not production dependencies (#1265)

* feat: 抖音真原画 (#1267)

* feat: 抖音真原画

* add webui option

* Update __init__.py

---------

Co-authored-by: ForgQi <34411314+ForgQi@users.noreply.github.com>

* feat: 优化移动端折叠体验

* chore: rebase master，重新提交 lock

---------

Co-authored-by: XuanRan_Nyan <31968665+xxxxuanran@users.noreply.github.com>
Co-authored-by: ForgQi <34411314+ForgQi@users.noreply.github.com>
 2025-04-29 02:03:19 +00:00
XuanRan_NyanandForgQi ce66a29bfe feat: 抖音真原画 (#1267) 
* feat: 抖音真原画

* add webui option

* Update __init__.py

---------

Co-authored-by: ForgQi <34411314+ForgQi@users.noreply.github.com>
 2025-04-27 02:01:11 +00:00
Gweesin Chan 3a15f5519a feat: 支持仅自己可见开关 (#1261) 
* feat: 支持仅自己可见开关

* fix: 私密视频投稿失败

* chore: 移除迁移脚本

* fix: 修复 is_only_self 覆盖界面原先额外字段配置问题
 2025-04-27 01:57:01 +00:00
Guthrie 4cf8de648c webui: 录制时间范围改用TimePicker，选择时间 (#1211) 
* 录制时间范围前端改为选择

* 配置文件注释

* fixx

* bug fix

* Update TemplateModal.tsx

* 修改css
 2025-04-02 09:37:10 +00:00
Guthrie 518e74f496 feature: 关键词不录播 (#1200) 2025-03-31 02:59:11 +00:00
某摆烂咸鱼andxxxxuanran 257453a70b feat: 支持B站完整弹幕录制 (#1186) 
* feat: 支持B站完整弹幕录制

* feat: 原始弹幕json编码时不编码中文

* mod: 每五分钟保存一次弹幕文件，减少磁盘IO

* feat: 默认场景10秒保存一次弹幕，原始弹幕5分钟一次

* mod: 修改录制原始弹幕参数名称

* mod: 更新示例配置文件

* refactor(Danmaku): 提升代码可读性

---------

Co-authored-by: xxxxuanran <xxxxuanran@gmail.com>
 2025-03-31 02:48:27 +00:00
XiaoMiku01andCopilot eb6b35c93f Fix 修复一些问题 (#1207) 
* fix

* 修复虎牙拉流失败异常

* 添加边录边传下载器日志记录

* 修复边录边传投稿标题概率异常

* Update biliup/plugins/huya.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* 添加边录边传的说明链接

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
 2025-03-30 11:13:55 +00:00
XuanRan_Nyan 3070a4011b 相似备注检查跳过自身；格式化用户模板提交之数据 (#1157) 
* 相似备注检查跳过自身；格式化用户模板提交之数据

* fix

* 更新配置文件模板
 2025-02-07 12:59:42 +00:00
XuanRan_Nyan 9404dc4a5c feat: Add override configuration support for streamers (#1151) 
* feat: Add override configuration support for streamers

* refactor: Simplify plugin imports and platform matching

* refactor: 支持插件配置覆写

* refactor: 更新 User 块覆写

* fix: type error
 2025-02-06 12:07:40 +00:00
XuanRan_Nyan 2ad84afa98 feat: Add Kilakila streaming platform support (#1148) 
* feat: Add Kilakila streaming platform support

Integrated Kilakila plugin into the dashboard streaming platforms section

* Improve Kilakila plugin URL support

Add support for additional Kilakila and Hongdoufm domain URLs, and implement URL path validation to prevent unsupported stream types

* 补充信息
 2025-02-03 11:21:33 +00:00
XiaoMiku01andxxxxuanran 94b404c57e Dev 适配 biliup/biliup-rs#186 测试边录边上传功能 (#1140) 
* fix

* 适配 biliup/biliup-rs#186  extra_fields

* dev 边录边上传功能初版

* 修复下载器错误

* 实现同步编辑投稿功能

* 上传模板标题格式化

* fix

* 默认分p大小2G

* 重写了对列

* 修改输出队列机制

* 多线程上传有bug

* 修复异常阻塞和多线程上传bug

* reset

* fix

* 修复线程池异常

* 添加额外字段支持；增加同步下载器选项；去除无用日志；修复B站FLV流小概率无法获取；去掉B站弹幕重复登录态验证。

* 删除补0测戳

* 调整 ffmpeg header 参数位置

* 添加同步保存到本地的配置项 和 运行分段后自定义命令

* 添加缺失的投稿参数

* 添加边录边传保存目录项

* 格式化

* 修正 webup_sync 上传线路选择

* 修复 webup_sync 的 submit_web

* 修正参数错误

* 删除多余代码

* 删除多余代码

---------

Co-authored-by: xxxxuanran <xxxxuanran@gmail.com>
 2025-02-03 11:03:44 +00:00
Monine Melolaris 694d05fac0 Style(webui): 执行前端代码格式化 (#1141) 
仅按照配置文件格式化，未进行任何逻辑更改。
 2025-01-14 06:35:54 +00:00
某摆烂咸鱼andunknown-o ef24502d17 feat: B站弹幕录制优化 (#1120) 
* feat: B站弹幕服务支持传入cookie

* feat: 哔哩哔哩录制弹幕时传入cookie

* feat: 新增针对于B站的上舰、SC、礼物记录

* feat: 支持开关B站完整弹幕录制

* fix: 条件判断错误

* fix: 当尝试使用cookie录制B站失败时自动fallback

* fix: 修正舰长无法录制的问题

* mod: 按照原逻辑写入弹幕

* mod: 修改B站详细弹幕录制开关名称

* fix: B站详细弹幕录制条件错误

* fix: 修正舰长、SC信息没有记录用户名

---------

Co-authored-by: unknown-o <yushen@mr-wu.top>
 2025-01-03 12:03:37 +00:00
XuanRan_Nyan dfdd92ae60 fix: dtime (#1121) 
* fix dtime

* change npm mirror

* 发布时间离当前时间必须≥4小时且≤15天

* 使用 artplayer 替换 西瓜播放器

* 自动切换播放器

* 控件修改为 ScrollList

* 移除 西瓜播放器
 2024-12-31 16:45:21 +00:00