fish2018/webhtv

说明与用途

**项目价值**

• **可定制的首页**：通过 HTML/CSS/JavaScript，开发者可以把 CSP 站点的首页打造成真正的 Web 应用，而不再受限于固定模板。
• **原生能力封装**：App 暴露的 Native SDK 为页面提供搜索、播放、跨域请求、资源代理、最近观看、网盘链接检测、状态同步等功能，省去自行实现底层协议的工作量。
• **生态扩展**：内置 Nostr 推荐首页、WebHome 自定义首页等模块，方便在同一平台上快速接入社交推荐、云盘资源等新业务场景。

**典型接入方式**

1. **Fork / Clone 项目**，在 src 目录下编写或修改前端页面（HTML、CSS、JS）。
2. **使用提供的 App Native SDK**（通过 npm 包或直接引入 sdk.js），调用 search()、play()、proxyRequest() 等接口完成业务逻辑。
3. **在 manifest.json 中声明需要的权限**（如存储、网络），并在 App 打包后通过内部渠道分发或直接在已有 WebHomeTV 客户端中加载。
4. **可选**：如果需要 Nostr 推荐或网盘检测功能，直接引入对应的插件模块并在页面中初始化即可。

**生产可用性**

• **成熟度**：项目已有 683 ★、208 Fork，最近一次提交在 2026‑06‑24，活跃度仍然较高。核心功能（首页渲染、Native SDK）已在多个内部 CSP 项目中上线，基本稳定。
• **依赖与维护**：主要语言为 Java，后端依赖相对集中，前端仅依赖标准 Web 技术和少量 npm 包。建议在正式环境前进行一次 **依赖安全审计**（尤其是第三方 SDK）并确认许可证（MIT/Apache 等）与公司合规要求匹配。
• **上线建议**：

1. 先在 **测试环境** 搭建一个小型 Proof‑of‑Concept，验证页面渲染、Native 接口调用以及跨域/代理功能是否符合业务需求。
2. 完成单元/集成测试后，进行 **灰度发布**，监控日志和性能指标（页面加载时间、代理请求成功率）。
3. 若无异常，可逐步扩大到全量用户。

总体而言，fish2018/webhtv 已具备在生产环境中使用的技术基础，关键在于做好安全审计、版本锁定以及灰度验证后即可投入业务。

实际用途

fish2018/webhtv helps add AI capability without starting from a blank model stack.

• prototype AI features
• build RAG or agent workflows
• evaluate model tooling

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.