Web影视资源助手产品系统Vibe Coding

1、立项原因，旨在解决什么产品问题
本项目立项旨在解决普通用户在访问互联网免费影视资源时面临的核心痛点：泛滥的弹窗广告、恶意的网页跳转劫持，以及底层视频源经常因防盗链（CORS跨域限制）导致的加载失败和卡顿断流。为了给用户提供一个“零广告、零干扰”的沉浸式观影环境，我开发了这款极简纯净的本地影视检索与播放桌面端工具。通过在本地搭建轻量级的拦截与代理服务，将复杂的页面解析、去广告剔除和跨域流媒体转发等重计算任务下沉到本地后台运行，彻底剥离网站原有的不良污染元素，仅将最纯净的视频流直接推送给用户，极大提升了产品的体验与纯净度。

2、行业场景、业务背景
在泛娱乐的视频点播行业中，大量的影视资源通常被切片为 HLS（m3u8/ts）流媒体形式并在边缘 CDN 上分发。然而，这些资源聚合站点往往缺乏前端技术规范，且盈利极度依赖粗暴的前端广告代码，导致页面充斥着各种不可控的脚本代码。一旦脱离其原始页面直接播放视频流，常规浏览器前端往往会被严格的跨域安全策略阻断。面对这一行业乱象，传统的浏览器去广告插件难以对流媒体进行底层拦截。因此，需要一种基于本地代理机制架构，兼任请求“黑客代理”与数据“搬运工”，打破协议壁垒重组数据流，以此来创造原生、极速的播放大厅体验。

1、项目有哪些具体功能模块

智能检索引擎模块：提供对全网影视资源的深度全文模糊检索，内置防空格容错清洗系统，保障极高模糊搜索的命中概率。
资源与线路解析模块：将原站错乱复杂的 HTML 原文转化为标准的 JSON 格式，智能归类提取所有可用节点（多条播放线路），以直观的形式全量展示影视剧集。
本地流媒体代理转发模块：建立透明的视频流代理中继通道，擦除原站点的逐跳头信息（hop-by-hop）以此绕开系统防御机制，并稳定转发高频切片数据。
独立 HLS 播放器模块：剥离于外部组件的极简 Web 观影界面，提供 HLS 协议直解能力，并集成自定义多档位视频速率控制模块（支持 0.5x - 2.0x 倍速）。
2、项目的主要功能描述
项目坚持“零依赖、免安装”极客理念。用户在本地一键运行启动脚本，即可自动分配可用网络端口并唤醒系统默认浏览器，无缝进入影视搜索大厅。在无任何广告骚扰的精简 UI 中，用户输入影视关键字即可极速拉取带有海报的检索列表；点击资源后，系统后台剥离原站冗余数据，直观呈现不同节点和多集列表。选择想要观看的集数，即刻在新视窗中进入高清独立播放器，自动启用本地缓冲加速与播放调度，彻底告别观影前的几十秒倒计时广告与诱导点击行为。

1、我负责哪些具体任务
本项目为个人独立作品。我独立完成了项目的整体架构设计、技术选型以及全栈代码研发。具体包含后端 Node.js 爬虫引擎的编写、HTTP 流媒体代理服务层的构建、网络连接的性能调优与并发管理，以及前端（HTML/CSS/JS）的用户交互搭建、HLS 播放器的定制封装，并编写了用于一键运行的本地自动化启动脚本。

2、项目使用了哪些技术栈、架构、实现亮点、难点

技术栈：纯原生 Node.js（基于内置的http/https, fs, url模块）、Vanilla JavaScript、HTML5/CSS3、HLS.js流媒体库。
架构：采用本地轻量级 C/S 代理架构。后端彻底拒绝臃肿的第三方 Web 框架（且无需 npm install 零三方包依赖），直接用底层原生接口实现了极速秒级启动。前端界面直接基于 Fetch API 与后端接口进行通信和视频流数据中转。
实现亮点与攻克难点：
极客级网络并发调优：为解决庞大数量的 TS 切片拉取所产生的高频握手与 TLS 耗时开销，重写了 HTTP Agent，并全局引入了 Keep-Alive 连接池机制，动态分配热连接。结合对 M3U8 索引与静态界面的内存级 TTL 缓存调度，大幅提高了流媒体的秒开率和起播速度。
连接死锁防泄漏机制设计：视频中转极其消耗带宽与内存，因此我设计了异常精准的底层中断机制监听。一旦捕捉到客户端（如用户强制关闭原浏览器标签），服务端底层立刻通过 destroy() 销毁上游 CDN 的拉流行为，防止因网络句柄闭合不及时导致的带宽窃取与内存幽灵泄漏。
鲁棒性高的 HTML 块级解析算法：由于大部分不规范目标站点的 DOM 结构极其混乱且标签闭合常有错误，导致传统的正则匹配或类 Cheerio DOM解析树往往解析“失明”或丢失线路。