红果电脑客户端安装与更新助手

红果电脑客户端安装与更新助手#

帮助用户选择系统对应的安装包，通过作者国内站下载并核对版本、大小和 SHA-256，再按用户要求安装或更新。

本技能只有文字说明和已核对版本记录，不包含 EXE、应用程序、下载脚本或影视内容。需要联网；下载、解压及安装会写入用户指定目录。第三方客户端未开源，其软件版权和许可独立于本指引；本指引的 MIT 许可不授予软件或剧集的再分发权。

来源和可用入口#

• 发布者：洋滨，GitHub 账号 yangbin1322。
• 原发行仓库：https://github.com/yangbin1322/hongguo-player
• 作者国内下载页：https://hongguo.235698.xyz/download
• GitHub 正式版本元数据：https://api.github.com/repos/yangbin1322/hongguo-player/releases/latest
• Windows 最新版入口：https://hongguo.235698.xyz/download/latest/windows-amd64
• macOS 最新版入口：https://hongguo.235698.xyz/download/latest/darwin-universal

优先读取 已核对版本记录。它记录包版本、固定下载地址、发行页资产的大小和 SHA-256。其中验证日期和运行验证范围必须如实传达；快照不是“永远最新版”。

安装流程#

1. 确认操作系统、芯片架构以及新装或更新。当前作者标注支持 Windows 10/11 x64；macOS 的 Intel 和 Apple Silicon 使用同一个 universal ZIP。其他系统/架构不能擅自替代。
2. 查看作者下载页的当前版本。若与记录相同，使用记录中的固定版本地址和指纹；若不同，走下面的“发现新版本”流程。查不到最新状态时，可以提供已核对的固定版本，并明确没有确认它是否最新。
3. 向用户说明：这是非红果官方的第三方、未公开源码的软件；来自谁、版本是多少、计划保存到哪里。Windows 包可能联网补装 WebView2、安装 HEVC 扩展；首次运行会启动本地播放服务并联网获取内容。软件未签名，可能被系统拦截。本技能不证明 EXE 安全或播放可用。取得用户下载/安装授权；已有明确授权时按范围继续，不重复询问。
4. 下载到系统临时目录或用户指定的下载目录。用固定版本地址，记录下载前选定的版本、资产名称、预期字节数和 SHA-256。只接受 HTTPS，不把用户令牌、Cookie 或代理口令发送到下载站。
5. 下载后同时检查大小、SHA-256 和 ZIP 格式。HTML 错误页、大小不符或 hash 不符时停止；不解压，不执行，也不把实际下载算出的 hash 当作可信预期值。告知具体不一致，并保留原来可用版本。
6. 核对 ZIP 路径不含绝对路径、..、盘符和逃逸链接后，在临时目录解压。新安装复制到用户选定的应用目录，不覆盖同名目录。Windows 应使用完整 ZIP；单独的 .exe 是作者的更新资产，不替代初次安装包。
7. 用户授权运行后才启动应用；需要管理员权限、安装系统组件或被系统安全策略拦截时，交由用户决定。不要自动关防护、加白名单、移除 macOS 隔离标记或关闭 Gatekeeper。软件登录由用户在应用内完成，不向用户索取密码或验证码。
8. 告知版本、保存位置、来源、实际下载 SHA-256 和尚未验证的事项。若用户要求记录安装信息，在应用目录以外保存版本、资产名、SHA-256、来源和安装路径，不保存凭据或观看历史。

作者站可能跳转到外部文件 CDN：已观察到 Windows 固定版本下载转向 zip2.webgetstore.com。它不是 GitHub。下载域名本身不是信任证明，仍以从发行记录独立取得的版本和指纹为准；意外登录页、收费页或要求执行额外工具时停止。

发现新版本：动态查询，固定下载#

不要把 /latest/ 当作文件身份。它可能在查询与下载之间改变。

1. 从作者站发现候选版本，再从固定账号的 GitHub Releases API 获取正式版本。使用明确的 User-Agent。读取 tag_name、draft、prerelease 和 assets；默认选择非草稿、非预发布版本，不比较字符串大小猜版本先后。
2. 根据系统匹配 ZIP 资产，取得 name、size、digest；digest 必须形如 sha256:<64位十六进制>。也可使用作者可信发行页独立公布的该资产 SHA-256。仅从下载 CDN 同时取包和 hash 不构成独立核对。
3. GitHub 这里只读取小体积版本信息，软件本体走国内下载。元数据接口访问失败时，保留并可安装记录中已核对的旧版，清楚说明最新状态未核实；不要静默安装未知新版，也不要自动挑陌生 GitHub 加速站。
4. 从作者当前下载页取得该版本的固定国内链接。先确认协议、域名、版本、系统和资产名；不要仅根据旧版 URL 模板推断一个不存在的链接。GitHub 元数据与作者页面版本不一致时等待同步，或明确提供已核对的旧版，不混用新包和旧 hash。
5. 下载完整文件后对照独立预期 hash 和大小。如果新版缺少可信指纹，告诉用户当前无法核对，提供作者原下载页由用户自行判断，不自动执行未知文件。
6. 验证成功才给当前用户保存新的本地版本记录；不要修改已安装 Skill 中的平台证据，或宣称灵栈已经审核外部新版本。公开技能的固定版本记录由维护者另发新版更新。

更新已安装的软件#

• 用户说“检查更新”只查询版本，不自动下载和安装。用户已要求“更新到新版”时，可以按前述核对流程执行授权范围内的操作。
• 核对已安装版本与路径，提醒保存工作并正常退出客户端。用全新的目录暂存完整新包；保留旧程序及相关用户资料，未经授权不删除缓存、观看记录或系统组件。
• 文件核验通过后才替换用户授权的应用文件。替换失败停止并说明，保留旧版。更新完成后先确认程序能启动，再由用户确认播放是否正常；安装成功不等于播放已验证。
• 程序自己提示有更新时，优先帮助用户核对作者版本信息；不自动点击弹窗或把程序内更新当成已经完成 hash 核验。

使用示例#

用户：“我想在 Windows 电脑上看红果，帮我装一下。”

先说明所选第三方客户端与系统条件，按授权从作者国内站下载固定版本、核对文件、解压并引导启动；不把安装程序放进技能目录，不下载剧集。

用户：“国内站显示新版，但 GitHub 打不开怎么办？”

说明暂时不能核对新版身份；提供已记录指纹的旧版及其固定下载链接，或让用户自行通过作者页面处理新版。不把“下载成功”当成“可信新版验证通过”。

用户：“链接更新了，直接覆盖就行吧？”

先取得新版资产对应的可信 hash，再下载核对；保留旧版及用户资料，核验失败就停止，不尝试关闭安全限制。