用电脑免费看网络影视 — ZYFun安装与配置指南
想用电脑免费看网络影视？ZYFun（原ZyPlayer）是目前最靠谱的开源播放器，支持海量影视资源站和直播源。本指南覆盖从下载到能看的全流程。
第一步：下载安装ZYFun
ZYFun是开源免费软件，跨平台支持Windows/Mac/Linux。
👉 详见 references/download.md
快速下载（Windows x64）：
Invoke-WebRequest -Uri "https://gh-proxy.com/https://github.com/Hiram-Wong/zyfun/releases/download/v3.4.7/zyfun-win-3.4.7-x64-setup.exe" -OutFile "$env:USERPROFILE\Downloads\zyfun-setup.exe"
下载后双击安装，安装完自动启动。
第二步：配置影视源（核心）
安装完ZYFun打开后是空的——没有影片可看。需要配置影视采集站接口。
⚠️ 重要：UI添加站点不可靠
ZYFun v3.4.x已移除"远端导入"按钮，UI手动添加经常报"出了点差错"。最可靠的方式是直接注入数据库。
快速配置（推荐）
运行注入脚本，一键添加验证可用的影视源：
python "<技能目录>\scripts\inject_sites.py"
> <技能目录> = 本SKILL.md所在目录。WorkBuddy安装后通常是 %USERPROFILE%\.workbuddy\skills\zyfun-setup。AI执行时用绝对路径，不要用相对路径。
脚本会自动：关闭ZYFun（如未运行则跳过）→ 备份数据库（data.db.bak-时间戳）→ 验证源可用性 → 注入 → 提示重启。无需手动关闭ZYFun。
重启ZYFun后，影视配置页面就能看到站点列表，搜索影片即可观看。
手动配置（备选）
如需手动添加单个站点，用SQLite工具操作 %APPDATA%\zyfun\database\data.db：
INSERT INTO tbl_site (id, key, name, api, playUrl, search, "group", type, ext, categories, isActive)
VALUES ('uuid-here', '站点key', '站点名称', 'https://xxx/api.php/provide/vod/?ac=list', '', 1, '影视', 1, '', '', 1);
⚠️ group是SQL保留字，必须加双引号 "group"。
站点类型编码
| type | 类型 | 说明 |
|---|---|---|
| 0 | CMS XML | 老格式，少见 |
| 1 | CMS JSON | 推荐，最稳定 |
| 3 | drpy | 需Python运行时，可能报错"UV binary is not ready" |
| 4 | hipy | 较少见 |
| 6 | TVBox多仓 | ZYFun兼容性差，多仓内站点常无法正确加载 |
| 7 | debug | 内部调试 |
优先选type=1（CMS JSON单站点）。
可用源列表
详见 references/verified_sources.md
影视采集站经常更换域名或下线，需定期复查。运行验证脚本检查：
python "<技能目录>\scripts\verify_sources.py"
默认超时15秒，部分活源响应需10秒以上，不要把超时调到10秒以下。
第三步：看直播电视（可选）
ZYFun支持IPTV直播源（m3u格式），可以看央视、卫视等网络电视直播。
快速配置直播源（推荐）
注入影视源时加 --iptv 参数即可同时注入直播源：
python "<技能目录>\scripts\inject_sites.py" --iptv
或单独注入直播源（如之前已注入过影视源）：
python "<技能目录>\scripts\inject_sites.py" --iptv --skip-verify
注入3个验证可用的直播源（国内均走gh-proxy.com镜像）：
- IPTV中文频道（含央视卫视地方台）
- IPTV中国频道（仅中国境内）
- 范明明IPv6直播
重启ZYFun后，在「直播」页面切换IPTV源即可观看。
👉 详见 references/iptv_setup.md
常见问题
安装或配置过程中遇到问题？几乎所有坑都踩过了：
👉 详见 references/troubleshooting.md
高频问题速查：
- "出了点差错" → 不用UI，用注入脚本
- 找不到脚本 → 用SKILL.md所在目录的绝对路径调用脚本
- 站点不显示 → type选错了，用type=1
- 搜索没结果 → 采集站已失效，运行verify_sources.py检查
- UV binary is not ready → drpy站点需要Python运行时，不影响type=1站点
- 下载超时 → 国内访问GitHub需镜像站
脚本说明
scripts/inject_sites.py
批量注入CMS站点和IPTV直播源到ZYFun数据库。
python inject_sites.py [--db DB路径] [--sites 站点JSON] [--iptv] [--skip-verify] [--timeout 15]
- 默认注入验证可用的CMS影视源
--iptv同时注入IPTV直播源--sites指定自定义JSON文件--skip-verify跳过API验证（加速）- 写库前自动备份（data.db.bak-时间戳）、自动关闭ZYFun进程、注入、统计
scripts/verify_sources.py
验证CMS采集站API是否存活。
python verify_sources.py [--db DB路径] [--timeout 15] [--remove-dead]
- 逐个测试数据库中所有type=1站点（默认超时15秒）
- 不带
--remove-dead时为纯只读，ZYFun运行中也可执行 --remove-dead删除不可用站点（删除前自动备份数据库）
版本变更
v1.0.1 (2026-08-02 定稿)
- 新增IPTV直播源注入功能（
--iptv参数，内置3个验证可用的m3u直播源，国内均走gh-proxy镜像） - iptv-org直播源改用 gh-pages 分支 + gh-proxy 镜像地址（官方 iptv-org.github.io 国内直连不通，实测HTTP 000）
- 修复tbl_iptv createdAt/updatedAt时间戳类型：毫秒级整数，修复字符串/秒级时间导致直播源无法加载
- 影视源移除已失效的天涯资源(tyyszy)，内置源由6个改为5个
- 修正defaultIptv说明（存的是直播源id而非key）；验证超时统一为15秒
- iptv_setup.md：补全tbl_iptv可执行SQL与时间戳警告；troubleshooting.md：新增#12直播源排查
