fish-dock-plugin-filemgr 1.0.4 → 1.0.5

package/README.md

@@ -1,27 +1,18 @@
-# 文件管理 · FISH Dock 插件
+# 文件管理
 
-把 FISH Dock 变成随手可用的文件工作台：上半逛目录、下半看内容，左边还能把常用文件先「暂存」起来，随时拖进别的程序。
-
-插件 id `jassdingk.filemgr`，宿主 API 1，兼容 **FISH Dock v1.2.3 及更早的官方发行版**，不要求宿主做任何改动。
+把 FISH Dock 变成随手可用的文件工作台：左边逛目录、右边看内容，中间还能把常用文件先「暂存」起来，随时拖进别的程序。
 
 ## 功能
 
 ### 目录浏览 + 预览
 
-- **目录浏览**：磁盘根目录、用户目录、桌面 / 文档 / 下载逐层进入；支持把文件 / 文件夹直接拖进面板。
+- **目录浏览**：从磁盘根目录、用户目录、桌面 / 文档 / 下载逐层进入；支持把文件 / 文件夹直接拖进面板。
 - **预览**：Markdown 渲染、图片（PNG / JPEG / GIF / WebP / BMP / AVIF / ICO / SVG）、Office 文本抽取（docx 段落与标题、xlsx 多工作表、pptx 每页文字，原生解析 OOXML，不需要装 Office）、代码高亮行号、纯文本与二进制兜底。
 - **上下并列**：上半是文件夹浏览器（面包屑 + 列表 + 上一级 / 刷新 / 常用文件夹 / 固定），下半是预览；中间分隔条可拖动调高，高度会被记住。
 - **框选与拖入暂存**：在列表里拖出选框可批量选中（Ctrl / Shift 点选切换），选中项直接拖到左侧暂存区即批量加入；拖到一半拖出列表会自动从「框选」切到「搬运」。
 - **常用文件夹**：记住打开过的目录，浮层里快速跳转；可把目录「固定」到最上面。
 
-### 文件暂存（中转站）
-
-- 拖入文件或文件夹即加入暂存区，也可以右键 / 按钮添加。
-- **分组**：暂存区支持多个分组标签，点击切换，标签可折叠；删除分组只走标签右侧的 ×。分组之间完全隔离，切组不会串条目。
-- **拖出**：把暂存项直接拖到桌面、资源管理器、微信等外部程序。
-- 复制路径、复制为文件、多选批量、去重、清空，偏好持久化。
-
-## 选择文件夹
+### 选择文件夹
 
 「打开文件夹」默认调用 **Windows 原生文件夹选择框**（`pick-folder.ps1` + IFileOpenDialog），选完直接进入该目录。
 
@@ -34,7 +25,7 @@
 | 自行编译、带 `fish:hold` 的宿主 | Windows 原生对话框 | 仅对话框期间临时锁定 |
 | 官方发行版（≤ v1.2.3） | 内置选择器 | 不锁定 |
 
-宿主侧要支持这条路，需要三处改动：
+宿主侧要支持这条路，需要三处改动（都已在 `FISH-Dock` 上游以补丁形式验证过）：
 
 1. `sdk/browser/bridge.js` 暴露 `hold(on)` → `parent.postMessage({type:'fish:hold', ticket, on}, '*')`
 2. `Wakuwaku/src/pet/extension-page.js` 收 `fish:hold` 写入 `record.hold`，并新增 `onHold(record, on)` 回调；`park()` / `enter()` / `retire()` 各自同步
@@ -42,76 +33,30 @@
 
 只改插件包、不重编译宿主时，插件自动走内置选择器，功能完整不缺。
 
-## 安装
-
-### 方式一：npm（最省事）
-
-```bash
-npm i -g fish-dock-plugin-filemgr
-fish-dock-filemgr            # 校验 + 拷到宿主 packages 目录 + 写注册表
-```
-
-装完重启 FISH Dock 即可。其它子命令：
-
-```bash
-fish-dock-filemgr --dry-run     # 只校验包完整性，不写磁盘
-fish-dock-filemgr --path        # 只打印 .fish-plugin 路径，自己拖进宿主「从文件安装」
-fish-dock-filemgr --uninstall   # 从宿主注册表移除本插件
-```
-
-### 方式二：打过发行包，走宿主「从文件安装」
-
-```bash
-npm run build
-# 产物 dist/jassdingk.filemgr.fish-plugin，用 FISH Dock 插件页的「从文件安装」装上
-```
-
-### 方式三：开发加载
-
-```bash
-npm run build
-# 产物 dist/filemgr 就是一个完整的开发目录（含 plugin.json），交给 FISH Dock 开发加载即可
-```
+### 文件暂存（中转站）
 
-两种产物都由 `tools/build.mjs` 一次生成。`sdk/` 里带的 `bridge.js` 与 `plugin.mjs` 是 FISH Dock v1.2.3 的原始副本，打包时会分别拷到包根目录的 `bridge.js` 和 `plugins/filemgr/sdk.mjs`——与官方 `tools/stage-development.mjs` 的做法一致。
+- 拖入文件或文件夹即加入暂存区，也可以右键 / 按钮添加。
+- **分组**：暂存区支持多个分组标签，点击切换，标签可折叠；删除分组只走标签右侧的 ×。
+- **拖出**：把暂存项直接拖到桌面、资源管理器、微信等外部程序。
+- 复制路径、复制为文件、多选批量、去重、清空，偏好持久化。
 
 ## 说明
 
 - 只读取路径白名单内的文件，路径解析后必须落在允许的根目录之下；UNC 路径一律拒绝。
-- 「打开文件夹」在支持 `fish:hold` 的宿主上会短暂启动系统 PowerShell 调起 Windows 原生文件夹对话框（`pick-folder.ps1`）；不加 `fish:hold` 的宿主上不会启动子进程，改用内置选择器。除此之外不启动任何子进程。
+- 「打开文件夹」在支持 `fish:hold` 的宿主上会短暂启动系统 PowerShell 调起 Windows 原生文件夹对话框（`pick-folder.ps1`），用于拿到用户亲手选择的路径；不加 `fish:hold` 的宿主上不会启动子进程，走内置选择器。除此之外不启动任何子进程。
 - 页面运行在宿主沙箱里（`default-src 'none'`），PDF 与音视频不做内联播放，会提示用系统程序打开。
 - 不发起网络请求。
-- 大文件保护：单次文本预览上限 800 KB、目录条目上限 2000 条、Office 文件上限 200 MB，超限会截断并给出提示，不会把插件进程撑死。
 
 ## 存储
 
-偏好（布局、最近打开、额外根目录、暂存条目与分组、固定目录）保存在插件命名空间的 `config/prefs.json`。
+偏好（布局、最近打开、额外根目录、暂存分组）保存在插件命名空间的 `config/prefs.json`。
 
-## 目录结构
+## 开发
 
+```bash
+# 本地暂存（模拟官方 tools/stage-development.mjs 的产出）
+node _stage_filemgr.mjs
+# 产物
+#   dist/filemgr.fish-plugin
+#   _stage/filemgr/   ← 可直接用 FISH Dock 的「从文件安装」装上验证
 ```
-plugins/filemgr/
-  backend.mjs          后端入口：命令路由 + 帧体积兜底
-  preview.mjs          目录树 / 文本 / 图片 / Office 读取
-  stash.mjs            暂存区数据与拖出服务
-  page.html            页面结构（上下并列 + 左侧暂存）
-  page.js              页面逻辑（浏览、预览、框选、暂存、目录选择器）
-  page.css             布局与主题
-  filemgr.css          浏览器列表、行内按钮、高亮
-  stash.css            暂存区与分组标签
-  dock.css             与宿主共享的配色变量
-  pick-folder.ps1      原生文件夹对话框（内联 C#，不依赖 .cs 文件）
-  pick-files.ps1       原生多文件对话框
-  clip.ps1             复制到剪贴板
-sdk/
-  browser/bridge.js    宿主注入页面的桥（官方 v1.2.3 原版）
-  node/plugin.mjs      后端 SDK（官方 v1.2.3 原版）
-tools/
-  build.mjs            打发行包 / 开发目录
-bin/
-  fish-dock-filemgr.mjs  npm 全局命令：校验 + 安装 / 卸载插件
-```
-
-## 许可
-
-MIT。`sdk/` 下的两个文件来自 [Fish-under-sea/FISH-Dock](https://github.com/Fish-under-sea/FISH-Dock)（MIT），保留原作者版权。

package/package.json

@@ -1,25 +1,17 @@
 {
   "name": "fish-dock-plugin-filemgr",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "FISH Dock 文件管理插件：目录浏览 + 文件预览（Markdown / 图片 / Office / 代码）+ 文件暂存中转站，兼容 FISH Dock v1.2.3 及更早官方发行版。",
   "type": "module",
-  "bin": {
-    "fish-dock-filemgr": "bin/fish-dock-filemgr.mjs"
-  },
   "files": [
-    "bin/",
-    "dist/",
+    "plugin.json",
     "README.md",
-    "LICENSE"
+    "bridge.js",
+    "plugins"
   ],
   "engines": {
     "node": ">=18"
   },
-  "scripts": {
-    "build": "node tools/build.mjs",
-    "install-plugin": "node bin/fish-dock-filemgr.mjs",
-    "prepack": "node tools/build.mjs"
-  },
   "keywords": [
     "fish-dock",
     "fishdock",

package/{dist/filemgr/plugin.json → plugin.json}

@@ -2,7 +2,7 @@
   "schema": 1,
   "id": "jassdingk.filemgr",
   "name": "文件管理",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "hostApi": 1,
   "platforms": [
     "windows-x86_64"
@@ -27,6 +27,7 @@
   ],
   "files": {
     "bridge.js": "f38f93994e3cb2b71f2ff1810b3f68fb42f4261550f8ab01b0bfa3eecd5f94ee",
+    "package.json": "7e9124508cc113f5039ce514573a5f8f280faf9392e4677d30bb144c55351e5c",
     "plugins/filemgr/backend.mjs": "b448aa688ff11f2abc4c5281b4714646ed6c384473d873cfe431a8e64b066d26",
     "plugins/filemgr/clip.ps1": "b0a32fca35cf2d25133338f46e20a0db20d78c5bb6b5c2aab899998bfbd6c6ab",
     "plugins/filemgr/dock.css": "e795214dd39de3b473ac0b1a7b79f6922a88c761fca4d3ea4da8fd9b60188bcf",

package/LICENSE

@@ -1,32 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Fish-under-sea
-Copyright (c) 2026 Pengjie Zhou
-Copyright (c) 2026 Ebony-Vinyl
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-The root license covers FISH Dock integration code and MIT-licensed upstream
-code, subject to the original notices retained in Wakuwaku/LICENSE and
-dsh-our-free-model/LICENSE. Other bundled libraries retain their own licenses.
-This license does not grant rights to pet sprites, application icons,
-wallpapers, third-party trademarks, accounts, or model services. Verify the
-applicable permissions before redistributing artwork or other assets.

package/bin/fish-dock-filemgr.mjs

@@ -1,151 +0,0 @@
-#!/usr/bin/env node
-// fish-dock-filemgr —— 把「文件管理」插件装进本机 FISH Dock。
-//
-// 做的事和宿主「从文件安装 .fish-plugin」等价：
-//   1. 校验 dist/filemgr 里每个文件的 sha256 与 plugin.json 登记值一致
-//   2. 拷到 %USERPROFILE%\.fish-dock\host\packages\<id>\<version>\<整包 sha256>\
-//   3. 往 host/config/installed-plugins.json 写注册条目（manifest 按宿主解析后的形状补全）
-//
-// 仅支持 Windows（宿主只发 windows-x86_64）。
-import fs from 'node:fs'
-import os from 'node:os'
-import path from 'node:path'
-import crypto from 'node:crypto'
-import { fileURLToPath } from 'node:url'
-import { spawnSync } from 'node:child_process'
-
-const HERE = path.dirname(fileURLToPath(import.meta.url))
-const PKG_ROOT = path.resolve(HERE, '..')
-const DEV = path.join(PKG_ROOT, 'dist', 'filemgr')
-const ARCHIVE = path.join(PKG_ROOT, 'dist', 'jassdingk.filemgr.fish-plugin')
-
-const C = { r: '\x1b[0m', b: '\x1b[1m', dim: '\x1b[2m', g: '\x1b[32m', y: '\x1b[33m', red: '\x1b[31m', cyan: '\x1b[36m' }
-const say = (...a) => console.log(...a)
-const die = msg => { console.error(`${C.red}✗ ${msg}${C.r}`); process.exit(1) }
-const sha256 = b => crypto.createHash('sha256').update(b).digest('hex')
-
-const argv = process.argv.slice(2)
-const has = (...names) => names.some(n => argv.includes(n))
-
-if (has('-h', '--help')) {
-  say(`
-${C.b}fish-dock-filemgr${C.r} — 安装 FISH Dock「文件管理」插件
-
-  ${C.cyan}fish-dock-filemgr${C.r}                 安装 / 升级到当前版本
-  ${C.cyan}fish-dock-filemgr --path${C.r}          只打印 .fish-plugin 包路径（自行拖进宿主安装）
-  ${C.cyan}fish-dock-filemgr --dry-run${C.r}       只做校验，不写磁盘
-  ${C.cyan}fish-dock-filemgr --uninstall${C.r}     从注册表移除本插件
-
-安装完成后需要 ${C.y}重启 FISH Dock${C.r} 才会加载新版本。
-`)
-  process.exit(0)
-}
-
-if (process.platform !== 'win32') die('本插件只支持 Windows（FISH Dock 宿主仅提供 windows-x86_64）')
-
-if (!fs.existsSync(path.join(DEV, 'plugin.json'))) {
-  die(`找不到 dist/filemgr/plugin.json。\n  这是发行包里预构建的产物；如果你是源码检出，先跑 ${C.cyan}npm run build${C.r}`)
-}
-
-const manifest = JSON.parse(fs.readFileSync(path.join(DEV, 'plugin.json'), 'utf8'))
-const version = manifest.version
-const HOST = path.join(os.homedir(), '.fish-dock', 'host')
-const REGISTRY = path.join(HOST, 'config', 'installed-plugins.json')
-
-if (has('--path')) {
-  say(fs.existsSync(ARCHIVE) ? ARCHIVE : path.join(DEV, 'plugin.json'))
-  process.exit(0)
-}
-
-// ---------- uninstall ----------
-if (has('--uninstall')) {
-  if (!fs.existsSync(REGISTRY)) die(`注册表不存在：${REGISTRY}\n  看起来这台机器还没装过 FISH Dock 插件。`)
-  const reg = JSON.parse(fs.readFileSync(REGISTRY, 'utf8'))
-  if (!reg.entries || !reg.entries[manifest.id]) {
-    say(`${C.y}!${C.r} 注册表里没有 ${manifest.id}，无需卸载`)
-    process.exit(0)
-  }
-  const backup = REGISTRY + '.bak-' + Date.now()
-  fs.copyFileSync(REGISTRY, backup)
-  delete reg.entries[manifest.id]
-  const tmp = REGISTRY + '.tmp-' + process.pid
-  fs.writeFileSync(tmp, JSON.stringify(reg, null, 2))
-  fs.renameSync(tmp, REGISTRY)
-  say(`${C.g}✓${C.r} 已从注册表移除 ${C.b}${manifest.id}${C.r}`)
-  say(`  ${C.dim}注册表备份 ${backup}${C.r}`)
-  say(`  ${C.dim}包目录可留可删：${path.join(HOST, 'packages', manifest.id)}${C.r}`)
-  say(`  ${C.y}重启 FISH Dock 后生效${C.r}`)
-  process.exit(0)
-}
-
-// ---------- 校验 ----------
-const declared = manifest.files || {}
-const files = Object.keys(declared)
-if (!files.length) die('plugin.json 里没有 files 清单，包不完整')
-let bad = 0
-for (const name of files) {
-  const abs = path.join(DEV, name)
-  if (!fs.existsSync(abs)) { console.error(`${C.red}缺失${C.r} ${name}`); bad++; continue }
-  const got = sha256(fs.readFileSync(abs))
-  if (got !== String(declared[name]).toLowerCase()) { console.error(`${C.red}哈希不符${C.r} ${name}\n  期望 ${declared[name]}\n  实际 ${got}`); bad++ }
-}
-if (bad) die(`包内文件校验失败（${bad} 个异常），已中止，未写入任何文件`)
-
-const digest = sha256(fs.readFileSync(ARCHIVE))
-say(`${C.dim}插件${C.r}   ${C.b}${manifest.id}${C.r}  ${C.cyan}v${version}${C.r}`)
-say(`${C.dim}文件${C.r}   ${files.length} 个全部校验通过`)
-say(`${C.dim}整包${C.r}   sha256 ${digest.slice(0, 16)}…`)
-
-if (has('--dry-run')) { say(`\n${C.y}= dry-run，未写入磁盘 =${C.r}`); process.exit(0) }
-
-// ---------- 拷文件 ----------
-const target = path.join(HOST, 'packages', manifest.id, version, digest)
-fs.mkdirSync(target, { recursive: true })
-for (const name of files) {
-  const dst = path.join(target, name)
-  fs.mkdirSync(path.dirname(dst), { recursive: true })
-  fs.copyFileSync(path.join(DEV, name), dst)
-}
-fs.copyFileSync(path.join(DEV, 'plugin.json'), path.join(target, 'plugin.json'))
-say(`${C.dim}落盘${C.r}   ${target}`)
-
-// ---------- 写注册表 ----------
-// 宿主 Manifest::parse 用 serde(deny_unknown_fields) + camelCase，且 backend.args / locksSettings
-// 有 serde(default)——注册表里存的是解析后的 to_value 结果，所以这两个字段要显式补上。
-const full = {
-  ...manifest,
-  backend: { ...manifest.backend, args: manifest.backend?.args ?? [] },
-  locksSettings: manifest.locksSettings ?? false,
-}
-
-const registry = fs.existsSync(REGISTRY) ? JSON.parse(fs.readFileSync(REGISTRY, 'utf8')) : { schema: 1, entries: {} }
-registry.entries = registry.entries || {}
-const previous = registry.entries[manifest.id] || null
-registry.entries[manifest.id] = {
-  manifest: full,
-  digest,
-  official: false,
-  enabled: previous ? previous.enabled !== false : true,
-  autostart: previous ? previous.autostart !== false : true,
-}
-
-if (fs.existsSync(REGISTRY)) {
-  const backup = REGISTRY + '.bak-' + Date.now()
-  fs.copyFileSync(REGISTRY, backup)
-  say(`${C.dim}备份${C.r}   ${backup}`)
-}
-const tmp = REGISTRY + '.tmp-' + process.pid
-fs.writeFileSync(tmp, JSON.stringify(registry, null, 2))
-fs.renameSync(tmp, REGISTRY)
-
-say('')
-say(`${C.g}✓ 已安装${C.r} ${C.b}${manifest.id}${C.r} v${version}${previous ? '（覆盖旧版）' : ''}`)
-
-// ---------- 提示重启 ----------
-const running = spawnSync('tasklist', ['/FI', 'IMAGENAME eq DSH-FISH.exe', '/NH'], { encoding: 'utf8' })
-if ((running.stdout || '').includes('DSH-FISH.exe')) {
-  say(`${C.y}${C.b}FISH Dock 正在运行${C.r} —— 需要重启它才会加载新版本：`)
-  say(`  ${C.dim}右下角托盘图标退出，或任务管理器结束 DSH-FISH.exe，然后重新打开${C.r}`)
-} else {
-  say(`${C.dim}打开 FISH Dock 即可在插件页看到「文件管理」${C.r}`)
-}

package/dist/filemgr/README.md

@@ -1,62 +0,0 @@
-# 文件管理
-
-把 FISH Dock 变成随手可用的文件工作台：左边逛目录、右边看内容，中间还能把常用文件先「暂存」起来，随时拖进别的程序。
-
-## 功能
-
-### 目录浏览 + 预览
-
-- **目录浏览**：从磁盘根目录、用户目录、桌面 / 文档 / 下载逐层进入；支持把文件 / 文件夹直接拖进面板。
-- **预览**：Markdown 渲染、图片（PNG / JPEG / GIF / WebP / BMP / AVIF / ICO / SVG）、Office 文本抽取（docx 段落与标题、xlsx 多工作表、pptx 每页文字，原生解析 OOXML，不需要装 Office）、代码高亮行号、纯文本与二进制兜底。
-- **上下并列**：上半是文件夹浏览器（面包屑 + 列表 + 上一级 / 刷新 / 常用文件夹 / 固定），下半是预览；中间分隔条可拖动调高，高度会被记住。
-- **框选与拖入暂存**：在列表里拖出选框可批量选中（Ctrl / Shift 点选切换），选中项直接拖到左侧暂存区即批量加入；拖到一半拖出列表会自动从「框选」切到「搬运」。
-- **常用文件夹**：记住打开过的目录，浮层里快速跳转；可把目录「固定」到最上面。
-
-### 选择文件夹
-
-「打开文件夹」默认调用 **Windows 原生文件夹选择框**（`pick-folder.ps1` + IFileOpenDialog），选完直接进入该目录。
-
-宿主原本会在系统对话框抢走焦点时自动收起设置面板。插件只在**弹出对话框的那一刻**调用 `bridge.js` 的 `hold(true)`，选完（或取消/报错）立刻在 `finally` 里 `hold(false)` 放开——平时浏览、拖放都不锁，点面板外面照常能关。
-
-宿主没有 `fish:hold` 能力（官方发行版 ≤ v1.2.3）时，插件自动回落到**内置自绘选择器**（用后端 `preview.tree` 逐层浏览），功能完整，只是不锁面板：
-
-| 宿主 | 「打开文件夹」 | 面板锁定 |
-|---|---|---|
-| 自行编译、带 `fish:hold` 的宿主 | Windows 原生对话框 | 仅对话框期间临时锁定 |
-| 官方发行版（≤ v1.2.3） | 内置选择器 | 不锁定 |
-
-宿主侧要支持这条路，需要三处改动（都已在 `FISH-Dock` 上游以补丁形式验证过）：
-
-1. `sdk/browser/bridge.js` 暴露 `hold(on)` → `parent.postMessage({type:'fish:hold', ticket, on}, '*')`
-2. `Wakuwaku/src/pet/extension-page.js` 收 `fish:hold` 写入 `record.hold`，并新增 `onHold(record, on)` 回调；`park()` / `enter()` / `retire()` 各自同步
-3. `Wakuwaku/src/pet/settings.js` 维护 `pluginHold` 标志，`onBlur` 判定里加 `!pluginHold`
-
-只改插件包、不重编译宿主时，插件自动走内置选择器，功能完整不缺。
-
-### 文件暂存（中转站）
-
-- 拖入文件或文件夹即加入暂存区，也可以右键 / 按钮添加。
-- **分组**：暂存区支持多个分组标签，点击切换，标签可折叠；删除分组只走标签右侧的 ×。
-- **拖出**：把暂存项直接拖到桌面、资源管理器、微信等外部程序。
-- 复制路径、复制为文件、多选批量、去重、清空，偏好持久化。
-
-## 说明
-
-- 只读取路径白名单内的文件，路径解析后必须落在允许的根目录之下；UNC 路径一律拒绝。
-- 「打开文件夹」在支持 `fish:hold` 的宿主上会短暂启动系统 PowerShell 调起 Windows 原生文件夹对话框（`pick-folder.ps1`），用于拿到用户亲手选择的路径；不加 `fish:hold` 的宿主上不会启动子进程，走内置选择器。除此之外不启动任何子进程。
-- 页面运行在宿主沙箱里（`default-src 'none'`），PDF 与音视频不做内联播放，会提示用系统程序打开。
-- 不发起网络请求。
-
-## 存储
-
-偏好（布局、最近打开、额外根目录、暂存分组）保存在插件命名空间的 `config/prefs.json`。
-
-## 开发
-
-```bash
-# 本地暂存（模拟官方 tools/stage-development.mjs 的产出）
-node _stage_filemgr.mjs
-# 产物
-#   dist/filemgr.fish-plugin
-#   _stage/filemgr/   ← 可直接用 FISH Dock 的「从文件安装」装上验证
-```