前言¶
在 DeepSeek Harness（DSH）里接 MUSE AV 出图时，常见路径是 MCP 的 mcp__cs__* 工具或直接敲 museav CLI。这两种方式能完成上传和出图，但很难在一屏里看清「有哪些工作区、每个工作区有多少素材、最近出了哪些图」。要拿某张图的直链当垫图，往往还得先记住素材 id 或手抄 URL。
@dsh-plugins/dsh-museav-assets（仓库 webkubor/dsh-museav-assets）由社区维护者 webkubor 发布，分类为客户端插件。它基于本机已登录的 museav CLI，在主区增加「资产」tab，按工作区展示素材库与最近出图，点素材即可复制直链，便于配合 museav gen --ref <url> 使用。出图与上传仍交给 CLI / MCP，插件不重复实现那部分能力，也不读取或转发 ~/.museav.json 中的密钥。
这是什么¶
一句话：DSH 里的 MUSE AV 资产浏览台——看得见项目与素材，复制直链当垫图。
插件通过调用本机 museav 命令获取数据，服务端不碰 token。与单次调用的 MCP 工具、逐条敲 CLI 相比，README 中的对比表强调：本插件适合「一屏网格 + 计数」看清全貌，以及「点一下复制」拿直链；完整出图 / 上传能力仍由 MCP 或 CLI 承担。
界面放在哪里¶
主区顶栏 conversation.view 注册第 6 个 tab，order 为 40，排在对话、轨迹、记忆、上下文、电脑环境之后，标签为「资产」。
选择主区而不是右侧面板，是因为资产视图是「项目列表 + 缩略图网格 + 出图流水」的一屏浏览；右侧面板语义是「当前选中对象」，而资产是全局的，不属于单个会话。
核心功能¶
下面介绍插件实际提供的能力（均以 README 与仓库说明为准）。
工作区与素材¶
- 列出 museav 工作区（项目），并展示出图 / 素材计数及
used/limit/full等配额信息。 - 按选定工作区加载素材库；stdout 提供
id与url，展示名称等字段从 CLI stderr 解析，解析失败时降级显示（例如项目名退回 id 前 8 位）。 - 支持通过接口新建工作区（名称不超过 20 字）。
最近出图¶
- 拉取最近出图记录（
museav jobs，stdout 为完整 JSON 数组）。
复制直链¶
- 点击素材即复制 URL，可直接作为垫图引用。
HTTP 接口（供 tab 与集成方）¶
| 路由 | 作用 |
|---|---|
GET /api/dsh-museav-assets/health |
检测 CLI 是否可用、版本、工作区上限 |
GET /api/dsh-museav-assets/projects |
工作区列表与计数 |
POST /api/dsh-museav-assets/projects |
body {name} 新建工作区 |
GET /api/dsh-museav-assets/assets?project=<id\|名> |
指定工作区素材 |
GET /api/dsh-museav-assets/jobs?limit=<n> |
最近出图 |
上游或 CLI 出错时，接口仍返回 HTTP 200，body 为 {ok:false,error}，由 tab 内联显示原因；仅参数非法时返回 400，避免一次抖动导致整页白屏。
明确不做的部分¶
- 不出图、不传文件（交给 CLI / MCP）。
- 不缓存数据；挂载时拉一次，用户点「刷新」才重跑。
- 不轮询。
安装与启用¶
包名为 @dsh-plugins/dsh-museav-assets（npm scope @dsh-plugins）。历史上无 scope 的 dsh-museav-assets 已于 2026-10-02 从 npm 撤回，安装时请只用本名。
桌面端（推荐）¶
在 DSH 应用内的插件管理中安装，由应用从 npm 拉包。命令行无法把插件装进受 Electron 独占管理的 desktop profile（会出现 profile "desktop" is managed exclusively by the Electron application 一类提示）。
拓扑或 bundle 变更后需退出并重新打开桌面应用（README 注明 ~/.dsh/restart.sh 已作废）。
自建 profile（本地开发）¶
若使用 CLI 可管理的 profile（例如 desktop-local），可在插件仓库内执行：
npm run deploy
该命令将构建产物 rsync 到 ~/.dsh/profiles/desktop-local/node_modules/@dsh-plugins/dsh-museav-assets/（默认 profile 可通过环境变量 DSH_PROFILE 覆盖）。
并在对应 profile 的 package.json 中声明依赖与 bundle，例如：
"dependencies": { "@dsh-plugins/dsh-museav-assets": "^0.1.1" },
"dsh": { "profile": { "bundles": [ /* … */, "@dsh-plugins/dsh-museav-assets" ] } }
前置条件¶
本机已安装并完成 museav login。插件不读取 ~/.museav.json。
可选：通过环境变量 MUSEAW_BIN 指定 museav 可执行文件路径（与 profile 里 MCP 桥约定一致），改路径无需重载插件。
典型用法¶
- 安装并启用插件，确认本机 museav 已登录。
- 打开 DSH 主区顶栏的「资产」tab，查看工作区列表与各工作区素材 / 出图数量。
- 选择某个工作区，在网格中浏览素材；点击需要的素材，复制直链。
- 在 CLI 或已通过 DSH 接入的 MCP 工具中出图时，将直链作为参考图，例如：
museav gen --ref <url>
其中 <url> 为刚复制的素材直链。
需要新建工作区时，可通过 tab 对应能力或 POST /api/dsh-museav-assets/projects 提交 { "name": "你的工作区名" }（名称 ≤20 字）。
适用场景与注意¶
适合谁： 已在 DSH 或本机使用 museav CLI / mcp__cs__* 做 MUSE AV 出图，希望在不离开 DSH 的情况下浏览工作区、素材和最近出图，并快速复制垫图链接的开发者。
权限与安全： 插件以当前 DSH 进程权限运行，通过子进程调用本机 museav；安装前建议查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。
与上游 CLI 的契约： 展示字段部分依赖 museav projects / projects assets 的 stderr 表格解析（这两条命令尚无 --json）。若上游为命令增加 --json，可降低解析脆点；真源在 museav-cli 的 projects 相关命令，而非本插件。
社区目录： 插件收录于 SkillHub 目录页（GitHub 约 49 stars）。该目录为社区站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态奉行「一切皆插件」，本包是其中面向 MUSE AV 资产可视化的客户端扩展。
结尾¶
dsh-museav-assets 补的是「看得见」这一环：主区「资产」tab、按工作区看素材与出图流水、一点复制直链。出图与上传继续用你已有的 MCP 或 CLI 即可。
- 目录页：https://www.skillhub.cn/plugins/webkubor/dsh-museav-assets
- 源码与说明：https://github.com/webkubor/dsh-museav-assets
- npm：
@dsh-plugins/dsh-museav-assets
