dsh-avatar-frame 0.11.4 → 0.11.6

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.
Files changed (5) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +10 -6
  3. package/locale/en.json +1 -1
  4. package/locale/zh.json +1 -1
  5. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,19 @@
2
2
 
3
3
  格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
4
4
 
5
+ ## [0.11.6] - 2026-10-25
6
+
7
+ ### 变更
8
+
9
+ - 插件描述开头加上「插件安装后重启 DSH 生效」，英文版同步。
10
+
11
+ ## [0.11.5] - 2026-10-25
12
+
13
+ ### 文档
14
+
15
+ - README 英文部分改用英文界面截图（`docs/images/*-en.png`）。
16
+ - 本次发布同时提供源码 zip，供不适用 git / npm 的环境直接解压安装。
17
+
5
18
  ## [0.11.4] - 2026-10-25
6
19
 
7
20
  ### 文档
package/README.md CHANGED
@@ -44,14 +44,14 @@
44
44
  ### 安装
45
45
 
46
46
  1. 打开 DeepSeek Harness → **插件 → 添加插件** → 输入本插件的 **包名**（`dsh-avatar-frame`，从 npm 拉取，最省事）、**GitHub 仓库地址**（`https://github.com/vioeveann/dsh-avatar-frame`）或**本地目录路径**；
47
- 2. 重启一次 DSH（「启动服务」那块跑在宿主端，只在启动时加载；界面部分刷新一下就行）。
47
+ 2. **重启一次 DSH**（必须）。安装、升级后都算：插件的前端模块和服务启动都在 DSH 启动时加载，只刷新页面往往不够，会出现「装上了、显示运行中，但聊天区没变化」。
48
48
 
49
49
  包名已发布到 npm：[`dsh-avatar-frame`](https://www.npmjs.com/package/dsh-avatar-frame)（国内可走 `registry.npmmirror.com` 镜像）。
50
50
 
51
51
  **装不上怎么办**
52
52
 
53
53
  - 用 **GitHub 地址**安装走的是 `git`，机器连不上 github.com 就会报 `ERR_PNPM_GIT_RESOLVE_FAILED`。先验证：`git ls-remote https://github.com/vioeveann/dsh-avatar-frame`；不通就配代理，或在 `hosts` 里给 `github.com` 指定一个可用 IP；
54
- - 完全绕开 `git`：GitHub 页面 → `Code` → **Download ZIP** → 解压 → 添加插件时填**解压后的本地目录**；
54
+ - 完全绕开 `git` 和 npm：直接下载 [v0.11.5 源码 zip](https://github.com/vioeveann/dsh-avatar-frame/releases/latest) → 解压 → 添加插件时填**解压后的本地目录**（也可以走 `Code` → **Download ZIP**）；
55
55
  - 用**包名**安装若提示找不到，先 `npm config get registry` 确认走的是官方源。
56
56
 
57
57
  ![插件详情页](docs/images/bundle.png)
@@ -150,7 +150,7 @@ PermissionError: [WinError 10013] 以一种访问权限不允许的方式做了
150
150
  - 头像只在**一轮结束后**出现，流式输出过程中没有——那需要接管整个回答渲染器，代价太大；
151
151
  - 与**同样接管 `turn-process`** 的其他插件会冲突；
152
152
  - 朗读按句切分，某一句失败会跳过继续读；
153
- - 「一键启动服务」的宿主端代码在 DSH 启动时加载，**升级插件后要重启一次 DSH**；
153
+ - 插件的前端模块与「一键启动服务」的宿主端代码都在 **DSH 启动时**加载：**安装或升级后必须重启 DSH**，只刷新页面可能没反应；
154
154
  - 该功能会**按你填写的命令执行本机程序**，请只填你自己的服务；路由走本机同源请求，没有额外鉴权，别把 DSH 暴露到公网；
155
155
  - 英文界面下「试听一句」会读英文例句，中文音色念英文可能带口音——那是模型的能力边界。
156
156
 
@@ -215,17 +215,17 @@ PermissionError: [WinError 10013] 以一种访问权限不允许的方式做了
215
215
  ### Install
216
216
 
217
217
  1. Open DeepSeek Harness → **Plugins → Add plugin** → enter this plugin's **package name** (`dsh-avatar-frame`), its **GitHub URL** (`https://github.com/vioeveann/dsh-avatar-frame`), or a **local directory path**;
218
- 2. Restart DSH once (the service launcher runs on the host side and is only loaded at startup; the UI part just needs a refresh).
218
+ 2. **Restart DSH** (required). This applies to installs and upgrades alike: both the client module and the service launcher load at DSH startup, and a page refresh alone is usually not enough — otherwise you get "installed and running, but the chat row looks unchanged".
219
219
 
220
220
  The package is published on npm as [`dsh-avatar-frame`](https://www.npmjs.com/package/dsh-avatar-frame) — installing by that name is the simplest route.
221
221
 
222
222
  **If installation fails**
223
223
 
224
224
  - Installing from a **GitHub URL** goes through `git`; if your machine can't reach github.com it fails with `ERR_PNPM_GIT_RESOLVE_FAILED`. Check with `git ls-remote https://github.com/vioeveann/dsh-avatar-frame`, then use a proxy or point `github.com` at a reachable IP in your hosts file;
225
- - To bypass `git` entirely: `Code` → **Download ZIP**, unzip it, and point "Add plugin" at the unzipped **local directory**;
225
+ - To bypass `git` and npm entirely: download the [source zip from the latest release](https://github.com/vioeveann/dsh-avatar-frame/releases/latest), unzip it, and point "Add plugin" at the unzipped **local directory** (the `Code` → **Download ZIP** route works too);
226
226
  - If the **package name** isn't found, check `npm config get registry` — it must be the official registry.
227
227
 
228
- ![Plugin page](docs/images/bundle.png)
228
+ ![Plugin page, English UI](docs/images/bundle-en.png)
229
229
 
230
230
  ### Usage
231
231
 
@@ -235,6 +235,8 @@ The package is published on npm as [`dsh-avatar-frame`](https://www.npmjs.com/pa
235
235
  4. Optionally save the combination as a preset (up to 8);
236
236
  5. Turn on "Read aloud" and click the speaker next to a reply.
237
237
 
238
+ ![Settings panel, English UI](docs/images/panel-en.png)
239
+
238
240
  ### Speech service
239
241
 
240
242
  The plugin never downloads a model or bundles a voice. It either uses the system voice or calls an HTTP service you provide. The default address is `http://127.0.0.1:8123` and can be changed in the panel, the plugin page or the settings page; a status dot shows connected / not connected and **retries every 8 seconds**, so start the service and watch it turn green — no refresh needed.
@@ -262,6 +264,8 @@ The command is yours: the plugin does not ship a service, it only executes and s
262
264
 
263
265
  Settings → **Character avatar**. Every key lives in this browser's `localStorage`: `image`, `id`, `size`, `presets`, `speech`, `engine`, `endpoint`, `rate`, `tone`, `lang` — all under the `dsh-avatar-frame/…/v1` prefix. Windows of the same browser stay in sync; clearing site data resets it, and there is no cloud sync.
264
266
 
267
+ ![Settings → Character avatar, English UI](docs/images/settings-en.png)
268
+
265
269
  ### Known limitations
266
270
 
267
271
  - **Web platform only**;
package/locale/en.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "meta": {
3
3
  "title": "Character avatar",
4
- "description": "Shows a character avatar and an editable ID beside every assistant reply, with saved avatar + ID presets you can switch between on this device. Any reply can be read aloud with the system voice or your own local TTS service (tone and speed adjustable), with a control bar for pause and sentence skipping. The plugin UI itself can switch between Chinese and English."
4
+ "description": "Restart DSH after installing. Shows a character avatar and an editable ID beside every assistant reply, with saved avatar + ID presets you can switch between on this device. Any reply can be read aloud with the system voice or your own local TTS service (tone and speed adjustable), with a control bar for pause and sentence skipping. The plugin UI itself can switch between Chinese and English."
5
5
  }
6
6
  }
package/locale/zh.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "meta": {
3
3
  "title": "角色头像框",
4
- "description": "在每轮 AI 回复左侧显示角色头像和可编辑的 ID；可保存多套头像+ID 预设随时切换，只保存在本机。回复可点小喇叭朗读：用系统语音，或调用你自己跑的本地 TTS 服务（支持语气与语速调节），带暂停、上一句/下一句的控制条，并可在弹窗里试听。；插件详情页、设置页与头像弹窗都有中文 / English 切换。"
4
+ "description": "插件安装后重启 DSH 生效。在每轮 AI 回复左侧显示角色头像和可编辑的 ID；可保存多套头像+ID 预设随时切换，只保存在本机。回复可点小喇叭朗读：用系统语音，或调用你自己跑的本地 TTS 服务（支持语气与语速调节），带暂停、上一句/下一句的控制条，并可在弹窗里试听；插件详情页、设置页与头像弹窗都有中文 / English 切换。"
5
5
  }
6
6
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-avatar-frame",
3
- "version": "0.11.4",
3
+ "version": "0.11.6",
4
4
  "type": "module",
5
5
  "description": "Character avatar, editable ID and read-aloud beside every assistant reply — system voice or your own local TTS service, with tone and speed controls, presets, a playback bar, one-click launching of your own TTS process, and a Chinese/English UI switch.",
6
6
  "license": "MIT",