@yangzhenghan/dsh-bluewhale 0.3.1 → 0.3.2

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,47 +1,51 @@
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),听力才能用。
1
+ # blue whale
2
+
3
+ DeepSeek Harness(DSH)插件:桌面上的 Live2D 桌宠「大肥鱼」,和 DSH 里你选的那个会话说话。角色的回复会带着表情、动作回到桌宠,由桌宠念出来。第一次打开桌宠就是大肥鱼,不用自己导入模型。
4
+
5
+ 桌宠说的每句话,开头都带标签 `[from the blue whale]`。角色要知道「带这个标签的话该怎么回」(口语短句、写表情动作标记),所以**装好后要做一次**:
6
+ 1. 第一次启动后,打开 `C:\Users\你的用户名\.dsh\blue-whale\贴进记忆的桌宠规则.txt`,全选复制。
7
+ 2. 在 DSH 里把这段话发给你的角色,让它「记住这条规则」(或者贴进角色的人设 / 记忆)。
8
+
9
+ 只做一次,以后每句话都很短,不占会话长度。不想改记忆的话,在插件设置里把 `ruleMode` 改成 `prompt`:每句话自动附上规则,装上就能用,代价是每句多三百字左右。
10
+
11
+ ## 安装(在 DSH 里直接装)
12
+ 1. 打开 DSH 设置 → 插件,搜索 `@yangzhenghan/dsh-bluewhale`(或 `bluewhale`),点安装。
13
+ 2. 重启 DSH。
14
+ 3. **第一次会自动下载桌宠程序**(约 460MB,只下一次):右下角会弹出「正在下载桌宠」的通知,下好、解压完桌宠会自己出来,站在屏幕右下角。网速快几分钟,慢的话要久一点,这期间 DSH 照常能用。
15
+ - 先从 Gitee 下(国内不用梯子),不行再从 GitHub 下;下完会核对文件,下坏了不会装上。
16
+ - 下载失败(比如断网):重启 DSH 会接着下。
17
+
18
+ 只支持 Windows。需要 DeepSeek Harness 桌面版,并且已经登录、在 DSH 窗口里能正常聊天。
19
+
20
+ > 杀毒软件(360 等)可能误删桌宠里的文件,导致桌宠没有托盘图标、角色被关在小框里。可以把 `C:\Users\你的用户名\.dsh\blue-whale` 加入信任。
21
+
22
+ ## 手动安装(不想在线下载时)
23
+ 到 [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 份,合并方法看那边的说明。
24
+
25
+ ## 模型
26
+ - 内置模型是「大肥鱼」,已经加好表情动作、换装动作、说话口型,是桌宠的初始模型,也是唯一自带的模型(AIRI 官方的示例模型已去掉)。
27
+ - 大肥鱼模型经原作者授权二次发布。模型的版权属于原作者,请不要单独拿出模型另作他用。
28
+
29
+ ## 用法
30
+ - **拖动**:按住大肥拖动。只能在当前屏幕里拖,拖到别的屏幕会看不见,拖回来就好。
31
+ - **对桌宠说话**:右键桌宠,打开聊天或麦克风。
32
+ - **切换聊天**:右键桌宠 →「切换聊天」,会列出所有工作区里最近的会话,显示成「工作区名 · 会话标题」。选你平时和角色聊天的那个会话,桌宠就用那个角色的人设和记忆。
33
+ - **改表情规则**:改插件文件夹里的 `桌宠规则.md`,下一句话就生效。注意:在 DSH 里更新插件时这个文件会被换回默认的。
34
+
35
+ ## 设置(DSH 设置 → 插件 → blue whale)
36
+ | 设置 | 默认 | 说明 |
37
+ |---|---|---|
38
+ | `petTag` | `[from the blue whale]` | 桌宠消息开头的标签 |
39
+ | `ruleMode` | `tag` | `tag`:只带标签(规则要自己写进角色的记忆,见上面);`prompt`:每句附上规则 |
40
+ | `allWorkspaces` | 开 | 切换聊天时列出所有工作区的会话 |
41
+ | `workDir` | `文档\deepseek-harness\blue whale` | 选「新建会话」时,新会话建在这里 |
42
+ | `autoDownloadPet` | 开 | 没有桌宠程序时自动下载 |
43
+ | `airiExe` | 自动 | 桌宠程序的位置,一般不用改 |
44
+ | `port` | 18100 | 桌宠连接的端口 |
45
+
46
+ ## 要知道的
47
+ - **文件在哪**:自动下载的桌宠在 `C:\Users\你的用户名\.dsh\blue-whale\pet-版本号\`;日志 `dafei.log` 和当前会话 `state.json` 在 `C:\Users\你的用户名\.dsh\blue-whale\data\`。卸载插件后想彻底删掉,就把 `.dsh\blue-whale` 文件夹删了。
48
+ - **和 aurabot(QQ)一起用**:如果切换到 aurabot 建的 QQ 会话,对桌宠说的话的回复,aurabot 也会发到 QQ 上。
49
+ - **后续消息**:角色说完以后 1 分钟内补的话,比如提醒到点、主动搭话,桌宠也会念出来,一句一句地念。
50
+ - 用的是 18100 端口,别的程序占着这个端口时桌宠连不上。
51
+ - **国内用麦克风(0.3.1 起)**:桌宠判断「有没有人在说话」的语音检测模型原本要从 huggingface.co 下载,国内连不上,听力会卡在 Loading 或报 Failed to fetch。插件现在自带这个模型,在本机 18101 端口提供,并在打开桌宠前自动把桌宠里的下载地址改成本机。所以要从 DSH 里打开桌宠(不要单独打开 airi.exe),听力才能用。
package/cordis.patch.yml CHANGED
@@ -5,4 +5,4 @@
5
5
  config:
6
6
  port: 18100
7
7
  autoLaunchPet: true
8
- ruleMode: prompt
8
+ ruleMode: tag
package/index.js CHANGED
@@ -12,6 +12,7 @@ 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
14
  import { startModelServer, patchPetForChina } from './src/vad-mirror.js'
15
+ import { tagModeHint } from './src/pet-rules.js'
15
16
 
16
17
  // 桌宠程序在哪:整包里自带的「桌宠\airi.exe」 → 自动下载的 ~/.dsh/blue-whale/pet-版本\桌宠\airi.exe → 装在 Programs\airi 的
17
18
  // 都没有时用自动下载的位置(插件启动时会去下载)
@@ -27,8 +28,9 @@ const DEFAULTS = {
27
28
  allWorkspaces: true,
28
29
  // 桌宠说的话开头加的标签,角色靠它认出这是桌宠里当面说的
29
30
  petTag: '[from the blue whale]',
30
- // prompt = 每句话都附上「桌宠规则.md」;tag = 只带标签,规则由用户自己写进角色的人设或记忆
31
- ruleMode: 'prompt',
31
+ // tag(默认)= 只带标签,规则由用户自己写进角色的记忆或人设(启动时会生成一份可直接粘贴的规则)
32
+ // prompt = 每句话都附上「桌宠规则.md」,不用改记忆,但每句多三百字
33
+ ruleMode: 'tag',
32
34
  // 桌宠程序:优先用插件文件夹里自带的「桌宠\airi.exe」(下载整包就能用),没有就用装在 Programs\airi 的
33
35
  airiExe: BUNDLED_PET,
34
36
  autoLaunchPet: true,
@@ -64,7 +66,7 @@ export const Config = z
64
66
  workDir: z.string().default(DEFAULTS.workDir).description('新建会话放在哪个文件夹(工作区)'),
65
67
  allWorkspaces: z.boolean().default(DEFAULTS.allWorkspaces).description('切换聊天时列出所有工作区的会话'),
66
68
  petTag: z.string().default(DEFAULTS.petTag).description('桌宠消息开头的标签'),
67
- ruleMode: z.union(['prompt', 'tag']).default(DEFAULTS.ruleMode).description('prompt:每句附上桌宠规则.md;tag:只带标签,规则自己贴进角色记忆'),
69
+ ruleMode: z.union(['prompt', 'tag']).default(DEFAULTS.ruleMode).description('tag:只带标签,规则要贴进角色记忆(见 .dsh\\blue-whale\\贴进记忆的桌宠规则.txt);prompt:每句附上桌宠规则.md'),
68
70
  airiExe: z.string().default(DEFAULTS.airiExe).description('桌宠程序 airi.exe 的位置'),
69
71
  autoLaunchPet: z.boolean().default(DEFAULTS.autoLaunchPet).description('DSH 启动时打开桌宠'),
70
72
  autoDownloadPet: z.boolean().default(DEFAULTS.autoDownloadPet).description('没有桌宠程序时自动下载(约 460MB,只下一次)'),
@@ -93,6 +95,7 @@ export function apply(ctx, config = {}) {
93
95
  // 语音检测模型在本机提供,国内不用连 huggingface.co(src/vad-mirror.js)
94
96
  const modelServer = startModelServer()
95
97
  scheduleCookieCleanup(log)
98
+ tagModeHint(cfg, toast)
96
99
  if (cfg.autoLaunchPet) {
97
100
  // 从插件市场装的没有自带桌宠:第一次先下载(下载在后台进行,不耽误 DSH 启动)
98
101
  const ready = fs.existsSync(cfg.airiExe) || !cfg.autoDownloadPet || path.resolve(cfg.airiExe) !== path.resolve(PET_EXE)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yangzhenghan/dsh-bluewhale",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
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",
package/src/pet-rules.js CHANGED
@@ -1,10 +1,12 @@
1
1
  // 桌宠说的话交给会话前,加上开头标签(默认 [from the blue whale],不带时间)
2
- // prompt 模式(默认):标签 + 话 + 插件根目录「桌宠规则.md」的全文,每句都带
3
- // tag 模式:只带标签 + 话;规则由用户自己贴进角色的记忆 / AGENTS.md
2
+ // tag 模式(默认):只带标签 + 话;规则由用户自己贴进角色的记忆 / 人设
3
+ // 启动时把可直接粘贴的规则写到 ~/.dsh/blue-whale/贴进记忆的桌宠规则.txt,第一次还弹通知提醒
4
+ // prompt 模式:标签 + 话 + 插件根目录「桌宠规则.md」的全文,每句都带
4
5
  // 规则文件每次读,改完不用重启 DSH
5
6
  import fs from 'node:fs'
6
7
  import path from 'node:path'
7
- import { ROOT } from './state.js'
8
+ import os from 'node:os'
9
+ import { ROOT, loadState, saveState, log } from './state.js'
8
10
 
9
11
  export const RULES_FILE = path.join(ROOT, '桌宠规则.md')
10
12
 
@@ -22,3 +24,24 @@ export function petMessage(speech, cfg) {
22
24
  const rules = loadRules()
23
25
  return rules ? `${head}\n\n(${rules})` : head
24
26
  }
27
+
28
+ // 贴进角色记忆用的一段话:说明标签的意思 + 规则全文
29
+ export const MEMORY_RULE_FILE = path.join(os.homedir(), '.dsh', 'blue-whale', '贴进记忆的桌宠规则.txt')
30
+
31
+ export function memoryRuleText(cfg) {
32
+ return `桌宠当面语音回复约定:带 ${cfg.petTag} 标签的消息,是对方在桌宠面前当面对你说的话,按下面的规则回复。\n${loadRules()}`
33
+ }
34
+
35
+ // tag 模式:每次启动都把最新规则写一份到 .dsh\blue-whale;第一次额外弹通知,告诉用户要把它告诉角色
36
+ export function tagModeHint(cfg, notify) {
37
+ if (cfg.ruleMode !== 'tag') return
38
+ try {
39
+ fs.mkdirSync(path.dirname(MEMORY_RULE_FILE), { recursive: true })
40
+ fs.writeFileSync(MEMORY_RULE_FILE, '\ufeff' + memoryRuleText(cfg).replace(/\r?\n/g, '\r\n') + '\r\n')
41
+ } catch (e) {
42
+ return log('写贴进记忆的桌宠规则失败:', e.message)
43
+ }
44
+ if (loadState().tagHintShown) return
45
+ notify(`blue whale 用的是标签模式:请把「${MEMORY_RULE_FILE}」里的内容发给角色,让它记住(只需一次),桌宠的表情动作才会对。不想弄的话,在插件设置里把 ruleMode 改成 prompt。`)
46
+ saveState({ tagHintShown: true })
47
+ }