dsh-advisor-plugin 0.2.1

package/lib/client/locales.d.ts

@@ -0,0 +1,54 @@
+/**
+ * locales —— Advisor 设置卡片的 zh/en 文案。
+ */
+export declare const zh: {
+    readonly title: "Advisor 审查模型";
+    readonly description: "执行模型卡住/做重大决策/宣告完成前，可调用零参数的 advisor() 工具升级咨询该审查模型，拿回计划、纠正或停止信号。整段会话每次调用都会转发给它——升级不免费。";
+    readonly armed: "当前审查模型";
+    readonly off: "未选择——advisor 工具对模型隐藏（零提示词成本）";
+    readonly offCurrent: "未选择";
+    readonly choose: "选择一个 DSH 已配置的模型：";
+    readonly loading: "正在加载模型目录…";
+    readonly loadFailed: "模型目录加载失败";
+    readonly retry: "重试";
+    readonly partial: "部分 provider 的模型列表获取失败，列表可能不完整。";
+    readonly empty: "没有可配置的模型——请先在 设置 → 模型 里配置 provider。";
+    readonly effort: "推理档位";
+    readonly effortDefault: "（模型默认）";
+    readonly effortHint: "留空走模型默认；该模型未声明支持档位——若配置的档位不被支持，插件会自动降级为默认档（日志可见）。";
+    readonly effortHintKnown: "只列出该模型声明支持的档位；留空走模型默认。";
+    readonly unavailable: "（已配置的路由不在当前模型目录中）";
+    readonly save: "保存";
+    readonly saving: "保存中…";
+    readonly discard: "放弃更改";
+    readonly saved: "已保存";
+    readonly saveFailed: "保存失败，请重试";
+    readonly readonly: "设置文档只读，无法在此修改。";
+    readonly patrolTitle: "巡逻模式（自动检测跑偏）";
+    readonly patrolDescription: "执行过程中每隔若干步自动把会话快照发给审查模型检查方向；发现跑偏会在下一步注入纠偏，STOP 时要求执行模型停下向用户报告。每次巡逻整段会话计费一次审查模型。";
+    readonly patrolToggle: "启用巡逻";
+    readonly patrolEverySteps: "巡逻间隔（步数）";
+    readonly patrolEveryStepsHint: "每 N 个模型请求做一次巡逻检查；两次巡逻之间另有至少 90 秒的节流。";
+    readonly patrolImmuneTurns: "纠偏冷却（请求数）";
+    readonly investigateToggle: "审查者调查工具";
+    readonly investigateHint: "允许审查模型在裁决前用只读工具（工作区内搜索/读文件）亲自核实事实；重复建议与空话建议会被自动去重/丢弃。";
+    readonly toolTitle: "咨询";
+    readonly toolRunning: "进行中";
+    readonly toolDone: "完成";
+    readonly toolFailed: "失败";
+    readonly toolConsulting: "正在向审查模型转发整段会话…";
+    readonly toolExpand: "展开建议全文";
+    readonly toolCollapse: "收起";
+    readonly patrolCardTitle: "巡逻裁决";
+    readonly patrolCheckTitle: "巡逻检查";
+    readonly patrolVerdictOnTrack: "正常";
+    readonly patrolVerdictCorrection: "纠偏";
+    readonly patrolVerdictStop: "叫停";
+    readonly patrolCardStepPrefix: "第 ";
+    readonly patrolCardStepSuffix: " 步";
+    readonly patrolExpand: "展开裁决全文";
+    readonly patrolCollapse: "收起";
+    readonly patrolDowngradedTag: "冷却降级·未注入";
+};
+export type LocaleKey = keyof typeof zh;
+export declare const en: Record<LocaleKey, string>;

package/lib/client/locales.js

@@ -0,0 +1,101 @@
+/**
+ * locales —— Advisor 设置卡片的 zh/en 文案。
+ */
+export const zh = {
+    title: 'Advisor 审查模型',
+    description: '执行模型卡住/做重大决策/宣告完成前，可调用零参数的 advisor() 工具升级咨询该审查模型，拿回计划、纠正或停止信号。整段会话每次调用都会转发给它——升级不免费。',
+    armed: '当前审查模型',
+    off: '未选择——advisor 工具对模型隐藏（零提示词成本）',
+    offCurrent: '未选择',
+    choose: '选择一个 DSH 已配置的模型：',
+    loading: '正在加载模型目录…',
+    loadFailed: '模型目录加载失败',
+    retry: '重试',
+    partial: '部分 provider 的模型列表获取失败，列表可能不完整。',
+    empty: '没有可配置的模型——请先在 设置 → 模型 里配置 provider。',
+    effort: '推理档位',
+    effortDefault: '（模型默认）',
+    effortHint: '留空走模型默认；该模型未声明支持档位——若配置的档位不被支持，插件会自动降级为默认档（日志可见）。',
+    effortHintKnown: '只列出该模型声明支持的档位；留空走模型默认。',
+    unavailable: '（已配置的路由不在当前模型目录中）',
+    save: '保存',
+    saving: '保存中…',
+    discard: '放弃更改',
+    saved: '已保存',
+    saveFailed: '保存失败，请重试',
+    readonly: '设置文档只读，无法在此修改。',
+    patrolTitle: '巡逻模式（自动检测跑偏）',
+    patrolDescription: '执行过程中每隔若干步自动把会话快照发给审查模型检查方向；发现跑偏会在下一步注入纠偏，STOP 时要求执行模型停下向用户报告。每次巡逻整段会话计费一次审查模型。',
+    patrolToggle: '启用巡逻',
+    patrolEverySteps: '巡逻间隔（步数）',
+    patrolEveryStepsHint: '每 N 个模型请求做一次巡逻检查；两次巡逻之间另有至少 90 秒的节流。',
+    patrolImmuneTurns: '纠偏冷却（请求数）',
+    investigateToggle: '审查者调查工具',
+    investigateHint: '允许审查模型在裁决前用只读工具（工作区内搜索/读文件）亲自核实事实；重复建议与空话建议会被自动去重/丢弃。',
+    toolTitle: '咨询',
+    toolRunning: '进行中',
+    toolDone: '完成',
+    toolFailed: '失败',
+    toolConsulting: '正在向审查模型转发整段会话…',
+    toolExpand: '展开建议全文',
+    toolCollapse: '收起',
+    patrolCardTitle: '巡逻裁决',
+    patrolCheckTitle: '巡逻检查',
+    patrolVerdictOnTrack: '正常',
+    patrolVerdictCorrection: '纠偏',
+    patrolVerdictStop: '叫停',
+    patrolCardStepPrefix: '第 ',
+    patrolCardStepSuffix: ' 步',
+    patrolExpand: '展开裁决全文',
+    patrolCollapse: '收起',
+    patrolDowngradedTag: '冷却降级·未注入',
+};
+export const en = {
+    title: 'Advisor reviewer model',
+    description: 'The executor model may call the zero-parameter advisor() tool when stuck, before major decisions, or before declaring done. The whole conversation is forwarded to this reviewer each call — escalation is not free.',
+    armed: 'Current reviewer',
+    off: 'None selected — the advisor tool is hidden from the model (zero prompt cost)',
+    offCurrent: 'None selected',
+    choose: 'Pick one of the models DSH already has configured:',
+    loading: 'Loading model catalog…',
+    loadFailed: 'Failed to load the model catalog',
+    retry: 'Retry',
+    partial: 'Some providers failed to list models; the catalog may be incomplete.',
+    empty: 'No configurable models — configure a provider under Settings → Models first.',
+    effort: 'Reasoning effort',
+    effortDefault: '(model default)',
+    effortHint: 'Leave empty for the model default; this model declares no effort support — an unsupported configured effort falls back to the model default automatically (see logs).',
+    effortHintKnown: 'Only levels this model declares as supported are listed; empty means the model default.',
+    unavailable: '(configured route is not in the current catalog)',
+    save: 'Save',
+    saving: 'Saving…',
+    discard: 'Discard changes',
+    saved: 'Saved',
+    saveFailed: 'Save failed, please retry',
+    readonly: 'The settings document is read-only here.',
+    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',
+    patrolEverySteps: 'Patrol interval (steps)',
+    patrolEveryStepsHint: 'One patrol check per N model requests; throttled to at most one patrol per 90 seconds.',
+    patrolImmuneTurns: 'Correction cooldown (requests)',
+    investigateToggle: 'Reviewer investigation tools',
+    investigateHint: 'Let the reviewer verify facts with read-only tools (workspace search / file read) before ruling; duplicate and content-free advice is auto-deduped/dropped.',
+    toolTitle: 'consultation',
+    toolRunning: 'running',
+    toolDone: 'done',
+    toolFailed: 'failed',
+    toolConsulting: 'forwarding the whole conversation to the reviewer…',
+    toolExpand: 'show guidance',
+    toolCollapse: 'collapse',
+    patrolCardTitle: 'patrol verdict',
+    patrolCheckTitle: 'patrol check',
+    patrolVerdictOnTrack: 'on track',
+    patrolVerdictCorrection: 'correction',
+    patrolVerdictStop: 'stop',
+    patrolCardStepPrefix: 'step ',
+    patrolCardStepSuffix: '',
+    patrolExpand: 'show verdict',
+    patrolCollapse: 'collapse',
+    patrolDowngradedTag: 'cooldown·not injected',
+};

package/lib/client/patrol-chat.d.ts

@@ -0,0 +1,78 @@
+/**
+ * patrol-chat —— 巡逻裁决的会话聊天视图贡献（client 半）。
+ *
+ * 机制（0.1.1 实测反编译确认）：
+ *   - 会话事件流 → conversationEvents 注册的 Definition（事件→业务上下文
+ *     状态机）→ buildViewNode 物化聊天节点（kind 为判别键）→ ChatNodeSeat
+ *     按节点 kind 派发 keyed `conversation.chat.node` 槽 → 我们注册的
+ *     key 'advisor-patrol' 卡片渲染。
+ *   - Definition 匹配不独占：所有命中者各自物化。我们的 match 只认
+ *     plugin/point 双判别字段，stock 的 messageDefinition 等不会碰
+ *     log-only 的 hook/invoked，fallback 也只认 surface 事件——因此
+ *     该事件在全 UI 里只有这一张卡片，无重复渲染。
+ *   - 未装载本插件客户端（如 CLI 会话）时事件零渲染，静默无害。
+ *
+ * 类型策略：conversationEvents 服务在 0.1.1 声明于 dsh-client-runtime
+ * （本包未链接、版本间漂移），此处按结构收窄——同 controller.ts 对
+ * settingsScope 的做法，版本无关。
+ */
+import { type PatrolEventData } from '../patrol-event.js';
+/** 会话事件的最小结构（client 侧收窄读取） */
+export interface PatrolEventLike {
+    readonly type?: unknown;
+    readonly seq: number;
+    readonly time: number;
+    readonly data?: unknown;
+    readonly location?: unknown;
+}
+/** Definition match 返回的身份 */
+interface PatrolMatchResult {
+    readonly id: string;
+    readonly role: 'start';
+}
+/** 引擎喂给 start/buildViewNode 的上下文（最小结构） */
+interface PatrolNodeContext {
+    readonly key: string;
+    readonly id: string;
+    readonly start?: {
+        readonly location?: unknown;
+    } | undefined;
+    readonly matches?: readonly {
+        readonly location?: unknown;
+    }[] | undefined;
+    readonly state?: PatrolNodeState | undefined;
+}
+/** 节点数据 = 事件载荷 + 日志定位（卡片渲染的全部输入） */
+export interface PatrolNodeState extends PatrolEventData {
+    readonly seq: number;
+    readonly time: number;
+}
+/** 聊天节点的最终形态（ChatConversationViewNode 的结构子集） */
+export interface PatrolChatViewNode {
+    readonly key: string;
+    readonly kind: 'advisor-patrol';
+    readonly id: string;
+    readonly target: 'chat';
+    readonly anchorSeq: number;
+    readonly location: unknown;
+    readonly visibility: 'visible';
+    readonly data: PatrolNodeState;
+}
+/** 巡逻裁决的聊天 Definition（纯工厂，可单测） */
+export declare function patrolChatDefinition(): {
+    kind: 'advisor-patrol';
+    target: 'chat';
+    match(event: PatrolEventLike): PatrolMatchResult | null;
+    start(_context: unknown, match: {
+        event: PatrolEventLike;
+    }): PatrolNodeState;
+    update(context: {
+        state: PatrolNodeState;
+    }): PatrolNodeState;
+    buildViewNode(context: PatrolNodeContext): PatrolChatViewNode | null;
+};
+/** conversationEvents 服务的结构化最小面（版本无关收窄） */
+export interface ConversationEventsService {
+    register(definition: ReturnType<typeof patrolChatDefinition>): () => void;
+}
+export {};

package/lib/client/patrol-chat.js

@@ -0,0 +1,54 @@
+/**
+ * patrol-chat —— 巡逻裁决的会话聊天视图贡献（client 半）。
+ *
+ * 机制（0.1.1 实测反编译确认）：
+ *   - 会话事件流 → conversationEvents 注册的 Definition（事件→业务上下文
+ *     状态机）→ buildViewNode 物化聊天节点（kind 为判别键）→ ChatNodeSeat
+ *     按节点 kind 派发 keyed `conversation.chat.node` 槽 → 我们注册的
+ *     key 'advisor-patrol' 卡片渲染。
+ *   - Definition 匹配不独占：所有命中者各自物化。我们的 match 只认
+ *     plugin/point 双判别字段，stock 的 messageDefinition 等不会碰
+ *     log-only 的 hook/invoked，fallback 也只认 surface 事件——因此
+ *     该事件在全 UI 里只有这一张卡片，无重复渲染。
+ *   - 未装载本插件客户端（如 CLI 会话）时事件零渲染，静默无害。
+ *
+ * 类型策略：conversationEvents 服务在 0.1.1 声明于 dsh-client-runtime
+ * （本包未链接、版本间漂移），此处按结构收窄——同 controller.ts 对
+ * settingsScope 的做法，版本无关。
+ */
+import { isPatrolVerdictEvent } from '../patrol-event.js';
+/** 事件定位兜底：start 匹配的位置 → 首个匹配的位置 → 未解析 */
+function patrolLocation(context) {
+    return context.start?.location ?? context.matches?.[0]?.location ?? { kind: 'unresolved' };
+}
+/** 巡逻裁决的聊天 Definition（纯工厂，可单测） */
+export function patrolChatDefinition() {
+    return {
+        kind: 'advisor-patrol',
+        target: 'chat',
+        match: (event) => {
+            if (!isPatrolVerdictEvent(event))
+                return null;
+            return { id: `advisor-patrol-${event.seq}`, role: 'start' };
+        },
+        start: (_context, match) => {
+            const data = match.event.data;
+            return { ...data, seq: match.event.seq, time: match.event.time };
+        },
+        update: (context) => context.state,
+        buildViewNode: (context) => {
+            if (context.state === undefined)
+                return null;
+            return {
+                key: context.key,
+                kind: 'advisor-patrol',
+                id: context.id,
+                target: 'chat',
+                anchorSeq: context.state.seq,
+                location: patrolLocation(context),
+                visibility: 'visible',
+                data: context.state,
+            };
+        },
+    };
+}

package/lib/client/store.d.ts

@@ -0,0 +1,11 @@
+/**
+ * store —— 极简快照存储（结构兼容渲染器的 HostObservable：
+ * { getSnapshot, subscribe }），避免对官方 client-store 的值导入，
+ * 让外部 client 插件保持零运行时外部依赖。
+ */
+export interface SnapshotStore<T> {
+    getSnapshot(): T;
+    subscribe(fn: () => void): () => void;
+    set(value: T): void;
+}
+export declare function createSnapshotStore<T>(initial: T): SnapshotStore<T>;

package/lib/client/store.js

@@ -0,0 +1,23 @@
+/**
+ * store —— 极简快照存储（结构兼容渲染器的 HostObservable：
+ * { getSnapshot, subscribe }），避免对官方 client-store 的值导入，
+ * 让外部 client 插件保持零运行时外部依赖。
+ */
+export function createSnapshotStore(initial) {
+    let current = initial;
+    const listeners = new Set();
+    return {
+        getSnapshot: () => current,
+        subscribe: (fn) => {
+            listeners.add(fn);
+            return () => {
+                listeners.delete(fn);
+            };
+        },
+        set: (value) => {
+            current = value;
+            for (const fn of listeners)
+                fn();
+        },
+    };
+}

package/lib/command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * command —— `/advisor` 人类命令：报告当前审查模型选择、逐 provider 列出
+ * 可配置模型（来自 llm 服务的模型目录）、以及黑名单状态。不产生模型消息。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config, type Selection } from './config.js';
+export declare function registerAdvisorCommand(ctx: Context, getConfig: () => Config, getSelection: () => Selection | undefined, getSettingsInfo: () => string): (() => void) | undefined;

package/lib/command.js

@@ -0,0 +1,52 @@
+/**
+ * command —— `/advisor` 人类命令：报告当前审查模型选择、逐 provider 列出
+ * 可配置模型（来自 llm 服务的模型目录）、以及黑名单状态。不产生模型消息。
+ */
+import { selectionLabel } from './config.js';
+export function registerAdvisorCommand(ctx, getConfig, getSelection, getSettingsInfo) {
+    const commands = ctx.get('commands');
+    if (commands === undefined)
+        return undefined;
+    return commands.register({
+        name: 'advisor',
+        description: '查看 advisor（审查模型）配置与各 provider 可用模型',
+        handler: async () => {
+            const selection = getSelection();
+            const current = selection === undefined
+                ? '未配置审查模型——advisor 工具对模型不可见。'
+                : `Advisor：${selectionLabel(selection)}`;
+            const providers = ctx.llm.listProviders();
+            let routesBlock;
+            if (providers.length === 0) {
+                routesBlock = '没有已注册的 provider 路由（需要挂载 llm 适配器，如 llm-pi-ai）。';
+            }
+            else {
+                const perProvider = await Promise.all(providers.map(async (p) => {
+                    try {
+                        const models = await ctx.llm.listModels(p.id);
+                        const list = models.length === 0 ? '（无模型）' : models.map(m => m.id).join(', ');
+                        return `- ${p.id}（${p.name}）: ${list}`;
+                    }
+                    catch {
+                        return `- ${p.id}（${p.name}）: 模型列表获取失败`;
+                    }
+                }));
+                routesBlock = ['已注册 provider 路由与模型：', ...perProvider].join('\n');
+            }
+            const config = getConfig();
+            const blocklist = (config.disabledForModels ?? []).length === 0
+                ? '执行模型黑名单：（空）'
+                : `执行模型黑名单：${config.disabledForModels?.join(', ')}`;
+            return {
+                kind: 'success',
+                text: [
+                    current,
+                    routesBlock,
+                    blocklist,
+                    getSettingsInfo(),
+                    '在 设置 → 插件 → Advisor 卡片中选择审查模型，或直接编辑 ~/.dsh/settings.yaml 的 advisor: 段。',
+                ].join('\n'),
+            };
+        },
+    });
+}

package/lib/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * config —— schemastery 配置 schema、审查模型选择解析、执行模型黑名单语法。
+ *
+ * 配置三层合成（rc.6 settings 服务）：schema 默认值 → 插件组合层 base →
+ * 用户层（~/.dsh/settings.yaml 的 advisor: 段，设置页卡片写入的就是这一层）。
+ *
+ * `provider` + `model` 两者齐备 advisor 才武装（对应 rpiv 的 "off costs
+ * nothing"：没有审查模型时工具与提示词段都不注册）。
+ *
+ * disabledForModels 条目语法（字符串数组，与设置页文案一致）：
+ *   "model"                 —— 任意 provider 跑该模型都禁用
+ *   "provider/model"        —— 精确路由禁用
+ *   "provider/model@effort" —— 档位达到 effort 及以上才禁用
+ */
+import z from '@deepseek-ai/schemastery';
+export interface Config {
+    provider?: string;
+    model?: string;
+    effort?: string;
+    disabledForModels?: string[];
+    guidelines?: string[];
+    patrolEnabled?: boolean;
+    patrolEverySteps?: number;
+    patrolImmuneTurns?: number;
+    investigate?: boolean;
+}
+export declare const Config: z<Config>;
+/** 已武装的审查路由；undefined = advisor 关闭 */
+export interface Selection {
+    readonly provider: string;
+    readonly model: string;
+    readonly effort?: string;
+}
+export declare function resolveSelection(config: Config): Selection | undefined;
+export declare function selectionLabel(selection: Selection): string;
+/** 执行路由在当前档位下是否命中黑名单（fail-soft：未知档位/未知阈值不禁用） */
+export declare function isExecutorBlocked(config: Config, provider: string | undefined, model: string | undefined, reasoningEffort: string | undefined): boolean;

package/lib/config.js

@@ -0,0 +1,83 @@
+/**
+ * config —— schemastery 配置 schema、审查模型选择解析、执行模型黑名单语法。
+ *
+ * 配置三层合成（rc.6 settings 服务）：schema 默认值 → 插件组合层 base →
+ * 用户层（~/.dsh/settings.yaml 的 advisor: 段，设置页卡片写入的就是这一层）。
+ *
+ * `provider` + `model` 两者齐备 advisor 才武装（对应 rpiv 的 "off costs
+ * nothing"：没有审查模型时工具与提示词段都不注册）。
+ *
+ * disabledForModels 条目语法（字符串数组，与设置页文案一致）：
+ *   "model"                 —— 任意 provider 跑该模型都禁用
+ *   "provider/model"        —— 精确路由禁用
+ *   "provider/model@effort" —— 档位达到 effort 及以上才禁用
+ */
+import z from '@deepseek-ai/schemastery';
+export const Config = z.object({
+    provider: z.string().default('').description('审查模型所在的 provider 路由名（ctx.llm 适配器路由，如 example-provider）'),
+    model: z.string().default('').description('该路由下的审查模型 id（如 deepseek-v4-pro）'),
+    effort: z.string().default('').description('审查模型推理档位；留空走模型默认'),
+    disabledForModels: z.array(z.string()).default([]).description('执行模型黑名单："model" / "provider/model" / "provider/model@minEffort"'),
+    guidelines: z.array(z.string()).default([]).description('覆盖默认的升级守则（系统提示段文本，每条一行）'),
+    patrolEnabled: z.boolean().default(true).description('巡逻模式：执行中每 N 步自动把会话快照发给审查模型检查是否跑偏，跑偏时注入纠偏'),
+    patrolEverySteps: z.number().default(6).min(2).max(500).description('巡逻间隔（模型请求步数）；每次巡逻整段会话计费一次审查模型。当保底用可以配大（如 100）'),
+    patrolImmuneTurns: z.number().default(3).min(0).max(20).description('纠偏冷却：一次纠偏注入后的 N 个请求内，新的 CORRECTION 降级为只出卡片不注入（STOP 不受冷却限制）'),
+    investigate: z.boolean().default(true).description('审查者调查工具：允许审查模型在裁决前用只读工具（工作区内搜索/读文件）亲自核实，建议更有据'),
+});
+export function resolveSelection(config) {
+    const { provider, model } = config;
+    if (provider === undefined || provider === '' || model === undefined || model === '')
+        return undefined;
+    return config.effort === undefined || config.effort === ''
+        ? { provider, model }
+        : { provider, model, effort: config.effort };
+}
+export function selectionLabel(selection) {
+    return selection.effort === undefined
+        ? `${selection.provider}/${selection.model}`
+        : `${selection.provider}/${selection.model} (${selection.effort})`;
+}
+// "@minEffort" 阈值比较用的档位序；未知档位排名 NaN 而不是猜
+const EFFORT_LADDER = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+function effortRank(effort) {
+    const index = EFFORT_LADDER.indexOf(effort);
+    return index === -1 ? Number.NaN : index;
+}
+function parseRule(entry) {
+    const parts = entry.split('@');
+    const route = parts[0] ?? '';
+    const minEffort = parts[1];
+    const trimmed = route.trim();
+    if (trimmed === '')
+        return undefined;
+    const slash = trimmed.indexOf('/');
+    if (slash === -1)
+        return { model: trimmed, ...(minEffort === undefined ? {} : { minEffort }) };
+    return {
+        provider: trimmed.slice(0, slash),
+        model: trimmed.slice(slash + 1),
+        ...(minEffort === undefined ? {} : { minEffort }),
+    };
+}
+/** 执行路由在当前档位下是否命中黑名单（fail-soft：未知档位/未知阈值不禁用） */
+export function isExecutorBlocked(config, provider, model, reasoningEffort) {
+    if (provider === undefined || model === undefined)
+        return false;
+    for (const entry of config.disabledForModels ?? []) {
+        const rule = parseRule(entry);
+        if (rule === undefined)
+            continue;
+        if (rule.provider !== undefined && rule.provider !== provider)
+            continue;
+        if (rule.model !== model)
+            continue;
+        if (rule.minEffort !== undefined) {
+            const current = effortRank(reasoningEffort ?? '');
+            const floor = effortRank(rule.minEffort);
+            if (Number.isNaN(current) || Number.isNaN(floor) || current < floor)
+                continue;
+        }
+        return true;
+    }
+    return false;
+}

package/lib/emission-guard.d.ts

@@ -0,0 +1,32 @@
+/**
+ * emission-guard —— 审查建议的防噪闸（对照 oh-my-pi AdvisorEmissionGuard，
+ * 其源于生产事故：某会话 advisor 发了 309 次 advise、其中 114 次是
+ * "Stop."——防噪规则必须是代码而不是提示词）。
+ *
+ * 我们对应的问题：巡逻重复发同类 CORRECTION（实测"已咨询过不要重复"
+ * 连续纠偏）、无理由的"停止"式裁决。三道闸：
+ *   1. 归一化：大小写/NFKC/非字母数字折叠——"Stop."/"*STOP*"/"  停止！"
+ *      归一到同一个键；
+ *   2. 内容空短语黑名单：归一化后整体匹配（中英双语）——只说结论不给
+ *      理由的建议没有信息量，按 unclear 处理不打扰；
+ *   3. 会话内精确去重：已注入过的建议再次出现直接丢弃（FIFO 容量上限，
+ *      对齐 OMP 的 4096）。
+ */
+/** 会话内建议去重的历史容量（对齐 oh-my-pi） */
+export declare const ADVICE_DEDUPE_CAPACITY = 4096;
+/**
+ * 归一化建议文本（纯函数，可单测）：小写 + NFKC + 非字母数字连续段折叠为
+ * 单空格 + 修剪。\p{L} 覆盖 CJK 表意字符，中文建议同样可归一。
+ */
+export declare function normalizeAdvice(text: string): string;
+/**
+ * 归一化后的建议是否"内容空"（纯函数）：整体命中黑名单、或归一化后为空。
+ * 部分匹配不算——"停止：await 缺失会丢缓冲写"这类带理由的建议不受影响。
+ */
+export declare function isContentFreeAdvice(normalized: string): boolean;
+/**
+ * 会话内建议去重器（每 agent 一份）。返回一个判定函数：输入归一化后的
+ * 建议键，首次出现返回 true（接受并记录），重复出现返回 false（丢弃）。
+ * FIFO 容量上限防止长会话无界增长。
+ */
+export declare function createAdviceDeduper(capacity?: number): (normalized: string) => boolean;

package/lib/emission-guard.js

@@ -0,0 +1,74 @@
+/**
+ * emission-guard —— 审查建议的防噪闸（对照 oh-my-pi AdvisorEmissionGuard，
+ * 其源于生产事故：某会话 advisor 发了 309 次 advise、其中 114 次是
+ * "Stop."——防噪规则必须是代码而不是提示词）。
+ *
+ * 我们对应的问题：巡逻重复发同类 CORRECTION（实测"已咨询过不要重复"
+ * 连续纠偏）、无理由的"停止"式裁决。三道闸：
+ *   1. 归一化：大小写/NFKC/非字母数字折叠——"Stop."/"*STOP*"/"  停止！"
+ *      归一到同一个键；
+ *   2. 内容空短语黑名单：归一化后整体匹配（中英双语）——只说结论不给
+ *      理由的建议没有信息量，按 unclear 处理不打扰；
+ *   3. 会话内精确去重：已注入过的建议再次出现直接丢弃（FIFO 容量上限，
+ *      对齐 OMP 的 4096）。
+ */
+/** 会话内建议去重的历史容量（对齐 oh-my-pi） */
+export const ADVICE_DEDUPE_CAPACITY = 4_096;
+/**
+ * 归一化建议文本（纯函数，可单测）：小写 + NFKC + 非字母数字连续段折叠为
+ * 单空格 + 修剪。\p{L} 覆盖 CJK 表意字符，中文建议同样可归一。
+ */
+export function normalizeAdvice(text) {
+    return text
+        .toLowerCase()
+        .normalize('NFKC')
+        .replace(/[^\p{L}\p{N}]+/gu, ' ')
+        .trim();
+}
+/** 归一化后整体匹配的"内容空"短语——只给结论不给理由（黑名单保守收录） */
+const CONTENT_FREE_PHRASES = new Set([
+    // 英文（对齐 OMP 观测到的噪声）
+    'stop', 'stop here', 'stop now', 'halt', 'abort',
+    'done', 'task done', 'task complete', 'complete', 'finished', 'ok', 'okay', 'ok done',
+    'no issue', 'no issues', 'no issue continue', 'no concerns', 'no concern',
+    'nothing to add', 'nothing to flag', 'nothing to report', 'no notes',
+    'no further input', 'no further input needed', 'no further input required',
+    'lgtm', 'looks good', 'looks good to me', 'continue', 'keep going',
+    // 中文（patrol 裁决实测可能出现的形式；键必须是归一化后的形态——
+    // 标点已折叠为空格，如"没有问题，继续。"→"没有问题 继续"）
+    '停止', '停止吧', '立即停止', '停下来', '停下', '中止', '终止',
+    '已完成', '已完成任务', '任务完成', '任务已完成', '完成', '结束了',
+    '好的', '没有问题', '无问题', '没有问题 继续', '无需修改', '不需要修改',
+    '继续', '继续保持', '保持现状', '一切正常', '一切正常 继续', '方向正确',
+    '没有建议', '无建议', '没有要补充的', '无补充', '没有意见',
+]);
+/**
+ * 归一化后的建议是否"内容空"（纯函数）：整体命中黑名单、或归一化后为空。
+ * 部分匹配不算——"停止：await 缺失会丢缓冲写"这类带理由的建议不受影响。
+ */
+export function isContentFreeAdvice(normalized) {
+    if (normalized === '')
+        return true;
+    return CONTENT_FREE_PHRASES.has(normalized);
+}
+/**
+ * 会话内建议去重器（每 agent 一份）。返回一个判定函数：输入归一化后的
+ * 建议键，首次出现返回 true（接受并记录），重复出现返回 false（丢弃）。
+ * FIFO 容量上限防止长会话无界增长。
+ */
+export function createAdviceDeduper(capacity = ADVICE_DEDUPE_CAPACITY) {
+    const seen = new Set();
+    const order = [];
+    return (normalized) => {
+        if (seen.has(normalized))
+            return false;
+        seen.add(normalized);
+        order.push(normalized);
+        if (order.length > capacity) {
+            const oldest = order.shift();
+            if (oldest !== undefined)
+                seen.delete(oldest);
+        }
+        return true;
+    };
+}

package/lib/gating.d.ts

@@ -0,0 +1,8 @@
+/**
+ * gating —— 按 agent 动态可见性。每次解析模型请求时把执行路由对照
+ * 黑名单：命中的 agent 在自己的作用域上挂 restrict({deny:['advisor']})
+ * （工具 schema 从该 agent 的提示里消失），未命中的解除限制。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config } from './config.js';
+export declare function registerGating(ctx: Context, getConfig: () => Config, hasReviewer: () => boolean): () => void;