dsh-muse-media
sizhe03/dsh-muse-media
Generates images and video from chat using your own Muse account's free weekly allowance, with no API key: it drives the Chrome you are already signed in to, and shows the remaining quota beside the composer. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
インストール
dsh plugin --profile web add github:sizhe03/dsh-muse-mediaREADME
dsh-muse-media
用你自己的 Muse 账号在 DeepSeek Harness 对话里生成图片和视频,并在输入框旁看到本周免费额度。
English: README.en.md
插件自带浏览器驱动:通过 Chrome DevTools Protocol 操作本机已安装的 Chrome/Chromium/Edge。不需要 Python,不需要 muse2api,不需要装第二个插件,也不碰你日常浏览器的配置。
快速开始
npm install dsh-muse-media
然后在 Harness 里:设置 → Muse → 新增账号 → 打开登录窗口,在弹出的 Chrome 里登录 muse.ai 一次。
之后在对话里直接说「用 Muse 画一张……」即可。
前提
三样东西,缺一不可:
- Chrome / Chromium / Edge(任一基于 Chromium 的浏览器)。插件不打包浏览器。
- DeepSeek Harness 0.2.2-rc.5 或同一小版本线,Node
^22.19.0 || >=24.0.0。 - 你自己的 Muse 个人账号(免费账号即可)。插件只驱动你已登录的浏览器,注册和登录都由你完成。
用法
对话里直接用工具:
muse_draw_image—— 文生图;传image(本机路径、file://、data URL 或对话附件的attachmentId)就是图生图,最多 10 张参考图。muse_draw_video—— 文生视频;传image就用那张图当起始画面。多张参考图可以一起上传,但 Muse 只保证第一张生效,其余是否被采用没有文档说明。muse_quota—— 读计划名、本周已用百分比、下次重置时间,另附独立的额外额度。
Muse 没有独立的视频模式:界面上只有一个对话框,「生成视频」靠提示词表达,所以时长和镜头要写进 prompt。
设置页
三个页签,各自回答一个问题:
- 账号 —— 现在用哪个账号、本周用了多少。点额度数字即可刷新;「新增账号」展开标签输入框。
- 记录 —— 最近生成了什么、用哪个账号、耗时和额度消耗,附本周汇总。
- 高级 —— 浏览器与超时的设置(改动立即生效,无需重启)、诊断信息、磁盘占用与媒体清理。
输入框旁的胶囊显示 Muse · 周额度已用 25% · acc-01,悬停看计划、重置时间、数据时间和当前账号身份。
账号是怎么选的
装多个账号时,插件按周额度最早重置的账号优先,其次才是用量和你的「同条件时优先」标记。理由是周额度到期即作废,而额外额度不会过期——先把会消失的花掉。
空闲时胶囊显示的是你正在查看的账号,下一次生成可能选另一个。悬停会说明这一点。
会消耗额度
每次生成都真实消耗该账号的 Muse 额度,和你在网页上手动点一次一样。
同一个提示词两次的结果不同——上游没有种子,插件也不提供种子控制。
上游限流或额度耗尽时本次任务停止,不会自动换号去绕过(只在登录失效这一种情形下才允许换号)。
⚠️ 生成失败的两个真实原因
Muse 会接受你的请求,然后什么都不生成。已知两种原因,处理方式完全不同:
一、内容没通过审核
性暗示、暴力等内容会被拒绝。
怎么办:改写提示词。原样重试不会成功。
插件现在能识别这类回复,会明确告诉你「提示词内容不符合它的内容政策」并附上页面原文。
二、视频生成受账号所在地区限制
图片不受此限制,视频受。 已知可用地区:美国、加拿大、日本、新加坡。
这是最容易被误判成"插件坏了"的一条。实际情况:
- Muse 后台返回 403,判定依据是账号所在的地区。
- 一旦账号被标记,就是永久的。 实测:七个账号运行两个月,六个稳定;一个注册时 IP 就不在支持地区,两个月过去视频生成仍然不可恢复,而这个账号的图片功能一直正常。
- 所以:换 IP、重试、改写提示词,全都不会恢复。 只有换账号。
怎样才能生视频(实测有效):
- 注册时的出口 IP 必须在支持地区。
- 使用时的出口 IP 也必须在支持地区。
- 出口要"真的"在支持地区——WebRTC 和 DNS 泄漏会让真实位置暴露。只挂代理而 WebRTC/DNS 走本地,等于没挂。
- 同一地区内切换(例如美国西雅图 ↔ 洛杉矶)不影响生成,实测未造成任何问题。
邮箱不限制:用任何邮箱注册都不影响功能完整性,关键是注册和使用时的地区。
插件能识别这类回复,会说清「绑定在账号上、换 IP 和重试都不会恢复」,并附上 Muse 的原话。
三、图片生成需要能连外网
图片不受地区限制,但插件操作的是 muse.ai 网页,必须能正常访问它。网络不通时任何生成都不会成功。
如果插件没认出来
Muse 的提示措辞可能变。插件没识别出上面两种情况时,超时错误里会附上页面末尾的文字——你能看到 Muse 到底说了什么,而不是只看到一句「超时」。
边界
- 只驱动你自己装的浏览器,只在本机开调试端口(
127.0.0.1)。 - 退出时只关闭插件自己启动的浏览器进程,不碰你的日常浏览器。
- 同时运行的浏览器数量有上限(默认 2),因为一个无头 Muse 页面约占 1 GB 内存。
- 已交付的媒体不会自动删除——它们是花额度换来的,且被对话里的消息引用。清理只有你点「清空已下载媒体」才会发生。
- 不提供:代理中转、签到领取、媒体库、缩略图、FFmpeg、画布、批量工作台。
- 对话只用于连通测试,不接入 Muse 的对话模型,也不适配它的工具调用。
- 这个插件只消耗 Muse 账号的额度,不影响也不调用其他已安装的生图/视频插件。
更新
从 npm 安装才会收到更新。 Harness 的插件管理器会去注册表查有没有更新版本,在设置页给出更新入口,点一下即可,不需要重装。
拖本地目录(file: / link:)安装的副本不会被标记为可更新——它的代码就在你的磁盘上。想跟新版本就重新 npm install dsh-muse-media。
配置
所有可调项都在 cordis.patch.yml,也能在设置 → Muse → 高级里改(保存后立即生效)。常用几项:
| 键 | 默认 | 说明 |
|---|---|---|
headlessAfterLogin | true | 生成时不显示窗口;只有首次登录需要可见窗口 |
idleReapSeconds | 600 | 浏览器闲置多久后关闭,0 不关 |
maxLiveBrowsers | 2 | 同时运行的浏览器上限,0 不限制 |
imageTimeoutSeconds | 300 | 生图等待上限 |
videoTimeoutSeconds | 780 | 生视频等待上限 |
开发
git clone https://github.com/sizhe03/dsh-muse-media.git
cd dsh-muse-media
npm test # 98 项:清单、索引、编码、主题变量、CI 结构、决策层、页面层、拒绝识别
npm run check # 语法检查 + 测试
测试覆盖的是能出错的判断,不是行数:版本号与 CHANGELOG 是否一致、市场索引能否通过 DSH 校验器、详情文档格式、主题变量在 Host 里是否存在、文本文件是否为合法 UTF-8、发布 job 有没有开关、以及 lib/pool.js 的选号与故障分类。
不覆盖 lib/muse.js 的页面操作(发送、上传、等待媒体)——那些依赖真实 muse.ai 页面结构。改动那部分请人工验证一次真实生成。
CI
两个工作流:
.github/workflows/ci.yml—— 每次 push 和 PR 都跑测试。不用等到发版才发现测试坏了。.github/workflows/publish.yml—— 只在v*标签上跑,校验版本一致后跳过发布(发布仍手动)。
CI 里装了真实 Chrome,因为页面层测试要驱动浏览器。如果 CI 里 Chrome 起不来,测试会失败而不是跳过——跳过会让 npm test 退出 0,等于什么都没验。本地没有 Chrome 时才跳过,并打印原因。
发版流程
先判断该不该发,再动手。 发版要同时满足两条:
- 累积到值得让人升级——修一处 bug、补一条测试、改一段文档,先做本地提交。攒到别人有理由升级时才发。
- 先问维护者,他同意才发。
这不是流程洁癖。这个项目曾在 6 小时内发过 17 版,平均 21 分钟一版,其中一半是"修上一版"——那是 0.0.x 的形态用了 1.0.x 的编号,而且每个中间态都成了永久可下载的版本。
确认要发之后:
- 改
package.json的version - 在
CHANGELOG.md加一节(不加则测试失败) npm testnpm publishnode scripts/sync-market-index.mjs(把新版本加进插件市场索引)- 提交、打
v*标签;标签会跑 CI 校验但不发布
第 6 步的提交要同时包含 package.json、CHANGELOG.md 和 market-index.json——分成两次会让中间那个 commit 在 CI 里必然失败。
文档
docs/DESIGN.md—— 设计与实现说明:发送边界、故障分类、选号逻辑、为什么某些限制是故意的THIRD_PARTY_NOTICES.md—— 参考来源
许可
MIT。见 LICENSE。