Octans

本文主要记录在自托管媒体库场景下，扫描探测工具在 MediaInfo 与 ffprobe 之间应如何分工：速度差从哪里来、字段面谁更宽、哪些事实更适合交给 FFmpeg 视角，以及为何不宜一次性把扫描主数据源全量切到 ffprobe。 ...

本文主要说明自托管媒体库（以 Octans 播放子系统为例）在 HLS 转码缓存 上的存储选型：当前短窗口 + tmpfs 适合什么、为何生产默认应迁到 SSD 本地盘 + 应用层治理，以及容量模型、网络文件系统边界和清理优先级如何一起约束架构。 ...

本文主要介绍自托管媒体库在播放转码链路上的 FFmpeg 工具链治理：为何不能默认依赖发行版自带 ffmpeg，历史 Jellyfin FFmpeg 路径解决了什么，自维护 runtime 如何安装与验证，以及 capability 探测与「二进制能跑」之间的差别。 ...

本文主要介绍一类自托管媒体库（以 Octans 后端为例）在两件看似无关、实则都决定「长期可维护性」的决策上如何收口：一是内部结果模型与错误契约统一，二是配置可视化首版的边界。前者解决 Controller / Service 各造一套 *ServiceResult 的分裂；后者解决「配置能改、能看、能审计」与「部署覆盖、启动链路、权限面」之间的张力。讨论的是可被 supersede 的工程边界，不是某一版本的接口字段全集。 ...

本文主要说明自托管媒体库（以 Octans 一类播放子系统为例）在协商 DirectPlay / DirectStream / Transcode 时，为何「能解码」不等于「能正确显示」：动态范围与色彩管线应作为独立事实进入 Planner，DirectStream 的视频 copy 不能自动修 HDR，tone mapping 属于完整转码，以及 Dolby Vision 为何必须按 profile / fallback 保守处理。 ...

本文主要说明自托管媒体库（以 Octans 扫描与轨事实层为例）如何把「容器内 stream 事实」和「给 UI / NFO / 选轨用的展示轨」分层建模，如何用语言与标题启发式生成可读轨名，以及视频动态范围（HDR / Dolby Vision 等）为何要按证据优先级保守分类、并在必要时做分层探针。探测工具选型本身见同系列 MediaInfo / ffprobe 文，本文不重复速度与字段面对比。 ...

本文主要把早期项目笔记中与媒体库开发直接相关的基础知识收成一篇速记：动态范围与蓝光规格、API 契约概念、实时进度通道，以及像素格式 / 图像处理边界。不追求百科完整度；详细播放与架构见同系列专题。 ...

本文主要从架构边界角度梳理一类自托管媒体库（以 Octans 播放子系统为例）：播放为何从 Catalog / 任务系统里拆出来，服务端与客户端各管什么，以及 PlaybackSession、Planner、DirectPlay / HLS 交付如何构成当前 Web 主链。重点是职责与名词，而不是接口字段大全。 ...

本文主要把一类自托管媒体库（以 Octans 播放子系统为例）的播放能力决策写成可复用的 Planner 模型：输入不是「codec 能不能播」的布尔判断，而是客户端能力、媒体事实与策略的交叉求解；输出是 DirectPlay / DirectStream / Transcode（及无法成计划时的 Unsupported），并与交付方式（HttpFile / Hls 等）解耦。 ...

本文主要记录一类自托管媒体库（以 Octans 播放子系统为例）在 Web 与 Windows native/libmpv 播放链路上的排障方法：从创建会话、DirectPlay / HLS 分流、暂停恢复与 seek，到字幕资源、硬解回退与残留 window 清理。命令与路径已通用化，便于对照同类架构做定位。 ...