Skip to content

SyncWatch同步观影 v2.1.8

Choose a tag to compare

View all tags
@xuange6610 xuange6610 released this 19 Aug 18:05
· 96 commits to main since this release
v2.1.8
562d52c

和朋友、家人、情侣远程一起看电影。v2.1.8 提供 Windows 一键安装与便携运行、Android 通用 APK，以及由真实 macOS runner 构建的 Intel / Apple Silicon 客户端、服务器和完整离线包。

第一次使用请立即修改默认管理员密码，并先在局域网完成连接测试，再开启公网访问。

下载文件 版本标识 最适合谁 一句话说明
SyncWatch-Experience-Client-Portable-v2.1.8-x64.exe 体验版 Windows 普通成员 连接已有服务器，不在本机启动服务端
SyncWatch-Standard-Server-Portable-v2.1.8-x64.exe 标准版 不想安装的 Windows 房主 内置运行环境和 cloudflared，绿色便携运行
SyncWatch-v2.1.8-Full-Offline-Installer-x64.exe 完整版 需要离线全平台下载中心的 Windows 房主 安装向导、完整服务器运行时，并离线内嵌 Windows、Android 与 macOS 发布文件
SyncWatch-v2.1.8-Full-Offline-Portable-x64.exe 完整版 不想安装的 Windows 房主 独立 EXE，直接双击运行；功能和离线资源与安装完整版相同
macOS Intel 完整版 DMG / ZIP 完整版 Intel Mac 房主 x64 完整服务器、cloudflared 和全平台离线下载中心
macOS Apple 芯片完整版 DMG / ZIP 完整版 Apple Silicon 房主 arm64 完整服务器、cloudflared 和全平台离线下载中心
cloudflared Windows x64 MSI / x86 MSI 公网工具 需要手工安装 Tunnel 的 Windows 用户 双击 MSI 安装，不要双击命令行 EXE；安装后运行 cloudflared --version
Node.js Windows x64 MSI / Windows ARM64 MSI / macOS Intel PKG / macOS Apple 芯片包 开发环境 源码开发或独立服务器用户 安装后运行 node --version；正式 SyncWatch EXE 已内置运行环境，无需另装 Node.js

v2.1.8 更新公告

v2.1.8 是本项目当前最新版本，面向 Windows、Android、macOS 与独立服务器用户。此次发布重点解决版本标识不一致、Android 服务端构建与登录协议兼容性、发布包校验和文档入口不同步问题。

版本范围声明

本次是从 v2.1.7 到 v2.1.8 的兼容更新，不是重新定义产品。房间、同步播放、媒体上传、聊天、弹幕、语音、屏幕/网页共享、权限模型、数据目录、启动方式和主要页面结构继续沿用 v2.1.7；已有账号、房间、媒体和配置不需要因为升级而重建。以下清单只记录实际发生的修复、版本迁移、可访问性微调、构建流程和发布文件变化。

完整变更清单

1. 版本与兼容标识

  • 根目录 package.json 从 2.1.7 更新为 2.1.8；Electron 服务器、独立客户端、独立服务器和公开配置均返回/显示 v2.1.8。
  • Android versionName 更新为 2.1.8，versionCode 更新为 20108；WebView User-Agent、手机服务器下载元数据和 APK 下载文件名同步更新。
  • 首次登录使用协议默认版本、发现服务广播版本、媒体管理导出 JSON、服务器 JSON/二进制备份文件名统一使用 2.1.8。
  • Windows 安装版、Windows 便携完整版、体验版、标准版、客户端、服务端和独立服务器 ZIP 的文件名与构建契约统一为 v2.1.8；旧的 v2.1.7 文件不会被新构建覆盖后继续冒充新包。
  • 仓库、Pages、Wiki、Release 和下载入口统一使用当前 GitHub 地址 xuange6610/SyncWatch；仓库 slug 仍保持 SyncWatch，产品显示名称仍为 SyncWatch同步观影。

2. Android 登录与错误诊断

  • 修复部分 Node.js Mobile 18 构建缺少 crypto.randomUUID 时，游客账号创建、登录审计或设备会话在服务端直接异常的问题；服务端现在使用符合 UUID v4 的 crypto.randomBytes 回退，桌面 Node/Electron 仍优先使用原生实现。
  • 修复 Node.js Mobile 18.20.4 未编译 Intl 时，成员进入/退出房间通知调用 Intl.DateTimeFormat 导致 guest-login 返回 SOCKET_EVENT_FAILED 的问题；服务端现在在 Intl 不可用时输出稳定的 YYYY/MM/DD HH:mm:ss 本地时间，并复用于媒体操作和播放申请提示。
  • 普通账号、游客、服务器管理员登录失败统一经过 loginErrorMessage(result)，不再只显示“服务器处理请求失败”。
  • Socket 处理异常现在包含安全的 SOCKET_EVENT_FAILED、事件名和 SW-... 错误编号；客户端根据编号给出数据目录可写、设备时间、重新连接和联系管理员等处理建议。
  • 服务端日志保留完整堆栈并关联同一个错误编号，但不会把堆栈或敏感内容发送到 Android/Web 客户端。
  • 登录初始化网络异常会显示明确的连接失败信息和错误提示，不再显示没有行动指引的“正在自动重试”。

3. 页面与交互的兼容性微调

  • 短屏横向窗口中展开聊天时，播放器和聊天栏保持双列布局，避免移动端规则把聊天栏压到视频边缘。
  • 增强下拉框保留确定性的原生指示器，禁用状态仍可被辅助技术识别；不改变已有字段、选项或业务流程。
  • 账户、管理中心、播放器、截图/3D 文档页和下载入口的内容与主要导航保持 v2.1.7 结构；本版本没有新增“重新设计首页”或删除旧功能。

4. 发布与构建流程

  • Windows/macOS Actions 改为直接从 Cloudflare 官方 latest Release 获取匹配架构的 cloudflared，再执行体积检查；不再依赖当前 SyncWatch Release 中预先存在的同名工具资产。
  • Windows Release workflow 改为手动输入目标 tag 后执行，避免 Windows/macOS 完整包之间的跨平台资源依赖在 tag push 时并行触发，造成半成品 Release；Pages 和常规 CI 不受影响。
  • Windows Release runner 先构建并上传已签名 Android APK，再把真实 APK、Windows 客户端和 macOS ZIP 放入离线完整版；离线包验证会检查六个平台资源、最小体积和文件闭包。
  • Windows、macOS 和 Android 构建脚本、Electron Builder 配置、独立服务器打包脚本以及发布契约测试全部切换到 2.1.8，并禁止构建阶段隐式发布或把旧资产当作新资产。
  • 由于当前工作站为 Windows，macOS DMG/ZIP 只能以 macOS runner 实际产物为准；没有真实资产时，下载接口返回“尚未提供”，不会生成伪造链接。

5. 测试与验收

  • 更新前端、服务端、Android、独立服务器、macOS 下载、Tunnel、平台契约和 Release 文件名测试中的版本期望。
  • 新增普通账号登录错误编号和 SOCKET_EVENT_FAILED 的前端契约断言。
  • 新增 tests/android-node-compat.test.js，主动移除原生 crypto.randomUUID 和全局 Intl 后启动完整服务，并验证管理员、同房游客、成员退出通知和游客重新登录。
  • 在 Android 15 sdk_gphone64_x86_64 模拟器中安装签名 APK，真实启动 APK 内嵌 Node.js Mobile 服务，并通过 ADB 端口转发连接该服务验证管理员、同房游客和游客重连；测试后应用主进程与 syncwatch_server 进程均保持运行。

与 v2.1.7 保持不变

  • 同步播放权威时钟、房间密码/人数限制、成员与权限组、媒体审核/队列、聊天/私聊/弹幕、语音、屏幕共享、邮件验证、备份恢复和管理中心 11 个模块的业务规则不变。
  • 默认数据目录仍为 SyncWatch同步观影-Data/，升级仍需停止服务并备份整个目录；同一目录仍只允许一个实例写入。
  • Windows 服务器 EXE 仍内置 Node/Electron、FFmpeg、FFprobe 和 cloudflared；体验版仍只连接已有服务器，标准版仍用于 Windows 房主，完整版仍用于离线资源分发。
  • Android 仍不能在 APK 内直接运行 Windows/Linux 的 cloudflared；手机公网使用场景仍需连接已开启 Tunnel 的桌面、macOS、Linux 或云服务器。
  • Apache-2.0 许可证、xuan 署名、数据保护要求和外部贡献流程不变。

Android 登录错误修复

  • 普通账号登录此前直接显示服务端笼统的“服务器处理请求失败”，没有调用已有错误解析器；现在统一调用 loginErrorMessage(result)。
  • 当服务端返回 SOCKET_EVENT_FAILED 时，安卓 WebView 与桌面网页都会显示事件名称、SW-... 错误编号、数据目录/设备时间/重新连接建议，并通过 toast 重复提示一次。
  • 服务端仍只向客户端发送安全错误编号，不泄露堆栈；真实异常继续写入服务器日志，管理员可按错误编号检索。
  • 登录初始化网络异常也改为明确的连接失败提示，不再显示“正在自动重试”但没有下一步的模糊文案。

登录修复验证记录

  • node tests/frontend-v205.test.js：通过，普通账号登录错误编号契约有效。
  • node tests/ui-layout.test.js：通过，顶部播报布局无回归。
  • node tests/android-package.test.js --source-only：通过，生产依赖与 Android 源代码契约完整。
  • node tests/integration.test.js：通过，54 项服务端/账户/房间/媒体/权限/同步集成检查全部通过。

Android 更新

  • Android versionName 已统一为 2.1.8，versionCode 为 20108。
  • APK 使用 Node.js Mobile 18.20.4，并包含 SyncWatch 服务端运行所需的生产依赖和静态资源。
  • 通用 APK 已验证包含 arm64-v8a、armeabi-v7a 与 x86_64 三种 ABI，可覆盖常见 ARM 手机、32 位 ARM 设备和 x86_64 模拟器。
  • 构建脚本会检查 APK badging、版本号、ABI、Node.js 运行时、生产包数量和前端资源，避免“能安装但缺少服务文件”的不完整包。
  • Android 本机服务支持本机访问以及同一 Wi-Fi/热点内的局域网访问；WebView 登录、房间、播放同步、聊天和原生屏幕共享桥接沿用同一套服务端协议。
  • 修正了 Android 运行时生成 mobile-index.js 时的 Unicode 用户名正则和 path-to-regexp 兼容补丁，避免部分账号或路由在手机端启动失败。
  • 修复 Socket 处理异常只返回笼统提示的问题：服务端日志现在带事件名和错误编号，客户端收到安全错误码，安卓登录失败时可将编号交给管理员定位；堆栈不会发送给客户端。
  • 修复 Windows PowerShell 构建脚本的 UTF-8 编码标记，避免中文 APK/客户端文件名在 Windows PowerShell 下变成乱码并导致旧版本文件未被覆盖。
  • 修复 Node.js Mobile 无 Intl 时登录后广播成员在线状态直接抛出 ReferenceError: Intl is not defined 的真实根因；此前仅补充 UUID 回退不足以解决该故障。

公网访问边界

Android APK 不内置也不执行 Windows/Linux 的 cloudflared 二进制。Cloudflare 官方没有一个可以安全、通用地直接嵌入 Android APK 的同等运行包，因此不能把手机本机 Tunnel 宣称为已支持。手机用户需要连接一台已经在 Windows、macOS、Linux 或云服务器上启动并开启 Cloudflare Tunnel 的 SyncWatch 服务器；该连接路径支持公网登录和同步观影。Android 本机仍可正常启动服务器并在局域网使用。

桌面与服务器更新

  • 源码、公共配置、Dockerfile、构建脚本、下载入口、GitHub Pages 与 Wiki 当前版本统一为 2.1.8。
  • 修复旧版本硬编码 2.1.7 导致下载链接、运行时提示和发布说明显示旧版本的问题。
  • Windows/macOS 构建流程保留平台架构边界：Windows 桌面发布包提供 x64；macOS 通过 GitHub Actions 的 macOS runner 构建 Intel x64 与 Apple Silicon arm64。现代 Electron/macOS 不提供可验证的 32 位桌面包，因此不上传虚假的 32 位文件。
  • 完整包、标准包、体验包、独立服务器包和运行时资产必须使用真实构建产物；禁止仅修改旧文件名冒充新版本。

验证记录

本次已通过：

node tests/integration.test.js
node tests/account-v205-backend.test.js
node tests/android-package.test.js --source-only
Android APK Gradle build: BUILD SUCCESSFUL
APK payload: 124 production Node.js packages, 36 public files, 3 native ABIs
APK signing: v1/v2/v3 verified
Android 15 embedded server: admin login, guest login and guest reconnect passed
Android Logcat: 0 Intl/SOCKET_EVENT_FAILED/Node-exit/FATAL matches

本次已在 Android 15 模拟器中完成 APK 安装、手机服务器启动和登录协议实测。该证据覆盖 Node.js Mobile x86_64、WebView 宿主、管理员/游客登录、断开重连和进程存活；它不能替代小米 14/HyperOS 的通知权限、电池优化、后台保活和 ARM64 厂商 ROM 实机验证，因此发布说明不把厂商特有行为写成已经验证。

普通用户怎么选

体验版

  • 在线展示：打开 GitHub Pages，查看真实界面、功能截图和逐步教程。它是静态展示，不运行真实服务器。
  • Windows 客户端：下载体验版独立 EXE，适合成员连接已经运行的服务器，不在本机启动服务端。

标准版与完整版

  • Windows 标准服务器：下载标准版独立 EXE，双击启动，无需安装 Git、Node.js 或 npm。
  • Windows 安装完整版：下载安装程序，提供安装、卸载、桌面快捷方式、开始菜单和完整离线下载资源。
  • Windows 独立 EXE 完整版：下载便携完整版，无需安装，放在普通文件夹后直接双击，功能和内嵌跨平台资源与安装完整版一致。
  • Android 完整 APK：下载通用 APK，可加入房间，也可在受支持设备上运行手机服务器。

跨平台完整套装

完整版把已真实构建的离线下载资源放进 Windows/macOS 房主端。房主启动 SyncWatch 后，成员可以从登录页或账号菜单下载适合自己设备的文件：

  1. Windows 成员下载客户端 EXE。
  2. Android 成员下载通用 APK。
  3. Intel Mac 成员下载 x64 客户端。
  4. Apple Silicon Mac 成员下载 arm64 客户端。
  5. Mac 房主下载对应架构的服务器包。
  6. 临时公网访问优先使用服务器内置的 cloudflared；独立工具资产用于手工部署、诊断和修复。

管理中心的“通知/通告设置”可以隐藏 Windows、macOS、Android 和服务器下载按钮，但隐藏入口不会从完整版中删除文件。升级或迁移前请停止服务并备份完整的 SyncWatch同步观影-Data/。

一键运行包含什么

Windows 正式服务器包内置 Electron/Node.js 运行时、应用前后端、生产依赖、Socket.IO、FFmpeg、FFprobe 和 Windows cloudflared。启动时会初始化数据目录、读取配置、检查端口、启动 HTTP/WebSocket 服务、显示局域网地址并打开应用窗口。

同一数据目录只允许一个实例写入。连续双击时，后启动的实例会提示已有进程，而不会创建两个服务器同时写数据。不同目录运行互不影响。

macOS

macOS 客户端、服务器和完整离线版均提供 Intel x64 与 Apple Silicon arm64：

  • Intel 客户端：DMG / ZIP
  • Apple Silicon 客户端：DMG / ZIP
  • Intel 服务器：DMG / ZIP
  • Apple Silicon 服务器：DMG / ZIP
  • Intel 完整版：DMG / ZIP
  • Apple Silicon 完整版：DMG / ZIP

这些产物由 GitHub Actions 的真实 macos-14 runner 分架构构建，并执行文件大小、SHA-256 和隐私字符串检查。现代 macOS 与 Electron 不支持 32 位应用，因此不提供虚假的 macOS 32 位包。

架构支持边界

  • Windows 正式桌面包：x64。当前 Electron 41 和媒体工具发布链没有提供完整验证的 Windows 32 位组合。
  • Android 通用 APK：包含 armeabi-v7a（32 位）、arm64-v8a 和 x86_64。
  • macOS：Intel x64 与 Apple Silicon arm64，无现代 macOS 32 位。
  • 独立服务器：以 Node.js 22+ 对目标系统和架构的官方支持为准。

cloudflared 独立工具

cloudflared 是 Cloudflare Tunnel 连接器，用于把本机 HTTP、Socket.IO 和媒体 Range 请求转发为 HTTPS 公网入口。它不保存 SyncWatch 账号或影片。完整服务器包优先使用内置文件；独立工具用于手工部署和网络诊断。官方文档：Cloudflare Tunnel。

Node.js 官方环境包

Windows 正式 EXE 已内置运行时，不需要另装 Node.js。源码开发和独立服务器用户可下载：

安装后在终端执行 node --version 和 npm --version 验证。Node.js 官网：nodejs.org。完整图文教程见 cloudflared 与 Node.js 安装使用教程。

本次构建产物与数量

v2.1.8 完整发布严格沿用 v2.1.7 的资产标准：Release API 有 26 个手动资产；加上 GitHub 自动生成的两个源码归档，页面共显示 28 个文件。所有资产必须是真实构建或经哈希核对的官方运行时，不用改名旧版本或空文件凑数，也不增加重复用途的额外文件。

所有下载文件以 GitHub Release 页面展示的大小和 SHA-256 为准。Android v2.1.8 通用 APK 大小为 161,259,430 字节，SHA-256 为 368470D69AB413C24997AE5B86646796B9669FF84CC5EB9F7A61DBBE86AC4F7C。

已知限制

  1. Android 本机不能直接运行 cloudflared；请使用桌面或云服务器 Tunnel。
  2. macOS 32 位桌面包不存在于现代系统和 Electron 支持矩阵中，因此仅提供 x64 与 arm64。
  3. Android 15 模拟器验证不等同于小米/HyperOS 真机验证；厂商 ROM 的权限弹窗、后台保活和屏幕共享授权仍需按 Wiki 的 Android 排错页检查电池优化、局域网权限和服务器地址。
Assets 28
Loading