- Home
- Plugin
- Miglioramenti UI
- dsh-project-gallery
dsh-project-gallery
dongsheng123132/dsh-project-gallery
DeepSeek Harness 插件「项目相册」:把会话里 AI 看过/生成过的图、以及项目目录里的图攒成一册,悬停工作区就能看,点开是类相册的大图 + 当时的对话诉求与进展。
Installazione
dsh plugin --profile web add github:dongsheng123132/dsh-project-galleryREADME
项目相册 · dsh-project-gallery
English · 中文
DeepSeek Harness(DSH)插件:把会话里 AI 看过 / 生成过 / 交付过的图,以及项目目录里的图,按项目攒成一册。 悬停项目行就能看最近几张;点开是相册;点大图能看到当时你让它做什么。

四个入口
| 位置 | 打开什么 |
|---|---|
| 悬停项目 / 对话行右侧的 ⋯ 区 | 弹一张小卡:项目名 + 「N 张图 · 待办 x/y」+ 2×2 缩略图,可 📌 固定、可 ⊘ 静音该项目 |
| 卡片里「打开相册」/ 点缩略图 | 右侧面板(420px):按天分组的网格 + 搜索 + 会话图/磁盘图切换 |
| 工作区头部 📷 或 ⌘⇧G | 全局相册浮层:左侧按项目、右侧按天网格 |
| 右侧栏「项目相册」tab | 常驻右栏:按范围看图 + 进展条;宿主官方席位,可拖动、可全屏 |


看哪个范围(三个维度)
右栏顶部有一排范围按钮,默认按上下文落位:
| 维度 | 看什么 | 什么时候默认 |
|---|---|---|
| 本次对话 | 只显示这次会话里出现过的图(AI 看过的、生成的、交付的) | 从对话/面板打开、宿主把 tab 绑在会话上时 |
| 当前项目 | 这个项目目录里 AI 用过的图 + 目录里的图 | 悬停项目行打开时 |
| 全部项目 | 所有项目的最新图,按天分组;切「看板」就是项目进度看板 | 从「更多工具」直接打开时 |
「全部项目」下还有 网格 / 看板 两个视图:

看板一行一个项目:最新 3 张缩略图 + 最后活动时间 + 改动/命令数 + 待办进度条。 点一行就进那个项目的相册——哪个项目最近出了图、哪个卡住了,一眼扫完。这就是「出现了代表做完了」的可视化。
另外那排「全部 / 会话图 / 项目目录」是来源筛选,不是范围:
- 会话图:AI 在对话里看过、生成过、交付过的图(来自
~/.dsh/sessions与附件库) - 项目目录:当前项目文件夹里的图片文件。只扫这一个目录,限深 3 层、跳过
node_modules/.git/dist、近 240 天、单张 ≤30MB。 不是全盘图片检索(不是 Everything 那种扫整块磁盘),扫描范围就是你在 DSH 里打开的那个项目。
灯箱
大图不再铺满屏幕,而是按容器宽度换布局:
- 宽容器(全屏 / 全局相册):图在左、上下文在右(当时在做什么、时间/尺寸/体积/工具/来源/会话/第几轮/路径), 底部胶片条 —— YouTube 那种布局。
- 窄容器(右侧栏 tab / 窄窗口,≤760px):自动改成上下堆叠——图在上占满宽度,详情在下方, 翻页按钮压在图上。右栏里再左右分栏会把图挤成邮票、右边留一大条空白。
←/→ 翻页、Esc 逐层退回对话;显示用 1600px 中图秒开,想看原始像素点「看原图」。


截图与促销图都用虚构数据生成(
node demo/shots.mjs、node promotion/make-promo.mjs);演示图片是公共领域作品 (Met Open Access,CC0,来源见 demo/fixtures/LICENSE-IMAGES.md),不含任何真实项目或会话。 重生成步骤与逐图来源见 docs/screenshots-demo/PROVENANCE.md。
数据从哪来
- 会话附件:
~/.dsh/sessions/**/session.v4.jsonl.zstd+~/.dsh/attachments/v1/objects/** - 交付图:
deliverables/presented - 项目目录里的图:限深 3、跳过
node_modules/.git/dist、近 240 天、单张 ≤30MB
刷新策略:索引在 60 秒内直接复用(不扫盘),过期后做一次增量重建——只重扫 size/mtime 变过的会话文件,
新图 1 分钟内出现在卡片和面板里。面板底部显示「X 分钟前更新」;想立刻看到就点「重建索引」。
(0.1.4 之前是「建一次就不再自动重建」,会出现卡片一直是旧图的问题。)
读的全是本机文件,不发任何网络请求(除了插件自己的本地接口)。
隐私
- 索引与缩略图缓存在本机(默认
~/.dsh/cache/dsh-session-gallery),含项目路径、会话标题、对话文字; 分享缓存目录前请自行检查。 - 静音设置存在浏览器 localStorage(
dsh-project-gallery:muted),不上传。 - 插件不收集遥测。
安装
DSH 桌面版:设置 → 插件 → 添加插件,填 dsh-project-gallery。
或者命令行:
dsh plugin --profile web add dsh-project-gallery
桌面版把 web 换成 desktop:dsh plugin --profile desktop add dsh-project-gallery。
想比 npm 版更新(跟 main 走):
dsh plugin --profile web add github:dongsheng123132/dsh-project-gallery
clone 本仓库后本地装:node scripts/install.mjs --profile desktop。
装好后重启 DSH,左侧工具区会出现入口(不同 DSH 版本位置略有差异)。
在 DSH 插件市场里搜到它
本仓库根目录的 plugin-index.json 就是一条插件市场索引源,不用起服务:
https://raw.githubusercontent.com/dongsheng123132/dsh-project-gallery/main/plugin-index.json
在 DSH 里启用实验性插件市场 → 把上面这个地址添加为索引源 → 搜「项目相册」或 project gallery。
开发
npm run check # 语法 + 26 项单测
npm run bench # 资源基准:建索引 / 刷新开销 / 内存(见 PERF.md)
npm run shots # 重新生成演示图(需要 playwright)
它贴宿主贴得多紧
这个插件不是只加一行菜单:它挂一个 /session-gallery 前缀路由、读宿主的工作区注册表、还要在侧栏 DOM 上做悬停几何识别。
宿主缺哪块就降级哪块(没注册表 → 悬停失效但全局相册照用;没 connection → 跳过鉴权判定但保留同源检查),
细节与宿主求值器实测表(0.2.1-rc.5 → 0.3.0 全部放行)见 COMPATIBILITY.md。
实用口径:engines.dsh 只写下界、不写上界——上界会让 DSH 一升级就直接装不上,而不是降级。
右侧栏 tab 走的是宿主正式的 sidebarRightTabs + slots 席位(宿主 8 个右栏 tab 里没有图片类,这一格是空的);
宿主没有这个席位时,插件自动退回原来的右侧浮层,功能不丢。
已知限制
- 悬停预览依赖宿主 DOM(
data-row-key)与几何推断,DSH 大版本升级后可能需要重新对位;取不到就只剩「📷 全盘相册」。 - 目前只在 macOS 上实测(CLI 0.2.2-rc.1 / 桌面版 0.2.2-rc.3);Windows 桌面版未验证。
- 搜索结果里的会话行没有
data-row-key,悬停不生效,请用全局相册。 - 同一张图出现在多个会话时,各会话各自保留一条关联(这是真实状态,不做跨会话合并)。
常见问题
装完在哪里找? 四个入口:悬停项目/对话行右侧的 ⋯ 区、卡片里「打开相册」、工作区头部 📷 / ⌘⇧G、右栏「更多工具 → 项目相册」。
右栏没有「项目相册」tab? 这个 tab 需要宿主的 sidebarRightTabs + slots 席位(DSH ≥ 0.2.1-rc.5 有)。
老宿主上插件会自动退回右侧浮层,功能不丢。装完没看到就重启一次 DSH。
图不是最新的? 索引 60 秒内复用、过期做增量刷新;想立刻刷新点面板底部的「重建索引」,或重启 DSH。
「项目目录」是不是扫整个磁盘? 不是。只扫当前项目目录:限深 3 层、跳过 node_modules/.git/dist、近 240 天、单张 ≤30MB。
占资源吗? 平时不占 CPU(无常驻定时器),开销只在索引过期且你正在看图时发生。实测数字见 PERF.md。
隐私? 只读本机文件,不发网络请求、无遥测;索引与缩略图缓存都在本机。
怎么卸载? dsh plugin --profile web remove dsh-project-gallery,再删掉 ~/.dsh/cache/dsh-session-gallery 即可。
License
MIT
Plugin correlati
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
dsh-TUI
ccch1mneyyy/dsh-tui
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui