@mars-sea/dsh-commandcode-provider 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-09-15
+
+### Changed
+- **The sidebar plans & quota card is now off by default, with a switch to show it** ([#42](https://github.com/Mars-Sea/dsh-commandcode-provider/issues/42)). The card used to render unconditionally at the bottom of the sidebar. It is now opt-in: **Settings → Command Code → Advanced** carries a *"Show the quota card in the sidebar"* toggle (`showSidebarQuota`, default off). While hidden the card renders nothing at all — no card in the expanded sidebar and no icon in the 56px rail — and starts no background usage poll, so an unused panel costs nothing. The dashboard behind the card stays registered; with the card hidden it simply has no trigger. Saving the switch on shows the card again immediately, with no restart; an unsaved edit never moves it.
+
 ## [0.11.0] - 2026-09-15
 
 ### Added

package/README.md

@@ -27,7 +27,7 @@ Unofficial [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harnes
 - **Plan-aware picker** — models above your subscription tier are hidden by default (toggleable); an optional **Model allowlist** keeps only your favorites in the picker.
 - **Reasoning-effort support** — models with selectable reasoning effort levels expose them in the picker.
 - **Image input** — Vision-capable models accept images.
-- **Plans & quota panel** — a Command Code card at the bottom of the sidebar (directly above Settings) shows the serving account's plan and its 5-hour and weekly windows; clicking it opens a dashboard with the billing period, both windows as progress bars with reset times, monthly credit consumption, and the purchased/free balances. Needs dsh 0.1.5 (rc.1) or newer, and reads in English on every harness language.
+- **Plans & quota panel** — an optional Command Code card at the bottom of the sidebar (directly above Settings) shows the serving account's plan and its 5-hour and weekly windows; clicking it opens a dashboard with the billing period, both windows as progress bars with reset times, monthly credit consumption, and the purchased/free balances. **Off by default** — turn on *"Show the quota card in the sidebar"* under **Settings → Command Code → Advanced** to show it, and the same switch hides it again (a hidden card draws nothing at all and runs no background usage poll); the change lands as soon as you save. Needs dsh 0.1.5 (rc.1) or newer, and reads in English on every harness language.
 - **Session cost estimate** — published-rate estimates (`≈`) beside the composer token counter and in its usage dialog, using each request's model, request time and context tier from durable session history. Model switches and viewing the session later do not reprice earlier requests. Mixed-provider or unpriced usage shows a labeled subtotal (`≥`); missing history or wholly unpriceable usage stays hidden. These are estimates from the installed price snapshot, not provider invoices. Also English on every harness language.
 - **Web search** — the dsh `web_search` tool is backed by the Command Code Provider API (`/alpha/web-search`) with the same key/endpoint as chat, so no separate search key or base URL is needed. See [Web search](#web-search).
 
@@ -54,7 +54,7 @@ Pick the release line that matches your DeepSeek Harness version:
 **pnpm 11 holds back new releases.** Its `minimumReleaseAge` defaults to 1440 minutes, so a version published less than a day ago is skipped and `@latest` resolves to the *previous* release — silently, with a success exit code. To install a release from the last 24 hours, name it exactly:
 
 ```sh
-dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 The same applies to every profile you install into, including the terminal UI below.
@@ -73,7 +73,7 @@ dsh plugin --profile web update @mars-sea/dsh-commandcode-provider@0.9.1      #
 Each profile updates separately — the terminal UI owns its own plugin list (see below):
 
 ```sh
-dsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 To move to a version published less than 24 hours ago, name it exactly as in Install above; pnpm 11's age gate resolves `@latest` to the previous release instead.
@@ -102,7 +102,7 @@ After restart, enter your API key in **Settings → Command Code** and save; **S
 The plugin also works under a terminal front door. **Each dsh profile owns its own plugin list**, so the web install above does not reach the terminal — add the plugin to the `dsh-tui` profile as well:
 
 ```sh
-dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 Pin the exact version here. For the first 24 hours after a release, a bare package name (or `@latest`) is silently resolved to the previous one: the install succeeds, but the profile gets the older build — which is how a fresh terminal install ends up with no **`/settings` → Command Code** page and no `commandcode` models at all.
@@ -188,7 +188,7 @@ llm-commandcode:
 
 ## Configure
 
-**Settings → Command Code** covers the API key, API base URL, working directory, and request/stream timeouts; once a key is saved, a live **Account usage** card appears at the top of the page.
+**Settings → Command Code** covers the API key, API base URL, working directory, and request/stream timeouts; once a key is saved, a live **Account usage** card appears at the top of the page. The **Advanced** card holds the toggles — hide out-of-plan models, serve web search with Command Code, and show the quota card in the sidebar (off by default).
 
 The same options live in `$DSH_HOME/settings.yaml` (changes apply immediately, no restart):
 
@@ -200,6 +200,7 @@ llm-commandcode:
   modelsCachePath: ~/.commandcode/models-cache.json
   requestTimeoutMs: 60000          # default 60s
   streamIdleTimeoutMs: 300000      # default 300s
+  showSidebarQuota: true           # optional: show the plans & quota card in the sidebar (default off)
 ```
 
 ## Web search

package/README.zh-CN.md

@@ -27,7 +27,7 @@
 - **按套餐过滤**：默认隐藏超出订阅套餐的模型，可一键关闭；「模型白名单」可进一步只保留常用模型。
 - **推理强度支持**：支持推理强度的模型可在选择器中选择档位。
 - **图片输入**：Vision 模型支持发送图片。
-- **套餐与配额面板**：侧边栏底部（Settings 正上方）新增 Command Code 卡片，显示当前服务账号的套餐与 5 小时 / 每周两个配额窗口；点击后在中间栏打开面板，包含计费周期、两个窗口的进度条与重置时间、月度额度消耗，以及已购买 / 赠送余额。需要 dsh 0.1.5（rc.1）或更高版本；无论 Harness 语言如何，该面板固定为英文。
+- **套餐与配额面板**：可选的 Command Code 卡片位于侧边栏底部（Settings 正上方），显示当前服务账号的套餐与 5 小时 / 每周两个配额窗口；点击后在中间栏打开面板，包含计费周期、两个窗口的进度条与重置时间、月度额度消耗，以及已购买 / 赠送余额。**默认关闭**——在 **设置 → Command Code → 高级设置** 中打开「在侧边栏显示额度卡片」即可显示，同一开关也能随时隐藏（隐藏时左侧不渲染任何内容，也不会为其后台刷新用量）。需要 dsh 0.1.5（rc.1）或更高版本；无论 Harness 语言如何，该面板固定为英文。
 - **会话费用估算**：在输入框下方的 token 计数旁及用量对话框中显示估算金额（`≈`），根据持久化历史中每次请求的模型、请求时间和上下文阶梯分别计价。切换模型或稍后查看不会重新定价之前的请求。混合供应商或缺少费率时显示已定价部分的小计（`≥`）；缺少历史事实或完全无法定价时不显示金额。结果基于插件内的价格快照，不等同于供应商账单。同样固定为英文。
 - **联网搜索**：dsh 的 `web_search` 工具由 Command Code Provider API（`/alpha/web-search`）承载，复用聊天同一个 key 与端点，无需单独配置搜索 key 或地址。详见[联网搜索](#联网搜索)。
 
@@ -52,7 +52,7 @@
 **pnpm 11 会拦下刚发布的新版本。** 它的 `minimumReleaseAge` 默认为 1440 分钟，发布不足一天的版本会被跳过，`@latest` 解析到**上一个**版本 —— 而且是静默的，命令照样以成功退出。想装 24 小时内发布的版本，必须写精确版本号：
 
 ```sh
-dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 这一点对每个 profile 都成立，包括下面的终端界面。
@@ -71,7 +71,7 @@ dsh plugin --profile web update @mars-sea/dsh-commandcode-provider@0.9.1      #
 每个 profile 各自更新 —— 终端界面有独立的插件列表（见下文）：
 
 ```sh
-dsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile dsh-tui update @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 要更新到发布不足 24 小时的版本，和上面的安装一样写精确版本号；pnpm 11 的年龄门禁会把 `@latest` 解析成上一个版本。
@@ -100,7 +100,7 @@ cmd login        # macOS/Linux；Windows 原生版：cmdc login
 插件同样支持终端前端。**每个 dsh profile 有独立的插件列表**，所以上面那条 Web 安装命令不会装到终端里 —— 还要把插件装进 `dsh-tui` profile：
 
 ```sh
-dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.0
+dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.1
 ```
 
 这里请写精确版本号。新版本发布后的 24 小时内，只写包名（或 `@latest`）会被静默解析到上一个版本 —— 安装命令照样成功，但 profile 里拿到的是旧版本，结果就是全新的终端安装里既没有 **`/settings` → Command Code** 页面，也看不到任何 `commandcode` 模型。
@@ -186,7 +186,7 @@ llm-commandcode:
 
 ## 配置
 
-**设置 → Command Code** 可配置 API key、API 地址、工作目录与请求/流超时；配置好 key 后，页面顶部会显示实时「账户用量」卡片。
+**设置 → Command Code** 可配置 API key、API 地址、工作目录与请求/流超时；配置好 key 后，页面顶部会显示实时「账户用量」卡片。**高级设置**卡片里集中了各个开关：隐藏套餐外模型、用 Command Code 承载联网搜索，以及在侧边栏显示额度卡片（默认关闭）。
 
 同一组选项也位于 `$DSH_HOME/settings.yaml`（修改即刻生效，无需重启）：
 
@@ -198,6 +198,7 @@ llm-commandcode:
   modelsCachePath: ~/.commandcode/models-cache.json
   requestTimeoutMs: 60000          # 默认 60s
   streamIdleTimeoutMs: 300000      # 默认 300s
+  showSidebarQuota: true           # 可选：在侧边栏显示套餐与配额卡片（默认关闭）
 ```
 
 ## 联网搜索

package/lib/client.js

@@ -303,6 +303,7 @@ window.__ModuleLoader__.load({
 			}),
 			booleanField$1("filterModelsByPlan"),
 			booleanField$1("webSearch"),
+			booleanField$1("showSidebarQuota"),
 			textField("activeAccount")
 		];
 		/** Whether two model-id lists are equal as sets (order-insensitive). */
@@ -455,6 +456,8 @@ window.__ModuleLoader__.load({
 					streamIdleTimeoutMs: this.field("streamIdleTimeoutMs"),
 					filterModelsByPlan: this.field("filterModelsByPlan"),
 					webSearch: this.field("webSearch"),
+					showSidebarQuota: this.field("showSidebarQuota"),
+					sidebarQuota: this.sectionValue("showSidebarQuota") === true,
 					activeAccount: this.field("activeAccount"),
 					accounts,
 					accountsRemoving: [...this.removedRefs],
@@ -2291,7 +2294,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region package.json
-		var version = "0.11.0";
+		var version = "0.11.1";
 		var repository = {
 			"type": "git",
 			"url": "git+https://github.com/Mars-Sea/dsh-commandcode-provider.git"
@@ -2491,7 +2494,8 @@ window.__ModuleLoader__.load({
 			"requestTimeoutMs",
 			"streamIdleTimeoutMs",
 			"filterModelsByPlan",
-			"webSearch"
+			"webSearch",
+			"showSidebarQuota"
 		];
 		/** One labelled field row in the page body. */
 		function Field({ id, label, hint, state, disabled, numeric, placeholder, onEdit, onReset, t }) {
@@ -2543,11 +2547,12 @@ window.__ModuleLoader__.load({
 			return t("invalidNumber");
 		}
 		/**
-		* The collapsed "Advanced" card: API base, working dir, both timeouts, and
-		* the plan filter live here so the page leads with the facts a user actually
-		* touches. Starts collapsed on every visit; expands on demand. While
-		* collapsed, a badge names the customized count so a nonzero override stays
-		* visible (a number field's error blocks save and must be reachable).
+		* The collapsed "Advanced" card: API base, working dir, both timeouts, the
+		* plan filter, the web-search backend and the sidebar quota card live here so
+		* the page leads with the facts a user actually touches. Starts collapsed on
+		* every visit; expands on demand. While collapsed, a badge names the
+		* customized count so a nonzero override stays visible (a number field's error
+		* blocks save and must be reachable).
 		*/
 		function AdvancedSection({ state, disabled, t, onEdit, onReset }) {
 			const [expanded, setExpanded] = (0, react.useState)(false);
@@ -2654,6 +2659,17 @@ window.__ModuleLoader__.load({
 								onEdit: (text) => onEdit("webSearch", text),
 								onReset: () => onReset("webSearch"),
 								t
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToggleField, {
+								id: "cc-show-sidebar-quota",
+								label: t("showSidebarQuota"),
+								hint: t("showSidebarQuotaHint"),
+								state: state.showSidebarQuota,
+								disabled,
+								defaultChecked: false,
+								onEdit: (text) => onEdit("showSidebarQuota", text),
+								onReset: () => onReset("showSidebarQuota"),
+								t
 							})
 						]
 					}) : null,
@@ -4773,11 +4789,23 @@ window.__ModuleLoader__.load({
 		* matching the shell's own rail geometry. `wide` comes from the shell as an
 		* owner prop — unlike the old `sidebar.panellist` row, this slot really does
 		* supply it.
+		*
+		* Rendering is gated on the settings page's `showSidebarQuota` toggle, which
+		* defaults OFF: a fresh install shows no quota surface in the sidebar and runs
+		* no background poll. The gate reads the STORED document (the settings
+		* controller's `sidebarQuota` fact), so an unsaved draft cannot show the card,
+		* while a landed save flips it live. The entry is still REGISTERED — this is a
+		* render decision, not a slot registration, so nothing churns the slot ledger.
 		*/
 		function CommandCodeFooterEntry(props) {
+			const visible = props.useCommandCodeSettings((snapshot) => snapshot.sidebarQuota);
 			const view = usePanelView(props);
 			const startAutoRefresh = props.startAutoRefresh;
-			(0, react.useEffect)(() => startAutoRefresh(), [startAutoRefresh]);
+			(0, react.useEffect)(() => {
+				if (!visible) return void 0;
+				return startAutoRefresh();
+			}, [visible, startAutoRefresh]);
+			if (!visible) return null;
 			const text = (key) => view.text[key] ?? key;
 			const headline = view.footerBars[0];
 			const title = view.footTitle;
@@ -5787,7 +5815,7 @@ window.__ModuleLoader__.load({
 			streamIdleTimeoutMs: "流空闲超时（毫秒）",
 			streamIdleTimeoutMsHint: "生成流停滞多久视为断连；默认 300000（长思考模型可静默数分钟，默认值刻意放宽）。",
 			advancedSettings: "高级设置",
-			advancedSettingsHint: "API 地址、工作目录、超时与模型过滤等不常修改的选项。",
+			advancedSettingsHint: "API 地址、工作目录、超时、模型过滤、联网搜索与侧边栏额度卡片等不常修改的选项。",
 			advancedOverriddenOne: "已自定义 1 项",
 			advancedOverriddenMany: "已自定义 {count} 项",
 			advancedInvalid: "高级设置中有未填好的数字，请展开修正后再保存。",
@@ -5795,6 +5823,8 @@ window.__ModuleLoader__.load({
 			filterModelsByPlanHint: "开启后，模型选择器只列出当前套餐可用的模型；账户持有按需余额时会显示全部。",
 			webSearch: "用 Command Code 承载联网搜索",
 			webSearchHint: "开启后，dsh 的 web_search 工具由 Command Code 承担（复用同一个 API key 与地址），并优先于其他搜索后端；关闭则把选择权交还给之前的后端（如 modsearch），而不是强制回退到 DeepSeek 搜索。",
+			showSidebarQuota: "在侧边栏显示额度卡片",
+			showSidebarQuotaHint: "开启后，侧边栏底部（Settings 上方）显示 Command Code 套餐与配额卡片，点击可在中间栏打开完整仪表盘。默认关闭：左侧不显示任何额度信息，也不会为其后台刷新用量。保存后立即生效。",
 			accountsTitle: "多账户轮换",
 			accountsHint: "当前账户达到用量限额（429）或密钥失效（401）时，请求自动切换到下一个账户；全部耗尽时会提示最早的重置时间。",
 			accountAdd: "添加账户",
@@ -5919,7 +5949,7 @@ window.__ModuleLoader__.load({
 			streamIdleTimeoutMs: "Stream idle timeout (ms)",
 			streamIdleTimeoutMsHint: "How long a stalled stream is treated as dead; default 300000 (deliberately generous — long-thinking models can stay silent for minutes).",
 			advancedSettings: "Advanced",
-			advancedSettingsHint: "Rarely touched options: API base URL, working directory, timeouts, and model filtering.",
+			advancedSettingsHint: "Rarely touched options: API base URL, working directory, timeouts, model filtering, web search, and the sidebar quota card.",
 			advancedOverriddenOne: "1 customized",
 			advancedOverriddenMany: "{count} customized",
 			advancedInvalid: "A number in Advanced settings is not ready to save; expand to fix it.",
@@ -5927,6 +5957,8 @@ window.__ModuleLoader__.load({
 			filterModelsByPlanHint: "When on, the model picker lists only models your subscription includes; any on-demand credit balance shows the full catalog.",
 			webSearch: "Serve dsh web search with Command Code",
 			webSearchHint: "When on, the model-facing web_search tool is backed by Command Code (same API key and base URL as chat), winning over other search backends. Off hands the selection back to the previous backend (e.g. modsearch) instead of forcing the shipped DeepSeek search.",
+			showSidebarQuota: "Show the quota card in the sidebar",
+			showSidebarQuotaHint: "When on, a Command Code plan & quota card sits at the bottom of the sidebar (above Settings) and opens the full dashboard in the centre column. Off by default: nothing is shown on the left, and no background usage poll runs for it. Applies on save.",
 			accountsTitle: "Account rotation",
 			accountsHint: "When the active account hits its usage limit (429) or its key fails (401), requests switch to the next account; when every account is exhausted the error names the earliest window reset.",
 			accountAdd: "Add account",