dsh-agy-link 0.6.5 → 0.6.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 (3) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +12 -0
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.6 (2026-11-08)
4
+
5
+ ### English
6
+
7
+ - **Docs: document the DSH 0.2.2 boot failure seen on 0.4.99 and the upgrade path (issue #86).**
8
+ - Users still on 0.4.99 (and earlier) can hit `web boot: 1 entry did not activate` with `locale "es" is already registered` after upgrading to DSH 0.2.2-rc.1: that client called `locale.addLanguage` unconditionally, and the host may have registered `es`/`pt-BR` first. Idempotent registration landed in **0.5.5** (#70/`31c99c1`), so the fix is an upgrade to ≥ 0.5.5; both FAQs now say so, in 中文 and English, together with the disable-plugin workaround.
9
+
10
+ ### 中文
11
+
12
+ - **文档:记录 0.4.99 在 DSH 0.2.2 下的启动失败与升级路径(issue #86)。**
13
+ - 仍在使用 0.4.99(及更早)的用户升级到 DSH 0.2.2-rc.1 后可能遇到 `web boot: 1 entry did not activate` 与 `locale "es" is already registered`:旧客户端无条件调用 `locale.addLanguage`,而宿主可能已先注册 `es`/`pt-BR`。幂等注册已在 **0.5.5**(#70/`31c99c1`)落地,升级到 ≥ 0.5.5 即可;中英 FAQ 均已补充该说明与「临时禁用插件」的兜底。
14
+
15
+ **Full Changelog**: https://github.com/amlyczz/dsh-agy-link/compare/v0.6.5...v0.6.6
16
+
3
17
  ## 0.6.5 (2026-11-07)
4
18
 
5
19
  ### English
package/README.md CHANGED
@@ -212,6 +212,12 @@ dsh plugin --profile web add dsh-agy-link
212
212
 
213
213
  ## ❓ 常见问题排查 (FAQ)
214
214
 
215
+ ### 升级到 DSH 0.2.2 后桌面端启动失败(`web boot: 1 entry did not activate` / `locale "es" is already registered`)?
216
+ **答:这是 0.4.99 及更早版本的兼容性问题,已在 0.5.5 修复(#70 / `31c99c1`),当前 0.6.x 不受影响。**
217
+ - **原因**:0.4.99 的客户端会无条件调用 `locale.addLanguage({ id: 'es' | 'pt-BR' })`。DSH 0.2.2 的宿主 locale 插件可能已先注册这些语言,于是抛出 `locale "es" is already registered`,插件前端条目激活失败并导致整个 web boot 失败(桌面端进不了聊天界面)。
218
+ - **处理**:把 `dsh-agy-link` 升级到 **≥ 0.5.5**(推荐当前 0.6.x)。新版注册前会检查宿主语言目录,仅容忍「已注册 / 已有词典」,卸载时也只清理自己拥有的注册项;宿主已注册 `es`/`pt-BR`(含 `ES`/`pt-br` 大小写变体)都可正常共存。
219
+ - **临时恢复**:若暂时无法升级,禁用该插件即可进入聊天界面。
220
+
215
221
  ### Windows 平台开始对话时为什么会短暂闪一下黑色命令行窗口(黑框)?
216
222
  **答:这是 Windows 系统的控制台分配机制,完全良性,不会影响对话和模型功能。**
217
223
  - **原因分析**:DSH 是基于 Electron 的图形桌面应用(GUI 进程),每次发起对话时,插件需要调用底层命令校验并同步当前账号在 Windows 凭据管理器(Credential Manager)中的 OAuth Token,随后启动 `agy.exe` 控制台子进程建立流式通信。在 Windows 11 下,系统默认终端若被设为「Windows 终端 (Windows Terminal)」,Windows Terminal 会拦截后台控制台子进程的句柄分配并闪现弹窗(这是 Windows Terminal 已知的 OpenConsole 委托拦截机制)。
@@ -454,6 +460,12 @@ you explicitly accept unattended tool execution.
454
460
 
455
461
  ## ❓ FAQ & Troubleshooting
456
462
 
463
+ ### Desktop app fails to boot after upgrading to DSH 0.2.2 (`web boot: 1 entry did not activate` / `locale "es" is already registered`)?
464
+ **A: That is a 0.4.99-and-earlier compatibility bug, fixed in 0.5.5 (#70 / `31c99c1`); current 0.6.x is unaffected.**
465
+ - **Cause**: the 0.4.99 client called `locale.addLanguage({ id: 'es' | 'pt-BR' })` unconditionally. DSH 0.2.2's host locale plugin may have registered those languages first, so the call threw `locale "es" is already registered`; the plugin's client entry failed to activate and took the whole web boot down (the desktop app could not reach the chat UI).
466
+ - **Fix**: upgrade `dsh-agy-link` to **≥ 0.5.5** (0.6.x recommended). Registration now inspects the host catalog, tolerates only "already registered / already has locale", and disposing removes only entries the plugin owns; host-registered `es`/`pt-BR` (including `ES`/`pt-br` case variants) coexist fine.
467
+ - **Workaround**: if you cannot upgrade yet, disable the plugin to reach the chat UI.
468
+
457
469
  ### Why does a black command prompt / terminal window briefly flash when starting a conversation on Windows?
458
470
  **A: This is a cosmetic behavior of the Windows Console subsystem and is completely harmless.**
459
471
  - **Root Cause**: DSH is an Electron desktop app (GUI process). Before each conversation turn, the plugin verifies/syncs Google credentials via the Windows Credential Manager and launches the `agy.exe` console child process for streaming. On Windows 11, if the system default terminal is set to "Windows Terminal", Windows Terminal intercepts the background console allocation and momentarily flashes an empty window (a known Windows Terminal OpenConsole delegation behavior).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-agy-link",
3
- "version": "0.6.5",
3
+ "version": "0.6.6",
4
4
  "description": "Google Antigravity (agy CLI) models for DeepSeek Harness — stream Gemini/Claude/GPT-OSS subscriptions into DSH with thinking, tool activity, token usage and in-GUI Google OAuth login.",
5
5
  "type": "module",
6
6
  "license": "MIT",