wiina

项目概述

Wiina 不复刻 AppKit，而是把 IINA 的交互模型——浮动 OSC、侧栏快速设置、OSD 与模式状态机——按 Windows 11 Fluent 规范在 WinUI 3 里重做，播放内核交给 libmpv。界面是真正的 XAML，视频走 mpv 的 d3d11 合成，Sego e UI Variable、Mica 与亚克力、圆角与深浅主题全部跟随系统。约 100 MB 的安装包自带 .NET 10、Windows App Runtime、libmpv 0.41 与解码能力，装完即播，首次打开就是 d3d11va 硬解。

IINA 的手感，Windows 11 的原生质感。

项目	内容
平台	Windows 10 2004+（build 19041）与 Windows 11，x64
技术栈	WinUI 3 + libmpv + C# / .NET 10
安装包	约 100 MB，自带运行时与解码器
许可证	GPL-3.0-only
测试	xUnit 943 项通过

主要功能

• 浮动 OSC：可拖动、可停靠、可记忆位置，鼠标静止自动隐去，5 px 内手抖不唤醒，悬停进度条有精确缩略图
• 毛玻璃与纯色：OSC 与 OSD 支持「固定 / 动态 / 始终 / 纯色」四档，毛玻璃把视频帧模糊后垫在控件下，纯色档零抓帧低配最省
• 记忆播放：欢迎窗口列出最近播放与上次进度，一键续播，每文件独立记录位置
• 设置搜索：11 页设置支持中英文关键词直达，输「字幕」定位字号边框，改完即时生效
• 快捷键方案：内置 Wiina（IINA 习惯 79 键）与 mpv 两套，可录制、冲突检查、导入导出
• 画质调节：23 项 mpv 参数按缩放、色度、抖动、去色带、插帧、同步分组，标注原始键名，支持 JSON 档案
• 缩略图：预生成 23 分钟视频约 30 秒建完索引，或切即时预览 250 ms 防抖，磁盘 LRU 缓存可调
• 智能字幕：同集外挂字幕自动入列、assfonts 优先、双字幕，手动选过的不被覆盖
• 系统集成：打开 URL 播 HLS 流媒体，文件关联可一键写入并随卸载恢复

界面与操作

• 快速设置侧栏：Shift+Alt+V 视频、A 音频、S 字幕、P 播放列表
• 播放控制：Space 播放暂停，方向键 5 秒步进（Ctrl 30 秒），Enter 全屏，Ctrl+S 截图
• 小窗模式：Ctrl+Shift+P 进无边框画中画，快捷键与主窗一致，贴边吸附
• 主题：深浅色跟随系统，Mica、亚克力与 Windows 重点色实时响应

快速上手

1. 从 Releases 下载便携 zip 或安装版 exe，便携版解压即用、自带卸载清理工具
2. 打开文件即播，GPU 支持时默认 d3d11va 硬解，不支持自动回退软解
3. 按需在设置里搜「缓存」「硬解」等关键词微调
4. 首次运行若遇 SmartScreen 拦截，点「更多信息 → 仍要运行」，发布页附 SHA-256

系统要求

项目	要求
操作系统	Windows 10 2004+ / 11，x64
运行时	.NET 10 与 Windows App Runtime 随包内置
仓库结构	Wiina.App 外壳、Wiina.Core 逻辑、Wiina.Mpv 绑定、Wiina.Uninstall 卸载器

注意事项

• 未签名：无代码签名，SmartScreen 提示属预期
• 架构分层：Core 为纯逻辑库，Mpv 负责绑定与播放器封装，界面与逻辑分离便于测试
• 路线图：mpv 插件系统与 IINA 插件兼容层在下一版本
• 文档齐备：架构决策、IINA 复刻规格、缩略图逻辑、快捷键对照、性能分析都在 docs/ 下