dsh-qoder-connect 0.2.0 → 0.2.2

package/README.en.md

@@ -42,6 +42,10 @@ The *“Qoder sidebar display”* card controls both widgets' visibility and the
 
 ![Sidebar display toggles](assets/3.png)
 
+### Settings inside the Plugins panel
+
+The same Qoder settings card has a second home: sidebar → **Plugins** panel → Installed → the *Qoder 连接器* card. Open the card's detail page and the full configuration sits between the description and the component list — PAT, per-variant switches, context windows, model toggles, check-in and sidebar-quota settings, identical to the *Settings → Plugin settings* card (both surfaces share one configuration). On hosts that do not declare the seat (older DSH), only the Settings entry exists and nothing else changes.
+
 ### Picking a model in a session
 
 Once a PAT is saved, the model picker gains a Qoder group with per-model rate multipliers (`x0.5`, `x0`, …):
@@ -64,6 +68,8 @@ Each variant card's *Context window* tab lists capacities per model under the *
 
 Both variant cards provide a *Model Toggles* tab (located between *Context window* and *Credit details*): search models on the fly, toggle individual models on or off, and use *Enable all* / *Disable all* batch buttons; hidden models will not appear in the session model picker.
 
+![Model toggles & batch controls](assets/8.png)
+
 ### Daily Auto Check-In & Check-In Log
 
 Enable daily automatic check-in in the settings card and set each variant's own moment (10:00 UTC+8 by default), then inspect check-in history logs, trigger a manual check-in, or clear logs in the *Check-in log* tab:
@@ -74,19 +80,30 @@ Enable daily automatic check-in in the settings card and set each variant's own
 
 Prerequisites:
 
-- DSH core `0.1.5-rc.1` or newer (this plugin peers on the `@deepseek-ai/*` `^0.1.5-rc.1` line);
+- DSH core `0.1.7-rc.1` or newer (this plugin peers on the `@deepseek-ai/*` `>=0.1.7-rc.1` line);
 - Node.js `^22.19.0 || >=24.0.0` (per `package.json` engines);
 - your own Qoder account and at least one Personal Access Token.
 
 ```sh
 # From GitHub (recommended)
 dsh plugin --profile web add github:masknull/dsh-qoder-connect
-# Or from npm, once published
+# Or from npm
 dsh plugin --profile web add dsh-qoder-connect
 ```
 
 Swap the `--profile` value for the profile you use (`web` / `desktop` / `tui`, e.g. `dsh plugin --profile desktop add dsh-qoder-connect`) — data stays inside that profile, so web / desktop / tui never collide. On a terminal-only profile (TUI) there is no browser card: manage the PAT and check status through the bundled CLI instead; the settings card and sidebar widgets require Web or Desktop.
 
+> **DSH older than `0.1.7-rc.1`?** Use **[v0.2.0](https://github.com/masknull/dsh-qoder-connect/releases/tag/v0.2.0)** instead — the last release supporting the 0.1.5 line (DSH ≥ `0.1.5-rc.2`):
+>
+> ```sh
+> # From GitHub (recommended, pin the tag)
+> dsh plugin --profile web add github:masknull/dsh-qoder-connect#v0.2.0
+> # Or from npm
+> dsh plugin --profile web add dsh-qoder-connect@0.2.0
+> ```
+>
+> Upgrading from 0.1.5? This release removed the automatic migration of the old host's `settings.yaml`. To carry your old configuration over, migrate through **[v0.1.9](https://github.com/masknull/dsh-qoder-connect/releases/tag/v0.1.9)** (the first release with the data migration) first, then upgrade to this release.
+
 ## Configuration
 
 ### Mint a PAT
@@ -98,7 +115,7 @@ Swap the `--profile` value for the profile you use (`web` / `desktop` / `tui`, e
 
 ### Save it on the card
 
-DSH → Settings → Plugins → the variant's card: paste the PAT into the password field and press *Save* (*“Validating and saving…”* while it runs). The token is validated against that variant's region first — a refusal saves nothing and the card says *“That PAT was rejected — generate a new one in your account settings and try again.”*. Do this on both cards to run both groups side by side.
+DSH → Settings → Plugin Settings (插件设置) → the Qoder card: paste the PAT into the password field and press *Save* (*“Validating and saving…”* while it runs). The token is validated against that variant's region first — a refusal saves nothing and the card says *“That PAT was rejected — generate a new one in your account settings and try again.”*. Do this on both cards to run both groups side by side.
 
 ### Environment-variable fallback
 

package/README.md

@@ -42,6 +42,10 @@
 
 ![侧栏展示开关设置](assets/3.png)
 
+### 插件面板内的设置入口
+
+同一张 Qoder 设置卡片还有第二个入口：左侧边栏「插件」面板 → 已安装 → 「Qoder 连接器」卡片，点开卡片详情页，完整设置就挂在插件的描述与组件列表之间（PAT、双区域开关、上下文窗口、模型开关、签到与侧栏额度设置，与「设置 → 插件设置」里完全一致，两处共用同一份配置）。宿主不提供该槽位时（旧版 DSH）只用「设置 → 插件设置」一个入口，功能不受影响。
+
 ### 会话内选择模型
 
 保存 PAT 后，模型选择器出现 Qoder 分组，模型名后跟随价格倍率（`x0.5`、`x0` 等）：
@@ -64,6 +68,8 @@
 
 两张变体卡片均提供「模型开关」页（位于「上下文窗口」与「额度明细」之间）：支持即时搜索模型、单独开启/关闭指定模型，以及全选后一键「批量开启」或「批量关闭」；关闭的模型不会出现在模型选择器中。
 
+![模型开关与批量控制](assets/8.png)
+
 ### 每日自动签到与签到日志
 
 支持在设置卡片中开启每日自动签到，并自定义各版本的签到时刻（默认 10:00，按 UTC+8）；在卡片底部的「签到日志」面板中查看签到流水、立即签到或清空日志：
@@ -74,19 +80,30 @@
 
 前置条件：
 
-- DSH 核心 `0.1.5-rc.1` 及以上（本插件 peer 依赖 `@deepseek-ai/*` `^0.1.5-rc.1` 线）；
+- DSH 核心 `0.1.7-rc.1` 及以上（本插件 peer 依赖 `@deepseek-ai/*` `>=0.1.7-rc.1` 线）；
 - Node.js `^22.19.0 || >=24.0.0`（`package.json` engines）；
 - 你自己的 Qoder 账号，以及至少一枚个人访问令牌。
 
 ```sh
 # 从 GitHub 安装（推荐）
 dsh plugin --profile web add github:masknull/dsh-qoder-connect
-# 或已发布 npm 后从 npm 安装
+# 或从 npm 安装
 dsh plugin --profile web add dsh-qoder-connect
 ```
 
 按你使用的 profile 换 `--profile` 的值（`web` / `desktop` / `tui`，如 `dsh plugin --profile desktop add dsh-qoder-connect`）。装到哪个 profile，数据就落在哪个 profile 目录里，web / desktop / tui 各自独立。没有浏览器卡片的终端环境（TUI）下依旧可用 CLI 保存 PAT 并驱动模型；设置卡片与侧栏额度卡需要 Web/Desktop 界面。
 
+> **DSH 低于 `0.1.7-rc.1`？** 请改用最后一个支持 0.1.5 线的版本 **[v0.2.0](https://github.com/masknull/dsh-qoder-connect/releases/tag/v0.2.0)**（要求 DSH ≥ `0.1.5-rc.2`）：
+>
+> ```sh
+> # GitHub（推荐，指定 tag）
+> dsh plugin --profile web add github:masknull/dsh-qoder-connect#v0.2.0
+> # 或从 npm 安装
+> dsh plugin --profile web add dsh-qoder-connect@0.2.0
+> ```
+>
+> 从 0.1.5 升级上来的老用户：本版本已移除旧宿主 `settings.yaml` 的自动迁移；如需保留旧配置，请先经 **[v0.1.9](https://github.com/masknull/dsh-qoder-connect/releases/tag/v0.1.9)**（首个带数据迁移的版本）完成迁移后，再升级本版本。
+
 ## 配置与使用
 
 ### 生成 PAT
@@ -98,7 +115,7 @@ dsh plugin --profile web add dsh-qoder-connect
 
 ### 在卡片上保存
 
-DSH → 设置 → 插件 → 对应卡片，展开后把 PAT 粘贴进密码输入框，点「保存」（期间显示「校验并保存中…」）。保存动作会先经 Qoder 校验令牌对该变体的区域有效，失败则不落盘并提示「PAT 无效或已过期 — 请到账号设置重新生成后再试。」两版各填各的卡片即可两组并存。
+DSH → 设置 → 插件设置 → Qoder 卡片，展开后把 PAT 粘贴进密码输入框，点「保存」（期间显示「校验并保存中…」）。保存动作会先经 Qoder 校验令牌对该变体的区域有效，失败则不落盘并提示「PAT 无效或已过期 — 请到账号设置重新生成后再试。」两版各填各的卡片即可两组并存。
 
 ### 环境变量兜底
 
@@ -119,13 +136,13 @@ DSH → 设置 → 插件 → 对应卡片，展开后把 PAT 粘贴进密码输
 
 ```text
 <profile>/.dsh-qoder-connect/
-├── .qoder-auth.json              # 中国版 PAT（{version:2, pat, region, savedAt}）
+├── .qoder-auth.json              # 国内版 PAT（{version:2, pat, region, savedAt}）
 ├── .qoder-global-auth.json       # 国际版 PAT
 ├── checkin-status.json           # 签到状态与历史日志记录
 └── state/
-    ├── .qoder-catalog.json       # 中国版按账号保存的模型目录
+    ├── .qoder-catalog.json       # 国内版按账号保存的模型目录
     ├── .qoder-global-catalog.json
-    ├── .qoder-probe.json         # 中国版推理档位探测记录
+    ├── .qoder-probe.json         # 国内版推理档位探测记录
     ├── .qoder-global-probe.json
     ├── .qoder-host-heartbeat.json    # host 心跳（doctor 判断宿主是否在跑）
     └── .qoder-machine-id         # 传输层机器标识种子（不落 ~/.qoder）

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { D as FALLBACK_QODER_MODELS, E as qoderCatalogPath, T as QoderCatalogStore, V as qoderCredentialIdentity, b as createQoderTransport, f as QODER_CONNECT_VERSION, i as variantFor, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, y as validateApiKey, z as QoderCredentialStore } from "./variants-DuEgaUad.js";
+import { D as FALLBACK_QODER_MODELS, E as qoderCatalogPath, T as QoderCatalogStore, V as qoderCredentialIdentity, b as createQoderTransport, f as QODER_CONNECT_VERSION, i as variantFor, l as qoderHostHeartbeatPath, m as QoderUpstreamClient, r as QODER_VARIANTS, s as isHeartbeatProcessAlive, t as CHINA_VARIANT, u as readHostHeartbeat, y as validateApiKey, z as QoderCredentialStore } from "./variants-CFI6-cGn.js";
 import { readFile } from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";