dsh-advisor-plugin 0.2.2 → 0.2.4

package/README.md

@@ -20,6 +20,8 @@
 
 ## 特性
 
+- **总开关**：设置页一键启用/关闭；关闭时不注册 advisor 工具与升级守则，已保存的模型配置保留。
+- **可折叠配置**：模型与推理档位、巡逻模式两个区块可分别收起/展开。
 - **零参数 `advisor()` 工具**：调用即自动转发整段会话，模型不需要组织上下文。
 - **plan / correction / stop 契约**：审查模型只做判断，不碰代码、不直接改状态。
 - **compaction 感知**：转发的是 `session.deriveMessages()` 的真实模型可见面，而不是过期原始历史。
@@ -116,6 +118,7 @@ dsh plugin --profile web add github:leeyoung1/dsh-advisor-plugin
 
 ```yaml
 advisor:
+  enabled: true
   provider: example-provider
   model: reviewer-model
   effort: high
@@ -166,10 +169,17 @@ agent/request ──每 N 步──▶ 快照 ──▶ 审查模型
 
 ## 依赖要求
 
-- Node.js >= 20
+- Node.js `^22.19` 或 `>=24`
 - DeepSeek Harness（web profile）
 - 已配置至少一个可用的 provider / model 作为审查模型
 
+## 兼容性
+
+- **DSH 版本**：peer 范围覆盖 `0.1.0-rc.6`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.3-alpha.1`；已在 `0.1.1-rc.2` 上实机验证。
+- **配置向后兼容**：旧配置没有 `enabled` 字段时默认 `true`，不影响升级。
+- **关闭总开关**：`enabled: false` 时保留已保存的模型配置，但不注册工具与升级守则。
+- **安装方式**：请使用 `dsh plugin --profile web add dsh-advisor-plugin`；裸 `npm install` 会撞 DSH 官方包的 peer 依赖，这不是插件本身的问题。
+
 开发验证：
 
 ```bash

package/lib/client/AdvisorCard.d.ts

@@ -1,9 +1,8 @@
 /**
- * AdvisorCard —— 设置页"插件"栏里的 Advisor 卡片（浏览器半）。
+ * AdvisorCard —— 设置页“插件”栏里的 Advisor 卡片（浏览器半）。
  *
- * 交互：provider 分组的模型单选列表（再次点击取消选择）+ 推理档位下拉 +
- * 保存/放弃。数据与动作全部由 controller 通过 slot inject 面注入；
- * 本组件纯渲染，样式内联（不依赖 css module 构建）。
+ * 交互：总开关 + 可折叠的模型/档位区块与巡逻区块；数据与动作全部由
+ * controller 通过 slot inject 面注入；本组件纯渲染，样式内联。
  */
 import type { AdvisorCardFace, AdvisorCardState } from './controller.js';
 import type { LocaleKey } from './locales.js';

package/lib/client/AdvisorCard.js

@@ -1,23 +1,32 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * AdvisorCard —— 设置页“插件”栏里的 Advisor 卡片（浏览器半）。
+ *
+ * 交互：总开关 + 可折叠的模型/档位区块与巡逻区块；数据与动作全部由
+ * controller 通过 slot inject 面注入；本组件纯渲染，样式内联。
+ */
+import { useState } from 'react';
+/** 通用开关 */
+function ToggleSwitch(props) {
+    return (_jsx("button", { type: "button", role: "switch", "aria-checked": props.checked, "aria-label": props.label, disabled: props.disabled, onClick: props.onToggle, style: {
+            ...style.button,
+            width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
+            background: props.checked ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
+        }, children: _jsx("span", { style: {
+                position: 'absolute', top: 2, left: props.checked ? 20 : 2,
+                width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
+            } }) }));
+}
+/** 可折叠区块：点击标题行展开/收起 */
+function Section(props) {
+    const [open, setOpen] = useState(props.defaultOpen ?? false);
+    return (_jsxs("div", { style: style.section, children: [_jsxs("button", { type: "button", style: style.sectionHead, "aria-expanded": open, onClick: () => setOpen(v => !v), children: [_jsx("span", { style: style.sectionTitle, children: props.title }), props.subtitle === undefined ? null : _jsx("span", { style: style.sectionSubtitle, children: props.subtitle }), _jsx("span", { style: style.sectionState, children: open ? props.t('sectionCollapse') : props.t('sectionExpand') })] }), open ? _jsx("div", { style: style.sectionBody, children: props.children }) : null] }));
+}
 /** 巡逻模式区块（自动检测跑偏） */
 function PatrolSection(props) {
     const { t } = props;
-    return (_jsxs("div", { style: { ...style.card, background: 'rgba(128,128,128,.06)' }, children: [_jsx("h4", { style: { ...style.title, fontSize: 13 }, children: t('patrolTitle') }), _jsx("p", { style: style.description, children: t('patrolDescription') }), _jsxs("div", { style: style.effortRow, children: [_jsx("span", { children: t('patrolToggle') }), _jsx("button", { type: "button", role: "switch", "aria-checked": props.enabled, "aria-label": t('patrolToggle'), disabled: props.disabled, onClick: props.togglePatrol, style: {
-                            ...style.button,
-                            width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
-                            background: props.enabled ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
-                        }, children: _jsx("span", { style: {
-                                position: 'absolute', top: 2, left: props.enabled ? 20 : 2,
-                                width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
-                            } }) })] }), props.enabled
-                ? (_jsxs("div", { children: [_jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-patrol-steps", children: t('patrolEverySteps') }), _jsx("input", { id: "advisor-patrol-steps", type: "number", min: 2, max: 500, value: props.everySteps, disabled: props.disabled, onChange: (event) => { props.setPatrolEverySteps(Number(event.target.value)); }, style: { width: 64 } })] }), _jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-patrol-immune", children: t('patrolImmuneTurns') }), _jsx("input", { id: "advisor-patrol-immune", type: "number", min: 0, max: 20, value: props.immuneTurns, disabled: props.disabled, onChange: (event) => { props.setPatrolImmuneTurns(Number(event.target.value)); }, style: { width: 64 } })] }), _jsxs("div", { style: { ...style.effortRow, marginTop: 8 }, children: [_jsx("span", { children: t('investigateToggle') }), _jsx("button", { type: "button", role: "switch", "aria-checked": props.investigate, "aria-label": t('investigateToggle'), disabled: props.disabled, onClick: props.toggleInvestigate, style: {
-                                        ...style.button,
-                                        width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
-                                        background: props.investigate ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
-                                    }, children: _jsx("span", { style: {
-                                            position: 'absolute', top: 2, left: props.investigate ? 20 : 2,
-                                            width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
-                                        } }) })] }), _jsx("p", { style: { ...style.notice, marginTop: -2 }, children: t('investigateHint') })] }))
+    return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 10 }, children: [_jsx("p", { style: style.description, children: t('patrolDescription') }), _jsxs("div", { style: style.effortRow, children: [_jsx("span", { children: t('patrolToggle') }), _jsx(ToggleSwitch, { checked: props.enabled, disabled: props.disabled, label: t('patrolToggle'), onToggle: props.togglePatrol })] }), props.enabled
+                ? (_jsxs("div", { children: [_jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-patrol-steps", children: t('patrolEverySteps') }), _jsx("input", { id: "advisor-patrol-steps", type: "number", min: 2, max: 500, value: props.everySteps, disabled: props.disabled, onChange: (event) => { props.setPatrolEverySteps(Number(event.target.value)); }, style: { width: 64 } })] }), _jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-patrol-immune", children: t('patrolImmuneTurns') }), _jsx("input", { id: "advisor-patrol-immune", type: "number", min: 0, max: 20, value: props.immuneTurns, disabled: props.disabled, onChange: (event) => { props.setPatrolImmuneTurns(Number(event.target.value)); }, style: { width: 64 } })] }), _jsxs("div", { style: { ...style.effortRow, marginTop: 8 }, children: [_jsx("span", { children: t('investigateToggle') }), _jsx(ToggleSwitch, { checked: props.investigate, disabled: props.disabled, label: t('investigateToggle'), onToggle: props.toggleInvestigate })] }), _jsx("p", { style: { ...style.notice, marginTop: -2 }, children: t('investigateHint') })] }))
                 : null, _jsx("p", { style: { ...style.notice, marginTop: -2 }, children: t('patrolEveryStepsHint') })] }));
 }
 const EFFORT_OPTIONS = ['', 'off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
@@ -41,20 +50,29 @@ const style = {
     secondary: { background: 'transparent', border: '1px solid rgba(128,128,128,.5)' },
     status: { fontSize: 12 },
     list: { maxHeight: 260, overflowY: 'auto', border: '1px solid rgba(128,128,128,.25)', borderRadius: 6, padding: '4px 10px' },
+    switchRow: { display: 'flex', alignItems: 'center', gap: 8, fontSize: 13, marginTop: 2 },
+    switchLabel: { fontWeight: 600 },
+    section: { border: '1px solid rgba(128,128,128,.25)', borderRadius: 8, overflow: 'hidden' },
+    sectionHead: { display: 'flex', alignItems: 'center', gap: 8, width: '100%', padding: '8px 10px', background: 'rgba(128,128,128,.06)', border: 'none', font: 'inherit', textAlign: 'left', cursor: 'pointer' },
+    sectionTitle: { fontSize: 13, fontWeight: 600 },
+    sectionSubtitle: { fontSize: 11, opacity: 0.65, flex: 1 },
+    sectionState: { fontSize: 11, opacity: 0.65, marginLeft: 'auto' },
+    sectionBody: { padding: 10, display: 'flex', flexDirection: 'column', gap: 8 },
 };
 export function AdvisorCard(props) {
     const state = props.useAdvisorCard(s => s);
+    const enabled = state.enabled;
     // 档位选项：目录声明了支持面 → 只列支持的；未声明 → 全档位（host 自动降级兜底）
     const effortOptions = state.efforts.known
         ? ['', ...state.efforts.levels]
         : EFFORT_OPTIONS;
     const disabled = !state.writable || state.saving;
-    const armed = state.effective.provider !== '' && state.effective.model !== '';
-    return (_jsxs("div", { style: style.card, children: [_jsx("h3", { style: style.title, children: props.t('title') }), _jsx("p", { style: style.description, children: props.t('description') }), _jsxs("p", { style: style.current, children: [props.t('armed'), "\uFF1A", armed
+    const armed = enabled && state.effective.provider !== '' && state.effective.model !== '';
+    return (_jsxs("div", { style: style.card, children: [_jsx("h3", { style: style.title, children: props.t('title') }), _jsx("p", { style: style.description, children: props.t('description') }), _jsxs("div", { style: style.switchRow, children: [_jsx("span", { style: style.switchLabel, children: props.t('enabledToggle') }), _jsx(ToggleSwitch, { checked: enabled, disabled: disabled, label: props.t('enabledToggle'), onToggle: props.toggleEnabled })] }), _jsx("p", { style: style.notice, children: enabled ? props.t('enabledHintOn') : props.t('enabledHintOff') }), _jsxs("p", { style: style.current, children: [props.t('armed'), "\uFF1A", armed
                         ? _jsx("strong", { children: `${state.effective.provider}/${state.effective.model}${state.effective.effort === '' ? '' : ` (${state.effective.effort})`}` })
-                        : props.t('offCurrent')] }), !state.writable ? _jsx("p", { style: style.notice, children: props.t('readonly') }) : null, state.catalogStatus === 'loading' ? _jsx("p", { style: style.notice, children: props.t('loading') }) : null, state.catalogStatus === 'error'
-                ? (_jsxs("div", { style: style.error, children: [_jsx("span", { children: props.t('loadFailed') }), _jsx("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled: disabled, onClick: props.retryCatalog, children: props.t('retry') })] }))
-                : null, state.catalogPartial ? _jsx("p", { style: style.notice, children: props.t('partial') }) : null, state.groups.length > 0
-                ? (_jsxs("div", { children: [_jsx("p", { style: style.notice, children: props.t('choose') }), _jsx("div", { style: style.list, children: state.groups.map(group => (_jsxs("div", { children: [_jsx("div", { style: style.groupTitle, children: group.name }), group.candidates.map(candidate => (_jsxs("label", { style: style.row, children: [_jsx("input", { type: "radio", name: "advisor-route", checked: candidate.selected, disabled: disabled, onChange: () => { props.pickRoute(candidate.key); } }), _jsxs("span", { style: style.modelName, children: [_jsx("span", { children: candidate.modelName }), _jsx("span", { style: style.route, children: `${candidate.provider}/${candidate.model}` })] }), !candidate.available ? _jsx("span", { style: style.badge, children: props.t('unavailable') }) : null] }, candidate.key)))] }, group.id))) })] }))
-                : state.catalogStatus === 'ready' ? _jsx("p", { style: style.notice, children: props.t('empty') }) : null, _jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-effort", children: props.t('effort') }), _jsx("select", { id: "advisor-effort", value: state.effective.effort, disabled: disabled, onChange: (event) => { props.setEffort(event.target.value); }, children: effortOptions.map(option => (_jsx("option", { value: option, children: option === '' ? props.t('effortDefault') : option }, option))) })] }), _jsx("p", { style: { ...style.notice, marginTop: -4 }, children: state.efforts.known ? props.t('effortHintKnown') : props.t('effortHint') }), _jsx(PatrolSection, { ...props, enabled: state.patrol.enabled, everySteps: state.patrol.everySteps, immuneTurns: state.patrol.immuneTurns, investigate: state.patrol.investigate, disabled: disabled }), _jsxs("div", { style: style.actions, children: [_jsx("button", { type: "button", style: { ...style.button, ...style.primary }, disabled: disabled || !state.dirty, onClick: props.save, children: props.t('save') }), _jsx("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled: disabled || !state.dirty, onClick: props.discard, children: props.t('discard') }), state.saving ? _jsx("span", { style: style.status, children: props.t('saving') }) : null, state.failed ? _jsx("span", { style: { ...style.status, color: '#b91c1c' }, children: props.t('saveFailed') }) : null] })] }));
+                        : props.t('offCurrent')] }), !state.writable ? _jsx("p", { style: style.notice, children: props.t('readonly') }) : null, _jsxs(Section, { t: props.t, title: props.t('modelSection'), subtitle: props.t('modelSectionHint'), defaultOpen: true, children: [state.catalogStatus === 'loading' ? _jsx("p", { style: style.notice, children: props.t('loading') }) : null, state.catalogStatus === 'error'
+                        ? (_jsxs("div", { style: style.error, children: [_jsx("span", { children: props.t('loadFailed') }), _jsx("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled: disabled, onClick: props.retryCatalog, children: props.t('retry') })] }))
+                        : null, state.catalogPartial ? _jsx("p", { style: style.notice, children: props.t('partial') }) : null, state.groups.length > 0
+                        ? (_jsxs("div", { children: [_jsx("p", { style: style.notice, children: props.t('choose') }), _jsx("div", { style: style.list, children: state.groups.map(group => (_jsxs("div", { children: [_jsx("div", { style: style.groupTitle, children: group.name }), group.candidates.map(candidate => (_jsxs("label", { style: style.row, children: [_jsx("input", { type: "radio", name: "advisor-route", checked: candidate.selected, disabled: disabled, onChange: () => { props.pickRoute(candidate.key); } }), _jsxs("span", { style: style.modelName, children: [_jsx("span", { children: candidate.modelName }), _jsx("span", { style: style.route, children: `${candidate.provider}/${candidate.model}` })] }), !candidate.available ? _jsx("span", { style: style.badge, children: props.t('unavailable') }) : null] }, candidate.key)))] }, group.id))) })] }))
+                        : state.catalogStatus === 'ready' ? _jsx("p", { style: style.notice, children: props.t('empty') }) : null, _jsxs("div", { style: style.effortRow, children: [_jsx("label", { htmlFor: "advisor-effort", children: props.t('effort') }), _jsx("select", { id: "advisor-effort", value: state.effective.effort, disabled: disabled, onChange: (event) => { props.setEffort(event.target.value); }, children: effortOptions.map(option => (_jsx("option", { value: option, children: option === '' ? props.t('effortDefault') : option }, option))) })] }), _jsx("p", { style: { ...style.notice, marginTop: -4 }, children: state.efforts.known ? props.t('effortHintKnown') : props.t('effortHint') })] }), _jsx(Section, { t: props.t, title: props.t('patrolTitle'), defaultOpen: false, children: _jsx(PatrolSection, { ...props, enabled: state.patrol.enabled, everySteps: state.patrol.everySteps, immuneTurns: state.patrol.immuneTurns, investigate: state.patrol.investigate, disabled: disabled }) }), _jsxs("div", { style: style.actions, children: [_jsx("button", { type: "button", style: { ...style.button, ...style.primary }, disabled: disabled || !state.dirty, onClick: props.save, children: props.t('save') }), _jsx("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled: disabled || !state.dirty, onClick: props.discard, children: props.t('discard') }), state.saving ? _jsx("span", { style: style.status, children: props.t('saving') }) : null, state.failed ? _jsx("span", { style: { ...style.status, color: '#b91c1c' }, children: props.t('saveFailed') }) : null] })] }));
 }

package/lib/client/controller.d.ts

@@ -71,6 +71,8 @@ export interface AdvisorCardState {
     dirty: boolean;
     catalogStatus: 'idle' | 'loading' | 'ready' | 'error';
     catalogPartial: boolean;
+    /** 总开关的生效值（draft 优先） */
+    enabled: boolean;
     /** 生效值（draft 优先，其次已保存值） */
     effective: AdvisorRoute;
     /** 巡逻模式的生效值（同 draft 优先） */
@@ -96,6 +98,7 @@ export interface AdvisorCardFace {
         advisorCard: SnapshotStore<AdvisorCardState>;
     };
     pickRoute: (key: string) => void;
+    toggleEnabled: () => void;
     setEffort: (effort: string) => void;
     togglePatrol: () => void;
     setPatrolEverySteps: (steps: number) => void;
@@ -120,6 +123,7 @@ export declare function currentEffortSupport(groups: readonly CatalogGroup[], ro
     levels: readonly string[];
 };
 export interface AdvisorSection {
+    enabled?: boolean;
     provider?: string;
     model?: string;
     effort?: string;
@@ -149,6 +153,7 @@ export declare class AdvisorCardController {
     private effective;
     private pickRoute;
     private setEffort;
+    private toggleEnabled;
     private togglePatrol;
     private setPatrolEverySteps;
     private setPatrolImmuneTurns;

package/lib/client/controller.js

@@ -103,6 +103,7 @@ export class AdvisorCardController {
         return {
             hooks: { advisorCard: this.store },
             pickRoute: (key) => this.pickRoute(key),
+            toggleEnabled: () => this.toggleEnabled(),
             setEffort: (effort) => this.setEffort(effort),
             togglePatrol: () => this.togglePatrol(),
             setPatrolEverySteps: (steps) => this.setPatrolEverySteps(steps),
@@ -116,6 +117,7 @@ export class AdvisorCardController {
     saved() {
         const value = this.scope.getSnapshot().value;
         return {
+            enabled: value?.enabled ?? true,
             provider: value?.provider ?? '',
             model: value?.model ?? '',
             effort: value?.effort ?? '',
@@ -167,6 +169,14 @@ export class AdvisorCardController {
         this.failed = false;
         this.publish();
     }
+    toggleEnabled() {
+        if (!this.scope.getSnapshot().writable || this.saving)
+            return;
+        const current = this.effective();
+        this.draft = { ...current, enabled: !(current.enabled ?? true) };
+        this.failed = false;
+        this.publish();
+    }
     togglePatrol() {
         if (!this.scope.getSnapshot().writable || this.saving)
             return;
@@ -214,7 +224,8 @@ export class AdvisorCardController {
         this.failed = false;
         this.publish();
         try {
-            // rc.6 scope 是逐字段写：五个字段顺序写入（'' 也写，保证旧值被清掉）
+            // rc.6 scope 是逐字段写：顺序写入（'' / false 也写，保证旧值被清掉）
+            await this.scope.set('enabled', desired.enabled ?? true);
             await this.scope.set('provider', desired.provider);
             await this.scope.set('model', desired.model);
             await this.scope.set('effort', desired.effort);
@@ -270,6 +281,7 @@ export class AdvisorCardController {
             dirty: this.draft !== undefined,
             catalogStatus: this.catalogStatus,
             catalogPartial: this.catalogPartial,
+            enabled: effective.enabled ?? true,
             effective,
             patrol: {
                 enabled: effective.patrolEnabled ?? true,

package/lib/client/index.js

@@ -31,43 +31,74 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client/AdvisorCard.tsx
+var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
+function ToggleSwitch(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      role: "switch",
+      "aria-checked": props.checked,
+      "aria-label": props.label,
+      disabled: props.disabled,
+      onClick: props.onToggle,
+      style: {
+        ...style.button,
+        width: 40,
+        height: 22,
+        borderRadius: 11,
+        padding: 0,
+        position: "relative",
+        background: props.checked ? "#16a34a" : "rgba(128,128,128,.4)",
+        border: "none"
+      },
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: {
+        position: "absolute",
+        top: 2,
+        left: props.checked ? 20 : 2,
+        width: 18,
+        height: 18,
+        borderRadius: 9,
+        background: "#fff",
+        transition: "left .15s"
+      } })
+    }
+  );
+}
+function Section(props) {
+  const [open, setOpen] = (0, import_react.useState)(props.defaultOpen ?? false);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.section, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+      "button",
+      {
+        type: "button",
+        style: style.sectionHead,
+        "aria-expanded": open,
+        onClick: () => setOpen((v) => !v),
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.sectionTitle, children: props.title }),
+          props.subtitle === void 0 ? null : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.sectionSubtitle, children: props.subtitle }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.sectionState, children: open ? props.t("sectionCollapse") : props.t("sectionExpand") })
+        ]
+      }
+    ),
+    open ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: style.sectionBody, children: props.children }) : null
+  ] });
+}
 function PatrolSection(props) {
   const { t } = props;
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { ...style.card, background: "rgba(128,128,128,.06)" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h4", { style: { ...style.title, fontSize: 13 }, children: t("patrolTitle") }),
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 10 }, children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.description, children: t("patrolDescription") }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.effortRow, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("patrolToggle") }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "button",
+        ToggleSwitch,
         {
-          type: "button",
-          role: "switch",
-          "aria-checked": props.enabled,
-          "aria-label": t("patrolToggle"),
+          checked: props.enabled,
           disabled: props.disabled,
-          onClick: props.togglePatrol,
-          style: {
-            ...style.button,
-            width: 40,
-            height: 22,
-            borderRadius: 11,
-            padding: 0,
-            position: "relative",
-            background: props.enabled ? "#16a34a" : "rgba(128,128,128,.4)",
-            border: "none"
-          },
-          children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: {
-            position: "absolute",
-            top: 2,
-            left: props.enabled ? 20 : 2,
-            width: 18,
-            height: 18,
-            borderRadius: 9,
-            background: "#fff",
-            transition: "left .15s"
-          } })
+          label: t("patrolToggle"),
+          onToggle: props.togglePatrol
         }
       )
     ] }),
@@ -111,34 +142,12 @@ function PatrolSection(props) {
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { ...style.effortRow, marginTop: 8 }, children: [
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: t("investigateToggle") }),
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-          "button",
+          ToggleSwitch,
           {
-            type: "button",
-            role: "switch",
-            "aria-checked": props.investigate,
-            "aria-label": t("investigateToggle"),
+            checked: props.investigate,
             disabled: props.disabled,
-            onClick: props.toggleInvestigate,
-            style: {
-              ...style.button,
-              width: 40,
-              height: 22,
-              borderRadius: 11,
-              padding: 0,
-              position: "relative",
-              background: props.investigate ? "#16a34a" : "rgba(128,128,128,.4)",
-              border: "none"
-            },
-            children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: {
-              position: "absolute",
-              top: 2,
-              left: props.investigate ? 20 : 2,
-              width: 18,
-              height: 18,
-              borderRadius: 9,
-              background: "#fff",
-              transition: "left .15s"
-            } })
+            label: t("investigateToggle"),
+            onToggle: props.toggleInvestigate
           }
         )
       ] }),
@@ -166,70 +175,103 @@ var style = {
   primary: { background: "#2563eb", color: "#fff", border: "none" },
   secondary: { background: "transparent", border: "1px solid rgba(128,128,128,.5)" },
   status: { fontSize: 12 },
-  list: { maxHeight: 260, overflowY: "auto", border: "1px solid rgba(128,128,128,.25)", borderRadius: 6, padding: "4px 10px" }
+  list: { maxHeight: 260, overflowY: "auto", border: "1px solid rgba(128,128,128,.25)", borderRadius: 6, padding: "4px 10px" },
+  switchRow: { display: "flex", alignItems: "center", gap: 8, fontSize: 13, marginTop: 2 },
+  switchLabel: { fontWeight: 600 },
+  section: { border: "1px solid rgba(128,128,128,.25)", borderRadius: 8, overflow: "hidden" },
+  sectionHead: { display: "flex", alignItems: "center", gap: 8, width: "100%", padding: "8px 10px", background: "rgba(128,128,128,.06)", border: "none", font: "inherit", textAlign: "left", cursor: "pointer" },
+  sectionTitle: { fontSize: 13, fontWeight: 600 },
+  sectionSubtitle: { fontSize: 11, opacity: 0.65, flex: 1 },
+  sectionState: { fontSize: 11, opacity: 0.65, marginLeft: "auto" },
+  sectionBody: { padding: 10, display: "flex", flexDirection: "column", gap: 8 }
 };
 function AdvisorCard(props) {
   const state = props.useAdvisorCard((s) => s);
+  const enabled = state.enabled;
   const effortOptions = state.efforts.known ? ["", ...state.efforts.levels] : EFFORT_OPTIONS;
   const disabled = !state.writable || state.saving;
-  const armed = state.effective.provider !== "" && state.effective.model !== "";
+  const armed = enabled && state.effective.provider !== "" && state.effective.model !== "";
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.card, children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h3", { style: style.title, children: props.t("title") }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.description, children: props.t("description") }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.switchRow, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.switchLabel, children: props.t("enabledToggle") }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        ToggleSwitch,
+        {
+          checked: enabled,
+          disabled,
+          label: props.t("enabledToggle"),
+          onToggle: props.toggleEnabled
+        }
+      )
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: enabled ? props.t("enabledHintOn") : props.t("enabledHintOff") }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { style: style.current, children: [
       props.t("armed"),
       "\uFF1A",
       armed ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: `${state.effective.provider}/${state.effective.model}${state.effective.effort === "" ? "" : ` (${state.effective.effort})`}` }) : props.t("offCurrent")
     ] }),
     !state.writable ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("readonly") }) : null,
-    state.catalogStatus === "loading" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("loading") }) : null,
-    state.catalogStatus === "error" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.error, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: props.t("loadFailed") }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled, onClick: props.retryCatalog, children: props.t("retry") })
-    ] }) : null,
-    state.catalogPartial ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("partial") }) : null,
-    state.groups.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("choose") }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: style.list, children: state.groups.map((group) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: style.groupTitle, children: group.name }),
-        group.candidates.map((candidate) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("label", { style: style.row, children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-            "input",
-            {
-              type: "radio",
-              name: "advisor-route",
-              checked: candidate.selected,
-              disabled,
-              onChange: () => {
-                props.pickRoute(candidate.key);
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+      Section,
+      {
+        t: props.t,
+        title: props.t("modelSection"),
+        subtitle: props.t("modelSectionHint"),
+        defaultOpen: true,
+        children: [
+          state.catalogStatus === "loading" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("loading") }) : null,
+          state.catalogStatus === "error" ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.error, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: props.t("loadFailed") }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", style: { ...style.button, ...style.secondary }, disabled, onClick: props.retryCatalog, children: props.t("retry") })
+          ] }) : null,
+          state.catalogPartial ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("partial") }) : null,
+          state.groups.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("choose") }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: style.list, children: state.groups.map((group) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: style.groupTitle, children: group.name }),
+              group.candidates.map((candidate) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("label", { style: style.row, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                  "input",
+                  {
+                    type: "radio",
+                    name: "advisor-route",
+                    checked: candidate.selected,
+                    disabled,
+                    onChange: () => {
+                      props.pickRoute(candidate.key);
+                    }
+                  }
+                ),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: style.modelName, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: candidate.modelName }),
+                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.route, children: `${candidate.provider}/${candidate.model}` })
+                ] }),
+                !candidate.available ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.badge, children: props.t("unavailable") }) : null
+              ] }, candidate.key))
+            ] }, group.id)) })
+          ] }) : state.catalogStatus === "ready" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("empty") }) : null,
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.effortRow, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { htmlFor: "advisor-effort", children: props.t("effort") }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              "select",
+              {
+                id: "advisor-effort",
+                value: state.effective.effort,
+                disabled,
+                onChange: (event) => {
+                  props.setEffort(event.target.value);
+                },
+                children: effortOptions.map((option) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: option, children: option === "" ? props.t("effortDefault") : option }, option))
               }
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: style.modelName, children: [
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: candidate.modelName }),
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.route, children: `${candidate.provider}/${candidate.model}` })
+            )
           ] }),
-          !candidate.available ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: style.badge, children: props.t("unavailable") }) : null
-        ] }, candidate.key))
-      ] }, group.id)) })
-    ] }) : state.catalogStatus === "ready" ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: style.notice, children: props.t("empty") }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.effortRow, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { htmlFor: "advisor-effort", children: props.t("effort") }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "select",
-        {
-          id: "advisor-effort",
-          value: state.effective.effort,
-          disabled,
-          onChange: (event) => {
-            props.setEffort(event.target.value);
-          },
-          children: effortOptions.map((option) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("option", { value: option, children: option === "" ? props.t("effortDefault") : option }, option))
-        }
-      )
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: { ...style.notice, marginTop: -4 }, children: state.efforts.known ? props.t("effortHintKnown") : props.t("effortHint") }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: { ...style.notice, marginTop: -4 }, children: state.efforts.known ? props.t("effortHintKnown") : props.t("effortHint") })
+        ]
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Section, { t: props.t, title: props.t("patrolTitle"), defaultOpen: false, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       PatrolSection,
       {
         ...props,
@@ -239,7 +281,7 @@ function AdvisorCard(props) {
         investigate: state.patrol.investigate,
         disabled
       }
-    ),
+    ) }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: style.actions, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
         "button",
@@ -268,7 +310,7 @@ function AdvisorCard(props) {
 }
 
 // src/client/AdvisorToolRow.tsx
-var import_react = require("react");
+var import_react2 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var style2 = {
   row: { display: "flex", flexDirection: "column", gap: 4, margin: "6px 0", border: "1px solid rgba(37,99,235,.35)", borderRadius: 8, overflow: "hidden" },
@@ -296,7 +338,7 @@ function blockOutput(block) {
 }
 function AdvisorToolRow(props) {
   const t = props.t ?? ((key) => key);
-  const [expanded, setExpanded] = (0, import_react.useState)(false);
+  const [expanded, setExpanded] = (0, import_react2.useState)(false);
   const block = props.block ?? {};
   const done = block.kind !== void 0;
   const { text, isError } = done ? blockOutput(block) : { text: "", isError: false };
@@ -318,7 +360,7 @@ function AdvisorToolRow(props) {
 }
 
 // src/client/PatrolNodeView.tsx
-var import_react2 = require("react");
+var import_react3 = require("react");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var ACCENT_ON_TRACK = {
   border: "rgba(107,114,128,.35)",
@@ -348,7 +390,7 @@ var style3 = {
 };
 function PatrolNodeView(props) {
   const t = props.t ?? ((key) => key);
-  const [expanded, setExpanded] = (0, import_react2.useState)(false);
+  const [expanded, setExpanded] = (0, import_react3.useState)(false);
   const data = props.node?.data;
   if (data === void 0) return null;
   const onTrack = data.verdict === "on-track";
@@ -473,6 +515,7 @@ var AdvisorCardController = class {
     return {
       hooks: { advisorCard: this.store },
       pickRoute: (key) => this.pickRoute(key),
+      toggleEnabled: () => this.toggleEnabled(),
       setEffort: (effort) => this.setEffort(effort),
       togglePatrol: () => this.togglePatrol(),
       setPatrolEverySteps: (steps) => this.setPatrolEverySteps(steps),
@@ -490,6 +533,7 @@ var AdvisorCardController = class {
   saved() {
     const value = this.scope.getSnapshot().value;
     return {
+      enabled: value?.enabled ?? true,
       provider: value?.provider ?? "",
       model: value?.model ?? "",
       effort: value?.effort ?? "",
@@ -534,6 +578,13 @@ var AdvisorCardController = class {
     this.failed = false;
     this.publish();
   }
+  toggleEnabled() {
+    if (!this.scope.getSnapshot().writable || this.saving) return;
+    const current = this.effective();
+    this.draft = { ...current, enabled: !(current.enabled ?? true) };
+    this.failed = false;
+    this.publish();
+  }
   togglePatrol() {
     if (!this.scope.getSnapshot().writable || this.saving) return;
     const current = this.effective();
@@ -575,6 +626,7 @@ var AdvisorCardController = class {
     this.failed = false;
     this.publish();
     try {
+      await this.scope.set("enabled", desired.enabled ?? true);
       await this.scope.set("provider", desired.provider);
       await this.scope.set("model", desired.model);
       await this.scope.set("effort", desired.effort);
@@ -624,6 +676,7 @@ var AdvisorCardController = class {
       dirty: this.draft !== void 0,
       catalogStatus: this.catalogStatus,
       catalogPartial: this.catalogPartial,
+      enabled: effective.enabled ?? true,
       effective,
       patrol: {
         enabled: effective.patrolEnabled ?? true,
@@ -709,6 +762,13 @@ var zh = {
   saved: "\u5DF2\u4FDD\u5B58",
   saveFailed: "\u4FDD\u5B58\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5",
   readonly: "\u8BBE\u7F6E\u6587\u6863\u53EA\u8BFB\uFF0C\u65E0\u6CD5\u5728\u6B64\u4FEE\u6539\u3002",
+  enabledToggle: "\u542F\u7528 Advisor \u63D2\u4EF6",
+  enabledHintOn: "\u603B\u5F00\u5173\u5DF2\u6253\u5F00\uFF1A\u914D\u7F6E\u5BA1\u67E5\u6A21\u578B\u540E\uFF0Cadvisor \u5DE5\u5177\u4F1A\u5BF9\u6267\u884C\u6A21\u578B\u53EF\u89C1\u3002",
+  enabledHintOff: "\u603B\u5F00\u5173\u5DF2\u5173\u95ED\uFF1Aadvisor \u5DE5\u5177\u4E0E\u5347\u7EA7\u5B88\u5219\u4E0D\u4F1A\u6CE8\u518C\uFF0C\u5DF2\u4FDD\u5B58\u7684\u6A21\u578B\u914D\u7F6E\u4F1A\u4FDD\u7559\u3002",
+  modelSection: "\u6A21\u578B\u4E0E\u63A8\u7406\u6863\u4F4D",
+  modelSectionHint: "\u9009\u62E9\u5BA1\u67E5\u6A21\u578B\u548C\u63A8\u7406\u6863\u4F4D",
+  sectionExpand: "\u5C55\u5F00",
+  sectionCollapse: "\u6536\u8D77",
   patrolTitle: "\u5DE1\u903B\u6A21\u5F0F\uFF08\u81EA\u52A8\u68C0\u6D4B\u8DD1\u504F\uFF09",
   patrolDescription: "\u6267\u884C\u8FC7\u7A0B\u4E2D\u6BCF\u9694\u82E5\u5E72\u6B65\u81EA\u52A8\u628A\u4F1A\u8BDD\u5FEB\u7167\u53D1\u7ED9\u5BA1\u67E5\u6A21\u578B\u68C0\u67E5\u65B9\u5411\uFF1B\u53D1\u73B0\u8DD1\u504F\u4F1A\u5728\u4E0B\u4E00\u6B65\u6CE8\u5165\u7EA0\u504F\uFF0CSTOP \u65F6\u8981\u6C42\u6267\u884C\u6A21\u578B\u505C\u4E0B\u5411\u7528\u6237\u62A5\u544A\u3002\u6BCF\u6B21\u5DE1\u903B\u6574\u6BB5\u4F1A\u8BDD\u8BA1\u8D39\u4E00\u6B21\u5BA1\u67E5\u6A21\u578B\u3002",
   patrolToggle: "\u542F\u7528\u5DE1\u903B",
@@ -758,6 +818,13 @@ var en = {
   saved: "Saved",
   saveFailed: "Save failed, please retry",
   readonly: "The settings document is read-only here.",
+  enabledToggle: "Enable advisor plugin",
+  enabledHintOn: "Master switch is on: once a reviewer is configured, the advisor tool becomes visible to the executor.",
+  enabledHintOff: "Master switch is off: the advisor tool and guideline prompt section are not registered; saved settings are kept.",
+  modelSection: "Reviewer model & effort",
+  modelSectionHint: "Pick the reviewer model and reasoning effort",
+  sectionExpand: "Expand",
+  sectionCollapse: "Collapse",
   patrolTitle: "Patrol mode (automatic drift detection)",
   patrolDescription: "Every few steps the conversation snapshot is sent to the reviewer to check direction; on drift a correction is injected into the next request, and STOP asks the executor to halt and report. Each patrol bills the full conversation to the reviewer once.",
   patrolToggle: "Enable patrol",

package/lib/client/locales.d.ts

@@ -24,6 +24,13 @@ export declare const zh: {
     readonly saved: "已保存";
     readonly saveFailed: "保存失败，请重试";
     readonly readonly: "设置文档只读，无法在此修改。";
+    readonly enabledToggle: "启用 Advisor 插件";
+    readonly enabledHintOn: "总开关已打开：配置审查模型后，advisor 工具会对执行模型可见。";
+    readonly enabledHintOff: "总开关已关闭：advisor 工具与升级守则不会注册，已保存的模型配置会保留。";
+    readonly modelSection: "模型与推理档位";
+    readonly modelSectionHint: "选择审查模型和推理档位";
+    readonly sectionExpand: "展开";
+    readonly sectionCollapse: "收起";
     readonly patrolTitle: "巡逻模式（自动检测跑偏）";
     readonly patrolDescription: "执行过程中每隔若干步自动把会话快照发给审查模型检查方向；发现跑偏会在下一步注入纠偏，STOP 时要求执行模型停下向用户报告。每次巡逻整段会话计费一次审查模型。";
     readonly patrolToggle: "启用巡逻";

package/lib/client/locales.js

@@ -24,6 +24,13 @@ export const zh = {
     saved: '已保存',
     saveFailed: '保存失败，请重试',
     readonly: '设置文档只读，无法在此修改。',
+    enabledToggle: '启用 Advisor 插件',
+    enabledHintOn: '总开关已打开：配置审查模型后，advisor 工具会对执行模型可见。',
+    enabledHintOff: '总开关已关闭：advisor 工具与升级守则不会注册，已保存的模型配置会保留。',
+    modelSection: '模型与推理档位',
+    modelSectionHint: '选择审查模型和推理档位',
+    sectionExpand: '展开',
+    sectionCollapse: '收起',
     patrolTitle: '巡逻模式（自动检测跑偏）',
     patrolDescription: '执行过程中每隔若干步自动把会话快照发给审查模型检查方向；发现跑偏会在下一步注入纠偏，STOP 时要求执行模型停下向用户报告。每次巡逻整段会话计费一次审查模型。',
     patrolToggle: '启用巡逻',
@@ -73,6 +80,13 @@ export const en = {
     saved: 'Saved',
     saveFailed: 'Save failed, please retry',
     readonly: 'The settings document is read-only here.',
+    enabledToggle: 'Enable advisor plugin',
+    enabledHintOn: 'Master switch is on: once a reviewer is configured, the advisor tool becomes visible to the executor.',
+    enabledHintOff: 'Master switch is off: the advisor tool and guideline prompt section are not registered; saved settings are kept.',
+    modelSection: 'Reviewer model & effort',
+    modelSectionHint: 'Pick the reviewer model and reasoning effort',
+    sectionExpand: 'Expand',
+    sectionCollapse: 'Collapse',
     patrolTitle: 'Patrol mode (automatic drift detection)',
     patrolDescription: 'Every few steps the conversation snapshot is sent to the reviewer to check direction; on drift a correction is injected into the next request, and STOP asks the executor to halt and report. Each patrol bills the full conversation to the reviewer once.',
     patrolToggle: 'Enable patrol',

package/lib/config.d.ts

@@ -4,8 +4,9 @@
  * 配置三层合成（rc.6 settings 服务）：schema 默认值 → 插件组合层 base →
  * 用户层（~/.dsh/settings.yaml 的 advisor: 段，设置页卡片写入的就是这一层）。
  *
- * `provider` + `model` 两者齐备 advisor 才武装（对应 rpiv 的 "off costs
- * nothing"：没有审查模型时工具与提示词段都不注册）。
+ * `enabled` 是用户总开关；`provider` + `model` 齐备且总开关打开时 advisor
+ * 才武装（对应 rpiv 的 "off costs nothing"：关闭或没有审查模型时，工具与
+ * 提示词段都不注册）。
  *
  * disabledForModels 条目语法（字符串数组，与设置页文案一致）：
  *   "model"                 —— 任意 provider 跑该模型都禁用
@@ -14,6 +15,7 @@
  */
 import z from '@deepseek-ai/schemastery';
 export interface Config {
+    enabled?: boolean;
     provider?: string;
     model?: string;
     effort?: string;

package/lib/config.js

@@ -4,8 +4,9 @@
  * 配置三层合成（rc.6 settings 服务）：schema 默认值 → 插件组合层 base →
  * 用户层（~/.dsh/settings.yaml 的 advisor: 段，设置页卡片写入的就是这一层）。
  *
- * `provider` + `model` 两者齐备 advisor 才武装（对应 rpiv 的 "off costs
- * nothing"：没有审查模型时工具与提示词段都不注册）。
+ * `enabled` 是用户总开关；`provider` + `model` 齐备且总开关打开时 advisor
+ * 才武装（对应 rpiv 的 "off costs nothing"：关闭或没有审查模型时，工具与
+ * 提示词段都不注册）。
  *
  * disabledForModels 条目语法（字符串数组，与设置页文案一致）：
  *   "model"                 —— 任意 provider 跑该模型都禁用
@@ -14,6 +15,7 @@
  */
 import z from '@deepseek-ai/schemastery';
 export const Config = z.object({
+    enabled: z.boolean().default(true).description('advisor 总开关：关闭后不注册 advisor 工具与升级守则提示段，已保存的模型配置保留'),
     provider: z.string().default('').description('审查模型所在的 provider 路由名（ctx.llm 适配器路由，如 example-provider）'),
     model: z.string().default('').description('该路由下的审查模型 id（如 deepseek-v4-pro）'),
     effort: z.string().default('').description('审查模型推理档位；留空走模型默认'),
@@ -25,6 +27,8 @@ export const Config = z.object({
     investigate: z.boolean().default(true).description('审查者调查工具：允许审查模型在裁决前用只读工具（工作区内搜索/读文件）亲自核实，建议更有据'),
 });
 export function resolveSelection(config) {
+    if (config.enabled === false)
+        return undefined;
     const { provider, model } = config;
     if (provider === undefined || provider === '' || model === undefined || model === '')
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-advisor-plugin",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "DeepSeek Harness advisor plugin: pair a fast executor with a stronger reviewer model for plan / correction / stop guidance.",
   "type": "module",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": "^22.19 || >=24"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -63,15 +63,15 @@
     "coding-agent"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-agent": "*",
-    "@deepseek-ai/dsh-commands": "*",
-    "@deepseek-ai/dsh-llm": "*",
-    "@deepseek-ai/dsh-session": "*",
-    "@deepseek-ai/dsh-settings": "*",
-    "@deepseek-ai/dsh-system-prompt": "*",
-    "@deepseek-ai/dsh-tools": "*",
-    "@deepseek-ai/schemastery": "*"
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/client/AdvisorCard.tsx

@@ -1,11 +1,11 @@
 /**
- * AdvisorCard —— 设置页"插件"栏里的 Advisor 卡片（浏览器半）。
+ * AdvisorCard —— 设置页“插件”栏里的 Advisor 卡片（浏览器半）。
  *
- * 交互：provider 分组的模型单选列表（再次点击取消选择）+ 推理档位下拉 +
- * 保存/放弃。数据与动作全部由 controller 通过 slot inject 面注入；
- * 本组件纯渲染，样式内联（不依赖 css module 构建）。
+ * 交互：总开关 + 可折叠的模型/档位区块与巡逻区块；数据与动作全部由
+ * controller 通过 slot inject 面注入；本组件纯渲染，样式内联。
  */
 
+import { useState, type ReactNode } from 'react'
 import type { AdvisorCardFace, AdvisorCardState } from './controller.js'
 import type { LocaleKey } from './locales.js'
 
@@ -15,6 +15,61 @@ export type AdvisorCardProps = Omit<AdvisorCardFace, 'hooks'> & {
   t: (key: LocaleKey) => string
 }
 
+/** 通用开关 */
+function ToggleSwitch(props: {
+  checked: boolean
+  disabled?: boolean
+  label: string
+  onToggle: () => void
+}) {
+  return (
+    <button
+      type="button"
+      role="switch"
+      aria-checked={props.checked}
+      aria-label={props.label}
+      disabled={props.disabled}
+      onClick={props.onToggle}
+      style={{
+        ...style.button,
+        width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
+        background: props.checked ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
+      }}
+    >
+      <span style={{
+        position: 'absolute', top: 2, left: props.checked ? 20 : 2,
+        width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
+      }} />
+    </button>
+  )
+}
+
+/** 可折叠区块：点击标题行展开/收起 */
+function Section(props: {
+  t: (key: LocaleKey) => string
+  title: string
+  subtitle?: string
+  defaultOpen?: boolean
+  children: ReactNode
+}) {
+  const [open, setOpen] = useState(props.defaultOpen ?? false)
+  return (
+    <div style={style.section}>
+      <button
+        type="button"
+        style={style.sectionHead}
+        aria-expanded={open}
+        onClick={() => setOpen(v => !v)}
+      >
+        <span style={style.sectionTitle}>{props.title}</span>
+        {props.subtitle === undefined ? null : <span style={style.sectionSubtitle}>{props.subtitle}</span>}
+        <span style={style.sectionState}>{open ? props.t('sectionCollapse') : props.t('sectionExpand')}</span>
+      </button>
+      {open ? <div style={style.sectionBody}>{props.children}</div> : null}
+    </div>
+  )
+}
+
 /** 巡逻模式区块（自动检测跑偏） */
 function PatrolSection(props: AdvisorCardProps & {
   enabled: boolean
@@ -25,29 +80,16 @@ function PatrolSection(props: AdvisorCardProps & {
 }) {
   const { t } = props
   return (
-    <div style={{ ...style.card, background: 'rgba(128,128,128,.06)' }}>
-      <h4 style={{ ...style.title, fontSize: 13 }}>{t('patrolTitle')}</h4>
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 10 }}>
       <p style={style.description}>{t('patrolDescription')}</p>
       <div style={style.effortRow}>
         <span>{t('patrolToggle')}</span>
-        <button
-          type="button"
-          role="switch"
-          aria-checked={props.enabled}
-          aria-label={t('patrolToggle')}
+        <ToggleSwitch
+          checked={props.enabled}
           disabled={props.disabled}
-          onClick={props.togglePatrol}
-          style={{
-            ...style.button,
-            width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
-            background: props.enabled ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
-          }}
-        >
-          <span style={{
-            position: 'absolute', top: 2, left: props.enabled ? 20 : 2,
-            width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
-          }} />
-        </button>
+          label={t('patrolToggle')}
+          onToggle={props.togglePatrol}
+        />
       </div>
       {props.enabled
         ? (
@@ -80,24 +122,12 @@ function PatrolSection(props: AdvisorCardProps & {
             </div>
             <div style={{ ...style.effortRow, marginTop: 8 }}>
               <span>{t('investigateToggle')}</span>
-              <button
-                type="button"
-                role="switch"
-                aria-checked={props.investigate}
-                aria-label={t('investigateToggle')}
+              <ToggleSwitch
+                checked={props.investigate}
                 disabled={props.disabled}
-                onClick={props.toggleInvestigate}
-                style={{
-                  ...style.button,
-                  width: 40, height: 22, borderRadius: 11, padding: 0, position: 'relative',
-                  background: props.investigate ? '#16a34a' : 'rgba(128,128,128,.4)', border: 'none',
-                }}
-              >
-                <span style={{
-                  position: 'absolute', top: 2, left: props.investigate ? 20 : 2,
-                  width: 18, height: 18, borderRadius: 9, background: '#fff', transition: 'left .15s',
-                }} />
-              </button>
+                label={t('investigateToggle')}
+                onToggle={props.toggleInvestigate}
+              />
             </div>
             <p style={{ ...style.notice, marginTop: -2 }}>{t('investigateHint')}</p>
           </div>
@@ -130,22 +160,42 @@ const style = {
   secondary: { background: 'transparent', border: '1px solid rgba(128,128,128,.5)' } as const,
   status: { fontSize: 12 } as const,
   list: { maxHeight: 260, overflowY: 'auto', border: '1px solid rgba(128,128,128,.25)', borderRadius: 6, padding: '4px 10px' } as const,
+  switchRow: { display: 'flex', alignItems: 'center', gap: 8, fontSize: 13, marginTop: 2 } as const,
+  switchLabel: { fontWeight: 600 } as const,
+  section: { border: '1px solid rgba(128,128,128,.25)', borderRadius: 8, overflow: 'hidden' } as const,
+  sectionHead: { display: 'flex', alignItems: 'center', gap: 8, width: '100%', padding: '8px 10px', background: 'rgba(128,128,128,.06)', border: 'none', font: 'inherit', textAlign: 'left', cursor: 'pointer' } as const,
+  sectionTitle: { fontSize: 13, fontWeight: 600 } as const,
+  sectionSubtitle: { fontSize: 11, opacity: 0.65, flex: 1 } as const,
+  sectionState: { fontSize: 11, opacity: 0.65, marginLeft: 'auto' } as const,
+  sectionBody: { padding: 10, display: 'flex', flexDirection: 'column', gap: 8 } as const,
 }
 
 export function AdvisorCard(props: AdvisorCardProps) {
   const state = props.useAdvisorCard(s => s)
+  const enabled = state.enabled
   // 档位选项：目录声明了支持面 → 只列支持的；未声明 → 全档位（host 自动降级兜底）
   const effortOptions: readonly string[] = state.efforts.known
     ? ['', ...state.efforts.levels]
     : EFFORT_OPTIONS
   const disabled = !state.writable || state.saving
-  const armed = state.effective.provider !== '' && state.effective.model !== ''
+  const armed = enabled && state.effective.provider !== '' && state.effective.model !== ''
 
   return (
     <div style={style.card}>
       <h3 style={style.title}>{props.t('title')}</h3>
       <p style={style.description}>{props.t('description')}</p>
 
+      <div style={style.switchRow}>
+        <span style={style.switchLabel}>{props.t('enabledToggle')}</span>
+        <ToggleSwitch
+          checked={enabled}
+          disabled={disabled}
+          label={props.t('enabledToggle')}
+          onToggle={props.toggleEnabled}
+        />
+      </div>
+      <p style={style.notice}>{enabled ? props.t('enabledHintOn') : props.t('enabledHintOff')}</p>
+
       <p style={style.current}>
         {props.t('armed')}：
         {armed
@@ -155,78 +205,87 @@ export function AdvisorCard(props: AdvisorCardProps) {
 
       {!state.writable ? <p style={style.notice}>{props.t('readonly')}</p> : null}
 
-      {state.catalogStatus === 'loading' ? <p style={style.notice}>{props.t('loading')}</p> : null}
-      {state.catalogStatus === 'error'
-        ? (
-          <div style={style.error}>
-            <span>{props.t('loadFailed')}</span>
-            <button type="button" style={{ ...style.button, ...style.secondary }} disabled={disabled} onClick={props.retryCatalog}>
-              {props.t('retry')}
-            </button>
-          </div>
-        )
-        : null}
-      {state.catalogPartial ? <p style={style.notice}>{props.t('partial')}</p> : null}
+      <Section
+        t={props.t}
+        title={props.t('modelSection')}
+        subtitle={props.t('modelSectionHint')}
+        defaultOpen
+      >
+        {state.catalogStatus === 'loading' ? <p style={style.notice}>{props.t('loading')}</p> : null}
+        {state.catalogStatus === 'error'
+          ? (
+            <div style={style.error}>
+              <span>{props.t('loadFailed')}</span>
+              <button type="button" style={{ ...style.button, ...style.secondary }} disabled={disabled} onClick={props.retryCatalog}>
+                {props.t('retry')}
+              </button>
+            </div>
+          )
+          : null}
+        {state.catalogPartial ? <p style={style.notice}>{props.t('partial')}</p> : null}
 
-      {state.groups.length > 0
-        ? (
-          <div>
-            <p style={style.notice}>{props.t('choose')}</p>
-            <div style={style.list}>
-              {state.groups.map(group => (
-                <div key={group.id}>
-                  <div style={style.groupTitle}>{group.name}</div>
-                  {group.candidates.map(candidate => (
-                    <label key={candidate.key} style={style.row}>
-                      <input
-                        type="radio"
-                        name="advisor-route"
-                        checked={candidate.selected}
-                        disabled={disabled}
-                        onChange={() => { props.pickRoute(candidate.key) }}
-                      />
-                      <span style={style.modelName}>
-                        <span>{candidate.modelName}</span>
-                        <span style={style.route}>{`${candidate.provider}/${candidate.model}`}</span>
-                      </span>
-                      {!candidate.available ? <span style={style.badge}>{props.t('unavailable')}</span> : null}
-                    </label>
-                  ))}
-                </div>
-              ))}
+        {state.groups.length > 0
+          ? (
+            <div>
+              <p style={style.notice}>{props.t('choose')}</p>
+              <div style={style.list}>
+                {state.groups.map(group => (
+                  <div key={group.id}>
+                    <div style={style.groupTitle}>{group.name}</div>
+                    {group.candidates.map(candidate => (
+                      <label key={candidate.key} style={style.row}>
+                        <input
+                          type="radio"
+                          name="advisor-route"
+                          checked={candidate.selected}
+                          disabled={disabled}
+                          onChange={() => { props.pickRoute(candidate.key) }}
+                        />
+                        <span style={style.modelName}>
+                          <span>{candidate.modelName}</span>
+                          <span style={style.route}>{`${candidate.provider}/${candidate.model}`}</span>
+                        </span>
+                        {!candidate.available ? <span style={style.badge}>{props.t('unavailable')}</span> : null}
+                      </label>
+                    ))}
+                  </div>
+                ))}
+              </div>
             </div>
-          </div>
-        )
-        : state.catalogStatus === 'ready' ? <p style={style.notice}>{props.t('empty')}</p> : null}
+          )
+          : state.catalogStatus === 'ready' ? <p style={style.notice}>{props.t('empty')}</p> : null}
 
-      <div style={style.effortRow}>
-        <label htmlFor="advisor-effort">{props.t('effort')}</label>
-        <select
-          id="advisor-effort"
-          value={state.effective.effort}
-          disabled={disabled}
-          onChange={(event) => { props.setEffort(event.target.value) }}
-        >
-          {/* 已声明支持面的模型只列支持的档位；未声明的列全档位（host 侧自动降级兜底） */}
-          {effortOptions.map(option => (
-            <option key={option} value={option}>
-              {option === '' ? props.t('effortDefault') : option}
-            </option>
-          ))}
-        </select>
-      </div>
-      <p style={{ ...style.notice, marginTop: -4 }}>
-        {state.efforts.known ? props.t('effortHintKnown') : props.t('effortHint')}
-      </p>
+        <div style={style.effortRow}>
+          <label htmlFor="advisor-effort">{props.t('effort')}</label>
+          <select
+            id="advisor-effort"
+            value={state.effective.effort}
+            disabled={disabled}
+            onChange={(event) => { props.setEffort(event.target.value) }}
+          >
+            {/* 已声明支持面的模型只列支持的档位；未声明的列全档位（host 侧自动降级兜底） */}
+            {effortOptions.map(option => (
+              <option key={option} value={option}>
+                {option === '' ? props.t('effortDefault') : option}
+              </option>
+            ))}
+          </select>
+        </div>
+        <p style={{ ...style.notice, marginTop: -4 }}>
+          {state.efforts.known ? props.t('effortHintKnown') : props.t('effortHint')}
+        </p>
+      </Section>
 
-      <PatrolSection
-        {...props}
-        enabled={state.patrol.enabled}
-        everySteps={state.patrol.everySteps}
-        immuneTurns={state.patrol.immuneTurns}
-        investigate={state.patrol.investigate}
-        disabled={disabled}
-      />
+      <Section t={props.t} title={props.t('patrolTitle')} defaultOpen={false}>
+        <PatrolSection
+          {...props}
+          enabled={state.patrol.enabled}
+          everySteps={state.patrol.everySteps}
+          immuneTurns={state.patrol.immuneTurns}
+          investigate={state.patrol.investigate}
+          disabled={disabled}
+        />
+      </Section>
 
       <div style={style.actions}>
         <button

package/src/client/controller.ts

@@ -87,6 +87,8 @@ export interface AdvisorCardState {
   dirty: boolean
   catalogStatus: 'idle' | 'loading' | 'ready' | 'error'
   catalogPartial: boolean
+  /** 总开关的生效值（draft 优先） */
+  enabled: boolean
   /** 生效值（draft 优先，其次已保存值） */
   effective: AdvisorRoute
   /** 巡逻模式的生效值（同 draft 优先） */
@@ -99,6 +101,7 @@ export interface AdvisorCardState {
 export interface AdvisorCardFace {
   hooks: { advisorCard: SnapshotStore<AdvisorCardState> }
   pickRoute: (key: string) => void
+  toggleEnabled: () => void
   setEffort: (effort: string) => void
   togglePatrol: () => void
   setPatrolEverySteps: (steps: number) => void
@@ -175,6 +178,7 @@ export function currentEffortSupport(
 }
 
 export interface AdvisorSection {
+  enabled?: boolean
   provider?: string
   model?: string
   effort?: string
@@ -217,6 +221,7 @@ export class AdvisorCardController {
     return {
       hooks: { advisorCard: this.store },
       pickRoute: (key) => this.pickRoute(key),
+      toggleEnabled: () => this.toggleEnabled(),
       setEffort: (effort) => this.setEffort(effort),
       togglePatrol: () => this.togglePatrol(),
       setPatrolEverySteps: (steps) => this.setPatrolEverySteps(steps),
@@ -231,6 +236,7 @@ export class AdvisorCardController {
   private saved(): SectionDraft {
     const value = this.scope.getSnapshot().value
     return {
+      enabled: value?.enabled ?? true,
       provider: value?.provider ?? '',
       model: value?.model ?? '',
       effort: value?.effort ?? '',
@@ -283,6 +289,14 @@ export class AdvisorCardController {
     this.publish()
   }
 
+  private toggleEnabled(): void {
+    if (!this.scope.getSnapshot().writable || this.saving) return
+    const current = this.effective()
+    this.draft = { ...current, enabled: !(current.enabled ?? true) }
+    this.failed = false
+    this.publish()
+  }
+
   private togglePatrol(): void {
     if (!this.scope.getSnapshot().writable || this.saving) return
     const current = this.effective()
@@ -329,7 +343,8 @@ export class AdvisorCardController {
     this.failed = false
     this.publish()
     try {
-      // rc.6 scope 是逐字段写：五个字段顺序写入（'' 也写，保证旧值被清掉）
+      // rc.6 scope 是逐字段写：顺序写入（'' / false 也写，保证旧值被清掉）
+      await this.scope.set('enabled', desired.enabled ?? true)
       await this.scope.set('provider', desired.provider)
       await this.scope.set('model', desired.model)
       await this.scope.set('effort', desired.effort)
@@ -381,6 +396,7 @@ export class AdvisorCardController {
       dirty: this.draft !== undefined,
       catalogStatus: this.catalogStatus,
       catalogPartial: this.catalogPartial,
+      enabled: effective.enabled ?? true,
       effective,
       patrol: {
         enabled: effective.patrolEnabled ?? true,

package/src/client/locales.ts

@@ -25,6 +25,13 @@ export const zh = {
   saved: '已保存',
   saveFailed: '保存失败，请重试',
   readonly: '设置文档只读，无法在此修改。',
+  enabledToggle: '启用 Advisor 插件',
+  enabledHintOn: '总开关已打开：配置审查模型后，advisor 工具会对执行模型可见。',
+  enabledHintOff: '总开关已关闭：advisor 工具与升级守则不会注册，已保存的模型配置会保留。',
+  modelSection: '模型与推理档位',
+  modelSectionHint: '选择审查模型和推理档位',
+  sectionExpand: '展开',
+  sectionCollapse: '收起',
   patrolTitle: '巡逻模式（自动检测跑偏）',
   patrolDescription: '执行过程中每隔若干步自动把会话快照发给审查模型检查方向；发现跑偏会在下一步注入纠偏，STOP 时要求执行模型停下向用户报告。每次巡逻整段会话计费一次审查模型。',
   patrolToggle: '启用巡逻',
@@ -77,6 +84,13 @@ export const en: Record<LocaleKey, string> = {
   saved: 'Saved',
   saveFailed: 'Save failed, please retry',
   readonly: 'The settings document is read-only here.',
+  enabledToggle: 'Enable advisor plugin',
+  enabledHintOn: 'Master switch is on: once a reviewer is configured, the advisor tool becomes visible to the executor.',
+  enabledHintOff: 'Master switch is off: the advisor tool and guideline prompt section are not registered; saved settings are kept.',
+  modelSection: 'Reviewer model & effort',
+  modelSectionHint: 'Pick the reviewer model and reasoning effort',
+  sectionExpand: 'Expand',
+  sectionCollapse: 'Collapse',
   patrolTitle: 'Patrol mode (automatic drift detection)',
   patrolDescription: 'Every few steps the conversation snapshot is sent to the reviewer to check direction; on drift a correction is injected into the next request, and STOP asks the executor to halt and report. Each patrol bills the full conversation to the reviewer once.',
   patrolToggle: 'Enable patrol',

package/src/config.ts

@@ -4,8 +4,9 @@
  * 配置三层合成（rc.6 settings 服务）：schema 默认值 → 插件组合层 base →
  * 用户层（~/.dsh/settings.yaml 的 advisor: 段，设置页卡片写入的就是这一层）。
  *
- * `provider` + `model` 两者齐备 advisor 才武装（对应 rpiv 的 "off costs
- * nothing"：没有审查模型时工具与提示词段都不注册）。
+ * `enabled` 是用户总开关；`provider` + `model` 齐备且总开关打开时 advisor
+ * 才武装（对应 rpiv 的 "off costs nothing"：关闭或没有审查模型时，工具与
+ * 提示词段都不注册）。
  *
  * disabledForModels 条目语法（字符串数组，与设置页文案一致）：
  *   "model"                 —— 任意 provider 跑该模型都禁用
@@ -16,6 +17,7 @@
 import z from '@deepseek-ai/schemastery'
 
 export interface Config {
+  enabled?: boolean
   provider?: string
   model?: string
   effort?: string
@@ -28,6 +30,7 @@ export interface Config {
 }
 
 export const Config: z<Config> = z.object({
+  enabled: z.boolean().default(true).description('advisor 总开关：关闭后不注册 advisor 工具与升级守则提示段，已保存的模型配置保留'),
   provider: z.string().default('').description('审查模型所在的 provider 路由名（ctx.llm 适配器路由，如 example-provider）'),
   model: z.string().default('').description('该路由下的审查模型 id（如 deepseek-v4-pro）'),
   effort: z.string().default('').description('审查模型推理档位；留空走模型默认'),
@@ -47,6 +50,7 @@ export interface Selection {
 }
 
 export function resolveSelection(config: Config): Selection | undefined {
+  if (config.enabled === false) return undefined
   const { provider, model } = config
   if (provider === undefined || provider === '' || model === undefined || model === '') return undefined
   return config.effort === undefined || config.effort === ''