源码系统概览
文章正文
Zevideo是一个基于Typecho博客系统做的开源视频主题,主要面向想做影视动漫类站点的朋友。
作者jrotty(网名泽泽社长)把它放到了GitHub上开源,还配套写了个叫CatClaw的采集插件,能对接市面上大部分资源站的JSON接口自动拉内容。
这套源码把Typecho核心、Zevideo主题和CatClaw插件都打包在一起了,上传部署就能跑起来,自带pjax无刷新加载、深色模式切换和播放历史记录这几个实用功能。
源码简介
这套东西的核心就是Zevideo这个主题,它把原本用来写博客的Typecho改造成了能展示影视内容的门户站点。
前端用的Tailwind CSS做响应式布局,全站pjax驱动,点链接不会整页刷新,用起来跟App似的顺。
深色模式会自动跟随操作系统的设置切换,不想自动的话也可以手动点一下按钮来回切。
播放历史功能会记住你看到哪一集了,下次打开接着看,换台设备也能续上进度。
首页排版可以在后台自己调,Logo、统计代码、广告位这些都能在主题设置里改。
CatClaw采集插件是这套方案里最关键的部分,它调用资源站的标准JSON接口(一般是api.php/provide/vod/?ac=list和?ac=detail这两个地址)把影片列表和详情数据拉下来。
插件支持免登录采集和定时任务两种跑法,碰到同名影片会自动跳过不重复采,已经连载中的片子更新了也会跟着刷新状态。
适用场景
想搞个动漫或电影电视剧聚合站的朋友可以用这套源码快速搭起来。
手头有闲置域名不知道干啥好的,拿来做娱乐内容填充也行,顺便练练Typecho主题开发和视频站运营。
已经在用Typecho写博客的,装上这个主题就能把现有站点改成视频展示型,不用从零开始折腾。
功能亮点
pjax全站无刷新是这主题的一个卖点,页面之间跳转不需要等整页重载,体验确实比传统整页刷新好不少。
深色模式这块做得比较细,系统设了暗色它会跟着变,不喜欢自动的也能手动切,白天晚上各取所需。
播放历史记录挺实用的,每部片子的进度都会存下来,换个浏览器或者手机打开还能接着上次的地方看。
CatClaw插件能对接几十家主流视频资源站的JSON接口,配置好之后批量导入影片数据和封面图,省得一条条手动录。
后台有个可视化设置面板,Logo、页脚版权信息、统计代码和广告位代码都在里面改,不用去碰模板文件。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端:PHP模板 + Tailwind CSS + 原生JavaScript(pjax驱动) 后端:Typecho框架 |
依具体方案选型,需自行搭建与维护 |
| 部署方式 | 把源码整个传到Web服务器的根目录下,确认install.php能在根路径直接访问到就行。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | pjax全站无刷新是这主题的一个卖点,页面之间跳转不需要等整页重载,体验确实比传统整页刷新好不少。 | 功能通用,定制深度有限 |
| 数据归属 | 数据自持,部署在自有服务器,不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署,无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端:PHP模板 + Tailwind CSS + 原生JavaScript(pjax驱动)
后端:Typecho框架(PHP 7.4+/8.x)+ PDO_Mysql数据库适配器
数据库:MySQL 5.6+(utf8mb4)/ PostgreSQL / SQLite
运行环境:Apache或Nginx服务器,需开启URL重写(mod_rewrite)
其他依赖:CatClaw采集插件 + 可选gjsoso多条件检索付费插件
安装与部署提示
把源码整个传到Web服务器的根目录下,确认install.php能在根路径直接访问到就行。
浏览器打开域名/install.php走安装向导,按提示填好MySQL数据库连接信息,几步就能初始化完。
装完之后登录后台(默认地址/admin/),去外观管理那里把Zevideo-main主题激活。
然后进插件管理启用CatClaw,在插件设置页面填上你要对接的资源站JSON接口地址。
有个地方需要手动改一下Typecho的核心文件,找到var/Widget/Archive.php大概第764行那块,把排序字段从created改成modified,这样视频站才能按最后更新时间排而不是按创建时间排。
还有个建议是把typecho_fields表里str_value字段的类型从text改成mediumtext,不然像柯南这种上千集的字段存不下。
截图与演示说明
下面这张图是Zevideo主题前台首页的实际效果,左边是导航侧边栏,右边主体区域用卡片网格展示最新入库的影片。

左侧分类栏列出了日本动漫、动漫电影、日剧、韩剧这些频道,每个影片卡片上都标了更新集数,带缩略图预览。
整体界面风格偏简洁现代那一挂,亮色暗色两套配色方案都适配了,手机端自适应也没问题。
后台管理面板用的是Typecho自带的控制台样式,主题相关的设置项集中在外观菜单里面,用过Typecho的人应该一眼就能找到地方。
常见问题
问:这个主题只能拿来建视频站吗?
Zevideo确实是针对影视内容做了列表展示和播放器适配,但它本质上还是个Typecho主题,你要拿去做图文混排的内容站也完全没问题。
问:CatClaw插件采集的视频会有版权问题吗?
插件本身做的事情就是调资源站公开提供的API接口拉数据,版权这块主要看你用的资源站内容本身是否合规,上线之前最好自己确认清楚。
问:为什么要改Typecho的核心文件?
Typecho默认按文章创建时间排序,但视频站的实际需求是新更新的剧集要排在前面,所以得改成按修改时间排序,这是针对使用场景做的必要调整。
问:那个多条件检索功能一定要买付费插件吗?
对,gjsoso那个多条件检索插件是第三方收费产品,如果你不需要高级搜索功能的话,直接把主题目录里引用它的代码删掉就行,不影响其他功能。
安全风险提示
特别提示:本源码未检测安全风险文件,下载后请务必进行安全审计,删除恶意代码后再部署使用!
下载说明
源码仅供学习研究、测试部署和二次开发参考,商用前请自行确认授权、版权和安全风险。
另外提一句,这套源码的视频内容主要靠第三方资源站接口获取,正式运营前请务必确认内容来源的版权和合规情况,别踩侵权坑。