🖼️ dsh-museav-assets

在 DSH 里看得见你的素材库。
主区多一个「资产」tab：按项目（工作区）看 MUSE AV 的素材库与最近出图，
点素材即复制直链，直接当垫图用（museav gen --ref <url>）。

English | 中文

Why This

	本插件	mcp__cs__* 工具	直接敲 CLI
看清「有哪些项目、各有多少素材」	✅ 一屏网格 + 计数	❌ 单次调用，看不见全貌	⚠️ 逐条命令，靠脑记
素材拿直链当垫图	✅ 点一下复制	⚠️ 得先知道素材 id	⚠️ 手抄 URL
出图 / 上传能力	➖ 不重复实现，转交 MCP	✅ 完整	✅ 完整
密钥	✅ 不读不转发 ~/.museav.json	✅	⚠️ token 落在本机明文文件

基于本机的 museav CLI，不重复造出图能力 —— 出图/上传继续走已经接进 DSH 的 mcp__cs__* 工具（见 profile 的 cordis.patch.yml）。这个插件只补一件事： 在 DSH 里看得见「我有哪些项目、每个项目里有什么素材」。

放在哪个 tab

主区顶栏，conversation.view 的第 6 个 tab，order 40，排在 对话(0) / 轨迹(10) / 记忆(20) / 上下文 / 电脑环境(30) 之后。

ctx.slots.register({
  name: 'conversation.view',
  id: 'museav-assets',
  order: 40,
  label: () => t('title'),   // 「资产」
}, AssetsView)

为什么是主区而不是右侧面板：资产是「一屏看完的事」（项目列表 + 缩略图网格 + 出图流水）， 右侧面板是给单份文档/单个预览的窄栏，塞不下网格；而且右侧面板的 tab 语义是 「当前选中对象」，资产是全局的，不属于任何一个会话。主区 tab 已有先例 （dsh-user-mirror 的「记忆」同样是全局内容挂在会话壳里）。

装

包名 @dsh-plugins/dsh-museav-assets（与另外三个插件同一 scope）。 dsh-museav-assets（无 scope）是走错路时发过一版的临时名 —— 已于 2026-10-02 撤回（unpublish）， 请只用本名。教训：新插件一开始就用 scope 名，别先发无 scope 再撤回（撤回的名字 24 小时后任何人都能抢）。

桌面端在应用内的插件管理里装 —— 它从 npm 拉。命令行装不进 desktop profile （profile "desktop" is managed exclusively by the Electron application）。

自建 profile（CLI 能管的，例如本地开发用的 desktop-local）：

npm run deploy   # rsync 进 ~/.dsh/profiles/desktop-local/node_modules/@dsh-plugins/dsh-museav-assets/

再把包名加进该 profile（~/.dsh/profiles/desktop-local/package.json）：

"dependencies": { "@dsh-plugins/dsh-museav-assets": "^0.1.1" },
"dsh": { "profile": { "bundles": [ /* … */, "@dsh-plugins/dsh-museav-assets" ] } }

拓扑级变更要重启：桌面端是退出并重开 app（~/.dsh/restart.sh 已作废，现在探测不到 3080 服务会直接以 1 退出）。

前置条件只有一条：本机 museav CLI 已登录（museav login）。 插件自己不读也不转发 ~/.museav.json 里的 token。

接口

路由	做什么
GET /api/dsh-museav-assets/health	CLI 在不在、什么版本、工作区上限
GET /api/dsh-museav-assets/projects	工作区列表 + 出图/素材计数 + used/limit/full
POST /api/dsh-museav-assets/projects	{name} 新建工作区（≤20 字）
GET /api/dsh-museav-assets/assets?project=<id|名>	该工作区的素材库
GET /api/dsh-museav-assets/jobs?limit=<n>	最近出图记录

失败语义：上游/CLI 出错一律 200 + {ok:false,error}，tab 内联显示原因； 只有参数不合法才 400。一次网络抖动不该让 tab 变白屏。

CLI 契约（插件唯一依赖的东西）

lib/museav.js 是唯一知道 CLI 输出长什么样的文件。museav-cli 的 stdout/stderr 分工就是它的脚本契约：

命令	stdout（真值）	stderr（人看的补充）
museav projects	id 换行	名称 / 出图 x/y / 素材 n / brand
museav projects assets --project X	id<TAB>url	名称 / media_type / tags
museav jobs	完整 JSON 数组	表格式摘要
museav projects create --name N	新建 id	成功提示

所以：真值一律取 stdout，stderr 只用来补展示字段。stderr 解析不出来就降级 （项目名退回 id 前 8 位，素材名退回「未命名」），绝不因为上游改一句中文就让整页空白。 test/museav-parse.test.mjs 用真机抓的输出当夹具守着这条线。

已知脆点：museav projects / projects assets 没有 --json，展示字段只能从 stderr 表格里解析。给 museav-cli 这两个命令加 --json 就能把这条脆点彻底消掉 —— 真源在 ~/dev/muse/museav-cli/src/commands/projects.ts，改的是上游仓，不是本插件。

不做什么

• 不出图、不传文件 —— 那是 CLI / MCP 的活，重复实现只会两处漂移
• 不缓存 —— 数据便宜，状态随时在变；想要缓存再加
• 不轮询 —— 挂载时拉一次，用户点「刷新」才重跑

测试

npm run check && npm test   # 28 个：解析契约 12 + 路由 8 + UI 8

路由测试用 stub 可执行文件顶替 CLI（走 MUSEAW_BIN 环境变量），全程不联网、不碰真账号。

CLI 路径为什么是环境变量而不是插件配置：这套 Cordis 的函数式插件读不到 ctx.config （声明了会永远 pending (waiting for service: config)）。MUSEAW_BIN 也正好和 profile 里 MCP 桥的约定一致。改它不用重载插件 —— 每次请求现取。