@dsh-sparrow/dsh-file-manage 0.1.5-rc.2 → 0.2.0-rc.2

package/CHANGELOG.md

@@ -2,41 +2,50 @@
 
 English | [简体中文](CHANGELOG.zh-CN.md)
 
+## 0.2.0-rc.2 (2026-10-08)
+
+- Now adapted to official dsh 0.2.0-rc.2 (web and desktop).
+- The Cloud Files entry moved to the top of the sidebar, beside Plugins and Automations, and now opens as a page in the main area instead of a dialog.
+
+## 0.1.5-rc.2.1 (2026-09-11)
+
+- "Load more" now loads 20 more files per click instead of 100.
+
 ## 0.1.5-rc.2 (2026-09-10)
 
 - Version-line alignment with official dsh 0.1.5-rc.2.
-- The panel's loading indicator now uses dsh's own dot-matrix chase animation, matching the rest of the UI.
-- Escape now closes the delete confirmation first instead of leaving it stranded on screen after the panel closes.
+- The loading indicator now matches the rest of the dsh interface.
+- Escape now closes the delete confirmation first, so it no longer stays on screen after the panel closes.
 
 ## 0.1.2-rc.1.1 (2026-09-09)
 
-- If dsh is upgraded to a version this plugin does not support yet, the plugin now disables itself instead of running against an unknown contract (dsh and other plugins are unaffected).
+- On a dsh version this plugin does not support, it turns itself off and leaves dsh working.
 
 ## 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.
+- Fixed the file list going wrong after quickly reopening the panel or tapping Retry.
+- Requests stop once the panel is closed, so a cancelled file count no longer keeps using your API credit.
+- The sidebar "Cloud Files" button now matches the width of Settings.
+- "Load more" now sits at the end of the file list, and the list scrolls to the bottom after each page loads.
+- A small 🐦 dsh-sparrow brand line closes the panel.
 
 ## 0.1.0 (2026-09-02)
 
-- Promoted 0.1.0 (identical to 0.1.0-alpha.3).
+- First stable release.
 
 ## 0.1.0-alpha.3 (2026-09-02 · pre-release)
 
-- README screenshots now use absolute URLs and are no longer packed into the npm package (functionally identical to the previous release).
+- No user-perceivable change from the previous release.
 
 ## 0.1.0-alpha.2 (2026-09-01 · pre-release)
 
-- Full-page loading: the list renders only once entries and totals are both ready (removes the open flicker).
+- The list now appears only once files and totals are both loaded, so opening no longer flickers.
 
 ## 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
+- First release.
+- Sidebar "Cloud Files" entry with a page that lists your cloud files 20 at a time, and lets you load more, delete a file, and copy its file ID.
+- Shows how much of your 25 GiB storage is used and how many files are loaded so far.
+- Reuses the DeepSeek connection already configured in dsh; nothing is stored locally.
 

package/CHANGELOG.zh-CN.md

@@ -2,41 +2,50 @@
 
 简体中文 | [English](CHANGELOG.md)
 
+## 0.2.0-rc.2（2026-10-08）
+
+- 适配官方 dsh 0.2.0-rc.2（Web 与桌面端）。
+- 「云端文件」入口移到侧边栏顶部（与「插件」「自动化任务」并列），点开后是中央区页面，不再是弹窗。
+
+## 0.1.5-rc.2.1（2026-09-11）
+
+- 「加载更多」每次加载 20 条，不再是 100 条。
+
 ## 0.1.5-rc.2（2026-09-10）
 
 - 版本线对齐官方 dsh 0.1.5-rc.2。
-- 面板的加载指示改用 dsh 官方点阵追逐动画，与界面其它部分一致。
-- Esc 现在先关删除确认框，不再出现「面板关了、确认框孤零零留在屏上」。
+- 加载指示器改为与 dsh 界面其余部分一致。
+- Esc 现在先关删除确认框，不再在面板关闭后留在屏上。
 
 ## 0.1.2-rc.1.1（2026-09-09）
 
-- dsh 升级到本插件尚不支持的版本时，插件会自动停用（dsh 与其它插件不受影响），不再带病运行。
+- 遇到本插件尚不支持的 dsh 版本时，插件自动停用，dsh 仍可正常使用。
 
 ## 0.1.2-rc.1（2026-09-05）
 
-- 版本对齐官方 dsh 0.1.2-rc.1（稳定线）。
-- 翻页与删除的并发修复：快速关开面板或点击重试后，陈旧页不再混入新列表、「加载更多」不再卡死，迟到的删除回调不再误关新弹出的确认框。
-- 请求超时后自行停止不再无限挂起（列表/删除 15s、计数 60s 上限），计数翻页在客户端连接断开（超时/导航）时立即停下，被放弃的计数不再持续消耗 API 配额。
-- 侧边栏「云端文件」按钮与 Settings 同宽对齐（与归档入口一致）。
-- 「加载更多」移到文件列表末尾，每页加载后自动滚到列表底部（按钮不再固定在面板底部）。
+- 版本线对齐官方 dsh 0.1.2-rc.1（稳定线）。
+- 修复快速关开面板或点重试后文件列表出错的问题。
+- 面板关闭后请求即停止，取消掉的文件计数不再继续消耗你的 API 额度。
+- 侧边栏「云端文件」按钮宽度与 Settings 对齐。
+- 「加载更多」移到文件列表末尾，每页加载后列表滚到底部。
 - 面板底部新增 🐦 dsh-sparrow 品牌行。
 
 ## 0.1.0 (2026-09-02)
 
-- 转正 0.1.0（与 0.1.0-alpha.3 一致）。
+- 首个稳定版。
 
 ## 0.1.0-alpha.3 (2026-09-02 · pre-release)
 
-- README 截图改为绝对 URL 引用，图片不再打包进 npm 包（功能与上版一致）。
+- 与上一版相比无用户可感知的变化。
 
 ## 0.1.0-alpha.2 (2026-09-01 · pre-release)
 
-- 面板整页 loading：列表与总数都就绪后再展示（消除打开闪动）。
+- 文件与总数都加载完才显示列表，打开时不再闪动。
 
 ## 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）；无本地持久化
+- 首个版本。
+- 侧边栏「云端文件」入口：每页列出 20 个云端文件，可加载更多、删除文件、复制文件 ID。
+- 显示 25 GiB 空间已用多少，以及当前已加载多少个文件。
+- 复用 dsh 里已配置的 DeepSeek 连接；不在本地保存任何数据。
 

package/README.md

@@ -4,7 +4,7 @@ English | [简体中文](README.zh-CN.md) | [GitHub](https://github.com/peiyucn/
 
 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.
+Large images pasted into DSH are auto-uploaded to the DeepSeek Files API, but DSH has no built-in management UI. This plugin adds a "Cloud Files" entry at the top of the sidebar (beside the Plugins and Automations entries): it opens a page in the main area listing every cloud file under your API key — pagination, upload/expiry times, sizes, single-file deletion, and one-click file_id copy. No extra credentials are needed.
 
 ## Install
 
@@ -12,30 +12,31 @@ 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.5-rc.2 — the exact official version line this release is built and verified against (newer lines, pre-releases in particular, are not covered) — and a working `pnpm` (`dsh plugin` forwards installation to pnpm).
+Requires dsh 0.2.0-rc.2 — the exact official version line this release is built and verified against (newer lines, pre-releases in particular, are not covered) — 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**: 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)
+* **Entry**: the "Cloud Files" icon at the top of the sidebar, opening the page in the main area
+* **Getting back**: The cloud files page is a normal main-area page, not a dialog — it does not dim or block the interface. Return to a conversation the usual way: pick a session in the sidebar, or use New Session
+* **List**: in the order the service returns (this plugin does not re-sort) with "Load more" at the bottom (20 more files per click); each row shows filename / size / upload time / expiry time (when present)
+* **Quota**: the page header shows the total count and a quota bar (used storage / the 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
+* The Files API has **no batch-delete endpoint** — no "delete all", only per-file deletion
+* The Files API has **no download endpoint** — content cannot be previewed or downloaded
+* Quota: at most 10000 files / 25 GiB per key
+* **Where files come from**: DSH auto-uploads to the Files API only on the **DeepSeek model path**; 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 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](https://raw.githubusercontent.com/peiyucn/dsh-sparrow/main/resources/dsh-file-manage.png)
+![Cloud Files page](https://raw.githubusercontent.com/peiyucn/dsh-sparrow/main/resources/dsh-file-manage.png)
 
 ## Uninstall & leftovers
 

package/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 DeepSeek Files API 云端文件管理 —— DeepSeek Harness（DSH）Web 插件（dsh-sparrow 合集成员）。
 
-DSH 贴图的大图会自动上传到 DeepSeek Files API（云端文件库），但官方没有管理界面。本插件在侧边栏加一个「云端文件」入口，列出你 API key 下的全部云端文件：游标翻页、上传 / 到期时间、大小，支持删除单条与一键复制 file_id。完全复用官方 `DeepSeekFilesClient`，不新增任何凭据。
+DSH 贴图的大图会自动上传到 DeepSeek Files API（云端文件库），但 DSH 没有内置的管理界面。本插件在侧边栏上面加「云端文件」入口（与「插件」「自动化任务」并列）：点开在中央区以页面形式列出你 API key 下的全部云端文件：翻页、上传 / 到期时间、大小，支持删除单条与一键复制 file_id。不需要额外凭据。
 
 ## 安装
 
@@ -12,30 +12,31 @@ DSH 贴图的大图会自动上传到 DeepSeek Files API（云端文件库），
 dsh plugin --profile web add @dsh-sparrow/dsh-file-manage
 ```
 
-适配 dsh 0.1.5-rc.2（本版构建与验证所对齐的确切官方版本线；更新的版本线、尤其是预发布版本不在承诺范围内），并需要可用的 `pnpm`（`dsh plugin` 会把安装操作转发给 pnpm）。
+适配 dsh 0.2.0-rc.2（本版构建与验证所对齐的确切官方版本线；更新的版本线、尤其是预发布版本不在承诺范围内），并需要可用的 `pnpm`（`dsh plugin` 会把安装操作转发给 pnpm）。
 
 > **不要**直接执行 `npm install @dsh-sparrow/dsh-file-manage`：那只会把包下载到某个 `node_modules`，不会注册进 DSH 的 web profile。请使用上面的 `dsh plugin` 命令安装，并在安装后重启 DSH。
 
 ## 使用
 
-* **入口**：侧边栏底部「云端文件」按钮
-* **列表**：最新在前，底部「加载更多」每次多显示 100 条（官方 after 游标翻页）；行内展示文件名 / 大小 / 上传时间 / 到期时间（有则显）
-* **配额**：列表顶部显示总数与网盘式配额进度条（已用存储 / 25 GiB 官方上限）
-* **删除**：行内删除按钮二次确认；「DSH 自动上传」角标（`dsh-` 前缀）的文件有额外提示——删除后旧会话再次引用时官方会自动重新上传（可能稍慢）
+* **入口**：侧边栏上面的「云端文件」图标，点开在中央区以页面形式展示
+* **回对话**：云端文件页是中央区的普通页面、不是弹窗——不压暗、不挡界面。回到对话照常：点侧边栏的会话项，或用 New Session
+* **列表**：按服务端返回的顺序展示（本插件不改排），底部「加载更多」每次多显示 20 条；行内展示文件名 / 大小 / 上传时间 / 到期时间（有则显）
+* **配额**：页面顶部显示总数与配额进度条（已用存储 / 25 GiB 上限）
+* **删除**：行内删除按钮二次确认；「DSH 自动上传」角标（`dsh-` 前缀）的文件有额外提示——删除后旧会话再次引用时 DSH 会自动重新上传（可能稍慢）
 * **复制 file_id**：行内按钮一键复制
 * **错误提示**：鉴权失败 / 限流 / 服务端错误分类展示，可重试
 
 ## 限制
 
-* 官方 Files API **没有批量删除端点**——不做「全部清理」，只能逐条删
-* 官方**没有下载端点**——不能预览 / 下载文件内容
-* 配额：单 key 最多 10000 个文件 / 25 GiB（官方限制）
-* **文件来源**：云端文件只在 **DeepSeek 系列模型**路径下由 DSH 自动上传（上传发生在 llm-deepseek 适配器层）；使用其它模型时列表主要为你手动 / 外部工具上传的文件
-* **有效期**：DSH 自动上传的文件默认 **7 天**有效期（官方无「永久」选项）；到期后再次引用会自动重新上传，可在 `llm-deepseek` 设置节的 `fileExpiresAfterSeconds`（1 小时–30 天）调整
+* Files API **没有批量删除端点**——不做「全部清理」，只能逐条删
+* Files API **没有下载端点**——不能预览 / 下载文件内容
+* 配额：单 key 最多 10000 个文件 / 25 GiB
+* **文件来源**：云端文件只在 **DeepSeek 系列模型**路径下由 DSH 自动上传；使用其它模型时列表主要为你手动 / 外部工具上传的文件
+* **有效期**：DSH 自动上传的文件默认 **7 天**有效期（API 没有「永久」选项）；到期后再次引用会自动重新上传，可在 `llm-deepseek` 设置节的 `fileExpiresAfterSeconds`（1 小时–30 天）调整
 
 ## 截图
 
-![云端文件面板](https://raw.githubusercontent.com/peiyucn/dsh-sparrow/main/resources/dsh-file-manage.png)
+![云端文件页面](https://raw.githubusercontent.com/peiyucn/dsh-sparrow/main/resources/dsh-file-manage.png)
 
 ## 卸载与残留