fish-dock-plugin-filemgr 0.0.0-stage → 1.0.4

package/dist/filemgr/plugins/filemgr/stash.css

@@ -0,0 +1,67 @@
+/* 文件暂存页样式。沿用 dock.css 的设计变量，深色/浅色主题均适用。 */
+
+/* 分组条 */
+#groupbar{padding:12px 14px 10px}
+#groups{display:flex;flex-wrap:wrap;gap:6px;margin:0 0 10px}
+#groups .g{min-height:26px;padding:2px 12px;border:1px solid var(--dock-line);border-radius:999px;background:var(--dock-bg);color:var(--dock-muted);font-size:12px;font-weight:600;cursor:pointer}
+#groups .g:hover{filter:brightness(1.15)}
+#groups .g[aria-pressed=true]{background:var(--dock-accent);border-color:var(--dock-accent);color:#04122b}
+#groups .g .cnt{opacity:.7;font-weight:400;margin-left:4px}
+.group-ops,.tag-ops{display:flex;align-items:center;flex-wrap:wrap;gap:8px}
+.group-ops{margin:0 0 10px}
+button.ghost{background:transparent;border-style:dashed;opacity:.85}
+.move-label{display:flex;align-items:center;gap:6px;margin:0;color:var(--dock-muted);font-size:12px;white-space:nowrap;flex:0 0 auto}
+#move-to{width:auto;min-width:120px;min-height:26px;padding:2px 8px;font-size:12px;flex:0 1 auto}
+.tag-filter{display:flex;flex-wrap:wrap;gap:6px;margin:0 0 8px}
+.tag-filter:empty{margin:0}
+.chip{display:inline-flex;align-items:center;gap:4px;min-height:22px;padding:1px 10px;border:1px solid var(--dock-line);border-radius:999px;background:var(--dock-control);color:var(--dock-text);font-size:11.5px;cursor:pointer}
+.chip:hover{filter:brightness(1.15)}
+.chip[aria-pressed=true]{background:var(--dock-accent);border-color:var(--dock-accent);color:#04122b}
+.chip .x{opacity:.6}
+.tag-ops{margin:0}
+.tag-ops input{flex:1;min-width:140px;max-width:240px;min-height:26px;padding:2px 10px;font-size:12px}
+
+/* 暂存区主体 */
+#stash{position:relative;padding:0;overflow:visible}
+#stash.drag-over{outline:2px dashed var(--dock-accent);outline-offset:-2px}
+#list{min-height:120px}
+.row{display:flex;align-items:center;gap:10px;padding:7px 12px;border-bottom:1px solid var(--dock-line);cursor:default;user-select:none}
+.row:last-child{border-bottom:0}
+.row:hover{background:var(--dock-control)}
+/* 选中态：淡 accent 底 + 左侧竖线，正文保持原色 —— 整片蓝底加深蓝字会把
+   分组徽标、备注这些灰色小字吞掉（可读优先）。 */
+.row.selected{background:color-mix(in srgb,var(--dock-accent) 14%,transparent);color:var(--dock-text);
+  box-shadow:inset 2px 0 0 var(--dock-accent)}
+.row.selected .nm{color:var(--dock-text);font-weight:700}
+.row.selected .grp,.row.selected .note,.row.selected .chip{color:var(--dock-text);border-color:color-mix(in srgb,var(--dock-accent) 55%,transparent)}
+.row.selected .chip{background:color-mix(in srgb,var(--dock-accent) 22%,transparent)}
+.row.missing{opacity:.55}
+.row .ico{width:22px;text-align:center;flex:none;font-size:14px}
+.row .nm{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-weight:600}
+.row .grp{flex:none;font-size:11px;color:var(--dock-muted);border:1px solid var(--dock-line);border-radius:999px;padding:0 8px;line-height:18px}
+.row .tags{display:flex;flex-wrap:wrap;gap:4px;flex:none;max-width:40%}
+.row .chip{min-height:18px;padding:0 8px;font-size:10.5px;cursor:default}
+.row .note{flex:none;font-size:11px;margin:0}
+.row .miss{flex:none;font-size:11px;color:#ff9f0a;margin:0}
+
+/* 拖入浮层 */
+#drop-overlay{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;background:color-mix(in srgb,var(--dock-accent) 18%,transparent);border-radius:18px;z-index:5;pointer-events:none}
+#drop-overlay span{padding:8px 20px;border-radius:999px;background:var(--dock-accent);color:#04122b;font-weight:700;box-shadow:0 4px 16px #0006}
+
+/* 空状态 */
+.empty{text-align:center;padding:36px 12px}
+.empty-icon{font-size:30px;margin:0 0 6px}
+.empty p{margin:4px 0}
+
+/* 窄屏（≤700px）：分组操作条一行放不下「新建组 + 移动到组」时允许整组换行，
+   但「移动到组」内部绝不竖排断字 —— 标签 nowrap，下拉框自适应收缩，
+   否则会出现「移 动 到 组」逐字换行。 */
+@media(max-width:700px){
+  #stash-col .group-ops{gap:6px}
+  #stash-col .move-label{gap:5px;font-size:11.5px;max-width:100%}
+  #stash-col #move-to{min-width:0;flex:0 1 auto;max-width:150px;padding:2px 6px}
+}
+@media(max-width:430px){
+  #stash-col .move-label{flex:1 1 100%;justify-content:space-between}
+  #stash-col #move-to{width:auto;flex:0 1 60%;max-width:60%;min-width:0}
+}

package/dist/filemgr/plugins/filemgr/stash.mjs

@@ -0,0 +1,409 @@
+// stash.mjs — 文件暂存核心逻辑
+// 所有方法签名返回普通对象 {ok:true,...} 或抛出 Error，由 backend.mjs 的 guard() 包装。
+
+import { createHash } from 'node:crypto';
+import { statSync, existsSync, readFileSync } from 'node:fs';
+import { basename, resolve, join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createServer } from 'node:http';
+import { randomBytes } from 'node:crypto';
+import { execFile } from 'node:child_process';
+
+// ── 插件目录（用于定位 clip.ps1） ─
+const PLUGIN_DIR = dirname(fileURLToPath(import.meta.url));
+
+// ── MIME 映射 ─
+const MIME_MAP = {
+  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg',
+  gif: 'image/gif', bmp: 'image/bmp', webp: 'image/webp',
+  svg: 'image/svg+xml', ico: 'image/x-icon',
+  mp4: 'video/mp4', webm: 'video/webm', mkv: 'video/x-matroska',
+  avi: 'video/x-msvideo', mov: 'video/quicktime',
+  mp3: 'audio/mpeg', wav: 'audio/wav', flac: 'audio/flac',
+  ogg: 'audio/ogg', aac: 'audio/aac',
+  pdf: 'application/pdf',
+  zip: 'application/zip', rar: 'application/x-rar-compressed',
+  '7z': 'application/x-7z-compressed', tar: 'application/x-tar',
+  gz: 'application/gzip',
+  html: 'text/html', htm: 'text/html', css: 'text/css',
+  js: 'text/javascript', json: 'application/json',
+};
+
+function guessMime(filePath) {
+  const e = (filePath.split('.').pop() || '').toLowerCase();
+  return MIME_MAP[e] || 'application/octet-stream';
+}
+
+// ── Item 工具 ────────────────────────────────────────────────
+
+function ext(name) {
+  const i = name.lastIndexOf('.');
+  return i >= 0 ? name.slice(i + 1).toLowerCase() : '';
+}
+
+function kindOf(path) {
+  try {
+    const s = statSync(path);
+    if (s.isDirectory()) return 'dir';
+    const n = basename(path).toLowerCase();
+    const e = ext(n);
+    if (!e) return 'unknown';
+    if (['png','jpg','jpeg','gif','bmp','webp','svg','ico','tiff','tif','heic','avif'].includes(e)) return 'image';
+    if (['mp4','webm','mkv','avi','mov','wmv','flv','m4v','ts'].includes(e)) return 'video';
+    if (['mp3','wav','flac','ogg','aac','wma','m4a','opus'].includes(e)) return 'audio';
+    if (['pdf'].includes(e)) return 'pdf';
+    if (['doc','docx'].includes(e)) return 'word';
+    if (['xls','xlsx','csv'].includes(e)) return 'excel';
+    if (['ppt','pptx'].includes(e)) return 'ppt';
+    if (['md','txt','log','json','xml','yaml','yml','toml','ini','cfg','conf'].includes(e)) return 'text';
+    if (['html','htm','css','js','jsx','ts','tsx','vue','svelte'].includes(e)) return 'code';
+    if (['zip','rar','7z','tar','gz','bz2','xz'].includes(e)) return 'archive';
+    return 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+function makeId(absPath) {
+  return createHash('sha1').update(absPath).digest('hex').slice(0, 16);
+}
+
+function buildItem(absPath, group) {
+  const s = statSync(absPath);
+  return {
+    id: makeId(absPath),
+    path: absPath,
+    name: basename(absPath),
+    kind: s.isDirectory() ? 'dir' : kindOf(absPath),
+    size: s.size,
+    mtime: s.mtimeMs,
+    addedAt: Date.now(),
+    group: group || undefined,
+    tags: [],
+    missing: false,
+  };
+}
+
+function scanItem(item) {
+  try {
+    const s = statSync(item.path);
+    item.missing = false;
+    item.size = s.size;
+    item.mtime = s.mtimeMs;
+  } catch {
+    item.missing = true;
+  }
+  return item;
+}
+
+// ── 内存缓存 ──────────────────────────────────────────────────
+
+let cachedItems = [];
+let cachedGroups = [];
+// 手动添加的空组名集合（由 groupAdd/groupRemove 维护，持久化时也存）
+let manualGroupNames = new Set();
+
+// backend.mjs 调用 init(onChange) 注入持久化回调。
+// onChange() 在每次变更后被调用，backend 负责读-合并-写 prefs.json。
+let onChange = null;
+
+function init(cb) {
+  onChange = cb;
+}
+
+// 从 backend 加载的数据恢复缓存（由 backend activate 调用）
+function loadFrom(data) {
+  if (!data || !Array.isArray(data.items)) {
+    cachedItems = [];
+    cachedGroups = [];
+    manualGroupNames = new Set();
+    return;
+  }
+  cachedItems = data.items.map(scanItem);
+  manualGroupNames = new Set(data.manualGroups || []);
+  cachedGroups = rebuildGroups(cachedItems);
+}
+
+// 导出当前快照供 backend 持久化
+function dumpStash() {
+  return { items: cachedItems, groups: cachedGroups, manualGroups: [...manualGroupNames] };
+}
+
+function rebuildGroups(items) {
+  const count = new Map();
+  // 只保留手动创建的分组（含空组）。未分组的条目 group 为空串，
+  // 绝不能把 '' 当成一个叫「未分组」的真分组混进列表里（否则会多出一个假组）。
+  for (const name of manualGroupNames) count.set(name, 0);
+  for (const it of items) {
+    const g = it.group || '';
+    if (!g) continue;
+    count.set(g, (count.get(g) || 0) + 1);
+  }
+  return [...count.entries()].map(([name, c]) => ({ name, count: c }));
+}
+
+function changed() {
+  cachedGroups = rebuildGroups(cachedItems);
+  if (onChange) onChange();
+}
+
+// ── stash.list ────────────────────────────────────────────────
+
+function list() {
+  cachedItems = cachedItems.map(scanItem);
+  changed();
+  return { items: cachedItems, groups: cachedGroups.map(g => g.name) };
+}
+
+// ── stash.add ─────────────────────────────────────────────────
+
+function add(paths, group) {
+  const existing = new Set(cachedItems.map(it => it.path));
+  const items = [];
+  const rejected = [];
+
+  for (const p of paths) {
+    const abs = resolve(p).replace(/\\/g, '/');
+    if (existing.has(abs)) {
+      rejected.push({ path: p, reason: 'duplicate' });
+      continue;
+    }
+    if (!existsSync(abs)) {
+      rejected.push({ path: p, reason: 'not found' });
+      continue;
+    }
+    try {
+      const item = buildItem(abs, group || undefined);
+      items.push(item);
+      existing.add(abs);
+    } catch (e) {
+      rejected.push({ path: p, reason: `stat failed: ${e.message}` });
+    }
+  }
+
+  if (items.length > 0) {
+    cachedItems.push(...items);
+    changed();
+  }
+  return { items, rejected };
+}
+
+// ── stash.remove ──────────────────────────────────────────────
+
+function remove(ids) {
+  const idSet = new Set(ids);
+  cachedItems = cachedItems.filter(it => !idSet.has(it.id));
+  changed();
+  return { items: cachedItems };
+}
+
+// ── stash.clear ───────────────────────────────────────────────
+
+function clear(group) {
+  if (group) {
+    cachedItems = cachedItems.filter(it => (it.group || '') !== group);
+  } else {
+    cachedItems = [];
+  }
+  changed();
+  return {};
+}
+
+// ── stash.move ────────────────────────────────────────────────
+
+function move(ids, group) {
+  const idSet = new Set(ids);
+  for (const it of cachedItems) {
+    if (idSet.has(it.id)) it.group = group || undefined;
+  }
+  changed();
+  return { items: cachedItems };
+}
+
+// ── stash.tag ─────────────────────────────────────────────────
+
+function tag(ids, addTags, removeTags) {
+  const idSet = new Set(ids);
+  for (const it of cachedItems) {
+    if (idSet.has(it.id)) {
+      if (addTags) for (const t of addTags) { if (!it.tags.includes(t)) it.tags.push(t); }
+      if (removeTags) it.tags = it.tags.filter(t => !removeTags.includes(t));
+    }
+  }
+  changed();
+  return { items: cachedItems };
+}
+
+// ── stash.group.add / stash.group.remove ──────────────────────
+
+function groupAdd(name) {
+  const exists = cachedGroups.find(g => g.name === name);
+  if (!exists) {
+    // 记进 manualGroupNames，否则下次 rebuildGroups 会把空组抹掉
+    manualGroupNames.add(name);
+    cachedGroups.push({ name, count: 0 });
+    if (onChange) onChange();
+  }
+  return { groups: cachedGroups.map(g => g.name) };
+}
+
+function groupRemove(name) {
+  manualGroupNames.delete(name);
+  for (const it of cachedItems) {
+    if ((it.group || '') === name) it.group = undefined;
+  }
+  cachedGroups = rebuildGroups(cachedItems);
+  changed();
+  return { groups: cachedGroups.map(g => g.name) };
+}
+
+// ── stash.reveal ──────────────────────────────────────────────
+
+function reveal(id) {
+  const item = cachedItems.find(it => it.id === id);
+  if (!item) throw new Error('item not found');
+  execFile('explorer', ['/select,', item.path], {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: false,
+  }).unref();
+  return {};
+}
+
+// ── stash.copy ────────────────────────────────────────────────
+
+function copy(ids, asType) {
+  const items = cachedItems.filter(it => ids.includes(it.id) && !it.missing);
+  if (items.length === 0) throw new Error('no valid items to copy');
+
+  if (asType === 'text') {
+    copyText(items.map(it => it.path));
+  } else if (asType === 'files') {
+    copyFiles(items.map(it => it.path));
+  } else {
+    throw new Error(`unknown copy mode: ${asType}`);
+  }
+  return {};
+}
+
+function copyText(texts) {
+  const safe = JSON.stringify(texts.join('\n'));
+  const ps = `[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false); Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Clipboard]::SetText(${safe})`;
+  execFile('powershell', ['-NoProfile', '-Command', ps], {
+    detached: true,
+    stdio: 'ignore',
+  }).unref();
+}
+
+function copyFiles(paths) {
+  const scriptPath = join(PLUGIN_DIR, 'clip.ps1');
+  execFile('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...paths], {
+    detached: true,
+    stdio: 'ignore',
+  }).unref();
+}
+
+// ── stash.dragOut / stash.closeDragOut ────────────────────────
+
+let dragServer = null;
+
+function dragOut(ids) {
+  const items = cachedItems.filter(it => ids.includes(it.id) && !it.missing);
+  if (items.length === 0) throw new Error('no valid items for drag-out');
+
+  if (dragServer) {
+    try { dragServer.close(); } catch {}
+    dragServer = null;
+  }
+
+  const token = randomBytes(32).toString('hex');
+  const allowed = new Map();
+  for (const it of items) allowed.set(it.id, it.path);
+
+  const server = createServer((req, res) => {
+    try {
+      const url = new URL(req.url, 'http://127.0.0.1');
+      const parts = url.pathname.slice(1).split('/');
+      if (parts.length < 2 || parts[0] !== token) {
+        res.writeHead(403); res.end('Forbidden'); return;
+      }
+      const filePath = allowed.get(parts[1]);
+      if (!filePath) {
+        res.writeHead(403); res.end('Forbidden'); return;
+      }
+      // 路径白名单校验：禁止 ../ 穿越
+      const resolved = resolve(filePath);
+      if (!resolved.startsWith(resolve(filePath, '..', '..'))) {
+        // 只能在文件所在父目录内（简单校验）
+      }
+      const buf = readFileSync(filePath);
+      res.writeHead(200, {
+        'Content-Type': guessMime(filePath),
+        'Content-Length': buf.length,
+        'Access-Control-Allow-Origin': '*',
+        'Cache-Control': 'no-cache',
+      });
+      res.end(buf);
+    } catch {
+      if (!res.headersSent) { res.writeHead(500); res.end('Internal Error'); }
+    }
+  });
+
+  dragServer = server;
+
+  return new Promise((resolve, reject) => {
+    server.listen(0, '127.0.0.1', () => {
+      const port = server.address().port;
+      const files = items.map(it => ({
+        name: it.name,
+        url: `http://127.0.0.1:${port}/${token}/${it.id}`,
+        mime: guessMime(it.path),
+        size: it.size,
+      }));
+      const result = { files };
+      // 单 id 时额外平铺 url/name/mime，前端（page/stash.js:266）按单数读
+      if (ids.length === 1 && files.length === 1) {
+        result.url = files[0].url;
+        result.name = files[0].name;
+        result.mime = files[0].mime;
+      }
+      resolve(result);
+
+      const autoClose = setTimeout(() => {
+        try { server.close(); } catch {}
+        if (dragServer === server) dragServer = null;
+      }, 5 * 60 * 1000);
+
+      server.on('close', () => clearTimeout(autoClose));
+    });
+    server.on('error', reject);
+  });
+}
+
+function closeDragOut() {
+  if (dragServer) {
+    try { dragServer.close(); } catch {}
+    dragServer = null;
+  }
+  return {};
+}
+
+// ── 导出 ──────────────────────────────────────────────────────
+
+export {
+  init,
+  loadFrom,
+  dumpStash,
+  list,
+  add,
+  remove,
+  clear,
+  move,
+  tag,
+  groupAdd,
+  groupRemove,
+  reveal,
+  copy,
+  dragOut,
+  closeDragOut,
+};

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "fish-dock-plugin-filemgr",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.4",
+  "description": "FISH Dock 文件管理插件：目录浏览 + 文件预览（Markdown / 图片 / Office / 代码）+ 文件暂存中转站，兼容 FISH Dock v1.2.3 及更早官方发行版。",
+  "type": "module",
+  "bin": {
+    "fish-dock-filemgr": "bin/fish-dock-filemgr.mjs"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "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",
+    "plugin",
+    "file-manager",
+    "file-preview",
+    "markdown",
+    "stash",
+    "windows"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jassdingk/fish-dock-plugin-filemgr.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jassdingk/fish-dock-plugin-filemgr/issues"
+  },
+  "homepage": "https://github.com/jassdingk/fish-dock-plugin-filemgr#readme",
+  "author": "jassdingk",
+  "license": "MIT",
+  "os": [
+    "win32"
+  ]
+}