前言¶
在 DeepSeek Harness（DSH）里做多工作区、多会话开发时，产物往往散落在各目录的 out/、outputs/ 里，上传文件也可能落在 attachments、incoming 等不同位置。若只靠资源管理器或终端 ls 逐层翻目录，类型混杂、点文件与 node_modules 穿插其中，查找成本高。下文介绍的 dsh-asset-gallery（维护者 ZyRay233，分类为客户端插件）在 DSH Web 会话界面提供只读「资产库」面板：按文档、图片、音视频等页签浏览工作区文件，并单独聚合「上传的」「生成的」两类路径，适合需要快速复制路径或 @ 引用、预览小文本、在浏览器打开媒体文件的场景。
这是什么¶
dsh-asset-gallery 是 DSH 的资产业务向文件管理插件（README 中亦称 DSH 资产库）。它在 host 侧挂载扫描与 HTTP API，在浏览器侧通过 DSH client UI slots 注入会话头部的入口，不写入、不删除、不上传任何文件。插件版本在 package 元数据中为 0.1.0，许可证 MIT。
社区目录页：SkillHub 上的 dsh-assest-gallery。源码与说明见 GitHub 仓库；README 与 package 中的安装地址指向 ZyRay233/file-manager 仓库，安装时应以 README 中的命令为准。
核心功能¶
下面按 README 已写明的能力归纳，不做超出资料的扩展。
按类型与工作区浏览¶
- 顶部页签：全部 / 文档 / 图片 / 音视频 / 压缩包。
- 工作区列表从 DSH 的
workspace.json自动发现；大工作区下子目录先折叠为一行，点开再展开，右上「← 上级」返回上一层。 - 默认隐藏
.dsh、.git、node_modules、__pycache__等系统或缓存路径。
文件操作菜单¶
每个文件右侧「⋮」菜单支持：复制路径、复制 @ 引用、预览文本（受 API 大小限制）、在浏览器中打开图片或音视频。
「上传的」与「生成的」聚合页¶
- 上传的：依次扫描
~/qq_files、$DSH_HOME/attachments/v1/files、~/incoming（目录存在才扫）。 - 生成的：默认在每个工作区下扫描
out/、outputs/、deliverables/、tmp_frames/、gen/，以及~/tmp_frames，取最近 7 天的图片与音视频。 - 可用环境变量覆盖「生成的」扫描目录（逗号分隔），例如：
DSH_ASSET_GALLERY_GENERATED_DIRS="/data/outputs,/data/render" dsh web --no-open
HTTP API（只读）¶
路由挂在 DSH webServer 上，供客户端面板调用：
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /dsh-ag/api/scan?type=all&ws=<工作区名>&dir=<相对目录> |
扫描一层，返回文件与子目录摘要 |
| GET | /dsh-ag/api/collected?which=uploaded\|generated |
聚合页文件列表 |
| GET | /dsh-ag/api/peek?path=<绝对路径> |
只读预览文本（≤32KB） |
scan 的 dir 不得越出所选工作区；peek 仅允许工作区根或用户主目录范围内的路径（经 resolve 与前缀校验）。
环境要求¶
- DSH Web（
dsh web）>= 0.2.0（packageengines.dsh与此一致）。 - 浏览器端依赖 DSH 的 client UI slots（
@deepseek-ai/dsh-client-ui-slots）。
安装与启用¶
官方 README 给出两种安装方式。日常从 GitHub 安装可使用下面命令（勿自行改写仓库 URL）：
dsh plugin --profile web add git+https://github.com/ZyRay233/file-manager.git
本地开发与 link 安装时，README 要求先克隆 file-manager 仓库、在插件目录执行构建，再以 link 方式注册（具体路径以你本机克隆目录为准）。装完后需重启 dsh-web，例如 Linux systemd：
systemctl restart dsh-web
亦可手动重启正在运行的 dsh web 进程。
典型用法¶
- 打开任意 DSH Web 会话，在会话头部找到 资产库 按钮，点开右侧资产库面板。
- 在顶部选择文件类型页签，在下拉框中切换工作区。
- 需要深入子目录时点击折叠行进入；用「← 上级」返回。
- 对目标文件打开「⋮」菜单，按需复制路径、
@引用，或预览、浏览器打开媒体。
工作区注册表默认读取 $DSH_HOME/storages/workspace.json，按 title / path 展示；若文件不存在则回退到用户主目录。
适用场景与注意¶
适合谁：经常在 DSH 里切换多个工作区、需要按类型筛文件、或要把上传/生成产物集中看一眼的 Web 端用户；需要纯只读浏览、快速引用路径到对话里的场景。
权限与安全：插件以当前 DSH 进程权限读盘，安装前应自行审阅源码与 MIT 许可证。设计上为纯只读：peek 限制 32KB，无写入/删除/上传接口；隐藏点开头文件与常见系统目录。DSH 社区目录（如 SkillHub）为独立生态站点，与 DeepSeek / 幻方无官方从属关系，安装插件属于信任维护者与仓库内容的个人选择。
资料不一致处：目录页与线索中的仓库名为 dsh-assest-gallery，而 README 安装与 package repository 指向 file-manager.git；本文安装步骤以 README 为准。
结尾¶
dsh-asset-gallery 把「工作区树状翻目录」改成「按类型 + 聚合目录」的浏览方式，并守住只读边界，降低在 DSH 会话里找文件、引文件的摩擦。进一步了解可访问 SkillHub 目录页 与 GitHub（安装命令见 README 中的 file-manager 地址）。
