会话交付文件 xiaoran0829/dsh-session-deliverables

dsh-session-deliverables · 会话文件

一个 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。

接入方式（引导接入）

- 形态：DSH Web Cordis 插件（dsh.bundle.patch + dsh.client），注册两个需登录态的 HTTP 路由。
- 路由注册做了跨版本兼容：0.2.x 用 ctx.connection.fetch.register，0.1.0-rc.6 用 ctx.webServer.register（Node 风格 handler）；两者都不存在时插件保持加载、跳过路由并打一条 warn。
- package.json#dshWorkshop 声明为 harness-cordis + third-party adapter 的 guided 接入；当前没有事务安装、没有 Registry 安装权限，也没有可执行安装步骤。上面「安装」一节的命令是作者本机经验，不构成 Workshop 安装能力。
- 安装或升级插件后需重启 DSH Web 的 profile 才生效。
- 静态核对发现 0.1.0-rc.6 没有 deliverables/presented 会话事件：基线下列表为空，只有「含工作区成果」的有界扫描仍可用。路由注册已按 rc.6 的 webServer.register 适配。
- 未跑通 rc.6 完整 Web 启动（该环境核心插件树无法启动），因此仍无基线生命周期证据；evidence 四项均为 null。

权限与外部副作用

| 能力 | 事实 |
| 文件读取 | 只读会话日志（deliverables/presented）与会话工作区内有界扫描（最多 200 个文件、3 秒预算、深度 12，跳过 node_modules 等目录）；不写文件 |
| HTTP | 在 DSH Connection fence 上注册 /api/session-files.list 与 /api/session-files.download，继承 GUI 登录态与 Host/Origin 校验 |
| 越界保护 | 下载只允许会话工作区内、或会话日志明确声明过的文件，其余返回 403 |
| 网络外发 | 无。插件不发第三方请求 |
| 进程 | 不起子进程、不跑后台任务、无 install script |
| 不可 generation 回滚 | 下载行为无持久化副作用；插件不修改任何交付物 |

兼容与测试

- 作者本机：DSH Web 0.2.1-rc.3（当前安装版本）。
- 已有检查：node --check index.js client.js 通过；无单元/集成测试、无官方基线生命周期测试、无失败注入或热重载证据。

已知限制

- 列表只认会话日志里 present 声明过的交付物；「含工作区成果」是有界补充，超出预算的文件不会出现。
- 插件没有 dispose 证据，dshWorkshop.lifecycle.dispose 如实写 unknown。

许可证

MIT