docs: 补全 C# XML 文档注释，覆盖所有公开与内部成员

为 14 个项目中缺少 XML 注释的类、接口、方法、属性、字段、record、
枚举等成员补全中文文档注释。接口方法在接口层定义完整注释，实现类
使用 <inheritdoc /> 引用。私有辅助方法结合业务语义编写注释。

扫描结果：missing-csharp-docs.txt 缺失项归零。
构建结果：0 警告，0 错误。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

FileShare-PC/Views/MainWindow.axaml.cs

@@ -684,6 +684,10 @@ namespace FileShare_PC.Views
             return true;
         }
 
+        /// <summary>
+        /// 为媒体流响应添加 CORS 和 Range 请求头，允许浏览器跨域访问和分段请求。
+        /// </summary>
+        /// <param name="response">HTTP 响应对象。</param>
         private static void AddLocalMediaHeaders(HttpListenerResponse response)
         {
             response.Headers["Access-Control-Allow-Origin"] = "*";
@@ -692,6 +696,14 @@ namespace FileShare_PC.Views
             response.Headers["Access-Control-Expose-Headers"] = "Accept-Ranges, Content-Length, Content-Range";
         }
 
+        /// <summary>
+        /// 解析 HTTP Range 请求头中的 <c>bytes=start-end</c> 格式，支持两端省略和后缀长度（如 <c>bytes=-500</c>）。
+        /// </summary>
+        /// <param name="value">Range 请求头值。</param>
+        /// <param name="length">资源总字节数。</param>
+        /// <param name="start">解析出的起始字节偏移。</param>
+        /// <param name="end">解析出的结束字节偏移。</param>
+        /// <returns>解析成功返回 true，否则 false。</returns>
         private static bool TryParseByteRange(string? value, long length, out long start, out long end)
         {
             start = 0;
@@ -737,6 +749,12 @@ namespace FileShare_PC.Views
             return true;
         }
 
+        /// <summary>
+        /// 从输入流读取指定字节数并写入输出流，用于实现 HTTP Range 分段响应。
+        /// </summary>
+        /// <param name="input">源文件流。</param>
+        /// <param name="output">HTTP 响应输出流。</param>
+        /// <param name="bytesRemaining">需要传输的剩余字节数。</param>
         private static async Task CopyRangeAsync(Stream input, Stream output, long bytesRemaining)
         {
             var buffer = new byte[64 * 1024];