<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>游戏串流 on 我的博客</title><link>https://blog.5616760.com/tags/%E6%B8%B8%E6%88%8F%E4%B8%B2%E6%B5%81/</link><description>Recent content in 游戏串流 on 我的博客</description><generator>Hugo -- gohugo.io</generator><language>zh</language><lastBuildDate>Sat, 07 Nov 2026 21:25:00 +0800</lastBuildDate><atom:link href="https://blog.5616760.com/tags/%E6%B8%B8%E6%88%8F%E4%B8%B2%E6%B5%81/index.xml" rel="self" type="application/rss+xml"/><item><title>7,816 Star 的 Sunshine 魔改版：把 HDR、虚拟屏、DualSense 和 LLM 码率控制塞进同一个串流栈</title><link>https://blog.5616760.com/0071.html</link><pubDate>Sat, 07 Nov 2026 21:25:00 +0800</pubDate><guid>https://blog.5616760.com/0071.html</guid><description>&lt;p&gt;&lt;img alt="图：Foundation Sunshine 官方封面——让游戏串流更优雅" loading="lazy" sizes="(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px" src="https://blog.5616760.com/img/0071-001.png"&gt;&lt;/p&gt;&#10;&lt;p&gt;Sunshine 是把 Windows 电脑变成游戏串流主机的开源服务端，配合 Moonlight 客户端远程用桌面、应用和游戏。&lt;strong&gt;Foundation Sunshine&lt;/strong&gt; 是它的一个深度魔改分支：HDR 全链路、虚拟显示器、环绕声与麦克风透传、DualSense 原生反馈、独立桌面 GUI，全部塞进同一个二进制。&lt;/p&gt;&#10;&lt;p&gt;项目：https://github.com/AlkaidLab/foundation-sunshine（7,816 Star · 227 Fork · GPL-3.0 · C++）&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;本文所有数字均为 2026-11-07 通过 GitHub REST API 与仓库文件树实测，非引用二手报道。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="01--硬数据"&gt;01 · 硬数据&#10;&lt;/h2&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;维度&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;实测值&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;备注&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Star / Fork&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;7,816 / 227&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Star/Fork 比 34:1，围观远多于分叉&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Watchers（subscribers）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;17&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;极低，社区尚未形成回路&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;建库 / 最近 push&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2023-02-06 / 2026-11-07&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;存续 3 年 9 个月&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Commit 总数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;约 3,395&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;含继承的上游历史&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;近 52 周 commit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;679&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;平均每周 13 次&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;贡献者&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;144&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;前 10 位占 86.4%&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Release 总数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;70（64 正式 / 6 预发布）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;累计下载 599,804 次&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;单个版本最高下载&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;36,603（v2026.324）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2026-03-24&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Issue / PR&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;476 / 732&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;当前 62 open issue、34 open PR&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;仓库文件&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1,370 个 blob / 23.6 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;342 个 &lt;code&gt;.cpp&lt;/code&gt;、292 个 &lt;code&gt;.h&lt;/code&gt;、71 个 &lt;code&gt;.hlsl&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;许可证&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;GPL-3.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;与上游一致，商业分发受限&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;贡献者排行里有个容易被误读的地方：&lt;/p&gt;&#10;&lt;pre tabindex="0"&gt;&lt;code&gt;ReenigneArcher 769 ← 上游 Sunshine 维护者&#10;qiin2333 619 ← 本项目主导者&#10;loki (anon) 478&#10;cgutman 407 ← 上游 moonlight-common-c 作者&#10;Yundi339 183&#10;dependabot[bot] 169&#10;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;前四名里有三个是&lt;strong&gt;上游项目的人&lt;/strong&gt;。这说明仓库保留了完整的 Sunshine 提交历史——它不是从零起飞，而是在一条 4.3 万 star 的干流上开了条支渠。真正的&amp;quot;基地&amp;quot;自己的量，是 qiin2333 与 Yundi339 的合计 802 次提交。&lt;/p&gt;&#10;&lt;p&gt;对比上游 LizardByte/Sunshine：43,106 Star、615 个文件、32.2 MB。Foundation 的文件数是上游的 &lt;strong&gt;2.2 倍&lt;/strong&gt;，&lt;code&gt;.cpp&lt;/code&gt; 是 &lt;strong&gt;2.4 倍&lt;/strong&gt;（342 vs 143）——增量几乎全在 Windows 平台能力上。&lt;/p&gt;&#10;&lt;h2 id="02--它到底加了什么"&gt;02 · 它到底加了什么&#10;&lt;/h2&gt;&lt;p&gt;上游 Sunshine 是一次&amp;quot;捕获 → 编码 → 传输&amp;quot;的通用实现。Foundation 在这条链路的&lt;strong&gt;每一个环节&lt;/strong&gt;都插了东西：&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart LR&#10; subgraph HOST["被控端 Windows"]&#10; direction TB&#10; VDD["ZakoDisplay 虚拟屏&lt;br/&gt;HDR / 自定义分辨率"]&#10; CAP["捕获&lt;br/&gt;Zako Direct / WGC / DDAPI"]&#10; SHADE["71 个 HLSL 着色器&lt;br/&gt;色彩转换 + 缩放"]&#10; ENC["编码&lt;br/&gt;NVENC / AMF / QSV / libx264"]&#10; FEC["RS FEC 控制器&lt;br/&gt;10 秒窗口 + 二项尾概率"]&#10; ABR["ABR 决策&lt;br/&gt;阈值回退 + LLM 目标"]&#10; OUT["RTP 视频 + ENet 控制通道"]&#10; end&#10; subgraph CLIENT["控制端 Moonlight"]&#10; DEC["硬件解码"]&#10; DV["Dolby Vision / HDR10+ / Vivid 引擎"]&#10; end&#10; VDD --&gt; CAP --&gt; SHADE --&gt; ENC --&gt; FEC --&gt; ABR --&gt; OUT&#10; OUT --&gt;|"局域网 / 公网"| DEC --&gt; DV&#10; style VDD fill:#1f6feb,stroke:#1f6feb,color:#fff&#10; style CAP fill:#1f6feb,stroke:#1f6feb,color:#fff&#10; style SHADE fill:#8957e5,stroke:#8957e5,color:#fff&#10; style ENC fill:#8957e5,stroke:#8957e5,color:#fff&#10; style FEC fill:#da3633,stroke:#da3633,color:#fff&#10; style ABR fill:#da3633,stroke:#da3633,color:#fff&#10; style OUT fill:#238636,stroke:#238636,color:#fff&#10; style DEC fill:#9e6a03,stroke:#9e6a03,color:#fff&#10; style DV fill:#9e6a03,stroke:#9e6a03,color:#fff&lt;/pre&gt;&lt;p&gt;模块清单（按 &lt;code&gt;src/&lt;/code&gt; 目录实测）：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;目录&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;职责&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;上游有吗&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/hdr/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;客户端显示能力、动态 HDR 协商、屏幕校准&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/streaming/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;ABR、RS FEC、码率预算、性能记录&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;部分&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/ds5/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;DualSense 虚拟设备配置与 API&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/remote_usb/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;USB 设备转发&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/spatial_audio/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;环绕声、MAT（Dolby Atmos）实验链路&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/file_mapping/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;文件夹共享 + WSS 会话&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/ai/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;LLM 代理、凭据存储、SSE 流&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/webhook/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;事件通知投递&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/widget_http.cpp&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Xbox Game Bar 小部件状态接口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;✗ 新增&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;src/http/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Boost.Beast 传输层（替换 Simple-Web-Server）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;重写&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;顶层还有个 &lt;code&gt;gamebar-widget/&lt;/code&gt;——一个完整的 UWP 工程（34 个 &lt;code&gt;.cs&lt;/code&gt;），把串流状态做成 Xbox Game Bar 里能用手柄导航的浮层。这种&amp;quot;顺手把一个小平台也吃下来&amp;quot;的做法，是这个仓库的典型风格。&lt;/p&gt;&#10;&lt;h3 id="20-个子模块"&gt;20 个子模块&#10;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;.gitmodules&lt;/code&gt; 里 19 项，其中值得注意的有：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;third-party/moonlight-common-c&lt;/code&gt; → 指向 &lt;code&gt;qiin2333/moonlight-common-c&lt;/code&gt; 的 &lt;strong&gt;&lt;code&gt;mic&lt;/code&gt; 分支&lt;/strong&gt;（不是 LizardByte 官方）。协议扩展全在这里：麦克风回传、动态 HDR 字段、触觉事件。最近一次提交是 &lt;code&gt;docs: register fork protocol extensions (#51)&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;third-party/pyrowave&lt;/code&gt; → 自研实验视频路径，独立仓库。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;src_assets/common/sunshine-control-panel&lt;/code&gt; → 桌面 GUI 子模块（Tauri + Vue 3 + Rust，455 Star），不是内嵌在主体里。&lt;/li&gt;&#10;&lt;li&gt;四个 &lt;code&gt;nvenc-headers&lt;/code&gt; 版本并存（1100 / 1200 / 1300 / 1301），注释写得很直白：&lt;strong&gt;&amp;ldquo;新的 API 线会抬高最低驱动要求，不能替换旧的回退路径。&amp;rdquo;&lt;/strong&gt;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;最后这条是典型的踩过坑之后留下的防御性设计——同一个功能保留四条 NVENC API 版本，代价是构建产物里塞了四份头文件。&lt;/p&gt;&#10;&lt;h2 id="03--三条技术主线"&gt;03 · 三条技术主线&#10;&lt;/h2&gt;&lt;h3 id="31-显示链路把-hdr-从一个开关做成一次协商"&gt;3.1 显示链路：把 HDR 从&amp;quot;一个开关&amp;quot;做成&amp;quot;一次协商&amp;quot;&#10;&lt;/h3&gt;&lt;p&gt;上游的 HDR 是 &lt;code&gt;dynamicRangeMode = 1&lt;/code&gt; 或 &lt;code&gt;2&lt;/code&gt;，二选一。Foundation 把它拆成正交两个维度：&lt;strong&gt;基础视频模式&lt;/strong&gt;（SDR / HDR10-PQ / HLG）与&lt;strong&gt;动态元数据格式&lt;/strong&gt;（NONE / HDR10+ / Vivid-PQ / Vivid-HLG / Dolby Vision 8.1 / 8.4）。&lt;/p&gt;&#10;&lt;p&gt;Dolby Vision 的实现文档写得很坦诚——它明确说 8.1 &lt;strong&gt;不是 HDR10+ 的画质升级版&lt;/strong&gt;，而是并列的终端原生输出通道：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;HDR10+&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Dolby Vision Profile 8.1&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;基础视频&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HDR10 PQ / BT.2020 / 10-bit&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;同左&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;动态元数据&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;SMPTE ST 2094-40&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Dolby Vision RPU&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;元数据载体&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HEVC prefix SEI (T.35)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HEVC UNSPEC 62 NAL&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;映射执行者&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;客户端 shader 或设备 HDR10+ 引擎&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;设备 Dolby Vision 引擎&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HDR10 回退&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;支持&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;支持（BL 兼容 ID = 1）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;收益不在&amp;quot;多传了画质&amp;quot;，而在覆盖&lt;strong&gt;支持 DV 但不支持 HDR10+&lt;/strong&gt; 的终端（LG、索尼、部分小米/OPPO）。文档甚至写了一句反向自查：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;如果客户端最终仍用自研 shader 解析 RPU 再自行映射，这条通道没有意义——继续优化现有 HDR10+ 链路更有价值。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;协商流程上，一个会话只锁一种动态格式，运行中不切换：&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart TD&#10; A["客户端 ANNOUNCE&lt;br/&gt;上报屏幕能力 + 动态格式列表"] --&gt; B{"是否只报 DV 8.4&lt;br/&gt;且请求 HLG?"}&#10; B --&gt;|"同时报 8.1 与 8.4"| C["只协商 8.1（PQ 基层）"]&#10; B --&gt;|"仅 8.4"| D{"应用是否开启 RTX HDR?"}&#10; D --&gt;|"是"| E["8.4 不参与协商&lt;br/&gt;返回 colorspace_unsupported"]&#10; D --&gt;|"否"| F["协商 8.4（HLG 基层）"]&#10; C --&gt; G{"基础层可编码?"}&#10; F --&gt; G&#10; G --&gt;|"NVENC / AMF 支持"| H["注入 RPU，开始会话"]&#10; G --&gt;|"不支持"| I["逐级回退&lt;br/&gt;HDR10+ → HDR10 → SDR"]&#10; style A fill:#1f6feb,stroke:#1f6feb,color:#fff&#10; style C fill:#238636,stroke:#238636,color:#fff&#10; style F fill:#238636,stroke:#238636,color:#fff&#10; style E fill:#da3633,stroke:#da3633,color:#fff&#10; style I fill:#9e6a03,stroke:#9e6a03,color:#fff&lt;/pre&gt;&lt;p&gt;RTX HDR 与 8.4 的互斥是个具体例子：RTX HDR 管线固定输出 PQ（TrueHDR 滤镜 → FP16 linear scRGB → PQ/P010），HLG 会话压根不激活滤镜。所以 gate 判断的是&lt;strong&gt;应用配置&lt;/strong&gt;（&lt;code&gt;session.synthetic_hdr.enabled&lt;/code&gt;）而不是会话里的滤镜状态——否则用滤镜状态做判断，RTX HDR 应用在 HLG 路径上会漏排除。&lt;/p&gt;&#10;&lt;p&gt;这类&amp;quot;为什么这么写&amp;quot;的解释，在仓库 86 篇 Markdown 文档里密度很高，是这个项目最值钱的部分之一。&lt;/p&gt;&#10;&lt;h3 id="32-网络自适应01-概率目标的-rs-fec"&gt;3.2 网络自适应：0.1% 概率目标的 RS FEC&#10;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;src/streaming/fec.h&lt;/code&gt; 只有 8 KB，做的事相当克制：&lt;strong&gt;不改视频 UDP 格式，不加逐包身份，不做带宽探测。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;p&gt;反馈机制：客户端每秒通过已有的加密 ENet 控制通道回一条 &lt;strong&gt;12 字节汇总&lt;/strong&gt;，内容是&amp;quot;块完成或放弃时的数据分片缺失数&amp;quot;。主机用十个一秒桶保存有限历史，取&lt;strong&gt;最高桶&lt;/strong&gt;的缺失比例。&lt;/p&gt;&#10;&lt;p&gt;决策逻辑，文档原文：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;决策器结合实际待发送帧大小，调用已有 Boost.Math 的二项分布尾概率。对可表示的 RS 布局选择最低冗余，使独立同分布丢失模型下&amp;quot;一帧任意块不可恢复&amp;quot;的概率上界不超过 0.1%。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;冗余定义 &lt;code&gt;P = ceil(D × F / 100)&lt;/code&gt;。约束很清楚：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;参数&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;默认&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;范围&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;说明&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自动 FEC&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;关闭&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;客户端&amp;quot;跟随主机&amp;quot;时才自动选&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;默认/回退比例&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;20%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0–255%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;无反馈或反馈超 3 秒时用&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自动比例上限&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;50%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;0–100%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;只约束自动模式，不约束客户端固定值&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;历史窗口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;10 秒&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;固定&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;借鉴有限历史滤波，非通用最优&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;RS 布局&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;最多 4 块&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每块 ≤ 255 分片&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;协议硬限制&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;文档末尾有整段自我限定，读起来像验收报告而不是宣传材料：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;最高桶比例是保守观测值，并非统计置信上界；0.1% 是模型目标，不是实际体验保证。相关丢失、发送突发、迟到和未观察帧都可能偏离该模型。没有突发丢包分类或专用适配。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;还有一个工程细节值得单独拎出来：提高 FEC 比例需要&lt;strong&gt;先降编码目标&lt;/strong&gt;腾出带宽预算，代码用&amp;quot;帧时间戳环&amp;quot;记录每帧提交时的额度，避免 NVENC/AMF 的延迟输出把旧帧套上新额度。比例提高要等编码器成功重配置，比例降低可以先减冗余。这种方向不对称的处理，说明作者真的被&amp;quot;改完设置立刻卡一下&amp;quot;坑过。&lt;/p&gt;&#10;&lt;h3 id="33-abr阈值回退--llm-兜底"&gt;3.3 ABR：阈值回退 + LLM 兜底&#10;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;src/streaming/abr.h&lt;/code&gt; 的头部注释直接给出两层结构：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Two-tier architecture:&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; 1. Real-time fallback: immediate threshold-based reactions to packet loss.&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; 2. Event-driven LLM: intelligent per-game target bitrate via LLM AI,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; triggered on app switches and network recovery.&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;注意分工：&lt;strong&gt;实时层负责&amp;quot;立刻降&amp;quot;，LLM 负责&amp;quot;长期上限&amp;quot;&lt;/strong&gt;。LLM 不参与逐包决策，只在应用切换和网络恢复时异步设定该游戏的目标码率天花板。客户端定期 POST 网络指标，拿回调整动作。&lt;/p&gt;&#10;&lt;p&gt;这个设计有明确的技术合理性——大模型延迟不可控，塞进实时回路必然抖动；作为&amp;quot;这个游戏该给多少码率&amp;quot;的先验则很合适。代价也明确：要配 API key，多一条外部依赖，且推荐值不可复现。&lt;code&gt;src/ai/&lt;/code&gt; 目录（凭据存储、代理、SSE 流）就是为这个配套的。&lt;/p&gt;&#10;&lt;p&gt;配套的 &lt;code&gt;src/ai/proxy.cpp&lt;/code&gt; 还承担桌面 GUI 的 AI 日志诊断——本地日志喂给模型定位问题。这类功能对&amp;quot;只看结果的用户&amp;quot;价值有限，对&amp;quot;愿意读日志的人&amp;quot;是加分项。&lt;/p&gt;&#10;&lt;h3 id="34-设备侧dualsenseusbmat"&gt;3.4 设备侧：DualSense、USB、MAT&#10;&lt;/h3&gt;&lt;p&gt;三块新增能力，复杂度递增：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;DualSense&lt;/strong&gt;：&lt;code&gt;Sunshine.Ds5Sidecar.x64.zip&lt;/code&gt; 单独一个 &lt;strong&gt;89.1 MB&lt;/strong&gt; 资产（比主安装包 36.8 MB 还大 2.4 倍）。装好后在被控端呈现原生 DS5，自适应扳机、音频触觉、灯光、触控板全部透传。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;USB 转发&lt;/strong&gt;：&lt;code&gt;src/remote_usb/&lt;/code&gt;，需要装传输组件并按设备授权。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;MAT（Dolby Atmos）&lt;/strong&gt;：&lt;code&gt;src/spatial_audio/&lt;/code&gt;，实验性。文档说得很实在——采集钩子依赖 &lt;code&gt;audioeng.dll&lt;/code&gt; 与 Dolby Access 的 &lt;code&gt;DolbyMatEnc.dll&lt;/code&gt; / &lt;code&gt;DolbyMatEngine.dll&lt;/code&gt; 的&lt;strong&gt;内部偏移&lt;/strong&gt;，只在 &lt;code&gt;mat_compat.h&lt;/code&gt; 列出的已验证文件哈希上运行。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;最后这条是整篇文章里最该被强调的风险：&lt;strong&gt;Windows 累积更新或 Dolby Access 商店更新一改这几个 DLL，MAT 就不可用&lt;/strong&gt;（普通音频不受影响）。宿主更新的自由度决定了这个功能会周期性失效，修一次要重新做原生验收、补哈希。&lt;/p&gt;&#10;&lt;h2 id="04--工程治理86-篇文档与-4-个-ci-job"&gt;04 · 工程治理：86 篇文档与 4 个 CI Job&#10;&lt;/h2&gt;&lt;p&gt;主流开源项目里，文档质量与代码质量经常脱节。这个项目的文档产出量值得单独统计：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;类别&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;数量&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;例子&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;.md&lt;/code&gt; 文档&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;86 篇 / 0.8 MB&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用户文档&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4 语言 × 6 篇&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;README 有中/英/德/法/日五版&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;设计文档&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;30+ 篇&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;dolby_vision_profile81/84&lt;/code&gt;、&lt;code&gt;dynamic-fec&lt;/code&gt;、&lt;code&gt;http-transport&lt;/code&gt;、&lt;code&gt;MAT-HOST&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;排障文档&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2 篇&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;FAQ、troubleshooting&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;特殊文档&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1 篇&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;WGC vs DDAPI 流畅度&amp;quot;论文&amp;quot;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;那篇 &lt;code&gt;WGC_vs_DDAPI_Smoothness_Fun_Guide.md&lt;/code&gt; 值得单独看。它用&amp;quot;杂鱼&amp;quot;口吻 + Mermaid 时序图解释了一个真问题：DDAPI 轮询新帧时&lt;strong&gt;长时间持有 GPU 锁&lt;/strong&gt;，编码器被挡在门外，导致每帧包含的游戏运动量不等——即便 V-Sync 让显示间隔完全均匀，眼睛看到的仍是动量忽大忽小（judder）。&lt;/p&gt;&#10;&lt;p&gt;文档里给了个穿透力很强的表格：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;帧率&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;帧间距&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;±3ms 抖动占比&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;感受&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;30 fps&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;33.3 ms&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;9%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;有点涩&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;60 fps&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;16.7 ms&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;18%&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;明显不顺&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;120 fps&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;8.3 ms&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;36%&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;很不舒服&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;240 fps&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4.2 ms&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;72%&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;—&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;结论对高刷串流用户是硬信息：帧率越高，同样的捕获抖动占比越大，捕获方式的选择越重要。&lt;/p&gt;&#10;&lt;p&gt;测试侧相对克制：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;项&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;实测&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;tests/CMakeLists.txt&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;897 行&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;add_executable&lt;/code&gt; / &lt;code&gt;add_test&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;46 / 42&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;CI Job&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4 个（&lt;code&gt;setup_release&lt;/code&gt;、&lt;code&gt;vdd_smoke&lt;/code&gt;、&lt;code&gt;mat_smoke&lt;/code&gt;、&lt;code&gt;build_win&lt;/code&gt;）&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;测试类型&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;单元 + 契约 + 冒烟，MAT 侧 20 余个专用用例&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;MAT 那部分是认真的：&lt;code&gt;tests/mat-live/&lt;/code&gt; 下 20 多个文件，包含 Android instrumentation、加密 oracle、22.8 KB 的管道测试、4.6 KB 的看门狗测试。但文档也承认边界：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;常规 CI 运行轻量主机契约、对象回调、IPC、管道和管理入口回归；客户端使用 mock，不启动原生捕获、现场信号或完整 RTSP/视频会话。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;也就是说，&lt;strong&gt;&amp;ldquo;能不能跑&amp;quot;由 CI 保证，&amp;ldquo;效果好不好&amp;quot;只能靠人工验收&lt;/strong&gt;。这在音视频领域是常态，不是缺陷，但用户不该指望 CI 绿灯等于画质达标。&lt;/p&gt;&#10;&lt;p&gt;发布节奏则明显偏&amp;quot;快&amp;rdquo;：70 个 Release，2025-12 一个月发了 6 个，2026-11 前 7 天里发了 2 个。版本号形如 &lt;code&gt;v2026.1031.121458.杂鱼&lt;/code&gt;——日期 + 时分秒 + 后缀，没有语义化版本。预发布和正式版混在同一个列表里，首屏 &amp;ldquo;Latest&amp;rdquo; 徽章还会指向预发布版本。&lt;/p&gt;&#10;&lt;h2 id="05--四个必须知道的代价"&gt;05 · 四个必须知道的代价&#10;&lt;/h2&gt;&lt;h3 id="代价一客户端锁定"&gt;代价一：客户端锁定&#10;&lt;/h3&gt;&lt;p&gt;这是最重要的一条。HDR 协商、显示器管理、音频格式、触觉事件全部依赖 &lt;code&gt;moonlight-common-c&lt;/code&gt; 的 &lt;code&gt;mic&lt;/code&gt; 分支协议扩展。&lt;strong&gt;官方 Moonlight 客户端不认这些扩展&lt;/strong&gt;，用上去的结果是功能静默消失，或出现显示异常、连接错误。&lt;/p&gt;&#10;&lt;p&gt;README 直接列了推荐客户端清单（V+ for PC、macOS Enhanced、Android/TV V+、鸿蒙版，以及 VoidLink、王冠版、包子版等合作客户端）。想用 Foundation 的完整能力，等于接受一套&amp;quot;服务端 + 指定客户端&amp;quot;的绑定组合。&lt;/p&gt;&#10;&lt;h3 id="代价二不是装上就能用"&gt;代价二：不是&amp;quot;装上就能用&amp;rdquo;&#10;&lt;/h3&gt;&lt;p&gt;安装清单实际包含：主程序安装包（36.8 MB）+ 虚拟显示器驱动（Zako Display Driver）+ DualSense Sidecar（89.1 MB，按需）+ USB 传输组件（按需）+ 桌面 GUI 子模块。系统要求 Windows 10 22H2 以上。&lt;/p&gt;&#10;&lt;p&gt;README 里的新手流程有 6 个步骤、两张表格，还专门提醒&amp;quot;第一次连接先用 1080p / 60 FPS / 20 Mbps，先关 HDR&amp;quot;。这不是文档啰嗦，是这东西的可调项太多。&lt;/p&gt;&#10;&lt;h3 id="代价三96-个-open-issue"&gt;代价三：96 个 open issue&#10;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;open_issues_count = 96&lt;/code&gt;（含 PR），拆开是 62 个 issue + 34 个 PR。对一个 3 年、近 3,400 次提交的项目，这个比例不算失控，但意味着&lt;strong&gt;反馈周期可能较长&lt;/strong&gt;。文档里已经沉淀了相当多&amp;quot;已知问题&amp;quot;——比如&amp;quot;安装模拟 DS5 组件后 Windows 桌面自动滚动&amp;quot;，FAQ 的解法是&amp;quot;装最新测试版试试&amp;quot;，属于未根治状态。&lt;/p&gt;&#10;&lt;h3 id="代价四发布说明里有硬约束"&gt;代价四：发布说明里有硬约束&#10;&lt;/h3&gt;&lt;p&gt;最新正式版的发布说明出现了三条不该被忽略的提示：&lt;/p&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;&lt;strong&gt;N 卡用户请避开 616.55、616.64 版本驱动&lt;/strong&gt;，这两个版本可能导致虚拟显示器无法激活，并出现串流 503 错误。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;&lt;strong&gt;Sunshine 完全免费。如果你通过第三方平台付费购买，请申请退款。&lt;/strong&gt;&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;&lt;strong&gt;虚拟显示器的系统要求：Windows 10 22H2 或更高版本。&lt;/strong&gt;&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;&lt;p&gt;第一条是实实在在的踩坑警告（驱动版本 × 虚拟屏激活 × 503 错误，三个词对上一类典型故障）。第二条说明市面上已经有人在倒卖这个免费工具。&lt;/p&gt;&#10;&lt;h2 id="06--该用哪个"&gt;06 · 该用哪个&#10;&lt;/h2&gt;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;场景&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;建议&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;局域网串流，只要稳定低延迟，不折腾&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;上游 Sunshine&lt;/strong&gt; 足够，生态和客户端兼容性最好&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;无物理显示器 / 要 HDR / 要 7.1.4 与麦克风回传&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Foundation，且必须配它指定的客户端&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;需要 DualSense 自适应扳机远程可用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Foundation，接受 89 MB Sidecar 与组件维护成本&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;需要 Dolby Vision 输出到电视&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Foundation 8.1/8.4 通道，但先确认终端与客户端都支持&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;追求&amp;quot;装完即用&amp;quot;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;两个都不太符合，Sunshine 系列天生是配置型工具&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;一句话总结：&lt;strong&gt;上游解决&amp;quot;能不能串&amp;quot;，Foundation 解决&amp;quot;串得像不像本地&amp;quot;。&lt;/strong&gt; 后者的代价是把上游 615 个文件的通用实现，扩成了 1,370 个文件的 Windows 专用栈——其中 342 个 &lt;code&gt;.cpp&lt;/code&gt;、71 个 HLSL 着色器、20 个子模块、4 个 NVENC API 版本，每一项都是为&amp;quot;画面和声音更接近本地&amp;quot;付的账。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&#10; &lt;blockquote&gt;&#10; &lt;p&gt;本文所述功能与限制均以 2026-11-07 仓库状态为准。项目迭代很快（单周内两次发布），具体可用性请以实际版本说明与真机测试为准。作者与项目无关联，不构成推荐。&lt;/p&gt;&#10;&#10; &lt;/blockquote&gt;&#10;</description></item></channel></rss>