dsh-deepseek-account 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.9 - 2026-09-13
+
+- Wait for both Connection and its HTTP server before registering the balance RPC, fixing missing routes after upgrading Harness; restore the route when the server restarts.
+- Add real Host lifecycle regression coverage for Harness 0.1.5-rc.2.
+- Declare compatibility with Harness 0.1.5-rc.2 and Cordis 4.0.2 alongside the existing versions.
+
 ## 0.1.8 - 2026-08-31
 
 - Override the Harness list-slot anchor's inline `display: contents` before stacking full-width sidebar footer actions, so the Cordis and account entries actually share a vertical flex container.

package/README.en.md

@@ -28,13 +28,13 @@ Only DeepSeek has a top-up entry. Grok uses the remaining percentage supplied by
 Requirements:
 
 - Node.js `>=22.19.0 <25`
-- DeepSeek Harness in the `0.1.1-rc.2` line
+- DeepSeek Harness `0.1.1-rc.2` or `0.1.5-rc.2` (live balance acceptance for this release used `0.1.5-rc.2`)
 - `DEEPSEEK_API_KEY` configured in Harness model settings when reading a DeepSeek balance
 
 Install the current stable version:
 
 ```sh
-dsh plugin --profile web add dsh-deepseek-account@0.1.8
+dsh plugin --profile web add dsh-deepseek-account@0.1.9
 dsh web
 ```
 

package/README.md

@@ -28,13 +28,13 @@ DeepSeek Harness 的独立账户插件：在一个侧栏入口中展示当前对
 运行环境：
 
 - Node.js `>=22.19.0 <25`
-- DeepSeek Harness `0.1.1-rc.2` 系列
+- DeepSeek Harness `0.1.1-rc.2` 或 `0.1.5-rc.2`（本次在 `0.1.5-rc.2` 完成真实余额验收）
 - 已在 Harness 模型设置中配置 `DEEPSEEK_API_KEY`（仅查看 DeepSeek 余额时需要）
 
 安装当前稳定版本：
 
 ```sh
-dsh plugin --profile web add dsh-deepseek-account@0.1.8
+dsh plugin --profile web add dsh-deepseek-account@0.1.9
 dsh web
 ```
 

package/dist/host/index.mjs

@@ -6,5 +6,10 @@ export const inject = ["credentials"]
 
 export function apply(ctx) {
   const accountBalance = createDeepSeekAccountBalance({ credentials: ctx.credentials })
-  ctx.inject(["connection"], (connectionCtx) => registerDeepSeekAccountRpc(connectionCtx, accountBalance))
+  // Connection can become ready before its HTTP carrier in newer Harness versions.
+  // Own the route in both services' lifetime so server reloads register it again.
+  ctx.inject(["connection", "webServer"], (connectionCtx) => {
+    // Connection already owns the registration effect in this injection fiber.
+    registerDeepSeekAccountRpc(connectionCtx, accountBalance)
+  })
 }

package/docs/ARCHITECTURE.md

@@ -30,6 +30,8 @@ current session list ── running true→false ──> one forced account refr
 
 `src/host/index.mjs` 是 npm 包的 Host 入口。它的接口只有 Harness 插件约定的 `name`、`inject` 和 `apply(ctx)`，负责组合 credential adapter、余额模块与 connection adapter，不包含浏览器 UI。
 
+HTTP RPC 注册必须同时等待 `connection` 和 `webServer`。新版 Harness 可先提供 Connection、后启动 HTTP carrier；仅等待 Connection 会让路由注册失败，客户端收到 HTTP 405。路由归属两项服务的注入生命周期，HTTP 服务重启时自动移除并重新注册。
+
 ### Account balance module
 
 `src/internal/account-balance.mjs` 隐藏 DeepSeek 请求、缓存、并发合并、错误分类和响应投影。它的接口是：

package/docs/MAINTAINING.md

@@ -18,6 +18,14 @@
 - Grok/Codex 必须保持可选，它们缺失时 DeepSeek 仍可工作。
 - 稳定版只承诺最新版本获得安全修复；破坏性变化需要在 README、CHANGELOG 和发布说明中突出。
 
+Host 生命周期回归使用真实 Cordis/Connection 模块，覆盖 HTTP 服务延迟启动、重启和插件卸载。CI 自动安装隔离的 0.1.5-rc.2 fixture；本地可复用已安装的 Harness：
+
+```sh
+DSH_TEST_NODE_MODULES=/absolute/path/to/harness/node_modules node --test test/host-runtime.test.mjs
+```
+
+未设置此变量时该项测试跳过，普通 `npm test` 通过不代表已完成 Host 兼容验证。此测试不读取真实凭据或请求官方 API。
+
 ## Pull Request review
 
 合并前确认：

package/docs/releases/v0.1.9.md

@@ -0,0 +1,52 @@
+## 中文
+
+`0.1.9` 修复升级 DSH 后 DeepSeek 账户页显示“暂时无法读取余额”、侧栏余额为空的问题。
+
+### 修复
+
+- 余额 HTTP RPC 同时等待 `connection` 和 `webServer`，并由 Connection 管理注册效果的生命周期，避免启动期间遗漏路由。
+- HTTP 服务重启时重新注册余额路由；插件卸载时清理路由。
+- peer dependency 声明新增 Harness `0.1.5-rc.2` 和 Cordis `4.0.2`，保留此前声明的版本。
+
+### 验证与范围
+
+- 12 项测试与构建通过；新增回归使用真实 Cordis/Connection 模块，覆盖 HTTP 服务晚启动、重启及插件卸载。
+- 独立安装的 Harness `0.1.5-rc.2` Host fixture 通过；CI 增加相同检查。
+- 本机 DeepSeek YukiRyou / DSH `0.1.5-rc.2` 已验证真实账户余额读取：侧栏和设置页均恢复，刷新可用。
+- 本次未重新完成旧版 Harness 的完整验收，也未验证其他账户插件或付款流程。
+
+安装：
+
+```sh
+dsh plugin --profile web add dsh-deepseek-account@0.1.9
+```
+
+安装后重启使用该 profile 的 DSH。
+
+<details>
+<summary>English release notes</summary>
+
+`0.1.9` fixes unavailable DeepSeek balances after a DSH upgrade, affecting both the account settings page and sidebar.
+
+### Fix
+
+- Wait for both `connection` and `webServer` before registering the balance HTTP RPC, leaving registration effects owned by Connection's lifecycle.
+- Restore the route after an HTTP server restart and remove it when the plugin unloads.
+- Add Harness `0.1.5-rc.2` and Cordis `4.0.2` to the declared peer versions while retaining the existing versions.
+
+### Verification and scope
+
+- All 12 tests and the build passed. The new regression uses real Cordis/Connection modules to cover delayed HTTP server startup, server restart, and plugin unload.
+- An independently installed Harness `0.1.5-rc.2` Host fixture passed; CI now runs the same check.
+- Live balance reads and refresh were verified in the installed DeepSeek YukiRyou application running DSH `0.1.5-rc.2`, in both the sidebar and settings page.
+- Full acceptance on older Harness versions, other account plugins, and payment flows was not repeated in this release.
+
+Install:
+
+```sh
+dsh plugin --profile web add dsh-deepseek-account@0.1.9
+```
+
+Restart the DSH instance using this profile after installation.
+
+</details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deepseek-account",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "DeepSeek account balance and official top-up entry for DeepSeek Harness",
   "type": "module",
   "license": "MIT",
@@ -59,14 +59,14 @@
     "prepack": "npm run check"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-credentials": "0.1.1-rc.2"
+    "@deepseek-ai/cordis": "4.0.1 || 4.0.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.1-rc.2 || 0.1.5-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.1-rc.2 || 0.1.5-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-connection": { "optional": true },