Skip to content

dsh-session-deliverables

Verified

dsh-session-deliverables · v1.0.1 · MIT · Web UI

DSH Web 插件:为每个会话增加「文件」视图,列出本会话交付的文件(Word / Excel / PPT / PDF / 图片 / 视频等),支持一键按附件下载。

Install

dsh plugin add dsh-session-deliverables

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-session-deliverables · 会话文件

中文 · English

一个 DeepSeek Harness(DSH)Web 插件:在每个会话顶栏增加「文件」视图,列出该会话交付的文件,并支持一键按附件下载——内网直连或经公网反向代理都可用。

功能

  • 顶栏「文件」视图:位于「画廊 / 团队」旁,列出通过 present 工具声明的交付物:Word、Excel、PPT、PDF、Markdown、图片、视频、音频、压缩包。
  • 一键下载附件:点击整行或其「下载」按钮,Host 以 Content-Disposition: attachment 流式返回文件,Content-Type 正确,中文文件名也能正常保存。
  • 可选「含工作区成果」:勾选后额外列出会话运行期间在工作区创建的文档 / 媒体文件;代码、脚本、日志、上传文件不会出现在列表里。
  • 侧栏预览下载按钮:在 DSH 原生文档预览页(Excel、PDF、图片及其他原生预览支持的文件)头部增加「下载」按钮。

为什么能做到很小

列表来源是可持久化的会话日志(deliverables/presented),勾选「含工作区成果」后再做一次有界的工作区扫描。下载范围限定在会话工作区,或会话日志中明确声明过的文件,其他路径一律返回 403。插件在 DSH Connection 上注册两个需要鉴权的 Fetch 路由,直接继承 GUI 的登录态与 Host/Origin 校验,不需要单独起服务。

安装

从 npm 安装:

dsh plugin --profile web add dsh-session-deliverables

或直接从本仓库安装:

dsh plugin --profile web add github:xiaoran0829/dsh-session-deliverables

也可以从源码目录安装:

dsh plugin --profile web add /path/to/dsh-session-deliverables

首次安装后重启 dsh web。插件没有配置项。

环境要求

  • DSH Web(在 0.2.1-rc.3 上测试通过)。
  • Linux / macOS / Windows Host,Node.js 20+。
  • 会话需要经内置 present 工具声明最终交付物——「文件」视图列的就是这些文件。

安全模型

  • 两个路由都注册在 ctx.connection.fetch 上,只有已登录的所有者浏览器能通过这道栅栏;公网登录反向代理无需任何改动。
  • GET /api/session-files.list?sessionId=… 只返回元数据。
  • GET /api/session-files.download?sessionId=…&path=… 通过组合后的文件系统解析路径;除非会话日志本身声明过该文件,否则拒绝会话工作区以外的任何路径。
  • 不写文件、不跑后台任务、不发起第三方请求。

开发

node --check index.js
node --check client.js

Host 侧是纯 ESM;浏览器侧是惰性的 window.__ModuleLoader__ 工厂,只依赖 React。

许可证

MIT