fish-dock-plugin-filemgr 1.0.4 → 1.0.6

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.6",
   "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.6",
   "hostApi": 1,
   "platforms": [
     "windows-x86_64"
@@ -27,18 +27,19 @@
   ],
   "files": {
     "bridge.js": "f38f93994e3cb2b71f2ff1810b3f68fb42f4261550f8ab01b0bfa3eecd5f94ee",
+    "package.json": "d2b066289c54ebfb40da8591f8dbaf261c8cbd0dcb80ea03f5206c7f0aa50e35",
     "plugins/filemgr/backend.mjs": "b448aa688ff11f2abc4c5281b4714646ed6c384473d873cfe431a8e64b066d26",
     "plugins/filemgr/clip.ps1": "b0a32fca35cf2d25133338f46e20a0db20d78c5bb6b5c2aab899998bfbd6c6ab",
     "plugins/filemgr/dock.css": "e795214dd39de3b473ac0b1a7b79f6922a88c761fca4d3ea4da8fd9b60188bcf",
-    "plugins/filemgr/filemgr.css": "16c621471133d29c6942781bedf86e0a4de806865ff004b666bcad8b1929434e",
+    "plugins/filemgr/filemgr.css": "79b878b29499284935d71dfa877716232f85ed40d864437382a059fa8ced0479",
     "plugins/filemgr/FolderPicker.ps1": "4b7f86c543e06fd8f93fa5d8002997d944c8189cb0ae031bedf864ea89196427",
     "plugins/filemgr/page.css": "0801a05b5148cd091a68957beac21cc982a7818ef4707cd06fd11b20adbc7765",
     "plugins/filemgr/page.html": "3cfda31be29cd23b1e0f7f6004b6c03522c3526b78f9df4711e320962a660831",
-    "plugins/filemgr/page.js": "282f11d803ddc8bb87a0a99d8af68315f4ff7304672072da838a07a47c5cdc62",
+    "plugins/filemgr/page.js": "74a7ccae18f7857be9656f14db07c2bddbf4591fff57a7eb16722ee4128e739d",
     "plugins/filemgr/pick-files.ps1": "88bff92d9a2e5b69e9411bb372441ff0b86899b7f5b31f5ed8d154c4f6fc2f37",
     "plugins/filemgr/pick-folder.ps1": "ff031c14df32149c1c80c7ab6a21710c1a68e823e96e3068c458a60902ae3b6f",
     "plugins/filemgr/preview.mjs": "a5596e77180fe7928443244a0148b6d3ea8381a1f886ee01f9a08be038c7ee80",
-    "plugins/filemgr/sdk.mjs": "76b052b8d99ff6b6b0b149aee7479d1129bb248a959625642282184978065f38",
+    "plugins/filemgr/sdk.mjs": "91061dae337157c88e2303d1899f9149ccecd656df4675c76dd5721bc405bf07",
     "plugins/filemgr/stash.css": "fce2aaa13a86dbd7675b685c533f0bb916c7e610fc612a3ade660c67069f5662",
     "plugins/filemgr/stash.mjs": "c33cea6b845a3847950d26a10b9aba1ef68d39b1f9fc423b23055dead7638866",
     "README.md": "e9fb4ca9831b778a1d530b67518fcaf2b42cf02494b9d68deaad16bf2b947687"

package/{dist/filemgr/plugins → plugins}/filemgr/filemgr.css

@@ -71,6 +71,14 @@ body[data-resizing=true]{user-select:none;cursor:col-resize}
 .stash-group>.stash-tag.active>.stash-tag-count{opacity:.8}
 .stash-group>.stash-tag.active>.stash-tag-del{color:#1a1035;opacity:.75}
 .stash-group>.stash-tag.active>.stash-tag-del:hover{color:#7a1010}
+/* 拖动文件悬停到某个分组标签上：高亮该分组名，提示松手即落入此分组 */
+.stash-group>.stash-tag.drop-hover{
+  color:#1a1035;background:var(--dock-accent);border-color:var(--dock-accent);
+  box-shadow:0 0 0 2px color-mix(in srgb,var(--dock-accent) 40%,transparent);
+}
+.stash-group>.stash-tag.drop-hover>.stash-tag-dot{background:#1a1035}
+.stash-group>.stash-tag.drop-hover>.stash-tag-count{opacity:.85}
+.stash-group>.stash-tag.drop-hover>.stash-tag-del{color:#1a1035;opacity:.75}
 /* 右侧文件列表：已在暂存/分组里的文件 */
 .filelist .row.stashed .nm{color:var(--dock-accent)}
 .stash-badge{flex:none;font-size:10px;line-height:1;padding:2px 6px;border-radius:999px;

package/{dist/filemgr/plugins → plugins}/filemgr/page.js

@@ -1472,6 +1472,7 @@
 
       const summary = el('summary', {
         class: 'stash-tag' + (active ? ' active' : ''),
+        dataset: { group: bucket.key },   // 供拖拽命中：拖到此标签上即高亮该组名并落入该分组
         title: `${bucket.label} · ${bucket.items.length} 项（点箭头/整条折叠；点右侧漏斗图标只在看本组与全部间切换）`,
       })
       // 单击整条标签 = 折叠/展开（summary 默认行为，不拦截）。
@@ -1765,11 +1766,12 @@
   // 批量加入（框选后拖进暂存区走这一条）。
   // 后端 stash.add 本来就吃 paths 数组，所以只是把多行一次性递过去；
   // 逐个报告"加了几项/几项重复"，比只弹一个含糊的 toast 更好懂。
-  async function addManyToStash(paths) {
+  async function addManyToStash(paths, group) {
     const list = (paths || []).filter(Boolean)
     if (!list.length) return
-    const group = state.view === 'all' ? '' : state.view
-    const row = await callSoft('stash.add', { paths: list, group })
+    // 显式传入的分组（拖到某个分组标签上）优先；未指定时回退到当前视图分组。
+    const targetGroup = group === undefined ? (state.view === 'all' ? '' : state.view) : group
+    const row = await callSoft('stash.add', { paths: list, group: targetGroup })
     if (row && row.ok) {
       const added = Array.isArray(row.items) ? row.items.length : 0
       const dup = list.length - added
@@ -1800,6 +1802,7 @@
     let moved = false
     let suppressClick = false
     let ghost = null
+    let dropGroup = undefined     // 拖拽时命中的分组标签 key（undefined=未命中，回退当前视图）
 
     const rows = () => Array.from(list.querySelectorAll('.row[data-path]'))
 
@@ -1836,6 +1839,8 @@
       if (ghost) { ghost.remove(); ghost = null }
       for (const node of list.querySelectorAll('.row.drag-src')) node.classList.remove('drag-src')
       if (stashCol) stashCol.classList.remove('drop-target')
+      dropGroup = undefined
+      for (const node of document.querySelectorAll('.stash-tag.drop-hover')) node.classList.remove('drop-hover')
     }
 
     list.addEventListener('pointerdown', event => {
@@ -1920,8 +1925,14 @@
       } else if (mode === 'drag' && ghost) {
         ghost.style.left = `${event.clientX + 14}px`
         ghost.style.top = `${event.clientY + 14}px`
-        const over = stashCol && document.elementFromPoint(event.clientX, event.clientY)?.closest('#stash-col')
+        const under = document.elementFromPoint(event.clientX, event.clientY)
+        const over = stashCol && under?.closest('#stash-col')
         if (stashCol) stashCol.classList.toggle('drop-target', !!over)
+        // 命中哪个分组标签，就高亮哪个分组名并把它作为落点；未命中分组标签则回退当前视图分组。
+        const hitTag = under && under.closest('.stash-tag[data-group]')
+        dropGroup = hitTag ? hitTag.dataset.group : undefined
+        for (const node of document.querySelectorAll('.stash-tag.drop-hover')) node.classList.remove('drop-hover')
+        if (hitTag) hitTag.classList.add('drop-hover')
       }
       event.preventDefault()
     })
@@ -1930,6 +1941,7 @@
       if (mode === 'idle') return
       const was = mode
       const paths = dragPaths.slice()
+      const group = dropGroup            // 松手前记录命中的分组（reset 会清空）
       const dropped = was === 'drag' && !!(
         stashCol && document.elementFromPoint(event.clientX, event.clientY)?.closest('#stash-col')
       )
@@ -1940,7 +1952,7 @@
         setTimeout(() => { suppressClick = false }, 0)
       }
       reset()
-      if (dropped && paths.length) await addManyToStash(paths)
+      if (dropped && paths.length) await addManyToStash(paths, group)
     }
 
     list.addEventListener('pointerup', event => { finish(event) })

package/{dist/filemgr/plugins → plugins}/filemgr/sdk.mjs

@@ -3,7 +3,7 @@ const CATEGORIES = new Set(['credentials','roster','keys','config','exports','ba
 const DEFAULT_LIMIT = 1024 * 1024;
 export function createPlugin({ id, input = process.stdin, output = process.stdout,
   activate = async () => {}, deactivate = async () => {}, onEvent = async () => {}, commands = {},
-  onError = () => {}, maxLine = DEFAULT_LIMIT, requestTimeout = 5000 } = {}) {
+  onError = () => {}, maxLine = DEFAULT_LIMIT, requestTimeout = 12000 } = {}) {
   if (!/^[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id ?? '')) throw new Error('插件 ID 格式无效');
   if (!Number.isSafeInteger(maxLine) || maxLine < 128 || maxLine > DEFAULT_LIMIT) throw new Error('协议帧大小无效');
   if (!Number.isSafeInteger(requestTimeout) || requestTimeout < 1 || requestTimeout > 30000) throw new Error('宿主调用时限无效');
@@ -94,7 +94,10 @@ export function createPlugin({ id, input = process.stdin, output = process.stdou
     if (!row || typeof row !== 'object' || Array.isArray(row)) throw new Error('插件协议应为 JSON 对象');
     if (!Object.hasOwn(row,'method')) {
       const waiter = pending.get(row.id);
-      if (!waiter) throw new Error('宿主响应编号不匹配');
+      // 迟到/重复的宿主响应（原请求已因超时被清理）：静默丢弃，绝不让整个插件会话崩溃。
+      // 原实现此处 throw 会经 receive() → close()+onError() 杀死插件；任何一次超过
+      // requestTimeout 的存储调用，其迟到响应都会触发。调用方早已通过超时 reject 感知失败。
+      if (!waiter) return;
       pending.delete(row.id); clearTimeout(waiter.timer);
       if (Object.hasOwn(row,'result') === Object.hasOwn(row,'error')) return waiter.reject(new Error('宿主响应结构无效'));
       if (row.error) waiter.reject(new Error('宿主存储操作失败')); else waiter.resolve(row.result);

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 的「从文件安装」装上验证
-```