上传文件管理面板iskshadow195563/DeepSeek_Harness_Files_Panel

DeepSeek 文件面板 · DSH 上传文件管理面板

为 DeepSeek Harness(DSH)Web 界面提供的一个右侧可折叠侧边栏：列出、查看并清理你的 DeepSeek 账号通过 Files API 上传的图片，支持复用已上传文件的快速管理。

面板展开效果

折叠为右侧竖排手柄（📁 DeepSeek 文件），点击展开；也可用 ?dsf-open=1 直达展开态。

功能

- 📋 列出全部已上传文件：文件名（DSH 自动命名 dsh-.）、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 通用)

1. 下载 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\"

2. 合并补丁：编辑同一目录下的 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）。

3. 保存即热生效（profile 补丁文件被实时监视，无需重启）；若 5 秒内没生效，重启 dsh web。

4. 刷新浏览器页面（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-paneln      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

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

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

已上传到 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 网页:

1. 打开仓库页 → 右侧 Releases → Draft a new release；
2. Choose a tag → 选择 v1.0.0(或输入新标签自动创建)；
3. 填写标题与说明(可参考下方模板)；
4. 把 dsf-files-panel.mjs 文件拖入 Attach binaries 作为安装产物；
5. 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 管理），过期前面板会显示剩余有效期。

许可证

MIT License — 见 LICENSE。

由 DSH 用户社区维护 · 与 DeepSeek 官方 API 兼容 · 图片上传复用见 DeepSeek Files API

许可证选择

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

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

A. 首次把插件放上 GitHub（本仓库即为此例）
bash
git init
git add .
git commit -m "initial release: deepseek-files-panel"
gh repo create deepseek-files-panel --public --source . --push

B. 别人如何安装（终极简化版）

1. 打开本仓库 Release 页，下载附件的 dsf-files-panel.mjs；
2. 放进 $DSH_HOME/profiles/web/（Windows：%USERPROFILE%\.dsh\profiles\web\）；
3. 在同目录 cordis.patch.yml 的数组里追加：
yaml
- insert:
- id: deepseek-files-panel
name: ./dsf-files-panel.mjs?v=1

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

C. 以后每次发布新版本（3 条命令）
bash
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（否则浏览器可能缓存旧脚本）。