Skip to main content
D

dsh-project-gallery

dongsheng123132/dsh-project-gallery

DeepSeek Harness 插件「项目相册」:把会话里 AI 看过/生成过的图、以及项目目录里的图攒成一册,悬停工作区就能看,点开是类相册的大图 + 当时的对话诉求与进展。

Install

dsh plugin --profile web add github:dongsheng123132/dsh-project-gallery

README

npm version npm downloads DSH tested 0.2.2-rc.1 → 0.2.2-rc.3 License: MIT

English · 中文

DeepSeek Harness(DSH)插件:把会话里 AI 看过 / 生成过 / 交付过的图,以及项目目录里的图,按项目攒成一册。 悬停项目行就能看最近几张;点开是相册;点大图能看到当时你让它做什么。

项目相册:图左、当时那段对话在右

四个入口

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

右侧栏「项目相册」tab:左边继续对话,右边按范围看图、看进展

悬停工作区行:先看最近 4 张,可固定、可静音

看哪个范围(三个维度)

右栏顶部有一排范围按钮,默认按上下文落位:

维度看什么什么时候默认
本次对话只显示这次会话里出现过的图(AI 看过的、生成的、交付的)从对话/面板打开、宿主把 tab 绑在会话上时
当前项目这个项目目录里 AI 用过的图 + 目录里的图悬停项目行打开时
全部项目所有项目的最新图,按天分组;切「看板」就是项目进度看板从「更多工具」直接打开时

「全部项目」下还有 网格 / 看板 两个视图:

项目看板:每个项目一行,最新 3 张 + 最后活动 + 待办进度

看板一行一个项目:最新 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

Related plugins