diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..2707c9a8
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,177 @@
+# Changelog / 更新日志
+
+## 2026-08-06 — User-friendly FFmpeg workflow / 用户友好的 FFmpeg 工作流
+
+### 中文
+
+#### 新增“音频准备”主页面
+
+- 在主导航中加入独立的“音频准备”入口，不改变原有对话和 SynthV 实时音符编辑入口。
+- 支持选择一个本地音频/视频文件或拖放单个文件，并在开始任务前调用 `ffprobe` 显示：
+  时长、容器/编码、采样率和声道数。
+- 提供“为 SynthV 准备音频”流程，生成新的 PCM WAV；默认保持原采样率和声道、使用
+  24-bit PCM，并可显式选择采样率、单/双声道、采样格式、起始位置和保留时长。
+- 提供“检查 / 平衡响度”流程：先执行只读 EBU R128 测量，再允许用户确认后生成新文件。
+- 默认响度目标为通用试听预设 `-16 LUFS / -1.5 dBTP / 11 LRA`，界面明确说明它不是
+  SynthV 强制标准；标准化完成后自动复测输出，显示输入/输出对比。
+
+#### 用户确认与文件安全
+
+- PCM WAV 准备、响度标准化、FFmpeg 安装和更新均在写入前显示输入、参数和计划输出位置，
+  并要求用户在 Desktop 中确认。
+- 所有音频操作生成新文件到 `~/.SynthVcopilot/output/ffmpeg`，不覆盖源文件。
+- 输出名包含时间、毫秒和随机短后缀，避免快速重试时发生同名冲突。
+- “另存为”显式拒绝选择输入源路径，维护“源文件不修改”的产品承诺。
+- 不自动导入 SynthV、不自动运行 CVRS、不删除输出，也不开放批处理或任意 FFmpeg 命令。
+
+#### 结果预览与交接
+
+- 处理完成后可在页面内分别试听原始音频与处理结果。
+- 提供“打开文件位置”“复制路径”和“另存为”，让用户决定如何交给 SynthV 或其他工具。
+- 对话页增加固定的“处理音频”跳转，Agent 不再直接执行音频写入。
+
+#### FFmpeg 组件维护
+
+- 将原来的静态组件占位列表改为可用的 FFmpeg 维护卡片。
+- 显示当前来源（Pi Desktop 私有安装、系统 PATH 或用户显式目录）、已用版本、可用版本和
+  可执行文件目录。
+- 支持用户确认后的安装、更新和卸载；系统 FFmpeg 与显式配置目录保持只读，不会被卸载。
+- 其他尚未实现的模型组件明确显示为“计划中”，不会执行占位下载或无效安装。
+
+#### Native 服务和任务生命周期
+
+- 新增完整 C# DTO、四种 FFmpeg 请求模型及六项原生 C ABI P/Invoke 绑定。
+- 新增 `SafeHandle`，确保每个 native `PiJob` 恰好销毁一次。
+- 新增全局 `FfmpegService`：所有 native 调用离开 UI 线程，单任务互斥，250 ms 状态轮询，
+  结构化错误、进度报告和安全取消。
+- 增加预登记取消状态，覆盖“UI 已显示任务但 native handle 尚未登记”的短窗口。
+- 取消调用同步绑定当时的任务，避免旧取消请求延迟后错误命中新任务。
+- 应用关闭时取消当前任务并释放 FFmpeg 服务与 Agent 服务。
+
+#### 跨页面体验
+
+- 主窗口增加全局任务条和取消按钮；切换页面后仍可看到任务并取消。
+- 音频准备和组件页面启用导航缓存，返回页面后保留选择、进度、试听和处理结果。
+- 全局任务条使用任务 token，旧任务的延迟完成不会关闭或改写新任务状态。
+
+#### 架构和冒烟测试
+
+- `pi-desktop` 和 `PiAgentSmoke` 根据 Platform/RID 显式选择 Rust target：
+  x64 对应 `x86_64-pc-windows-msvc`，ARM64 对应 `aarch64-pc-windows-msvc`。
+- 从 `target/<triple>/release/pi_agent.dll` 复制对应架构 DLL；缺少预期 DLL 时构建失败关闭，
+  防止 ARM64 包误带 x64 产物。
+- 冒烟测试覆盖组件状态 JSON、job 轮询、SafeHandle 释放，以及真实 FFmpeg 的探测、PCM WAV
+  准备、响度分析和响度标准化；测试输出会被清理。
+
+#### Agent 与 SynthV 边界
+
+- Desktop 子模块更新到包含安全 FFmpeg C ABI 的 `pi-agent` 基线，并同步 Agent 只读权限补丁。
+- Agent 只保留 `ffmpeg_probe` 和 `ffmpeg_loudness_analyze`；音频写入只通过 Desktop 确认流程。
+- 未修改 `synthv-agent-bridge`、IPC v3、六个 `sv_*` 工具或 `add_notes`；用户继续在打开的
+  SynthV 钢琴卷帘中看到 Agent 批量插入音符。
+
+#### 验证状态
+
+- 真实 C ABI 冒烟：探测、准备、响度分析、标准化全部通过。
+- Rust：57 项测试通过、2 项按设计忽略；Clippy `-D warnings` 通过。
+- SynthV Bridge：240 项自动化检查通过，Bridge 工作树保持无改动。
+- Desktop 非 XAML C# 源编译、XAML XML 与事件绑定检查通过。
+- 本机缺少 Visual Studio C++ Build Tools、MSVC linker 与 Windows SDK，因此完整 WinUI XAML
+  构建和 ARM64 native 构建仍需在具备正式 Windows 构建环境的节点补跑。
+
+### English
+
+#### New first-class Audio Preparation page
+
+- Added an independent Audio Preparation destination to the main navigation without changing
+  the existing chat entry or live SynthV note-editing workflow.
+- Supports selecting one local audio/video file or dropping a single file, then probes it before
+  processing to show duration, container/codec, sample rate, and channel count.
+- Added a “Prepare audio for SynthV” flow that creates a new PCM WAV. Defaults preserve the source
+  sample rate and channels, use 24-bit PCM, and allow explicit sample rate, mono/stereo, sample
+  format, start position, and duration choices.
+- Added a “Check / balance loudness” flow that performs read-only EBU R128 analysis before any
+  write-capable action becomes available.
+- Uses a general listening preset of `-16 LUFS / -1.5 dBTP / 11 LRA`, clearly labels it as not a
+  mandatory SynthV standard, and automatically re-analyzes normalized output for before/after
+  comparison.
+
+#### User confirmation and file safety
+
+- PCM WAV preparation, loudness normalization, FFmpeg install, and FFmpeg update all show the
+  input, parameters, and planned destination before asking the user to confirm.
+- Audio jobs create new files under `~/.SynthVcopilot/output/ffmpeg` and never overwrite the input.
+- Output names include time, milliseconds, and a short random suffix to avoid rapid-retry name
+  collisions.
+- Save As explicitly refuses the original input path, preserving the source-file immutability
+  promise.
+- The workflow does not auto-import into SynthV, auto-run CVRS, delete output, offer batch mode,
+  or expose arbitrary FFmpeg command lines.
+
+#### Result preview and hand-off
+
+- Provides separate in-page playback for the original file and processed result.
+- Adds Open location, Copy path, and Save As actions so the user decides how to hand the result to
+  SynthV or another application.
+- Adds a persistent “Process audio” shortcut to Chat while keeping audio writes out of Agent tools.
+
+#### FFmpeg component maintenance
+
+- Replaced the inert component placeholder list with an operational FFmpeg maintenance card.
+- Shows the active source (Pi Desktop managed install, system `PATH`, or explicit user directory),
+  installed version, available version, and executable directory.
+- Supports confirmed install, update, and managed uninstall. System and explicitly configured
+  FFmpeg installations remain read-only and are never removed.
+- Labels unimplemented model components as planned and performs no placeholder download or no-op
+  installation.
+
+#### Native service and job lifecycle
+
+- Added complete C# DTOs, four FFmpeg request models, and six native C ABI P/Invoke bindings.
+- Added a `SafeHandle` that destroys each native `PiJob` exactly once.
+- Added a process-wide `FfmpegService`: native calls run off the UI thread, only one job can own the
+  executor, status is polled every 250 ms, and structured errors, progress, and cancellation are
+  exposed to the UI.
+- Added pre-registration cancellation state for the short interval where the UI has started a task
+  but the native handle is not yet published.
+- Cancellation binds synchronously to the job active at click time so a delayed old cancellation
+  cannot terminate a newer job.
+- Window shutdown cancels active work and disposes both the FFmpeg and Agent services.
+
+#### Cross-page experience
+
+- Added a global task InfoBar and Cancel action so work remains visible and cancellable after
+  navigation.
+- Enabled required navigation caching for Audio Preparation and Components, preserving selections,
+  progress, playback, and results when the user returns.
+- Protects the global task bar with per-operation tokens so late completion from an old task cannot
+  hide or rewrite a newer task.
+
+#### Architecture and smoke coverage
+
+- `pi-desktop` and `PiAgentSmoke` explicitly map Platform/RID to Rust targets:
+  x64 uses `x86_64-pc-windows-msvc`; ARM64 uses `aarch64-pc-windows-msvc`.
+- Copies the native DLL from `target/<triple>/release/pi_agent.dll` and fails closed if the expected
+  artifact is missing, preventing an ARM64 package from accidentally carrying an x64 DLL.
+- Expanded smoke coverage for component status JSON, job polling, SafeHandle disposal, and all four
+  real FFmpeg operations: probe, PCM WAV preparation, loudness analysis, and normalization. Test
+  artifacts are removed afterward.
+
+#### Agent and SynthV boundaries
+
+- Updated the Desktop submodule to the secure FFmpeg C ABI baseline and synchronized the Agent
+  read-only permission patch.
+- The Agent retains only `ffmpeg_probe` and `ffmpeg_loudness_analyze`; audio writes run only through
+  the confirmed Desktop workflow.
+- Did not modify `synthv-agent-bridge`, IPC v3, the six `sv_*` tools, or `add_notes`; users continue
+  to see Agent-created note batches appear in the open SynthV piano roll.
+
+#### Validation status
+
+- Real C ABI smoke passed probe, prepare, loudness analysis, and normalization.
+- Rust validation passed 57 tests with 2 intentionally ignored; Clippy passed with `-D warnings`.
+- SynthV Bridge passed 240 automated checks and remained unchanged.
+- Desktop non-XAML C# source compilation, XAML XML parsing, and event-handler checks passed.
+- This machine lacks Visual Studio C++ Build Tools, the MSVC linker, and the Windows SDK, so the
+  complete WinUI XAML build and ARM64 native build still need to run on a fully provisioned Windows
+  build node.
diff --git a/README.md b/README.md
index 8560d218..defdaac6 100644
--- a/README.md
+++ b/README.md
@@ -8,17 +8,19 @@
 
 | 页面 | 能力 |
 |---|---|
-| 对话 | 与 Pi Agent 的 GUI 对话 |
+| 对话 | 与 Pi Agent 的 GUI 对话；音频写入请求引导到“音频准备”页确认 |
+| 音频准备 | 选择/拖入本地文件、格式检测、PCM WAV 准备、响度测量与确认后标准化、前后试听、打开位置/复制路径/另存为 |
 | 历史 | 会话历史列表（`IConversationStore`） |
 | 配置 Agent | 选模型后端、指向 synthv-agent-bridge 仓库、测试 `sv_status` |
-| 组件 | 安装 ffmpeg、本地 whisper、游戏音高识别模型、Sound→(含词)MIDI，及直接导入 MIDI/MusicXML |
+| 组件 | 安装、更新、卸载 Pi Desktop 私有 FFmpeg；显示系统/显式配置来源，其他组件明确标为计划中 |
 
 ## 架构
 
 ```
 MainWindow (NavigationView)
-  ├─ ChatPage / HistoryPage / AgentConfigPage / ComponentsPage
-  └─ App.Agent : DesktopAgentService ── P/Invoke ──▶ pi_agent.dll (Rust, v3)
+  ├─ ChatPage / AudioPreparationPage / HistoryPage / AgentConfigPage / ComponentsPage
+  ├─ App.Ffmpeg : FfmpegService ── P/Invoke（后台任务/轮询/取消）──┐
+  └─ App.Agent  : DesktopAgentService ── P/Invoke ───────────────▶ pi_agent.dll (Rust, v3)
                                                         ├─ pi-agent-core  (agent 循环/历史/组件)
                                                         ├─ pi-agent-mcp   (MCP stdio → synthv-agent-bridge)
                                                         └─ pi-agent-ffi   (C-ABI)
@@ -27,28 +29,53 @@ MainWindow (NavigationView)
 桌面壳与 agent 的通信是**进程内 P/Invoke 直调**（不起 sidecar），满足「原生 WinUI 3 内部通信」。
 只有两类子进程由 pi-agent 内部管理：SynthV 桥 (`node dist/src/cli.js`) 与组件可执行文件 (ffmpeg 等)。
 
+FFmpeg 的 Agent 工具面只保留只读的 `ffmpeg_probe` 与 `ffmpeg_loudness_analyze`。
+生成 PCM WAV 与响度标准化只通过 Desktop 的直接 C ABI 路径执行，并在写入前显示输入、参数和输出位置供用户确认。
+输出保存在 `~/.SynthVcopilot/output/ffmpeg`，不会覆盖源文件，也不会自动导入 SynthV；用户可试听、打开位置、复制路径或另存为。
+默认响度目标 `-16 LUFS / -1.5 dBTP / 11 LRA` 是通用试听预设，不是 SynthV 强制标准。
+
 ## submodule
 
 ```bash
 git submodule update --init --recursive
 ```
 
-`pi-agent` 位于 `external/pi-agent`，由 `src/PiDesktop/PiDesktop.csproj` 以 ProjectReference 引用。
+`pi-agent` 位于 `external/pi-agent`，由 `src/PiDesktop/PiDesktop.csproj` 的构建目标调用 Cargo，
+并把对应架构的 `pi_agent.dll` 复制到 Desktop 输出目录。
 
 ## 构建
 
-需要 **.NET 10 SDK** + **Windows App SDK / WinUI 3 工作负载** + **Rust 工具链 (cargo)**
+需要 **.NET 10 SDK** + **Windows App SDK / WinUI 3 工作负载** +
+**Visual Studio 2022 C++ Build Tools（MSVC linker 与 Windows SDK）** + **Rust 工具链 (cargo)**
 （csproj 的 `BuildPiAgentDll` target 会自动 `cargo build --release -p pi-agent-ffi` 并把
 `pi_agent.dll` 拷进输出目录）：
 
 ```bash
 git submodule update --init --recursive
-dotnet build src/PiDesktop/PiDesktop.csproj
+dotnet build src/PiDesktop/PiDesktop.csproj -p:Platform=x64
+# ARM64 machine / output:
+rustup target add aarch64-pc-windows-msvc
+dotnet build src/PiDesktop/PiDesktop.csproj -p:Platform=ARM64
+```
+
+`BuildPiAgentDll` compiles the matching Rust target explicitly: x64 uses
+`x86_64-pc-windows-msvc`, and ARM64 uses `aarch64-pc-windows-msvc`. The native
+DLL is copied from that target's `release` directory, so an ARM64 package never
+accidentally carries an x64 `pi_agent.dll`. The non-GUI ABI smoke test is:
+
+```bash
+dotnet run --project tools/PiAgentSmoke/PiAgentSmoke.csproj -p:Platform=x64
 ```
 
+It validates the static component catalog, dynamic FFmpeg status JSON, and—if
+a healthy system FFmpeg/ffprobe pair is already available on PATH—a local probe
+job through polling and deterministic job-handle disposal. It never downloads
+or installs FFmpeg.
+
 未打包(unpackaged) 运行，`WindowsPackageType=None`、`WindowsAppSDKSelfContained=true`。
 
-## 状态
+## 当前边界
 
-骨架阶段：四个页面与进程内 agent 通道已就位，默认用占位回显后端 (`echo`)。
-真实模型后端、桥连接测试、组件安装器与 Sound→MIDI 管线为后续填充。
+- 保持现有 `pi-agent → synthv-agent-bridge → SynthV` 实时音符写入链路；音频辅助页不修改 Bridge 协议或 SynthV 工程。
+- V1 一次处理一个本地文件，不做批处理、任意 FFmpeg 参数、自动 CVRS 或自动 SynthV 音频导入。
+- 默认仍可使用占位回显后端 (`echo`)；真实模型后端和后续音频模型组件不由本次 FFmpeg 辅助功能实现。
diff --git a/external/pi-agent b/external/pi-agent
index b68767fc..5cdb12f8 160000
--- a/external/pi-agent
+++ b/external/pi-agent
@@ -1 +1 @@
-Subproject commit b68767fc75ad777f3c13cd6f90e8c1e013ea1c74
+Subproject commit 5cdb12f8da05e93a0294d6b5955d397ec1e9a9d1
diff --git a/src/PiDesktop/App.xaml.cs b/src/PiDesktop/App.xaml.cs
index 9a3272d1..780404f0 100644
--- a/src/PiDesktop/App.xaml.cs
+++ b/src/PiDesktop/App.xaml.cs
@@ -11,11 +11,19 @@ public partial class App : Application
     /// <summary>全局 agent 服务：桌面壳与 pi-agent 的唯一进程内通道。</summary>
     public static DesktopAgentService Agent { get; } = new();
 
+    /// <summary>Global serialized local FFmpeg/component service for Desktop pages.</summary>
+    public static FfmpegService Ffmpeg { get; } = new();
+
     public App() => InitializeComponent();
 
     protected override void OnLaunched(LaunchActivatedEventArgs args)
     {
         _window = new MainWindow();
+        _window.Closed += (_, _) =>
+        {
+            Ffmpeg.Dispose();
+            Agent.Dispose();
+        };
         _window.Activate();
     }
 }
diff --git a/src/PiDesktop/MainWindow.xaml b/src/PiDesktop/MainWindow.xaml
index 373f8f94..573ff6cd 100644
--- a/src/PiDesktop/MainWindow.xaml
+++ b/src/PiDesktop/MainWindow.xaml
@@ -7,7 +7,21 @@
     Title="Pi Agent">
 
     <Grid>
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="*" />
+        </Grid.RowDefinitions>
+
+        <InfoBar x:Name="GlobalJobBar" Grid.Row="0" Margin="8,8,8,0"
+                 IsOpen="False" IsClosable="False" Severity="Informational"
+                 Title="本地任务正在运行">
+            <InfoBar.ActionButton>
+                <Button x:Name="GlobalCancelButton" Content="取消任务" Click="GlobalCancelButton_Click" />
+            </InfoBar.ActionButton>
+        </InfoBar>
+
         <muxc:NavigationView
+            Grid.Row="1"
             x:Name="Nav"
             PaneDisplayMode="LeftCompact"
             IsBackButtonVisible="Collapsed"
@@ -15,6 +29,11 @@
             SelectionChanged="Nav_SelectionChanged">
             <muxc:NavigationView.MenuItems>
                 <muxc:NavigationViewItem Content="对话" Tag="chat" Icon="Message" />
+                <muxc:NavigationViewItem Content="音频准备" Tag="audio">
+                    <muxc:NavigationViewItem.Icon>
+                        <FontIcon Glyph="&#xE8D6;" />
+                    </muxc:NavigationViewItem.Icon>
+                </muxc:NavigationViewItem>
                 <muxc:NavigationViewItem Content="历史" Tag="history" Icon="Clock" />
                 <muxc:NavigationViewItem Content="配置 Agent" Tag="config" Icon="Setting" />
                 <muxc:NavigationViewItem Content="组件" Tag="components" Icon="Download" />
diff --git a/src/PiDesktop/MainWindow.xaml.cs b/src/PiDesktop/MainWindow.xaml.cs
index 8efe78ae..35499e14 100644
--- a/src/PiDesktop/MainWindow.xaml.cs
+++ b/src/PiDesktop/MainWindow.xaml.cs
@@ -6,24 +6,86 @@ namespace PiDesktop;
 
 public sealed partial class MainWindow : Window
 {
+    public static MainWindow? Instance { get; private set; }
+    private Guid? _globalJobToken;
+
     public MainWindow()
     {
         InitializeComponent();
+        Instance = this;
         ContentFrame.Navigate(typeof(ChatPage));
         Nav.SelectedItem = Nav.MenuItems[0];
     }
 
+    public void NavigateTo(string tag)
+    {
+        var item = Nav.MenuItems
+            .OfType<NavigationViewItem>()
+            .FirstOrDefault(candidate => string.Equals(candidate.Tag as string, tag, StringComparison.Ordinal));
+
+        if (item is null)
+            return;
+
+        if (ReferenceEquals(Nav.SelectedItem, item))
+            ContentFrame.Navigate(PageFor(tag));
+        else
+            Nav.SelectedItem = item;
+    }
+
+    public Guid BeginGlobalJob(string message)
+    {
+        var token = Guid.NewGuid();
+        _globalJobToken = token;
+        GlobalJobBar.Message = message;
+        GlobalJobBar.IsOpen = true;
+        GlobalCancelButton.IsEnabled = true;
+        return token;
+    }
+
+    public void UpdateGlobalJob(Guid token, string message)
+    {
+        if (_globalJobToken == token)
+            GlobalJobBar.Message = message;
+    }
+
+    public void EndGlobalJob(Guid token)
+    {
+        if (_globalJobToken != token)
+            return;
+        _globalJobToken = null;
+        GlobalJobBar.IsOpen = false;
+    }
+
+    private async void GlobalCancelButton_Click(object sender, RoutedEventArgs e)
+    {
+        var token = _globalJobToken;
+        if (token is null)
+            return;
+
+        GlobalCancelButton.IsEnabled = false;
+        var requested = await App.Ffmpeg.CancelCurrent();
+        if (_globalJobToken == token)
+        {
+            GlobalJobBar.Message = requested
+                ? "已请求取消；正在等待当前安全步骤结束。"
+                : "任务可能已经结束。";
+            GlobalCancelButton.IsEnabled = true;
+        }
+    }
+
     private void Nav_SelectionChanged(NavigationView sender, NavigationViewSelectionChangedEventArgs args)
     {
         var tag = (args.SelectedItem as NavigationViewItem)?.Tag as string;
-        var page = tag switch
-        {
-            "chat" => typeof(ChatPage),
-            "history" => typeof(HistoryPage),
-            "config" => typeof(AgentConfigPage),
-            "components" => typeof(ComponentsPage),
-            _ => typeof(ChatPage),
-        };
-        ContentFrame.Navigate(page);
+        ContentFrame.Navigate(PageFor(tag));
     }
+
+    private static Type PageFor(string? tag) => tag switch
+    {
+        "chat" => typeof(ChatPage),
+        "audio" => typeof(AudioPreparationPage),
+        "history" => typeof(HistoryPage),
+        "config" => typeof(AgentConfigPage),
+        "components" => typeof(ComponentsPage),
+        _ => typeof(ChatPage),
+    };
 }
diff --git a/src/PiDesktop/Models/Dtos.cs b/src/PiDesktop/Models/Dtos.cs
index 3d72c163..ef1e6ea2 100644
--- a/src/PiDesktop/Models/Dtos.cs
+++ b/src/PiDesktop/Models/Dtos.cs
@@ -1,3 +1,4 @@
+using System.Text.Json;
 using System.Text.Json.Serialization;
 
 namespace PiDesktop.Models;
@@ -13,7 +14,121 @@ public sealed class ChatMessage
 public sealed class ComponentSpec
 {
     [JsonPropertyName("id")] public string Id { get; set; } = "";
+    [JsonPropertyName("kind")] public string Kind { get; set; } = "";
     [JsonPropertyName("display_name")] public string DisplayName { get; set; } = "";
     [JsonPropertyName("description")] public string Description { get; set; } = "";
+    [JsonPropertyName("version")] public string Version { get; set; } = "";
     [JsonPropertyName("audience")] public string Audience { get; set; } = "";
+    [JsonPropertyName("download_url")] public string DownloadUrl { get; set; } = "";
+    [JsonPropertyName("sha256")] public string? Sha256 { get; set; }
+    [JsonPropertyName("executable_relative_path")] public string? ExecutableRelativePath { get; set; }
+}
+
+/// <summary>Runtime state paired with a component catalog entry.</summary>
+public sealed class ComponentView
+{
+    [JsonPropertyName("spec")] public ComponentSpec Spec { get; set; } = new();
+    [JsonPropertyName("status")] public ComponentStatus Status { get; set; } = new();
+}
+
+/// <summary>Exact pi-agent component status JSON shape.</summary>
+public sealed class ComponentStatus
+{
+    [JsonPropertyName("id")] public string Id { get; set; } = "";
+    [JsonPropertyName("state")] public string State { get; set; } = "not-installed";
+    [JsonPropertyName("source")] public string Source { get; set; } = "unavailable";
+    [JsonPropertyName("installed_version")] public string? InstalledVersion { get; set; }
+    [JsonPropertyName("available_version")] public string? AvailableVersion { get; set; }
+    [JsonPropertyName("executable_dir")] public string? ExecutableDir { get; set; }
+    [JsonPropertyName("can_install")] public bool CanInstall { get; set; }
+    [JsonPropertyName("can_update")] public bool CanUpdate { get; set; }
+    [JsonPropertyName("can_uninstall")] public bool CanUninstall { get; set; }
+    [JsonPropertyName("error")] public string? Error { get; set; }
+}
+
+/// <summary>Stable machine-readable failure emitted by a native background job.</summary>
+public sealed class JobError
+{
+    [JsonPropertyName("code")] public string Code { get; set; } = "";
+    [JsonPropertyName("message")] public string Message { get; set; } = "";
+    [JsonPropertyName("details")] public string? Details { get; set; }
+}
+
+/// <summary>Pollable lifecycle or FFmpeg job state.</summary>
+public sealed class JobStatus
+{
+    [JsonPropertyName("id")] public string Id { get; set; } = "";
+    [JsonPropertyName("state")] public string State { get; set; } = "queued";
+    [JsonPropertyName("phase")] public string? Phase { get; set; }
+    [JsonPropertyName("progress")] public float? Progress { get; set; }
+    [JsonPropertyName("result")] public JsonElement? Result { get; set; }
+    [JsonPropertyName("error")] public JobError? Error { get; set; }
+
+    [JsonIgnore] public bool IsTerminal => State is "succeeded" or "failed" or "cancelled";
+}
+
+/// <summary>Result payload shared by all finite FFmpeg operations.</summary>
+public sealed class FfmpegOperationResult
+{
+    [JsonPropertyName("output_path")] public string? OutputPath { get; set; }
+    [JsonPropertyName("probe")] public FfmpegProbeResult? Probe { get; set; }
+    [JsonPropertyName("loudness")] public LoudnessAnalysisResult? Loudness { get; set; }
+}
+
+/// <summary>Normalized facts for the selected input audio stream.</summary>
+public sealed class FfmpegProbeResult
+{
+    [JsonPropertyName("container")] public string? Container { get; set; }
+    [JsonPropertyName("codec")] public string? Codec { get; set; }
+    [JsonPropertyName("duration_seconds")] public double? DurationSeconds { get; set; }
+    [JsonPropertyName("sample_rate")] public uint? SampleRate { get; set; }
+    [JsonPropertyName("channels")] public byte? Channels { get; set; }
+    [JsonPropertyName("bit_depth")] public ushort? BitDepth { get; set; }
+    [JsonPropertyName("bit_rate")] public ulong? BitRate { get; set; }
+}
+
+/// <summary>EBU R128 measurement values from FFmpeg.</summary>
+public sealed class LoudnessAnalysisResult
+{
+    [JsonPropertyName("integrated_lufs")] public double? IntegratedLufs { get; set; }
+    [JsonPropertyName("true_peak_db")] public double? TruePeakDb { get; set; }
+    [JsonPropertyName("loudness_range")] public double? LoudnessRange { get; set; }
+    [JsonPropertyName("threshold")] public double? Threshold { get; set; }
+}
+
+/// <summary>Base request JSON for a finite pi-agent FFmpeg operation.</summary>
+public abstract class FfmpegRequest
+{
+    [JsonPropertyName("operation")] public abstract string Operation { get; }
+    [JsonPropertyName("input")] public string Input { get; set; } = "";
+}
+
+public sealed class ProbeRequest : FfmpegRequest
+{
+    public override string Operation => "probe";
+}
+
+public sealed class PrepareRequest : FfmpegRequest
+{
+    public override string Operation => "prepare";
+    [JsonPropertyName("output_name")] public string OutputName { get; set; } = "";
+    [JsonPropertyName("sample_rate")] public uint? SampleRate { get; set; }
+    [JsonPropertyName("channels")] public byte? Channels { get; set; }
+    [JsonPropertyName("sample_format")] public string? SampleFormat { get; set; }
+    [JsonPropertyName("start_seconds")] public double? StartSeconds { get; set; }
+    [JsonPropertyName("duration_seconds")] public double? DurationSeconds { get; set; }
+}
+
+public sealed class LoudnessAnalyzeRequest : FfmpegRequest
+{
+    public override string Operation => "loudness_analyze";
+}
+
+public sealed class LoudnessNormalizeRequest : FfmpegRequest
+{
+    public override string Operation => "loudness_normalize";
+    [JsonPropertyName("output_name")] public string OutputName { get; set; } = "";
+    [JsonPropertyName("target_lufs")] public double TargetLufs { get; set; }
+    [JsonPropertyName("max_true_peak_db")] public double MaxTruePeakDb { get; set; }
+    [JsonPropertyName("target_lra")] public double TargetLra { get; set; }
 }
diff --git a/src/PiDesktop/PiDesktop.csproj b/src/PiDesktop/PiDesktop.csproj
index fae4b3bb..e9866b4f 100644
--- a/src/PiDesktop/PiDesktop.csproj
+++ b/src/PiDesktop/PiDesktop.csproj
@@ -20,6 +20,8 @@
     <RuntimeIdentifiers>win-x64;win-arm64</RuntimeIdentifiers>
     <RuntimeIdentifier Condition="'$(RuntimeIdentifier)' == '' and '$(Platform)' == 'x64'">win-x64</RuntimeIdentifier>
     <RuntimeIdentifier Condition="'$(RuntimeIdentifier)' == '' and '$(Platform)' == 'ARM64'">win-arm64</RuntimeIdentifier>
+    <PiAgentTargetTriple Condition="'$(PiAgentTargetTriple)' == '' and '$(Platform)' == 'x64'">x86_64-pc-windows-msvc</PiAgentTargetTriple>
+    <PiAgentTargetTriple Condition="'$(PiAgentTargetTriple)' == '' and '$(Platform)' == 'ARM64'">aarch64-pc-windows-msvc</PiAgentTargetTriple>
     <UseWinUI>true</UseWinUI>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
@@ -42,11 +44,17 @@
     首次会拉 crates，稍慢；之后增量很快。
   -->
   <Target Name="BuildPiAgentDll" BeforeTargets="Build">
-    <Exec Command="cargo build --release -p pi-agent-ffi" WorkingDirectory="$(PiAgentDir)" />
-    <Copy SourceFiles="$(PiAgentDir)\target\release\pi_agent.dll"
+    <Error Condition="'$(PiAgentTargetTriple)' == ''" Text="PiDesktop supports only x64 and ARM64 Platform/RuntimeIdentifier values." />
+    <Error Condition="'$(Platform)' == 'x64' and '$(RuntimeIdentifier)' != 'win-x64'"
+           Text="Platform x64 requires RuntimeIdentifier win-x64." />
+    <Error Condition="'$(Platform)' == 'ARM64' and '$(RuntimeIdentifier)' != 'win-arm64'"
+           Text="Platform ARM64 requires RuntimeIdentifier win-arm64." />
+    <Exec Command="cargo build --release --target $(PiAgentTargetTriple) -p pi-agent-ffi" WorkingDirectory="$(PiAgentDir)" />
+    <Error Condition="!Exists('$(PiAgentDir)\target\$(PiAgentTargetTriple)\release\pi_agent.dll')"
+           Text="cargo completed without the expected $(PiAgentTargetTriple) pi_agent.dll." />
+    <Copy SourceFiles="$(PiAgentDir)\target\$(PiAgentTargetTriple)\release\pi_agent.dll"
           DestinationFolder="$(OutDir)"
-          SkipUnchangedFiles="true"
-          Condition="Exists('$(PiAgentDir)\target\release\pi_agent.dll')" />
+          SkipUnchangedFiles="true" />
   </Target>
 
 </Project>
diff --git a/src/PiDesktop/Services/FfmpegService.cs b/src/PiDesktop/Services/FfmpegService.cs
new file mode 100644
index 00000000..1bccc7a7
--- /dev/null
+++ b/src/PiDesktop/Services/FfmpegService.cs
@@ -0,0 +1,215 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using PiDesktop.Models;
+
+namespace PiDesktop.Services;
+
+/// <summary>
+/// Process-wide, single-active-job access to pi-agent's component and FFmpeg job C ABI.
+/// Native calls and polling run away from the WinUI thread; callers receive only
+/// DTO snapshots through tasks and <see cref="IProgress{T}"/>.
+/// </summary>
+public sealed class FfmpegService : IDisposable
+{
+    private static readonly TimeSpan PollInterval = TimeSpan.FromMilliseconds(250);
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
+    };
+
+    private readonly object _jobLock = new();
+    private PiJobHandle? _currentJob;
+    private int _isBusy;
+    private bool _cancelRequested;
+    private volatile bool _disposed;
+
+    /// <summary>True while one lifecycle or audio job owns the native executor.</summary>
+    public bool IsBusy => Volatile.Read(ref _isBusy) != 0;
+
+    /// <summary>Gets the latest state for every component without modifying it.</summary>
+    public Task<IReadOnlyList<ComponentView>> RefreshStatusAsync(CancellationToken cancellationToken = default) =>
+        Task.Run(() =>
+        {
+            cancellationToken.ThrowIfCancellationRequested();
+            ThrowIfDisposed();
+            var json = NativeMethods.TakeString(NativeMethods.pi_components_status_json());
+            IReadOnlyList<ComponentView> components =
+                JsonSerializer.Deserialize<List<ComponentView>>(json, JsonOptions) ?? new List<ComponentView>();
+            return components;
+        }, cancellationToken);
+
+    public Task<JobStatus> InstallAsync(string componentId = "ffmpeg", IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) =>
+        StartComponentActionAsync(componentId, "install", progress, cancellationToken);
+
+    public Task<JobStatus> UpdateAsync(string componentId = "ffmpeg", IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) =>
+        StartComponentActionAsync(componentId, "update", progress, cancellationToken);
+
+    public Task<JobStatus> UninstallAsync(string componentId = "ffmpeg", IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) =>
+        StartComponentActionAsync(componentId, "uninstall", progress, cancellationToken);
+
+    public Task<FfmpegOperationResult> ProbeAsync(ProbeRequest request, IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) => StartFfmpegAsync(request, progress, cancellationToken);
+
+    public Task<FfmpegOperationResult> PrepareAsync(PrepareRequest request, IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) => StartFfmpegAsync(request, progress, cancellationToken);
+
+    public Task<FfmpegOperationResult> AnalyzeAsync(LoudnessAnalyzeRequest request, IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) => StartFfmpegAsync(request, progress, cancellationToken);
+
+    public Task<FfmpegOperationResult> NormalizeAsync(LoudnessNormalizeRequest request, IProgress<JobStatus>? progress = null,
+        CancellationToken cancellationToken = default) => StartFfmpegAsync(request, progress, cancellationToken);
+
+    /// <summary>Requests cancellation of the active native job. The final status still arrives through its task.</summary>
+    public Task<bool> CancelCurrent() => Task.FromResult(CancelCurrentCore());
+
+    private bool CancelCurrentCore()
+    {
+        PiJobHandle? job;
+        lock (_jobLock)
+        {
+            if (_isBusy == 0)
+                return false;
+            job = _currentJob;
+            if (job is null)
+            {
+                _cancelRequested = true;
+                return true;
+            }
+        }
+        if (job.IsInvalid || job.IsClosed) return false;
+
+        var addedRef = false;
+        try
+        {
+            try
+            {
+                job.DangerousAddRef(ref addedRef);
+            }
+            catch (ObjectDisposedException)
+            {
+                return false;
+            }
+            if (job.IsInvalid || job.IsClosed) return false;
+            NativeMethods.pi_job_cancel(job.DangerousGetHandle());
+            return true;
+        }
+        finally
+        {
+            if (addedRef) job.DangerousRelease();
+        }
+    }
+
+    private Task<JobStatus> StartComponentActionAsync(string componentId, string action,
+        IProgress<JobStatus>? progress, CancellationToken cancellationToken)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
+        return RunExclusiveAsync(
+            () => NativeMethods.pi_component_action_start(componentId, action), progress, cancellationToken);
+    }
+
+    private async Task<FfmpegOperationResult> StartFfmpegAsync(FfmpegRequest request,
+        IProgress<JobStatus>? progress, CancellationToken cancellationToken)
+    {
+        ArgumentNullException.ThrowIfNull(request);
+        ArgumentException.ThrowIfNullOrWhiteSpace(request.Input);
+        var requestJson = JsonSerializer.Serialize(request, request.GetType(), JsonOptions);
+        var status = await RunExclusiveAsync(
+            () => NativeMethods.pi_ffmpeg_job_start(requestJson), progress, cancellationToken).ConfigureAwait(false);
+        if (status.Result is not { } result)
+            return new FfmpegOperationResult();
+        return result.Deserialize<FfmpegOperationResult>(JsonOptions) ?? new FfmpegOperationResult();
+    }
+
+    private Task<JobStatus> RunExclusiveAsync(Func<IntPtr> start, IProgress<JobStatus>? progress,
+        CancellationToken cancellationToken)
+    {
+        ThrowIfDisposed();
+        lock (_jobLock)
+        {
+            ThrowIfDisposed();
+            if (_isBusy != 0)
+                return Task.FromException<JobStatus>(new InvalidOperationException(
+                    "Another FFmpeg or component job is already running."));
+            _cancelRequested = false;
+            Volatile.Write(ref _isBusy, 1);
+        }
+
+        return Task.Run(async () =>
+        {
+            try
+            {
+                cancellationToken.ThrowIfCancellationRequested();
+                ThrowIfDisposed();
+                var raw = start();
+                if (raw == IntPtr.Zero)
+                    throw new InvalidOperationException("pi-agent could not start the requested background job.");
+
+                using var job = new PiJobHandle(raw);
+                bool cancelForDispose;
+                lock (_jobLock)
+                {
+                    _currentJob = job;
+                    cancelForDispose = _disposed || _cancelRequested;
+                }
+                if (cancelForDispose)
+                    NativeMethods.pi_job_cancel(job.DangerousGetHandle());
+                using var registration = cancellationToken.Register(static state =>
+                    _ = ((FfmpegService)state!).CancelCurrent(), this);
+
+                while (true)
+                {
+                    var json = NativeMethods.TakeString(NativeMethods.pi_job_status_json(job.DangerousGetHandle()));
+                    var status = JsonSerializer.Deserialize<JobStatus>(json, JsonOptions)
+                        ?? throw new InvalidOperationException("pi-agent returned an empty job status.");
+                    progress?.Report(status);
+
+                    if (status.IsTerminal)
+                    {
+                        if (status.State != "succeeded")
+                        {
+                            if (status.State == "cancelled" && cancellationToken.IsCancellationRequested)
+                                throw new OperationCanceledException(cancellationToken);
+                            throw new FfmpegJobException(status);
+                        }
+                        return status;
+                    }
+                    await Task.Delay(PollInterval, CancellationToken.None).ConfigureAwait(false);
+                }
+            }
+            finally
+            {
+                lock (_jobLock)
+                {
+                    _currentJob = null;
+                    _cancelRequested = false;
+                    Volatile.Write(ref _isBusy, 0);
+                }
+            }
+        }, CancellationToken.None);
+    }
+
+    public void Dispose()
+    {
+        if (_disposed) return;
+        _disposed = true;
+        _ = CancelCurrent();
+    }
+
+    private void ThrowIfDisposed()
+    {
+        ObjectDisposedException.ThrowIf(_disposed, this);
+    }
+}
+
+/// <summary>A failed or user-cancelled native job with its original structured status.</summary>
+public sealed class FfmpegJobException : Exception
+{
+    public FfmpegJobException(JobStatus status)
+        : base(status.Error?.Message ?? $"FFmpeg job ended with state '{status.State}'.") => Status = status;
+
+    public JobStatus Status { get; }
+    public JobError? Error => Status.Error;
+}
diff --git a/src/PiDesktop/Services/NativeMethods.cs b/src/PiDesktop/Services/NativeMethods.cs
index 311c53d0..e50a1d22 100644
--- a/src/PiDesktop/Services/NativeMethods.cs
+++ b/src/PiDesktop/Services/NativeMethods.cs
@@ -35,6 +35,24 @@ internal static partial class NativeMethods
     [LibraryImport(Dll)]
     internal static partial IntPtr pi_components_json();
 
+    [LibraryImport(Dll)]
+    internal static partial IntPtr pi_components_status_json();
+
+    [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)]
+    internal static partial IntPtr pi_component_action_start(string componentIdUtf8, string actionUtf8);
+
+    [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)]
+    internal static partial IntPtr pi_ffmpeg_job_start(string requestJsonUtf8);
+
+    [LibraryImport(Dll)]
+    internal static partial IntPtr pi_job_status_json(IntPtr job);
+
+    [LibraryImport(Dll)]
+    internal static partial void pi_job_cancel(IntPtr job);
+
+    [LibraryImport(Dll)]
+    internal static partial void pi_job_destroy(IntPtr job);
+
     [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)]
     internal static partial IntPtr pi_bridge_connect(string bridgeRepoDirUtf8);
 
diff --git a/src/PiDesktop/Services/PiJobHandle.cs b/src/PiDesktop/Services/PiJobHandle.cs
new file mode 100644
index 00000000..1d83cd3e
--- /dev/null
+++ b/src/PiDesktop/Services/PiJobHandle.cs
@@ -0,0 +1,17 @@
+using Microsoft.Win32.SafeHandles;
+
+namespace PiDesktop.Services;
+
+/// <summary>Owns one native <c>PiJob*</c> and destroys it exactly once.</summary>
+internal sealed class PiJobHandle : SafeHandleZeroOrMinusOneIsInvalid
+{
+    internal PiJobHandle() : base(ownsHandle: true) { }
+
+    internal PiJobHandle(IntPtr handle) : base(ownsHandle: true) => SetHandle(handle);
+
+    protected override bool ReleaseHandle()
+    {
+        NativeMethods.pi_job_destroy(handle);
+        return true;
+    }
+}
diff --git a/src/PiDesktop/Views/AudioPreparationPage.xaml b/src/PiDesktop/Views/AudioPreparationPage.xaml
new file mode 100644
index 00000000..843571b0
--- /dev/null
+++ b/src/PiDesktop/Views/AudioPreparationPage.xaml
@@ -0,0 +1,205 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Page
+    x:Class="PiDesktop.Views.AudioPreparationPage"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    NavigationCacheMode="Required"
+    Loaded="Page_Loaded">
+
+    <ScrollViewer>
+        <StackPanel Margin="20" Spacing="16" MaxWidth="920" HorizontalAlignment="Left">
+            <StackPanel Spacing="4">
+                <TextBlock Text="音频准备" Style="{ThemeResource TitleTextBlockStyle}" />
+                <TextBlock Text="检测、转换和试听本地音频。源文件不会被修改，SynthV 中的实时编辑也不会受到影响。"
+                           TextWrapping="Wrap" Opacity="0.72" />
+            </StackPanel>
+
+            <InfoBar x:Name="PageInfoBar" IsOpen="False" IsClosable="True" />
+
+            <Border x:Name="SetupCard" Padding="18" CornerRadius="10"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="10">
+                    <TextBlock Text="启用本地音频处理" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <TextBlock Text="需要本地 FFmpeg 组件。它只在本机处理音频，不上传文件，也不会修改系统 PATH。"
+                               TextWrapping="Wrap" Opacity="0.72" />
+                    <TextBlock x:Name="ComponentStatusText" Text="正在检查…" TextWrapping="Wrap" />
+                    <StackPanel Orientation="Horizontal" Spacing="8">
+                        <Button x:Name="InstallButton" Content="安装本地组件" Click="InstallButton_Click"
+                                Style="{ThemeResource AccentButtonStyle}" />
+                        <Button x:Name="RefreshComponentButton" Content="刷新状态" Click="RefreshComponentButton_Click" />
+                        <Button x:Name="SetupCancelButton" Content="取消" Click="CancelJob_Click" Visibility="Collapsed" />
+                    </StackPanel>
+                    <ProgressBar x:Name="SetupProgress" Minimum="0" Maximum="100" Visibility="Collapsed" />
+                    <Expander Header="高级信息">
+                        <TextBlock x:Name="ComponentDetailsText" TextWrapping="Wrap" Opacity="0.7" />
+                    </Expander>
+                </StackPanel>
+            </Border>
+
+            <Border x:Name="InputCard" Padding="18" CornerRadius="10" AllowDrop="True"
+                    DragOver="InputCard_DragOver" Drop="InputCard_Drop"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="10">
+                    <TextBlock Text="1. 选择音频" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <TextBlock Text="选择一个本地音频或包含音频的视频，也可以把单个文件拖到这里。"
+                               TextWrapping="Wrap" Opacity="0.72" />
+                    <StackPanel Orientation="Horizontal" Spacing="8">
+                        <Button x:Name="ChooseFileButton" Content="选择文件" Click="ChooseFileButton_Click"
+                                Style="{ThemeResource AccentButtonStyle}" />
+                        <Button x:Name="AnalyzeAgainButton" Content="重新检测" Click="AnalyzeAgainButton_Click"
+                                Visibility="Collapsed" />
+                    </StackPanel>
+                    <TextBlock x:Name="SelectedFileText" Text="尚未选择文件" TextWrapping="Wrap" />
+                    <Grid x:Name="ProbeDetailsGrid" Visibility="Collapsed" ColumnSpacing="24" RowSpacing="5">
+                        <Grid.ColumnDefinitions>
+                            <ColumnDefinition Width="Auto" />
+                            <ColumnDefinition Width="*" />
+                        </Grid.ColumnDefinitions>
+                        <Grid.RowDefinitions>
+                            <RowDefinition Height="Auto" />
+                            <RowDefinition Height="Auto" />
+                            <RowDefinition Height="Auto" />
+                            <RowDefinition Height="Auto" />
+                        </Grid.RowDefinitions>
+                        <TextBlock Grid.Row="0" Grid.Column="0" Text="时长" Opacity="0.62" />
+                        <TextBlock Grid.Row="0" Grid.Column="1" x:Name="DurationText" />
+                        <TextBlock Grid.Row="1" Grid.Column="0" Text="格式" Opacity="0.62" />
+                        <TextBlock Grid.Row="1" Grid.Column="1" x:Name="FormatText" />
+                        <TextBlock Grid.Row="2" Grid.Column="0" Text="采样率" Opacity="0.62" />
+                        <TextBlock Grid.Row="2" Grid.Column="1" x:Name="SampleRateText" />
+                        <TextBlock Grid.Row="3" Grid.Column="0" Text="声道" Opacity="0.62" />
+                        <TextBlock Grid.Row="3" Grid.Column="1" x:Name="ChannelsText" />
+                    </Grid>
+                </StackPanel>
+            </Border>
+
+            <Border x:Name="TaskCard" Padding="18" CornerRadius="10" IsEnabled="False"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="12">
+                    <TextBlock Text="2. 选择任务" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <RadioButtons x:Name="TaskSelector" SelectionChanged="TaskSelector_SelectionChanged"
+                                  SelectedIndex="0" MaxColumns="2">
+                        <x:String>为 SynthV 准备音频</x:String>
+                        <x:String>检查 / 平衡响度</x:String>
+                    </RadioButtons>
+
+                    <StackPanel x:Name="PreparePanel" Spacing="10">
+                        <TextBlock Text="生成新的 PCM WAV；默认保持原采样率和声道，不裁剪。"
+                                   TextWrapping="Wrap" Opacity="0.72" />
+                        <Expander Header="高级设置">
+                            <StackPanel Spacing="10" Padding="0,8,0,0">
+                                <ComboBox x:Name="SampleRateBox" Header="采样率" SelectedIndex="0"
+                                          SelectionChanged="PrepareSettings_Changed">
+                                    <ComboBoxItem Content="保持原采样率" Tag="keep" />
+                                    <ComboBoxItem Content="44.1 kHz" Tag="44100" />
+                                    <ComboBoxItem Content="48 kHz" Tag="48000" />
+                                    <ComboBoxItem Content="96 kHz" Tag="96000" />
+                                </ComboBox>
+                                <ComboBox x:Name="ChannelsBox" Header="声道" SelectedIndex="0"
+                                          SelectionChanged="PrepareSettings_Changed">
+                                    <ComboBoxItem Content="保持原声道" Tag="keep" />
+                                    <ComboBoxItem Content="单声道" Tag="1" />
+                                    <ComboBoxItem Content="立体声" Tag="2" />
+                                </ComboBox>
+                                <ComboBox x:Name="SampleFormatBox" Header="采样格式" SelectedIndex="1"
+                                          SelectionChanged="PrepareSettings_Changed">
+                                    <ComboBoxItem Content="16-bit PCM" Tag="s16" />
+                                    <ComboBoxItem Content="24-bit PCM（推荐）" Tag="s24" />
+                                    <ComboBoxItem Content="32-bit float PCM" Tag="f32" />
+                                </ComboBox>
+                                <Grid ColumnSpacing="12">
+                                    <Grid.ColumnDefinitions>
+                                        <ColumnDefinition Width="*" />
+                                        <ColumnDefinition Width="*" />
+                                    </Grid.ColumnDefinitions>
+                                    <NumberBox x:Name="StartSecondsBox" Grid.Column="0" Header="从第几秒开始（可选）"
+                                               Minimum="0" SpinButtonPlacementMode="Compact"
+                                               ValueChanged="PrepareNumber_ValueChanged" />
+                                    <NumberBox x:Name="DurationSecondsBox" Grid.Column="1" Header="保留多少秒（可选）"
+                                               Minimum="0.001" SpinButtonPlacementMode="Compact"
+                                               ValueChanged="PrepareNumber_ValueChanged" />
+                                </Grid>
+                            </StackPanel>
+                        </Expander>
+                        <TextBlock x:Name="PrepareSummaryText" TextWrapping="Wrap" />
+                        <Button x:Name="PrepareButton" Content="查看计划并开始" Click="PrepareButton_Click"
+                                HorizontalAlignment="Left" Style="{ThemeResource AccentButtonStyle}" />
+                    </StackPanel>
+
+                    <StackPanel x:Name="LoudnessPanel" Spacing="10" Visibility="Collapsed">
+                        <TextBlock Text="先测量，不会修改文件。只有你确认后才会生成平衡响度的新文件。"
+                                   TextWrapping="Wrap" Opacity="0.72" />
+                        <Button x:Name="AnalyzeLoudnessButton" Content="检查响度" Click="AnalyzeLoudnessButton_Click"
+                                HorizontalAlignment="Left" />
+                        <Border x:Name="LoudnessResultCard" Padding="12" CornerRadius="8" Visibility="Collapsed"
+                                Background="{ThemeResource SubtleFillColorSecondaryBrush}">
+                            <StackPanel Spacing="6">
+                                <TextBlock x:Name="LoudnessSummaryText" TextWrapping="Wrap" />
+                                <TextBlock x:Name="LoudnessNumbersText" TextWrapping="Wrap" Opacity="0.72" />
+                            </StackPanel>
+                        </Border>
+                        <Expander Header="平衡响度设置">
+                            <StackPanel Spacing="10" Padding="0,8,0,0">
+                                <TextBlock Text="通用试听预设，不是 SynthV 强制标准。" Opacity="0.72" />
+                                <NumberBox x:Name="TargetLufsBox" Header="目标响度（LUFS）" Value="-16"
+                                           Minimum="-70" Maximum="-5" SpinButtonPlacementMode="Compact" />
+                                <NumberBox x:Name="TruePeakBox" Header="最大真峰值（dBTP）" Value="-1.5"
+                                           Minimum="-9" Maximum="0" SpinButtonPlacementMode="Compact" />
+                                <NumberBox x:Name="TargetLraBox" Header="目标动态范围（LRA）" Value="11"
+                                           Minimum="1" Maximum="50" SpinButtonPlacementMode="Compact" />
+                            </StackPanel>
+                        </Expander>
+                        <Button x:Name="NormalizeButton" Content="查看计划并平衡响度"
+                                Click="NormalizeButton_Click" HorizontalAlignment="Left"
+                                Style="{ThemeResource AccentButtonStyle}" IsEnabled="False" />
+                    </StackPanel>
+                </StackPanel>
+            </Border>
+
+            <Border x:Name="ProgressCard" Padding="18" CornerRadius="10" Visibility="Collapsed"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="10">
+                    <TextBlock Text="正在处理" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <TextBlock x:Name="JobStatusText" TextWrapping="Wrap" />
+                    <ProgressBar x:Name="JobProgress" Minimum="0" Maximum="100" />
+                    <Button Content="取消" Click="CancelJob_Click" HorizontalAlignment="Left" />
+                </StackPanel>
+            </Border>
+
+            <Border x:Name="ResultCard" Padding="18" CornerRadius="10" Visibility="Collapsed"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="12">
+                    <TextBlock Text="3. 处理结果" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <TextBlock x:Name="ResultSummaryText" TextWrapping="Wrap" />
+                    <Grid ColumnSpacing="12">
+                        <Grid.ColumnDefinitions>
+                            <ColumnDefinition Width="*" />
+                            <ColumnDefinition Width="*" />
+                        </Grid.ColumnDefinitions>
+                        <StackPanel Grid.Column="0" Spacing="6">
+                            <TextBlock Text="原始音频" FontWeight="SemiBold" />
+                            <MediaPlayerElement x:Name="OriginalPlayer" AreTransportControlsEnabled="True"
+                                                AutoPlay="False" Height="72" />
+                        </StackPanel>
+                        <StackPanel Grid.Column="1" Spacing="6">
+                            <TextBlock Text="处理结果" FontWeight="SemiBold" />
+                            <MediaPlayerElement x:Name="ResultPlayer" AreTransportControlsEnabled="True"
+                                                AutoPlay="False" Height="72" />
+                        </StackPanel>
+                    </Grid>
+                    <StackPanel Orientation="Horizontal" Spacing="8">
+                        <Button Content="打开文件位置" Click="OpenLocationButton_Click" />
+                        <Button Content="复制路径" Click="CopyPathButton_Click" />
+                        <Button Content="另存为" Click="SaveAsButton_Click"
+                                Style="{ThemeResource AccentButtonStyle}" />
+                    </StackPanel>
+                </StackPanel>
+            </Border>
+        </StackPanel>
+    </ScrollViewer>
+</Page>
diff --git a/src/PiDesktop/Views/AudioPreparationPage.xaml.cs b/src/PiDesktop/Views/AudioPreparationPage.xaml.cs
new file mode 100644
index 00000000..20a8e6ff
--- /dev/null
+++ b/src/PiDesktop/Views/AudioPreparationPage.xaml.cs
@@ -0,0 +1,774 @@
+using System.Diagnostics;
+using System.Globalization;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Media;
+using PiDesktop.Models;
+using PiDesktop.Services;
+using Windows.ApplicationModel.DataTransfer;
+using Windows.Media.Core;
+using Windows.Storage;
+using Windows.Storage.Pickers;
+
+namespace PiDesktop.Views;
+
+public sealed partial class AudioPreparationPage : Page
+{
+    private ComponentView? _ffmpeg;
+    private StorageFile? _inputFile;
+    private FfmpegProbeResult? _probe;
+    private LoudnessAnalysisResult? _inputLoudness;
+    private LoudnessAnalysisResult? _outputLoudness;
+    private string? _outputPath;
+    private string _setupAction = "install";
+    private Guid? _globalJobToken;
+    private bool _operationRunning;
+    private bool _loaded;
+
+    public AudioPreparationPage() => InitializeComponent();
+
+    private bool IsFfmpegReady => string.Equals(_ffmpeg?.Status.State, "ready", StringComparison.Ordinal);
+
+    private async void Page_Loaded(object sender, RoutedEventArgs e)
+    {
+        if (_loaded)
+            return;
+
+        _loaded = true;
+        UpdatePrepareSummary();
+        await RefreshComponentStatusAsync();
+    }
+
+    private async Task RefreshComponentStatusAsync()
+    {
+        try
+        {
+            var components = await App.Ffmpeg.RefreshStatusAsync();
+            _ffmpeg = components.FirstOrDefault(component =>
+                string.Equals(component.Spec.Id, "ffmpeg", StringComparison.OrdinalIgnoreCase));
+
+            if (_ffmpeg is null)
+            {
+                ComponentStatusText.Text = "当前运行时没有提供 FFmpeg 组件。";
+                ComponentDetailsText.Text = "请确认 pi-agent 与 Desktop 来自同一版本。";
+                InstallButton.Visibility = Visibility.Collapsed;
+                UpdateTaskAvailability();
+                return;
+            }
+
+            var status = _ffmpeg.Status;
+            ComponentStatusText.Text = DescribeComponentStatus(status);
+            ComponentDetailsText.Text = BuildComponentDetails(status);
+
+            _setupAction = status.CanUpdate ? "update" : "install";
+            InstallButton.Content = _setupAction == "update" ? "更新本地组件" : "安装本地组件";
+            InstallButton.Visibility = status.CanInstall || status.CanUpdate
+                ? Visibility.Visible
+                : Visibility.Collapsed;
+            InstallButton.IsEnabled = !_operationRunning;
+
+            if (string.Equals(status.State, "failed", StringComparison.Ordinal) && !string.IsNullOrWhiteSpace(status.Error))
+                ShowInfo(InfoBarSeverity.Error, "FFmpeg 组件不可用", status.Error);
+
+            UpdateTaskAvailability();
+            if (IsFfmpegReady && _inputFile is not null && _probe is null && !_operationRunning)
+                await ProbeInputAsync();
+        }
+        catch (Exception ex)
+        {
+            ComponentStatusText.Text = "无法读取 FFmpeg 状态。";
+            ComponentDetailsText.Text = ex.Message;
+            InstallButton.Visibility = Visibility.Collapsed;
+            UpdateTaskAvailability();
+        }
+    }
+
+    private async void InstallButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (_operationRunning)
+            return;
+        if (App.Ffmpeg.IsBusy)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "已有任务正在运行", "请回到启动该任务的页面等待或取消，然后再试。");
+            return;
+        }
+
+        var verb = _setupAction == "update" ? "更新" : "安装";
+        var confirmed = await ConfirmAsync(
+            $"{verb} FFmpeg 组件？",
+            _setupAction == "update"
+                ? "Pi Desktop 将更新自己的私有 FFmpeg 副本。系统 PATH 和系统安装不会被修改。"
+                : "Pi Desktop 将下载并安装一个经过校验的私有 FFmpeg 副本。文件保存在当前用户目录中，不会修改系统 PATH。",
+            verb);
+        if (!confirmed)
+            return;
+
+        _operationRunning = true;
+        SetInteractiveState();
+        SetupProgress.Visibility = Visibility.Visible;
+        SetupProgress.IsIndeterminate = true;
+        SetupCancelButton.Visibility = Visibility.Visible;
+        ComponentStatusText.Text = $"正在{verb}…";
+        BeginGlobalJob($"正在{verb} FFmpeg…");
+
+        var progress = new Progress<JobStatus>(UpdateSetupProgress);
+        try
+        {
+            if (_setupAction == "update")
+                await App.Ffmpeg.UpdateAsync(progress: progress);
+            else
+                await App.Ffmpeg.InstallAsync(progress: progress);
+
+            ShowInfo(InfoBarSeverity.Success, $"FFmpeg 已{verb}", "现在可以在本机检测和处理音频。源文件不会被修改。");
+        }
+        catch (FfmpegJobException ex)
+        {
+            ShowJobFailure(ex, $"{verb} FFmpeg");
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Error, $"无法{verb} FFmpeg", ex.Message);
+        }
+        finally
+        {
+            _operationRunning = false;
+            EndGlobalJob();
+            SetupProgress.Visibility = Visibility.Collapsed;
+            SetupCancelButton.Visibility = Visibility.Collapsed;
+            SetInteractiveState();
+            await RefreshComponentStatusAsync();
+        }
+    }
+
+    private async void RefreshComponentButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (!_operationRunning)
+            await RefreshComponentStatusAsync();
+    }
+
+    private async void ChooseFileButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (_operationRunning)
+            return;
+
+        var picker = new FileOpenPicker
+        {
+            ViewMode = PickerViewMode.List,
+            SuggestedStartLocation = PickerLocationId.MusicLibrary,
+        };
+        picker.FileTypeFilter.Add("*");
+        InitializePicker(picker);
+
+        var file = await picker.PickSingleFileAsync();
+        if (file is not null)
+            await SelectInputAsync(file);
+    }
+
+    private void InputCard_DragOver(object sender, DragEventArgs e)
+    {
+        if (_operationRunning || !e.DataView.Contains(StandardDataFormats.StorageItems))
+            return;
+
+        e.AcceptedOperation = DataPackageOperation.Copy;
+        e.DragUIOverride.Caption = "使用此文件";
+        e.DragUIOverride.IsCaptionVisible = true;
+    }
+
+    private async void InputCard_Drop(object sender, DragEventArgs e)
+    {
+        if (_operationRunning || !e.DataView.Contains(StandardDataFormats.StorageItems))
+            return;
+
+        var items = await e.DataView.GetStorageItemsAsync();
+        var files = items.OfType<StorageFile>().ToList();
+        if (files.Count != 1)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "请选择一个文件", "当前版本一次只处理一个本地文件。");
+            return;
+        }
+
+        await SelectInputAsync(files[0]);
+    }
+
+    private async Task SelectInputAsync(StorageFile file)
+    {
+        if (string.IsNullOrWhiteSpace(file.Path))
+        {
+            ShowInfo(InfoBarSeverity.Warning, "无法使用此文件", "请选择具有本地绝对路径的文件。");
+            return;
+        }
+
+        _inputFile = file;
+        _probe = null;
+        _inputLoudness = null;
+        _outputLoudness = null;
+        _outputPath = null;
+
+        SelectedFileText.Text = file.Path;
+        AnalyzeAgainButton.Visibility = Visibility.Visible;
+        ProbeDetailsGrid.Visibility = Visibility.Collapsed;
+        LoudnessResultCard.Visibility = Visibility.Collapsed;
+        NormalizeButton.IsEnabled = false;
+        ResultCard.Visibility = Visibility.Collapsed;
+        OriginalPlayer.Source = MediaSource.CreateFromStorageFile(file);
+        ResultPlayer.Source = null;
+        UpdateTaskAvailability();
+
+        if (!IsFfmpegReady)
+        {
+            ShowInfo(InfoBarSeverity.Informational, "先启用 FFmpeg", "文件已选择。组件就绪后会自动检测格式。");
+            return;
+        }
+
+        await ProbeInputAsync();
+    }
+
+    private async void AnalyzeAgainButton_Click(object sender, RoutedEventArgs e) => await ProbeInputAsync();
+
+    private async Task ProbeInputAsync()
+    {
+        if (_inputFile is null || !IsFfmpegReady || _operationRunning)
+            return;
+
+        var result = await RunAudioJobAsync(
+            "正在检测音频格式…",
+            progress => App.Ffmpeg.ProbeAsync(new ProbeRequest { Input = _inputFile.Path }, progress));
+        if (result?.Probe is null)
+        {
+            _probe = null;
+            UpdateTaskAvailability();
+            return;
+        }
+
+        _probe = result.Probe;
+        DurationText.Text = FormatDuration(_probe.DurationSeconds);
+        FormatText.Text = JoinKnown(_probe.Container, _probe.Codec);
+        SampleRateText.Text = _probe.SampleRate is { } rate ? $"{rate:N0} Hz" : "未知";
+        ChannelsText.Text = DescribeChannels(_probe.Channels);
+        ProbeDetailsGrid.Visibility = Visibility.Visible;
+        UpdatePrepareSummary();
+        UpdateTaskAvailability();
+        ShowInfo(InfoBarSeverity.Success, "音频检测完成", "可以选择准备音频，或先检查响度。");
+    }
+
+    private void TaskSelector_SelectionChanged(object sender, SelectionChangedEventArgs e)
+    {
+        if (PreparePanel is null || LoudnessPanel is null)
+            return;
+
+        var loudness = TaskSelector.SelectedIndex == 1;
+        PreparePanel.Visibility = loudness ? Visibility.Collapsed : Visibility.Visible;
+        LoudnessPanel.Visibility = loudness ? Visibility.Visible : Visibility.Collapsed;
+        UpdatePrepareSummary();
+    }
+
+    private void PrepareSettings_Changed(object sender, SelectionChangedEventArgs e) => UpdatePrepareSummary();
+
+    private void PrepareNumber_ValueChanged(NumberBox sender, NumberBoxValueChangedEventArgs args) => UpdatePrepareSummary();
+
+    private void UpdatePrepareSummary()
+    {
+        if (PrepareSummaryText is null || SampleRateBox is null || ChannelsBox is null || SampleFormatBox is null)
+            return;
+
+        var sampleRate = SelectedTag(SampleRateBox) == "keep"
+            ? _probe?.SampleRate is { } rate ? $"保持 {rate:N0} Hz" : "保持原采样率"
+            : $"转换为 {SelectedTag(SampleRateBox)} Hz";
+        var channels = SelectedTag(ChannelsBox) switch
+        {
+            "1" => "单声道",
+            "2" => "立体声",
+            _ => "保持原声道",
+        };
+        var format = SelectedTag(SampleFormatBox) switch
+        {
+            "s16" => "16-bit PCM",
+            "f32" => "32-bit float PCM",
+            _ => "24-bit PCM",
+        };
+        var trim = OptionalValue(StartSecondsBox) is null && OptionalValue(DurationSecondsBox) is null
+            ? "不裁剪"
+            : $"从 {OptionalValue(StartSecondsBox) ?? 0:0.###} 秒开始"
+              + (OptionalValue(DurationSecondsBox) is { } duration ? $"，保留 {duration:0.###} 秒" : "");
+
+        PrepareSummaryText.Text = $"计划：{sampleRate}，{channels}，{format}，{trim}。将生成新的 WAV，源文件保持不变。";
+    }
+
+    private async void PrepareButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (!CanProcessInput())
+            return;
+
+        var outputName = BuildOutputName("synthv");
+        var request = new PrepareRequest
+        {
+            Input = _inputFile!.Path,
+            OutputName = outputName,
+            SampleRate = ParseOptionalUInt(SelectedTag(SampleRateBox)),
+            Channels = ParseOptionalByte(SelectedTag(ChannelsBox)),
+            SampleFormat = SelectedTag(SampleFormatBox),
+            StartSeconds = OptionalValue(StartSecondsBox),
+            DurationSeconds = OptionalValue(DurationSecondsBox),
+        };
+
+        var plannedPath = Path.Combine(OutputDirectory, outputName);
+        var confirmed = await ConfirmAsync(
+            "生成 SynthV 用音频？",
+            $"输入：{request.Input}\n\n{PrepareSummaryText.Text}\n\n输出：{plannedPath}\n\n这一步不会导入 SynthV，也不会修改当前工程。",
+            "生成新文件");
+        if (!confirmed)
+            return;
+
+        var result = await RunAudioJobAsync(
+            "正在生成 PCM WAV…",
+            progress => App.Ffmpeg.PrepareAsync(request, progress));
+        if (string.IsNullOrWhiteSpace(result?.OutputPath))
+            return;
+
+        _outputPath = result.OutputPath;
+        await ShowResultAsync("已生成供 SynthV 使用的 PCM WAV。源文件和当前 SynthV 工程均未修改。");
+    }
+
+    private async void AnalyzeLoudnessButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (!CanProcessInput())
+            return;
+
+        var result = await RunAudioJobAsync(
+            "正在测量响度（只读）…",
+            progress => App.Ffmpeg.AnalyzeAsync(
+                new LoudnessAnalyzeRequest { Input = _inputFile!.Path }, progress));
+        if (result?.Loudness is null)
+            return;
+
+        _inputLoudness = result.Loudness;
+        _outputLoudness = null;
+        UpdateLoudnessCard();
+        NormalizeButton.IsEnabled = !_operationRunning;
+        ShowInfo(InfoBarSeverity.Success, "响度检查完成", "测量过程没有修改文件。你可以查看参数后再决定是否生成平衡响度的新文件。");
+    }
+
+    private async void NormalizeButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (!CanProcessInput() || _inputLoudness is null)
+            return;
+
+        if (!TryReadTargets(out var targetLufs, out var truePeak, out var targetLra))
+            return;
+
+        var outputName = BuildOutputName("normalized");
+        var plannedPath = Path.Combine(OutputDirectory, outputName);
+        var confirmed = await ConfirmAsync(
+            "生成平衡响度的新文件？",
+            $"输入：{_inputFile!.Path}\n\n目标：{targetLufs:0.0} LUFS，真峰值不高于 {truePeak:0.0} dBTP，LRA {targetLra:0.0}。"
+            + $"\n这是通用试听预设，不是 SynthV 强制标准。\n\n输出：{plannedPath}\n\n源文件不会被覆盖。",
+            "平衡响度");
+        if (!confirmed)
+            return;
+
+        var request = new LoudnessNormalizeRequest
+        {
+            Input = _inputFile.Path,
+            OutputName = outputName,
+            TargetLufs = targetLufs,
+            MaxTruePeakDb = truePeak,
+            TargetLra = targetLra,
+        };
+        var result = await RunAudioJobAsync(
+            "正在平衡响度…",
+            progress => App.Ffmpeg.NormalizeAsync(request, progress));
+        if (string.IsNullOrWhiteSpace(result?.OutputPath))
+            return;
+
+        _outputPath = result.OutputPath;
+        var after = await RunAudioJobAsync(
+            "正在复测输出响度…",
+            progress => App.Ffmpeg.AnalyzeAsync(
+                new LoudnessAnalyzeRequest { Input = _outputPath }, progress));
+        _outputLoudness = after?.Loudness;
+        UpdateLoudnessCard();
+
+        var summary = _outputLoudness is null
+            ? "已生成平衡响度的新文件；输出复测未完成，但文件仍可试听或另存。"
+            : $"已生成并复测：综合响度 {FormatMetric(_inputLoudness.IntegratedLufs)} → {FormatMetric(_outputLoudness.IntegratedLufs)} LUFS。";
+        await ShowResultAsync(summary);
+    }
+
+    private async Task<FfmpegOperationResult?> RunAudioJobAsync(
+        string initialStatus,
+        Func<IProgress<JobStatus>, Task<FfmpegOperationResult>> start)
+    {
+        if (_operationRunning)
+            return null;
+        if (App.Ffmpeg.IsBusy)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "已有任务正在运行", "请回到启动该任务的页面等待或取消，然后再试。");
+            return null;
+        }
+
+        _operationRunning = true;
+        SetInteractiveState();
+        ProgressCard.Visibility = Visibility.Visible;
+        JobStatusText.Text = initialStatus;
+        JobProgress.IsIndeterminate = true;
+        BeginGlobalJob(initialStatus);
+        var progress = new Progress<JobStatus>(UpdateAudioProgress);
+
+        try
+        {
+            return await start(progress);
+        }
+        catch (FfmpegJobException ex)
+        {
+            ShowJobFailure(ex, "处理音频");
+            return null;
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Error, "无法处理音频", ex.Message);
+            return null;
+        }
+        finally
+        {
+            _operationRunning = false;
+            EndGlobalJob();
+            ProgressCard.Visibility = Visibility.Collapsed;
+            SetInteractiveState();
+        }
+    }
+
+    private void UpdateAudioProgress(JobStatus status)
+    {
+        JobProgress.IsIndeterminate = status.Progress is null;
+        if (status.Progress is { } progress)
+            JobProgress.Value = Math.Clamp(progress, 0, 1) * 100;
+        JobStatusText.Text = DescribePhase(status.Phase);
+        UpdateGlobalJob(JobStatusText.Text);
+    }
+
+    private void UpdateSetupProgress(JobStatus status)
+    {
+        SetupProgress.IsIndeterminate = status.Progress is null;
+        if (status.Progress is { } progress)
+            SetupProgress.Value = Math.Clamp(progress, 0, 1) * 100;
+        ComponentStatusText.Text = DescribePhase(status.Phase);
+        UpdateGlobalJob(ComponentStatusText.Text);
+    }
+
+    private async void CancelJob_Click(object sender, RoutedEventArgs e)
+    {
+        var requested = await App.Ffmpeg.CancelCurrent();
+        ShowInfo(
+            requested ? InfoBarSeverity.Informational : InfoBarSeverity.Warning,
+            requested ? "已请求取消" : "没有可取消的任务",
+            requested ? "正在等待当前安全步骤结束。" : "任务可能已经结束，请稍后查看状态。");
+    }
+
+    private void UpdateLoudnessCard()
+    {
+        if (_inputLoudness is null)
+        {
+            LoudnessResultCard.Visibility = Visibility.Collapsed;
+            return;
+        }
+
+        LoudnessResultCard.Visibility = Visibility.Visible;
+        LoudnessSummaryText.Text = _outputLoudness is null ? "输入文件测量值" : "输入与输出复测对比";
+        var before = FormatLoudness("输入", _inputLoudness);
+        LoudnessNumbersText.Text = _outputLoudness is null
+            ? before
+            : before + "\n" + FormatLoudness("输出", _outputLoudness);
+    }
+
+    private async Task ShowResultAsync(string summary)
+    {
+        if (string.IsNullOrWhiteSpace(_outputPath))
+            return;
+
+        ResultSummaryText.Text = summary + $"\n{_outputPath}";
+        ResultCard.Visibility = Visibility.Visible;
+        try
+        {
+            var outputFile = await StorageFile.GetFileFromPathAsync(_outputPath);
+            ResultPlayer.Source = MediaSource.CreateFromStorageFile(outputFile);
+            if (_inputFile is not null)
+                OriginalPlayer.Source = MediaSource.CreateFromStorageFile(_inputFile);
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "文件已生成，但无法加载内置试听", ex.Message);
+        }
+    }
+
+    private void OpenLocationButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (string.IsNullOrWhiteSpace(_outputPath))
+            return;
+
+        try
+        {
+            Process.Start(new ProcessStartInfo
+            {
+                FileName = "explorer.exe",
+                Arguments = $"/select,\"{_outputPath}\"",
+                UseShellExecute = true,
+            });
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Error, "无法打开文件位置", ex.Message);
+        }
+    }
+
+    private void CopyPathButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (string.IsNullOrWhiteSpace(_outputPath))
+            return;
+
+        var package = new DataPackage();
+        package.SetText(_outputPath);
+        Clipboard.SetContent(package);
+        ShowInfo(InfoBarSeverity.Success, "已复制路径", _outputPath);
+    }
+
+    private async void SaveAsButton_Click(object sender, RoutedEventArgs e)
+    {
+        if (string.IsNullOrWhiteSpace(_outputPath) || !File.Exists(_outputPath))
+            return;
+
+        var picker = new FileSavePicker
+        {
+            SuggestedStartLocation = PickerLocationId.MusicLibrary,
+            SuggestedFileName = Path.GetFileNameWithoutExtension(_outputPath),
+        };
+        picker.FileTypeChoices.Add("WAV 音频", new List<string> { ".wav" });
+        InitializePicker(picker);
+        var destination = await picker.PickSaveFileAsync();
+        if (destination is null)
+            return;
+
+        try
+        {
+            var sourcePath = Path.GetFullPath(_outputPath);
+            var destinationPath = Path.GetFullPath(destination.Path);
+            if (_inputFile is not null
+                && string.Equals(Path.GetFullPath(_inputFile.Path), destinationPath, StringComparison.OrdinalIgnoreCase))
+            {
+                ShowInfo(InfoBarSeverity.Warning, "不能覆盖源文件", "请选择其他文件名或目录；源音频必须保持不变。");
+                return;
+            }
+            if (!string.Equals(sourcePath, destinationPath, StringComparison.OrdinalIgnoreCase))
+                await Task.Run(() => File.Copy(sourcePath, destinationPath, overwrite: true));
+            ShowInfo(InfoBarSeverity.Success, "已另存文件", destinationPath);
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Error, "另存失败", ex.Message);
+        }
+    }
+
+    private bool CanProcessInput()
+    {
+        if (!IsFfmpegReady)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "FFmpeg 尚未就绪", "请先安装或配置本地 FFmpeg。 ");
+            return false;
+        }
+        if (_inputFile is null || _probe is null)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "请先选择有效音频", "检测成功后才能开始处理。");
+            return false;
+        }
+        if (App.Ffmpeg.IsBusy && !_operationRunning)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "已有任务正在运行", "请回到启动该任务的页面等待或取消，然后再试。");
+            return false;
+        }
+        return !_operationRunning;
+    }
+
+    private bool TryReadTargets(out double targetLufs, out double truePeak, out double targetLra)
+    {
+        targetLufs = TargetLufsBox.Value;
+        truePeak = TruePeakBox.Value;
+        targetLra = TargetLraBox.Value;
+        if (double.IsFinite(targetLufs) && double.IsFinite(truePeak) && double.IsFinite(targetLra))
+            return true;
+
+        ShowInfo(InfoBarSeverity.Warning, "请填写完整的响度目标", "三个目标值都必须是有效数字。");
+        return false;
+    }
+
+    private void SetInteractiveState()
+    {
+        ChooseFileButton.IsEnabled = !_operationRunning;
+        AnalyzeAgainButton.IsEnabled = !_operationRunning;
+        TaskCard.IsEnabled = !_operationRunning && IsFfmpegReady && _probe is not null;
+        InstallButton.IsEnabled = !_operationRunning;
+        RefreshComponentButton.IsEnabled = !_operationRunning;
+        NormalizeButton.IsEnabled = !_operationRunning && _inputLoudness is not null;
+    }
+
+    private void UpdateTaskAvailability() => SetInteractiveState();
+
+    private async Task<bool> ConfirmAsync(string title, string message, string primaryText)
+    {
+        var dialog = new ContentDialog
+        {
+            XamlRoot = XamlRoot,
+            Title = title,
+            Content = new ScrollViewer
+            {
+                MaxHeight = 420,
+                Content = new TextBlock { Text = message, TextWrapping = TextWrapping.Wrap, IsTextSelectionEnabled = true },
+            },
+            PrimaryButtonText = primaryText,
+            CloseButtonText = "取消",
+            DefaultButton = ContentDialogButton.Close,
+        };
+        return await dialog.ShowAsync() == ContentDialogResult.Primary;
+    }
+
+    private void ShowJobFailure(FfmpegJobException exception, string action)
+    {
+        if (string.Equals(exception.Status.State, "cancelled", StringComparison.Ordinal))
+        {
+            ShowInfo(InfoBarSeverity.Informational, $"已取消{action}", "没有覆盖源文件。");
+            return;
+        }
+
+        var code = exception.Error?.Code;
+        var detail = exception.Error?.Details;
+        var message = string.IsNullOrWhiteSpace(detail) ? exception.Message : $"{exception.Message}\n{detail}";
+        ShowInfo(InfoBarSeverity.Error, string.IsNullOrWhiteSpace(code) ? $"{action}失败" : $"{action}失败（{code}）", message);
+    }
+
+    private void ShowInfo(InfoBarSeverity severity, string title, string message)
+    {
+        PageInfoBar.Severity = severity;
+        PageInfoBar.Title = title;
+        PageInfoBar.Message = message;
+        PageInfoBar.IsOpen = true;
+    }
+
+    private void BeginGlobalJob(string message)
+    {
+        _globalJobToken = MainWindow.Instance?.BeginGlobalJob(message);
+    }
+
+    private void UpdateGlobalJob(string message)
+    {
+        if (_globalJobToken is { } token)
+            MainWindow.Instance?.UpdateGlobalJob(token, message);
+    }
+
+    private void EndGlobalJob()
+    {
+        if (_globalJobToken is { } token)
+            MainWindow.Instance?.EndGlobalJob(token);
+        _globalJobToken = null;
+    }
+
+    private static string DescribeComponentStatus(ComponentStatus status) => status.State switch
+    {
+        "ready" when status.Source == "managed" => $"私有 FFmpeg 已就绪（{status.InstalledVersion ?? "版本未知"}）。",
+        "ready" when status.Source == "system" => $"已检测到系统 FFmpeg（{status.InstalledVersion ?? "版本未知"}）。",
+        "ready" when status.Source == "explicit" => $"配置的 FFmpeg 已就绪（{status.InstalledVersion ?? "版本未知"}）。",
+        "checking" => "FFmpeg 正被另一个本地任务使用；任务结束后请刷新状态。",
+        "downloading" => "正在下载 FFmpeg…",
+        "verifying" => "正在校验 FFmpeg…",
+        "installing" => "正在安装 FFmpeg…",
+        "updating" => "正在更新 FFmpeg…",
+        "failed" => "FFmpeg 检查失败。",
+        _ => "尚未安装可用的 FFmpeg。",
+    };
+
+    private static string BuildComponentDetails(ComponentStatus status) =>
+        $"来源：{DescribeSource(status.Source)}\n"
+        + $"已用版本：{status.InstalledVersion ?? "—"}\n"
+        + $"可用版本：{status.AvailableVersion ?? "—"}\n"
+        + $"目录：{status.ExecutableDir ?? "—"}"
+        + (string.IsNullOrWhiteSpace(status.Error) ? string.Empty : $"\n错误：{status.Error}");
+
+    private static string DescribeSource(string source) => source switch
+    {
+        "managed" => "Pi Desktop 私有安装",
+        "system" => "系统 PATH",
+        "explicit" => "用户配置目录",
+        _ => "未找到",
+    };
+
+    private static string DescribePhase(string? phase) => phase switch
+    {
+        "queued" => "任务已排队…",
+        "resolving" => "正在定位本地组件…",
+        "download" or "downloading" => "正在下载…",
+        "verify" or "verifying" => "正在校验…",
+        "install" or "installing" => "正在安装…",
+        "processing" => "正在处理音频…",
+        "complete" => "已完成。",
+        "cancelled" => "已取消。",
+        "failed" => "处理失败。",
+        _ => "正在处理…",
+    };
+
+    private static string FormatLoudness(string label, LoudnessAnalysisResult value) =>
+        $"{label}：I {FormatMetric(value.IntegratedLufs)} LUFS　TP {FormatMetric(value.TruePeakDb)} dBTP　LRA {FormatMetric(value.LoudnessRange)} LU";
+
+    private static string FormatMetric(double? value) => value is { } number ? number.ToString("0.0", CultureInfo.CurrentCulture) : "—";
+
+    private static string FormatDuration(double? seconds)
+    {
+        if (seconds is null || !double.IsFinite(seconds.Value) || seconds < 0)
+            return "未知";
+        var duration = TimeSpan.FromSeconds(seconds.Value);
+        return duration.TotalHours >= 1 ? duration.ToString(@"h\:mm\:ss\.fff") : duration.ToString(@"m\:ss\.fff");
+    }
+
+    private static string DescribeChannels(byte? channels) => channels switch
+    {
+        1 => "1（单声道）",
+        2 => "2（立体声）",
+        { } count => count.ToString(CultureInfo.CurrentCulture),
+        null => "未知",
+    };
+
+    private static string JoinKnown(params string?[] values)
+    {
+        var known = values.Where(value => !string.IsNullOrWhiteSpace(value)).ToArray();
+        return known.Length == 0 ? "未知" : string.Join(" / ", known);
+    }
+
+    private static string SelectedTag(ComboBox box) => (box.SelectedItem as ComboBoxItem)?.Tag?.ToString() ?? "keep";
+
+    private static uint? ParseOptionalUInt(string value) =>
+        value == "keep" ? null : uint.TryParse(value, NumberStyles.None, CultureInfo.InvariantCulture, out var parsed) ? parsed : null;
+
+    private static byte? ParseOptionalByte(string value) =>
+        value == "keep" ? null : byte.TryParse(value, NumberStyles.None, CultureInfo.InvariantCulture, out var parsed) ? parsed : null;
+
+    private static double? OptionalValue(NumberBox box) => double.IsNaN(box.Value) ? null : box.Value;
+
+    private string BuildOutputName(string purpose)
+    {
+        var stem = Path.GetFileNameWithoutExtension(_inputFile?.Name ?? "audio");
+        var invalid = Path.GetInvalidFileNameChars().ToHashSet();
+        stem = new string(stem.Select(character => invalid.Contains(character) ? '_' : character).ToArray()).Trim(' ', '.');
+        if (string.IsNullOrWhiteSpace(stem))
+            stem = "audio";
+        if (stem.Length > 64)
+            stem = stem[..64].TrimEnd(' ', '.');
+        var nonce = Guid.NewGuid().ToString("N", CultureInfo.InvariantCulture)[..6];
+        return $"{stem}_{purpose}_{DateTime.Now:yyyyMMdd_HHmmss_fff}_{nonce}.wav";
+    }
+
+    private static string OutputDirectory => Path.Combine(
+        Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".SynthVcopilot", "output", "ffmpeg");
+
+    private static void InitializePicker(object picker)
+    {
+        var window = MainWindow.Instance ?? throw new InvalidOperationException("The main window is not available.");
+        var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(window);
+        WinRT.Interop.InitializeWithWindow.Initialize(picker, hwnd);
+    }
+}
diff --git a/src/PiDesktop/Views/ChatPage.xaml b/src/PiDesktop/Views/ChatPage.xaml
index a3b223d8..2fd8e12f 100644
--- a/src/PiDesktop/Views/ChatPage.xaml
+++ b/src/PiDesktop/Views/ChatPage.xaml
@@ -8,6 +8,7 @@
         <Grid.RowDefinitions>
             <RowDefinition Height="*" />
             <RowDefinition Height="Auto" />
+            <RowDefinition Height="Auto" />
         </Grid.RowDefinitions>
 
         <ScrollViewer Grid.Row="0">
@@ -26,7 +27,20 @@
             </ItemsControl>
         </ScrollViewer>
 
-        <Grid Grid.Row="1" ColumnSpacing="8">
+        <Border Grid.Row="1" Padding="12" CornerRadius="8"
+                Background="{ThemeResource SubtleFillColorSecondaryBrush}">
+            <Grid ColumnSpacing="12">
+                <Grid.ColumnDefinitions>
+                    <ColumnDefinition Width="*" />
+                    <ColumnDefinition Width="Auto" />
+                </Grid.ColumnDefinitions>
+                <TextBlock Text="转换或平衡响度会生成新文件，并需要你在音频准备页面确认。"
+                           VerticalAlignment="Center" TextWrapping="Wrap" />
+                <Button Grid.Column="1" Content="处理音频" Click="OpenAudioPreparationButton_Click" />
+            </Grid>
+        </Border>
+
+        <Grid Grid.Row="2" ColumnSpacing="8">
             <Grid.ColumnDefinitions>
                 <ColumnDefinition Width="*" />
                 <ColumnDefinition Width="Auto" />
diff --git a/src/PiDesktop/Views/ChatPage.xaml.cs b/src/PiDesktop/Views/ChatPage.xaml.cs
index d15a6394..fb980c46 100644
--- a/src/PiDesktop/Views/ChatPage.xaml.cs
+++ b/src/PiDesktop/Views/ChatPage.xaml.cs
@@ -20,6 +20,9 @@ public ChatPage()
 
     private async void SendButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) => await SendAsync();
 
+    private void OpenAudioPreparationButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) =>
+        MainWindow.Instance?.NavigateTo("audio");
+
     private async void InputBox_KeyDown(object sender, KeyRoutedEventArgs e)
     {
         var ctrl = Microsoft.UI.Input.InputKeyboardSource
diff --git a/src/PiDesktop/Views/ComponentsPage.xaml b/src/PiDesktop/Views/ComponentsPage.xaml
index 0111e48c..b6047f64 100644
--- a/src/PiDesktop/Views/ComponentsPage.xaml
+++ b/src/PiDesktop/Views/ComponentsPage.xaml
@@ -2,29 +2,86 @@
 <Page
     x:Class="PiDesktop.Views.ComponentsPage"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
-    <Grid Margin="16" RowSpacing="12">
-        <Grid.RowDefinitions>
-            <RowDefinition Height="Auto" />
-            <RowDefinition Height="*" />
-        </Grid.RowDefinitions>
-        <TextBlock Grid.Row="0" Text="组件" Style="{ThemeResource TitleTextBlockStyle}" />
-        <ListView x:Name="ComponentsList" Grid.Row="1">
-            <ListView.ItemTemplate>
-                <DataTemplate>
-                    <Grid Padding="4" ColumnSpacing="12">
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    NavigationCacheMode="Required"
+    Loaded="Page_Loaded">
+
+    <ScrollViewer>
+        <StackPanel Margin="20" Spacing="16" MaxWidth="920" HorizontalAlignment="Left">
+            <StackPanel Spacing="4">
+                <TextBlock Text="组件" Style="{ThemeResource TitleTextBlockStyle}" />
+                <TextBlock Text="管理 Pi Desktop 自己使用的本地组件。不会修改系统 PATH，也不会影响 SynthV 的实时编辑。"
+                           TextWrapping="Wrap" Opacity="0.72" />
+            </StackPanel>
+
+            <InfoBar x:Name="ComponentInfoBar" IsOpen="False" IsClosable="True" />
+
+            <Border Padding="18" CornerRadius="10"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="10">
+                    <Grid ColumnSpacing="12">
                         <Grid.ColumnDefinitions>
                             <ColumnDefinition Width="*" />
                             <ColumnDefinition Width="Auto" />
                         </Grid.ColumnDefinitions>
-                        <StackPanel Grid.Column="0">
-                            <TextBlock Text="{Binding DisplayName}" />
-                            <TextBlock Text="{Binding Description}" Opacity="0.6" FontSize="12" TextWrapping="Wrap" />
+                        <StackPanel>
+                            <TextBlock Text="FFmpeg" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                            <TextBlock Text="用于音频检测、PCM WAV 准备和 EBU R128 响度处理。所有任务都在本机运行。"
+                                       TextWrapping="Wrap" Opacity="0.72" />
                         </StackPanel>
-                        <Button Grid.Column="1" Content="安装" />
+                        <Button Grid.Column="1" Content="刷新" Click="RefreshButton_Click" VerticalAlignment="Top" />
                     </Grid>
-                </DataTemplate>
-            </ListView.ItemTemplate>
-        </ListView>
-    </Grid>
+
+                    <TextBlock x:Name="FfmpegStatusText" Text="正在检查…" TextWrapping="Wrap" />
+                    <ProgressBar x:Name="ActionProgress" Minimum="0" Maximum="100" Visibility="Collapsed" />
+                    <TextBlock x:Name="ActionStatusText" Visibility="Collapsed" TextWrapping="Wrap" />
+
+                    <StackPanel Orientation="Horizontal" Spacing="8">
+                        <Button x:Name="InstallButton" Content="安装" Click="InstallButton_Click"
+                                Style="{ThemeResource AccentButtonStyle}" Visibility="Collapsed" />
+                        <Button x:Name="UpdateButton" Content="更新" Click="UpdateButton_Click"
+                                Style="{ThemeResource AccentButtonStyle}" Visibility="Collapsed" />
+                        <Button x:Name="UninstallButton" Content="卸载私有副本" Click="UninstallButton_Click"
+                                Visibility="Collapsed" />
+                        <Button x:Name="CancelButton" Content="取消任务" Click="CancelButton_Click"
+                                Visibility="Collapsed" />
+                    </StackPanel>
+
+                    <Expander Header="高级信息">
+                        <TextBlock x:Name="FfmpegDetailsText" TextWrapping="Wrap" IsTextSelectionEnabled="True" Opacity="0.72" />
+                    </Expander>
+
+                    <Button Content="打开音频准备" Click="OpenAudioPreparationButton_Click" HorizontalAlignment="Left" />
+                </StackPanel>
+            </Border>
+
+            <Border Padding="18" CornerRadius="10"
+                    Background="{ThemeResource CardBackgroundFillColorDefaultBrush}"
+                    BorderBrush="{ThemeResource CardStrokeColorDefaultBrush}" BorderThickness="1">
+                <StackPanel Spacing="10">
+                    <TextBlock Text="后续组件" Style="{ThemeResource SubtitleTextBlockStyle}" />
+                    <TextBlock Text="以下能力仍在规划中；当前页面不会下载占位模型或执行无效安装。"
+                               TextWrapping="Wrap" Opacity="0.72" />
+                    <ItemsControl x:Name="PlannedComponentsList">
+                        <ItemsControl.ItemTemplate>
+                            <DataTemplate>
+                                <Grid Padding="0,8" ColumnSpacing="12">
+                                    <Grid.ColumnDefinitions>
+                                        <ColumnDefinition Width="*" />
+                                        <ColumnDefinition Width="Auto" />
+                                    </Grid.ColumnDefinitions>
+                                    <StackPanel>
+                                        <TextBlock Text="{Binding DisplayName}" />
+                                        <TextBlock Text="{Binding Description}" Opacity="0.62" FontSize="12" TextWrapping="Wrap" />
+                                    </StackPanel>
+                                    <Button Grid.Column="1" Content="计划中" IsEnabled="False" VerticalAlignment="Center" />
+                                </Grid>
+                            </DataTemplate>
+                        </ItemsControl.ItemTemplate>
+                    </ItemsControl>
+                </StackPanel>
+            </Border>
+        </StackPanel>
+    </ScrollViewer>
 </Page>
diff --git a/src/PiDesktop/Views/ComponentsPage.xaml.cs b/src/PiDesktop/Views/ComponentsPage.xaml.cs
index bd2f2a7f..a00a783b 100644
--- a/src/PiDesktop/Views/ComponentsPage.xaml.cs
+++ b/src/PiDesktop/Views/ComponentsPage.xaml.cs
@@ -1,13 +1,256 @@
 using Microsoft.UI.Xaml.Controls;
+using PiDesktop.Models;
+using PiDesktop.Services;
 
 namespace PiDesktop.Views;
 
 public sealed partial class ComponentsPage : Page
 {
+    private ComponentView? _ffmpeg;
+    private Guid? _globalJobToken;
+    private bool _busy;
+    private bool _loaded;
+
     public ComponentsPage()
     {
         InitializeComponent();
-        // 组件目录来自 pi-agent (Rust)：ffmpeg / whisper / 音高 / 人声分离 / 乐器 / 曲风 / 拍点 / Sound→MIDI
-        ComponentsList.ItemsSource = App.Agent.Components();
+        PlannedComponentsList.ItemsSource = App.Agent.Components()
+            .Where(component => !string.Equals(component.Id, "ffmpeg", StringComparison.OrdinalIgnoreCase))
+            .ToList();
+    }
+
+    private async void Page_Loaded(object sender, Microsoft.UI.Xaml.RoutedEventArgs e)
+    {
+        if (_loaded)
+            return;
+        _loaded = true;
+        await RefreshAsync();
     }
+
+    private async void RefreshButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) => await RefreshAsync();
+
+    private async Task RefreshAsync()
+    {
+        try
+        {
+            var components = await App.Ffmpeg.RefreshStatusAsync();
+            _ffmpeg = components.FirstOrDefault(component =>
+                string.Equals(component.Spec.Id, "ffmpeg", StringComparison.OrdinalIgnoreCase));
+            if (_ffmpeg is null)
+            {
+                FfmpegStatusText.Text = "当前运行时没有 FFmpeg 组件。请确认 Desktop 与 pi-agent 版本一致。";
+                FfmpegDetailsText.Text = "状态不可用";
+            }
+            else
+            {
+                var status = _ffmpeg.Status;
+                FfmpegStatusText.Text = DescribeStatus(status);
+                FfmpegDetailsText.Text = BuildDetails(status);
+                if (string.Equals(status.State, "failed", StringComparison.Ordinal) && !string.IsNullOrWhiteSpace(status.Error))
+                    ShowInfo(InfoBarSeverity.Error, "FFmpeg 检查失败", status.Error);
+            }
+            UpdateButtons();
+        }
+        catch (Exception ex)
+        {
+            FfmpegStatusText.Text = "无法读取组件状态。";
+            FfmpegDetailsText.Text = ex.Message;
+            ShowInfo(InfoBarSeverity.Error, "读取组件状态失败", ex.Message);
+            UpdateButtons();
+        }
+    }
+
+    private async void InstallButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) =>
+        await RunActionAsync("install", "安装", progress => App.Ffmpeg.InstallAsync(progress: progress));
+
+    private async void UpdateButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) =>
+        await RunActionAsync("update", "更新", progress => App.Ffmpeg.UpdateAsync(progress: progress));
+
+    private async void UninstallButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) =>
+        await RunActionAsync("uninstall", "卸载", progress => App.Ffmpeg.UninstallAsync(progress: progress));
+
+    private async Task RunActionAsync(
+        string action,
+        string verb,
+        Func<IProgress<JobStatus>, Task<JobStatus>> start)
+    {
+        if (_busy)
+            return;
+        if (App.Ffmpeg.IsBusy)
+        {
+            ShowInfo(InfoBarSeverity.Warning, "已有任务正在运行", "请等待音频处理或组件任务完成后再试。");
+            return;
+        }
+
+        var content = action switch
+        {
+            "install" => "将下载并校验 Pi Desktop 的私有 FFmpeg 副本。不会修改系统 PATH。",
+            "update" => "将更新 Pi Desktop 的私有 FFmpeg 副本。系统安装不会被修改。",
+            _ => "只会移除 Pi Desktop 管理的私有 FFmpeg 副本。系统 FFmpeg、源音频和输出文件不会被删除。",
+        };
+        if (!await ConfirmAsync($"{verb} FFmpeg？", content, verb))
+            return;
+
+        _busy = true;
+        ActionProgress.Visibility = Microsoft.UI.Xaml.Visibility.Visible;
+        ActionProgress.IsIndeterminate = true;
+        ActionStatusText.Visibility = Microsoft.UI.Xaml.Visibility.Visible;
+        ActionStatusText.Text = $"正在{verb}…";
+        CancelButton.Visibility = Microsoft.UI.Xaml.Visibility.Visible;
+        BeginGlobalJob($"正在{verb} FFmpeg…");
+        UpdateButtons();
+
+        try
+        {
+            var progress = new Progress<JobStatus>(UpdateProgress);
+            await start(progress);
+            ShowInfo(
+                InfoBarSeverity.Success,
+                $"FFmpeg 已{verb}",
+                action == "uninstall" ? "私有副本已移除。" : "本地组件现在可以使用。");
+        }
+        catch (FfmpegJobException ex)
+        {
+            if (string.Equals(ex.Status.State, "cancelled", StringComparison.Ordinal))
+                ShowInfo(InfoBarSeverity.Informational, $"已取消{verb}", "组件状态没有被错误标记为成功。");
+            else
+                ShowInfo(InfoBarSeverity.Error, $"{verb}失败（{ex.Error?.Code ?? "unknown"}）", ex.Message);
+        }
+        catch (Exception ex)
+        {
+            ShowInfo(InfoBarSeverity.Error, $"{verb}失败", ex.Message);
+        }
+        finally
+        {
+            _busy = false;
+            EndGlobalJob();
+            ActionProgress.Visibility = Microsoft.UI.Xaml.Visibility.Collapsed;
+            ActionStatusText.Visibility = Microsoft.UI.Xaml.Visibility.Collapsed;
+            CancelButton.Visibility = Microsoft.UI.Xaml.Visibility.Collapsed;
+            await RefreshAsync();
+        }
+    }
+
+    private void UpdateProgress(JobStatus status)
+    {
+        ActionProgress.IsIndeterminate = status.Progress is null;
+        if (status.Progress is { } progress)
+            ActionProgress.Value = Math.Clamp(progress, 0, 1) * 100;
+        ActionStatusText.Text = DescribePhase(status.Phase);
+        UpdateGlobalJob(ActionStatusText.Text);
+    }
+
+    private async void CancelButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e)
+    {
+        var requested = await App.Ffmpeg.CancelCurrent();
+        ShowInfo(
+            requested ? InfoBarSeverity.Informational : InfoBarSeverity.Warning,
+            requested ? "已请求取消" : "没有可取消的任务",
+            requested ? "正在等待当前安全步骤结束。" : "任务可能已经结束。");
+    }
+
+    private void OpenAudioPreparationButton_Click(object sender, Microsoft.UI.Xaml.RoutedEventArgs e) =>
+        MainWindow.Instance?.NavigateTo("audio");
+
+    private void UpdateButtons()
+    {
+        var status = _ffmpeg?.Status;
+        var enabled = !_busy && !App.Ffmpeg.IsBusy;
+        InstallButton.Visibility = status?.CanInstall == true
+            ? Microsoft.UI.Xaml.Visibility.Visible
+            : Microsoft.UI.Xaml.Visibility.Collapsed;
+        UpdateButton.Visibility = status?.CanUpdate == true
+            ? Microsoft.UI.Xaml.Visibility.Visible
+            : Microsoft.UI.Xaml.Visibility.Collapsed;
+        UninstallButton.Visibility = status?.CanUninstall == true
+            ? Microsoft.UI.Xaml.Visibility.Visible
+            : Microsoft.UI.Xaml.Visibility.Collapsed;
+        InstallButton.IsEnabled = enabled;
+        UpdateButton.IsEnabled = enabled;
+        UninstallButton.IsEnabled = enabled;
+    }
+
+    private async Task<bool> ConfirmAsync(string title, string content, string primaryText)
+    {
+        var dialog = new ContentDialog
+        {
+            XamlRoot = XamlRoot,
+            Title = title,
+            Content = new TextBlock { Text = content, TextWrapping = Microsoft.UI.Xaml.TextWrapping.Wrap },
+            PrimaryButtonText = primaryText,
+            CloseButtonText = "取消",
+            DefaultButton = ContentDialogButton.Close,
+        };
+        return await dialog.ShowAsync() == ContentDialogResult.Primary;
+    }
+
+    private void ShowInfo(InfoBarSeverity severity, string title, string message)
+    {
+        ComponentInfoBar.Severity = severity;
+        ComponentInfoBar.Title = title;
+        ComponentInfoBar.Message = message;
+        ComponentInfoBar.IsOpen = true;
+    }
+
+    private void BeginGlobalJob(string message)
+    {
+        _globalJobToken = MainWindow.Instance?.BeginGlobalJob(message);
+    }
+
+    private void UpdateGlobalJob(string message)
+    {
+        if (_globalJobToken is { } token)
+            MainWindow.Instance?.UpdateGlobalJob(token, message);
+    }
+
+    private void EndGlobalJob()
+    {
+        if (_globalJobToken is { } token)
+            MainWindow.Instance?.EndGlobalJob(token);
+        _globalJobToken = null;
+    }
+
+    private static string DescribeStatus(ComponentStatus status) => status.State switch
+    {
+        "ready" when status.Source == "managed" => $"Pi Desktop 私有 FFmpeg 已就绪（{status.InstalledVersion ?? "版本未知"}）。",
+        "ready" when status.Source == "system" => $"正在使用系统 FFmpeg（{status.InstalledVersion ?? "版本未知"}）；Pi Desktop 不会卸载它。",
+        "ready" when status.Source == "explicit" => $"正在使用配置目录中的 FFmpeg（{status.InstalledVersion ?? "版本未知"}）。",
+        "checking" => "FFmpeg 正被另一个本地任务使用；任务结束后请刷新状态。",
+        "downloading" => "正在下载 FFmpeg…",
+        "verifying" => "正在校验 FFmpeg…",
+        "installing" => "正在安装 FFmpeg…",
+        "updating" => "正在更新 FFmpeg…",
+        "uninstalling" => "正在卸载私有 FFmpeg…",
+        "failed" => "FFmpeg 当前不可用。",
+        _ => "尚未找到可用的 FFmpeg。可以安装 Pi Desktop 的私有副本。",
+    };
+
+    private static string BuildDetails(ComponentStatus status) =>
+        $"来源：{DescribeSource(status.Source)}\n"
+        + $"已用版本：{status.InstalledVersion ?? "—"}\n"
+        + $"可用版本：{status.AvailableVersion ?? "—"}\n"
+        + $"可执行文件目录：{status.ExecutableDir ?? "—"}"
+        + (string.IsNullOrWhiteSpace(status.Error) ? string.Empty : $"\n错误：{status.Error}");
+
+    private static string DescribeSource(string source) => source switch
+    {
+        "managed" => "Pi Desktop 私有安装",
+        "system" => "系统 PATH",
+        "explicit" => "用户配置目录",
+        _ => "未找到",
+    };
+
+    private static string DescribePhase(string? phase) => phase switch
+    {
+        "queued" => "任务已排队…",
+        "download" or "downloading" => "正在下载…",
+        "verify" or "verifying" => "正在校验…",
+        "install" or "installing" => "正在安装…",
+        "update" or "updating" => "正在更新…",
+        "uninstall" or "uninstalling" => "正在卸载…",
+        "complete" => "已完成。",
+        "cancelled" => "已取消。",
+        "failed" => "任务失败。",
+        _ => "正在处理…",
+    };
 }
diff --git a/tools/PiAgentSmoke/PiAgentSmoke.csproj b/tools/PiAgentSmoke/PiAgentSmoke.csproj
index a43484a1..b7b78440 100644
--- a/tools/PiAgentSmoke/PiAgentSmoke.csproj
+++ b/tools/PiAgentSmoke/PiAgentSmoke.csproj
@@ -9,11 +9,24 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <PiAgentDir>$(MSBuildProjectDirectory)\..\..\external\pi-agent</PiAgentDir>
+    <Platforms>x64;ARM64</Platforms>
+    <Platform Condition="'$(Platform)' == '' or '$(Platform)' == 'AnyCPU'">x64</Platform>
+    <RuntimeIdentifier Condition="'$(RuntimeIdentifier)' == '' and '$(Platform)' == 'x64'">win-x64</RuntimeIdentifier>
+    <RuntimeIdentifier Condition="'$(RuntimeIdentifier)' == '' and '$(Platform)' == 'ARM64'">win-arm64</RuntimeIdentifier>
+    <PiAgentTargetTriple Condition="'$(PiAgentTargetTriple)' == '' and '$(Platform)' == 'x64'">x86_64-pc-windows-msvc</PiAgentTargetTriple>
+    <PiAgentTargetTriple Condition="'$(PiAgentTargetTriple)' == '' and '$(Platform)' == 'ARM64'">aarch64-pc-windows-msvc</PiAgentTargetTriple>
   </PropertyGroup>
 
   <Target Name="BuildPiAgentDll" BeforeTargets="Build">
-    <Exec Command="cargo build --release -p pi-agent-ffi" WorkingDirectory="$(PiAgentDir)" />
-    <Copy SourceFiles="$(PiAgentDir)\target\release\pi_agent.dll"
+    <Error Condition="'$(PiAgentTargetTriple)' == ''" Text="PiAgentSmoke supports only x64 and ARM64 Platform/RuntimeIdentifier values." />
+    <Error Condition="'$(Platform)' == 'x64' and '$(RuntimeIdentifier)' != 'win-x64'"
+           Text="Platform x64 requires RuntimeIdentifier win-x64." />
+    <Error Condition="'$(Platform)' == 'ARM64' and '$(RuntimeIdentifier)' != 'win-arm64'"
+           Text="Platform ARM64 requires RuntimeIdentifier win-arm64." />
+    <Exec Command="cargo build --release --target $(PiAgentTargetTriple) -p pi-agent-ffi" WorkingDirectory="$(PiAgentDir)" />
+    <Error Condition="!Exists('$(PiAgentDir)\target\$(PiAgentTargetTriple)\release\pi_agent.dll')"
+           Text="cargo completed without the expected $(PiAgentTargetTriple) pi_agent.dll." />
+    <Copy SourceFiles="$(PiAgentDir)\target\$(PiAgentTargetTriple)\release\pi_agent.dll"
           DestinationFolder="$(OutDir)"
           SkipUnchangedFiles="true" />
   </Target>
diff --git a/tools/PiAgentSmoke/Program.cs b/tools/PiAgentSmoke/Program.cs
index 119edd46..a87a59cf 100644
--- a/tools/PiAgentSmoke/Program.cs
+++ b/tools/PiAgentSmoke/Program.cs
@@ -1,9 +1,8 @@
+using System.Diagnostics;
 using System.Runtime.InteropServices;
 using System.Text.Json;
 
-// pi_agent.dll 冒烟测试：version → create → send ×2 → components → destroy。
-// 任一步失败即非零退出。
-
+// Non-GUI ABI smoke test. It deliberately never installs or updates FFmpeg.
 var failures = 0;
 
 string Take(nint p)
@@ -15,67 +14,172 @@ string Take(nint p)
 
 void Check(string name, bool ok, string detail = "")
 {
-    Console.WriteLine($"[{(ok ? "PASS" : "FAIL")}] {name}{(detail.Length > 0 ? " — " + detail : "")}");
+    Console.WriteLine($"[{(ok ? "PASS" : "FAIL")}] {name}{(detail.Length > 0 ? " - " + detail : "")}");
     if (!ok) failures++;
 }
 
-// 1. 版本
+JsonElement Status(SafePiJobHandle job)
+{
+    using var document = JsonDocument.Parse(Take(Native.pi_job_status_json(job.DangerousGetHandle())));
+    return document.RootElement.Clone();
+}
+
+JsonElement PollToTerminal(SafePiJobHandle job)
+{
+    for (var attempt = 0; attempt != 100; attempt++)
+    {
+        var status = Status(job);
+        var state = status.GetProperty("state").GetString();
+        if (state is "succeeded" or "failed" or "cancelled") return status;
+        Thread.Sleep(100);
+    }
+    throw new TimeoutException("FFmpeg job did not reach a terminal state within 10 seconds.");
+}
+
 var version = Take(Native.pi_agent_version());
 Check("pi_agent_version", version.Length > 0, $"version={version}");
 
-// 2. 句柄
 var handle = Native.pi_agent_create();
 Check("pi_agent_create", handle != 0);
+if (handle != 0)
+{
+    var json = Take(Native.pi_agent_send(handle, "smoke test"));
+    Check("pi_agent_send returns JSON", json.TrimStart().StartsWith('['), json);
+    Native.pi_agent_destroy(handle);
+}
 
-// 3. 一轮对话（echo 后端）
-var json1 = Take(Native.pi_agent_send(handle, "你好，Pi！"));
-Check("pi_agent_send #1 returns JSON array", json1.TrimStart().StartsWith('['), json1);
+// The legacy catalog remains available, while the status endpoint supplies the
+// dynamic FFmpeg source and capability fields used by Desktop.
+var components = Take(Native.pi_components_json());
 try
 {
-    using var doc = JsonDocument.Parse(json1);
-    var arr = doc.RootElement;
-    Check("send #1: 2 messages (user+assistant)", arr.GetArrayLength() == 2, $"len={arr.GetArrayLength()}");
-    Check("send #1: roles", arr[0].GetProperty("role").GetString() == "user"
-                         && arr[1].GetProperty("role").GetString() == "assistant");
-    Check("send #1: echo content", (arr[1].GetProperty("content").GetString() ?? "").Contains("你好，Pi！"));
+    using var document = JsonDocument.Parse(components);
+    Check("pi_components_json is an array", document.RootElement.ValueKind == JsonValueKind.Array);
+    Check("pi_components_json includes ffmpeg", document.RootElement.EnumerateArray()
+        .Any(component => component.GetProperty("id").GetString() == "ffmpeg"));
 }
-catch (Exception e) { Check("send #1: parse", false, e.Message); }
+catch (Exception error) { Check("pi_components_json parse", false, error.Message); }
 
-// 4. 第二轮（验证会话在句柄里累积、UTF-8 编组稳定）
-var json2 = Take(Native.pi_agent_send(handle, "second turn / 中文·emoji 🎵"));
-Check("pi_agent_send #2", json2.Contains("🎵") && json2.TrimStart().StartsWith('['));
-
-// 5. 组件目录
-var components = Take(Native.pi_components_json());
+var ffmpegIsSystemReady = false;
 try
 {
-    using var doc = JsonDocument.Parse(components);
-    var ids = doc.RootElement.EnumerateArray()
-        .Select(c => c.GetProperty("id").GetString()).ToArray();
-    string[] expected = ["ffmpeg", "whisper-local", "game-pitch", "vocal-separation",
-                         "instrument-id", "genre-id", "tempo-beat", "sound-to-midi"];
-    Check("pi_components_json: 8 components", ids.Length == 8, string.Join(",", ids!));
-    Check("pi_components_json: expected ids", expected.All(ids.Contains!));
+    using var document = JsonDocument.Parse(Take(Native.pi_components_status_json()));
+    var ffmpeg = document.RootElement.EnumerateArray().Single(component =>
+        component.GetProperty("spec").GetProperty("id").GetString() == "ffmpeg");
+    var status = ffmpeg.GetProperty("status");
+    var source = status.GetProperty("source").GetString();
+    var state = status.GetProperty("state").GetString();
+    Check("FFmpeg status shape", source is "explicit" or "managed" or "system" or "unavailable"
+        && state is not null && status.TryGetProperty("can_install", out _), $"source={source}; state={state}");
+    ffmpegIsSystemReady = source == "system" && state == "ready";
+}
+catch (Exception error) { Check("pi_components_status_json parse", false, error.Message); }
+
+if (!ffmpegIsSystemReady)
+{
+    Console.WriteLine("[SKIP] FFmpeg probe: no healthy system FFmpeg pair was resolved; status parsing still passed.");
 }
-catch (Exception e) { Check("components: parse", false, e.Message); }
+else
+{
+    var input = Path.Combine(Path.GetTempPath(), $"pi-agent-smoke-{Guid.NewGuid():N}.wav");
+    var createdOutputs = new List<string>();
+    try
+    {
+        using var ffmpeg = Process.Start(new ProcessStartInfo("ffmpeg", $"-hide_banner -loglevel error -f lavfi -i sine=frequency=440:duration=1 -y \"{input}\"")
+        { UseShellExecute = false });
+        ffmpeg!.WaitForExit();
+        Check("create probe fixture", ffmpeg.ExitCode == 0 && File.Exists(input));
+
+        JsonElement RunOperation(string label, object request)
+        {
+            using var job = new SafePiJobHandle(Native.pi_ffmpeg_job_start(JsonSerializer.Serialize(request)));
+            Check($"{label} starts", !job.IsInvalid);
+            if (job.IsInvalid) return default;
+            var terminal = PollToTerminal(job);
+            Check($"{label} succeeds", terminal.GetProperty("state").GetString() == "succeeded", terminal.ToString());
+            return terminal;
+        }
 
-// 6. 销毁 + 空句柄安全性
-Native.pi_agent_destroy(handle);
-var errJson = Take(Native.pi_agent_send(0, "should error"));
-Check("null-handle send returns error JSON", errJson.Contains("error"), errJson);
+        var probe = RunOperation("FFmpeg probe", new { operation = "probe", input });
+        var probeResult = probe.GetProperty("result").GetProperty("probe");
+        Check("FFmpeg probe returns audio facts",
+            probeResult.GetProperty("sample_rate").GetUInt32() > 0
+            && probeResult.GetProperty("channels").GetByte() > 0);
+
+        var preparedName = $"pi-agent-smoke-{Guid.NewGuid():N}-prepared.wav";
+        var prepared = RunOperation("FFmpeg prepare", new
+        {
+            operation = "prepare",
+            input,
+            output_name = preparedName,
+            sample_rate = 44_100,
+            channels = 1,
+            sample_format = "s24",
+        });
+        var preparedPath = prepared.GetProperty("result").GetProperty("output_path").GetString() ?? "";
+        if (preparedPath.Length > 0) createdOutputs.Add(preparedPath);
+        Check("FFmpeg prepare creates contained WAV", preparedPath.EndsWith(preparedName, StringComparison.OrdinalIgnoreCase)
+            && File.Exists(preparedPath), preparedPath);
+
+        var analysis = RunOperation("FFmpeg loudness analysis", new { operation = "loudness_analyze", input });
+        var loudness = analysis.GetProperty("result").GetProperty("loudness");
+        Check("FFmpeg loudness analysis returns finite metrics",
+            double.IsFinite(loudness.GetProperty("integrated_lufs").GetDouble())
+            && double.IsFinite(loudness.GetProperty("true_peak_db").GetDouble()));
+
+        var normalizedName = $"pi-agent-smoke-{Guid.NewGuid():N}-normalized.wav";
+        var normalized = RunOperation("FFmpeg loudness normalization", new
+        {
+            operation = "loudness_normalize",
+            input,
+            output_name = normalizedName,
+            target_lufs = -16.0,
+            max_true_peak_db = -1.5,
+            target_lra = 11.0,
+        });
+        var normalizedPath = normalized.GetProperty("result").GetProperty("output_path").GetString() ?? "";
+        if (normalizedPath.Length > 0) createdOutputs.Add(normalizedPath);
+        Check("FFmpeg loudness normalization creates contained WAV",
+            normalizedPath.EndsWith(normalizedName, StringComparison.OrdinalIgnoreCase)
+            && File.Exists(normalizedPath), normalizedPath);
+    }
+    catch (Exception error) { Check("FFmpeg C-ABI operation sequence", false, error.Message); }
+    finally
+    {
+        if (File.Exists(input)) File.Delete(input);
+        foreach (var output in createdOutputs)
+            if (File.Exists(output)) File.Delete(output);
+    }
+}
+
+var nullHandleResult = Take(Native.pi_agent_send(0, "should error"));
+Check("null-handle send returns error JSON", nullHandleResult.Contains("error"), nullHandleResult);
 
 Console.WriteLine(failures == 0 ? "\nALL PASS" : $"\n{failures} FAILURE(S)");
 return failures == 0 ? 0 : 1;
 
+internal sealed class SafePiJobHandle : SafeHandle
+{
+    public SafePiJobHandle(nint handle) : base(0, ownsHandle: true) => SetHandle(handle);
+    public override bool IsInvalid => handle == 0;
+    protected override bool ReleaseHandle()
+    {
+        Native.pi_job_destroy(handle);
+        return true;
+    }
+}
+
 internal static partial class Native
 {
     private const string Dll = "pi_agent";
-
     [LibraryImport(Dll)] internal static partial nint pi_agent_version();
     [LibraryImport(Dll)] internal static partial nint pi_agent_create();
     [LibraryImport(Dll)] internal static partial void pi_agent_destroy(nint handle);
-    [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)]
-    internal static partial nint pi_agent_send(nint handle, string inputUtf8);
+    [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)] internal static partial nint pi_agent_send(nint handle, string inputUtf8);
     [LibraryImport(Dll)] internal static partial nint pi_components_json();
+    [LibraryImport(Dll)] internal static partial nint pi_components_status_json();
+    [LibraryImport(Dll, StringMarshalling = StringMarshalling.Utf8)] internal static partial nint pi_ffmpeg_job_start(string requestJson);
+    [LibraryImport(Dll)] internal static partial nint pi_job_status_json(nint job);
+    [LibraryImport(Dll)] internal static partial void pi_job_destroy(nint job);
     [LibraryImport(Dll)] internal static partial void pi_string_free(nint s);
 }