dsh-muse-media 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +107 -2
- package/THIRD_PARTY_NOTICES.md +37 -0
- package/client.js +1933 -0
- package/cordis.patch.yml +37 -0
- package/docs/DETAIL.md +209 -0
- package/icon.svg +10 -0
- package/index.js +3440 -0
- package/lib/browser.js +769 -0
- package/lib/cdp.js +446 -0
- package/lib/muse.js +1489 -0
- package/lib/pool.js +682 -0
- package/lib/probe.js +503 -0
- package/lib/store.js +426 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +58 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-muse-media contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,108 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-muse-media
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
用你自己的 Muse 账号在 DeepSeek Harness 对话里生成图片和视频,并在输入框旁看到本周免费额度。
|
|
4
|
+
|
|
5
|
+
插件**自带浏览器驱动**:它通过 Chrome DevTools Protocol 操作本机已安装的 Chrome/Chromium/Edge。不需要 Python,不需要 muse2api,不需要装第二个插件。
|
|
6
|
+
|
|
7
|
+
## 前提
|
|
8
|
+
|
|
9
|
+
三样东西,缺一不可:
|
|
10
|
+
|
|
11
|
+
1. **Chrome / Chromium / Edge**(任一基于 Chromium 的浏览器)。插件不打包浏览器。
|
|
12
|
+
2. **DeepSeek Harness**,Node `^22.19.0 || >=24.0.0`。
|
|
13
|
+
3. **你自己的 Muse 个人账号**(免费账号即可)。插件只驱动你已经登录的浏览器,注册和登录都由你完成。
|
|
14
|
+
|
|
15
|
+
## 安装
|
|
16
|
+
|
|
17
|
+
在 Harness 里打开 **设置 → 插件 → 添加插件**,选择本目录,或安装 npm 包:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install dsh-muse-media
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
插件以 bundle 形式插入一行 Loader 条目。
|
|
24
|
+
|
|
25
|
+
## 更新
|
|
26
|
+
|
|
27
|
+
**从 npm 安装才会收到更新。** Harness 的插件管理器会去注册表查有没有更新版本,然后在设置页给出更新入口;用户点一下即可,不需要重装。
|
|
28
|
+
|
|
29
|
+
这一点只在**注册表形式**下成立。拖本地目录(`file:` / `link:`)安装的副本不会被标记为可更新,因为它的代码就在你的磁盘上,改了什么 Harness 无从得知;想跟新版本就重新 `npm install`。
|
|
30
|
+
|
|
31
|
+
维护者每次发布必须改 `version` 再 `npm publish`——版本号是唯一的判断依据,内容变了但版本号没动,对用户来说等于没有更新。
|
|
32
|
+
|
|
33
|
+
## 登录
|
|
34
|
+
|
|
35
|
+
1. 设置 → **Muse**。
|
|
36
|
+
2. 点「新增账号」,标签可留空(插件会自动命名)。
|
|
37
|
+
3. 点「打开登录窗口」。会弹出一个**可见的** Chrome 窗口,你在里面完成 muse.ai 登录。
|
|
38
|
+
4. 登录成功后设置卡会自动检测到(也可以点「验证登录」立即检查)。
|
|
39
|
+
|
|
40
|
+
每个账号有独立的浏览器数据目录:`<DSH_HOME>/muse-media/profiles/<accountId>/`。
|
|
41
|
+
凭据由 Chrome 自己保存,插件**不读取也不存储** cookie 或会话 token,账号索引里只有标签、状态、额度和使用记录。
|
|
42
|
+
|
|
43
|
+
## 三个页签
|
|
44
|
+
|
|
45
|
+
设置页分三栏,各自回答一个问题:
|
|
46
|
+
|
|
47
|
+
- **账号** — 现在用哪个账号、本周用了多少。点额度数字即可刷新;「新增账号」展开标签输入框。
|
|
48
|
+
- **记录** — 最近生成了什么、用哪个账号、耗时和额度消耗,附本周汇总。
|
|
49
|
+
- **高级** — 浏览器与超时的设置(改动立即生效,无需重启)、诊断信息、磁盘占用与媒体清理。
|
|
50
|
+
|
|
51
|
+
## 退登
|
|
52
|
+
|
|
53
|
+
- **关掉浏览器**:设置卡里的「关闭浏览器」。profile 还在,下次免登录。
|
|
54
|
+
- **彻底退出**:列表里的「删除」。会连同该账号的浏览器数据目录一起清除,之后需要重新登录。
|
|
55
|
+
- 想连额度记录一起清掉,再删 `<DSH_HOME>/muse-media/state.json`。
|
|
56
|
+
|
|
57
|
+
## 用法
|
|
58
|
+
|
|
59
|
+
对话里直接用工具:
|
|
60
|
+
|
|
61
|
+
- `muse_draw_image` — 文生图;传 `image`(本机路径、`file://`、data URL 或对话附件的 `attachmentId`)就是图生图,可给多张参考图。
|
|
62
|
+
- `muse_draw_video` — 文生视频;传 `image` 就用那张图当起始画面。多张参考图可以一起上传,但 Muse 只保证第一张作为起始画面,其余是否被采用没有文档说明。
|
|
63
|
+
- `muse_quota` — 读计划名、本周已用百分比、下次重置时间,另附独立的额外额度。
|
|
64
|
+
|
|
65
|
+
Muse 没有独立的视频模式:界面上只有一个对话框,「生成视频」靠提示词表达,所以时长和镜头要写进 `prompt`。
|
|
66
|
+
|
|
67
|
+
输入框旁的胶囊显示 `Muse · 周额度已用 25% · acc-01`,悬停看计划、重置时间、数据时间和当前账号身份。
|
|
68
|
+
|
|
69
|
+
## 账号是怎么选的
|
|
70
|
+
|
|
71
|
+
装多个账号时,插件按**周额度最早重置**的账号优先,其次才是用量和你的「同条件时优先」标记。理由是周额度到期即作废,而额外额度不会过期,所以先把会消失的花掉。
|
|
72
|
+
|
|
73
|
+
空闲时胶囊显示的是**你正在查看的账号**,下一次生成可能选另一个——悬停会说明这一点。
|
|
74
|
+
|
|
75
|
+
## 会消耗额度
|
|
76
|
+
|
|
77
|
+
每次生成都真实消耗该账号的 Muse 额度,和你在网页上手动点一次一样。
|
|
78
|
+
同一个提示词两次的结果不同——上游没有种子,插件也不提供种子控制。
|
|
79
|
+
上游限流或额度耗尽时本次任务停止,插件不会自动换号去绕(只在**登录失效**这一种情形下才允许换号)。
|
|
80
|
+
|
|
81
|
+
这个插件只消耗 Muse 账号的额度,不影响也不调用其他已安装的生图/视频插件。
|
|
82
|
+
|
|
83
|
+
## 边界
|
|
84
|
+
|
|
85
|
+
- 只驱动你自己装的浏览器,只在本机开调试端口(`127.0.0.1`)。
|
|
86
|
+
- 退出时只关闭**插件自己启动**的浏览器进程,不碰你的日常浏览器。
|
|
87
|
+
- 同时运行的浏览器数量有上限(默认 2),因为一个无头 Muse 页面约占 1 GB 内存。
|
|
88
|
+
- 已交付的媒体**不会自动删除**——它们是花额度换来的,且被对话里的消息引用。清理只有你点「清空已下载媒体」才会发生。
|
|
89
|
+
- 不提供:代理中转、签到领取、媒体库、缩略图、FFmpeg、画布、批量工作台。
|
|
90
|
+
- 对话只用于连通测试,不接入 Muse 的对话模型,也不适配它的工具调用。
|
|
91
|
+
|
|
92
|
+
## 配置
|
|
93
|
+
|
|
94
|
+
所有可调项都在 `cordis.patch.yml`,也在**设置 → Muse → 高级**里能改(保存后立即生效)。常用几项:
|
|
95
|
+
|
|
96
|
+
| 键 | 默认 | 说明 |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| `headlessAfterLogin` | `true` | 生成时不显示窗口;只有首次登录需要可见窗口 |
|
|
99
|
+
| `idleReapSeconds` | `600` | 浏览器闲置多久后关闭,`0` 不关 |
|
|
100
|
+
| `maxLiveBrowsers` | `2` | 同时运行的浏览器上限,`0` 不限制 |
|
|
101
|
+
| `imageTimeoutSeconds` | `300` | 生图等待上限 |
|
|
102
|
+
| `videoTimeoutSeconds` | `780` | 生视频等待上限 |
|
|
103
|
+
|
|
104
|
+
更多设计说明见 [`docs/DETAIL.md`](docs/DETAIL.md),参考来源见 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)。
|
|
105
|
+
|
|
106
|
+
## 许可
|
|
107
|
+
|
|
108
|
+
MIT。见 [`LICENSE`](LICENSE)。
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# 第三方来源声明
|
|
2
|
+
|
|
3
|
+
本插件自行实现。下列项目仅作为**行为参照**被阅读,未将代码复制、摘录或改写进本包。
|
|
4
|
+
|
|
5
|
+
| 项目 | 版本 / 提交 | 参照范围 | 实际纳入的材料 |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| [muse2api](https://github.com/czg86389-hub/muse2api) | `19db32a`(2026-11-16,MIT) | `engine.py` 的页面自动化流程(就绪判定、输入框定位、上传控件定位、附件就绪判据、额度面板遍历与解析、附件提取、发送动作)、`cdp.py` 的协议用法、`store.py` 的选号策略、`config.py` 的浏览器探测路径 | 无。仅取值与流程参照,代码按本包结构重写 |
|
|
8
|
+
| Trae 连接插件(本机已安装的第三方 DSH 插件) | 本机安装版本 | `settings.section` 的注册方式:`id` 由插件自己拥有,图标按同一 `id` 寻址 | 无。仅参照 DSH 的插槽用法 |
|
|
9
|
+
| WorkBuddy 连接插件(本机已安装的第三方 DSH 插件) | 本机安装版本 | Loopback/Origin 请求门禁的判定思路(`Host` 与实际落地地址比对,`Origin` 双检) | 无。判定条件按本插件需要重新编写 |
|
|
10
|
+
| DSH 官方文档与内置包源码 | 随本机 DSH 安装 | 插槽契约、`ToolDefinition`/`ToolOutputDefinition` 形状、`attachments.saveImage` 用法、主题 token | 无。接口按文档使用 |
|
|
11
|
+
|
|
12
|
+
## 文本比对结果
|
|
13
|
+
|
|
14
|
+
按目标书 G4 的要求,对本包源码与 `muse2api` 的 `engine.py`、`cdp.py`、`store.py`、`config.py` 做了逐行比对:
|
|
15
|
+
|
|
16
|
+
- 候选行:2,733 行(长度 ≥ 30 字符的行,以及长度 ≥ 6 且含中文的行)
|
|
17
|
+
- 参考文件:4 个
|
|
18
|
+
- 完全相同的行:**3 行**,全部是有意义的固定取值,不是逻辑代码:
|
|
19
|
+
|
|
20
|
+
| 本包位置 | 参考位置 | 内容 | 说明 |
|
|
21
|
+
|---|---|---|---|
|
|
22
|
+
| `lib/browser.js:43` | `engine.py` | `--autoplay-policy=no-user-gesture-required` | Chromium 启动开关,公开文档中的固定拼写 |
|
|
23
|
+
| `lib/browser.js:58` | `config.py` | `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome` | macOS 上 Chrome 的标准安装路径 |
|
|
24
|
+
| `lib/browser.js:64` | `config.py` | `/usr/bin/google-chrome-stable` | Linux 上 Chrome 的标准安装路径 |
|
|
25
|
+
|
|
26
|
+
三行都是浏览器自身的固定常量(一个官方命令行开关、两个官方安装路径),不构成可主张著作权的表达,也不需要随附许可声明。除此之外没有任何长行或中文注释与本包重合。
|
|
27
|
+
|
|
28
|
+
比对脚本与结果可用提交 `_compare.mjs`(开发期临时文件,不入包)复现。
|
|
29
|
+
|
|
30
|
+
## 许可
|
|
31
|
+
|
|
32
|
+
本包采用 MIT 许可,全文见 [`LICENSE`](LICENSE)。
|
|
33
|
+
上表所列项目均采用允许参照的许可(muse2api 为 MIT),但由于**未纳入任何代码**,本包不附带它们的许可声明。
|
|
34
|
+
|
|
35
|
+
## 商标
|
|
36
|
+
|
|
37
|
+
"Muse" 仅用于说明本插件兼容的产品(muse.ai)。本插件与该产品无隶属或授权关系,不使用其官方标识、品牌配色,也不做任何授权暗示。图标为本包自绘的几何图形。
|