Invidious：界面、媒体路径与运维责任
Invidious 学习项目：先解释搜索决策，再增加自动化
设计使用合成案例、明确证据标签和验收标准的离线查询路由解释器，不把尚未实现的互动工具说成成品。
你将学会
- 解释一个真实的分支边界
- 保持合成输入和证据标签可见
- 增加视觉效果之前，先定义完成标准
开始前需要
- 了解 HTTP 和容器基础
- 区分应用状态与媒体流量
解释依赖和信任边界，准备可核验的试验，并在真实范围内理解源码与模型证据。
先看结论
- 互动练习应解释真实的源码边界。
- 区分模型输出、上游执行与部署证据。
- 一个设想或静态图解不是已上线的互动解释器。
解释一个真实的分支边界
有价值的学习项目，是用小型离线解释器展示查询规范化、智能功能抑制、模式和过滤门槛，以及后续清理器的职责。这对应源码阅读中的真实难点，而不是增加与代码关系不大的装饰性三维场景。可访问的普通表格或 SVG 轨迹，就能表达这些关系，无需加载图形引擎。
十六个独立模型案例可以作为初始教学样本，包括“类似 URL 但不是视频”的根地址，以及带过滤器、仍然走普通搜索的输入。它们不是实现的最终判定标准。生产质量的解释器还需要实际源语言测试，并审阅模式、过滤器解析和最终目标规范化的行为。
保持合成输入和证据标签可见
使用虚构且不涉及个人信息的标识，不让案例面板执行网络跳转。分别展示文档描述、源码检查、独立模型输出和真正的上游执行结果。这样才能避免一个绿色分类标记，让读者误以为视频存在、重定向安全，或某个部署已经通过安全测试。
高级版本可以比较当前与后续源码提交并突出分支变化，但前提是固定两个版本并检查语义。不要为了生成案例自动导入用户观看历史。账号导出数据并不是这个练习所必需的内容，静态教程也不应该悄悄变成遥测收集工具。
增加视觉效果之前，先定义完成标准
验收应包括键盘可操作的控件、文字替代、完整语言标签、确定性案例，以及分类与最终路由之间的清晰分离。若增加动画，它应帮助理解决策顺序，并尊重减少动态效果的偏好。对于这种小型条件分支，三维渲染没有明显优势，还需要额外证明可访问性和性能合理。
本系列实际交付的是原创静态图解，以及 EasyAI 仓库中可运行的独立 JavaScript 教学模型。它没有交付互动查询解释器，没有执行 Crystal，也没有测试完整清理器。只有当真实界面、源语言行为和可访问性检查都存在并通过验证时，后续项目才算完成；想法本身不是已交付功能。
实施步骤
- 1
明确需要解释的查询决策。
- 2
使用离线合成案例和可见证据标签起步。
- 3
宣称等价前，补充源语言和最终目标测试。
- 4
若实现界面，验证键盘、文字替代和翻译。
可复制示例
{
"proposal": "offline query-route explainer",
"modelCasesAvailable": 16,
"interactiveExplorerShipped": false,
"sourceLanguageSuiteExecuted": false,
"networkNavigationEnabled": false,
"userHistoryRequired": false
}常见问题
本系列已经有 Three.js 解释器了吗？
没有。实际交付的是静态 SVG，互动解释器明确属于后续提案，而不是已完成的功能。
JavaScript 模型可以代替上游测试吗？
不能。它是范围有限的教学辅助；更强的等价性结论需要源语言测试和最终路由检查。
资料来源
- invidious/src/invidious/search/query.cr来源核查 2026-09-08
- invidious/spec/invidious/search/query_spec.cr来源核查 2026-09-08
- invidious/src/invidious/routes/search.cr来源核查 2026-09-08
- invidious/src/invidious/yt_backend/url_sanitizer.cr来源核查 2026-09-08