@khorsheed/dsh-context-guard 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 变更记录
 
+## 0.2.7（2026-10-26）
+
+- **README 更新**：设置截图换成新版「插件 → 内置插件配置 → 压缩提醒时机」两张，文字改为大白话。无功能变更。
+
+## 0.2.6（2026-10-24）
+
+- `dsh.references` 去掉已退役的 `@khorsheed/dsh-bundle-conversation-toolbox`(其成员全部并入 basic)。
+
 ## 0.2.5（2026-10-22）
 
 - **设置卡回归插件页**：家族/模式 bundle 折叠后阈值设置卡整体失声——`plugins.row.config` 的键钉死了旧载体 bundle（成员行现由模式包承载，键永不命中），0.1.5 座位 `settings.plugin.item` 已被宿主改名删除（现名 `plugins.item`），鸭式老臂静默失效。现在改为注册一个 `plugins.item` 列表条目并以 `configForms.whileServed` 门在服役中的 `context-guard` 命名空间上：独立安装、家族 bundle、模式包三种形态同一张卡，组合摘掉该行时卡也干净消失。代价：宿主 <0.1.7-alpha.1 不再渲染设置卡（输入框压缩按钮等其余面不变，已记入 README 兼容节与 `dsh.compat.notes`）。见 [Agent Note](../../.agents/notes/implemented/bug-fix/2026-10-18-bundle-member-config-card-via-plugins-item.md)

package/README.en.md

@@ -6,7 +6,7 @@ A "compact now" button that shows up in the composer before your context runs ou
 
 The longer a conversation runs, the fuller the context gets — and at the far end the provider starts rejecting requests outright. That wall arrives earlier than the 100% the context ring suggests, because every request also reserves room for the output. This plugin's job is simple: once occupancy crosses the ratio you set, an amber button appears in the composer's toolbar, and clicking it is the same as typing `/compact` yourself. It never compacts for you — it just reminds you while you still can.
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-button.png" width="640" alt="the compact button appears in the composer toolbar once context occupancy crosses the configured ratio">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-button.png" width="560" alt="the compact button appears in the composer toolbar once context occupancy crosses the configured ratio">
 
 ## Features
 
@@ -15,8 +15,6 @@ The longer a conversation runs, the fuller the context gets — and at the far e
 - **Runs the official `/compact`** — idle-gating, the compaction lock, and presentation stay host-owned; a click behaves exactly like the typed command.
 - **One live tunable** — the reminder threshold, editable in settings with no restart.
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-settings.png" width="640" alt="the trigger ratio is configurable in settings (0.01–1)">
-
 ## Install
 
 ```sh
@@ -33,6 +31,10 @@ dsh plugin --profile web remove @khorsheed/dsh-context-guard
 
 One tunable, editable in the GUI and live with no restart — on 0.1.5 under Settings → Plugins ("压缩提醒时机 / Compaction reminder timing"); on 0.1.6-alpha.2+ in the bundle's own configuration section on its Plugins-page detail view.
 
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-config-1.png" width="560" alt="The Plugins page's built-in plugin settings: the last card is Compaction reminder timing">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-config-2.png" width="560" alt="The Compaction reminder timing detail page: the reminder ratio set to 0.3 (customized), range 0.01–1, with Reset">
+
 | Key | Default | Meaning |
 |---|---|---|
 | `thresholdRatio` | `0.8` | Context occupancy fraction at which the button appears (clamped to (0, 1]). Lower it to be reminded earlier — the provider rejection wall sits below 100% occupancy (see *How it works*). |

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/context-guard/README.en.md
-packages/context-guard/README.en.md: afd1d0c450b5e2916377d10a59b537b6fbff9d6f
-packages/context-guard/README.md: ffbb010a2301151f96626f35c72c3208bd523bad
+packages/context-guard/README.en.md: 22b915c36929319553c65fac2892efeaaa8ec4af
+packages/context-guard/README.md: 915c4eb527d89be0c4bc6f6d48878e1ec37592f1

package/README.md

@@ -6,7 +6,7 @@
 
 聊得越久，上下文占用越高，涨到头 provider 会直接拒收请求——这堵墙比进度环的 100% 来得更早（请求还要给输出留位置）。这个插件就是干这个的：占用一过你设的比例，输入框工具栏里就出现一枚琥珀色按钮，点一下等于亲手输入 `/compact`。它不替你自动压缩，只在你还来得及的时候提醒你。
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-button.png" width="640" alt="上下文占用越过配置比例后，输入框工具栏里出现琥珀色的压缩按钮">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-button.png" width="560" alt="上下文占用越过配置比例后，输入框工具栏里出现琥珀色的压缩按钮">
 
 ## 功能
 
@@ -15,7 +15,6 @@
 - **执行官方 `/compact`**——空闲门控、压缩锁和流程展示都由宿主负责，点击的效果和手打命令一模一样。
 - **一个实时可调项**——提醒阈值在设置里改，保存即生效，不用重启。
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-settings.png" width="640" alt="提醒比例可在设置中按偏好调整（0.01–1）">
 
 ## 安装
 
@@ -33,6 +32,10 @@ dsh plugin --profile web remove @khorsheed/dsh-context-guard
 
 一个可调项，在 GUI 里改且实时生效，无需重启——0.1.5：设置 → 插件配置 →「压缩提醒时机 / Compaction reminder timing」；0.1.6-alpha.2 起：插件管理页 → 本包详情页的配置区。
 
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-config-1.png" width="560" alt="「插件」页的「内置插件配置」：最后一张是「压缩提醒时机」卡片">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-basic/main/docs/screenshots/context-guard-config-2.png" width="560" alt="「压缩提醒时机」详情页：提醒比例改成 0.3（已自定义），可配置范围 0.01–1，旁边是重置">
+
 | 键 | 默认值 | 含义 |
 |---|---|---|
 | `thresholdRatio` | `0.8` | 压缩按钮出现时的上下文占用比例（限制在 (0, 1]）。想更早收到提醒就调低——provider 拒绝墙在 100% 占用之下（见「实现原理」）。 |

package/lib/client.js

@@ -207,11 +207,11 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var CompactGuardButton_module_css_default = {
-			"icon": "BFFw2a_icon",
 			"warning": "BFFw2a_warning",
-			"wrap": "BFFw2a_wrap",
 			"button": "BFFw2a_button",
-			"error": "BFFw2a_error"
+			"error": "BFFw2a_error",
+			"wrap": "BFFw2a_wrap",
+			"icon": "BFFw2a_icon"
 		};
 		//#endregion
 		//#region src/client/CompactGuardButton.tsx
@@ -290,28 +290,28 @@ window.__ModuleLoader__.load({
 		}
 		var SettingsCard_module_css_default = {
 			"badge": "DKjZXq_badge",
-			"hint": "DKjZXq_hint",
-			"fieldHead": "DKjZXq_fieldHead",
-			"footer": "DKjZXq_footer",
-			"saved": "DKjZXq_saved",
-			"secondary": "DKjZXq_secondary",
-			"chevron": "DKjZXq_chevron",
-			"description": "DKjZXq_description",
+			"inputRow": "DKjZXq_inputRow",
 			"headText": "DKjZXq_headText",
-			"save": "DKjZXq_save",
-			"field": "DKjZXq_field",
-			"reset": "DKjZXq_reset",
 			"inputInvalid": "DKjZXq_inputInvalid",
+			"reset": "DKjZXq_reset",
+			"header": "DKjZXq_header",
+			"chevronOpen": "DKjZXq_chevronOpen",
+			"fieldName": "DKjZXq_fieldName",
+			"fieldHead": "DKjZXq_fieldHead",
+			"chevron": "DKjZXq_chevron",
 			"name": "DKjZXq_name",
+			"description": "DKjZXq_description",
 			"input": "DKjZXq_input",
-			"chevronOpen": "DKjZXq_chevronOpen",
+			"hint": "DKjZXq_hint",
 			"status": "DKjZXq_status",
-			"header": "DKjZXq_header",
-			"cardOpen": "DKjZXq_cardOpen",
 			"errorText": "DKjZXq_errorText",
-			"inputRow": "DKjZXq_inputRow",
+			"field": "DKjZXq_field",
+			"footer": "DKjZXq_footer",
+			"secondary": "DKjZXq_secondary",
+			"save": "DKjZXq_save",
+			"saved": "DKjZXq_saved",
+			"cardOpen": "DKjZXq_cardOpen",
 			"body": "DKjZXq_body",
-			"fieldName": "DKjZXq_fieldName",
 			"card": "DKjZXq_card"
 		};
 		//#endregion

package/lib/types/client/icons.d.ts

@@ -1,6 +1,6 @@
 /**
  * Generated by scripts/sync-icon-artwork.mts from @deepseek-ai/dsh-client-ui-primitives
- * (v0.1.7-rc.1, harness 46a7f68b09) — do not edit by hand. The 0.1.5 and rc.1 host lines
+ * (v0.2.1-rc.1, harness 1600d8a1e1) — do not edit by hand. The 0.1.5 and rc.1 host lines
  * share no icon export name, so the rc.1 artwork is inlined here: pure SVG,
  * no host runtime identity, identical on every line. Re-run the generator
  * after adding an icon import or bumping the harness checkout.
@@ -14,6 +14,5 @@ export interface IconProps {
     /** Extra class for layout placement; color rides currentColor. */
     className?: string | undefined;
 }
-export declare const IconChevronDownOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
 export declare const IconWarningOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
 //# sourceMappingURL=icons.d.ts.map

package/lib/types/client/icons.js

@@ -1,3 +1,2 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export const IconChevronDownOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6", stroke: "currentColor" }) }));
 export const IconWarningOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M8 14.5C11.5899 14.5 14.5 11.5899 14.5 8C14.5 4.41015 11.5899 1.5 8 1.5C4.41015 1.5 1.5 4.41015 1.5 8C1.5 11.5899 4.41015 14.5 8 14.5Z", stroke: "currentColor" }), _jsx("path", { d: "M8 4.29199V9.79199", stroke: "currentColor" }), _jsx("path", { d: "M8 10.708V11.708", stroke: "currentColor" })] }));

package/lib/types/client/index.d.ts

@@ -7,7 +7,7 @@
  * card editing the same number live: a `plugins.item` entry on the Plugins
  * page gated by `configForms.whileServed` on the `context-guard` namespace
  * (the official companion convention), so every install shape — standalone,
- * the conversation-toolbox bundle, a mode pack — surfaces the same card, and
+ * the basic bundle, a mode pack — surfaces the same card, and
  * a composition without the row shows no trace of it. The action
  * rides the official `/compact` command
  * channel (`remote.commands.execute` → host `ctx.commands` →

package/lib/types/client/index.js

@@ -56,7 +56,7 @@ export function apply(ctx, config) {
     }, CompactGuardButton));
     // One Plugins-page card gated on the SERVED NAMESPACE, never on the install
     // shape: whichever composition carries the `context-guard` row — standalone,
-    // the conversation-toolbox bundle, or a mode pack — serves the row's
+    // the basic bundle, or a mode pack — serves the row's
     // volatile Config under the row id, and `whileServed` keeps the
     // `plugins.item` entry alive for exactly that span (the official companion
     // convention), so a composition without the row shows no trace of the card.

package/package.json

@@ -8,7 +8,7 @@
     "context",
     "compaction"
   ],
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -26,9 +26,6 @@
     "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
-    "references": [
-      "@khorsheed/dsh-bundle-conversation-toolbox"
-    ],
     "bundle": {
       "patch": "./cordis.patch.yml"
     },