dsh-conversation-files
DeepSeek Harness 插件：一个左侧边栏画廊，汇总助手在所有对话中编写、编辑或交付的每个文件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Shall0vv/dsh-conversation-files#1b98076b9188772443906aadb3a6ed02e04a018b
Conversation Files 以 dsh-conversation-files 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness (DSH) web plugin: a left-sidebar entry that gathers every file the assistant generated for you — across all conversations — into one gallery panel, grouped by file type.
Click 对话文件 (folder icon, below SSH) in the left sidebar to open the panel.
中文版: README.zh.md
The panel replays the event log of every conversation in the profile and keeps only files the assistant produced:
| kind | where it comes from |
|---|---|
| 写入 / Written | files written, edited or patched by tools (write, edit, apply_patch, …) |
| 交付 / Delivered | files handed over by present-style tools |
Read-only touches (read, view_image, …) and user attachments are deliberately not generated files and never appear here.
Files are grouped by extension:
| group | extensions |
|---|---|
| 图片 / Images | png jpg jpeg webp gif svg bmp avif ico |
| 文档 / Documents | md mdx txt rtf pdf doc docx docm dot dotx odt pages epub |
| 表格 / Spreadsheets | xls xlsx xlsm xlsb numbers ods csv tsv |
| 演示文稿 / Slides | ppt pptx pptm pps ppsx pot potx key odp |
| 代码 / Code | js mjs cjs ts tsx jsx py rb go rs java kt c cc cpp h hpp cs swift sh bash zsh ps1 css scss less html htm vue lua php |
| 配置 / Config | json jsonc json5 yaml yml toml ini conf cfg env gitignore plist lock |
| 数据 / Data | jsonl ndjson xml parquet sqlite db sql |
| 压缩包 / Archives | zip tar gz tgz bz2 xz 7z rar dmg iso |
| 音视频 / Media | mp3 wav m4a flac aac ogg opus mp4 mov mkv webm avi |
| 其他 / Other | everything else (e.g. ttf woff) |
Each card opens with a preview thumbnail:
| card type | thumbnail |
|---|---|
| images | the image itself, downscaled by the browser |
| code, text, config | the first 8 lines of the file in a small monospace block, faded at the bottom |
| markdown | the same, with heading markers, list bullets and emphasis stripped so it reads like prose |
| PDF / Word / PowerPoint / Excel / iWork | the first page, rendered on demand by macOS QuickLook |
| everything else (archives, media, binaries) | a large extension label plus a type icon |
Every card carries the extension in its top-right corner and shows the conversation it came from (plus +N when more conversations touched it), how many times it was written, its size and the time of the last write. The full path is in the tooltip.
Clicking a card opens the file with its default application. The ⋮ button in the bottom-right corner opens a menu (pop/fade animation both ways):
| menu entry | action |
|---|---|
| 使用默认应用打开 / Open with default app | hands the file to open |
| 选择应用打开 / Open with… | a second menu listing the apps macOS can open this file with (the default one first, then Other… for the system chooser) |
| 在 Finder 中打开 / Show in Finder | open -R |
| 移到废纸篓 / Move to Trash | moves the file into ~/.Trash (recoverable), after a confirmation |
Files that no longer exist on disk are not part of 全部: they get their own 已删除 chip, a red 已删除 badge and no thumbnail.
Interactions:
localStorage.localStorage.scale(.92) and list rows unfold from a squashed bar, 14 ms apart.lib/index.js)
GET /dsh-conversation-files/generated — sessionQuery.listSessions() → skip origin: 'subagent' → batch titles via readTitleSnapshots → read each log (live sessions from memory, persisted ones via readSession) → parse only tool/call arguments (never tool/result, whose meta.path is the operated-on file) → canonicalise paths with realpathSync → merge per path across conversations → stat the first 400 → sort by last write, newest first.GET /dsh-conversation-files/thumb?path=… — returns image bytes only for files that appear in the most recent scan, only for image extensions, only up to 12 MB.GET /dsh-conversation-files/text?path=… — the first 40 lines of a generated text file (≤ 256 KB, binary files rejected), used for the code/markdown previews.GET /dsh-conversation-files/preview?path=…&size=… — a page thumbnail for a generated document, rendered with qlmanage -t and cached in ~/.dsh/cache/dsh-conversation-files/previews/ (one PNG + one JSON of {mtimeMs,size} per file, keyed by path hash and size), memory-cached per process.GET /dsh-conversation-files/raw?path=… — original bytes (images, PDF, audio/video) for the in-panel viewer.GET /dsh-conversation-files/apps?path=… — the applications that can open a generated file, best match first (JXA + NSWorkspace.URLsForApplicationsToOpenURL), cached per extension for 10 minutes.POST /dsh-conversation-files/open, /open-with (with or without an explicit app=), /reveal, /trash — the card actions above; every one validates the path against the current snapshot first.connection.requestRejection.client/client.js) — registers sidebar.panellist (id conversation-files, order 50) and the matching main panel; polls the route, buckets files by group, and renders sticky group headers with a responsive card grid.Caching happens at three levels, so the panel is never stuck on a loading screen for long:
~/.dsh/cache/dsh-conversation-files/generated.json. A snapshot younger than 10 minutes is served as-is; one younger than a day is served immediately and rebuilt in the background (the footer shows 「后台更新中」).A warm-up scan runs five seconds after the host starts, so even a cold process has a snapshot ready before you click the sidebar entry.
The gallery, grouped by file type Thumbnails for images, markdown, code and documents The card menu: open with the default app, choose an app, reveal in Finder, move to Trash
bash redirections (>, tee, …) are invisible — that is not a structured write call. Only tool arguments are parsed..conf / .lock extension lands in 配置; unknown extensions (fonts, binaries) land in 其他.git clone https://github.com/Shall0vv/dsh-conversation-files
Then, in DSH:
plugin_manager install_bundle target=<absolute path to the cloned folder>
To update an installed copy, remove it first:
plugin_manager remove_bundle target=dsh-conversation-files
plugin_manager install_bundle target=<absolute path to the cloned folder>
The bundle is linked into ~/.dsh/profiles/<profile>/package.json and listed in dsh.profile.bundles, so it survives a restart. Removing the bundle from the profile removes the sidebar entry.
qlmanage), the Trash move (~/.Trash) and the app list / open-with picker (osascript + NSWorkspace). The gallery itself, the text previews and the filters work anywhere.web client bundle — no extra dependencies.