dsh-pf-stream 0.2.4 → 0.3.1

package/README.en.md

@@ -1,58 +1,195 @@
-# dsh-pf-stream
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Weilv-D/dsh-pf-stream/main/icon.svg" width="72" height="72" alt="Video understanding">
+</p>
 
-[中文](README.md) | **English**
+<h1 align="center">Video understanding</h1>
 
-A video plugin for DeepSeek Harness (DSH). The agent uses it to watch local videos. During motion, the plugin records the process. At settle, it captures detail frames. Exact timestamps support full-resolution inspection.
+<p align="center">Frames, motion and speech from a video, aligned on a timeline for the agent.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-pf-stream"><img src="https://img.shields.io/npm/v/dsh-pf-stream?color=2f6feb" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/license-Apache--2.0-2ea44f" alt="license">
+  <img src="https://img.shields.io/badge/DSH-plugin-6e56cf" alt="DSH plugin">
+</p>
+
+<p align="center"><a href="README.md">中文</a> · <b>English</b></p>
+
+---
+
+## Quick start
+
+| Step | Do |
+| :--- | :--- |
+| 1 | Install ffmpeg ([commands below](#1-install-ffmpeg)); `ffmpeg -version` must print output |
+| 2 | Left sidebar **Plugins** → **Video understanding** → switch it on |
+| 3 | Click **Download local model** (~190 MB), then **Test transcription** |
+| 4 | Give the agent a video path and ask |
+
+Video works without transcription. Only videos that have no subtitles and need speech text require step 3.
+
+## What it does
+
+- **See**: motion is recorded as it happens; the moment it settles, detail is captured. Any timestamp can be inspected at full resolution.
+- **Hear**: subtitles are used when present; otherwise a transcription engine produces the speech and mounts it on the matching frames.
+- **Optional setup**: video works without transcription; with it, videos that only have a voice track also work.
 
 ## Install
 
-Prerequisite: ffmpeg and ffprobe must be available.
+### 1. Install ffmpeg
+
+The plugin decodes video with ffmpeg. Check that it runs:
+
+```bash
+ffmpeg -version
+ffprobe -version
+```
+
+Both must print output. If not:
+
+| OS | Command |
+| :--- | :--- |
+| Windows | `winget install Gyan.FFmpeg` |
+| macOS | `brew install ffmpeg` |
+| Ubuntu / Debian | `sudo apt install ffmpeg` |
 
-### Option 1: delegate to the agent
+> Open a new terminal and check again. To keep it out of PATH, set `ffmpegPath` and `ffprobePath` in the plugin config.
 
-Give this prompt to the agent:
+### 2. Install the plugin in DSH
+
+1. Open DSH and click **Plugins** in the left sidebar.
+2. Find **Video understanding** (package `dsh-pf-stream`).
+3. Open its detail page and switch it on (top right).
+4. On first enable, a setup card appears on the detail page.
+
+If it is not listed, use the install entry on the Plugins page to install `dsh-pf-stream` from npm, then return here.
+
+You can also hand the install to the agent:
 
 ```text
-Install the DSH plugin dsh-pf-stream. Follow these steps:
-1. Install the latest dsh-pf-stream from npm with the plugin manager. The result must be "applied".
-2. Check ffmpeg and ffprobe. If they are missing, install them:
-   Windows: winget install Gyan.FFmpeg;
-   macOS: brew install ffmpeg;
-   Linux: sudo apt install ffmpeg.
-3. Call probe on a local video. A returned duration and resolution means success.
-4. Report the plugin version, the ffmpeg location, and the check result.
+Install the DSH plugin dsh-pf-stream:
+1. Install the latest version from npm with the plugin manager; success means result applied;
+2. Check ffmpeg and ffprobe; install them if missing (Windows: winget install Gyan.FFmpeg / macOS: brew install ffmpeg / Linux: sudo apt install ffmpeg);
+3. Call probe on a local video; duration and resolution in the result means success;
+4. Report the plugin version, ffmpeg location, and check results.
 ```
 
-### Option 2: manual install
+## First run: configure transcription
+
+The transcription engine decides whether videos without subtitles get speech text. Without it, video still works; only the transcript is missing.
+
+To open the settings: **Plugins in the left sidebar → Video understanding → the panel below the description**. Use the same path later to change settings.
+
+<p><img src="https://raw.githubusercontent.com/Weilv-D/dsh-pf-stream/main/docs/assets/panel.png" width="720" alt="Transcription settings panel on the plugin detail page: decoder, local transcription and cloud transcription cards"></p>
 
-1. Install ffmpeg and ffprobe:
+Three cards at the top report video decode (ffmpeg), local transcription, and cloud transcription. Pick one path:
 
-   ```bash
-   winget install Gyan.FFmpeg   # Windows
-   brew install ffmpeg          # macOS
-   sudo apt install ffmpeg      # Debian / Ubuntu
-   ```
+| Path | Best for | What to do |
+| :--- | :--- | :--- |
+| Local (recommended) | Free, offline, no API key | Click "Download local model" (~190 MB), then "Test transcription" |
+| Cloud | You have a key, or the machine is slow | Pick OpenAI / Groq / a custom compatible endpoint, paste the key, save, then test |
+| Skip for now | Videos have subtitles | Use it as is; speech-only videos get no transcript |
 
-2. If the executables are outside PATH, set `ffmpegPath` and `ffprobePath` in the plugin config.
-3. Add the package to the host: `pnpm add dsh-pf-stream`.
-4. Mount the plugin as declared in `cordis.patch.yml` inside the package.
-5. Verify: start a new DSH session. The tool `dsh-pf-stream` appears in the tool list.
+### Local model
 
-## Usage
+1. Click "Download local model". The progress bar shows bytes received; cancel at any time.
+2. Clicking again after an interruption resumes the download.
+3. When done, the card reads "Ready · whisper.cpp".
+4. Click "Test transcription". "Local engine available" means it works.
 
-Ask the agent directly:
+One-click install currently supports Windows x64. On other systems, install whisper.cpp and set `audio.asr.local.binPath` in the config file, or use cloud transcription.
+
+### Cloud key
+
+1. Choose a provider under "Cloud transcription key".
+2. Paste the API key and click "Save". After saving, only "Configured" is shown; the key is never echoed back.
+3. Click "Test transcription" to verify the key and network.
+
+> **Auto policy**: cloud is used when key, endpoint and model are all set (faster, billed per use); otherwise the local engine. The badge next to the panel title shows the engine in use, such as "Transcription ready · Cloud". Under "Advanced" you can switch to local only, cloud only, or off.
+
+## Use it
+
+Give the agent a video path and ask:
 
 - "What happens in this video?"
-- "What text is shown at 12.9 seconds?"
-- "Sample one frame every 5 seconds and describe the change."
+- "What does the text at 12.9 seconds say?"
+- "Take one frame every 5 seconds and describe how it changes."
+- "Transcribe this interview with timestamps."
+
+Example output (excerpt):
 
-For parameters and return content, see the [usage guide](docs/usage-guide.md).
+```text
+[Packet #42 | Anchor: #105 | #101(P, 12.1s, Left-Top) → #105(F, 13.4s, Center)]
+Audio @Packet #42: [12.1s-12.9s] "we prepared this for three years" | [13.0s-13.4s] "today we can finally say it"
+```
+
+The text block is structured metadata: each canvas packet reports time, form, anchor, and unit positions; the audio part reports status, source, and per-line timings. The image block is one canvas per packet.
+
+Four ways to look, by question:
+
+| Goal | Ask |
+| :--- | :--- |
+| Overview first | "Look at this video" — streaming sampling; motion as process, settle as detail |
+| One exact moment | "What is written at 12.9s" — deterministic high-resolution frame |
+| Even coverage | "One frame every 5 seconds" — uniform sampling |
+| A region | "Zoom into the bottom right" — crop by area, then look |
+
+## Design
+
+### Dual-scale streaming perception
+
+Sampling is event-driven rather than fixed-rate. During motion, low-resolution process units (P) record state transitions; at settle, high-resolution freeze units (F) preserve detail. Both are delivered within a single canvas packet, so one observation carries the temporal process and the steady-state result together, and the model need not re-watch a clip to recover a detail.
+
+Density adapts to picture activity: rapid change lowers the sampling rate to suppress redundant frames, while slow change extends the wait until a settle is detected; long static intervals maintain a temporal reference through heartbeats without retransmitting images.
+
+### Canvas packing and metering
+
+Each frame is partitioned on a 42 px superpixel grid; P or F units are selected as needed and assembled into a canvas. A call may carry multiple packets, and each packet contains only the units new relative to the previous one; historical packets collapse into content-hash references, keeping context bounded in long sessions. Metering follows canvas grid cells (`r × (c + 1) + 2`).
+
+### Deterministic inspection
+
+Beyond streaming, four deterministic paths are provided: `probe` parses container metadata only; `timestamps` extracts exact frames at millisecond timestamps; `uniform` samples at a fixed interval; `roi_hint` crops and magnifies a normalized region. None depends on motion detection; outputs are reproducible and suited to verifying text, numerals, and small objects.
+
+### Cascaded speech sources
+
+Speech text is obtained through a three-stage cascade: a sidecar `.srt` / `.vtt` is read first, then embedded soft subtitles; without subtitles, silence detection and a speech-ratio estimate run, and an all-silent video skips transcription; finally ASR runs, either local whisper.cpp or OpenAI / Groq / a custom compatible endpoint. Segments are aligned by PTS and mounted on the corresponding packets, stitched across block boundaries with a ±300 ms tolerance.
+
+The default policy is vision-first with background transcription: once a call exceeds the soft deadline (`graceMs`, 8 s by default), the visual result returns and transcription continues in the background; later calls on the same video hit the disk cache.
+
+### Cold regions in long videos
+
+Historical packets outside the current window collapse into references (anchor hash, time, and transcript text) rather than retransmitting images; a timestamp call restores the detail when needed.
+
+## Troubleshooting
+
+| Symptom | Read |
+| :--- | :--- |
+| ffmpeg not found | [ffmpeg](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#找不到-ffmpeg) |
+| Speech but no transcript | [No transcript](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#有声音但没有台词) |
+| Model download fails or is slow | [Download](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#下载失败) |
+| Transcription is slow or times out | [Slow transcription](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#转写很慢或超时) |
+| Settings page is read-only | [Read-only config](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#设置页只读) |
+
+## Docs
+
+| Document | Contents |
+| :--- | :--- |
+| [Usage Guide](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/usage-guide.md) | Usage, parameters, output, metering, every config key |
+| [使用指南](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/使用指南.md) | Chinese usage guide |
+| [排障](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md) | Troubleshooting by symptom (Chinese) |
+| [开发者指南](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/开发者指南.md) | Architecture, host contracts, tests, release (Chinese) |
+
+## Development
+
+```bash
+pnpm build
+pnpm test
+pnpm verify:host
+pnpm check:package
+```
 
-## Documentation
+The host half provides the `dsh-pf-stream` tool (`probe` / `pf_stream` / `timestamps` / `uniform`), the audio sidecar, the local engine installer, and the settings API. The client half is `client.js`, which registers the config panel and the setup card on the plugin detail page. The only runtime dependency is `pngjs`.
 
-- [使用指南](docs/使用指南.md) (Chinese)
-- [Usage Guide](docs/usage-guide.md) (English)
-- [发布规范](docs/发布规范.md) (release process)
+Configuration is written through `ctx.configEditor.edit()`, which keeps fields the user did not touch; keys live in `ctx.credentials`, and the config file only holds a reference.
 
 ## License
 

package/README.md

@@ -1,58 +1,195 @@
-# dsh-pf-stream
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Weilv-D/dsh-pf-stream/main/icon.svg" width="72" height="72" alt="视频理解">
+</p>
 
-**中文** | [English](README.en.md)
+<h1 align="center">视频理解</h1>
 
-DSH 视频感知插件。智能体用它观看本地视频。画面运动时，插件记录过程。画面停稳时，插件定格细节。指定时间点可以高清检视。
+<p align="center">让智能体看懂视频：画面、动作与台词，按时间对齐。</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-pf-stream"><img src="https://img.shields.io/npm/v/dsh-pf-stream?color=2f6feb" alt="npm 版本"></a>
+  <img src="https://img.shields.io/badge/license-Apache--2.0-2ea44f" alt="许可证">
+  <img src="https://img.shields.io/badge/DSH-plugin-6e56cf" alt="DSH 插件">
+</p>
+
+<p align="center"><b>中文</b> · <a href="README.en.md">English</a></p>
+
+---
+
+## 30 秒上手
+
+| 步骤 | 做什么 |
+| :--- | :--- |
+| 1 | 安装 ffmpeg（[命令见下](#1-安装-ffmpeg)），确认 `ffmpeg -version` 有输出 |
+| 2 | 左侧栏「插件」→ 点「视频理解」→ 打开右上角开关 |
+| 3 | 详情页点「下载本地模型」，约 190 MB；完成后点「测试转写」 |
+| 4 | 在对话里给视频路径，直接提问 |
+
+不配置转写也能看画面。只有「没有字幕、又需要台词」的视频，才需要第 3 步。
+
+## 能做什么
+
+- **看画面**：画面运动时记录过程，停稳时定格细节；指定时间点可以高清复核。
+- **听声音**：有字幕就用字幕；没有字幕时，配置转写引擎后生成台词，并按时间挂到对应画面。
+- **按需配置**：默认不转写也能处理画面；配置后可以处理带音轨的视频。
 
 ## 安装
 
-前置条件：ffmpeg 与 ffprobe 必须可用。
+### 1. 安装 ffmpeg
+
+插件用 ffmpeg 解码视频。先确认它能运行：
+
+```bash
+ffmpeg -version
+ffprobe -version
+```
+
+两条都要有输出。没有的话：
+
+| 系统 | 安装命令 |
+| :--- | :--- |
+| Windows | `winget install Gyan.FFmpeg` |
+| macOS | `brew install ffmpeg` |
+| Ubuntu / Debian | `sudo apt install ffmpeg` |
 
-### 方式一：交给智能体
+> 装完新开一个终端再验证。不想放进 PATH，可以在插件配置里写 `ffmpegPath` 与 `ffprobePath` 的绝对路径。
 
-把下面的提示词交给智能体：
+### 2. 在 DSH 里安装插件
+
+1. 打开 DSH，点左侧栏的「插件」。
+2. 在列表里找「视频理解」（包名 `dsh-pf-stream`）。
+3. 点进详情页，把右上角的开关打开。
+4. 第一次开启后，详情页会出现引导卡片。
+
+列表里没有时，用插件页的安装入口从 npm 安装 `dsh-pf-stream`，装完再回到这一步。
+
+也可以把安装交给智能体：
 
 ```text
-安装 DSH 插件 dsh-pf-stream，按以下步骤执行：
-1. 用插件管理器从 npm 安装 dsh-pf-stream 最新版本。安装结果为 applied 才算成功。
-2. 检查 ffmpeg 与 ffprobe 是否可用。缺失时安装：
-   Windows 用 winget install Gyan.FFmpeg；
-   macOS 用 brew install ffmpeg；
-   Linux 用 sudo apt install ffmpeg。
-3. 对一个本地视频调用 probe。返回时长与分辨率即成功。
-4. 汇报插件版本、ffmpeg 位置、验证结果。
+安装 DSH 插件 dsh-pf-stream：
+1. 用插件管理器从 npm 安装最新版本，结果为 applied 才算成功；
+2. 检查 ffmpeg 与 ffprobe；缺失时安装（Windows: winget install Gyan.FFmpeg / macOS: brew install ffmpeg / Linux: sudo apt install ffmpeg）；
+3. 对一个本地视频调用 probe；返回时长与分辨率即成功；
+4. 汇报插件版本、ffmpeg 位置与检查结果。
 ```
 
-### 方式二：手动安装
+## 第一次配置转写
+
+转写引擎决定「没有字幕的视频能不能拿到台词」。不配置也能看画面，只是不会生成转写文本。
+
+进入配置页：**左侧栏「插件」→ 点「视频理解」→ 详情页描述下方的面板**。以后要改设置，走同一条路。
+
+<p><img src="https://raw.githubusercontent.com/Weilv-D/dsh-pf-stream/main/docs/assets/panel.png" width="720" alt="插件详情页的转写设置面板：视频解码、本地转写与云端转写三张状态卡"></p>
 
-1. 安装 ffmpeg 与 ffprobe：
+面板顶部有三张状态卡：视频解码（ffmpeg）、本地转写、云端转写。按需要选一条路线：
 
-   ```bash
-   winget install Gyan.FFmpeg   # Windows
-   brew install ffmpeg          # macOS
-   sudo apt install ffmpeg      # Debian / Ubuntu
-   ```
+| 路线 | 适合 | 操作 |
+| :--- | :--- | :--- |
+| 本地转写（推荐） | 免费、离线、不填密钥 | 点「下载本地模型」，约 190 MB；下载完点「测试转写」 |
+| 云端转写 | 已有 API Key，或机器性能较弱 | 选 OpenAI / Groq / 自定义兼容端点，填 Key，保存后点「测试转写」 |
+| 暂不配置 | 视频都有字幕 | 直接使用；无字幕的语音视频不会生成转写文本 |
 
-2. 可执行文件不在 PATH 时，在插件配置里写 `ffmpegPath` 与 `ffprobePath`。
-3. 在宿主环境安装插件包：`pnpm add dsh-pf-stream`。
-4. 按包内 `cordis.patch.yml` 写宿主装载配置。
-5. 验证：新开 DSH 会话。工具列表出现 `dsh-pf-stream` 即成功。
+### 本地模型
 
-## 使用
+1. 点「下载本地模型」。进度条显示已下载大小，可随时取消。
+2. 下载中断后再次点击会续传，不用从头开始。
+3. 完成后状态卡显示「已就绪 · whisper.cpp」。
+4. 点「测试转写」。返回「本地引擎可用」即配置成功。
 
-对智能体直接提问：
+一键安装当前支持 Windows x64。其他系统请先安装 whisper.cpp，在配置文件 `audio.asr.local.binPath` 填写可执行文件路径，或改用云端转写。
+
+### 云端密钥
+
+1. 在「云端转写密钥」里选服务商。
+2. 粘贴 API Key，点「保存」。保存后只显示「已配置」，不再回显密钥。
+3. 点「测试转写」验证密钥与网络。
+
+> **自动策略**：云端密钥、端点、模型都齐时用云端（更快，按量计费）；否则用本地引擎。面板标题旁会显示当前实际使用的引擎，如「转写可用 · 云端」。可以在「高级」里改成仅本地、仅云端或不转写。
+
+## 开始使用
+
+在对话里直接给视频路径并提问：
 
 - 「这个视频里发生了什么？」
 - 「第 12.9 秒的文字写的是什么？」
 - 「每 5 秒抽一帧，看画面怎么变化。」
+- 「把这段访谈里说的话按时间整理出来。」
+
+返回示例（节选）：
 
-参数与返回内容见[使用指南](docs/使用指南.md)。
+```text
+[Packet #42 | Anchor: #105 | #101(P, 12.1s, Left-Top) → #105(F, 13.4s, Center)]
+Audio @Packet #42: [12.1s-12.9s] "这件事我们准备了三年" | [13.0s-13.4s] "今天终于可以说了"
+```
+
+文本块是结构化元数据：每个画布包给出时间、形态、锚点与单元位置；音频部分给出状态、来源与逐句时间。图像块是每个画布包一张画布。
+
+常用问法对应四种取帧方式：
+
+| 想要 | 说法 |
+| :--- | :--- |
+| 先看整体 | 「看看这个视频」——流式采样，运动记过程、停稳给细节 |
+| 只看某一秒 | 「第 12.9 秒写了什么」——定点高清帧 |
+| 均匀看一遍 | 「每 5 秒抽一帧」——等间隔抽帧 |
+| 看局部 | 「放大右下角」——按区域裁剪后再看 |
+
+## 特点
+
+### 双尺度流式感知
+
+采样过程不再采用固定帧率，而由画面变化事件驱动：运动阶段以低分辨率过程单元（P）记录状态转移，停稳后以高分辨率定格单元（F）保留细节；两类单元在同一画布包内交付，使单次观测同时包含时序过程与稳态结果，模型无需为恢复某一细节而回看整段视频。
+
+采样密度随画面活动度自适应调整：快速变化时降低采样率以抑制冗余帧，缓慢变化时延长等待直至检测到停稳；长静止区间以心跳信号维持时间基准，不重复传输图像。
+
+### 画布打包与计费
+
+每帧按 42 px 超像素网格切分为单元，按需选取 P 或 F 单元并拼装为画布。单次调用可携带多个画布包；每个包仅包含相对上一包新增的单元，历史包以内容哈希引用折叠，使长会话中的上下文规模保持有界。计费按画布网格单元数计算（`r × (c + 1) + 2`）。
+
+### 确定性检视
+
+流式采样之外另设四条确定性路径：`probe` 仅解析容器元数据；`timestamps` 按毫秒级时间戳抽取精确帧；`uniform` 以固定间隔均匀采样；`roi_hint` 对指定归一化区域裁剪放大。上述路径不依赖运动检测，输出可复现，适用于文字、数字与小目标的核对。
+
+### 台词的级联来源
+
+转写文本按三级级联获取：优先读取同名外挂 `.srt` / `.vtt`，其次解析内嵌软字幕；无字幕时执行静音检测与语音占比估计，全静音视频直接跳过转写；最后调用语音识别，可选本地 whisper.cpp 或 OpenAI / Groq / 自定义兼容端点。识别结果按 PTS 对齐并挂载至相应画布包，跨块边界以 ±300 ms 容差缝合。
+
+默认策略为「视觉先行、转写后台补齐」：首次调用超过软截止（`graceMs`，默认 8 s）时先行返回视觉结果，转写任务在后台继续；同一视频的后续调用直接命中磁盘缓存。
+
+### 长视频的冷区
+
+超出当前窗口的历史画布包折叠为引用（锚点哈希、时间与台词文本），不再重复传输图像；需要复核时按时间戳重新取帧。
+
+## 遇到问题
+
+| 现象 | 先看这里 |
+| :--- | :--- |
+| 提示找不到 ffmpeg | [排障：ffmpeg](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#找不到-ffmpeg) |
+| 有声音，但没有台词 | [排障：没有台词](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#有声音但没有台词) |
+| 下载模型失败或很慢 | [排障：下载失败](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#下载失败) |
+| 转写很慢、超时 | [排障：转写慢](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#转写很慢或超时) |
+| 设置页显示「只读」 | [排障：配置只读](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md#设置页只读) |
 
 ## 文档
 
-- [使用指南](docs/使用指南.md)
-- [Usage Guide](docs/usage-guide.md)
-- [发布规范](docs/发布规范.md)
+| 文档 | 内容 |
+| :--- | :--- |
+| [使用指南](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/使用指南.md) | 用法、参数、返回内容、计费、全部配置项 |
+| [排障](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/排障.md) | 按现象查原因 |
+| [开发者指南](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/开发者指南.md) | 架构、宿主契约、测试与发布 |
+| [Usage Guide](https://github.com/Weilv-D/dsh-pf-stream/blob/main/docs/usage-guide.md) | 英文使用指南 |
+
+## 本地开发
+
+```bash
+pnpm build
+pnpm test
+pnpm verify:host
+pnpm check:package
+```
+
+Host 半提供工具 `dsh-pf-stream`（`probe` / `pf_stream` / `timestamps` / `uniform`）、音频边车、本地引擎安装器与设置接口；Client 半是 `client.js`，在插件详情页注册配置面板与引导卡片。运行时依赖只有 `pngjs`。
+
+配置通过 `ctx.configEditor.edit()` 写入，保留用户未触碰的字段；密钥通过 `ctx.credentials` 存取，配置文件只保留引用。
 
 ## 许可证