-
参考图列表/详情缩略图之前直接用原图（1-2MB/张），新增 GET /thumbs/{filename} 惰性生成 320px 长边的 JPEG 缩略图并落盘缓存，实测压缩到原图的0.6%；只重写本机 /assets/ 的展示用URL，job req 里喂给生成模型的原始URL不受影响。 DELETE /v1/videos/{id} 和 batch-delete 顺带改成先真正取消底层任务释放算力， 再移入回收站，避免"删了但其实还在跑"。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KJEL5jqdZR1QPToULRaTAz -
排查用户反馈的"每次刷新46个请求9237KB"：参考图缩略图直接用原图（1.4~1.7MB/张）， StaticFiles 挂载又没设 Cache-Control，每次刷新都要重新下载同一批图。文件名带 uuid、内容写完不再变，可以放心标 immutable，一行子类化搞定重复下载；缩略图本身 还是原图尺寸没缩小，留了 ponytail 注释记这个还没做的部分。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KJEL5jqdZR1QPToULRaTAz
-
已完成任务的视频文件其实早就在本机磁盘，之前无条件代理到raylight（4卡跑满时 HTTP请求要排在GPU计算后面），改成done状态直接本地FileResponse并加长期 Cache-Control，顺手给列表分页加页码按钮和跳转输入框。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KJEL5jqdZR1QPToULRaTAz
-
清理过载事故留下的重复排队任务时发现，取消/删除都只能按单条 id 调用， 脚本化清理只能一个个来。新增 POST /v1/videos/batch-cancel 和 /batch-delete，body 传 {"ids":[...]} 或 {status,kind,q} 筛选条件二选一； 筛选条件命中数超过 300 直接 400，避免条件写宽了误伤一大片。单条 cancel/ delete 的核心逻辑抽成 _cancel_job/_delete_job 供两边复用，批量场景里 一条失败（比如已经是终态）不影响其它条，成功/失败分别列出来。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GFw9ZBh3eVjssk6quYQ4Ki -
8080(LAN)/8081(公网) 两个进程共用同一份 sqlite，各自的 reconciler_loop 每 5 秒都会对进行中的任务逐条 UPDATE。默认 journal_mode=DELETE 下同一 时刻只允许一个写者、读写还互斥，且没设连接 timeout 时 sqlite3 默认只 等 5 秒——队列一次性堆到 200+（一次 fire-and-forget 并发提交 150 个任务 撞出来的）之后，写请求频繁互相撞车，直接抛 database is locked，连 GET /v1/backends 这种只读查询都被堵到 38 秒才返回。持续了 11+ 小时。 db() 连接加 timeout=30 + PRAGMA journal_mode=WAL，允许多读者+单写者 并发，写者互相排队重试而不是直接报错。部署后 35 秒内 0 次锁错误 （此前几乎每个 reconciler tick 都报错），/v1/backends 恢复到 ~0.3 秒。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GFw9ZBh3eVjssk6quYQ4Ki
-
左侧任务列表宽度 300px→50%，每条任务加缩略图（已完成显示结果视频首帧， 未完成显示输入的首帧图/参考图）；行节点按 job id 复用，避免每 5 秒轮询 重建 DOM 把还没加载完的 <video>/<img> 连根拔掉。 无限滚动改成真分页（默认 20 条/页），/v1/videos 加 offset 参数和 total 字段——列表变慢是因为无限滚动堆积的缩略图媒体请求越滚越多，分页把并发 请求数固定住。 修复 _try_submit（提交任务给 gateway）和 _discover_from_gateway（捞取 绕过 console 直连的任务）之间的竞态：提交请求已发出但 gateway_id 还没 写回数据库的窗口内，discover 会把这个任务误判成孤儿、用 gateway_id 自己 当 console id 再插一行，导致同一个真实任务在列表里出现两条记录（同一个 comfy_prompt_id）。两段操作现在共享同一把锁，不再重叠。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GFw9ZBh3eVjssk6quYQ4Ki
-
排查任务时经常要么去问 sqlite 里存的原始请求参数，要么去查 ComfyUI 自己的 /history 拿实际发给模型的完整 workflow graph——两者详情页都没有，只能手动 SSH 上去查。 - raylight/server.py 加 GET /v1/videos/{jid}/comfy_history，透传 ComfyUI 的 /history/{prompt_id}（这份数据在 ComfyUI 进程内存里，没有落盘，ComfyUI 重启后 查不到，接口会给出明确提示而不是裸错误）。 - h3-console/server.py 加对应代理。 - 详情页底部加两个默认折叠的区块：原始参数（req 原样 JSON，纯前端渲染，不用额外 请求）、ComfyUI History（懒加载，点开才去问后端，避免 queued/running 状态每次 轮询详情都多打一次 ComfyUI）。 - 顺带把生成结果视频从页面底部挪到状态/操作按钮那一行下面，不用再滚到底部看结果。 已在服务器重启验证：接口对已经清空 history 的任务（ComfyUI 重启后）正确返回明确 错误而不是裸 500；重启期间 14 条排队任务原样保留。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PA1AWh8e7wJ3vyhKBAEQux -
/v1/models 之前硬编码3个预设，模型文件名对应的是已删除的 api.py/gateway.py 那套旧 架构（minimax-h3-fl2va-nf4.safetensors 等），跟 raylight 现在实际加载的模型 （minimax_h3_fl2va_pruned_int8_convrot.safetensors 等）完全对不上，档位也只有3个， 跟前端下拉框实际支持的8个分辨率（RESOLUTION_CEILINGS）不一致——外部调这个接口查 "支持哪几档"拿到的是错的过期数据。 raylight/server.py 加 GET /v1/resolutions，返回 RESOLUTION_CEILINGS 的实时内容； h3-console 的 /v1/models 改成实时调这个接口拼 presets，顺带把 partitions 里的模型 文件名也换成当前实际使用的。 已在服务器上重启验证：/v1/resolutions 返回全部8档，h3-console /v1/models 端到端 拿到一致数据；重启过程中17条排队任务全部保留（用到了上一次改的排队恢复逻辑）。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PA1AWh8e7wJ3vyhKBAEQux
-
任务 f2de718e1e30（参考视频文件名带中文）秒失败：h3-console 上传时的文件名清洗用了 Python 3 默认的 Unicode \w，中文被当合法字符保留，资源 URL 里带着原始中文传给 urllib.request.urlopen，http.client 构造请求行要求纯 ASCII 直接炸了。改成请求前对 URL 的 path 部分 quote 一遍。 排查时发现 raylight 重启会把所有排队中的任务直接标记 cancelled（内存队列重启即清空， sqlite 里的 queued 记录没有任何路径被重新入队）。改成 Job 加 queue_seq、Q 换成 PriorityQueue，重启时排队任务原样保留、按序重新入队；顺带加了 POST /v1/videos/{jid}/prioritize 插队接口和对应的 h3-console 代理 + 前端"优先插队"按钮。 另外把 8月24日提交过、但实际从未部署到服务器的 ComfyUI 存活探测（_comfyui_alive） 重新加回，并解决了 raylight/server.py 和 raylight/scripts/server.py 长期分叉的问题。 已在服务器上验证：重启后 17 条排队任务原样保留、顺序不变；插队接口直接测试和通过 console 代理都验证通过；/health 的 comfy_alive 检查确认生效。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PA1AWh8e7wJ3vyhKBAEQux
-
公网审计发现 qwen.wudaima.com/console 无鉴权可直调（已知问题一直没排上），以及 comfyui.wudaima.com 也在裸奔（raylight 上线后 8188 常驻监听，旧的"隧道空挂"假设 已经过期，没人重新审计过）。两处都已实测确认修复生效：console 的 /v1/* 全部接口 要求 Authorization: Bearer <token>（H3_CONSOLE_AUTH_TOKEN 环境变量），ComfyUI 隧道 用 frp 原生的 http_user/http_pwd 加了基本认证。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SURs92UuTkFxDF4RXsEFJi
-
/v1/videos 一直硬编码 limit=50，服务器上实际232条未删除任务，超出的 根本没请求回来——不是滚动条的问题。改成滚到底部自动翻页加载；同时给 /v1/videos 加 q/status/kind/sort 参数（向后兼容），左侧栏加对应的 搜索框/状态筛选/类型筛选/排序切换。已部署到服务器并用真实数据验证过。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JDWoVwpqrsyzv9LRszTw9d
-
之前上传后只显示 uuid 文件名，传多个参考图/视频时分不清哪个是哪个。server.py 把原始 文件名塞进存盘文件名（<aid>__<原名>.ext），前端从 URL 反解出来显示在缩略图下方，旧任务 （改动前上传的，URL里没有__分段）会退化成显示uuid，不算错误只是没有原名可用。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
重置显存：raylight/server.py 加 /admin/reset-gpu（不挂在具体任务上的通用硬重启入口，应对 actor崩溃不自愈、显存卡在高位但JOBS里没有running任务的情况）。h3-console/server.py 加对应 代理端点 + 一个25秒的"重置中"窗口锁——硬重启期间端口直接连不上，提交新任务只会拿到一个费解 的连接失败，改成明确的409告诉用户还要等多久。前端加"重置显存"按钮，触发后禁用提交按钮、 轮询/health直到真正恢复。停止运行中任务(cancel)同样会触发这个锁。 下线旧接口：排查一次OOM发现GPU1被另一进程占着——另一个并发会话手动拉起了旧的 minimax-h3/gateway.py+api.py四个worker，测试他们改的代码，跟raylight抢卡。按端口停掉， 停了两次都被重新拉起（没有cron/systemd/supervisor在自动重启，是手动执行start-all.sh）， 所以把start-all.sh/start-gateway.sh改名成.disabled-20260824，留DISABLED-README.md说明 原因和恢复方法，代码权重都没删。 顺带查到两处过期文档：LLM(llm38)容器实际6天前就已经Exited了，qwen.wudaima.com早就打不通， 不是本次操作停的；"（常驻）whisper GPU3"这条也是过期信息，当时机器上根本没有whisper进程， 实际常驻的是stable-diffusion-webui-forge和一个embedding服务，跟本仓库两条工作线都无关， 已经一并停掉。CLAUDE.md/CHANGELOG都同步更新了。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
排队/取消：新增 cancelled 状态区分"排队未跑就被取消"和"运行中被打断"；运行中任务现在能点 "停止"——实测确认 ComfyUI 的 /interrupt 打断不了 Raylight 的 Ray 子进程（打断前后 GPU 一直 100%利用率），唯一办法是硬重启整个服务，已实测两种场景（初始化阶段/满载采样阶段）都能正确 收回 GPU。 参考视频/音频：GenReq 加 reference_video_urls/reference_audio_urls，用 ComfyUI 核心节点 LoadVideo→GetVideoComponents 接参考视频（自动带上视频自己的音轨），LoadAudio 接独立音频。 console 上传接口按类型分级限流，"多参考图生视频"tab 加对应上传框，task.html 的参考图/视频/ 音频现在都能直接预览播放（不再只显示文件名），不再需要跳出去看。 顺带修复：报错文本截取从头/尾盲截改成直接定位"XxxError: ..."模式，不会再被 traceback 里的 超长张量 dump 淹没掉真正的报错原因；console 自己的 partition 判断补上新字段，跟 raylight 那份 保持一致。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
用 Turing 版 SageAttention2 替换 TORCH_MATH 后端，解开了之前反复出现的 832×480×124帧/ 448×256×362帧/1024×576×60帧 OOM；又修复了 asyncio.CancelledError 被 contextlib.suppress (Exception) 漏接导致任务卡死在 running 的根因 bug。基于修复后的完成检测，实测出 4 个分辨率 的真实 CUDA OOM 上限（448×256 是画质上限，非显存上限），写进 server.py 的提交校验和 console 的分辨率/时长下拉联动，超上限请求直接拒绝而不是排队后才失败。详细过程和数据见 CHANGELOG.md 和 raylight/notes.md。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
CFG scale/negative prompt 参数入口（api.py + console 前端「高级参数」）、 参考素材点击插入 <Picture N>/<Video N> 标记、RTX PRO 6000 int8-convrot 冒烟测试成功的记录（h3-rtxpro6000/ 新目录）。这些改动之前只存在于服务器 磁盘和本地磁盘，没进 git，这次是同步不是新增功能。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
本地开发（脱离办公网络，只能走公网反代），未在真实 GPU 上验证，详见 docs/todo/verify-video-reference-on-gpu.md。 - minimax-h3/api.py: GenReq 加 reference_video_urls，_references() 打通到 pipeline 已支持的 video/video_audio 参考类型 - h3-console/server.py: /v1/assets 加视频上传支持（mp4/mov/webm，200MB） - h3-console/static/index.html: 参考视频多选上传 + URL 直填 + 预览， 重跑/任务详情页同步支持 新增 docs/todo 与 docs/done：把「明天要验证」和「画质改进方案」落成文档， docs/README.md 做索引，不重复 CHANGELOG 已有的细节。
-
/v1/videos/{jid}/file 两条返回路径都没设文件名，浏览器只能从 URL 猜， URL 以 /file 结尾没扩展名，猜出来都是 file.mp4，多个任务的视频存到同一个 下载目录会互相覆盖。加上 filename="h3-{任务id}.mp4"，id 天然唯一。 -
_try_submit 在 gateway_id 还是 NULL 的窗口里可能被 create_video/get_video/ reconciler_loop 并发调用，导致同一个任务被提交给 gateway 两次，两张卡各烧 一遍 GPU、其中一条变成没人追踪的孤儿任务。加进程内 _SUBMITTING 集合堵住这 个竞态窗口。 任务详情页只显示帧数不显示秒数，加一行按 24fps 折算的"时长"。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
HANDOFF.md 加了 2026-08-20 夜的最新状态一节（前置，不覆盖历史）：记录当前各服务 实际运行状态、今天做的十项改动摘要、以及一个重要发现——qwen.wudaima.com 现在 实际上是 minimax-h3 的 gateway.py 在占用（llm38 容器当前未运行），不是 Qwen LLM。 代码改动（此前几轮已分别验证部署，这次一并入库）： - h3-console/server.py、static/index.html：H3_CONSOLE_BASE_PATH 子路径支持， 用于挂到 qwen.wudaima.com/console - h3-console/README.md：同步子路径部署说明、gateway.wudaima.com 排查结论 - minimax-h3/api.py：ROWS_LIMIT 支持环境变量覆盖（边界探测用） - CLAUDE.md：当前负载表格更新 h3-console 的双实例/公网访问方式
-
任务行右侧「⋯」菜单可删除，左下角回收站入口可查看/恢复已删除任务。 server.py：jobs 表加 deleted_at 列，DELETE /v1/videos/{id} 软删除、 POST .../restore 恢复，GET /v1/videos?trash=true 切换视图。 不影响弹性调度器的 pending 计数（删除只隐藏，不取消底层任务）。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> -
- 从服务器同步 gateway.py、gateway-run.sh 等此前本地缺失的核心/调试脚本，修正与 服务器的漂移（此前 push 的本地副本一直缺 gateway.py 这个核心文件） - h3-console/server.py：_refresh_from_gateway 遇到 404 且任务未到终态时判 failed， 不再让后端进程重启丢失的任务永远显示"运行中" - h3-console/DESIGN.md、CHANGELOG.md 同步记录 fl2va/ref2va 默认基线改 2/2 分裂、 frames 上限改按 rows 动态判定的相关变更
-
包含 llama.cpp 部署脚本、MiniMax-H3 探查/运行脚本、h3-console Web 管理台源码， 以及运维文档（CLAUDE.md/HANDOFF.md/llm-setup.md/CHANGELOG.md）。 排除生成的图片/视频/音频产物、.venv、__pycache__ 等运行时/构建产物。