Saltar al contenido principal
S

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.

Instalar

dsh plugin --profile web add github:sizhe03/dsh-muse-media

README

dsh-muse-media

npm version npm downloads license DeepSeek Harness

用你自己的 Muse 账号在 DeepSeek Harness 对话里生成图片和视频,并在输入框旁看到本周免费额度。

English: README.en.md

插件自带浏览器驱动:通过 Chrome DevTools Protocol 操作本机已安装的 Chrome/Chromium/Edge。不需要 Python,不需要 muse2api,不需要装第二个插件,也不碰你日常浏览器的配置。

三个 Muse 账号及其周额度、输入框旁的额度胶囊,以及一帧生成结果

快速开始

npm install dsh-muse-media

然后在 Harness 里:设置 → Muse → 新增账号 → 打开登录窗口,在弹出的 Chrome 里登录 muse.ai 一次。

之后在对话里直接说「用 Muse 画一张……」即可。

前提

三样东西,缺一不可:

  1. Chrome / Chromium / Edge(任一基于 Chromium 的浏览器)。插件不打包浏览器。
  2. DeepSeek Harness 0.2.2-rc.5 或同一小版本线,Node ^22.19.0 || >=24.0.0。
  3. 你自己的 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、重试、改写提示词,全都不会恢复。 只有换账号。

怎样才能生视频(实测有效):

  1. 注册时的出口 IP 必须在支持地区。
  2. 使用时的出口 IP 也必须在支持地区。
  3. 出口要"真的"在支持地区——WebRTC 和 DNS 泄漏会让真实位置暴露。只挂代理而 WebRTC/DNS 走本地,等于没挂。
  4. 同一地区内切换(例如美国西雅图 ↔ 洛杉矶)不影响生成,实测未造成任何问题。

邮箱不限制:用任何邮箱注册都不影响功能完整性,关键是注册和使用时的地区。

插件能识别这类回复,会说清「绑定在账号上、换 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 → 高级里改(保存后立即生效)。常用几项:

键默认说明
headlessAfterLogintrue生成时不显示窗口;只有首次登录需要可见窗口
idleReapSeconds600浏览器闲置多久后关闭,0 不关
maxLiveBrowsers2同时运行的浏览器上限,0 不限制
imageTimeoutSeconds300生图等待上限
videoTimeoutSeconds780生视频等待上限

开发

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 时才跳过,并打印原因。

发版流程

先判断该不该发,再动手。 发版要同时满足两条:

  1. 累积到值得让人升级——修一处 bug、补一条测试、改一段文档,先做本地提交。攒到别人有理由升级时才发。
  2. 先问维护者,他同意才发。

这不是流程洁癖。这个项目曾在 6 小时内发过 17 版,平均 21 分钟一版,其中一半是"修上一版"——那是 0.0.x 的形态用了 1.0.x 的编号,而且每个中间态都成了永久可下载的版本。

确认要发之后:

  1. 改 package.json 的 version
  2. 在 CHANGELOG.md 加一节(不加则测试失败)
  3. npm test
  4. npm publish
  5. node scripts/sync-market-index.mjs(把新版本加进插件市场索引)
  6. 提交、打 v* 标签;标签会跑 CI 校验但不发布

第 6 步的提交要同时包含 package.json、CHANGELOG.md 和 market-index.json——分成两次会让中间那个 commit 在 CI 里必然失败。

文档

许可

MIT。见 LICENSE。

Plugins relacionados