@dsh-sparrow/dsh-file-manage 0.1.0 → 0.1.2-rc.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 English | [简体中文](CHANGELOG.zh-CN.md)
 
+## 0.1.2-rc.1 (2026-09-05)
+
+- Version-line alignment with official dsh 0.1.2-rc.1 (stability line).
+- Pagination and delete race fixes: after quickly reopening the panel or hitting Retry, stale pages no longer merge into the fresh list, "Load more" no longer sticks disabled, and a late delete callback no longer dismisses a newly opened confirmation dialog.
+- Requests that outlive the panel now stop by themselves instead of hanging (15s cap for list/delete, 60s for the count pass), and the count pass stops paging as soon as the client connection drops, so an abandoned count no longer keeps burning API quota.
+- The sidebar "Cloud Files" button now aligns its width with Settings (same as the Archive entry).
+- "Load more" now lives at the end of the file list and the list auto-scrolls to the bottom after each page loads (the button no longer sits in a fixed panel footer).
+- A subtle 🐦 dsh-sparrow brand line closes the panel.
+
 ## 0.1.0 (2026-09-02)
 
 - Promoted 0.1.0 (identical to 0.1.0-alpha.3).

package/CHANGELOG.zh-CN.md

@@ -2,6 +2,15 @@
 
 简体中文 | [English](CHANGELOG.md)
 
+## 0.1.2-rc.1（2026-09-05）
+
+- 版本对齐官方 dsh 0.1.2-rc.1（稳定线）。
+- 翻页与删除的并发修复：快速关开面板或点击重试后，陈旧页不再混入新列表、「加载更多」不再卡死，迟到的删除回调不再误关新弹出的确认框。
+- 请求超时后自行停止不再无限挂起（列表/删除 15s、计数 60s 上限），计数翻页在客户端连接断开（超时/导航）时立即停下，被放弃的计数不再持续消耗 API 配额。
+- 侧边栏「云端文件」按钮与 Settings 同宽对齐（与归档入口一致）。
+- 「加载更多」移到文件列表末尾，每页加载后自动滚到列表底部（按钮不再固定在面板底部）。
+- 面板底部新增 🐦 dsh-sparrow 品牌行。
+
 ## 0.1.0 (2026-09-02)
 
 - 转正 0.1.0（与 0.1.0-alpha.3 一致）。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 peiyucn
+
+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.

package/README.md

@@ -12,14 +12,14 @@ Large images pasted into DSH are auto-uploaded to the DeepSeek Files API, but th
 dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
 ```
 
-Requires dsh ≥ 0.1.2-alpha.4 and a working `pnpm` (`dsh plugin` forwards installation to pnpm).
+Requires dsh ≥ 0.1.2-rc.1 and a working `pnpm` (`dsh plugin` forwards installation to pnpm).
 
 > Do **not** run `npm install @dsh-sparrow/dsh-file-manage` directly: that only downloads the package into some `node_modules` and does not register it with the DSH web profile. Use the `dsh plugin` command above, then restart DSH.
 
 ## Usage
 
 * **Entry**: the "Cloud Files" button at the sidebar footer
-* **List**: 20 files per page with "Load more" pagination (official after cursor, newest first); each row shows filename / size / upload time / expiry time (when present)
+* **List**: newest first with "Load more" at the bottom (100 more files per click, official after cursor); each row shows filename / size / upload time / expiry time (when present)
 * **Quota**: the panel header shows the total count and a netdisk-style quota bar (used storage / the official 25 GiB limit)
 * **Delete**: per-row delete with confirmation; "DSH auto-uploaded" files (`dsh-` prefix) get an extra note — sessions referencing them will transparently re-upload on next use (may be slower)
 * **Copy file_id**: one-click copy per row
@@ -40,3 +40,5 @@ Requires dsh ≥ 0.1.2-alpha.4 and a working `pnpm` (`dsh plugin` forwards insta
 ## Uninstall & leftovers
 
 * The plugin keeps no local state; uninstalling leaves the cloud files untouched and DSH behavior unchanged
+
+**Changelog**: [CHANGELOG.md](https://github.com/peiyucn/dsh-sparrow/blob/main/plugins/dsh-file-manage/CHANGELOG.md)

package/README.zh-CN.md

@@ -12,14 +12,14 @@ DSH 贴图的大图会自动上传到 DeepSeek Files API（云端文件库），
 dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
 ```
 
-适配 dsh ≥ 0.1.2-alpha.4，并需要可用的 `pnpm`（`dsh plugin` 会把安装操作转发给 pnpm）。
+适配 dsh ≥ 0.1.2-rc.1，并需要可用的 `pnpm`（`dsh plugin` 会把安装操作转发给 pnpm）。
 
 > **不要**直接执行 `npm install @dsh-sparrow/dsh-file-manage`：那只会把包下载到某个 `node_modules`，不会注册进 DSH 的 web profile。请使用上面的 `dsh plugin` 命令安装，并在安装后重启 DSH。
 
 ## 使用
 
 * **入口**：侧边栏底部「云端文件」按钮
-* **列表**：每页 20 条，底部「加载更多」翻页（官方 after 游标，最新在前）；行内展示文件名 / 大小 / 上传时间 / 到期时间（有则显）
+* **列表**：最新在前，底部「加载更多」每次多显示 100 条（官方 after 游标翻页）；行内展示文件名 / 大小 / 上传时间 / 到期时间（有则显）
 * **配额**：列表顶部显示总数与网盘式配额进度条（已用存储 / 25 GiB 官方上限）
 * **删除**：行内删除按钮二次确认；「DSH 自动上传」角标（`dsh-` 前缀）的文件有额外提示——删除后旧会话再次引用时官方会自动重新上传（可能稍慢）
 * **复制 file_id**：行内按钮一键复制
@@ -40,3 +40,5 @@ dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
 ## 卸载与残留
 
 * 插件无任何本地持久化状态；卸载后云端文件原样保留，DSH 行为不受影响
+
+**更新日志**：[CHANGELOG.zh-CN.md](https://github.com/peiyucn/dsh-sparrow/blob/main/plugins/dsh-file-manage/CHANGELOG.zh-CN.md)

package/lib/client.js

@@ -32,19 +32,56 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/client/paging.ts
+var RENDER_PAGE_SIZE = 100;
+var FILE_PAGE_SIZE = 200;
+function renderedRowCount(totalRows, renderLimit) {
+  const total = Math.max(0, Math.trunc(totalRows));
+  const limit = Math.max(0, Math.trunc(renderLimit));
+  return Math.min(total, limit);
+}
+function hasLoadMore(totalRows, renderLimit, dataHasMore) {
+  return renderedRowCount(totalRows, renderLimit) < totalRows || dataHasMore;
+}
+
 // src/client/api.ts
+var COUNT_CACHE_TTL_MS = 3e4;
+var countCache = null;
+function readCountCache(entry, nowMs) {
+  return entry !== null && nowMs < entry.expiresAt ? entry.value : null;
+}
+function invalidateCountCache() {
+  countCache = null;
+}
 var REQUEST_TIMEOUT_MS = 15e3;
 var COUNT_TIMEOUT_MS = 6e4;
+async function fetchWithTimeout(path, init, timeoutMs) {
+  try {
+    return await fetch(path, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+  } catch (error) {
+    if (error instanceof DOMException && (error.name === "AbortError" || error.name === "TimeoutError")) {
+      throw new Error(`\u8BF7\u6C42\u8D85\u65F6\uFF08${Math.round(timeoutMs / 1e3)}s\uFF09\uFF0C\u8BF7\u91CD\u8BD5`);
+    }
+    throw error;
+  }
+}
+async function readJson(response) {
+  try {
+    return await response.json();
+  } catch {
+    return {};
+  }
+}
+async function readErrorMessage(response) {
+  const payload = await readJson(response);
+  return payload.error?.message ?? `\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`;
+}
 async function listApi(after) {
-  const params = new URLSearchParams();
+  const params = new URLSearchParams({ limit: String(FILE_PAGE_SIZE) });
   if (after !== void 0) params.set("after", after);
-  const response = await fetch(`/api/file-manage/list?${params.toString()}`, {
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-  });
-  const payload = await response.json();
-  if (!response.ok) {
-    throw new Error(payload.error?.message ?? `\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`);
-  }
+  const response = await fetchWithTimeout(`/api/file-manage/list?${params.toString()}`, {}, REQUEST_TIMEOUT_MS);
+  if (!response.ok) throw new Error(await readErrorMessage(response));
+  const payload = await readJson(response);
   return {
     rows: payload.items ?? [],
     hasMore: payload.hasMore ?? false,
@@ -52,12 +89,12 @@ async function listApi(after) {
   };
 }
 async function countApi() {
-  const response = await fetch("/api/file-manage/count", { signal: AbortSignal.timeout(COUNT_TIMEOUT_MS) });
-  const payload = await response.json();
-  if (!response.ok) {
-    throw new Error(payload.error?.message ?? `\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`);
-  }
-  return {
+  const cached = readCountCache(countCache, Date.now());
+  if (cached !== null) return cached;
+  const response = await fetchWithTimeout("/api/file-manage/count", {}, COUNT_TIMEOUT_MS);
+  if (!response.ok) throw new Error(await readErrorMessage(response));
+  const payload = await readJson(response);
+  const summary = {
     count: payload.count ?? 0,
     totalBytes: payload.totalBytes ?? 0,
     totalBytesLabel: payload.totalBytesLabel ?? "0 B",
@@ -65,17 +102,14 @@ async function countApi() {
     quotaBytesLabel: payload.quotaBytesLabel ?? "0 B",
     quotaCount: payload.quotaCount ?? 0
   };
+  countCache = { value: summary, expiresAt: Date.now() + COUNT_CACHE_TTL_MS };
+  return summary;
 }
 async function deleteApi(id) {
   const params = new URLSearchParams({ id });
-  const response = await fetch(`/api/file-manage/files?${params.toString()}`, {
-    method: "DELETE",
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-  });
-  const payload = await response.json();
-  if (!response.ok) {
-    throw new Error(payload.error?.message ?? `\u8BF7\u6C42\u5931\u8D25\uFF08HTTP ${response.status}\uFF09`);
-  }
+  const response = await fetchWithTimeout(`/api/file-manage/files?${params.toString()}`, { method: "DELETE" }, REQUEST_TIMEOUT_MS);
+  if (!response.ok) throw new Error(await readErrorMessage(response));
+  invalidateCountCache();
 }
 
 // src/client/FileManageDock.tsx
@@ -411,17 +445,22 @@ var styles = {
     fontSize: 12,
     lineHeight: "18px"
   },
-  footerBar: {
+  /** 合集品牌 footer：固定面板底部（滚动区之外），顶部分割线与内容区隔开；紧凑规格。 */
+  footer: {
     flex: "none",
-    display: "flex",
-    justifyContent: "center",
-    // 列表已包区块卡，不再加顶部分隔线（避免与卡片叠加显乱）。
-    padding: "10px 24px 14px"
+    boxSizing: "border-box",
+    padding: "6px 24px 8px",
+    borderTop: "1px solid var(--dsw-alias-border-l1, #e2e5ea)",
+    textAlign: "center",
+    fontSize: 11,
+    lineHeight: "16px",
+    color: "var(--dsw-alias-label-tertiary, #8a919f)"
   }
 };
 
 // src/client/FileManageDock.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
+var COPIED_RESET_MS = 2e3;
 function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
   const [open, setOpen] = (0, import_react.useState)(false);
   const [rows, setRows] = (0, import_react.useState)([]);
@@ -437,13 +476,20 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
   const [summaryPending, setSummaryPending] = (0, import_react.useState)(false);
   const closeButtonRef = (0, import_react.useRef)(null);
   const refreshSeqRef = (0, import_react.useRef)(0);
+  const bodyRef = (0, import_react.useRef)(null);
+  const scrollPendingRef = (0, import_react.useRef)(false);
   const copiedTimerRef = (0, import_react.useRef)(null);
+  const [renderLimit, setRenderLimit] = (0, import_react.useState)(RENDER_PAGE_SIZE);
   const reload = (0, import_react.useCallback)(() => {
     const seq = ++refreshSeqRef.current;
     setLoading(true);
     setSummaryPending(true);
     setSummary(null);
     setError(null);
+    setLoadingMore(false);
+    setBusyDelete(false);
+    scrollPendingRef.current = false;
+    setRenderLimit(RENDER_PAGE_SIZE);
     listFiles().then((page) => {
       if (seq !== refreshSeqRef.current) return;
       setRows(page.rows);
@@ -486,18 +532,29 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
     if (copiedTimerRef.current !== null) window.clearTimeout(copiedTimerRef.current);
   }, []);
   const loadMore = (0, import_react.useCallback)(() => {
-    if (lastId === void 0 || loadingMore) return;
+    if (loadingMore) return;
+    if (renderLimit < rows.length) {
+      setRenderLimit((limit) => limit + RENDER_PAGE_SIZE);
+      scrollPendingRef.current = true;
+      return;
+    }
+    if (lastId === void 0) return;
+    const seq = refreshSeqRef.current;
     setLoadingMore(true);
+    scrollPendingRef.current = true;
     listFiles(lastId).then((page) => {
+      if (seq !== refreshSeqRef.current) return;
       setRows((current) => [...current, ...page.rows]);
       setHasMore(page.hasMore);
       setLastId(page.lastId);
+      setRenderLimit((limit) => limit + RENDER_PAGE_SIZE);
     }).catch((reason) => {
+      if (seq !== refreshSeqRef.current) return;
       setError(reason instanceof Error ? reason.message : String(reason));
     }).finally(() => {
-      setLoadingMore(false);
+      if (seq === refreshSeqRef.current) setLoadingMore(false);
     });
-  }, [lastId, loadingMore, listFiles]);
+  }, [renderLimit, rows.length, lastId, loadingMore, listFiles]);
   const copyId = (0, import_react.useCallback)(async (row) => {
     try {
       await navigator.clipboard.writeText(row.id);
@@ -505,27 +562,39 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
       if (copiedTimerRef.current !== null) window.clearTimeout(copiedTimerRef.current);
       copiedTimerRef.current = window.setTimeout(() => {
         setCopied(null);
-      }, 2e3);
+      }, COPIED_RESET_MS);
     } catch {
       setCopied(null);
       setError(t("copyFailed"));
     }
   }, [t]);
+  (0, import_react.useEffect)(() => {
+    if (!scrollPendingRef.current) return;
+    scrollPendingRef.current = false;
+    const el = bodyRef.current;
+    if (el !== null) el.scrollTop = el.scrollHeight;
+  }, [rows, renderLimit]);
   const initialLoading = loading || summaryPending;
   const quotaRatio = summary === null ? 0 : storageUsageRatio(summary.totalBytes, summary.quotaBytes);
+  const visibleCount = renderedRowCount(rows.length, renderLimit);
   const submitDelete = (0, import_react.useCallback)(() => {
     if (confirming === null || busyDelete) return;
+    const seq = refreshSeqRef.current;
+    const deleteId = confirming.id;
     setBusyDelete(true);
-    deleteFile(confirming.id).then(() => {
-      setRows((current) => current.filter((row) => row.id !== confirming.id));
-      setConfirming(null);
-      void countFiles().then(setSummary).catch(() => {
+    deleteFile(deleteId).then(() => {
+      setRows((current) => current.filter((row) => row.id !== deleteId));
+      setConfirming((current) => current !== null && current.id === deleteId ? null : current);
+      void countFiles().then((next) => {
+        if (seq === refreshSeqRef.current) setSummary(next);
+      }).catch(() => {
       });
     }).catch((reason) => {
+      if (seq !== refreshSeqRef.current) return;
       setError(reason instanceof Error ? reason.message : String(reason));
-      setConfirming(null);
+      setConfirming((current) => current !== null && current.id === deleteId ? null : current);
     }).finally(() => {
-      setBusyDelete(false);
+      if (seq === refreshSeqRef.current) setBusyDelete(false);
     });
   }, [busyDelete, confirming, deleteFile, countFiles]);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
@@ -560,9 +629,9 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
           /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dsh-file-manage-quota-text", children: `${summary.totalBytesLabel} / ${summary.quotaBytesLabel} \xB7 ${t("quota.used", { percent: formatUsagePercent(quotaRatio) })}` }),
           quotaRatio > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsh-file-manage-quota-fill", style: { width: `${Math.round(quotaRatio * 100)}%` } }) : null
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "dsh-file-manage-count", children: rows.length < summary.count ? t("summary.loaded", { loaded: rows.length, count: summary.count }) : t("summary.count", { count: summary.count }) })
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "dsh-file-manage-count", children: visibleCount < summary.count ? t("summary.loaded", { loaded: visibleCount, count: summary.count }) : t("summary.count", { count: summary.count }) })
       ] }) : null,
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { ...styles.body, padding: summary !== null ? "0 24px 24px" : "12px 24px 24px" }, className: "dsh-file-manage-body", children: initialLoading ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dsh-file-manage-loading", role: "status", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { ref: bodyRef, style: { ...styles.body, padding: summary !== null ? "0 24px 24px" : "12px 24px 24px" }, className: "dsh-file-manage-body", children: initialLoading ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dsh-file-manage-loading", role: "status", children: [
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "dsh-file-manage-spinner", "aria-hidden": true }),
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("loading") })
       ] }) : /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
@@ -574,7 +643,7 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
           }, children: t("retry") })
         ] }) : null,
         error === null && rows.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: styles.secondarySmall, children: t("empty") }) : null,
-        rows.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsh-file-manage-card", children: rows.map((row) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.row, children: [
+        rows.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsh-file-manage-card", children: rows.slice(0, renderLimit).map((row) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.row, children: [
           /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { minWidth: 0 }, children: [
             /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 6, minWidth: 0 }, children: [
               /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: styles.title, title: row.filename, children: row.filename }),
@@ -611,20 +680,21 @@ function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
               }
             )
           ] })
-        ] }, row.id)) }) : null
+        ] }, row.id)) }) : null,
+        hasLoadMore(rows.length, renderLimit, hasMore) && !initialLoading ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { display: "flex", justifyContent: "center", paddingTop: 12 }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "button",
+          {
+            type: "button",
+            className: "dsh-file-manage-btn",
+            disabled: loadingMore,
+            onClick: () => {
+              void loadMore();
+            },
+            children: loadingMore ? t("loading") : t("loadMore")
+          }
+        ) }) : null
       ] }) }),
-      hasMore && !initialLoading ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.footerBar, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "button",
-        {
-          type: "button",
-          className: "dsh-file-manage-btn",
-          disabled: loadingMore,
-          onClick: () => {
-            void loadMore();
-          },
-          children: loadingMore ? t("loading") : t("loadMore")
-        }
-      ) }) : null
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.footer, children: "\u{1F426} dsh-sparrow" })
     ] }) }) : null,
     confirming !== null ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "dsh-file-manage-confirm-overlay", role: "presentation", onMouseDown: (event) => {
       if (event.target === event.currentTarget && !busyDelete) setConfirming(null);

package/lib/host.js

@@ -9,6 +9,11 @@ const PREFIX = '/api/file-manage';
 const DEFAULT_BASE_URL = 'https://api.deepseek.com';
 const DEFAULT_API_KEY_ENV = 'DEEPSEEK_API_KEY';
 const LLM_DEEPSEEK_NS = 'llm-deepseek';
+/**
+ * 单页 list / 单条 delete 的上游超时：官方 client 的 fetch 本身无默认超时，客户端断开
+ * （关面板 / 15s 超时）后残留的上游请求必须自限，否则会无限挂起并占用官方 API 配额。
+ */
+const UPSTREAM_TIMEOUT_MS = 15_000;
 /** 插件自身错误（面板可读的 code / message + HTTP 状态）。 */
 class FileManageError extends Error {
     code;
@@ -92,6 +97,7 @@ export function apply(ctx) {
                         ...query.after === undefined ? {} : { after: DeepSeekFileId(query.after) },
                         limit: query.limit,
                         order: query.order,
+                        signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS),
                     });
                     sendJson(res, 200, {
                         items: page.data.map(toFileRow),
@@ -108,6 +114,9 @@ export function apply(ctx) {
                     let totalBytes = 0;
                     let after;
                     for (let page = 0; page < MAX_COUNT_PAGES; page++) {
+                        // 客户端已断开（超时 / 关面板）时停止翻页：剩余页数没有接收方，白烧官方 API 配额。
+                        if (res.destroyed)
+                            break;
                         const result = await client.list({
                             ...after === undefined ? {} : { after },
                             limit: COUNT_PAGE_LIMIT,
@@ -139,7 +148,7 @@ export function apply(ctx) {
                     }
                     const connection = await resolveConnection(ctx);
                     const client = new DeepSeekFilesClient({ baseURL: connection.baseURL, apiKey: connection.apiKey });
-                    await client.delete(DeepSeekFileId(id));
+                    await client.delete(DeepSeekFileId(id), AbortSignal.timeout(UPSTREAM_TIMEOUT_MS));
                     sendJson(res, 200, { deleted: true, id });
                     return;
                 }

package/lib/types/client/api.d.ts

@@ -9,6 +9,17 @@ export interface FileCountSummary {
     quotaBytesLabel: string;
     quotaCount: number;
 }
+/** 总数统计 TTL 缓存时长：面板快速重开/重试不重复 count 全量翻页（count 要翻到底，配额内最多 10 页）。 */
+export declare const COUNT_CACHE_TTL_MS = 30000;
+/** TTL 缓存条目（api.ts 模块级单例：面板单实例，随 client bundle 生命周期，有界一条）。 */
+export interface CountCacheEntry {
+    readonly value: FileCountSummary;
+    readonly expiresAt: number;
+}
+/** TTL 读缓存（时钟注入的纯逻辑，供单测）：未过期返回快照，过期或缺条返回 null。 */
+export declare function readCountCache(entry: CountCacheEntry | null, nowMs: number): FileCountSummary | null;
+/** 删除成功后失效计数缓存：下一次 count 拉取重新翻页，包含删除结果。 */
+export declare function invalidateCountCache(): void;
 export declare function listApi(after?: string): Promise<{
     rows: FileRow[];
     hasMore: boolean;

package/lib/types/client/paging.d.ts

@@ -0,0 +1,13 @@
+/** 文件面板渲染窗口纯逻辑（对齐 archive-manage spec 09）：数据分页与 DOM 渲染窗口分离。 @module dsh-file-manage/client/paging */
+/** 渲染窗口大小：每次渲染的行数上限，「加载更多」按此递增（archive 同款 100）。 */
+export declare const RENDER_PAGE_SIZE = 100;
+/**
+ * 数据分页大小：每次 list 拉取的行数。必须大于渲染窗口（200 > 100），
+ * 窗口才会真正裁剪 DOM——否则窗口永远跑在数据前面，退化回全量渲染。
+ */
+export declare const FILE_PAGE_SIZE = 200;
+/** 窗口内可见行数：min(已加载行数, 窗口上限)；负数/小数钳到安全值（不抛）。 */
+export declare function renderedRowCount(totalRows: number, renderLimit: number): number;
+/** 「加载更多」是否可见：窗口未盖满已加载行（纯延伸窗口），或服务端还有更多数据（延伸窗口 + 拉页）。 */
+export declare function hasLoadMore(totalRows: number, renderLimit: number, dataHasMore: boolean): boolean;
+//# sourceMappingURL=paging.d.ts.map

package/lib/types/client/styles.d.ts

@@ -56,11 +56,16 @@ export declare const styles: {
         fontSize: number;
         lineHeight: string;
     };
-    readonly footerBar: {
+    /** 合集品牌 footer：固定面板底部（滚动区之外），顶部分割线与内容区隔开；紧凑规格。 */
+    readonly footer: {
         flex: string;
-        display: "flex";
-        justifyContent: "center";
+        boxSizing: "border-box";
         padding: string;
+        borderTop: string;
+        textAlign: "center";
+        fontSize: number;
+        lineHeight: string;
+        color: "var(--dsw-alias-label-tertiary, #8a919f)";
     };
 };
 //# sourceMappingURL=styles.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dsh-sparrow/dsh-file-manage",
   "description": "DSH web plugin: manage DeepSeek Files API cloud files from the sidebar — list with cursor pagination, delete, and copy file_id (reuses the official DeepSeekFilesClient, no extra credentials)",
-  "version": "0.1.0",
+  "version": "0.1.2-rc.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,6 +24,7 @@
   },
   "files": [
     "lib/**/*.js",
+    "!lib/client/**",
     "lib/types/**/*.d.ts",
     "cordis.patch.yml",
     "README.md",
@@ -37,8 +38,7 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-locale",
+                "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-sidebar"
       ]
     }
@@ -48,11 +48,11 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^0.1.1-rc.2 || ^4.0.1",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm-deepseek": "^0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.4"
+    "@deepseek-ai/dsh-credentials": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "0.1.1-rc.2",
@@ -61,11 +61,11 @@
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-sidebar": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-credentials": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm-deepseek": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.4",
+    "@deepseek-ai/dsh-credentials": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm-deepseek": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.1",

package/lib/client/FileManageDock.js

@@ -1,154 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/** 云端文件面板视图：入口按钮 + 弹窗（列表 / 翻页 / 删除确认 / 复制 / 配额条）；样式与请求分别在 styles.ts / api.ts。 */
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { IconCloseOutline16, IconFolderOpenOutline16 } from '@deepseek-ai/dsh-client-ui-primitives';
-import { formatUsagePercent, storageUsageRatio } from './quota.js';
-import { styles } from './styles.js';
-/** 面板状态：首屏 loading / 错误横幅 / 列表 + 加载更多 / 删除确认框（web 确认框替代原生 confirm）。 */
-export function FileManageDock({ wide, listFiles, deleteFile, countFiles, t }) {
-    const [open, setOpen] = useState(false);
-    const [rows, setRows] = useState([]);
-    const [hasMore, setHasMore] = useState(false);
-    const [lastId, setLastId] = useState(undefined);
-    const [loading, setLoading] = useState(false);
-    const [loadingMore, setLoadingMore] = useState(false);
-    const [error, setError] = useState(null);
-    const [confirming, setConfirming] = useState(null);
-    const [busyDelete, setBusyDelete] = useState(false);
-    const [copied, setCopied] = useState(null);
-    const [summary, setSummary] = useState(null);
-    /** 总数统计请求尚未落定：与 loading 一起构成首屏 ready 门（2026-09-01 整页 loading）。 */
-    const [summaryPending, setSummaryPending] = useState(false);
-    const closeButtonRef = useRef(null);
-    /** 刷新代际：快速关/开面板产生并发请求时，只让最新一次的结果落地（陈旧响应竞态，archive 同款）。 */
-    const refreshSeqRef = useRef(0);
-    /** 「已复制」反馈 2s 复位（archive 同款）。 */
-    const copiedTimerRef = useRef(null);
-    /** 首屏 / 重试共用：列表与总数统计并发拉取，两者都落定才揭开内容（整页 loading 防闪动，2026-09-01）。 */
-    const reload = useCallback(() => {
-        const seq = ++refreshSeqRef.current;
-        setLoading(true);
-        setSummaryPending(true);
-        setSummary(null);
-        setError(null);
-        listFiles()
-            .then(page => {
-            if (seq !== refreshSeqRef.current)
-                return;
-            setRows(page.rows);
-            setHasMore(page.hasMore);
-            setLastId(page.lastId);
-        })
-            .catch(reason => {
-            if (seq !== refreshSeqRef.current)
-                return;
-            setError(reason instanceof Error ? reason.message : String(reason));
-        })
-            .finally(() => {
-            if (seq === refreshSeqRef.current)
-                setLoading(false);
-        });
-        // 总数统计为 best-effort：接口失败只隐藏统计行，不影响列表；同样受刷新代际约束。
-        void countFiles()
-            .then(next => {
-            if (seq === refreshSeqRef.current)
-                setSummary(next);
-        })
-            .catch(() => { })
-            .finally(() => {
-            if (seq === refreshSeqRef.current)
-                setSummaryPending(false);
-        });
-    }, [listFiles, countFiles]);
-    // 官方弹窗行为：打开时聚焦关闭按钮，Esc 关闭。
-    useEffect(() => {
-        if (!open)
-            return;
-        closeButtonRef.current?.focus();
-        const onKeyDown = (event) => {
-            if (event.key === 'Escape')
-                setOpen(false);
-        };
-        document.addEventListener('keydown', onKeyDown);
-        return () => { document.removeEventListener('keydown', onKeyDown); };
-    }, [open]);
-    useEffect(() => {
-        if (!open)
-            return;
-        setConfirming(null);
-        setSummary(null);
-        setRows([]);
-        setHasMore(false);
-        setLastId(undefined);
-        reload();
-    }, [open, reload]);
-    useEffect(() => () => {
-        if (copiedTimerRef.current !== null)
-            window.clearTimeout(copiedTimerRef.current);
-    }, []);
-    const loadMore = useCallback(() => {
-        if (lastId === undefined || loadingMore)
-            return;
-        setLoadingMore(true);
-        listFiles(lastId)
-            .then(page => {
-            setRows(current => [...current, ...page.rows]);
-            setHasMore(page.hasMore);
-            setLastId(page.lastId);
-        })
-            .catch(reason => { setError(reason instanceof Error ? reason.message : String(reason)); })
-            .finally(() => { setLoadingMore(false); });
-    }, [lastId, loadingMore, listFiles]);
-    const copyId = useCallback(async (row) => {
-        try {
-            await navigator.clipboard.writeText(row.id);
-            setCopied(row.id);
-            if (copiedTimerRef.current !== null)
-                window.clearTimeout(copiedTimerRef.current);
-            copiedTimerRef.current = window.setTimeout(() => { setCopied(null); }, 2_000);
-        }
-        catch {
-            setCopied(null);
-            setError(t('copyFailed'));
-        }
-    }, [t]);
-    /** 首屏 ready 门：列表 + 总数都落定前展示整页 loading（2026-09-01）。 */
-    const initialLoading = loading || summaryPending;
-    const quotaRatio = summary === null ? 0 : storageUsageRatio(summary.totalBytes, summary.quotaBytes);
-    const submitDelete = useCallback(() => {
-        if (confirming === null || busyDelete)
-            return;
-        setBusyDelete(true);
-        deleteFile(confirming.id)
-            .then(() => {
-            setRows(current => current.filter(row => row.id !== confirming.id));
-            setConfirming(null);
-            // 删除后刷新总数（best-effort）。
-            void countFiles().then(setSummary).catch(() => { });
-        })
-            .catch(reason => {
-            setError(reason instanceof Error ? reason.message : String(reason));
-            setConfirming(null);
-        })
-            .finally(() => { setBusyDelete(false); });
-    }, [busyDelete, confirming, deleteFile, countFiles]);
-    return (_jsxs(_Fragment, { children: [_jsxs("button", { type: "button", className: wide ? 'dsh-file-manage-trigger' : 'dsh-file-manage-trigger dsh-file-manage-trigger-rail', title: t('dialog.title'), "aria-haspopup": "dialog", "aria-expanded": open, onClick: () => { setOpen(value => !value); }, children: [_jsx(IconFolderOpenOutline16, { className: "dsh-file-manage-trigger-icon", size: wide ? 16 : 18 }), wide ? _jsx("span", { className: "dsh-file-manage-trigger-label", children: t('button.label') }) : null] }), open ? (_jsx("div", { style: styles.overlay, role: "presentation", onMouseDown: (event) => {
-                    if (event.target === event.currentTarget)
-                        setOpen(false);
-                }, children: _jsxs("div", { style: styles.panel, role: "dialog", "aria-modal": "true", "aria-label": t('dialog.title'), children: [_jsxs("div", { className: "dsh-file-manage-panel-header", children: [_jsx("h2", { className: "dsh-file-manage-panel-title", style: { margin: 0 }, children: t('dialog.title') }), _jsx("button", { ref: closeButtonRef, type: "button", className: "dsh-file-manage-close", "aria-label": t('dialog.close'), onClick: () => { setOpen(false); }, children: _jsx(IconCloseOutline16, { size: 14 }) })] }), summary !== null ? (_jsxs("div", { className: "dsh-file-manage-summary", children: [_jsxs("div", { className: "dsh-file-manage-quota-track", children: [_jsx("span", { className: "dsh-file-manage-quota-text", children: `${summary.totalBytesLabel} / ${summary.quotaBytesLabel} · ${t('quota.used', { percent: formatUsagePercent(quotaRatio) })}` }), quotaRatio > 0
-                                            ? _jsx("div", { className: "dsh-file-manage-quota-fill", style: { width: `${Math.round(quotaRatio * 100)}%` } })
-                                            : null] }), _jsx("p", { className: "dsh-file-manage-count", children: rows.length < summary.count
-                                        ? t('summary.loaded', { loaded: rows.length, count: summary.count })
-                                        : t('summary.count', { count: summary.count }) })] })) : null, _jsx("div", { style: { ...styles.body, padding: summary !== null ? '0 24px 24px' : '12px 24px 24px' }, className: "dsh-file-manage-body", children: initialLoading ? (_jsxs("div", { className: "dsh-file-manage-loading", role: "status", children: [_jsx("span", { className: "dsh-file-manage-spinner", "aria-hidden": true }), _jsx("span", { children: t('loading') })] })) : (_jsxs(_Fragment, { children: [error !== null ? (_jsxs("p", { role: "alert", style: { ...styles.secondarySmall, margin: '0 0 12px', color: 'var(--dsw-alias-state-error-primary, #c62828)' }, children: [error, ' ', _jsx("button", { type: "button", className: "dsh-file-manage-btn", onClick: () => { reload(); }, children: t('retry') })] })) : null, error === null && rows.length === 0 ? _jsx("p", { style: styles.secondarySmall, children: t('empty') }) : null, rows.length > 0 ? (_jsx("div", { className: "dsh-file-manage-card", children: rows.map(row => (_jsxs("div", { style: styles.row, children: [_jsxs("div", { style: { minWidth: 0 }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 6, minWidth: 0 }, children: [_jsx("span", { style: styles.title, title: row.filename, children: row.filename }), row.dshOwned ? _jsx("span", { className: "dsh-file-manage-badge", children: t('dshBadge') }) : null] }), _jsxs("div", { style: styles.secondarySmall, children: [row.sizeLabel, " \u00B7 ", row.createdAtLabel, row.expiresAtLabel !== undefined ? ` · ${t('expires', { time: row.expiresAtLabel })}` : ''] })] }), _jsxs("div", { style: styles.actions, children: [_jsx("button", { type: "button", className: "dsh-file-manage-btn", onClick: () => { void copyId(row); }, children: copied === row.id ? t('copied') : t('copy') }), _jsx("button", { type: "button", className: "dsh-file-manage-btn dsh-file-manage-btn-danger", onClick: () => { setConfirming(row); }, children: t('delete') })] })] }, row.id))) })) : null] })) }), hasMore && !initialLoading ? (_jsx("div", { style: styles.footerBar, children: _jsx("button", { type: "button", className: "dsh-file-manage-btn", disabled: loadingMore, onClick: () => { void loadMore(); }, children: loadingMore ? t('loading') : t('loadMore') }) })) : null] }) })) : null, confirming !== null ? (_jsx("div", { className: "dsh-file-manage-confirm-overlay", role: "presentation", onMouseDown: (event) => {
-                    if (event.target === event.currentTarget && !busyDelete)
-                        setConfirming(null);
-                }, children: _jsxs("div", { className: "dsh-file-manage-confirm-card", role: "alertdialog", "aria-modal": "true", "aria-label": t('delete'), onKeyDown: (event) => {
-                        if (event.key === 'Escape' && !busyDelete) {
-                            event.stopPropagation();
-                            setConfirming(null);
-                        }
-                    }, children: [_jsx("h3", { className: "dsh-file-manage-confirm-title", children: t('delete') }), _jsx("p", { className: "dsh-file-manage-confirm-desc", children: confirming.dshOwned
-                                ? t('confirm.deleteDsh', { name: confirming.filename })
-                                : t('confirm.delete', { name: confirming.filename }) }), _jsxs("div", { className: "dsh-file-manage-confirm-actions", children: [_jsx("button", { type: "button", className: "dsh-file-manage-btn", disabled: busyDelete, onClick: () => { setConfirming(null); }, children: t('confirm.cancel') }), _jsx("button", { type: "button", className: "dsh-file-manage-btn dsh-file-manage-btn-danger", disabled: busyDelete, onClick: () => { void submitDelete(); }, children: busyDelete ? t('confirm.deleting') : t('confirm.confirm') })] })] }) })) : null] }));
-}
-//# sourceMappingURL=FileManageDock.js.map

package/lib/client/api.js

@@ -1,50 +0,0 @@
-/** dsh-file-manage 客户端请求封装：host 路由的 fetch 层（超时 + 错误提取）。 @module dsh-file-manage/client/api */
-/** 面板请求超时：host 挂起时不让面板永久 loading（根 AGENTS 网络约定）。 */
-const REQUEST_TIMEOUT_MS = 15_000;
-/** 总数统计超时：host 侧要游标翻到底（配额内最多 10 页），放宽到 60s。 */
-const COUNT_TIMEOUT_MS = 60_000;
-export async function listApi(after) {
-    // limit 不传：host 归一化缺省回退 PAGE_SIZE（页大小只活在一处，避免两端漂移）。
-    const params = new URLSearchParams();
-    if (after !== undefined)
-        params.set('after', after);
-    const response = await fetch(`/api/file-manage/list?${params.toString()}`, {
-        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-    });
-    const payload = await response.json();
-    if (!response.ok) {
-        throw new Error(payload.error?.message ?? `请求失败（HTTP ${response.status}）`);
-    }
-    return {
-        rows: payload.items ?? [],
-        hasMore: payload.hasMore ?? false,
-        ...payload.lastId === undefined ? {} : { lastId: payload.lastId },
-    };
-}
-export async function countApi() {
-    const response = await fetch('/api/file-manage/count', { signal: AbortSignal.timeout(COUNT_TIMEOUT_MS) });
-    const payload = await response.json();
-    if (!response.ok) {
-        throw new Error(payload.error?.message ?? `请求失败（HTTP ${response.status}）`);
-    }
-    return {
-        count: payload.count ?? 0,
-        totalBytes: payload.totalBytes ?? 0,
-        totalBytesLabel: payload.totalBytesLabel ?? '0 B',
-        quotaBytes: payload.quotaBytes ?? 0,
-        quotaBytesLabel: payload.quotaBytesLabel ?? '0 B',
-        quotaCount: payload.quotaCount ?? 0,
-    };
-}
-export async function deleteApi(id) {
-    const params = new URLSearchParams({ id });
-    const response = await fetch(`/api/file-manage/files?${params.toString()}`, {
-        method: 'DELETE',
-        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-    });
-    const payload = await response.json();
-    if (!response.ok) {
-        throw new Error(payload.error?.message ?? `请求失败（HTTP ${response.status}）`);
-    }
-}
-//# sourceMappingURL=api.js.map

package/lib/client/index.js

@@ -1,81 +0,0 @@
-/**
- * dsh-file-manage client half：sidebar footer 入口 + 云端文件弹窗。
- * 请求封装见 api.ts、样式见 styles.ts、视图见 FileManageDock.tsx；客户端不直接碰任何文件或凭据。
- */
-import { countApi, deleteApi, listApi } from './api.js';
-import { FileManageDock } from './FileManageDock.js';
-import { ensureFileManageStyles } from './styles.js';
-export const inject = ['slots', 'locale'];
-/** 本插件的 locale 字典（zh/en）。 */
-const LOCALE_DICTS = {
-    zh: {
-        'button.label': '云端文件',
-        'dialog.title': '云端文件（DeepSeek Files API）',
-        'dialog.close': '关闭',
-        'loading': '加载中…',
-        'loadMore': '加载更多',
-        'summary.count': '共 {count} 个文件',
-        'summary.loaded': '已加载 {loaded} / 共 {count} 个文件',
-        'quota.used': '已用 {percent}',
-        'empty': '暂无云端文件',
-        'dshBadge': 'DSH 自动上传',
-        'expires': '到期 {time}',
-        'copy': '复制 file_id',
-        'copied': '已复制',
-        'copyFailed': '复制失败（浏览器可能未授权剪贴板）',
-        'delete': '删除',
-        'retry': '重试',
-        'confirm.confirm': '确认删除',
-        'confirm.cancel': '取消',
-        'confirm.deleting': '正在删除…',
-        'confirm.delete': '删除「{name}」？\n\n删除后，引用它的会话再次使用时官方会自动重新上传（可能稍慢）。',
-        'confirm.deleteDsh': '此文件由 DSH 自动上传，可能仍被会话引用。\n\n删除「{name}」？删除后再次引用时官方会自动重新上传。',
-    },
-    en: {
-        'button.label': 'Cloud Files',
-        'dialog.title': 'Cloud Files (DeepSeek Files API)',
-        'dialog.close': 'Close',
-        'loading': 'Loading…',
-        'loadMore': 'Load more',
-        'summary.count': '{count} files',
-        'summary.loaded': '{loaded} / {count} files',
-        'quota.used': '{percent} used',
-        'empty': 'No cloud files',
-        'dshBadge': 'DSH auto-uploaded',
-        'expires': 'expires {time}',
-        'copy': 'Copy file_id',
-        'copied': 'Copied',
-        'copyFailed': 'Copy failed (clipboard may be blocked by the browser)',
-        'delete': 'Delete',
-        'retry': 'Retry',
-        'confirm.confirm': 'Delete',
-        'confirm.cancel': 'Cancel',
-        'confirm.deleting': 'Deleting…',
-        'confirm.delete': 'Delete "{name}"?\n\nSessions that reference it will transparently re-upload on next use (may be slower).',
-        'confirm.deleteDsh': 'This file was auto-uploaded by DSH and may still be referenced by sessions.\n\nDelete "{name}"? It will transparently re-upload on next use.',
-    },
-};
-/**
- * client half 入口：注册 locale 字典 + sidebar footer action。
- * @param ctx - 浏览器侧 Cordis 上下文。
- */
-export function apply(ctx) {
-    ensureFileManageStyles();
-    const disposeDictionaries = ctx.locale.register('file-manage', { zh: LOCALE_DICTS.zh, en: LOCALE_DICTS.en });
-    ctx.effect(() => disposeDictionaries, 'dsh-file-manage: locale dictionaries');
-    ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register({
-        name: 'sidebar.footer.action',
-        locale: 'file-manage',
-        id: 'file-manage',
-        order: 21,
-        inject: () => ({
-            listFiles: listApi,
-            deleteFile: deleteApi,
-            countFiles: countApi,
-        }),
-    }, FileManageDock));
-}
-export { FileManageDock } from './FileManageDock.js';
-export { ensureFileManageStyles } from './styles.js';
-export { countApi, deleteApi, listApi } from './api.js';
-//# sourceMappingURL=index.js.map

package/lib/client/quota.js

@@ -1,23 +0,0 @@
-/** dsh-file-manage 客户端纯逻辑：配额进度条计算（不 import Node 模块）。 @module dsh-file-manage/client/quota */
-/** 存储用量比例：钳到 [0, 1]；used/quota 非正时返回 0（不除零）。 */
-export function storageUsageRatio(usedBytes, quotaBytes) {
-    if (!Number.isFinite(usedBytes) || usedBytes <= 0)
-        return 0;
-    if (!Number.isFinite(quotaBytes) || quotaBytes <= 0)
-        return 0;
-    return Math.min(1, Math.max(0, usedBytes / quotaBytes));
-}
-/** 用量百分比文案（网盘风格自适应精度）：≥10% 取整、≥1% 一位、≥0.1% 两位、≥0.01% 三位、更小四位——25GiB 配额下常见 0.01% 量级，避免人人 0.0%。 */
-export function formatUsagePercent(ratio) {
-    const percent = Math.min(1, Math.max(0, ratio)) * 100;
-    if (percent >= 10)
-        return `${Math.round(percent)}%`;
-    if (percent >= 1)
-        return `${percent.toFixed(1)}%`;
-    if (percent >= 0.1)
-        return `${percent.toFixed(2)}%`;
-    if (percent >= 0.01)
-        return `${percent.toFixed(3)}%`;
-    return `${percent.toFixed(4)}%`;
-}
-//# sourceMappingURL=quota.js.map

package/lib/client/styles.js

@@ -1,326 +0,0 @@
-/** dsh-file-manage 客户端样式层：注入样式表 + 面板内联样式（官方设计 token；按 data 属性去重）。 @module dsh-file-manage/client/styles */
-/** 注入触发键 / 面板 / 确认框样式；HMR / 重载按 data 属性去重不叠加。 */
-export function ensureFileManageStyles() {
-    if (document.querySelector('style[data-dsh-file-manage]') !== null)
-        return;
-    const style = document.createElement('style');
-    style.dataset.dshFileManage = '';
-    style.textContent = `/* 官方 .footerActions 是横向 flex 行，slot 包裹层为行内 display:contents：
- * 多插件各自的全宽按钮会并排挤到右缘外（只剩一条边）。这里把包裹层改回真实盒子纵排，
- * Archive / 云端文件两个按钮上下堆叠、各自占满一行（!important 压过行内 contents）。 */
-[data-slot='sidebar.footer.action'] {
-  display: flex !important;
-  flex-direction: column;
-  /* 包裹层是 .footerActions 行容器里的 flex item，需显式撑满，否则两个全宽按钮按内容宽度收缩。 */
-  width: 100%;
-}
-.dsh-file-manage-trigger {
-  flex: none;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  width: calc(100% + 4px);
-  height: 42px;
-  margin: 4px -2px;
-  padding: 0 10px 0 8px;
-  box-sizing: border-box;
-  border: none;
-  border-radius: 12px;
-  background: transparent;
-  cursor: pointer;
-  overflow: hidden;
-  color: var(--dsw-alias-label-primary);
-  font-family: inherit;
-  font-size: 14px;
-  line-height: 22px;
-}
-.dsh-file-manage-trigger:hover {
-  background: var(--dsw-alias-interactive-bg-hover);
-}
-.dsh-file-manage-trigger-rail {
-  width: 36px;
-  height: 36px;
-  margin: 8px 0 10px;
-  justify-content: center;
-  gap: 0;
-  padding: 0;
-  border-radius: 50%;
-  corner-shape: round;
-}
-.dsh-file-manage-trigger-icon {
-  flex: none;
-}
-.dsh-file-manage-trigger-label {
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-/* 整页 loading：首屏数据（列表 + 总数）落定前占满内容区，避免「打开后加载闪动」（2026-09-01）。 */
-.dsh-file-manage-loading {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  gap: 10px;
-  min-height: 240px;
-  color: var(--dsw-alias-label-secondary, #6b7280);
-  font-size: 14px;
-  line-height: 22px;
-}
-.dsh-file-manage-spinner {
-  width: 16px;
-  height: 16px;
-  border: 2px solid var(--dsw-alias-border-l1, #d4d8e0);
-  border-top-color: var(--dsw-alias-button-info-fill, #4d6bfe);
-  border-radius: 50%;
-  corner-shape: round;
-  animation: dsh-file-manage-spin 0.8s linear infinite;
-}
-@keyframes dsh-file-manage-spin {
-  to { transform: rotate(360deg); }
-}
-@media (prefers-reduced-motion: reduce) {
-  .dsh-file-manage-spinner { animation: none; }
-}
-/* 面板滚动区：官方 settings 同款——elevated surface 重绑 l2 滚动条 token（base 默认 l1，浮层上对比度不对）。 */
-.dsh-file-manage-body {
-  --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2);
-  --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2);
-}
-/* 面板头：官方 settings 面板同款（54px 高、标题起点 24px）。 */
-.dsh-file-manage-panel-header {
-  flex: none;
-  display: flex;
-  align-items: flex-start;
-  justify-content: space-between;
-  gap: 8px;
-  height: 54px;
-  padding: 20px 14px 8px 24px;
-  box-sizing: border-box;
-}
-.dsh-file-manage-panel-title {
-  font-size: 16px;
-  font-weight: 500;
-  line-height: 24px;
-  color: var(--dsw-alias-label-primary);
-}
-.dsh-file-manage-close {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 28px;
-  height: 28px;
-  padding: 0;
-  border: none;
-  border-radius: 8px;
-  outline: none;
-  background: transparent;
-  cursor: pointer;
-  color: var(--dsw-alias-label-primary);
-}
-.dsh-file-manage-close:hover {
-  background: var(--dsw-alias-interactive-bg-hover);
-}
-.dsh-file-manage-badge {
-  flex: none;
-  padding: 1px 6px;
-  border: 1px solid var(--dsw-alias-border-l2, #e2e5ea);
-  border-radius: 999px;
-  corner-shape: round;
-  color: var(--dsw-alias-label-caption, #8a919f);
-  font-size: 11px;
-  line-height: 16px;
-}
-.dsh-file-manage-btn {
-  /* 官方 Button.sm 同款几何：h28 + r14 胶囊（超椭圆角随官方全局规则自动生效）。 */
-  height: 28px;
-  padding: 0 10px;
-  border: 0.5px solid var(--dsw-alias-border-l3, #d4d8e0);
-  border-radius: 14px;
-  outline: none;
-  background: transparent;
-  color: var(--dsw-alias-label-primary, #1f2329);
-  font-size: 12px;
-  line-height: 18px;
-  white-space: nowrap;
-  cursor: pointer;
-}
-.dsh-file-manage-btn:hover:not(:disabled) {
-  background: var(--dsw-alias-interactive-bg-hover);
-}
-.dsh-file-manage-btn:disabled {
-  opacity: 0.5;
-  cursor: default;
-}
-.dsh-file-manage-btn-danger {
-  color: var(--dsw-alias-state-error-primary, #c62828);
-}
-/* 删除确认框：官方 web 确认框同款（mask + 毛玻璃 + 480 卡片）。 */
-.dsh-file-manage-confirm-overlay {
-  position: fixed;
-  inset: 0;
-  z-index: 1100;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background: var(--dsw-alias-bg-mask-1, rgba(0, 0, 0, 0.28));
-  backdrop-filter: var(--dsw-mask-blur);
-}
-.dsh-file-manage-confirm-card {
-  display: flex;
-  flex-direction: column;
-  gap: 12px;
-  width: min(480px, calc(100vw - 48px));
-  padding: 20px;
-  border-radius: 16px;
-  background: var(--dsw-alias-bg-layer-2, #f6f7f9);
-  color: var(--dsw-alias-label-primary, #1f2329);
-  box-shadow: var(--dsw-elevation-prominent, 0 12px 40px rgba(0,0,0,0.22));
-}
-.dsh-file-manage-confirm-title {
-  margin: 0;
-  font-size: 16px;
-  font-weight: 500;
-  line-height: 24px;
-}
-.dsh-file-manage-confirm-desc {
-  margin: 0;
-  font-size: 14px;
-  line-height: 22px;
-  color: var(--dsw-alias-label-secondary, #6b7280);
-  white-space: pre-line;
-}
-.dsh-file-manage-confirm-actions {
-  display: flex;
-  justify-content: flex-end;
-  gap: 8px;
-}
-/* 用量/进度条固定区：面板头下方、不随列表滚动；左侧 24px 与区块卡线框齐平，
-   右侧额外让出滚动条宽度（列表区 scrollbar-gutter: stable 固定占位 8px）。 */
-.dsh-file-manage-summary {
-  flex: none;
-  padding: 12px calc(24px + var(--dsh-scrollbar-width, 8px)) 8px 24px;
-}
-.dsh-file-manage-count {
-  margin: 6px 0 0;
-  font-size: 12px;
-  line-height: 18px;
-  color: var(--dsw-alias-label-secondary, #6b7280);
-}
-/* 列表区块卡：存档页归档区/备份区同款 token（border-l2 + r12）。 */
-.dsh-file-manage-card {
-  box-sizing: border-box;
-  display: flex;
-  flex-direction: column;
-  margin: 0 0 12px;
-  padding: 8px 12px 12px;
-  border: 0.5px solid var(--dsw-alias-border-l4, #e2e5ea);
-  border-radius: 16px;
-}
-/* 配额容量条：加厚 + 未使用区斜纹（repeating-linear-gradient），与分割线区分；填充盖住斜纹。
-   容量文字绝对定位居中叠加在条上。 */
-.dsh-file-manage-quota-track {
-  position: relative;
-  height: 16px;
-  border-radius: 8px;
-  background-color: var(--dsw-alias-interactive-bg-hover);
-  background-image: repeating-linear-gradient(
-    45deg,
-    transparent 0px,
-    transparent 5px,
-    var(--dsw-alias-border-l1, #d4d8e0) 5px,
-    var(--dsw-alias-border-l1, #d4d8e0) 7px
-  );
-  overflow: hidden;
-}
-.dsh-file-manage-quota-text {
-  position: absolute;
-  inset: 0;
-  z-index: 1;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: 11px;
-  line-height: 16px;
-  white-space: nowrap;
-  color: var(--dsw-alias-label-primary, #1f2329);
-  /* 高用量时蓝填充垫底，加一圈底色光晕保证可读。 */
-  text-shadow: 0 0 4px var(--dsw-alias-bg-layer-2, #f6f7f9);
-  pointer-events: none;
-}
-.dsh-file-manage-quota-fill {
-  height: 100%;
-  /* 用量极小时（0.01% 量级）宽度趋近 0，兜底 4px 银条让「有使用」可见（网盘同款）。
-     不加自身圆角：最小宽度下圆角会长成圆点、视觉鼓出轨道左端，改由轨道 overflow:hidden + 圆角裁切两端。 */
-  min-width: 4px;
-  background: var(--dsw-alias-state-business-primary);
-  transition: width 220ms ease-out;
-}
-`;
-    document.head.appendChild(style);
-}
-/** 面板与行内联样式（对齐官方 Settings / Archive 的面板几何）。 */
-export const styles = {
-    overlay: {
-        position: 'fixed',
-        inset: 0,
-        zIndex: 1000,
-        display: 'flex',
-        alignItems: 'center',
-        justifyContent: 'center',
-        background: 'var(--dsw-alias-bg-mask-1, rgba(0, 0, 0, 0.28))',
-        backdropFilter: 'var(--dsw-mask-blur)',
-    },
-    panel: {
-        position: 'relative',
-        display: 'flex',
-        flexDirection: 'column',
-        width: 'min(800px, calc(100vw - 48px))',
-        // 高度随内容自适应、上限钳到视口（官方 settings 同款上限）。
-        maxHeight: 'min(800px, calc(100vh - 48px))',
-        borderRadius: 24,
-        overflow: 'hidden',
-        padding: 0,
-        background: 'var(--dsw-alias-bg-layer-2, #f6f7f9)',
-        color: 'var(--dsw-alias-label-primary, #1f2329)',
-        boxShadow: 'var(--dsw-elevation-prominent, 0 12px 40px rgba(0,0,0,0.22))',
-    },
-    body: {
-        flex: 1,
-        minHeight: 0,
-        overflow: 'auto',
-        // 滚动条固定占位：卡片右缘不因滚动条出现/消失而左右漂移（与顶部进度条对齐）。
-        scrollbarGutter: 'stable',
-        padding: '0 24px 24px',
-    },
-    row: {
-        display: 'flex',
-        justifyContent: 'space-between',
-        gap: 8,
-        alignItems: 'center',
-        padding: '8px 0',
-        borderBottom: '1px solid var(--dsw-alias-border-l1, #e2e5ea)',
-    },
-    actions: {
-        display: 'flex',
-        gap: 6,
-        alignItems: 'center',
-    },
-    title: {
-        overflow: 'hidden',
-        textOverflow: 'ellipsis',
-        whiteSpace: 'nowrap',
-    },
-    secondarySmall: {
-        color: 'var(--dsw-alias-label-secondary, #6b7280)',
-        fontSize: 12,
-        lineHeight: '18px',
-    },
-    footerBar: {
-        flex: 'none',
-        display: 'flex',
-        justifyContent: 'center',
-        // 列表已包区块卡，不再加顶部分隔线（避免与卡片叠加显乱）。
-        padding: '10px 24px 14px',
-    },
-};
-//# sourceMappingURL=styles.js.map