@eslaykey/dsh-breeze-tts 0.0.0-stage → 1.0.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/CHANGELOG.md ADDED
@@ -0,0 +1,28 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented here.
4
+ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning follows [SemVer](https://semver.org/).
5
+
6
+ ## [Unreleased]
7
+
8
+ ## [1.0.1] - 2026-10-30
9
+
10
+ ### Added
11
+ - API key binding directly in the settings page: paste a key, validate it against the account balance, and disconnect when needed
12
+ - Built-in tone names are localized (English UI shows Natural / Warm / Formal / Lively)
13
+
14
+ ### Fixed
15
+ - Emotion tags were counted against the auto-speak character limit and could be spoken aloud
16
+
17
+
18
+ ## [1.0.0] - 2026-10-30
19
+
20
+ ### Added
21
+ - Three agent tools: `tts_speak`, `tts_voices`, `tts_status`
22
+ - Settings page: voice, delivery preset, preview line, daily character limit, balance, usage bar
23
+ - One-click "read this reply" action on every finalized assistant message
24
+ - Auto-speak for replies within a configurable character limit (off by default)
25
+ - Voice design: generate three candidates from a text description, audition and save
26
+ - Sentence-level language detection so mixed Chinese/English text keeps the right accent
27
+ - Six built-in public voices across gender, age and accent
28
+ - Localized error messages with an API code map (auth, rate limit, credits, validation, daily quota)
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 eslaykey
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,85 @@
1
- # Temporary Holding Version
1
+ # Breeze 语音朗读 · DSH 插件
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 把 [Breeze Blue](https://breezeblue.ai) 的文字转语音接进 DeepSeek Harness:代理可以朗读,回复可以一键播放,音色和语气都能在设置页里调,还能用文字描述现捏一个新音色。
4
+
5
+ ## 安装
6
+
7
+ 装进当前 profile,然后重启 DSH:
8
+
9
+ ```bash
10
+ dsh plugin --profile <profile> add <package-name>
11
+ ```
12
+
13
+ 首次使用需要在设置里填 Breeze 的 API key(`brz_` 开头),获取地址:<https://breezeblue.ai/app/developer/api-keys>。
14
+
15
+ ## 能做什么
16
+
17
+ | 能力 | 位置 |
18
+ |---|---|
19
+ | `tts_speak` | 代理把一段文字念出来,也可以只落成文件 |
20
+ | `tts_voices` | 列出账号可用的音色,可按语言/关键词筛 |
21
+ | `tts_status` | 查当前音色、今日用量、剩余 credits |
22
+ | 回复朗读 | 每条助手回复下方的「朗读这条」 |
23
+ | 自动朗读 | 输入框下方状态条按设定字数自动念新回复(默认关) |
24
+ | 音色设置 | 设置 → 语音朗读:音色、语气、试听、每日上限、余额 |
25
+ | 音色设计 | 用一段文字描述生成三个候选音色,试听后可保存 |
26
+
27
+ ## 配置
28
+
29
+ 运行时配置写在 `~/.dsh/breeze.json`,插件补丁里的 `config` 只是出厂默认:
30
+
31
+ ```json
32
+ {
33
+ "apiKey": "brz_...",
34
+ "voiceId": "voc_xxxxxxxxxxxx",
35
+ "modelId": "breeze-tts-2",
36
+ "languageMode": "auto",
37
+ "dailyChars": 3000,
38
+ "autoSpeak": false,
39
+ "autoSpeakMaxChars": 120
40
+ }
41
+ ```
42
+
43
+ - `languageMode`:`auto` 按句识别中英混排,也可以写死 `zh` / `en`
44
+ - `dailyChars`:**硬闸门**,当天合成字数超了就拒绝,防止额度意外消耗
45
+ - `autoSpeakMaxChars`:只有不超过这个字数的回复才会被自动朗读
46
+
47
+ ## 费用
48
+
49
+ 按字符计费,10 个计费单位 = 1 credit,中日韩字符算 2 个单位。实测约 **0.19 credits / 汉字**。
50
+ 免费档每天可以在官网手动领 400 credits(≈2000 汉字)。插件自带两级闸门:单次字数限制 + 每日上限。
51
+
52
+ ## 隐私
53
+
54
+ 文字只发给 `api.breeze.blue` 做合成;生成的音频在本机缓存于 `~/.dsh/breeze-tts/`,不会上传到其他地方。API key 只保存在本机配置文件里。
55
+
56
+ ## 已知限制
57
+
58
+ - 朗读与自动朗读依赖本机播放能力,仅桌面端可用
59
+ - 自定义音色占用 Breeze 账号的音色槽(免费档 5 个)
60
+ - DSH 桌面版没有页面刷新,插件更新后需要重启
61
+
62
+ ## Troubleshooting
63
+
64
+ **安装时报 `ERR_PNPM_IGNORED_BUILDS`**
65
+
66
+ pnpm 12+ 只要依赖树里还有一个包的构建脚本“未表态”,就会让整个安装事务失败回滚——这时报错的包不一定是本插件。检查 profile 的 `pnpm-workspace.yaml`:
67
+
68
+ ```yaml
69
+ allowBuilds:
70
+ some-package@https://...: false # 必须是 true 或 false,不能留占位文本
71
+ ```
72
+
73
+ 把每个条目补成 `true` 或 `false` 后重试安装。
74
+
75
+ **装上之后没有声音**
76
+
77
+ 本插件的播放走宿主的系统播放器(Windows `winmm.PlaySound`),只接受 WAV。如果机器上没有可用的音频输出设备,或宿主进程被限制调用子进程,会失败但不报错。可以查看 `~/.dsh/breeze-tts/last-play.log` 确认播放器是否真的启动过。
78
+
79
+ **合成返回 401 / 403**
80
+
81
+ API key 无效或已过期。到 <https://breezeblue.ai/app/developer/api-keys> 重新生成,写进 `~/.dsh/breeze.json` 的 `apiKey`。
82
+
83
+ ## License
84
+
85
+ MIT