engine: 新增 --lock-tag,允许同一 tier 的第二个 runner 拿自己的锁并行

锁本来是按 tier 的(run-x265.lock),这是防两个编码器抢同一单元的正确默认值;
但当单进程吃不满机器时(720p x265 = wpp(12 rows),pools=22 实测 165 fps、整机 73%),
控制面要拆核并行两个 x265:第二个 runner 必须有自己的锁名,否则永远退避在 engine lock busy。
--lock-tag x265-w2 → run-x265-w2.lock,留空 = 旧行为。references/pitfalls.md 补第 13 条。
This commit is contained in:
2026-10-12 17:17:50 +08:00
parent 0287dcd2f6
commit c45cdda983
2 changed files with 21 additions and 1 deletions
+9 -1
View File
@@ -1245,6 +1245,9 @@ def main():
ap.add_argument("--crf", type=int, default=CRF_X265, help="x265 tier quality (measured default 24)")
ap.add_argument("--x265-preset", default=X265_PRESET)
ap.add_argument("--pools", type=int, default=X265_POOLS, help="x265 threads (match the affinity mask)")
ap.add_argument("--lock-tag", default="",
help="lock name suffix (run-<tag>.lock) so a second worker of the SAME tier can "
"encode concurrently on its own core set; empty = use the tier name")
ap.add_argument("--affinity-mask", default="0x%X" % E_CORE_MASK,
help="hex CPU mask for the x265 tier (default = the E-core mask); the mask is "
"inherited by the ffmpeg children and must agree with --pools")
@@ -1317,7 +1320,12 @@ def main():
# One lock PER TIER, not one global lock: the copy tier uses no encoder, the x265 tier is CPU
# and the nvenc tier is the GPU ASIC, so they are safe to run side by side whereas two runs of
# the same tier would race on dst and starve a shared unit.
lockf = os.path.join(WORK, "run-%s.lock" % (args.tier or ("single" if args.path else "all")))
# `--lock-tag` lets a SECOND worker of the same tier take its own lock: the lock exists to stop two
# encoders racing on the same unit/output, and the control plane splits the cores explicitly
# (measured 2026-10-12: two 720p x265 processes with 10 threads on disjoint core sets = +48%
# aggregate throughput over one process with 22 threads, because x265 caps at wpp(12 rows)).
lockf = os.path.join(WORK, "run-%s.lock" % (args.lock_tag or args.tier
or ("single" if args.path else "all")))
log("=== %d file(s) tier=%s cq=%d crf=%d audio=%s decode_check=%s lock=%s" %
(len(files), args.tier or "auto", args.cq, args.crf, args.audio or "source-matched",
DECODE_CHECK, os.path.basename(lockf)))