📋 列出全部已上传文件：文件名（DSH 自动命名 dsh-<内容哈希>.<ext>）、file_id、大小、创建时间、过期时间（默认 7 天）
🔁 一键刷新：随时与 DeepSeek 云端同步
📋 复制 file_id：方便在请求或脚本中引用
🗑️ 删除文件：红色按钮 + 二次确认（3.5 秒内再点击才真正删除），防止误删
🎨 主题自适应：跟随 DSH 页面主题变量（--dsw-*），深色/浅色皮肤均可
🔐 无密钥泄露：插件本体不含任何密钥；调用 DeepSeek Files API 时通过 DSH 的凭据服务（DEEPSEEK_API_KEY）在宿主侧解析，浏览器页面只访问本机路由

前置条件

要求	说明
DeepSeek Harness	`dsh >= 0.1.0-rc.6`（推荐 `0.1.1-rc.2+`，即官方适配器支持 Files API 的版本）
API Key	已在 DSH 凭据中配置 `DEEPSEEK_API_KEY`（用于调用 `https://api.deepseek.com/files`）
Web Profile 目录	`$DSH_HOME/profiles/web/`（Windows 默认 `%USERPROFILE%\.dsh\profiles\web\`）

说明：本插件只管理通过 Files API 上传的文件（图片走 Files API 上传时产生）。纯文本对话、未经过 Files API 的内容不在此列。

安装

方式 A(推荐)∶一条命令安装

本插件是标准的 DSH bundle 包(package.json 声明 dsh.bundle.patch),可直接通过官方插件命令安装:

# 从 GitHub 直装(推荐,不需要 npm 账号)
dsh plugin --profile web add github:iskshadow195563/DeepSeek_Harness_Files_Panel#v1.1.0

# 或从 npm 安装
dsh plugin --profile web add deepseek-files-panel

--profile 必填;换成你实际使用的 profile 名(web 为默认 Web 界面 profile)。

安装完成即加入 Profile 的 bundle 层;重启 dsh web 后生效(与官方皮肤插件同机制)。

本仓库带 dsh-plugin topic,可被 YELEBAI/dsh-plugin-marketplace 等社区插件市场自动扫描收录。

方式 B:手动安装(Windows / macOS / Linux 通用)

下载 dsf-files-panel.mjs（本仓库根目录，或 Release 附件），放入你的 Web profile 目录：

# macOS / Linux（$DSH_HOME 未设置时默认为 ~/.dsh）
cp dsf-files-panel.mjs "${DSH_HOME:-$HOME/.dsh}/profiles/web/"

# Windows PowerShell
Copy-Item dsf-files-panel.mjs "$env:USERPROFILE\.dsh\profiles\web\"

合并补丁：编辑同一目录下的 cordis.patch.yml，在顶层数组追加以下条目：
```
- insert:
    - id: deepseek-files-panel
      name: ./dsf-files-panel.mjs?v=1
```
- 若文件为 [] 或不存在：直接粘贴上面整段；
- 若已有其他 insert 条目：把 - id: deepseek-files-panel 这一行追加到已有的 insert 列表中（?v=1 用于破 ESM 缓存，升级插件时数字 +1）。
保存即热生效（profile 补丁文件被实时监视，无需重启）；若 5 秒内没生效，重启 dsh web。
刷新浏览器页面（F5）——右侧中部会出现「📁 DeepSeek 文件」手柄。

方式 C：一键脚本

Windows（PowerShell）

$dest = "$env:USERPROFILE\.dsh\profiles\web"
New-Item -ItemType Directory -Path $dest -Force | Out-Null
Invoke-WebRequest "https://raw.githubusercontent.com/iskshadow195563/DeepSeek_Harness_Files_Panel/main/dsf-files-panel.mjs" -OutFile "$dest\dsf-files-panel.mjs"
$patch = Join-Path $dest "cordis.patch.yml"
$entry = "`n- insert:`n    - id: deepseek-files-panel`n      name: ./dsf-files-panel.mjs?v=1"
if (Test-Path $patch) { Add-Content -Path $patch -Value $entry } else { $entry | Set-Content -Path $patch }
# 然后按 F5 刷新页面

macOS / Linux（bash）

DEST="${DSH_HOME:-$HOME/.dsh}/profiles/web"
mkdir -p "$DEST"
curl -fsSL "https://raw.githubusercontent.com/iskshadow195563/DeepSeek_Harness_Files_Panel/main/dsf-files-panel.mjs" -o "$DEST/dsf-files-panel.mjs"
{
  echo
  echo "- insert:"
  echo "    - id: deepseek-files-panel"
  echo "      name: ./dsf-files-panel.mjs?v=1"
} >> "$DEST/cordis.patch.yml"
# 然后刷新浏览器页面

使用

操作	说明
展开/收起	点击右侧手柄展开；点面板右上「▶」收起
刷新	标题栏「↻」按钮重新拉取云端列表
复制 ID	每个文件的「复制 ID」按钮，复制 `file-api-...`
删除	点「删除」→ 变红色「确认删除?」→ 3.5 秒内再点一次才会真正从云端删除
直达展开	浏览器地址栏加 `?dsf-open=1`（如 `http://127.0.0.1:3080/?dsf-open=1`）自动展开

卸载

包形态(推荐安装方式)卸载:

dsh plugin --profile web remove deepseek-files-panel

文件型(手动安装)卸载:

从 $DSH_HOME/profiles/web/ 删除 dsf-files-panel.mjs；
从 cordis.patch.yml 的 insert 列表中删除 deepseek-files-panel 那两行；
刷新页面。

已上传到 DeepSeek 云端的文件不会因此删除；需要清理请在面板里删除，或调用 DELETE https://api.deepseek.com/files/{file_id}。

工作原理

浏览器页面 ──(同源 fetch)──> 本机 dsh web(/dsf-files/list, /dsf-files/delete)
                                    │ ctx.credentials 解析 DEEPSEEK_API_KEY(不落页面)
                                    ▼
                     https://api.deepseek.com/files  (GET 列表 / DELETE 删除)

宿主插件（dsf-files-panel.mjs）注入页面脚本 panel.js，并把 Files API 列表/删除路由挂在本机 dsh web 上；
页面脚本只与本机通信，API Key 永不进入浏览器；
与 DeepSeek 官方 Files API 兼容；配合 DSH 0.1.1-rc.2+ 的官方适配器（图片经 Files API 上传并复用 file_id）效果最佳。

发布 Release(v1.x)

本仓库按语义化版本发布。发布步骤：

1. 提交并推送新版本

git add -A
git commit -m "feat: <本次改动>"
git push origin main

2. 打标签(推荐 `v1.0.0` 起)

git tag v1.0.0
git push origin v1.0.0

3. 创建 Release

方式 A —— GitHub CLI(推荐):

gh release create v1.0.0 \
  --title "v1.0.0" \
  --notes "• 右侧可折叠文件面板
• 列出 / 复制 / 删除 DeepSeek Files API 文件
• 主题自适应" \
  ./dsf-files-panel.mjs

方式 B —— GitHub 网页:

打开仓库页 → 右侧 Releases → Draft a new release；
Choose a tag → 选择 v1.0.0(或输入新标签自动创建)；
填写标题与说明(可参考下方模板)；
把 dsf-files-panel.mjs 文件拖入 Attach binaries 作为安装产物；
Publish release。

建议的 Release Notes 模板:

## 安装

下载 `dsf-files-panel.mjs`(本 Release 附件)→ 放入 `$DSH_HOME/profiles/web/`
→ 在 `cordis.patch.yml` 追加 insert → 刷新页面。

```yaml
- insert:
    - id: deepseek-files-panel
      name: ./dsf-files-panel.mjs?v=1

变更


### 版本策略

- `v1.0.0` 首次稳定发布；Bug 修复 `v1.0.1`；新功能 `v1.1.0`；
- 每次发布请同步更新插件内 `?v=` 数字(安装侧用于破 ESM 缓存)。

## 常见问题(FAQ)

| 问题 | 解决 |
|---|---|
| 右侧手柄没出现 | 确认 `.mjs` 在 profile 目录、补丁行已合并、`dsh web` 已加载(等待几秒)并 **F5 刷新页面** |
| 列表报「未配置 DEEPSEEK_API_KEY」 | 在 DSH 设置/Models 页配置该凭据 |
| 显示「HTTP 401/403」 | API Key 无效或过期 |
| 面板不跟随皮肤 | 请确认 DSH 页面提供 `--dsw-*` 主题变量(标准 DSH Web 均提供) |
| 删除后文件仍在列表 | 点「↻」刷新;云端删除是即时的,本地为已删条目 |

## 安全设计

- 插件不含任何密钥;密钥仅由 DSH 凭据服务在宿主进程内解析;
- 页面与 API 之间只经本机 `dsh web` 同源路由,不跨域;
- 删除操作带二次确认,避免误删云端文件;
- 已上传文件默认 7 天过期(过期时间由 DeepSeek 管理),过期前面板会显示剩余有效期。

## License

MIT License — see [LICENSE](LICENSE).

---

<p align="center">
  由 DSH 用户社区维护 · 与 DeepSeek 官方 API 兼容 · 图片上传复用见 <a href="https://api-docs.deepseek.com/zh-cn/guides/files_api/">DeepSeek Files API</a>
</p>

许可证选择

仓库将使用 MIT License。若你有其他偏好(如 Apache-2.0 / 专有),告诉我。

中文安装教程:从零到 Release 的完整版(也适合写进你自己的笔记)

A. 首次把插件放上 GitHub(本仓库即为此例)

git init
git add .
git commit -m "initial release: deepseek-files-panel"
gh repo create deepseek-files-panel --public --source . --push

B. 别人如何安装(终极简化版)

打开本仓库 Release 页,下载附件的 dsf-files-panel.mjs;
放进 $DSH_HOME/profiles/web/(Windows:%USERPROFILE%\.dsh\profiles\web\);
在同目录 cordis.patch.yml 的数组里追加:

- insert:
    - id: deepseek-files-panel
      name: ./dsf-files-panel.mjs?v=1

F5 刷新页面,右侧出现「📁 DeepSeek 文件」手柄。

C. 以后每次发布新版本(3 条命令)

git tag v1.1.0 && git push origin v1.1.0
gh release create v1.1.0 --title "v1.1.0" --notes "变更: ..." ./dsf-files-panel.mjs

以及记得把补丁里的 ?v=1 → ?v=2(否则浏览器可能缓存旧脚本)。

Keywords

FAQs

What is deepseek-files-panel?

Is deepseek-files-panel popular?

Is deepseek-files-panel well maintained?

Package last updated on 22 Aug 2026

deepseek-files-panel