@yangzhenghan/dsh-bluewhale 0.3.0 → 0.3.1

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/README.md CHANGED
@@ -1,46 +1,47 @@
1
- # blue whale
2
-
3
- DeepSeek Harness(DSH)插件:桌面上的 Live2D 桌宠「大肥鱼」,和 DSH 里你选的那个会话说话。角色的回复会带着表情、动作回到桌宠,由桌宠念出来。第一次打开桌宠就是大肥鱼,不用自己导入模型。
4
-
5
- 桌宠说的每句话,开头都带标签 `[from the blue whale]`,后面还附上一段表情动作规则(`桌宠规则.md`,大约三百字)。你的人设和记忆**一个字都不用改**,装上就能用。代价是每句话多三百字左右,聊得越多,会话越长。
6
-
7
- ## 安装(在 DSH 里直接装)
8
- 1. 打开 DSH 设置 → 插件,搜索 `@yangzhenghan/dsh-bluewhale`(或 `bluewhale`),点安装。
9
- 2. 重启 DSH。
10
- 3. **第一次会自动下载桌宠程序**(约 460MB,只下一次):右下角会弹出「正在下载桌宠」的通知,下好、解压完桌宠会自己出来,站在屏幕右下角。网速快几分钟,慢的话要久一点,这期间 DSH 照常能用。
11
- - 先从 Gitee 下(国内不用梯子),不行再从 GitHub 下;下完会核对文件,下坏了不会装上。
12
- - 下载失败(比如断网):重启 DSH 会接着下。
13
-
14
- 只支持 Windows。需要 DeepSeek Harness 桌面版,并且已经登录、在 DSH 窗口里能正常聊天。
15
-
16
- > 杀毒软件(360 等)可能误删桌宠里的文件,导致桌宠没有托盘图标、角色被关在小框里。可以把 `C:\Users\你的用户名\.dsh\blue-whale` 加入信任。
17
-
18
- ## 手动安装(不想在线下载时)
19
- 到 [GitHub](https://github.com/yangzhenghaniirs-code/blue-whale/releases/tag/v0.3.0) 或 [Gitee](https://gitee.com/yangzhenghan/blue-whale/releases/tag/v0.3.0) 下载整包,解压后在 DSH 设置 → 插件 → 按本地路径安装。Gitee 的整包拆成了 5 份,合并方法看那边的说明。
20
-
21
- ## 模型
22
- - 内置模型是「大肥鱼」,已经加好表情动作、换装动作、说话口型,是桌宠的初始模型,也是唯一自带的模型(AIRI 官方的示例模型已去掉)。
23
- - 大肥鱼模型经原作者授权二次发布。模型的版权属于原作者,请不要单独拿出模型另作他用。
24
-
25
- ## 用法
26
- - **拖动**:按住大肥拖动。只能在当前屏幕里拖,拖到别的屏幕会看不见,拖回来就好。
27
- - **对桌宠说话**:右键桌宠,打开聊天或麦克风。
28
- - **切换聊天**:右键桌宠 →「切换聊天」,会列出所有工作区里最近的会话,显示成「工作区名 · 会话标题」。选你平时和角色聊天的那个会话,桌宠就用那个角色的人设和记忆。
29
- - **改表情规则**:改插件文件夹里的 `桌宠规则.md`,下一句话就生效。注意:在 DSH 里更新插件时这个文件会被换回默认的。
30
-
31
- ## 设置(DSH 设置 → 插件 → blue whale)
32
- | 设置 | 默认 | 说明 |
33
- |---|---|---|
34
- | `petTag` | `[from the blue whale]` | 桌宠消息开头的标签 |
35
- | `ruleMode` | `prompt` | `prompt`:每句附上规则;`tag`:只带标签(规则要自己写进角色的人设或记忆) |
36
- | `allWorkspaces` | 开 | 切换聊天时列出所有工作区的会话 |
37
- | `workDir` | `文档\deepseek-harness\blue whale` | 选「新建会话」时,新会话建在这里 |
38
- | `autoDownloadPet` | 开 | 没有桌宠程序时自动下载 |
39
- | `airiExe` | 自动 | 桌宠程序的位置,一般不用改 |
40
- | `port` | 18100 | 桌宠连接的端口 |
41
-
42
- ## 要知道的
43
- - **文件在哪**:自动下载的桌宠在 `C:\Users\你的用户名\.dsh\blue-whale\pet-版本号\`;日志 `dafei.log` 和当前会话 `state.json` 在 `C:\Users\你的用户名\.dsh\blue-whale\data\`。卸载插件后想彻底删掉,就把 `.dsh\blue-whale` 文件夹删了。
44
- - **和 aurabot(QQ)一起用**:如果切换到 aurabot 建的 QQ 会话,对桌宠说的话的回复,aurabot 也会发到 QQ 上。
45
- - **后续消息**:角色说完以后 1 分钟内补的话,比如提醒到点、主动搭话,桌宠也会念出来,一句一句地念。
46
- - 用的是 18100 端口,别的程序占着这个端口时桌宠连不上。
1
+ # blue whale
2
+
3
+ DeepSeek Harness(DSH)插件:桌面上的 Live2D 桌宠「大肥鱼」,和 DSH 里你选的那个会话说话。角色的回复会带着表情、动作回到桌宠,由桌宠念出来。第一次打开桌宠就是大肥鱼,不用自己导入模型。
4
+
5
+ 桌宠说的每句话,开头都带标签 `[from the blue whale]`,后面还附上一段表情动作规则(`桌宠规则.md`,大约三百字)。你的人设和记忆**一个字都不用改**,装上就能用。代价是每句话多三百字左右,聊得越多,会话越长。
6
+
7
+ ## 安装(在 DSH 里直接装)
8
+ 1. 打开 DSH 设置 → 插件,搜索 `@yangzhenghan/dsh-bluewhale`(或 `bluewhale`),点安装。
9
+ 2. 重启 DSH。
10
+ 3. **第一次会自动下载桌宠程序**(约 460MB,只下一次):右下角会弹出「正在下载桌宠」的通知,下好、解压完桌宠会自己出来,站在屏幕右下角。网速快几分钟,慢的话要久一点,这期间 DSH 照常能用。
11
+ - 先从 Gitee 下(国内不用梯子),不行再从 GitHub 下;下完会核对文件,下坏了不会装上。
12
+ - 下载失败(比如断网):重启 DSH 会接着下。
13
+
14
+ 只支持 Windows。需要 DeepSeek Harness 桌面版,并且已经登录、在 DSH 窗口里能正常聊天。
15
+
16
+ > 杀毒软件(360 等)可能误删桌宠里的文件,导致桌宠没有托盘图标、角色被关在小框里。可以把 `C:\Users\你的用户名\.dsh\blue-whale` 加入信任。
17
+
18
+ ## 手动安装(不想在线下载时)
19
+ 到 [GitHub](https://github.com/yangzhenghaniirs-code/blue-whale/releases/tag/v0.3.0) 或 [Gitee](https://gitee.com/yangzhenghan/blue-whale/releases/tag/v0.3.0) 下载整包,解压后在 DSH 设置 → 插件 → 按本地路径安装。Gitee 的整包拆成了 5 份,合并方法看那边的说明。
20
+
21
+ ## 模型
22
+ - 内置模型是「大肥鱼」,已经加好表情动作、换装动作、说话口型,是桌宠的初始模型,也是唯一自带的模型(AIRI 官方的示例模型已去掉)。
23
+ - 大肥鱼模型经原作者授权二次发布。模型的版权属于原作者,请不要单独拿出模型另作他用。
24
+
25
+ ## 用法
26
+ - **拖动**:按住大肥拖动。只能在当前屏幕里拖,拖到别的屏幕会看不见,拖回来就好。
27
+ - **对桌宠说话**:右键桌宠,打开聊天或麦克风。
28
+ - **切换聊天**:右键桌宠 →「切换聊天」,会列出所有工作区里最近的会话,显示成「工作区名 · 会话标题」。选你平时和角色聊天的那个会话,桌宠就用那个角色的人设和记忆。
29
+ - **改表情规则**:改插件文件夹里的 `桌宠规则.md`,下一句话就生效。注意:在 DSH 里更新插件时这个文件会被换回默认的。
30
+
31
+ ## 设置(DSH 设置 → 插件 → blue whale)
32
+ | 设置 | 默认 | 说明 |
33
+ |---|---|---|
34
+ | `petTag` | `[from the blue whale]` | 桌宠消息开头的标签 |
35
+ | `ruleMode` | `prompt` | `prompt`:每句附上规则;`tag`:只带标签(规则要自己写进角色的人设或记忆) |
36
+ | `allWorkspaces` | 开 | 切换聊天时列出所有工作区的会话 |
37
+ | `workDir` | `文档\deepseek-harness\blue whale` | 选「新建会话」时,新会话建在这里 |
38
+ | `autoDownloadPet` | 开 | 没有桌宠程序时自动下载 |
39
+ | `airiExe` | 自动 | 桌宠程序的位置,一般不用改 |
40
+ | `port` | 18100 | 桌宠连接的端口 |
41
+
42
+ ## 要知道的
43
+ - **文件在哪**:自动下载的桌宠在 `C:\Users\你的用户名\.dsh\blue-whale\pet-版本号\`;日志 `dafei.log` 和当前会话 `state.json` 在 `C:\Users\你的用户名\.dsh\blue-whale\data\`。卸载插件后想彻底删掉,就把 `.dsh\blue-whale` 文件夹删了。
44
+ - **和 aurabot(QQ)一起用**:如果切换到 aurabot 建的 QQ 会话,对桌宠说的话的回复,aurabot 也会发到 QQ 上。
45
+ - **后续消息**:角色说完以后 1 分钟内补的话,比如提醒到点、主动搭话,桌宠也会念出来,一句一句地念。
46
+ - 用的是 18100 端口,别的程序占着这个端口时桌宠连不上。
47
+ - **国内用麦克风(0.3.1 起)**:桌宠判断「有没有人在说话」的语音检测模型原本要从 huggingface.co 下载,国内连不上,听力会卡在 Loading 或报 Failed to fetch。插件现在自带这个模型,在本机 18101 端口提供,并在打开桌宠前自动把桌宠里的下载地址改成本机。所以要从 DSH 里打开桌宠(不要单独打开 airi.exe),听力才能用。
Binary file
package/index.js CHANGED
@@ -11,6 +11,7 @@ import { log } from './src/state.js'
11
11
  import { ROOT } from './src/state.js'
12
12
  import fs from 'node:fs'
13
13
  import { ensurePet, toast, PET_EXE } from './src/pet-download.js'
14
+ import { startModelServer, patchPetForChina } from './src/vad-mirror.js'
14
15
 
15
16
  // 桌宠程序在哪:整包里自带的「桌宠\airi.exe」 → 自动下载的 ~/.dsh/blue-whale/pet-版本\桌宠\airi.exe → 装在 Programs\airi 的
16
17
  // 都没有时用自动下载的位置(插件启动时会去下载)
@@ -89,13 +90,20 @@ export function apply(ctx, config = {}) {
89
90
  const pet = createPetLauncher(cfg)
90
91
 
91
92
  server.start()
93
+ // 语音检测模型在本机提供,国内不用连 huggingface.co(src/vad-mirror.js)
94
+ const modelServer = startModelServer()
92
95
  scheduleCookieCleanup(log)
93
96
  if (cfg.autoLaunchPet) {
94
97
  // 从插件市场装的没有自带桌宠:第一次先下载(下载在后台进行,不耽误 DSH 启动)
95
98
  const ready = fs.existsSync(cfg.airiExe) || !cfg.autoDownloadPet || path.resolve(cfg.airiExe) !== path.resolve(PET_EXE)
96
99
  ? Promise.resolve()
97
100
  : ensurePet(toast)
98
- ready.then(() => pet.start()).catch((e) => log('✗ 打开桌宠出错:', e))
101
+ ready
102
+ .then(() => {
103
+ if (fs.existsSync(cfg.airiExe)) patchPetForChina(cfg.airiExe)
104
+ return pet.start()
105
+ })
106
+ .catch((e) => log('✗ 打开桌宠出错:', e))
99
107
  }
100
108
  log('blue whale插件已启动', { port: cfg.port, autoLaunchPet: cfg.autoLaunchPet })
101
109
  try {
@@ -107,6 +115,7 @@ export function apply(ctx, config = {}) {
107
115
  ctx.effect(() => async () => {
108
116
  pet.stop()
109
117
  await server.stop()
118
+ await modelServer.stop()
110
119
  log('blue whale插件已停止')
111
120
  }, 'dafei: server and pet')
112
121
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yangzhenghan/dsh-bluewhale",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "blue whale:DeepSeek Harness 的 Live2D 桌宠插件(大肥鱼),桌宠和 DSH 里的角色对话、带表情动作;第一次使用自动下载桌宠程序",
5
5
  "keywords": ["dsh-plugin", "deepseek-harness", "dsh", "live2d", "desktop-pet", "桌宠", "airi"],
6
6
  "license": "MIT",
@@ -13,6 +13,6 @@
13
13
  "./locale/*.json": "./locale/*.json",
14
14
  "./icon": "./icon.png"
15
15
  },
16
- "files": ["index.js", "src/*.js", "cordis.patch.yml", "locale/*.json", "icon.png", "桌宠规则.md", "README.md", "LICENSE"],
16
+ "files": ["index.js", "src/*.js", "assets/silero-vad.onnx", "cordis.patch.yml", "locale/*.json", "icon.png", "桌宠规则.md", "README.md", "LICENSE"],
17
17
  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
18
18
  }
@@ -0,0 +1,97 @@
1
+ // 国内能用的语音检测模型
2
+ // 桌宠听你说话前,要先用 Silero 小模型判断「有没有人在说话」,这个模型原本从 huggingface.co 下载,国内连不上,
3
+ // 听力就会卡在「Loading…」或报「Failed to fetch」「Audio detector fell behind」。
4
+ // 这里做两件事:
5
+ // 1. 插件自带模型文件(assets/silero-vad.onnx),在本机 127.0.0.1:18101 提供下载;其它文件转回 huggingface.co
6
+ // 2. 把桌宠程序里的下载地址 https://huggingface.co/ 换成 http://127.0.0.1:18101/(两者都是 23 个字符,原位替换)
7
+ // 改回去:把 app.asar 里的 http://127.0.0.1:18101/ 换回 https://huggingface.co/ 即可
8
+ import fs from 'node:fs'
9
+ import http from 'node:http'
10
+ import path from 'node:path'
11
+ import { fileURLToPath } from 'node:url'
12
+ import { log } from './state.js'
13
+
14
+ export const VAD_PORT = 18101
15
+ const OLD = Buffer.from('remoteHost: "https://huggingface.co/"')
16
+ const NEW = Buffer.from(`remoteHost: "http://127.0.0.1:${VAD_PORT}/"`)
17
+ const MODEL_FILE = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'assets', 'silero-vad.onnx')
18
+ const MODEL_PATH = '/onnx-community/silero-vad/resolve/main/onnx/model.onnx'
19
+
20
+ if (OLD.length !== NEW.length) throw new Error('vad-mirror:替换前后长度不一致')
21
+
22
+ const CORS = {
23
+ 'Access-Control-Allow-Origin': '*',
24
+ 'Access-Control-Allow-Headers': '*',
25
+ 'Access-Control-Allow-Private-Network': 'true',
26
+ 'Access-Control-Expose-Headers': 'Content-Length, ETag',
27
+ }
28
+
29
+ // 本机的小下载站:只认语音检测模型,其它请求转回 huggingface.co(和原来一样)
30
+ export function startModelServer() {
31
+ const server = http.createServer((req, res) => {
32
+ const url = new URL(req.url, 'http://127.0.0.1')
33
+ if (req.method === 'OPTIONS') {
34
+ res.writeHead(204, CORS)
35
+ return res.end()
36
+ }
37
+ if (url.pathname === MODEL_PATH && fs.existsSync(MODEL_FILE)) {
38
+ const size = fs.statSync(MODEL_FILE).size
39
+ res.writeHead(200, { ...CORS, 'Content-Type': 'application/octet-stream', 'Content-Length': size, ETag: '"silero-vad-bundled"' })
40
+ if (req.method === 'HEAD') return res.end()
41
+ return fs.createReadStream(MODEL_FILE).pipe(res)
42
+ }
43
+ res.writeHead(302, { ...CORS, Location: 'https://huggingface.co' + url.pathname + url.search })
44
+ res.end()
45
+ })
46
+ server.on('error', (e) => log('✗ 语音检测模型服务没启动(端口 ' + VAD_PORT + '):', e.message))
47
+ server.listen(VAD_PORT, '127.0.0.1', () => log('语音检测模型服务已启动:http://127.0.0.1:' + VAD_PORT))
48
+ return {
49
+ stop: () => new Promise((resolve) => server.close(() => resolve())),
50
+ }
51
+ }
52
+
53
+ // 在 app.asar 里找出所有旧地址(分块读,不把 500MB 一次读进内存)
54
+ function findAll(fd, size, needle) {
55
+ const CHUNK = 32 * 1024 * 1024
56
+ const buf = Buffer.alloc(CHUNK + needle.length)
57
+ const hits = []
58
+ for (let pos = 0; pos < size; pos += CHUNK) {
59
+ const n = fs.readSync(fd, buf, 0, Math.min(CHUNK + needle.length - 1, size - pos), pos)
60
+ const view = buf.subarray(0, n)
61
+ for (let i = view.indexOf(needle); i !== -1; i = view.indexOf(needle, i + 1)) {
62
+ if (i < CHUNK) hits.push(pos + i)
63
+ }
64
+ }
65
+ return hits
66
+ }
67
+
68
+ // 把桌宠程序里的模型下载地址换成本机的;已经换过就什么都不做
69
+ export function patchPetForChina(airiExe) {
70
+ const asar = path.join(path.dirname(airiExe), 'resources', 'app.asar')
71
+ if (!fs.existsSync(asar)) return log('找不到桌宠的 app.asar,跳过语音检测模型修补:', asar)
72
+ // 检查过的 app.asar 记下大小和修改时间,没变就不再扫一遍 500MB
73
+ const mark = asar + '.vad-checked'
74
+ const stamp = (st) => `${st.size}:${Math.floor(st.mtimeMs)}`
75
+ try {
76
+ if (fs.readFileSync(mark, 'utf8') === stamp(fs.statSync(asar))) return
77
+ } catch {}
78
+ let fd
79
+ try {
80
+ fd = fs.openSync(asar, 'r+')
81
+ const size = fs.fstatSync(fd).size
82
+ const hits = findAll(fd, size, OLD)
83
+ if (hits.length) {
84
+ for (const at of hits) fs.writeSync(fd, NEW, 0, NEW.length, at)
85
+ log(`已把桌宠的语音检测模型地址换成本机(${hits.length} 处)`)
86
+ } else {
87
+ log(findAll(fd, size, NEW).length ? '桌宠的语音检测模型地址已经是本机的了' : '桌宠程序里没找到模型下载地址,跳过修补')
88
+ }
89
+ fs.closeSync(fd)
90
+ fd = undefined
91
+ fs.writeFileSync(mark, stamp(fs.statSync(asar)))
92
+ } catch (e) {
93
+ log('✗ 修补桌宠的语音检测模型地址失败(桌宠开着时改不了,关掉桌宠后重启 DSH 会再试):', e.message)
94
+ } finally {
95
+ if (fd !== undefined) fs.closeSync(fd)
96
+ }
97
+ }