✨ feat(server): 增加混淆发布链路与调试页静态说明

- 新增 Obfuscar 混淆发布脚本、发布测试与产物隐私检查
- 调整 VS Code 发布任务和宿主发布配置，统一走混淆流程
- 为 debug 页面内嵌静态接口说明，并补充对应集成测试
- 更新 README 与设计计划文档，记录跨平台发布约束

docs/superpowers/plans/2026-06-22-cross-platform-obfuscation.md

@@ -0,0 +1,55 @@
+# Flyshot 跨平台混淆发布 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 为全部 `Flyshot.*` 自研程序集建立依赖环境 Obfuscar 的跨平台框架依赖混淆发布流程。
+
+**Architecture:** 使用一个 PowerShell 入口编排 `dotnet publish`、绝对路径 Obfuscar XML 生成、混淆执行、产物完整性检查和映射文件隔离。发布脚本不修改项目运行时代码，也不引入混淆器包依赖。
+
+**Tech Stack:** PowerShell 7、.NET 8 SDK、Obfuscar.GlobalTool 2.2.50、ASP.NET Core 自包含发布。
+
+---
+
+### Task 1: 发布脚本契约测试
+
+**Files:**
+- Create: `tests/Publishing/Publish-Obfuscated.Tests.ps1`
+
+- [ ] 编写测试夹具，创建包含八个 `Flyshot.*.dll` 和一个第三方 DLL 的临时发布目录。
+- [ ] 调用尚不存在的配置生成入口，断言测试因缺少 `scripts/Publish-Obfuscated.ps1` 而失败。
+- [ ] 保留测试入口，使后续实现可以在 `-GenerateConfigOnly` 模式下验证配置内容而不执行真实发布。
+
+### Task 2: 双平台混淆发布脚本
+
+**Files:**
+- Create: `scripts/Publish-Obfuscated.ps1`
+
+- [ ] 定义带完整注释的参数、静态程序集清单和辅助函数。
+- [ ] 检查 PowerShell、`dotnet` 与 `obfuscar.console` 环境命令。
+- [ ] 使用 `dotnet publish -c Release -r <rid> --self-contained true -p:PublishSingleFile=false` 生成原始产物。
+- [ ] 为八个 `Flyshot.*.dll` 生成使用绝对路径的 Obfuscar XML。
+- [ ] 执行 Obfuscar，并检查每个输入模块都有混淆输出。
+- [ ] 将混淆 DLL/PDB 替换进发布目录，并将 `Mapping.txt` 隔离到 `outputs/obfuscation-maps/<rid>/`。
+- [ ] 不传 RID，生成一份 Windows/Linux 共用的 .NET 8 框架依赖发布包。
+
+### Task 3: 发布任务与文档
+
+**Files:**
+- Modify: `.vscode/tasks.json`
+- Modify: `README.md`
+
+- [ ] 将 VS Code `publish` 任务改为调用 PowerShell 混淆发布脚本。
+- [ ] 在 README 发布章节记录环境安装、发布命令、输出目录和保护边界。
+
+### Task 4: 验证
+
+**Files:**
+- Modify: `docs/superpowers/plans/2026-06-22-cross-platform-obfuscation.md`
+
+- [ ] 运行脚本契约测试并确认通过。
+- [ ] 运行 `dotnet test FlyshotReplacement.sln -c Release -v minimal`。
+- [ ] 运行 `dotnet build FlyshotReplacement.sln -c Release --no-restore -v minimal`。
+- [ ] 环境安装 Obfuscar 后执行 `pwsh -File scripts/Publish-Obfuscated.ps1`。
+- [ ] 启动 Windows 混淆产物并请求 `/healthz`。
+- [ ] 检查 Linux 混淆产物结构；存在 WSL 时启动并请求 `/healthz`。
+- [ ] 检查 `git diff`，确认没有第三方程序集或映射文件进入部署包。

docs/superpowers/specs/2026-06-22-cross-platform-obfuscation-design.md

@@ -0,0 +1,44 @@
+# Flyshot 跨平台混淆发布设计
+
+## 目标
+
+为全部 `Flyshot.*` 自研程序集增加统一的 Obfuscar 混淆发布流程，生成一份 Windows 与 Linux 共用的 .NET 8 框架依赖部署包。混淆流程必须显式失败，不能在工具缺失或混淆失败时留下看似成功的未保护发布包。
+
+## 工具与环境边界
+
+- 使用环境中安装的 Obfuscar 全局工具，命令名为 `obfuscar.console`。
+- 仓库不增加 Obfuscar NuGet `PackageReference`，也不增加 `.config/dotnet-tools.json`。
+- 构建环境需预先执行 `dotnet tool install --global Obfuscar.GlobalTool --version 2.2.50`。
+- 发布脚本只依赖 PowerShell 7、.NET 8 SDK 和环境中的 Obfuscar。
+
+## 发布结构
+
+发布脚本不接受运行平台或 RID，固定执行一次框架依赖发布：
+
+1. 使用 `dotnet publish` 生成自包含、多文件的原始发布目录。
+2. 动态生成包含绝对路径的 Obfuscar XML 配置。
+3. 校验当前八个核心程序集不可缺失，并将发布目录中的全部 `Flyshot.*.dll` 加入混淆模块列表。
+4. Obfuscar 输出到独立临时目录。
+5. 仅在混淆成功且输出程序集完整时，用混淆程序集替换原始发布目录中的对应文件。
+6. 将映射文件移入不随部署包交付的 `outputs/obfuscation-maps/<rid>/`。
+7. 最终部署包输出到 `outputs/obfuscated/framework-dependent/`。
+
+## 混淆边界
+
+- `KeepPublicApi=true`：保留公共 API 名称，保护 ASP.NET Core 控制器发现、配置绑定、DI、JSON DTO、Swagger 和程序集间调用。
+- `HidePrivateApi=true`：重命名内部类型、私有方法和字段。
+- `RenameProperties=false`、`RenameEvents=false`：避免配置绑定、JSON 序列化和框架约定受属性或事件重命名影响。
+- 不处理 `Microsoft.*`、`System.*`、NLog、Swashbuckle 等第三方程序集。
+- 所有 `Flyshot.*.dll` 必须被发现并加入配置；缺少任何当前核心程序集都视为发布失败，未来新增模块会自动纳入。
+
+## 验证
+
+- 脚本契约测试验证：RID 列表、环境工具缺失失败、全部自研程序集进入配置、第三方程序集不进入配置、映射文件不进入部署目录。
+- 执行现有解决方案测试与 Release 构建。
+- 真实执行框架依赖发布及混淆，并分别在 Windows 与 Linux 的 .NET 8 运行时上启动。
+- Windows 包实际启动并请求 `/healthz`。
+- Linux 包至少验证 ELF 启动文件、依赖文件和全部混淆程序集完整；环境存在 WSL 时再实际启动并请求 `/healthz`。
+
+## 风险与限制
+
+Obfuscar 能显著提高普通反编译的阅读成本，但不能绝对阻止有经验的逆向分析。保留公共 API 是当前 ASP.NET Core 稳定运行所需的安全边界；若未来需要更强的控制流混淆、字符串加密或防篡改，应评估商业混淆器。