素材库浏览 webkubor/dsh-museav-assets

🖼️ dsh-museav-assets

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

为什么做这个

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

基于本机的 museav 命令行，不重复造出图能力 —— 出图/上传继续走已经接进 DSH 的 mcp__cs__ 工具（见配置档的 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 "desktop" is managed exclusively by the Electron application）。

自建配置档（命令行能管的，例如本地开发用的 desktop-local）：

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

再把包名加进该配置档（~/.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 命令行已登录（museav login）。
插件自己不读也不转发 ~/.museav.json 里的 token。

接口

| 路由 | 做什么 |
| GET /api/dsh-museav-assets/health | 命令行在不在、什么版本、工作区上限 |
| 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 桥的约定一致。改它不用重载插件 —— 每次请求现取。