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

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

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

功能

• 📋 列出全部已上传文件：文件名（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 通用)

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：一键脚本

$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 刷新页面

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 管理),过期前面板会显示剩余有效期。

## 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 / 专有),告诉我。

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

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

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

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

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(否则浏览器可能缓存旧脚本)。