交付文件库 BlankTasftu/dsh-delivery-library

dsh-delivery-library

在 DSH 对话窗的 对话 / 轨迹 两个页签之外，再加一个 交付文件 页签：把当前会话里 全部显式交付（present）和全部文件产出（write / edit）汇总成一份可检索的文件库，一个会话一份，不用再往回翻聊天记录。

- 纯插件：不改 DSH 本体，只往 conversation.view 座位追加一个新 id 的格子。
- 不读磁盘：清单完全由当前会话已载入的事件窗口折叠而来，不新增宿主路由、不扫工作区、不碰会话日志文件。
- 两栏分开：交付 只看模型显式声明的最终文件；产出 看 write / edit 真正写出的文件。两者不混。

快速安装

在 DSH 的「设置 → 插件」安装入口填：

github:BlankTasftu/dsh-delivery-library

装好后页签变成 对话 | 轨迹 | 交付文件；想确认装到的是完整件，直接在安装目录里跑 node --test "test/.test.mjs"（零依赖，期望 60/60）。细节见 安装。

它长什么样

对话窗顶部页签从 对话 | 轨迹 变成 对话 | 轨迹 | 交付文件。点进去：

┌ 交付文件库 本会话：交付 3 · 产出 12 ────────────┐
│ [ 交付 3 ] [ 产出 12 ] [ 搜索文件名、路径或说明 ] │
├───────────────────────────────────────────────────────────┤
│ ┌MD┐ 调研报告.md 第 4 轮 ×2 [复制路径]│ │ │ │ 最终版，含结论与附录 │ │ │ │ out/reports │ │ ┌PNG┐ chart.png 第 4 轮 │ │ │ │ assets │ ├───────────────────────────────────────────────────────────┤ │ 交付 = present 声明 · 产出 = write / edit 成功写出 │ └───────────────────────────────────────────────────────────┘

- 点一行 → 在右侧栏预览该文件（走 dsh-resource://file/session/<会话>/<路径>）。
没装右栏时自动退化成"复制路径"，点击不会变成没反应。
- 复制路径按钮：悬停行时出现，不会连带打开预览。
- 搜索：同时匹配文件名、目录、说明。
- ×N：同一个文件被多次交付；说明取最近一次，轮次取首次进库那一轮。
- 会话很长、更早的历史还没载入时，底部出现 加载更早（走 session.loadOlder()）。

安装

给别人装（从 GitHub）

在 DSH 的「设置 → 插件」里用安装入口填这个安装说明符：

github:BlankTasftu/dsh-delivery-library

它和 dsh plugin --profile <你的 profile> add github:BlankTasftu/dsh-delivery-library 是同一个安装说明符（桌面端不自带 dsh 命令行，所以多数人走设置页）。插件管理器会把它写进 profile 的依赖与 bundles 清单，再交给 pnpm 安装 —— 与 dsh-ark、dsh-media-preview 那类插件的安装方式完全一致。

无需刷新即可生效：宿主会把新的启动图经 /plugins/events（SSE）推给已打开的页面，页面随即物化并挂上这个条目。页签没出现时再按一次 F5。

装好后想确认拿到的是不是完整件，可以直接在安装目录里跑自带测试（零依赖，不需要装任何东西）：

node --test "test/.test.mjs" # 期望 60/60

本机开发（软链到工作区）

dsh plugin --profile desktop add link:D:\DeepSeekSpace\插件

等价的等价手工做法：在 %DSH_HOME%\profiles\desktop\package.json 里加

"dependencies": { "dsh-delivery-library": "link:D:/DeepSeekSpace/插件" },
"dsh": { "profile": { "bundles": [ /* … /, "dsh-delivery-library" ] } }

然后在该目录跑 pnpm install。软链的好处是改完 lib/client.js 刷新页面即生效。

⚠️ 给改这个插件的人（也包括未来的我）：客户端插件的 apply 里任何未捕获异常都会让桌面端直接退出 —— 渲染进程的启动审计会把未达 active 的条目上报为 web boot: N entry did not activate，桌面主进程把它当致命错误。
所以本插件的 apply 被刻意写成整体不可抛（每步单独 try/catch），失败只降级、并把面包屑写进 shell.overlay 的诊断条目。详见 docs/DESIGN.md。

装完/出问题时自查（只读探针，随包一起交付）

node tools/check-host-resolution.mjs # 从 profile 出发能否解析到 browser bundle
node tools/check-boot-graph.mjs # 插件在不在启动图、在哪个批次、批次能否投递
node tools/check-profile-patch.mjs # profile 的 patch 层 YAML 是否完好、关键条目是否还在
地址和路径都能覆盖：DSH_PROFILE_DIR、DSH_WEB_URL、DSH_ASAR_PATH（见 tools/paths.mjs）。

崩溃日志（哪天又崩了，先看这里）：

%APPDATA%\@deepseek-ai\dsh-desktop\logs\crash--web-boot.log

卸载：设置 → 插件里停用或卸载该 bundle；或从 dsh.profile.bundles 里删掉包名再 pnpm install。

数据口径（哪些文件会出现在这里）

| 栏位 | 来源 | 判据 |
| 交付 | 会话事件 deliverables/presented | present 工具成功执行后由宿主 append，形如 { turn, callId, files: [{ path, description? }] } |
| 产出 | 会话事件 tool/call + tool/result | 只认 write、edit、以及完整改写的 str_replace_editor；且结果必须不是错误 |

也就是说：读文件、删除、失败或被中断的调用、参数残缺的调用，都不会进清单；用终端命令（pwsh/bash）创建的文件也不会出现在「产出」里 —— 只有模型显式 present 才会进「交付」。这与出厂 ui-deliverables 的卡片口径一致。

同一路径按归一化形状（反斜杠、./ 前缀、尾斜杠）合并为一行，不折叠大小写：大小写敏感的文件系统上 A.md 与 a.md 是两个文件，猜错会把两份交付合成一行。

活动边界（这个插件只做插件该做的事）

这一条不是口头保证，而是 test/isolation.test.mjs 里 10 个静态断言钉住的：

| 面 | 结论 | 断言 |
| 宿主半侧 | 什么都不做：没有任何 import／require，不引用 fs/child_process/net/http/process/eval，apply() 是空函数 | 4 条 |
| 浏览器半侧 | 只 require('react')；不联网（无 fetch/XHR/WebSocket/EventSource）；不写任何存储（localStorage/sessionStorage/indexedDB/cookie）；无 eval；不碰文件（文件只拼一个 dsh-resource:// 地址交给侧栏读） | 4 条 |
| 装载声明 | cordis.patch.yml 只插入自己这一行，不含 disabled／inject／其它条目的覆盖；package.json 无安装脚本、无任何依赖、无可执行入口 | 2 条 |

运行时它到底动了什么：注入一份带 data-plugin 标记的 （插件卸载时由宿主按标记回收） ＋ 在 conversation.view 座位注册一个格子 ＋ 注册两份词典。仅此而已。

安装动作本身（dsh plugin add / 插件管理器 / pnpm）会在 profile 目录里写 package.json 的一条依赖与 bundles 名单，并建一个指向本目录的链接 —— 那是安装器的写入，不是插件运行时行为；本插件在运行时对 profile、DSH 本体、系统都零写入。

已知边界

- 清单覆盖已载入的会话事件窗口。会话非常长时窗口可能只含尾部，底部会给「加载更早」；点它即向前补页，补进来的交付会立刻出现在清单里。
- 视图是会话作用域的：切换会话就换一份清单；空会话不渲染视图区（与出厂行为一致）。
- 交付卡片打开的是当前文件，不是交付那一刻的快照；文件被删掉后预览会报找不到。
- 不提供"在资源管理器中显示"：那需要宿主 desktop 路由与授权坐标，超出本插件范围。
- 路径原样使用会话记录里的拼写（含 ..），与出厂 ui-deliverables 的资源地址判据完全一致—— 打开与否最终由宿主的会话文件服务裁决，插件不做也不该做路径改写。
- 极端长的会话（几百个产出文件）列表会一次性渲染，没有虚拟滚动；搜索框是主要的收敛手段。

开发

lib/index.js 宿主半侧：空实现（只作为客户端 bundle 的装载入口） lib/client.js 浏览器半侧：视图 + 事件折叠（全部功能在这里） test/ 60 个用例：折叠逻辑 / 注册契约 / 崩溃防护 / 样式选择器 / 渲染冒烟 / 隔离性 / 清单一致性 tools/asar-extract.mjs 只读：从 app.asar 抽取内置包源码（核对契约用） tools/asar-ls.mjs 只读：列 asar 内某个目录 tools/check-boot-graph.mjs 只读：本插件在不在启动图、在哪个批次、批次可投递 tools/check-host-resolution.mjs 只读：从 profile 出发能否解析到 browser bundle tools/check-profile-patch.mjs 只读：profile patch 的 YAML 是否完好、关键条目还在不在 tools/paths.mjs 上面几个探针共享的路径解析（走环境变量，不写死机器路径） docs/DESIGN.md 为什么这样取数、座位契约、验证证据、事故记录 docs/RECOVERY-profile-config.md 故障档案：新会话报 no API key 的那次配置丢失

跑测试（不需要安装任何依赖）：

$NODE = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"
& $NODE --test "test/*.test.mjs"

test/harness.mjs 会按 DSH 的真实装载契约（window.__ModuleLoader__.load + factory(require)）执行要发货的那份 lib/client.js，再用一个迷你 React 运行时把它渲染出来 ——测的不是副本，也没有引入测试框架依赖。

版本

- 0.2.0 —— 修复 0.1.0 里一个会让 DSH 桌面端退出的选择器缺陷；apply 改为绝不抛错并带诊断通道；见 CHANGELOG.md 与 docs/DESIGN.md 第 5 节。

MIT · 见 LICENSE