1. 先搞清楚 Castor 到底解决什么问题

如果你经常需要在电脑上找视频，然后投到电视大屏看，Castor 这类工具就是帮你省掉手动操作的。它不是一个完整的流媒体平台，而是让你在命令行里直接指定网页视频地址，一键推送到电视。最适合的场景是：你已经找到了想看的视频页面，但不想在电视上重新打开浏览器、登录账号、搜索片名，而是直接从工作终端投过去。

和那些需要安装电视端 APP 或依赖特定视频平台的做法不同，Castor 走的是 DLNA/UPnP 协议。这意味着只要你的电视支持 DLNA（现在大部分智能电视都自带），或者接了 Chromecast、Fire TV Stick 这类设备，就能直接接收推送。你不用在电视上装任何东西，也不用关心视频来源是 B 站、YouTube 还是其他支持网页播放的站点。

但要注意：它投的是网页视频，不是整个屏幕。所以如果你需要投会议软件、游戏画面或本地播放器，Castor 不适用。它的核心价值就是“网页视频→电视”的直达通道。

2. 运行环境准备：别急着装，先确认电视和设备状态

Castor 是命令行工具，所以你得有终端环境。Windows 用户可以用 PowerShell 或 WSL，macOS 和 Linux 直接开终端。但最关键的不是电脑系统，而是电视和网络条件。

电视端要确认 DLNA 或 Chromecast 可用：

• 打开电视，进入设置菜单，找“网络”“多屏互动”“DLNA”或类似选项，确保是开启状态。
• 如果电视较老或不支持，可以外接一个 Chromecast、Fire TV Stick 或小米盒子这类设备，它们通常都支持接收推送。
• 最简单验证方式：在电脑上打开支持投屏的视频网站（比如 B 站），播放时点击播放器的投屏按钮，看能否搜到你的电视。如果能，Castor 大概率也能用。

电脑和电视必须在同一局域网：

• 两者连同一个路由器，或者在同一网段（比如电脑用 Wi-Fi，电视用网线，但都是 192.168.1.x）。
• 如果网络有隔离（例如公司网分办公区和访客区），投屏会发现不了设备。
• 防火墙有时会拦截发现协议，如果电视搜不到，先暂时关闭电脑防火墙测试，没问题后再加规则放行。

Castor 本身是开源工具，安装方式通常是包管理或直接下载二进制文件：

• macOS 用户可以用 Homebrew：brew install castor（如果官方有提供）。
• Linux 用户可能要用 snap 或从 GitHub Releases 下载对应架构的二进制文件。
• Windows 用户直接拿 exe 文件，或者用 scoop 安装。
• 如果安装失败，最常见的原因是依赖没装全（比如 ffmpeg 或 node.js），或者网络问题拉不到资源。

3. 第一次投屏：从最简单的单条命令开始

安装完别急着处理复杂任务，先确保基础流程能走通。Castor 的典型用法是：

castor "https://www.bilibili.com/video/BV1xx411c7HW"

这条命令会做几件事：

1. 解析网址，识别页面里的视频源。
2. 在局域网里广播搜索支持的电视设备。
3. 把视频流地址推送给电视，电视开始播放。

如果电视没反应，按这个顺序排查：

• 先看命令输出有没有报错。常见错误有“未找到设备”“无法提取视频链接”“连接超时”。
• “未找到设备”说明网络发现环节出了问题，确认电视开著、同局域网、防火墙没挡。
• “无法提取视频链接”可能是网址不对（比如不是视频页而是列表页），或者网站结构变了，工具解析不了。
• “连接超时”往往是电视端拒绝接收，检查电视是否正处于其他投屏或输入源状态。

成功的话，电视会自动切换到投屏界面并开始播放。这时别关终端，因为 Castor 会保持连接，直到播放结束或你手动中断（Ctrl+C）。如果你提前关终端，电视可能卡住或停止播放。

4. 进阶用法：批量投屏、参数调节和播放控制

单条命令跑通后，可以试试更实用的场景。

批量投多个视频：
Castor 可能支持播放列表，比如把一个文本文件里每行一个网址传给它：

castor --playlist mylist.txt

但批量投屏时要注意：电视一般不会自动连播，放完一个就停了。如果你需要连续播放，最好事先把视频合并成列表，或者用脚本控制 Castor 投完一个再投下一个。

常用参数调节：

• --device-name “客厅电视”：如果你家有多台设备，用这个指定投哪台。
• --subtitles lang=zh：强制加载中文字幕（如果视频支持）。
• --quality 1080p：指定清晰度，但实际效果取决于视频源是否提供该分辨率。
• --seek 00:05:30：从5分30秒处开始播放，适合续播。

参数不是越多越好，先不加参数能播，再按需添加。有些参数对特定网站无效，因为视频源可能不提供多分辨率或外挂字幕。

播放中的控制：
Castor 是推送型工具，视频开始播放后，控制权主要在电视遥控器。你可以在终端里暂停（Ctrl+Z）或终止（Ctrl+C），但快进、音量调节还得用遥控器。这点和 AirPlay 或 Miracast 不同，后者是镜像屏幕，电脑端还能控制进度。

5. 常见问题排查：从网络到视频源的逐层定位

电视搜不到：

• 80% 的问题是网络隔离或防火墙。先用手机投屏试试，如果手机也搜不到，问题在电视或路由器。
• 电视重启、路由器重启能解决大部分临时故障。
• 如果网络有 IGMP 或组播限制（某些企业网络），DLNA 发现会失败，这时需要改网络设置或换家用网络环境。

能搜到电视但投屏失败：

• 视频网址可能需要登录或会员才能看，Castor 不会帮你带 cookie 或身份信息，所以电视端无权限播放。
• 网站用了复杂加密或动态加载，Castor 提取不到直接视频流。这时可以尝试用 yt-dlp 等工具先下载到本地，再用 Castor 投本地文件（如果支持）。
• 电视解码能力有限，遇到 HEVC、AV1 等新编码可能播不了，换一个视频试试。

播放卡顿或画质差：

• 如果是无线网络，信号干扰或带宽不足会导致卡顿。把电脑和电视尽量靠近路由器，或者用有线连接。
• 视频源本身码率高，而路由器性能不够，数据传不过去。尝试在 Castor 里降低清晰度参数。
• 电视硬件解码性能弱，遇到高帧率或高码率视频会掉帧，这不是 Castor 的问题，是电视瓶颈。

命令执行后无输出：

• Castor 可能默认静默运行，加-v或--verbose参数看详细日志。
• 如果加了参数还是没输出，可能是工具本身崩溃或依赖缺失，检查安装步骤是否完整。

6. 替代方案和适用边界：什么时候该用 Castor，什么时候换别的

Castor 适合：

• 快速投屏网页视频，不想折腾电视 APP。
• 环境限制不能在电视上装软件（比如酒店电视）。
• 习惯命令行操作，想写脚本自动化投屏任务。

不适合：

• 需要投整个屏幕或特定应用（用 Miracast、AirPlay 或 Steam Link）。
• 视频源需要复杂登录或验证（比如公司内网视频系统）。
• 对稳定性要求极高，不能接受偶尔解析失败或兼容问题。

同类工具对比：

• yt-dlp + dlna-play：先下载再投本地文件，更稳定，但步骤多。
• 浏览器原生投屏：方便但受限平台（比如 Chrome 只支持 Chromecast）。
• 电视自带 APP：直接打开视频网站，但操作麻烦且电视浏览器往往不好用。

如果 Castor 在你环境下总失败，可以退回最原始的方式：用 HDMI 线直连。虽然不够优雅，但绝对可靠。

7. 生产级使用建议：长期投屏如何更稳

如果你打算长期用 Castor，几个小调整能提升体验：

• 把电视设备名称固定下来，写进脚本或别名，避免每次手动选择。
• 准备一个备选视频源（比如同一视频有 B 站和 YouTube 链接），一个解析失败自动换另一个。
• 投屏前先用castor --list-devices确认设备在线，再发送视频。
• 如果经常投特定网站，可以写包装脚本，自动提取当前浏览器标签页网址再传给 Castor。

最重要的一点：这类工具强依赖网页结构，网站改版可能就失效了。保持 Castor 更新，或者选择那些视频源结构稳定的平台（比如主流流媒体站）。

最终判断标准：能让你在 30 秒内从找到视频到电视播放，就是好工具；如果每次都要折腾 10 分钟，不如换方案。