修复 Windows 构建与移植性问题

- CMakeLists: 移除硬编码的本机 PKG_CONFIG_PATH(M:/msys64),改由
  PKG_CONFIG_PATH/CMAKE_PREFIX_PATH 提供;MinGW64 shell 下自动发现
- CMakeLists: Windows 下对 vlc_threads.h 的 vlc_poll() 隐式 poll 声明
  降级为警告(GCC 14+ 默认报硬错误),该 inline 插件不会调用
- usm_vlc_video: 试 key 解密改用堆分配,去掉栈上 VLA(帧大小来自文件,
  超大帧会爆栈)
- usm_keys: Windows 默认 key 文件路径改用 %APPDATA%\\vlc(官网版 VLC 配置位置)
- dll_entry.c: 补末尾换行
- README: 重写为 Linux/MSYS2 双平台说明,修正密钥路径,恢复构建/测试节

Author: clansty

CMakeLists.txt

@@ -4,8 +4,10 @@ project(vlc_plugin_usm C)
 set(CMAKE_C_STANDARD 11)
 set(CMAKE_C_STANDARD_REQUIRED ON)
 set(CMAKE_C_EXTENSIONS OFF)
-set(ENV{PKG_CONFIG_PATH} "M:/msys64/mingw64/lib/pkgconfig")
 
+# 从 MSYS2 MinGW64 shell 构建时 pkg-config 会自动找到 vlc-plugin/vpx。
+# 若在其它环境构建，通过环境变量 PKG_CONFIG_PATH 或 -DCMAKE_PREFIX_PATH 指定，
+# 不要在此处硬编码本机路径。
 find_package(PkgConfig REQUIRED)
 pkg_check_modules(VLC_PLUGIN REQUIRED vlc-plugin)
 pkg_check_modules(VPX REQUIRED vpx)
@@ -23,6 +25,10 @@ target_compile_options(usm_core PRIVATE -Wall -Wextra -Wpedantic)
 
 if(WIN32)
     list(APPEND PLUGIN_SOURCES src/dll_entry.c)
+    # VLC 的 vlc_threads.h 在 Windows 分支里有个 static inline vlc_poll()，它调用 POSIX
+    # poll()，而 mingw 只有 WSAPoll。该 inline 本插件不会调用（不会产生链接引用），但
+    # GCC 14+ 默认把“隐式声明 poll”当硬错误，导致仅含 VLC 头就编不过。降级为警告即可。
+    set(PLUGIN_WIN_C_FLAGS -Wno-error=implicit-function-declaration)
 endif()
 
 add_library(usm_plugin MODULE
@@ -38,7 +44,7 @@ set_target_properties(usm_plugin PROPERTIES
 )
 target_include_directories(usm_plugin PRIVATE ${VLC_PLUGIN_INCLUDE_DIRS} src)
 target_include_directories(usm_plugin PRIVATE ${VPX_INCLUDE_DIRS})
-target_compile_options(usm_plugin PRIVATE ${VLC_PLUGIN_CFLAGS_OTHER} -Wall -Wextra)
+target_compile_options(usm_plugin PRIVATE ${VLC_PLUGIN_CFLAGS_OTHER} -Wall -Wextra ${PLUGIN_WIN_C_FLAGS})
 target_link_libraries(usm_plugin PRIVATE usm_core ${VLC_PLUGIN_LIBRARIES} ${VPX_LIBRARIES})
 target_link_directories(usm_plugin PRIVATE ${VLC_PLUGIN_LIBRARY_DIRS} ${VPX_LIBRARY_DIRS})
 target_compile_definitions(usm_plugin PRIVATE _GNU_SOURCE MODULE_STRING="usm")

README.md

@@ -11,59 +11,107 @@ VP9 解码器播放。
 - 从默认 key 文件读取密钥，适合在文件管理器里双击打开。
 - 基于时间轴拖动进度。
 
-## 安装
+## 构建
+
+### Linux
+
+```sh
+cmake -S . -B build
+cmake --build build
+ctest --test-dir build --output-on-failure
+```
+
+### Windows (MSYS2 / MinGW64)
+
+在 MSYS2 的 **MINGW64** shell 里安装依赖并构建：
 
-构建完成后将libusm_plugin.dll放入以下路径：
+```sh
+pacman -S --needed mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake \
+    mingw-w64-x86_64-pkgconf mingw-w64-x86_64-ninja \
+    mingw-w64-x86_64-libvpx mingw-w64-x86_64-vlc
 
+cmake -S . -B build -G Ninja
+cmake --build build
+ctest --test-dir build --output-on-failure
 ```
-# VLC Windows版默认安装路径：
-C:\Program Files\VideoLAN\VLC\plugins\demux（经测试暂不可用）
 
-# MSYS2版VLC默认安装路径：
-C:\msys64\mingw64\lib\vlc\plugins\demux
+从 MINGW64 shell 构建时 `pkg-config` 会自动找到 `vlc-plugin` 和 `vpx`，无需手动配置
+路径。若在其它环境构建，用环境变量 `PKG_CONFIG_PATH` 或 `-DCMAKE_PREFIX_PATH` 指定。
+
+## 安装
+
+### Arch 包
+
+```sh
+cd packaging/arch
+PKGDEST=../.. makepkg -f
+cd ../..
+sudo pacman -U vlc-plugin-usm-0.1.0-3-x86_64.pkg.tar.zst
 ```
 
-安装后若不识别请手动删除 `plugins.dat` 并使用
+安装后 VLC 的插件缓存会由 pacman hook 自动更新。
+
+### Windows
+
+把构建出的 `libusm_plugin.dll` 放进 VLC 的 `plugins/demux` 目录：
+
+- MSYS2 版 VLC：`C:\msys64\mingw64\lib\vlc\plugins\demux\`
+- 官网版 VLC：`C:\Program Files\VideoLAN\VLC\plugins\demux\`
+
+> 注意：本插件依赖 libvpx，MSYS2 构建出的 DLL 会动态链接 `libvpx-1.dll` 以及
+> mingw 运行时（`libgcc_s_seh-1.dll`、`libwinpthread-1.dll`）。MSYS2 版 VLC 因为
+> 这些 DLL 在 `mingw64\bin`（已在 PATH 上）能正常加载；官网版 VLC 不自带这些 DLL，
+> 直接拷过去会因找不到依赖而静默加载失败。让官网版可用的方案仍在完善中。
+
+安装后若不识别，删除缓存 `plugins.dat` 并重建：
+
 ```powershell
-& "C:\Program Files\VideoLAN\VLC\vlc-cache-gen.exe" ./plugins
+& "C:\Program Files\VideoLAN\VLC\vlc-cache-gen.exe" "C:\Program Files\VideoLAN\VLC\plugins"
 ```
-重建缓存。~~（貌似没用）~~
 
 ## 配置密钥
 
-~~推荐把 key 写到默认配置文件里，这样双击文件打开时也能自动解密：~~
+推荐把 key 写到 VLC 配置目录下的默认文件里，这样双击文件打开时也能自动解密。
+
+Linux：
 
 ```sh
 mkdir -p ~/.config/vlc
 printf '0x7F4551499DF55E68\n' > ~/.config/vlc/usm-keys.txt
 ```
 
-~~默认读取顺序：~~
+Windows（官网版 VLC）：
+
+```powershell
+New-Item -ItemType Directory -Force "$env:APPDATA\vlc" | Out-Null
+Set-Content "$env:APPDATA\vlc\usm-keys.txt" "0x7F4551499DF55E68"
+```
 
-~~1. `$XDG_CONFIG_HOME/vlc/usm-keys.txt`~~
-~~2. `~/.config/vlc/usm-keys.txt`~~
+默认读取顺序：
 
-~~key 文件支持十进制或 `0x` 前缀的十六进制；多个 key 可以用逗号、分号、
-空白或换行分隔。`#` 后面的内容会当作注释。~~
-（Windows下未经测试）
+- Windows：`%APPDATA%\vlc\usm-keys.txt`
+- Linux：`$XDG_CONFIG_HOME/vlc/usm-keys.txt`，否则 `~/.config/vlc/usm-keys.txt`
 
+key 文件支持十进制或 `0x` 前缀的十六进制；多个 key 可以用逗号、分号、空白或换行
+分隔。`#` 后面的内容会当作注释。配置多个 key 时，插件会用 libvpx 试解码自动选出
+能正确解密的那个。
 
 也可以启动时临时传 key：
 
+```sh
+vlc --usm-keys 0x7F4551499DF55E68 /path/to/movie.dat
+```
+
 ```powershell
-& "\path\to\vlc\vlc.exe" --usm-keys 0x7F4551499DF55E68 \path\to\movie.dat
+& "C:\Program Files\VideoLAN\VLC\vlc.exe" --usm-keys 0x7F4551499DF55E68 C:\path\to\movie.dat
 ```
 
 或者指定一个自定义 key 文件：
 
-```powershell
-& "\path\to\vlc\vlc.exe" --usm-key-file \path\to\usm-keys.txt \path\to\movie.dat
+```sh
+vlc --usm-key-file /path/to/usm-keys.txt /path/to/movie.dat
 ```
 
-## 构建
-~~我不知道，我用vscode cmake插件构建的~~
-构建前请先修改 `CMakeList' 中的 'set(ENV{PKG_CONFIG_PATH} "")` 为你自己的 `pkgconfig` 路径
-
 ## 已知限制
 
 - 当前只输出视频流，没有输出音频流。

src/dll_entry.c

@@ -13,4 +13,4 @@ BOOL WINAPI DllEntryPoint(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved
     return TRUE;
 }
 
-#endif
+#endif

src/usm_keys.c

@@ -90,6 +90,13 @@ char *usm_default_key_file_path_from_env(const char *xdg_config_home,
 
 char *usm_default_key_file_path(void)
 {
+#ifdef _WIN32
+    // 官网版 VLC 把用户配置放在 %APPDATA%\vlc\，优先使用
+    const char *appdata = getenv("APPDATA");
+    if (appdata != NULL && appdata[0] != '\0') {
+        return join_key_file_path(appdata, "\\vlc\\usm-keys.txt");
+    }
+#endif
     return usm_default_key_file_path_from_env(getenv("XDG_CONFIG_HOME"), getenv("HOME"));
 }
 

src/usm_vlc_video.c

@@ -5,6 +5,7 @@
 #include <vpx/vpx_decoder.h>
 
 #include <inttypes.h>
+#include <stdlib.h>
 #include <string.h>
 
 static bool payload_needs_decrypt(size_t payload_size)
@@ -52,19 +53,26 @@ static bool decrypted_frame_decodes(demux_t *demux, size_t key_index,
                                     block_t *payload,
                                     const usm_decryption_keys_t *keys)
 {
-    uint8_t trial[payload->i_buffer];
+    // 用堆而非栈上 VLA：payload 大小来自文件，超大帧会爆栈
+    uint8_t *trial = malloc(payload->i_buffer);
+    if (trial == NULL) {
+        return false;
+    }
     memcpy(trial, payload->p_buffer, payload->i_buffer);
     usm_decrypt_video(trial, payload->i_buffer, keys);
 
     const uint8_t *frame_data = NULL;
     size_t frame_size = 0;
     uint64_t timestamp = 0;
-    if (!usm_ivf_parse_payload_frame(trial, payload->i_buffer, &frame_data,
-                                     &frame_size, &timestamp)) {
-        return false;
-    }
-    demux_sys_t *sys = demux->p_sys;
-    return probe_decode_frame(&sys->key_probes[key_index], frame_data, frame_size);
+    bool ok = false;
+    if (usm_ivf_parse_payload_frame(trial, payload->i_buffer, &frame_data,
+                                    &frame_size, &timestamp)) {
+        demux_sys_t *sys = demux->p_sys;
+        ok = probe_decode_frame(&sys->key_probes[key_index], frame_data,
+                                frame_size);
+    }
+    free(trial);
+    return ok;
 }
 
 static bool select_matching_key(demux_t *demux, block_t *payload)