@dsh-sparrow/dsh-file-manage 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+English | [简体中文](CHANGELOG.zh-CN.md)
+
+## 0.1.0-alpha.1 (2026-09-01 · pre-release)
+
+- First pre-release, published to the `next` channel for validation; features match the planned `0.1.0` first release
+- Sidebar "Cloud Files" entry + panel (styled like the official Settings / Archive): list pages of 20, Load more cursor pagination, per-file delete (stronger notice for `dsh-` auto-uploaded files), one-click copy file_id
+- Total count + drive-style quota bar: used / 25 GiB, adaptive-precision percentage, striped empty area, "Loaded X / N" synced with pagination
+- Reuses the official DeepSeekFilesClient (connection facts from the llm-deepseek settings section + ctx.credentials); no local persistence

package/CHANGELOG.zh-CN.md

@@ -0,0 +1,10 @@
+# 更新日志
+
+简体中文 | [English](CHANGELOG.md)
+
+## 0.1.0-alpha.1 (2026-09-01 · pre-release)
+
+- 首个预发布版本，先发 `next` 渠道验证；功能对齐计划中的 `0.1.0` 首版
+- 侧边栏「云端文件」入口 + 面板（样式对齐官方设置 / 归档面板）：每页 20 条列表、Load more 游标翻页、单条删除（`dsh-` 自动上传文件给更强提示）、一键复制 file_id
+- 总数 + 网盘式配额条：已用 / 25 GiB、自适应精度百分比、条纹空白区、「已加载 X / N」随翻页同步
+- 复用官方 DeepSeekFilesClient（连接事实取自 llm-deepseek 设置节 + ctx.credentials）；无本地持久化

package/README.md

@@ -0,0 +1,42 @@
+# dsh-file-manage
+
+English | [简体中文](README.zh-CN.md) | [GitHub](https://github.com/peiyucn/dsh-sparrow)
+
+DeepSeek Files API cloud file management — a DeepSeek Harness (DSH) web plugin (dsh-sparrow collection member).
+
+Large images pasted into DSH are auto-uploaded to the DeepSeek Files API, but there is no official management UI. This plugin adds a "Cloud Files" entry to the sidebar and lists every cloud file under your API key: cursor pagination, upload/expiry times, sizes, single-file deletion, and one-click file_id copy. It reuses the official `DeepSeekFilesClient` — no extra credentials.
+
+## Install
+
+```bash
+dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
+```
+
+Requires dsh ≥ 0.1.2-alpha.3 (verified baseline; earlier versions unverified) 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)
+* **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
+* **Errors**: classified messages for auth failures / rate limits / server errors, with retry
+
+## Limitations
+
+* The official Files API has **no batch-delete endpoint** — no "delete all", only per-file deletion
+* The official API has **no download endpoint** — content cannot be previewed or downloaded
+* Quota: at most 10000 files / 25 GiB per key (official limits)
+* **Where files come from**: DSH auto-uploads to the Files API only on the **DeepSeek model path** (the upload lives in the llm-deepseek adapter layer); with other models the list mostly shows files you or external tools uploaded
+* **Expiry**: DSH auto-uploads files with a default **7-day** expiry (the official API has no permanent option); expired files are transparently re-uploaded on next use — tune `fileExpiresAfterSeconds` (1h–30d) in the `llm-deepseek` settings section
+
+## Screenshot
+
+![Cloud Files panel](docs/images/panel.png)
+
+## Uninstall & leftovers
+
+* The plugin keeps no local state; uninstalling leaves the cloud files untouched and DSH behavior unchanged

package/README.zh-CN.md

@@ -0,0 +1,42 @@
+# dsh-file-manage
+
+简体中文 | [English](README.md) | [GitHub](https://github.com/peiyucn/dsh-sparrow)
+
+DeepSeek Files API 云端文件管理 —— DeepSeek Harness（DSH）Web 插件（dsh-sparrow 合集成员）。
+
+DSH 贴图的大图会自动上传到 DeepSeek Files API（云端文件库），但官方没有管理界面。本插件在侧边栏加一个「云端文件」入口，列出你 API key 下的全部云端文件：游标翻页、上传 / 到期时间、大小，支持删除单条与一键复制 file_id。完全复用官方 `DeepSeekFilesClient`，不新增任何凭据。
+
+## 安装
+
+```bash
+dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
+```
+
+适配 dsh ≥ 0.1.2-alpha.3（本机验证基线；更早版本未验证），并需要可用的 `pnpm`（`dsh plugin` 会把安装操作转发给 pnpm）。
+
+> **不要**直接执行 `npm install @dsh-sparrow/dsh-file-manage`：那只会把包下载到某个 `node_modules`，不会注册进 DSH 的 web profile。请使用上面的 `dsh plugin` 命令安装，并在安装后重启 DSH。
+
+## 使用
+
+* **入口**：侧边栏底部「云端文件」按钮
+* **列表**：每页 20 条，底部「加载更多」翻页（官方 after 游标，最新在前）；行内展示文件名 / 大小 / 上传时间 / 到期时间（有则显）
+* **配额**：列表顶部显示总数与网盘式配额进度条（已用存储 / 25 GiB 官方上限）
+* **删除**：行内删除按钮二次确认；「DSH 自动上传」角标（`dsh-` 前缀）的文件有额外提示——删除后旧会话再次引用时官方会自动重新上传（可能稍慢）
+* **复制 file_id**：行内按钮一键复制
+* **错误提示**：鉴权失败 / 限流 / 服务端错误分类展示，可重试
+
+## 限制
+
+* 官方 Files API **没有批量删除端点**——不做「全部清理」，只能逐条删
+* 官方**没有下载端点**——不能预览 / 下载文件内容
+* 配额：单 key 最多 10000 个文件 / 25 GiB（官方限制）
+* **文件来源**：云端文件只在 **DeepSeek 系列模型**路径下由 DSH 自动上传（上传发生在 llm-deepseek 适配器层）；使用其它模型时列表主要为你手动 / 外部工具上传的文件
+* **有效期**：DSH 自动上传的文件默认 **7 天**有效期（官方无「永久」选项）；到期后再次引用会自动重新上传，可在 `llm-deepseek` 设置节的 `fileExpiresAfterSeconds`（1 小时–30 天）调整
+
+## 截图
+
+![云端文件面板](docs/images/panel.png)
+
+## 卸载与残留
+
+* 插件无任何本地持久化状态；卸载后云端文件原样保留，DSH 行为不受影响

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-file-manage 组合补丁：`dsh plugin --profile web add @dsh-sparrow/dsh-file-manage` 安装后由 profile 自动挂载。
+# 复用官方 DeepSeekFilesClient，无配置项；凭据只经 ctx.credentials 解析。
+- insert:
+    - id: dsh-file-manage
+      name: '@dsh-sparrow/dsh-file-manage'

package/lib/client/FileManageDock.js

@@ -0,0 +1,141 @@
+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);
+    const closeButtonRef = useRef(null);
+    /** 刷新代际：快速关/开面板产生并发请求时，只让最新一次的结果落地（陈旧响应竞态，archive 同款）。 */
+    const refreshSeqRef = useRef(0);
+    /** 「已复制」反馈 2s 复位（archive 同款）。 */
+    const copiedTimerRef = useRef(null);
+    const loadFirst = useCallback(() => {
+        const seq = ++refreshSeqRef.current;
+        setLoading(true);
+        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);
+        });
+    }, [listFiles]);
+    // 官方弹窗行为：打开时聚焦关闭按钮，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);
+        loadFirst();
+        // 总数统计为 best-effort：接口失败只隐藏统计行，不影响列表；同样受刷新代际约束。
+        const seq = refreshSeqRef.current;
+        void countFiles()
+            .then(next => {
+            if (seq === refreshSeqRef.current)
+                setSummary(next);
+        })
+            .catch(() => { });
+    }, [open, loadFirst, countFiles]);
+    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]);
+    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, _jsxs("div", { style: { ...styles.body, padding: summary !== null ? '0 24px 24px' : '12px 24px 24px' }, className: "dsh-file-manage-body", 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: loadFirst, children: t('retry') })] })) : null, loading ? _jsx("p", { style: styles.secondarySmall, children: t('loading') }) : null, !loading && 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 && !loading ? (_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

@@ -0,0 +1,50 @@
+/** 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

@@ -0,0 +1,81 @@
+/**
+ * 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

@@ -0,0 +1,23 @@
+/** 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