@modusensus/dsh-mneme 0.14.0-beta.1 → 0.14.0-beta.2

package/src/config.js

@@ -1,1344 +1,1361 @@
-import z from "@deepseek-ai/schemastery";
-import { TYPE_DECAY_DEFAULTS } from "./heat.js";
-
-// #275 容量预警的阈值默认值，单独导出：service.getCapacityHealth 在 config 缺席
-// （直连调用方 / 测试传裸对象）时也要用同一套数字判级，不能另立一份——schema 的
-// .default({}) 只在「Config() 解析过」的路径上补值，裸 config 走不到。
-// 数字锚定 #275 议题里写的形态区间（活跃数百条、归档数千条），依据见 schema 处注释。
-export const CAPACITY_WARNING_DEFAULTS = Object.freeze({
-  dbSizeWarnMb: 256,
-  archivedRowsWarn: 5000,
-  archivedRatioWarn: 0.95
-});
-
-export const Config = z.object({
-  // 记忆语言：生成记忆、注入标题与后台 LLM 提示词所用语言；'zh'（默认，
-  // 行为不变）/ 'en'。启动时读入，切换后重启生效。
-  language: z.union([z.const("zh"), z.const("en")]).default("zh")
-    .description("记忆语言：生成的记忆条目、注入标题与后台 LLM 提示词所用语言（zh=默认中文，en=英文）。"),
-  memoryDir: z.string().default("~/.dsh/memory"),
-  autoInject: z.boolean().default(true),
-  autoSummarize: z.boolean().default(true),
-  // Optional model override for summarization. When both are non-empty, they
-  // take priority over the session's current model. Empty = use the session's
-  // active provider/model (same as before).
-  summarizeProvider: z.string().default(""),
-  summarizeModel: z.string().default(""),
-  // 蒸馏转录上限（字符）。借鉴 Codex「保留原始、替代压缩摘要」的思路：
-  // 蒸馏把完整对话上下文交给 LLM 提炼，不硬裁到 8000 字就截断语义；默认
-  // 24000 字符（约覆盖一整轮中等对话），需要更完整可调大。
-  distillMaxChars: z.natural().min(1000).max(200000).default(24000),
-  // autoSummarize 节流、产出上限与写入端同会话去重（Issue #127，默认全 0/off =
-  // 零行为变化）。此前每个 turn/end 必跑、产出条数由模型输出决定、写入端只按
-  // 「同类型 + 标题 trim 全等」去重——本机实测单日 84 次、单会话一天 198 条、
-  // 同一事实 6 小时铸出 28+ 条。阀门交给用户按需拧，升级本身不改行为。
-  summarizeMinIntervalMinutes: z.natural().min(0).max(10080).default(0),
-  summarizeMaxEntriesPerRun: z.natural().min(0).max(50).default(0),
-  // Issue #239（成本感知级联第一级）：蒸馏前的零 LLM 预判——窗口内可蒸馏文本
-  // 不足此字符数时直接跳过 LLM 调用（0 = 关闭，行为与现状逐字节一致）。判定
-  // 纯规则、无模型参与；被挡下的窗口照常消费游标（否则每个 turn/end 都会重新
-  // 评估同一段短文本），并留一行 status='skipped' 审计，error_message 写明原因
-  // ——「这一窗为什么没蒸馏」必须可观测，否则阀门等于黑盒。
-  summarizeMinWindowChars: z.natural().min(0).max(100000).default(0),
-  // Issue #239（有界检查点）：同一会话最多发起多少次蒸馏（0 = 不限，等同现状）。
-  // 只统计真正发起过 LLM 调用的 run——被预判挡下的窗口不占预算，否则阀门会把
-  // 额度浪费在零成本窗口上。计数是进程内 per-session（与最小间隔闸门同生命
-  // 周期），宿主重启即清零，与 #229 的游标持久化是两件事。
-  summarizeMaxRunsPerSession: z.natural().min(0).max(1000).default(0),
-  // Issue #493：连续解析失败几次后放弃当前窗口（0 = 关闭，行为与历史版本逐字节
-  // 一致）。失败默认不推进游标——语义是「这段还没提炼完，下次接着来」，这对
-  // 偶发失败（429/5xx/超时）是对的。但确定性失败（模型把转录当成该自己回话，
-  // finish_reason=stop，同文同温）重试收益为 0，而窗口只会随新事件继续变大，
-  // 于是一条会话能被同一窗口卡死几十轮、每轮都白烧一次完整调用。设成 2-3 即
-  // 可止血：达到阈值后强制消费游标跳过该窗口，并留一行带 streak/raw_head 的
-  // error 审计。默认关是因为放弃内容本身有代价——短窗口偶尔失败仍值得重试。
-  summarizeParseFailureMaxRetries: z.natural().min(0).max(10).default(0),
-  // Issue #239（第 4 项，错峰队列）：高峰期蒸馏顺延。空串 = 关闭，行为与现状逐
-  // 字节一致。取值是本地时间的时段列表（逗号分隔，支持跨零点），可带**星期前缀**
-  // （可省；ISO 1=周一…7=周日，也认 mon..sun；省略 = 每天）：
-  //   "09:00-18:00"                      每天 09:00-18:00
-  //   "mon-fri 08:00-12:00,14:00-18:00"  工作日两段（按高峰计费的供应商即此形态）
-  //   "sat,sun 23:00-06:00"              周末跨零点段
-  // 命中高峰时：不调 LLM、不消费游标（窗口继续累积，留到非高峰一次性蒸馏——批量
-  // 比逐轮碎蒸更省），登记一行 status='skipped' / error_message='peak-hours' 审计，
-  // 并按下面的上限择时补跑。任一写法非法则整串按「未配置」处理：排程是省钱
-  // 手段，绝不该因为写错格式把蒸馏停掉。
-  summarizePeakHours: z.string().default(""),
-  // 高峰顺延上限（分钟，0 = 不设上限）：到点仍处高峰就照常跑，避免整天高峰把蒸馏
-  // 饿死。默认 120 分钟。仅在上面的时段串非空时生效。
-  summarizePeakMaxDeferMinutes: z.natural().min(0).max(1440).default(120),
-  // 落库前去重档位：off（默认，等同现状）/ title（零成本，仅拦完全同名）/
-  // vector（复用已有 embedding 列做同会话语义近邻，无 LLM 调用）。
-  summarizeDedupeMode: z.union([z.const("off"), z.const("title"), z.const("vector")]).default("off"),
-  summarizeDedupeMinSim: z.number().min(0.5).max(0.99).default(0.92),
-  summarizeDedupeWindowHours: z.natural().min(0).max(168).default(24),
-  // 智能调速器（429 保护，默认开）：蒸馏 LLM 调用全局串行排队，相邻请求
-  // 间隔 distillRateLimitIntervalMs（默认 1s 一次）；命中 429 限流时按
-  // distillRateLimitBaseDelayMs 指数退避（1s→2s→4s…）自动重试
-  // distillRateLimitRetries 次，全程对用户透明，不把 429 错误码抛给用户。
-  distillRateLimitIntervalMs: z.natural().min(0).max(60000).default(1000),
-  distillRateLimitRetries: z.natural().min(0).max(10).default(3),
-  distillRateLimitBaseDelayMs: z.natural().min(100).max(60000).default(1000),
-  maxInjectedItems: z.natural().min(1).max(20).default(5),
-  // Issue #205：注入位跨轮轮换。同一会话里，最近 N 个不同用户查询轮次注入过
-  // 的记忆本轮不再优先（新鲜优先、原序回填，槽位数不变）；长会话中避免相邻
-  // 轮次反复注入同一条（实测 15.5h 会话 86 次注入 93% 重复）。0 = 关闭（默认，
-  // 保持既有行为）。会话边界自动重置：新会话从零开始。
-  injectRotationTurns: z.natural().min(0).max(20).default(0),
-  // Issue #164①：注入单条正文截断上限可配（原硬编码 300）。截断时尾部带
-  // 提示：上限/原长/全文 memory_get 指引（BUDGET_EXCEEDED 原则——绝不静默）。
-  // 默认 300 = 与既有行为一致。
-  injectContentMaxChars: z.natural().min(60).max(4000).default(300),
-  // Issue #34（v0.7.2 引入；v0.7.11 误删后随 #333 恢复）：对话开始注入一次当前
-  // 时间。默认关 = 与既有行为一致；格式与键名不变，存量 feature_flags 恢复即生效。
-  injectTimePrefix: z.boolean().default(false),
-  importanceThreshold: z.natural().min(1).max(5).default(3),
-  // Issue #239（第 5 项）：注入条数的查询自适应（默认关）。确定性强的话题收缩注入
-  // 条数（减半、下限 1），模糊话题（回指/时间线索，或极短查询）维持
-  // maxInjectedItems 上限——只做**单向收缩**，绝不越过用户配置的上限；判据只看
-  // 查询本身，不做额外检索（先探针检索等于白付一次 fuseRecall）。
-  injectUncertaintyAdaptive: z.boolean().default(false),
-  // #249（第一批；第二批归位为注入子开关）：能力说明——「怎么用记忆」的判断
-  // 指引。落两个零注入成本的位：①`memory_search` / `memory_save` 的工具描述补
-  // 一句判断指引（工具描述是常驻文本，不进每轮上下文）；②一段 order 150 的
-  // 系统提示段（一次性、同会话内不随轮次变化，因此不作废前缀缓存），只讲总则
-  // （优先序、何时查、何时写、何时 no-op）。默认开＝基础档：#249 §10 的判据是
-  // 「只修正既有位、不引入新注入时机／新表面／额外 LLM 调用」的子项随父开关
-  // 生效——「agent 不知道何时该查、何时该写」是已实测的缺口，把它默认关着是反的。
-  // 父开关 `autoInject` 关闭时它不生效（闸门见 injectChildEnabled）；用户显式写进
-  // feature_flags 的值永远优先于这里的默认值。
-  injectGuidanceEnabled: z.boolean().default(true),
-  // #249 N3（压缩边缘双落点）：上下文即将大幅精简前抢救「正在做什么」。默认关。
-  // 触发只认「历史真的被折叠了」的压缩事件（summary / prune / 不带 error 的 end；
-  // 判定见 continuity.js 的 isCompactionEdge —— start 只是「试过」，带 error 的 end 是失败收尾），
-  // 不自定一套阈值参数——「压缩边缘」由宿主定义，我们再校准一份只会与之漂移。
-  // 为什么是「新时机 + 新表面」因而默认关：它往对话里**追加消息**（新的注入表面，
-  // 参照实现里最容易累积成一堆历史的那类），并多写一张提案表。按 §10 判据，引入
-  // 新时机/新表面/新成本的子项独立成键、默认关；只修正既有块的（基础内容分池、
-  // 库可见性行）才随父开关默认开。`pinnedInjectBudget` 与它同批，但属前者之外：
-  // 那是既有块内的预算，不是新表面。
-  // 双落点是硬要求，不能只留一半：宿主的压缩摘要器**只看对话里的内容**，只落库不
-  // 注入，等于在摘要重建里什么都没留下；只注入不落库，则压缩一过就随旧消息一起
-  // 消失。两者都做，且落库先于注入（注入失败不该丢提案）。
-  // 祖先：`autoInject`（父关则本项不生效，闸门见 injectChildEnabled）。轻量档默认
-  // 置关（见 LIGHT_MODE_OFF）：轻量档多一份注入物是反的，与 injectGuidanceEnabled
-  // 同一取舍。注意预设只是默认值而非强制——装配时用户显式开关在它之后展开，勾了就赢
-  // （合并顺序见 index.js 装配处）。
-  continuityRescueEnabled: z.boolean().default(false),
-  // #249（第一批）：B1 pin 池预算——约束/偏好类注入条目的独立小上限。约束与
-  // 偏好被静默降级是本议题的立项核心（同类知识与情景日志同池同速率摘要，实测
-  // 一轮压缩后仅保 53%、五轮 10%），故这两类不进相关性竞争、不参与跨轮轮换、
-  // 逐字保真（仅受超大条目的硬顶保护，截断仍带提示）并排在块内排序之前。
-  // 独立预算的意义：pin 不占 maxInjectedItems 名额，不会把当前任务需要的情景
-  // 候选挤出预算（另一种「批量塞历史」）。0（默认）= 关闭，注入块构成与既有
-  // 行为逐字节一致；超出预算的条数在块内如实标注未展示条数，绝不静默。
-  pinnedInjectBudget: z.natural().min(0).max(5).default(0),
-  // 编码记忆蒸馏（codingRetrospect，opt-in，默认关）。开启时，turn/end 蒸馏
-  // 额外提取三类编码专属记忆：rejected_solution（被否决方案）/ pitfall（踩坑）/
-  // constraint（工程约束）。蒸馏上下文为整轮完整对话（用户输入 → 助手思考/回答
-  // → 工具调用与结果 → 代码执行），不再只看用户消息，便于提炼踩坑根因。
-  // 关闭时行为与之前完全一致。
-  codingRetrospect: z.boolean().default(false),
-  // 编码任务识别词表（读取侧门控用）：命中即视为编码类任务，编码记忆才注入。
-  // 后一组是「工程协作动作」词：合并/开 PR/看 CI/发版/验收/冲突/分支/
-  // issue 这类话在原词表里一个都不命中，于是被判成非编码任务，编码记忆
-  // 整类被 codingGate 滤掉——生产日志里这类 query 占非编码调用的 17.1~17.8%。
-  // 只加中文：isCodingTask 是纯子串匹配，英文短词（pr/ci/commit）会命中
-  // prompt / GitHub CLI 路径这类文本，无词边界时误命中率达 57.9%。
-  // 「评审」与「审评」并列保留，不是笔误：她真实说「等审评」「看CI和审评」
-  // （非编码池内审评 9 条 / 717 次，评审 5 条 / 421 次，审评反而更多），
-  // 同义不同形，子串匹配必须两套都放，删掉任一个都会漏掉一类真实说法。
-  // 刻意不加的：事务（唯一命中是政治学「公共事务」简答）、依赖包（依赖已在表内）。
-  codingKeywords: z.array(z.string()).default([
-    "代码", "编码", "写一个", "写个", "实现", "函数", "方法", "类",
-    "接口", "bug", "调试", "报错", "错误", "异常", "堆栈", "脚本",
-    "python", "javascript", "typescript", "node", "js", "ts",
-    "sql", "sqlite", "数据库", "算法", "重构", "优化", "性能",
-    "测试", "单测", "修复", "补丁", "依赖", "npm", "pip",
-    "命令行", "shell", "配置", "配置文件", "yaml", "json",
-    "插件", "开发", "编译", "构建", "部署", "git", "commit",
-    "review", "前端", "后端", "页面", "组件", "dsh", "memos",
-    "提交", "合并", "分支", "冲突", "验收", "审查", "评审", "审评", "发版",
-    "仓库", "回滚", "推送", "拉取", "变基", "上线", "打包", "迁移",
-    "字段", "鉴权", "超时", "并发", "闪退", "白屏", "端口", "进程",
-    "守护", "定时任务", "索引", "缓存", "死锁", "内存泄漏", "日志",
-    "版本号", "环境变量"
-  ]),
-  // 编码记忆注入加权系数：编码任务时对 rejected_solution/pitfall/constraint
-  // 记忆的 importance 乘以该系数排序，让编码记忆在编码场景更靠前。
-  codingBoostFactor: z.number().min(1).max(5).default(2),
-  // 注入边界花括号转义（issue #162，v0.7.4 曾修后被 v0.7.11 重构误删）：默认开启，
-  // 在 memory / 短期上下文 / 用户设置三处注入出口对连续 2+ 个花括号插 `\`
-  // （`{{a}}`→`{\{a\}\}`），让 DSH 的 interpolate() 不再扫到非法变量名而 throw。
-  // 关闭时按原样透传。
-  escapePromptVariables: z.boolean().default(true),
-  autoDream: z.boolean().default(true),
-  dreamThresholdCount: z.natural().min(1).max(1000).default(10),
-  dreamThresholdChars: z.natural().min(100).max(100000).default(5000),
-  dreamDelayMs: z.natural().min(0).max(60000).default(2000),
-  // autoDream 触发最小间隔（分钟，0 = 不限制，Issue #89 请求 2）：高频写入
-  // 场景下防止巩固调用（含失败重试）连发刷爆配额。间隔从每次实际开跑时刻
-  // 起算，失败/degraded 的 run 也占用间隔；间隔内的触发请求静默跳过，下一次
-  // 写入事件会重新评估。
-  dreamMinIntervalMinutes: z.natural().min(0).max(10080).default(0),
-  // Issue #292（#135 派生）：autoDream 连续失败退避（opt-in，默认关 = 行为与
-  // 现状逐字节一致）。开启后调度器对连续失败做指数退避：有效最小间隔 =
-  // dreamMinIntervalMinutes × 2^连续失败数（成功一次清零恢复），封顶 30 分钟。
-  // #89 的最小间隔闸失败 run 也占用，但间隔恒定——恒定失败的模型（#135 空体
-  // 面）会按固定节奏连发刷爆配额；退避把下次重试按失败次数指数推远。基数取
-  // dreamMinIntervalMinutes：基数为 0 时无闸可翻倍，本键不自己产生间隔（先配
-  // dreamMinIntervalMinutes 再开本键）。与 dreamPeakHours / dreamMinIntervalMinutes
-  // 同族（节流阀，不新增任何 LLM 调用），故不进 LIGHT_MODE_OFF。
-  autoDreamFailureBackoff: z.boolean().default(false),
-  // Issue #557（建议 2，opt-in 默认关 = 审计行逐字节一致）：dream 审计行的输入
-  // 快照瘦身。dream_runs.input 单行体积随记忆量涨（#557 实测平均 40-79 KB/轮，
-  // 绝大部分是 content），轮数又随天数涨，两者相乘超线性（报告库占 43% 的页）。
-  // 开启后 auto 轮的快照只留骨架（id/type/title/importance/updated_at，不含
-  // content）。巩固判定不回读审计行：LLM 输入由记忆库现算（prompt 不变），
-  // snapshot_hash 在内存里对含 content 的快照计算（receipt 完整性不变）；变的
-  // 只是离线回放——原文不在库里就重算不出 hash，#512「每一行都能回放一次巩固」
-  // 对瘦身轮降级为骨架级（#275 reclaim 清过 input 的库本就丢过这层，本键把同一
-  // 权衡前移到写入期）。organize 轮不经过这里（重放载荷走 organize.js 自己的
-  // saveDreamRun），写入期与 reclaim（run_type != 'organize'）同一条边界。
-  // storage-only、不新增任何 LLM 调用，不进 LIGHT_MODE_OFF（同上定性）。
-  dreamInputSummaryEnabled: z.boolean().default(false),
-  // Issue #239（第 4 项，错峰队列）镜像到巩固：高峰期不做梦。与
-  // summarizePeakHours 同一份时段语法（复用 src/summarize.js 的 parsePeakSpec /
-  // isInPeakWindow / nextOffPeakAt，不另写解析器）：逗号分隔、可带星期前缀、支持
-  // 跨零点。空串 = 关闭，行为与现状逐字节一致。
-  //   "09:00-18:00"                      每天 09:00-18:00
-  //   "mon-fri 08:00-12:00,14:00-18:00"  工作日两段（按高峰计费的供应商即此形态）
-  // 为什么巩固比蒸馏更该有这道闸：单次巩固的输入是整窗快照（dreamMaxSnapshotSize
-  // 条），实测一次 run 的 LLM 时长可达数分钟量级，撞上高峰时既贵又慢；而它由写入
-  // 事件触发、没有天然的「等到空闲再跑」路径。命中高峰时：不调 LLM、不刷新
-  // baseline（阈值继续累积，留到非高峰一次性巩固），登记一行 status='skipped' /
-  // error_message='peak-hours' 审计，并按下面的上限择时补跑。任一写法非法则整串
-  // 按「未配置」处理——排程是省钱手段，绝不该因为写错格式把巩固停掉。
-  dreamPeakHours: z.string().default(""),
-  // 高峰顺延上限（分钟，0 = 不设上限）：到点仍处高峰就照常跑，避免整天高峰把巩固
-  // 饿死。默认 120，与 summarizePeakMaxDeferMinutes 对齐。仅在时段串非空时生效。
-  dreamPeakMaxDeferMinutes: z.natural().min(0).max(1440).default(120),
-  // 巩固模型路由（settings panel「巩固模型」/ dreamProvider+dreamModel）：
-  // dream 的记忆沉淀专用 LLM 路由，显式配置优先于 agent 默认模型（config-first，
-  // Issue #25）。模型分类声明：
-  //   - 非思考模型（推荐，如 glm-5-2 类）：无 reasoning 声明，effort 请求被 harness
-  //     拒绝后 withEffortFallback 去掉字段重试即成功；空体/no json array 风险最低。
-  //   - 思考模型（如 deepseek-v4-flash-ga 等 v4-flash-ga 系）：默认开推理，可能烧光
-  //     token 预算返回空体；且部分（如 v4-flash-ga）在 harness 侧被声明为不接受任何
-  //     reasoning effort —— 即使去掉 effort 重试，harness 的 defaultEffort 也会顶上来
-  //     再次拒绝（UNSUPPORTED_REASONING_EFFORT），插件 fallback 无法绕开。
-  //     选用时建议配 dreamReasoningEffort 并实测；不行就换非思考模型。
-  dreamProvider: z.string().description("记忆巩固专用模型的服务商（settings「巩固模型」）。巩固反复失败时，优先改用官方非思考模型的服务商（如 deepseek / glm）。"),
-  dreamModel: z.string().description("记忆巩固专用模型。建议选非思考模型（如 deepseek-chat、glm-5-2 类）：思考模型可能烧光 token 预算返回空体，导致巩固失败（UNSUPPORTED_REASONING_EFFORT）。"),
-  // Issue #135 建议 3：#9 只抬了 max（8192→131072），default 停在 32768。思考型
-  // 模型的推理与正文共享该预算，effort 未压低时 32768 恰好被推理烧光 → 空体
-  // （"no json array in llm output"，报告实测 146 轮因此失败）。默认抬到上限，
-  // 让默认配置也留足正文预算；流式计费按实际用量，不按上限。
-  //
-  // 成本审计（2026-10-12，本机库只读探针）复验了「默认值该不该降回去」这个问题，
-  // 结论是**不该降**，故默认维持 131072。三条实测证据：
-  //   1. 这个键是**上限**，不是计费口径——流式按实际用量计费（与 sleepMaxTokens
-  //      的 description 同口径）。压上限只在**真撞顶**时生效：近 10 天 88 个成功
-  //      轮 output 中位 24022、73.9% 超过 16384，因此把默认压到 16384 会让近四分之三
-  //      的正常轮撞顶。
-  //   2. 撞顶的后果不是「少烧一点」，而是**整轮失败**：max_tokens 截断 → 流上没有
-  //      完整 JSON → extractJsonArray 返回 null → finish({ok:false,
-  //      error:"no json array in llm output"})（src/dream.js:1167-1171）；而调度器
-  //      **只有 result.ok 才刷新 baseline**（src/dream.js:905-915，注释明写这是刻意
-  //      设计「失败必须能立刻重试」）→ 下一次写入用**同一批输入**重跑一遍。按 133 个
-  //      有真实用量的成功轮逐轮折算：cap=16384 撞顶 78.9%、净总量 +54.1%；
-  //      cap=24576 +43.3%；cap=32768 +15.9%；cap=49152 +6.5%；98304 起为 0。
-  //      即**调低这个值会把 token 花得更多**，而不是更少。
-  //   3. 真正的大头它治不到：把「时间就近」配上的 133 次成功调用（同一次配对里取
-  //      分子与分母）的决策正文（merge/update 的 content+title，剥离代码自动补的隐式
-  //      keep）按中英分估（中文 ≈1.5 字符/token、英文 ≈4）折 419,487 token，而同一批
-  //      调用输出合计 3,543,111 token —— 正文约占 11.8%（换算方法敏感性区间
-  //      8.2%~22.0%，逐轮中位 12.1%），其余约 88% 是推理与 JSON 骨架。
-  //      注意别用「全部有 decisions 的 run」当分子配「配对子集」的分母（会得 13.9%
-  //      这种偏高的数）——跨口径比较先校量纲、分子分母必须同集合。
-  //      病根是推理与正文共享 max_tokens 单一池子。宿主（DSH）侧确有分离机制：
-  //      DEFAULT_THINKING_BUDGETS = { minimal:1024, low:2048, medium:8192, high:16384 }、
-  //      adjustMaxTokensForThinking()（正文预算 + 推理预算相加后卡模型上限）、
-  //      clampThinkingBudgetToAnswerRoom()（MIN_ANSWER_TOKENS=1024，保证正文至少留
-  //      1024 token）——但它只对 Anthropic Claude 路径默认生效；chat-completions 网关
-  //      （volcano-engine / deepseek / glm 均在此列）须由路由 profile 开
-  //      compat.supportsThinkingTokenBudget 并指定 compat.thinkingTokenBudgetField
-  //      （vLLM/Qwen/llama.cpp 风格顶层字段，上游端点还必须认它），asar 注释明写
-  //      "Off by default"。两者都是 **profile 级**配置，插件 stream 调用无法
-  //      per-request 传递（ctx.llm.stream 唯一的推理旋钮是 reasoningEffort）——故本插件
-  //      在调用面无法单独约束推理预算：抬高这个上限是当前路由下唯一可用的止损手段，
-  //      治标不治本；治本是换非思考模型，或走能分离预算的路由 profile。
-  // 显式调小仍是允许的（min 256）：适合「宁可整轮失败也要压单轮上限」的场景，但请
-  // 知悉上面第 2 条的净成本方向。需要旧行为（无上限感）的库显式设回 131072。
-  dreamMaxTokens: z.natural().min(256).max(131072).default(131072),
-  // Pass-through reasoning effort for dream's LLM calls (Issue #135 建议 4/5).
-  // Unset (no value) resolves to the LOWEST effort the model declares before
-  // streaming: background consolidation must produce JSON, and omitting the
-  // field lets the harness substitute the model's defaultEffort (thinking-type
-  // models often default to high/max) — the reasoning then drains the whole
-  // token budget and the run dies with an empty body. Explicit 'none' still
-  // omits the field (provider default applies); off/low/medium/high are
-  // forwarded verbatim, unsupported values are remapped (v0.7.26+).
-  // Caveat: on some thinking models (e.g. v4-flash-ga) the harness declares NO
-  // supported effort, so even the fallback retry (field stripped) is rejected
-  // again via its defaultEffort — prefer a non-reasoning dreamProvider/dreamModel.
-  dreamReasoningEffort: z.union([
-    z.const("off"),
-    z.const("low"),
-    z.const("medium"),
-    z.const("high"),
-    z.const("none")
-  ]).description("巩固模型的推理档位：未配置 = 自动取模型支持的最低档（避免思考模型用自带默认档烧光预算返回空体，#135）；显式 'none' = 不发送字段、用服务商自带默认；off/low/medium/high 原样传递。模型不支持的值会自动换用其支持的档位（v0.7.26+）。"),
-  // 滑动窗口上限（v0.4.4）：autoDream 每次只对最近 dreamMaxSnapshotSize 条
-  // 记忆做 consolidation。大记忆量下全量快照会把 LLM 输入撑爆（636 记忆 →
-  // 677 "missing" errors、applied=0），窗口外的旧记忆不进 snapshot。
-  dreamMaxSnapshotSize: z.natural().min(1).max(1000).default(200),
-  // Issue #104 方向 2：单轮 archive 决策上限。一次性大扫除（12 条互不相关主题
-  // 被批量归档，其中 8 条疑似误伤长保留类型）是失控信号，与 update 上限同类的
-  // 全局闸门：skipInvalid 也不豁免，超限整单拒绝。正常清理可调高。
-  dreamMaxArchivePerRun: z.natural().min(1).max(200).default(8),
-  // #135 成本审计派生：单轮 merge 决策上限。merge 是唯一**回吐正文**的动作（每条
-  // 要求模型重新写出合并后的 content，实测平均 550 字符/条），其余动作都不带正文，
-  // 所以这是「输出里正文占比」唯一可控的杠杆。与 update/archive 上限同类：全局
-  // 闸门，skipInvalid 也不豁免，超限整单拒绝（errors 由 decisions.js 的数量闸段
-  // 统一汇总，run 记 failed）。默认 40 的校准依据（只读探针 246 轮 / 近 10 天 88 轮）：
-  // 每轮 merge 数全库 p50 7 / p90 15 / p99 28 / max 39，近 10 天 p99 39 / max 39
-  // ——40 即观测分布上沿（历史命中 0/246），与 archive 闸默认 8 恰为其 p90=max 是
-  // 同一校准法。刻意保守（不取 p90=15 之类）：超限代价不对称，整单拒绝会让调度器
-  // 不刷新 baseline、下轮同输入重跑，一次误伤约等于该轮成本 ×2，而探针里 merge≥15
-  // 的大轮正文占比正常（10~22%），没有失控特征。想拿覆盖换成本的用户可调低。
-  dreamMaxMergePerRun: z.natural().min(1).max(200).default(40),
-  // Issue #125：候选集构造方式。"window"（默认，等同现状）只取最近
-  // dreamMaxSnapshotSize 条；"hybrid" 在此基础上并入**向量翻出的高相似组**——
-  // 本机实测 45 对「双方活跃且 sim≥0.85」里 0 对能同时进窗口（窗口覆盖率 11.7%），
-  // 纯时间窗口让"该合并的一对"几乎永远碰不到面。候选总量仍由下面的上限封顶、
-  // 与库总量解耦，这是相对"调大窗口"的核心收益：输入成本不随库增长。
-  dreamCandidateMode: z.union([
-    z.const("window"),
-    z.const("hybrid")
-  ]).default("window"),
-  // hybrid 的候选总量上限；0 = 复用 dreamMaxSnapshotSize（不迁移，需要时显式覆盖）。
-  dreamCandidateMax: z.natural().min(0).max(5000).default(0),
-  // Issue #258：总览（dream_summarize）独立路由。consolidate 有 dreamMaxSnapshotSize
-  // 窗口、总览原为全库无界——两者对 ctx 的需求差 4 倍以上却强制共用 dream 路由，
-  // dreamProvider 指向小 ctx 模型时总览当场 CONTEXT_WINDOW_EXCEEDED（实测 120,969
-  // tokens > 32,768），指向大 ctx 模型则 consolidate 的卸载收益归零。未配置 = 回落
-  // dream 路由，行为逐字节不变。
-  dreamSummaryProvider: z.string().default("").description("记忆总览（dream_summarize）专用模型服务商，留空用巩固模型。总览输入为全库（或 dreamSummaryMaxInputs 上限），ctx 需求远大于 consolidation，建议大 ctx 模型（issue #258）。"),
-  dreamSummaryModel: z.string().default("").description("记忆总览（dream_summarize）专用模型，留空用巩固模型；总览输入随库增长，建议大 ctx 非思考模型（issue #258）。"),
-  // Issue #258：总览输入条数硬上限。0 = 不设上限（历史行为，库增长可能撑爆小
-  // ctx 模型）；>0 时按 updated_at 倒序保留最新的 N 条（与 consolidate 窗口同一
-  // 排序口径）。总览是常驻叙述而非逐条巩固，限输入只影响口径脚注里的条数。
-  dreamSummaryMaxInputs: z.natural().min(0).max(100000).default(0),
-  // hybrid 判"高相似"的阈值；0.85 与 sleep normal 档对齐——两个模块对"高相似"
-  // 保持同一个定义。
-  dreamCandidateMinSim: z.number().min(0.5).max(0.99).default(0.85),
-  // 叙述条（#164 对齐，opt-in）：dream 期间按共享 tag 主题聚类（dream/
-  // narratives.js），每簇 LLM 合成一条叙述落库（source=narrative、evidence
-  // 回链簇内原子记忆、求交防捏造）。按需检索、不常驻注入。默认关=行为与
-  // 此前一致；lightMode 强制关闭。
-  dreamNarrativeEnabled: z.boolean().default(false),
-  // 成簇门槛：共享同一 tag 的记忆 ≥ 此值才合成叙述条。
-  dreamNarrativeMinCluster: z.natural().min(2).max(20).default(3),
-  // document 型记忆（#164/#230，opt-in）：agent 产长文档的指针行——注册校验
-  // （文件存在 + 路径合法 + evidence 求交）、摘要 + doc_path 落库、C2 比对
-  // 去重、supersede 记账。全文归 agent，管线零触碰；默认关=行为与此前一致；
-  // lightMode 强制关闭。
-  documentMemoryEnabled: z.boolean().default(false),
-  // document 摘要行的注入预算（#230 拍板）：次优先档内最多注入的 document
-  // 行数，超预算跳过由后续候选补位。只约束注入，不约束检索。
-  documentInjectBudget: z.natural().min(1).max(5).default(2),
-  // document 的 managed 落盘目录（#296 第二批）：空串 = 跟随 memoryDir 的
-  // `<memoryDir>/documents/`。`~` / `~/` / `~\` 展开到 home，绝对路径原样用，相对
-  // 路径落在 memoryDir 下（这是本键自己的规则：memoryDir 的相对路径是原样留着的
-  // cwd 语义，两者刻意不同；`~user` 形式两边都不展开）。目录由 mneme 建，里面的
-  // `index.md`
-  // 整文件机器所有。这个目录**之外**的文件只登记指针行，正文一个字节都不碰
-  // （= #230 的「管线对正文零读零写」）；与 memoryDir 一样是路径配置，不是
-  // 行为开关，故不进 settings.js 的 feature flags 白名单、也不上面板。
-  documentDir: z.string().default(""),
-  // 日记本（QQ 机器人写日记）：跨天惰性判定 + 启动补写，正文落
-  // `<memoryDir>/diaries/<项目键>/YYYY-MM-DD.md`，记忆库里留一条 document 指针行。
-  // 默认关=行为与此前一致；lightMode 强制关闭（它要调模型，与低资源档互斥）。
-  // 与 documentMemoryEnabled **成对但不相依**：关掉文档记忆只影响「能不能被检索到」，
-  // 正文照样写——那是用户自己的日记，不该被一个检索开关收走。
-  diaryEnabled: z.boolean().default(false),
-  // 日记根目录：空串 = 跟随 `<memoryDir>/diaries/`。与 documentDir 同一套路径规则
-  // （`~` 展开、绝对路径原样、相对路径落 memoryDir 下），同样是**路径配置不是行为
-  // 开关**，故不进 settings.js 白名单、也不上面板。
-  diaryDir: z.string().default(""),
-  // QQ 收件箱目录：空串 = 从 memoryDir 推（`<memoryDir>/../media/onebot`，本机即
-  // `D:\DSH\.dsh\media\onebot`）。推出不来就报 no-inbox-dir，绝不猜别的盘。
-  diaryInboxDir: z.string().default(""),
-  // 定时写（v0.13，桉桉 2026-11-09「日记本按理来说应该需要定时写，这个要存设置中」）：
-  // 每隔 N 分钟主动检查一次「今天是否还没写」，0 = 关（只在 turn/end 与启动时判，
-  // 即此前行为）。为什么要这一项：auto.js 原来只在回合结束时判跨天，用户整天不说话
-  // 就整天不写——日记不该取决于谁先开口。它仍然**不是 cron**：定时器只负责唤醒判定，
-  // 写不写在 compose 里按落盘日期去重，所以一天最多一篇，失败也只是 warn。
-  // 上限 1440（一天）：比一天更长的间隔没有意义，因为判定单位就是「天」。
-  diaryWriteEveryMinutes: z.natural().min(0).max(1440).default(0),
-  // 隐式 keep（v0.4.4）：LLM 未提及的 snapshot 记忆自动补 {action:"keep"}，
-  // 避免"未覆盖即全拒"白白浪费整轮 run。设为 false 时保留旧的严格校验
-  // （未覆盖即拒绝整单）。
-  dreamImplicitKeep: z.boolean().default(true),
-  // 显式决策覆盖率下限（v0.4.4 fix）：dreamImplicitKeep 开启时，LLM 输出被
-  // 截断只显式 claim 少量 snapshot 记忆（claimed.size / snapshot.size < 该阈值）
-  // → 整单拒绝，防止残缺输出被隐式 keep 洗白成 ok 后再被真实 apply。0-1，
-  // 默认 0.5（至少显式覆盖一半 snapshot）。
-  dreamMinExplicitCoverage: z.number().min(0).max(1).default(0.5),
-  // Issue #89：v0.6.9（Issue #26）的宽容路径回归。默认跳过单条非法决策
-  // （未知 id / 跨类型合并等）、应用合法子集、run 记 degraded；设 false 恢复
-  // 整单拒绝的严格模式。全局上限与覆盖率下限不受此开关影响、始终整单拒绝。
-  dreamSkipInvalid: z.boolean().default(true),
-  // 显式开启后放宽跨类型合并检查（类型边界由用户自行承担）；配合
-  // dreamSkipInvalid 理解：关闭 skipInvalid 时跨类型 merge 直接整单拒绝。
-  allowCrossTypeMerge: z.boolean().default(false),
-  // issue #339 / E8 考卷：merge 护栏（默认开）。开启后合并对象命中长保留类型
-  // （preference/pattern/rejected_solution/constraint/pitfall，与 archive 护栏
-  // 同一张表）的 merge 决策整条跳过——E8 实测巩固损耗里 10/26 条被丢约束已归位
-  // guarded 类型仍被 merge 吃掉，而 archive 护栏只挡 archive 不挡 merge，
-  // 「更精炼的摘要」恰是约束失真的主通道（同类压缩管线实测：安全规则被同速压缩
-  // 一轮只剩 53%、五轮只剩 10%，且全程无任何报错信号）。skipInvalid（默认开）
-  // 时被跳条目进 dream_runs.skipped、run 记 degraded；关闭 skipInvalid 时整单
-  // 拒绝。设为 false 才恢复旧行为：guarded 类型的 merge 不再被跳过，约束可被
-  // 「更精炼的摘要」吃掉。与 allowCrossTypeMerge 同用时长 guard 先判。
-  dreamMergeGuard: z.boolean().default(true),
-  // Rule version for dream adjudication: when this bumps, older dream_runs
-  // degrade to historical evidence (their receipts no longer drive live
-  // decisions). Default 0 = no versioning in use yet.
-  policyEpoch: z.natural().min(0).max(1000000).default(0),
-
-  // --- API protection ------------------------------------------------------
-  // Optional shared token for the plugin's HTTP API. Empty (default) keeps
-  // the API open (DSH binds to 127.0.0.1 and has no built-in auth); when set,
-  // sensitive endpoints (vector-config, vector-reindex, and all write ops on
-  // profile/rules/commands) require `Authorization: Bearer <apiToken>` (or
-  // `X-DSH-Mneme-Token`). Read-only list/search/semantic stay open so the
-  // Web panel keeps working without the token.
-  apiToken: z.string(),
-
-  // --- semantic: local embedding provider (v0.2) --------------------------
-  // "openai" keeps the legacy external-API path (settings vector config);
-  // "local" runs an ONNX model in-process; "ollama" calls a local Ollama.
-  embedProvider: z.union([z.const("openai"), z.const("local"), z.const("ollama")]).default("openai"),
-
-  // Local ONNX embedder (transformers.js / onnxruntime).
-  localEmbedModel: z.string().default("Xenova/bge-small-zh-v1.5"),
-  localEmbedDimension: z.natural().default(512),
-  localEmbedDevice: z.union([z.const("cpu"), z.const("gpu")]).default("cpu"),
-  localEmbedBatchSize: z.natural().min(1).max(64).default(8),
-  // 本地嵌入的池化方式（**bug 修复，不是新能力**）：BGE 系是按 CLS 池化训练的——
-  // 模型自带的 `1_Pooling/config.json` 明确写着 `pooling_mode_cls_token: true` /
-  // `pooling_mode_mean_tokens: false`，官方 README 也是「select the last hidden state of
-  // the first token」+ L2 normalize；而 transformers.js 的 `feature-extraction` 默认 mean。
-  // ⇒ 此前本地嵌入对 BGE 系一直用错池化：**不报错、只是向量系统性偏差**，检索质量静默受损。
-  // 'auto' = 按模型族判定（BGE → cls，其余 → mean，未受影响的模型行为不变）；也可显式钉住。
-  // ⚠️ 池化决定向量空间，改它会改变 modelHash（见 local-embedder.js），既有索引会被判失配并重建。
-  localEmbedPooling: z.union([
-    z.const("auto"),
-    z.const("cls"),
-    z.const("mean")
-  ]).default("auto"),
-
-  // Ollama embedder.
-  ollamaBaseUrl: z.string().default("http://localhost:11434"),
-  ollamaModel: z.string().default("nomic-embed-text"),
-
-  // Model download/cache. When empty (default), models are cached under the
-  // user-level path ~/.dsh/mneme/models (resolved in local-embedder/reranker);
-  // a non-empty value is used verbatim.
-  embedModelCacheDir: z.string().default(""),
-  embedModelMirror: z.string().default("https://hf-mirror.com"),
-
-  // issue #194：模型文件下载的断点续传与重试。开启时 transformers.js 的 env.fetch 被
-  // 替换为带断点续传的实现（已收字节落盘、Range/If-Range 续传、空闲看门狗），大文件
-  // 中断后不必整份重来；关闭 = env.fetch 保持原样（线上回滚开关）。
-  resilientModelDownload: z.boolean().default(true),
-
-  // 自管运行时目录（issue #131）。空 = ~/.dsh/mneme/runtime：里面放收编或下载来的
-  // transformers + onnxruntime 闭包，插件经 src/runtime/loader.js 的三层解析加载它。
-  // 目的就是让这条重依赖不必留在宿主 profile 的依赖图里——profile 是所有插件共用的
-  // 依赖图，留在里面会让「装任何插件都要替它重走一遍这条链」。
-  runtimeDir: z.string().default(""),
-
-  // 运行时取件的两个来源（issue #131 / PR-C）。都是「克制」的默认：留空 = 不额外改变行为。
-  // - runtimeTarballDir：本地 .tgz 目录。某个包网络下不到时（例如 onnxruntime-node），
-  //   把 `npm pack <pkg>` 出来的 tgz 丢进这个目录即可离线取件；有它就优先于联网。
-  // - runtimeMirror：registry 镜像前缀，例如 https://npmmirror.com/mirrors/npm/ 。
-  //   留空则用 runtime-manifest.json 里写死的官方地址（那是随包发布的固定清单）。
-  runtimeTarballDir: z.string().default(""),
-  runtimeMirror: z.string().default(""),
-
-  // Vector search tuning.
-  vectorSearchTopK: z.natural().min(1).max(100).default(20),
-  vectorSearchThreshold: z.number().min(0).max(1).default(0.65),
-  hybridSearchVectorWeight: z.number().min(0).max(1).default(0.6),
-  hybridSearchKeywordWeight: z.number().min(0).max(1).default(0.4),
-  // Lazy auto-backfill of missing embeddings on boot (Bug2): when the vector
-  // API is configured and rows still lack an embedding, the index is rebuilt
-  // in the background after a short delay, rate-limited in batches. On by
-  // default; set false to keep the backfill manual only.
-  autoReindexOnBoot: z.boolean().default(true),
-  // Backfill pacing (previously hardcoded 500 / 10 / 200 in semantic.js). A
-  // fixed 500-per-boot cap meant a 4k-row backlog needed nine restarts to
-  // clear, and nothing reported that the run had been capped.
-  // reindexMaxPerBoot = 0 means "no cap, drain the whole backlog this run".
-  reindexMaxPerBoot: z.natural().default(500),
-  reindexBatchSize: z.natural().min(1).max(64).default(10),
-  reindexRateLimitMs: z.natural().default(200),
-  // Semantic-first injection (Bug4): when enabled, injectCandidates with a
-  // non-empty query recalls via the vector index first and falls back to the
-  // rule-based pick to fill/dedupe. Empty query / no vector → legacy behavior.
-  hybridInject: z.boolean().default(true),
-
-  // --- recall optimization (v0.5.0) ----------------------------------------
-  // BM25 third recall path beside vector + LIKE keyword (1.1): per-token IDF
-  // scoring recalls rows whose query terms are scattered — identifiers, code
-  // fragments, mixed CJK/ASCII — where substring LIKE cannot match.
-  bm25SearchEnabled: z.boolean().default(true),
-  // Query-aware vector cutoff (1.2) replacing the fixed 0.65: entity:/attr:
-  // prefixes loosen to 0.5, short queries tighten to 0.7, long queries loosen
-  // to 0.6, and a decisive top-1/top-5 score gap loosens to 0.5 so the tail
-  // still reaches the reranker. Off = legacy fixed threshold behavior.
-  adaptiveThresholdEnabled: z.boolean().default(true),
-  // Session-scoped hot memory (1.3): the latest N dialogue rounds rendered
-  // ahead of the long-term recall block — short-term context that never
-  // enters the memory store.
-  hotMemoryEnabled: z.boolean().default(true),
-  hotMemoryRounds: z.natural().min(1).max(50).default(5),
-  hotMemoryMaxTokens: z.natural().min(200).max(32000).default(2000),
-  // Topic-ranked injection (2.2): when a query vector is available the whole
-  // injection candidate list is re-ordered by similarity to the current
-  // query instead of keeping the rule-based order.
-  selectiveInjectEnabled: z.boolean().default(true),
-  // Search-time semantic dedup (2.3): greedy pass over the merged candidate
-  // list dropping rows whose embedding cosine-similarity to an already-kept
-  // row exceeds the threshold — duplicates are filtered at recall time
-  // instead of waiting for a dream consolidation. Opt-in aggressive mode:
-  // small embedding models can collapse legitimately distinct rows, so the
-  // default keeps every recalled row.
-  searchSemanticDedup: z.boolean().default(false),
-  searchSemanticDedupThreshold: z.number().min(0.5).max(1).default(0.95),
-
-  // Recall fusion recipe (plan #1): how the keyword/vector/BM25 ranked lists
-  // are combined into the final ranking. `blend` (default) is the legacy
-  // behavior — weighted sum for vector/hybrid, union backfill for auto —
-  // unchanged. `rrf` (Reciprocal Rank Fusion) and `minmax` (min-max normalized
-  // weighted sum) are rank/scale-aware recipes that fix the unit mismatch the
-  // issue describes (raw cosine vs keyword score vs normalized IDF are added
-  // directly). Off by default so existing behavior holds exactly.
-  recallFusion: z.union([z.const("blend"), z.const("rrf"), z.const("minmax")]).default("blend"),
-  // Attach a `signals` object { keyword, vector, bm25, final } to each search
-  // result for transparency/debugging (plan #2). Default off; when on it only
-  // decorates the returned rows, never changes the ranking.
-  signalTransparency: z.boolean().default(false),
-
-  // --- semantic: rerank layer (v0.2) --------------------------------------
-  // Opt-in by default (item ⑥): the local cross-encoder pulls in onnxruntime
-  // (transformers.js) at init, so a bare install must not load it. Only an
-  // explicit rerankEnabled=true + rerankProvider="local" constructs LocalReranker.
-  rerankEnabled: z.boolean().default(false),
-  rerankProvider: z.union([z.const("local"), z.const("none")]).default("none"),
-  rerankModel: z.string().default("Xenova/bge-reranker-base"),
-  rerankBatchSize: z.natural().min(1).max(64).default(8),
-  rerankMaxCandidates: z.natural().min(5).max(100).default(30),
-  rerankScoreThreshold: z.number().min(0).max(1).default(0.1),
-  // #188：量化档，与嵌入层的 useDtype 同语义（q8 = model_quantized.onnx，约为
-  // fp32 体积的 1/4）。此前重排层不传 dtype，即使缓存里已有量化文件也会去下载
-  // 1GB 级的 model.onnx。非法值由 transformers 在 init 时抛出 → 重排降级并告警。
-  rerankDtype: z.string().default("q8"),
-
-  // --- reflection: update decision + failure tracking (v0.2.1) ------------
-  reflectionUpdateEnabled: z.boolean().default(true),
-  reflectionFailureTracking: z.boolean().default(true),
-  reflectionUpdateMaxPerRun: z.natural().min(0).max(5).default(2),
-  reflectionUpdateMinAgeHours: z.natural().min(0).max(168).default(24),
-  // failure_memories 的启动期保留期（天）。此前在 index.js 里写死 90，是这一族
-  // 四张启动期清理表里唯一没有键可陈述的一条（#275 伞下的欠账）。形态对齐
-  // recallRetentionDays：顶层扁平键、只从配置文件改；暂不进 settings.js 白名单，
-  // 面板可调是后续的事（那要同时补 api.js 的 NESTED 表与 client.js 的面板行）。
-  // 下限取 1 而非 0：这张表的用途是「挖掘重复出现的纠正模式」，窗口太短就只剩
-  // 最近一次；要彻底停掉清理应当显式关掉 reflectionFailureTracking。
-  reflectionFailureRetentionDays: z.natural().min(1).max(3650).default(90),
-
-  // --- conflict freeze: manual review for conflicting memories (v0.2.1) ---
-  // Opt-in by default: when true, conflicting memories are not auto-merged
-  // and are marked as pending manual review instead.
-  conflictFreezeEnabled: z.boolean().default(false),
-  // Maximum number of frozen conflicts to keep pending for manual review.
-  conflictFreezeMaxPending: z.natural().min(1).max(1000).default(100),
-  // Issue #603 第 4 层（自动裁决档）：freeze 模式里相似度极高的同 scope 对直接
-  // 裁决（保留信息量更大的那条、归档另一条），不进人工队列——人只看模糊地带。
-  // 默认关：这是会归档记忆的自动动作，必须显式打开。
-  //
-  // ⚠️ Issue #616：这一档有三个已知边界，打开前先读，别当成「开了就清净」。
-  //
-  //  1) 阈值论证用的是早期快照，当前库上 0.95 等于不生效。
-  //     注释此前写「345 条有相似度、>=0.95 有 20 条（5.8%）」——2026-11-09 在
-  //     live 库重跑同口径：conflict_pending 全表 748 行，similarity 非 NULL 只有
-  //     11 行，其中 >=0.95 是 0 行，最高一对 0.914。这不是说阈值错了，是说
-  //     按 0.95 打开今晚一对都不会被判，用户会以为功能坏了。真要开，先按当前
-  //     分布重定阈值（配置下限 0.85），别沿用这两个数。
-  //
-  //  2) 它不是独立开关，是 freeze 分支的子节点。整段自动裁决都在
-  //     sleep.js 的 `if (config.conflictFreezeEnabled === true)` 里；关掉 freeze
-  //     会连它一起静默消失。面板上两个键看着平行，实际是父子。
-  //
-  //  3) 未标注 scope 会被判成同 scope。isCrossScopePair 走 scopeKeyOf，NULL 归一
-  //     成 null，null !== null 为 false，于是「归属未知」被当成「归属相同」。
-  //     live 库活跃 8259 行里 2710 行（32.8%）两个 scope 全 NULL，这批因此绕过了
-  //     「归属是用户的决定、永不自动」（v0.8.1 #170）这条守卫。改判据前不要打开。
-  //
-  // 另外 autoResolved/autoFailed 目前没有任何消费者（dream.js 只取 frozen），
-  // conflict_reviewed 台账也不记赢家、无 API 暴露——自动裁决了什么是看不见的。
-  // 可见性补齐之前，这一档只适合在能盯日志的前提下短时打开。
-  conflictAutoResolveEnabled: z.boolean().default(false),
-  conflictAutoResolveMinSimilarity: z.number().min(0.85).max(1).default(0.95),
-
-  // --- conflict ledger（issue #641，beta）-----------------------------------
-  // 冲突分诊账本的档位。真实库 788 对人审队列的全量分类：46% 近重复 + 20% 跨作用域
-  // 重复 + 5% 时序演进，真矛盾只有 ~27%——现行窄 prompt 把前 71% 全逼成了「输赢」，
-  // 再由人逐对裁决（≈30 条/天，且 92% 的对从未两侧同场）。分诊把「谁该机械处理、
-  // 谁才是真矛盾」从 LLM 手里拿回来（E13b：winner-take-all 裁决 P(毒胜出)=86.8%）。
-  //
-  //   "off"     默认。不分类、不记账，conflict 相位与本键引入前逐字节一致。
-  //   "shadow"  只分类 + 落 conflict_ledger 账本（bookkeeping，不触发 write hooks），
-  //             freeze/LLM 路径零变化——beta 实验的测量期：shadow 一周拿真实分诊
-  //             分布，验证是否复现 46/20/5/27。
-  //   "enforce" 确定性处置：T1（dup）走信息量优先 supersede（supersedeInfoFirstPair，
-  //             败者归档、胜者正文不动、可追溯注记在被归档侧）；T2（跨作用域重复）
-  //             与 T4（真矛盾）只记账——不停车、不送 LLM、不动正文；T3（时序演进）
-  //             落取代链：旧行 superseded_by/superseded_at 指向新行，两行都留着、
-  //             正文都不动，检索侧按降权处理。人审队列与 LLM 裁决都不再消费冲突
-  //             候选；与 conflictFreezeEnabled 同开时 freeze 让位（降级 shadow
-  //             + warn，#616 父子绑定不继承）。
-  //
-  // 判据唯一实现在 src/dream/triage.js；处置共享实现在 decisions.js 的
-  // supersedeInfoFirstPair。每个档位的行为都真实存在——#616 的「假成功」教训
-  // （autoMin 0.95 在现库覆盖为 0，开了等于没开）。
-  conflictLedgerMode: z.union([z.const("off"), z.const("shadow"), z.const("enforce")]).default("off"),
-  // T1（dup）档的相似度下限。检测阈值（normal 0.85）与自动档 autoMin（0.95）之间
-  // 的空带由它接管：真实库 reason 相似度回声集中在 0.85-0.93，正好落在两个阈值
-  // 之间、自动档开了也接不住的那一段。下界与检测阈值同源。
-  conflictLedgerDupMinSimilarity: z.number().min(0.85).max(1).default(0.9),
-
-  // --- entity gene (v0.3.0) -----------------------------------------------
-  // Opt-in: when false (default) nothing in the pipeline extracts entities.
-  // The storage layer (entities/entity_attrs/entity_relations tables + CRUD)
-  // is always available regardless of this flag.
-  entityExtractionEnabled: z.boolean().default(false),
-  // Optional provider override for entity extraction; empty = use the caller's
-  // default provider/model. Combined with entityExtractionModel — provider
-  // without model (or vice versa) falls through to the caller default.
-  entityExtractionProvider: z.string().default(""),
-  // Optional model override for entity extraction; empty = use the caller's
-  // default provider/model.
-  entityExtractionModel: z.string().default(""),
-  // Reasoning effort for entity extraction (issue #109), mirrors
-  // dreamReasoningEffort pass-through: 'none' omits the field / provider
-  // default; off/low/medium/high passed through. A provider that rejects the
-  // effort retries once without it, so opting in is safe to experiment with.
-  entityExtractionReasoning: z.union([
-    z.const("low"),
-    z.const("medium"),
-    z.const("high"),
-    z.const("none")
-  ]).default("none"),
-  // Cap on entities per extraction pass and attributes per entity.
-  entityExtractionMaxEntities: z.natural().min(1).max(20).default(10),
-  entityExtractionMaxAttrs: z.natural().min(1).max(50).default(20),
-  // Prefix/semantic search over entity names (used by recall).
-  entitySearchEnabled: z.boolean().default(true),
-  // 图召回轴（issue #219）：查询文本命中实体名时，把该实体挂联的记忆并入
-  // 检索融合池（与 BM25 同级的确认/回填信号）。默认关=检索行为与 #219 前
-  // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
-  entityRecallEnabled: z.boolean().default(false),
-  // 边权重演化（issue #24 块2）：touch 门控是否把被寻回路径的边权重抬升。
-  // 默认关=边初值纯由建边来源决定（store.RELATION_SOURCE_DEFAULTS），演化
-  // 不生效；开=被激活的边经 bumpRelationWeight 上涨（只加不减、封顶 1.0）。
-  graphWeightEnabled: z.boolean().default(false),
-  // 单次有效触达的抬升幅度。
-  graphWeightDelta: z.number().min(0).max(1).default(0.1),
-  // 被动确认（issue #24 块4）：heat 触达（记忆被召回/注入=被用）即对该记忆
-  // 挂联的关系边做被动确认——bumpRelationWeight 抬一格。默认关=零行为变化；
-  // 开=正常触达演化边权，「关系是用出来的」闭环落地（异常路径复核留后续块）。
-  graphPassiveConfirm: z.boolean().default(false),
-
-  // --- 图谱锚定层（issue #24 · 块1 Activation Anchoring）-------------------
-  // entityRecallEnabled 之上再开一层：以查询命中的实体为种子，沿实体关系表
-  // 级联扩散（默认深度 2），把「邻居实体挂联的记忆」也带进融合池。种子集
-  // 上限 graphSeedCap、级联深度 graphCascadeDepth 一并下发到 anchorSeeds /
-  // cascadeDepths（见 src/graph/anchoring.js）。默认关=行为与 #219 单跳轴
-  // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
-  graphAnchoringEnabled: z.boolean().default(false),
-  graphSeedCap: z.natural().min(1).max(30).default(12),
-  graphCascadeDepth: z.natural().min(1).max(3).default(2),
-
-  // 关联提示防幻觉（issue #24 块3）：图召回的候选（查询命中实体的挂联记忆）
-  // 进注入时默认只参与排序、不改变注入块构成（graphInjectHint=false 保守档）；
-  // 开启后注入文本里以固定句式「[检索线索] …」标出，引导语说明这是链路信息
-  // 非事实断言，防 LLM 单次消费把桥接召回当有依据的事实回头扩散。
-  graphInjectHint: z.boolean().default(false),
-  // 图召回候选在注入块里的独立预算（条数上限）。与 pin/document 预算同构：
-  // 不占 maxInjectedItems 名额、只约束「桥接线索」这类低信任信息的常驻占比。
-  graphInjectBudget: z.natural().min(0).max(5).default(1),
-
-  // --- sleep mode: idle-triggered deep maintenance (v0.4.0) ---------------
-  // Opt-in, off by default. Unlike autoDream (threshold-triggered, lightweight)
-  // sleep fires when the store has been quiet for sleepIdleMinutes and deep-
-  // maintains the whole library: conflict resolution, archival demotion,
-  // pattern discovery and entity relation completion. Abortable on user
-  // activity, audited into dream_runs (run_type='sleep'), and serialized with
-  // autoDream so the two never overlap.
-  sleepModeEnabled: z.boolean().default(false),
-  // Quiet window before a cycle fires (minutes).
-  sleepIdleMinutes: z.natural().min(1).max(60).default(5),
-  // Minimum gap between two sleep runs (hours) — a second idle window within
-  // this interval does not retrigger.
-  sleepMinIntervalHours: z.natural().min(1).max(168).default(8),
-  // Issue #529（C 项的替代实现）：sleep 连续失败退避（默认关 = 行为逐字节不变）。
-  // 基数是 sleepMinIntervalHours，有效间隔 = 基数 × 2^连续失败数（成功清零），
-  // 封顶 max(基数, 24 小时)——不是硬 24 小时：这个键允许配到 168，用户配 48 就是
-  // 明说「两天跑一次」，退避只能放宽间隔、不该把用户自己的基数压小。
-  // 为什么不按 issue 原案用 snapshot_hash 判据：sleep 的
-  // snapshot_hash 是**跑完之后**对 phases 结果算的哈希（dream/sleep.js 的
-  // createHash(JSON.stringify(phases))），不是输入快照；同一批输入跑两次结果不同
-  // 就会得到不同哈希，用它当「同一输入又在失败」的判据不成立。退避与 #292 的
-  // autoDreamFailureBackoff 同构：只放大既有的最小间隔闸，不新增状态面。
-  sleepFailureBackoff: z.boolean().default(false),
-  // Conflict adjudication strictness:
-  //   gentle    only high-confidence conflicts (threshold 0.92) are resolved
-  //   normal    standard dream-level (threshold 0.85)
-  //   aggressive low-confidence pairs are also adjudicated (threshold 0.75)
-  sleepConflictStrictness: z.union([
-    z.const("gentle"),
-    z.const("normal"),
-    z.const("aggressive")
-  ]).default("normal"),
-  // Issue #126：冲突阶段的动作集。"conflict"（默认 = 现状）只用 conflict/keep——
-  // 后台自动流程不静默扩张行为；"full" 开放六分支（merge / update / supersede /
-  // differentiate / conflict / keep），互补型与演进型重复因此有了正确出口，不再
-  // 被迫"输赢化"（实测抽样 10 对里 2 对属演进型/互补型，用 conflict 处理会丢信息）。
-  sleepActionSet: z.union([
-    z.const("conflict"),
-    z.const("full")
-  ]).default("conflict"),
-  // Archival demotion tiering (days since last access):
-  //   >= sleepArchiveDays  → shrink to summary, full body kept in _full_content
-  //   >= sleepCompressDays → archived outright (entity relations preserved)
-  sleepArchiveDays: z.natural().min(7).max(365).default(30),
-  sleepCompressDays: z.natural().min(7).max(365).default(90),
-  // Pattern discovery scan window (most recent memories to scan).
-  sleepPatternMinMemories: z.natural().min(10).max(1000).default(100),
-  // How far back pattern discovery considers entity attr changes (days).
-  sleepPatternLookbackDays: z.natural().min(1).max(90).default(30),
-  // Max pattern memories minted per run (0 = disabled).
-  sleepMaxPatternPerRun: z.natural().min(0).max(10).default(3),
-  // --- affective attribution (v0.13.0, issue #619) --------------------------
-  // Opt-in: when false (default) the affective phase does not run at all — no
-  // LLM call, no relations written. It exists so that a situational emotion
-  // ("she was anxious on defence day") can be stored as an occasion-bound
-  // relation instead of being generalised into "she is an anxious person".
-  sleepAffectiveEnabled: z.boolean().default(false),
-  // How many **independent sessions** a candidate must span before it may be
-  // promoted to a type=pattern trait. Below this it stays an occasion-bound
-  // affective_context relation. The floor is 2 on purpose: N=1 means a single
-  // occasion, and a single occasion is exactly what must never become a trait
-  // (that is the failure mode this phase exists to prevent).
-  sleepAffectiveTraitMinSessions: z.natural().min(2).max(10).default(3),
-  // Max affective_context relations written per run. Same role as
-  // sleepMaxPatternPerRun for the relation channel: a runaway model that
-  // "finds" an emotion in every memory must be capped, not trusted.
-  sleepAffectiveMaxRelationsPerRun: z.natural().min(0).max(50).default(10),
-  // Optional LLM route override for sleep's bulk passes (empty = use dream
-  // route / agent default model).
-  sleepProvider: z.string().default("").description("sleep 深维护专用模型服务商，留空用巩固模型或当前模型。"),
-  sleepModel: z.string().default("").description("sleep 深维护专用模型，留空用巩固模型或当前模型；建议同巩固模型选非思考模型。"),
-  // Pass-through reasoning effort for sleep's LLM passes, same semantics as
-  // dreamReasoningEffort (Issue #135 建议 4/5): unset resolves to the lowest
-  // effort the model declares; explicit 'none' omits the field; off/low/
-  // medium/high are forwarded verbatim.
-  sleepReasoningEffort: z.union([
-    z.const("off"),
-    z.const("low"),
-    z.const("medium"),
-    z.const("high"),
-    z.const("none")
-  ]).description("同 dreamReasoningEffort：sleep 各阶段 LLM 的推理档位，未配置 = 自动取模型支持的最低档；显式 'none' = 不发送字段、用服务商自带默认。"),
-  // Pass-through reasoning effort for the distill (summarize) LLM call
-  // (issue #315). Mirrors entityExtractionReasoning rather than dream: the
-  // default 'none' omits the field entirely (provider default), so current
-  // behavior is unchanged until the user opts in — no auto-lowest resolution
-  // here, distill failures are retried at the window level anyway. off/low/
-  // medium/high are forwarded verbatim; a provider that rejects the effort
-  // retries once without it (withEffortFallback), so opting in is safe to
-  // experiment with. The failure being addressed is the #9 shape on the
-  // distill path: a thinking model drains the output budget on reasoning and
-  // the summary comes back empty/truncated.
-  summarizeReasoningEffort: z.union([
-    z.const("off"),
-    z.const("low"),
-    z.const("medium"),
-    z.const("high"),
-    z.const("none")
-  ]).default("none").description("蒸馏（会话总结提炼）LLM 的推理档位：默认 'none' = 不发送字段、用服务商自带默认；off/low/medium/high 原样传递，被模型拒收时自动去掉字段重试一次（与巩固/睡眠同款降级，#315）。思考型模型建议 off/low，避免推理烧光输出预算。"),
-  // Issue #257：sleep 冲突/模式两阶段的输出预算（原硬编码 2048）。实测默认档
-  // 每对裁决约 90 token、24 对 2097——2048 恰好压在边界（53 次运行 48 败）；
-  // full 档六分支实测约 290 token/对、24 对 6967，2048 必然截断。默认 8192
-  // 覆盖实测峰值（候选对按「每记忆至多一对」去重，饱和在 ~25 对、不随库无限
-  // 增长）；流式计费按实际用量，不按上限。
-  sleepMaxTokens: z.natural().min(256).max(131072).default(8192).description("sleep 冲突消解与模式发现阶段的 LLM 输出预算上限（token）。原为硬编码 2048，sleepActionSet=full 实测需约 7000 导致裁决被截断而整轮失败；流式计费按实际用量，调大不增加成本。"),
-
-  // Issue #529：冲突阶段此前没有任何输入侧预算——同 scope 的全部相似对被一次性
-  // 拼进一个 prompt，实测单请求 163,054 输入 token（服务端 --ctx-size 163,840，
-  // 占 99.5%），449 对的池子必然撞墙；而失败的轮次不落 pairs、判 keep 又是
-  // no-op，下一轮冷却结束再送**完全相同的输入**，于是 23 轮连续 llm failed。
-  // 输出侧早有 sleepMaxTokens（#257），输入侧这一半一直是空的。
-  //
-  // 每批上限：0 = 不设上限（严格回退到旧的一次性全送，用于排查"是不是分批
-  // 引入的差异"）。取 12 是因为实测单对约 112~168 输入 token、12 对落在
-  // 1.5K~2K 区间，远低于任何服务商的上下文窗口，也不至于让 LLM 在长清单里
-  // 走神。
-  sleepConflictMaxPairs: z.natural().min(0).max(500).default(12).description("sleep 冲突阶段每批送给 LLM 的候选对上限（0 = 不设上限，回退旧的一次性全送）。实测单对约 112~168 输入 token，默认 12 对约 1.5K~2K。"),
-  // 每轮总上限：分批之后仍要有个总闸，否则一个 449 对的池子会拆成 38 批、
-  // 每批一次 LLM 往返，单轮跑上几小时（本身也没比撞墙好）。0 = 不设上限。
-  // 未入选的对不是"被丢弃"——它们留在 conflict_pending 与下一轮的候选池里。
-  sleepConflictMaxPairsPerRun: z.natural().min(0).max(5000).default(60).description("sleep 冲突阶段单轮累计裁定的候选对上限（0 = 不设上限）。默认 60 对 ≈ 5 批，约 10K 输入 token。"),
-
-  // --- epistemic trust: memory source credibility (v0.4.5) -----------------
-  // Distinguish memories by source: observation (measured / witnessed),
-  // subjective (opinion / guess) and inferred (derived from other evidence).
-  // Opt-in by default: when false (default) retrieval ranking, injection
-  // marking and dream merge/conflict keepSource are untouched and
-  // epistemic_status stays inert data (still written + inferred on save, just
-  // never used to influence behavior).
-  trustEpistemicWeighting: z.boolean().default(false),
-
-  // --- memory quality filter (Bug7) ------------------------------------------
-  // Heuristic gate on what deserves the injection/recall surface. When enabled,
-  // saveWithDedupe scores each new memory after dedupe and before write:
-  //   score >= degradeThreshold (60) → stored normally
-  //   archiveThreshold (30) <= score < 60 → quality_score persisted and the
-  //       injection sort re-ranks by importance * quality_score/100 (degraded)
-  //   score < 30 → archived + tagged low_quality (still explicitly searchable)
-  // Meta-memory markers, near-duplicates and repetitive filler lose points.
-  // "Repetitive" is trigram repetition > 0.7 (this change). The shipped v0.7.12
-  // measure was unique-chars/total, which decays with length: it flagged 94% of
-  // 800-2000 char memories and 100% of longer ones, i.e. long Chinese prose was
-  // punished for being long. Threshold rationale lives in quality-filter.js.
-  memoryQualityFilter: z.object({
-    enabled: z.boolean().default(true),
-    archiveThreshold: z.natural().min(1).max(100).default(30),
-    degradeThreshold: z.natural().min(1).max(100).default(60),
-    minContentLength: z.natural().min(1).max(1000).default(10),
-    // Issue #135 附属发现 1：importance ≥ 该值的记忆不参与静默自动归档——评分
-    // 与信号标签照常写入（可观测）、注入排序照常降权，但 setArchived 跳过。
-    // 报告实测 150 条低分归档里 128 条 importance ≥ 4（51 条 = 5）。设 1 = 全部
-    // 豁免（等效关闭自动归档），设 5 = 仅最重要的豁免。
-    exemptImportance: z.natural().min(1).max(5).default(4)
-  }).default({}),
-
-  // --- LLM audit trail (Bug8) ------------------------------------------------
-  // Records every background LLM call into llm_audit_logs: tokens, duration,
-  // status and which trigger produced it. Failures are recorded as
-  // status='error' and never block the feature. retentionDays bounds the table:
-  // older rows are purged on boot.
-  //
-  // Covered trigger_source values: autoDream (consolidation + summary),
-  // autoSummarize (compression), sleep (conflict + pattern) and entityExtract
-  // (issue #250 — the last two were structurally missing the hook, not a
-  // deliberate narrowing). entityExtract runs on every memory write, so row
-  // growth scales with write volume; retentionDays caps the ceiling but not the
-  // rate. If that turns out too fast, sample by operation_type or give it a
-  // separate retention — do not add a second gate: this flag is the single one.
-  llmAudit: z.object({
-    enabled: z.boolean().default(true),
-    retentionDays: z.natural().min(1).max(3650).default(90)
-  }).default({}),
-
-  // --- distill records + provenance (#399) ------------------------------------
-  // 蒸馏把窗口压成记忆后，原文默认不留——于是「这条记忆出自哪段对话」事后无法
-  // 复核（arXiv 2609.36059 §3 Eq.1：旁路索引不丢信息，替换才丢）。开启后蒸馏时
-  // 顺带把**公开**正文原样落盘（distill_records），并给写出的记忆挂上窗口链接
-  // （memory_provenance）。默认关：这是一份对话原文副本，价值与暴露面都取决于
-  // 用户是否愿意留档，不该由升级默认打开。
-  //
-  // retentionDays 只裁 distill_records（启动即清，挂 llmAudit purge 旁）；链接
-  // 保留指向空区间，面板/CLI 显示「来源已过期」——删原文不等于篡改历史。落盘
-  // 文本不受 distillMaxChars / trim(args,300) / trim(out,500) 约束（记录是凭证，
-  // 不是喂给 LLM 的预算）；工具调用入参与结果、code 输出不落盘（推理亦然）。
-  distillRecords: z.object({
-    enabled: z.boolean().default(false),
-    retentionDays: z.natural().min(1).max(3650).default(90)
-  }).default({}),
-
-  // --- capacity warning (#275: 空间维度) ---------------------------------------
-  // 容量预警：库体积 / 归档区规模过线时在 /health 与面板上报（维护者 2026-10-21
-  // 接手口径：有 retentionDays 的时间维度，缺空间维度）。三个阈值都是**观察口**，
-  // 不是动作触发：没有任何周期性消费者（/health 被读到才算一次），预警也永不
-  // 自动归档 / 删除（#275 拍板：真删由人显式确认）——所以不设 enabled 总开关，
-  // 数字恒在 /health，阈值 0 = 显式关掉那一条检查。
-  //
-  // 默认值锚定议题里的形态区间，不是拍脑袋：
-  //   dbSizeWarnMb 256 —— 议题实测 55 MB 库 VACUUM 0.8s；按同议题的归档增速
-  //     （+143 行/天 ≈ 2.8 MB/天）留约 70 天余量，正落在「现在便宜、以后贵」
-  //     该开始看数字的量级；
-  //   archivedRowsWarn 5000 —— 「归档是数千条这个量级」的上沿（议题实测 2,400
-  //     时还没坏）；
-  //   archivedRatioWarn 0.95 —— 健康形态本身就落在 0.8~0.9（活跃数百 / 归档
-  //     数千，议题实测 0.90），0.9 会对着健康库天天报警；0.95 起才是「归档区
-  //     把活跃区吞掉」的形态。
-  // 判级实现在 service.getCapacityHealth，答复挂 /health 的 capacity 块；出口是
-  // 维护卡的无损回收（dsh-mneme reclaim，见 docs/STORAGE.md）与后续批次的归档区
-  // 周期处理。增速指标（归档净增速率）在 recall-stats 的 archive 块，不在这里重复。
-  capacityWarning: z.object({
-    dbSizeWarnMb: z.natural().min(0).max(1048576).default(CAPACITY_WARNING_DEFAULTS.dbSizeWarnMb),
-    archivedRowsWarn: z.natural().min(0).max(10000000).default(CAPACITY_WARNING_DEFAULTS.archivedRowsWarn),
-    // 浮点：与 conflictAutoResolveMinSimilarity 同款（面板整数控件吃不下小数，
-    // 走 FEATURE_FLAG_NUMBER_RANGES）。
-    archivedRatioWarn: z.number().min(0).max(1).default(CAPACITY_WARNING_DEFAULTS.archivedRatioWarn)
-  }).default({}),
-
-  // --- write admission (#254) ------------------------------------------------
-  // 写入准入：把「这条该不该进库」前移到 LLM 之前。与 memoryQualityFilter 的分工
-  // 是时点不是判据——那个是**写入后**打分归档（扣分可以错，只影响排序与归档），
-  // 这个是**写入前**判定（硬拒不能错）。
-  //
-  // 两个开关都默认关（验收第 1 条「默认关零行为变化」）：
-  //   enabled — 跑第 1 级确定性判据。关时 evaluate 的返回与只计量那一阶段逐字段
-  //     一致，写入路径完全不碰。
-  //   enforce — 命中时真的拒绝。关时判据照跑、审计照留，决策回落 allow（仅告警）。
-  //     读审计时「metadata.deny 非空且 metadata.decision=allow」就是这一档的指纹。
-  // 分层是为了能把「先观察」和「开始拦」分成两次上线：enforce 打开前先在真实流量
-  // 里看误杀面，而不是靠回滚开关当保险。
-  //
-  // 第 1 级的判据面刻意收窄到两类：密钥/PII（#164 A2 是判据来源，经
-  // createWriteAdmission 的 sensitiveScan 注入；本批只定义它怎么被消费）与空白/
-  // 纯噪声文本。去重键命中**不**进第 1 级——按维护者 09-22 的判定归 write-update
-  // 放行（2606.24535 的失效模式：同步近重复门跑在异步矛盾检测之前，把本该被裁决
-  // 的矛盾直接拒掉）；G1/G2 的阈值继续只计量，等遥测有分布再单独提。
-  writeAdmission: z.object({
-    enabled: z.boolean().default(false),
-    enforce: z.boolean().default(false)
-  }).default({}),
-
-  // --- issue #380: pre-inject gate (opinion/stance judgment before injection) -
-  // 注入前判定：每帧注入候选出池后、进入 system prompt 前，一次池级 LLM 调用判出
-  // 「会向本次请求注入意见/立场」的记忆（E12 D1 口径，判定协议同源实验
-  // protocol-preinject.txt）。两级语义复用 writeAdmission：
-  //   enabled — 跑判定。判定 async prefetch + cache、同步消费（宿主 systemPrompt
-  //     渲染是同步回调，冷缓存首帧降级为不判定原样注入，下一轮同 key 生效）；
-  //     判定完成落 llm_audit_logs（trigger_source=preInjectGate，真实 token 用量，
-  //     related_memory_ids=被标记记忆）——先在真实负载看意见占比分布。
-  //   enforce — 缓存命中帧真的滤除被标记候选。E12 实测只有过滤过判据（D1 −24.4pp，
-  //     判定+标记 D2 比它差 +17.6pp——给模型看标记的线已被 E2/E3 关闭，本闸判定
-  //     结果绝不进模型上下文）。enforce 无 enabled 时无效果。
-  // 降级路径：判定失败/超时/不可解析 → 本帧原样注入 + 审计行 degraded=true 且不
-  // 缓存——防线故障永不阻塞注入。判定 LLM 走 agentDefaultModel 当前选择（entity
-  // adapter 同款装配），不设独立 provider/model 键；llmAudit.enabled=false 时本闸
-  // 不运行（无账目的判定不可见也不该花钱）。lightMode 强制关（LLM-per-turn 附加
-  // 路径与低资源档互斥）。
-  preInjectGate: z.object({
-    enabled: z.boolean().default(false),
-    enforce: z.boolean().default(false)
-  }).default({}),
-
-  // --- #164 A2: secret / PII scan at the write boundary ----------------------
-  // 写入边界的密钥 / PII 判据（src/sensitive-scan.js）自身的闸。与 writeAdmission
-  // 的 enabled 分开是有意的：那一个管 #254 第 1 级的空白 / 噪声判据，本键管 A2 这
-  // 一类判据，两批的误杀面差一个量级（空白 / 噪声没有解释空间，邮箱 / 手机号有），
-  // 绑在同一个开关上就没法单独观察 A2 的命中分布。
-  //
-  // 分层必须写清：判据的唯一调用点在 #254 第 1 级的闸门里（write-admission.js 的
-  // firstLevelHit），闸门不走第 1 级就没人来调这个扫描器。所以本键是「闸门内这一批
-  // 判据参不参与」，不是一条能独立跑的链路——单开本键就是零行为变化：
-  //   writeAdmission.enabled 关                  → 第 1 级整个不跑，本键开也没用
-  //   enabled 开 + 本键关                        → 只跑空白 / 噪声那一批
-  //   enabled 开 + 本键开 + enforce 关           → 命中留审计，写入照常（观察档）
-  //   enabled 开 + 本键开 + enforce 开           → 命中即拒绝
-  // 默认关 = 只计量那一阶段的行为逐字节保留（#332 合并时 sensitiveScan 就是 null）。
-  // #164 的「默认仅告警、拦截 opt-in」落在 enforce 上：命中落一条审计
-  // （metadata.deny.kind）但照常写入，真要拦得 enabled 与 enforce 同时开。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  sensitiveScanEnabled: z.boolean().default(false),
-
-  // --- recall evaluation: test-result storage (v0.4.6, 方案 B) --------------
-  // Separate retrieval evaluation snapshots from the production recall audit.
-  // When false (default) evaluateRetrieval still computes precision/recall/mrr
-  // and returns them to the caller, but writes nothing to recall_evals — the
-  // eval table only grows when the operator opts in. Production searchMemories
-  // audits to recall_runs and NEVER touches recall_evals, regardless of this
-  // flag (production isolation is unconditional).
-  evalPersistTestResults: z.boolean().default(false),
-
-  // --- standalone external API (v0.7.12) ------------------------------------
-  // A plain node:http server for ecosystem integrations that cannot reach the
-  // DSH-internal webServer. Disabled by default; when enabled the Bearer token
-  // is persisted in the settings kv ("external_api"), auto-generated on first
-  // boot. Bind host: keep the loopback default — moving it to a non-loopback
-  // address exposes the whole memory store to the network and is the
-  // operator's responsibility.
-  externalApiEnabled: z.boolean().default(false),
-  externalApiPort: z.natural().default(8790),
-  externalApiHost: z.string().default("127.0.0.1"),
-
-  // --- light mode preset (v0.7.12) -------------------------------------------
-  // One switch for low-resource setups: turns off every background/semantic
-  // heavy path (dream consolidation, entity extraction, vector pipeline,
-  // reranker, BM25, semantic dedup / selective inject, sleep mode) while
-  // keeping the core loop (autoInject, autoSummarize, hot memory, quality
-  // filter, keyword search). Applied by applyLightModePreset before the config
-  // reaches any service; a persisted panel_mode="light" (settings kv) counts
-  // as lightMode=true too and wins over the bundle config.
-  lightMode: z.boolean().default(false),
-
-  // --- heat: v0.7.0 self-evolution (heat + interest drift) ----------------
-  // 总开关，默认关（v0.7.12+ 用户已习惯无 heat 行为，默认开=全员行为变更）。
-  // 开启后：提供热度字段 / sleep 降级联合判定保护 / 前端热度投影，并只在
-  // 注入排序的优先级层内乘 heat（#218 v1；store 的 order=chrono 分页序与
-  // 召回融合序不动）。关闭则跳过所有 heat 计算与热度触达，注入排序乘数
-  // 恒 1，sleep 降级退回纯时间分层。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  heatEnabled: z.boolean().default(false),
-  // issue #218 / E5 效用考卷：heat 乘进注入排序在真实年龄混合下饿死老约束
-  // （现行量级 ≡ 拟合参数，注入集逐条相同；importance-only 遵从 +12.7pp），
-  // 故注入侧 heat 改为独立 opt-in：默认关 = heatEnabled 开启后热度字段/sleep
-  // 保护/前端投影照常，但注入排序乘数恒 1（与 heat 关闭逐字节一致）；
-  // 显式开启才恢复「层内乘 heat」的旧序。召回侧时钟（touchLastAccess）与
-  // sleep 降级联判不受本键影响——它们不参与注入排序。
-  injectHeatEnabled: z.boolean().default(false),
-  // 广义指数形状参数 β（heat = exp(-λ·Δt^β)，issue #218 拍板）：β=1 纯指数。
-  // 快慢以 Δt>1 小时为准——β<1 衰减更慢（亚线性长尾）、β>1 更快（超线性）；
-  // 0<Δt<1 的首小时内方向相反（Δt^β 随 β 增大而变小）。专家调优项，不进面板白名单。
-  heatGlobalBeta: z.number().min(0.5).max(2).default(1.0),
-  // per-type 衰减因子 λ；λ=0 的类型免疫（热度恒 1.0，sleep 永不降级）。
-  // 未知类型走默认 0.002。dict 的键为 type 字符串、值为数字 λ。
-  heatTypeDecay: z.dict(z.number(), z.string()).default({ ...TYPE_DECAY_DEFAULTS }),
-  // sleep 降级联合判定的热度下限：heat < 该值 且 importance<5 才允许降级。
-  sleepHeatThreshold: z.number().min(0).max(1).default(0.05),
-  // recordRecall 默认值（recall_runs 记录默认开；显式传 false 的调用方不受影响）。
-  recallRecordDefault: z.boolean().default(true),
-  // recall_runs 滚动清理保留天数。
-  recallRetentionDays: z.natural().min(1).max(3650).default(90),
-
-  // --- tool exposure: 慢模型/轻量模型的工具往返节流（v0.8.5）----------------
-  // 跨会话记忆已由 inject.js 每轮自动注入系统提示词，memory_search 只用于
-  // 「注入里没有、需要深挖」的补充检索；memory_archive 是隐藏/恢复条目的整理
-  // 操作，正常会话里很少需要。轻量模型对「何时该用工具」判断弱，容易每轮
-  // 顺手调一遍——每次工具调用都是一次串行往返（生成参数→执行→回填→再生成），
-  // 在慢模型上会被放大成明显卡顿。这两个开关允许直接隐藏对应工具（默认全
-  // 开=行为不变），隐藏后模型根本看不到它，也就不会调。也走 feature_flags
-  // 白名单，面板可启停=线上回滚开关。
-  disableMemorySearch: z.boolean().default(false),
-  disableMemoryArchive: z.boolean().default(false),
-
-  // Issue #231 第二批：agent 主动整理接口（src/organize.js）的**暴露**闸。引擎在
-  // PR #267 就造好了，当时刻意不进工具列表、不加开关（模块头注释：「与 #249 同批
-  // 暴露时只差『注册工具 + 注入指引』一步」），配置面留到这一批再定——就是这里。
-  // 与上面两个 disable* 是**反向**语义：那两个把默认在场的工具藏起来，本键把默认
-  // 不在场的能力开出来。因为 dryRun→apply 是一套两步协议（apply 必须引用真实报告
-  // 的 run_id），让 agent 未经用户同意就能整理记忆，不是「少一次往返」的成本问题，
-  // 而是「谁在改库」的授权问题。
-  // 进 LIGHT_MODE_OFF：两步协议在弱模型上最容易走歪（漏 run_id、或跳过报告直接
-  // apply——那一拒绝就是一次失败的工具调用），而一次 dryRun 的代价是一回嵌入调用
-  // 加按 type 有界扫库。这是预设给的默认值、不是强制：用户显式勾选仍然赢（合并顺序
-  // 「用户开关 > 轻量预设 > bundle」，同 continuityRescueEnabled / distillRecords.enabled）。
-  organizeEnabled: z.boolean().default(false),
-
-  // chorography（仓库地志，spec: docs/specs/2026-11-04-chorography-design.md）的
-  // 暴露闸（opt-in，默认关）：管模型侧三个只读工具（choro_search / read_page /
-  // module_map）、面板浏览页，以及 M3 的开局注入。工具描述常驻模型上下文 = 新增
-  // 成本，按仓库纪律 opt-in；默认关=工具不存在、面板页空态、注入块不渲染，行为与
-  // 0.10.1 逐字节一致。
-  //
-  // 本键仍**不进 LIGHT_MODE_OFF**，但理由收窄成一句：它是「是否启用这个子系统」，
-  // 不是「每轮付多少」。轻量档要付的是下面那条 chorographyInject（把档位压成
-  // off）——两层分开，用户才能在轻量档里保留工具、只关掉每轮那块文本。
-  chorographyEnabled: z.boolean().default(false),
-
-  // 开局注入档位（M3，spec §7）：off / light / full，默认 light。
-  // light ≤8 行（模块名 + 文件数 + 页状态 + 页路径，按「还有 N 个」明说截断）；
-  // full 列全部模块；off 不注入但工具照旧可用。
-  // 为什么是枚举而不是布尔：spec 原文就是三档，「开了但只给 6 行」与「全给」是两种
-  // 用法，布尔键表达不了；跟随 chorographyEnabled 隐式开又会丢掉「留工具、去文本」
-  // 这个组合。
-  // 为什么写作 z.union([z.const(...)]) 而不是 z.enum：与 summarizeDedupeMode 同款，
-  // 全仓枚举键统一这一种写法（z.enum 的报错文案与既有键不一致）。
-  // 轻量档**不进 LIGHT_MODE_OFF**：那张表对平铺键一律赋 false，枚举键进去会得到与
-  // schema 不符的 false，而 false !== "off" 时注入照样渲染——静默失效比不关更糟。
-  // 轻量档的压制改在消费侧（src/wiki/inject.js 的 resolveInjectTier 判 lightMode）。
-  chorographyInject: z.union([z.const("off"), z.const("light"), z.const("full")]).default("light"),
-
-  // --- scope: v0.8.0 A1 存储层（issue #17）--------------------------------
-  // 总开关默认关：关闭时写入不标注 scope、去重维持 (type, title) 现状，行为
-  // 逐字节不变。开启后**两条写入路径都自动盖章**（*_scope_source='auto'）：
-  // ① 工具调用（tools.js：memory_save / memory_update，显式参数改标 'explicit'）
-  // ② 机器提炼（summarize.js：会话蒸馏；合并进既有行时不盖章，作用域属于那一行
-  //    原来被提炼出来的语境——v0.9.0 补，此前只有工具路径盖章，于是「项目记忆」
-  //    在库里几乎不存在）。
-  // 两路的值同源：agent 维取 session header 的 agentPreset，workspace 维取
-  // registry 反查的 canonical path（header.cwd 兜底，取不到 NULL——解析绝不阻塞
-  // 写入），去重键扩展为 (type, title, agent_scope, workspace_scope, sensitivity)。
-  // 检索侧加权/过滤在 A2/A3 落地。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  scopeEnabled: z.boolean().default(false),
-  // strictScope（A3）：硬过滤模式。关闭=A2 软隔离（他 scope 降权保留可见，
-  // 检索与注入排序同权重，issue #339 补齐注入通道）；
-  // 开启后检索/注入/list/get 按 issue #17 四象限可见性公式硬过滤——带他 scope
-  // 的记忆完全不可见，未标注（NULL）恒可见；当前会话某维度解析不到时该维度
-  // 带标注的记忆一律不可见（fail-closed：身份不明只见全局）。依赖 scopeEnabled
-  // 打开才有意义（没有写入标注就无可过滤维度），但独立成键：可先开标注积累
-  // 数据、观察 A2 加权质量后再切硬过滤。
-  strictScope: z.boolean().default(false),
-
-  // scopeState（issue #471）：政策轴——作用域级可逆闸门。与上面两个键是**两条不同
-  // 的轴**：scopeEnabled/strictScope 管「这条记忆属于谁」（事实轴：持久、跟着记忆
-  // 行走、改的是归属数据），本键管「这个作用域现在通不通」（政策轴：暂时、由人单
-  // 方面按下、松开即恢复、不改任何记忆行）。
-  // 两级语义同 writeAdmission/preInjectGate——enabled 打开时被按下的作用域其候选
-  // 照常注入，但留一条审计行说清「本应被拦下几条」（观察档，先在真实流量看会少掉
-  // 多少再决定真按）；enforce 打开才真的不注入（拦截档）。两个都默认关，打开前
-  // 行为与今天逐字段一致。
-  // 不进 LIGHT_MODE_OFF：它只是查一张小表的判定，不引入重型后台路径、不加常驻
-  // 文本（同 actionPipelineEnabled 的定性）——轻量档预设该关的是重型能力，不该替
-  // 用户关掉一个纯判定入口，用户显式勾选仍然赢。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  scopeState: z.object({
-    enabled: z.boolean().default(false),
-    enforce: z.boolean().default(false)
-  }).default({}),
-
-  // --- v0.9.0 M.O.（Modus Operandi，beta）--------------------------
-  // 命名：M.O. = Modus Operandi，拉丁语「一个人一贯的做事方式」，缩写 M.O.；
-  // 也正是 org 词根 modus（modusensus）。界面主显示 M.O.，设置项 hint 第一句
-  // 给全名——缩写不靠注释解释，靠用户第一眼能看见全名。
-  // 这是客户端只读视图（做法图谱 + 对话行结算卡）的门控。API 的 effective 取值只认
-  // config 顶层/嵌套路径，schema 里没有这个键 → effective 静默少键 → 客户端读
-  // 不到就一个座位都不注册（#254 漏登记 NESTED_FLAG_PATHS 是同一个坑）。
-  // 默认关：beta 功能必须 opt-in，老用户行为逐字节不变。不进 LIGHT_MODE_OFF——
-  // 它只是只读视图、不引入任何重型后台路径，轻量档用户显式勾选仍然赢（预设
-  // 该关的是重型能力，不该替用户关掉一个纯 UI 入口）。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  actionPipelineEnabled: z.boolean().default(false),
-
-  // M.O. 执行记账（v0.9.0 第二批）：`/mo-run` 显式开一次执行窗口，窗口内的命令执行
-  // 才可能被记成一条 run。与上面那个键**分开**：上面管「看图的座位」，这个管
-  // 「往账本里写」——看图和写账是两件事，混成一个键会让「只想看图」的人不知不觉
-  // 获得写入能力。
-  //
-  // 默认关（beta 必须 opt-in）。它挂在热路径上（每个会话事件都过一次监听），
-  // 所以轻量档要关掉：`LIGHT_MODE_OFF` 里有它。
-  actionRunEnabled: z.boolean().default(false),
-
-  // M.O. 自动沉淀（v0.9.0 第三批）：会话跑完一轮后，把这个项目自己的会话日志挖一遍，
-  // 把「反复出现的同一段能力序列」落成提议（memoryDir 下），可选再落一份 draft 草稿。
-  //
-  // 与上面两个键三件事分开：actionPipelineEnabled 管「看图的座位」，actionRunEnabled
-  // 管「往账本里写」，这个管「从日志里长出候选」。三个都是独立能力，混成一个键会让
-  // 「只想看图」的人顺手获得写盘能力。
-  //
-  // 默认关（beta 必须 opt-in），并且进 LIGHT_MODE_OFF：它挂在 session/event 热路径上，
-  // 且解压会话日志是**同步**的（本机 118 份实测 16.2s），轻量档最不该背这条路径。
-  // 触发侧另有 10 分钟/项目的冷却与 budgetMs 上限（见 src/pipeline-nudge.js 的
-  // NUDGE_AUTO_MIN_INTERVAL_MS 与 src/index.js 的装配注释）——旗标只是总闸。
-  // （冷却值以常量为准：早前这里写「30 分钟」，与实际 10 分钟不符。）
-  actionNudgeEnabled: z.boolean().default(false),
-
-  // --- 人格定义页（beta）---------------------------------------------------
-  // 注入器渲染人格段的顶层总闸（双闸门的 config 半边；user_settings "persona"
-  // 键内的 persona.enabled 是 per-agent 半边，两闸同真才渲染）。API 的 effective
-  // 必须含这个键——schema 里没有它 effective 就静默少键，面板开关形同虚设
-  // （#254 漏登记 NESTED_FLAG_PATHS 是同一个坑，计数锁 test/api.test.js 钉住）。
-  // 默认关：beta 功能必须 opt-in，老用户行为逐字节不变。不进 LIGHT_MODE_OFF——
-  // 人格段是用户自写的一小段轻量常驻文本，不引入任何重型后台路径，轻量档用户
-  // 显式勾选仍然赢（同 actionPipelineEnabled 的定性）。
-  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
-  personaEnabled: z.boolean().default(false),
-
-  // 人格寻址的兜底口径（只在上一个键打开时才有意义）。关（默认，= 历史行为）：
-  // 会话身份没有卡、或有卡但卡被关掉时，一律落 default 卡——于是 default 成了
-  // 「所有没建卡的 agent 都能拿到某个人格」，宿主里跑的外部 bot（自带身份与设定）
-  // 会在同一帧里收到两句「你是谁」。开：这两种情况都不注入人格，default 退回它的
-  // 本意——只兜「这一帧解析不到会话身份」的无名会话（无身份时行为不变）。
-  // 默认关是因为这是一次口径变更：老用户升级后注入文本不许静默变化。
-  // 不进 LIGHT_MODE_OFF：它只是取卡时的一个分支，不引入常驻文本、也不引入后台路径，
-  // 且它本身只在 personaEnabled 打开时才起作用（同 scopeState 的定性）。
-  personaStrictAddressing: z.boolean().default(false),
-
-  // Issue #497：从活跃记忆反向提取「助手眼中的用户」画像**草稿**（POST
-  // /api/dsh-mneme/profile/extract）。默认关有三层理由：① 它每次点一次就是一次 LLM
-  // 调用并读上百行记忆，成本与 dream/summarize 同级，不该在没人要求时挂在面上；
-  // ② 产物会被用户当成「关于我的第一版画像」读，编造的代价不对称——所以空库直接报错、
-  // 解析失败也报错，绝不回空草稿；③ 它**不写** user_settings，采用草稿是面板里另一次
-  // 显式保存，画像正文必须是用户手写的原文，不给模型改写权。
-  // 进 LIGHT_MODE_OFF：一次调用要读上百行记忆 + 一轮模型生成，与低资源档互斥（同
-  // preInjectGate.enabled 的定性）；是预设不是强制，用户显式勾选仍然赢。
-  profileExtractEnabled: z.boolean().default(false),
-
-  // 「Agent 眼中的你」自动事实（2026-11-06，对标 ChatGPT 记忆 / DS Bot 每 bot 的
-  // MEMORY.md）：dream 巩固轮成功后按会话身份分卡增量维护一份逐条事实清单，
-  // 注入在手填画像之后（src/user-settings.js 的渲染顺序），面板可手动触发与逐条
-  // 修正（POST /api/dsh-mneme/profile-facts/*）。与 profileExtractEnabled 的三层
-  // 理由同源：① 自动轮是 dream 级别的 LLM 调用 + 读上百行记忆，不该在没人要求时
-  // 挂在面上；② 产物每帧注入，编造的代价不对称（维护 prompt 的三段硬约束与
-  // profileExtract 同源）；③ 它**不写** user_settings——手填画像神圣（#497 口径
-  // 不变），事实住独立的 profile_facts 表，可被人在面板上逐条修正。
-  // 进 LIGHT_MODE_OFF：自动维护轮与低资源档互斥（同 organizeEnabled 的定性）；
-  // 是预设不是强制，用户显式勾选仍然赢。注入段本身极轻（几十行文本），不额外
-  // 占用轻量档预算的考量见键注释末句。
-  profileFactsEnabled: z.boolean().default(false),
-
-  // chorography 面板闭环（2026-11-08 kb-qoder parity，契约见
-  // docs/plans/2026-11-08-kb-qoder-parity.md §3.1）。三个键都是「面板能不能替人
-  // 动手」的授权闸，与上面的 chorographyEnabled（子系统总闸）分层：总闸关着时
-  // 它们一律不生效，所以不必再进 LIGHT_MODE_OFF —— 轻量档要压的是「每轮付多少」，
-  // 而这三个键管的是「谁按下了重跑按钮」，关了也省不下一次调用，反倒让面板在
-  // 轻量档里静默少一块可操作区（同 chorographyEnabled 的定性与理由）。
-  //
-  // 过期的仓库在面板上直接刷新（POST /choro/run 的 refresh）。默认关：一次 T0 重跑
-  // 会扫整个仓库并重写 .chorography/ 下的页面，属于「改动工作区」的动作，不该在
-  // 没人要求时被面板顺手触发。
-  chorographyAutoRefresh: z.boolean().default(false),
-  // 面板发起 T1（POST /choro/t1）。默认**开**：这是面板闭环的主路径，关掉等于面板
-  // 上那个按钮永远是死的；真花钱的那一步仍由用户点按钮触发，且有
-  // chorographyEnabled 总闸在前面。需要「只读面板」的部署可以单独关它。
-  chorographyT1FromPanel: z.boolean().default(true),
-  // kb 子系统（知识库问答，B 线实现）的总闸。本车道只登记键与白名单，接线由后续
-  // 车道做——先有键才能让 /features 稳定暴露 false，客户端不至于静默少键。
-  kbEnabled: z.boolean().default(false),
-
-  // #539 逐会话无痕：总开关默认关，保持旧用户行为；子代理选择器默认开，但总开关
-  // 未开时不生效。手动名单是精确的 session id 匹配。
-  sessionGateEnabled: z.boolean().default(false),
-  sessionGateSubagents: z.boolean().default(true),
-  sessionGateSessions: z.array(z.string()).default([])
-});
-
-// Fields forced to false by the light-mode preset. Everything not listed here
-// (autoInject, autoSummarize, hotMemory*, memoryQualityFilter, dream
-// thresholds/delays, ...) is left untouched — those are the core loop.
-const LIGHT_MODE_OFF = [
-  "entityExtractionEnabled",
-  "autoDream",
-  "sleepModeEnabled",
-  // #619：情感归因相位要调模型、且依赖实体抽取产出（抽取关掉就没有实体可挂边），
-  // 与低资源档双重互斥。默认本就是关，这里只是轻量预设再确认一次。
-  "sleepAffectiveEnabled",
-  "rerankEnabled",
-  "autoReindexOnBoot",
-  "hybridInject",
-  // #249 第二批：能力说明在轻量档保持关闭——它是工具描述与提示段上的额外常驻
-  // 文本，轻量档（小模型 / 小上下文）不该因默认值翻转而多付这份提示成本。
-  "injectGuidanceEnabled",
-  "searchSemanticDedup",
-  "selectiveInjectEnabled",
-  "bm25SearchEnabled",
-  // 轻量模式不开图召回轴（#219，依赖实体抽取产出；抽取本身已被关掉）。
-  "entityRecallEnabled",
-  // 轻量模式不开图谱锚定层级联（#24 块1，依赖实体抽取 + 关系表，抽取已关则无边可扩）。
-  "graphAnchoringEnabled",
-  // 轻量模式不开边权重演化（#24 块2，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
-  "graphWeightEnabled",
-  // 轻量模式不开关联提示标注（#24 块3，常驻注入文本多一段提示成本）。
-  "graphInjectHint",
-  // 轻量模式不开被动确认（#24 块4，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
-  "graphPassiveConfirm",
-  // 轻量模式不开叙述条（额外 LLM 调用；#164 对齐，opt-in）。
-  "dreamNarrativeEnabled",
-  // 轻量模式不开 document 指针行（#230，opt-in：注册/注入/检索增强全随闸）。
-  "documentMemoryEnabled",
-  // #231 第二批：轻量档不开 agent 主动整理。理由不是成本而是协议——dryRun→apply
-  // 要求 agent 拿住上一轮的 run_id 再回来，弱模型漏这一环就是一次被拒的调用；
-  // 预设关、不剥夺显式开启的权利（合并顺序同 continuityRescueEnabled）。
-  "organizeEnabled",
-  // 轻量档不开画像事实自动维护轮（2026-11-06）：dream 后的逐卡 LLM 调用 + 读上百行
-  // 记忆，与低资源档互斥（同 organizeEnabled 的定性）。注入段本身是几十行常驻文本，
-  // 关掉自动轮不省注入成本、省的是维护调用——这正是该进这张表的路径。
-  "profileFactsEnabled",
-  // 轻量模式不开热计算（heat 属于重型增强；关掉后 sleep 降级也退回纯时间分层）。
-  "heatEnabled",
-  // 轻量模式不开注入前判定（#380：LLM-per-turn 附加路径，每帧注入多一次池级
-  // 判定调用——与低资源档互斥；预设给的默认值，用户显式勾选仍然赢）。点分键
-  // 由 applyLightModePreset 的嵌套赋值分支处理。
-  "preInjectGate.enabled",
-  // #249 N3：轻量档默认不开压缩边缘双落点——它往对话里追加消息（新的注入表面），
-  // 轻量档（小模型 / 小上下文）最不该再多一份注入物。这是预设给的默认值、不是强制：
-  // 用户显式勾选仍然赢（合并顺序「用户开关 > 轻量预设 > bundle 配置」，同
-  // injectGuidanceEnabled）。
-  "continuityRescueEnabled",
-  // #399：轻量档不开蒸馏原文留存——它是一份对话原文副本（磁盘 + 暴露面），
-  // 与轻量档「小模型 / 小上下文 / 少留痕」的取向相反。默认关，这里只是
-  // 轻量预设再确认一次；用户显式勾选仍然赢（合并顺序同 continuityRescueEnabled）。
-  "distillRecords.enabled",
-  // M.O. 执行记账：它挂在**热路径**上（每个会话事件都过一次监听）。轻量档的取向
-  // 是「小模型 / 小上下文 / 少常驻路径」，这与一个每事件都过一遍的监听器相冲突。
-  // 默认关，这里只是轻量预设再确认一次；用户显式勾选仍然赢（合并顺序同上面两条）。
-  "actionRunEnabled",
-  // #497：轻量档不开画像提取——一次调用要读上百行记忆再生成一段画像，与低资源档
-  // 互斥（同 preInjectGate.enabled 的定性）。默认关，这里只是预设再确认一次；
-  // 用户显式勾选仍然赢（合并顺序同 continuityRescueEnabled）。
-  "profileExtractEnabled",
-  // M.O. 自动沉淀：同样挂在 session/event 热路径上，而且解压会话日志是同步 I/O。
-  // 轻量档的取向（小模型 / 小上下文 / 少常驻路径）与它直接冲突，预设里关掉；
-  // 用户显式勾选仍然赢（合并顺序同上面几条）。
-  "actionNudgeEnabled",
-  // 日记本：一次要调模型写一整段散文，且挂 session/event 热路径做跨天判定。
-  // 与低资源档（小模型 / 小上下文 / 少常驻路径）直接冲突，预设里关掉；
-  // 用户显式勾选仍然赢（合并顺序同上面几条）。
-  "diaryEnabled"
-];
-
-/**
- * Apply the light-mode preset to a resolved config object (pure function,
- * exported for tests). When cfg.lightMode is not exactly true the config is
- * returned unchanged; otherwise a shallow copy carries false for every heavy
- * feature. Idempotent and side-effect free.
- */
-export function applyLightModePreset(cfg) {
-  if (cfg?.lightMode !== true) return cfg;
-  const preset = { ...cfg, lightMode: true };
-  for (const key of LIGHT_MODE_OFF) {
-    // 点分键（#380 preInjectGate.enabled）：对象子键的预设翻转——浅拷贝父对象后
-    // 改子键，避免直接改到用户 config 里的同一引用。平铺键照旧直赋。
-    const dot = key.indexOf(".");
-    if (dot < 0) {
-      preset[key] = false;
-      continue;
-    }
-    const parent = key.slice(0, dot);
-    preset[parent] = { ...(preset[parent] ?? {}), [key.slice(dot + 1)]: false };
-  }
-  return preset;
-}
-
-/**
- * #249 第二批：注入形态的父／子开关。父 = `autoInject`（既有的挂载总闸，默认
- * 开）。子项按 #249 §10 的判据分档——看它是否引入**新的注入时机／新的注入
- * 表面／额外成本**：
- *
- * - 只修正既有每轮块内的位（能力说明）→ 随父开关生效，键的默认值给开；
- * - 需要新时机或新表面（N2 回合结束提醒、N3 压缩边缘）→ 独立开关、默认关，
- *   实现时挂到这张表下（今天还没有这两个键，故表里只有能力说明一项）。
- *
- * 语义：**父关 = 子项一律不生效，但子项的持久值原样保留**（父关是「不生效」，
- * 不是「重置用户配置」）。用户显式写进 kv 的值也不因父关被改写。
- *
- * 闸门放在消费点而不是合并后的 cfg 上：压 cfg 会让 `/features` 的 effective
- * 失去「子项自己勾着、父关时当前不生效」这个状态，面板就显示不出来。跨文件
- * 契约见 test/inject-parent-gate.test.js（含面板侧关系的漂移检查）。
- *
- * 表里只放**顶层扁平键**：点号键（如 `memoryQualityFilter.enabled`）在合并后的
- * cfg 里是嵌套对象，`cfg?.["a.b"]` 取不到，挂进来会恒判不生效且不报错。N2/N3
- * 是扁平键，不受这条限制。
- */
-export const INJECT_CHILD_FLAGS = Object.freeze({
-  autoInject: Object.freeze(["injectGuidanceEnabled", "continuityRescueEnabled"])
-});
-
-/** 子开关的运行时生效值：父开关显式关（false）时恒不生效。 */
-export function injectChildEnabled(cfg, key) {
-  for (const [parent, children] of Object.entries(INJECT_CHILD_FLAGS)) {
-    if (children.includes(key) && cfg?.[parent] === false) return false;
-  }
-  return cfg?.[key] === true;
-}
+import z from "@deepseek-ai/schemastery";
+import { TYPE_DECAY_DEFAULTS } from "./heat.js";
+
+// #275 容量预警的阈值默认值，单独导出：service.getCapacityHealth 在 config 缺席
+// （直连调用方 / 测试传裸对象）时也要用同一套数字判级，不能另立一份——schema 的
+// .default({}) 只在「Config() 解析过」的路径上补值，裸 config 走不到。
+// 数字锚定 #275 议题里写的形态区间（活跃数百条、归档数千条），依据见 schema 处注释。
+export const CAPACITY_WARNING_DEFAULTS = Object.freeze({
+  dbSizeWarnMb: 256,
+  archivedRowsWarn: 5000,
+  archivedRatioWarn: 0.95
+});
+
+export const Config = z.object({
+  // 记忆语言：生成记忆、注入标题与后台 LLM 提示词所用语言；'zh'（默认，
+  // 行为不变）/ 'en'。启动时读入，切换后重启生效。
+  language: z.union([z.const("zh"), z.const("en")]).default("zh")
+    .description("记忆语言：生成的记忆条目、注入标题与后台 LLM 提示词所用语言（zh=默认中文，en=英文）。"),
+  memoryDir: z.string().default("~/.dsh/memory"),
+  autoInject: z.boolean().default(true),
+  autoSummarize: z.boolean().default(true),
+  // Optional model override for summarization. When both are non-empty, they
+  // take priority over the session's current model. Empty = use the session's
+  // active provider/model (same as before).
+  summarizeProvider: z.string().default(""),
+  summarizeModel: z.string().default(""),
+  // 蒸馏转录上限（字符）。借鉴 Codex「保留原始、替代压缩摘要」的思路：
+  // 蒸馏把完整对话上下文交给 LLM 提炼，不硬裁到 8000 字就截断语义；默认
+  // 24000 字符（约覆盖一整轮中等对话），需要更完整可调大。
+  distillMaxChars: z.natural().min(1000).max(200000).default(24000),
+  // 图像描述档（docs/DISTILL.md:346）：蒸馏前先用一个**多模态模型**给窗口里的
+  // 每张图写一段描述，并把描述并进转录——图本身仍然只是 `[图: …]` 占位，原图
+  // 不落库、不读字节（#611 的口径不变，这里只补「图里是什么」这段文字）。
+  //
+  // 默认关，三个理由：① 它要一次额外的视觉调用，且只有带图的窗口才付；② 描述
+  // 质量取决于所选模型，配错模型（纯文本模型）时宿主会把图换成占位，等于白花钱
+  // 换一行占位——所以必须显式选一个能看图的 provider；③ 转录是蒸馏的唯一输入，
+  // 往里加自动生成的内容属于改产物口径，不该在用户没要求时发生。
+  //
+  // 路由留空 = 不描述（不是「跟随主模型」）：蒸馏路由和会话主模型都可能是纯文本
+  // 模型，跟着它们跑等于默认把这一次调用浪费掉。三个键在同一条路径上，读一处。
+  imageDescribeEnabled: z.boolean().default(false),
+  imageDescribeProvider: z.string().default(""),
+  imageDescribeModel: z.string().default(""),
+  // autoSummarize 节流、产出上限与写入端同会话去重（Issue #127，默认全 0/off =
+  // 零行为变化）。此前每个 turn/end 必跑、产出条数由模型输出决定、写入端只按
+  // 「同类型 + 标题 trim 全等」去重——本机实测单日 84 次、单会话一天 198 条、
+  // 同一事实 6 小时铸出 28+ 条。阀门交给用户按需拧，升级本身不改行为。
+  summarizeMinIntervalMinutes: z.natural().min(0).max(10080).default(0),
+  summarizeMaxEntriesPerRun: z.natural().min(0).max(50).default(0),
+  // Issue #239（成本感知级联第一级）：蒸馏前的零 LLM 预判——窗口内可蒸馏文本
+  // 不足此字符数时直接跳过 LLM 调用（0 = 关闭，行为与现状逐字节一致）。判定
+  // 纯规则、无模型参与；被挡下的窗口照常消费游标（否则每个 turn/end 都会重新
+  // 评估同一段短文本），并留一行 status='skipped' 审计，error_message 写明原因
+  // ——「这一窗为什么没蒸馏」必须可观测，否则阀门等于黑盒。
+  summarizeMinWindowChars: z.natural().min(0).max(100000).default(0),
+  // Issue #239（有界检查点）：同一会话最多发起多少次蒸馏（0 = 不限，等同现状）。
+  // 只统计真正发起过 LLM 调用的 run——被预判挡下的窗口不占预算，否则阀门会把
+  // 额度浪费在零成本窗口上。计数是进程内 per-session（与最小间隔闸门同生命
+  // 周期），宿主重启即清零，与 #229 的游标持久化是两件事。
+  summarizeMaxRunsPerSession: z.natural().min(0).max(1000).default(0),
+  // Issue #493：连续解析失败几次后放弃当前窗口（0 = 关闭，行为与历史版本逐字节
+  // 一致）。失败默认不推进游标——语义是「这段还没提炼完，下次接着来」，这对
+  // 偶发失败（429/5xx/超时）是对的。但确定性失败（模型把转录当成该自己回话，
+  // finish_reason=stop，同文同温）重试收益为 0，而窗口只会随新事件继续变大，
+  // 于是一条会话能被同一窗口卡死几十轮、每轮都白烧一次完整调用。设成 2-3 即
+  // 可止血：达到阈值后强制消费游标跳过该窗口，并留一行带 streak/raw_head 的
+  // error 审计。默认关是因为放弃内容本身有代价——短窗口偶尔失败仍值得重试。
+  summarizeParseFailureMaxRetries: z.natural().min(0).max(10).default(0),
+  // Issue #239（第 4 项，错峰队列）：高峰期蒸馏顺延。空串 = 关闭，行为与现状逐
+  // 字节一致。取值是本地时间的时段列表（逗号分隔，支持跨零点），可带**星期前缀**
+  // （可省；ISO 1=周一…7=周日，也认 mon..sun；省略 = 每天）：
+  //   "09:00-18:00"                      每天 09:00-18:00
+  //   "mon-fri 08:00-12:00,14:00-18:00"  工作日两段（按高峰计费的供应商即此形态）
+  //   "sat,sun 23:00-06:00"              周末跨零点段
+  // 命中高峰时：不调 LLM、不消费游标（窗口继续累积，留到非高峰一次性蒸馏——批量
+  // 比逐轮碎蒸更省），登记一行 status='skipped' / error_message='peak-hours' 审计，
+  // 并按下面的上限择时补跑。任一写法非法则整串按「未配置」处理：排程是省钱
+  // 手段，绝不该因为写错格式把蒸馏停掉。
+  summarizePeakHours: z.string().default(""),
+  // 高峰顺延上限（分钟，0 = 不设上限）：到点仍处高峰就照常跑，避免整天高峰把蒸馏
+  // 饿死。默认 120 分钟。仅在上面的时段串非空时生效。
+  summarizePeakMaxDeferMinutes: z.natural().min(0).max(1440).default(120),
+  // 落库前去重档位：off（默认，等同现状）/ title（零成本，仅拦完全同名）/
+  // vector（复用已有 embedding 列做同会话语义近邻，无 LLM 调用）。
+  summarizeDedupeMode: z.union([z.const("off"), z.const("title"), z.const("vector")]).default("off"),
+  summarizeDedupeMinSim: z.number().min(0.5).max(0.99).default(0.92),
+  summarizeDedupeWindowHours: z.natural().min(0).max(168).default(24),
+  // 智能调速器（429 保护，默认开）：蒸馏 LLM 调用全局串行排队，相邻请求
+  // 间隔 distillRateLimitIntervalMs（默认 1s 一次）；命中 429 限流时按
+  // distillRateLimitBaseDelayMs 指数退避（1s→2s→4s…）自动重试
+  // distillRateLimitRetries 次，全程对用户透明，不把 429 错误码抛给用户。
+  distillRateLimitIntervalMs: z.natural().min(0).max(60000).default(1000),
+  distillRateLimitRetries: z.natural().min(0).max(10).default(3),
+  distillRateLimitBaseDelayMs: z.natural().min(100).max(60000).default(1000),
+  maxInjectedItems: z.natural().min(1).max(20).default(5),
+  // Issue #205：注入位跨轮轮换。同一会话里，最近 N 个不同用户查询轮次注入过
+  // 的记忆本轮不再优先（新鲜优先、原序回填，槽位数不变）；长会话中避免相邻
+  // 轮次反复注入同一条（实测 15.5h 会话 86 次注入 93% 重复）。0 = 关闭（默认，
+  // 保持既有行为）。会话边界自动重置：新会话从零开始。
+  injectRotationTurns: z.natural().min(0).max(20).default(0),
+  // Issue #164①：注入单条正文截断上限可配（原硬编码 300）。截断时尾部带
+  // 提示：上限/原长/全文 memory_get 指引（BUDGET_EXCEEDED 原则——绝不静默）。
+  // 默认 300 = 与既有行为一致。
+  injectContentMaxChars: z.natural().min(60).max(4000).default(300),
+  // Issue #34（v0.7.2 引入；v0.7.11 误删后随 #333 恢复）：对话开始注入一次当前
+  // 时间。默认关 = 与既有行为一致；格式与键名不变，存量 feature_flags 恢复即生效。
+  injectTimePrefix: z.boolean().default(false),
+  importanceThreshold: z.natural().min(1).max(5).default(3),
+  // Issue #239（第 5 项）：注入条数的查询自适应（默认关）。确定性强的话题收缩注入
+  // 条数（减半、下限 1），模糊话题（回指/时间线索，或极短查询）维持
+  // maxInjectedItems 上限——只做**单向收缩**，绝不越过用户配置的上限；判据只看
+  // 查询本身，不做额外检索（先探针检索等于白付一次 fuseRecall）。
+  injectUncertaintyAdaptive: z.boolean().default(false),
+  // #249（第一批；第二批归位为注入子开关）：能力说明——「怎么用记忆」的判断
+  // 指引。落两个零注入成本的位：①`memory_search` / `memory_save` 的工具描述补
+  // 一句判断指引（工具描述是常驻文本，不进每轮上下文）；②一段 order 150 的
+  // 系统提示段（一次性、同会话内不随轮次变化，因此不作废前缀缓存），只讲总则
+  // （优先序、何时查、何时写、何时 no-op）。默认开＝基础档：#249 §10 的判据是
+  // 「只修正既有位、不引入新注入时机／新表面／额外 LLM 调用」的子项随父开关
+  // 生效——「agent 不知道何时该查、何时该写」是已实测的缺口，把它默认关着是反的。
+  // 父开关 `autoInject` 关闭时它不生效（闸门见 injectChildEnabled）；用户显式写进
+  // feature_flags 的值永远优先于这里的默认值。
+  injectGuidanceEnabled: z.boolean().default(true),
+  // #249 N3（压缩边缘双落点）：上下文即将大幅精简前抢救「正在做什么」。默认关。
+  // 触发只认「历史真的被折叠了」的压缩事件（summary / prune / 不带 error 的 end；
+  // 判定见 continuity.js 的 isCompactionEdge —— start 只是「试过」，带 error 的 end 是失败收尾），
+  // 不自定一套阈值参数——「压缩边缘」由宿主定义，我们再校准一份只会与之漂移。
+  // 为什么是「新时机 + 新表面」因而默认关：它往对话里**追加消息**（新的注入表面，
+  // 参照实现里最容易累积成一堆历史的那类），并多写一张提案表。按 §10 判据，引入
+  // 新时机/新表面/新成本的子项独立成键、默认关；只修正既有块的（基础内容分池、
+  // 库可见性行）才随父开关默认开。`pinnedInjectBudget` 与它同批，但属前者之外：
+  // 那是既有块内的预算，不是新表面。
+  // 双落点是硬要求，不能只留一半：宿主的压缩摘要器**只看对话里的内容**，只落库不
+  // 注入，等于在摘要重建里什么都没留下；只注入不落库，则压缩一过就随旧消息一起
+  // 消失。两者都做，且落库先于注入（注入失败不该丢提案）。
+  // 祖先：`autoInject`（父关则本项不生效，闸门见 injectChildEnabled）。轻量档默认
+  // 置关（见 LIGHT_MODE_OFF）：轻量档多一份注入物是反的，与 injectGuidanceEnabled
+  // 同一取舍。注意预设只是默认值而非强制——装配时用户显式开关在它之后展开，勾了就赢
+  // （合并顺序见 index.js 装配处）。
+  continuityRescueEnabled: z.boolean().default(false),
+  // #249（第一批）：B1 pin 池预算——约束/偏好类注入条目的独立小上限。约束与
+  // 偏好被静默降级是本议题的立项核心（同类知识与情景日志同池同速率摘要，实测
+  // 一轮压缩后仅保 53%、五轮 10%），故这两类不进相关性竞争、不参与跨轮轮换、
+  // 逐字保真（仅受超大条目的硬顶保护，截断仍带提示）并排在块内排序之前。
+  // 独立预算的意义：pin 不占 maxInjectedItems 名额，不会把当前任务需要的情景
+  // 候选挤出预算（另一种「批量塞历史」）。0（默认）= 关闭，注入块构成与既有
+  // 行为逐字节一致；超出预算的条数在块内如实标注未展示条数，绝不静默。
+  pinnedInjectBudget: z.natural().min(0).max(5).default(0),
+  // 编码记忆蒸馏（codingRetrospect，opt-in，默认关）。开启时，turn/end 蒸馏
+  // 额外提取三类编码专属记忆：rejected_solution（被否决方案）/ pitfall（踩坑）/
+  // constraint（工程约束）。蒸馏上下文为整轮完整对话（用户输入 → 助手思考/回答
+  // → 工具调用与结果 → 代码执行），不再只看用户消息，便于提炼踩坑根因。
+  // 关闭时行为与之前完全一致。
+  codingRetrospect: z.boolean().default(false),
+  // 编码任务识别词表（读取侧门控用）：命中即视为编码类任务，编码记忆才注入。
+  // 后一组是「工程协作动作」词：合并/开 PR/看 CI/发版/验收/冲突/分支/
+  // issue 这类话在原词表里一个都不命中，于是被判成非编码任务，编码记忆
+  // 整类被 codingGate 滤掉——生产日志里这类 query 占非编码调用的 17.1~17.8%。
+  // 只加中文：isCodingTask 是纯子串匹配，英文短词（pr/ci/commit）会命中
+  // prompt / GitHub CLI 路径这类文本，无词边界时误命中率达 57.9%。
+  // 「评审」与「审评」并列保留，不是笔误：她真实说「等审评」「看CI和审评」
+  // （非编码池内审评 9 条 / 717 次，评审 5 条 / 421 次，审评反而更多），
+  // 同义不同形，子串匹配必须两套都放，删掉任一个都会漏掉一类真实说法。
+  // 刻意不加的：事务（唯一命中是政治学「公共事务」简答）、依赖包（依赖已在表内）。
+  codingKeywords: z.array(z.string()).default([
+    "代码", "编码", "写一个", "写个", "实现", "函数", "方法", "类",
+    "接口", "bug", "调试", "报错", "错误", "异常", "堆栈", "脚本",
+    "python", "javascript", "typescript", "node", "js", "ts",
+    "sql", "sqlite", "数据库", "算法", "重构", "优化", "性能",
+    "测试", "单测", "修复", "补丁", "依赖", "npm", "pip",
+    "命令行", "shell", "配置", "配置文件", "yaml", "json",
+    "插件", "开发", "编译", "构建", "部署", "git", "commit",
+    "review", "前端", "后端", "页面", "组件", "dsh", "memos",
+    "提交", "合并", "分支", "冲突", "验收", "审查", "评审", "审评", "发版",
+    "仓库", "回滚", "推送", "拉取", "变基", "上线", "打包", "迁移",
+    "字段", "鉴权", "超时", "并发", "闪退", "白屏", "端口", "进程",
+    "守护", "定时任务", "索引", "缓存", "死锁", "内存泄漏", "日志",
+    "版本号", "环境变量"
+  ]),
+  // 编码记忆注入加权系数：编码任务时对 rejected_solution/pitfall/constraint
+  // 记忆的 importance 乘以该系数排序，让编码记忆在编码场景更靠前。
+  codingBoostFactor: z.number().min(1).max(5).default(2),
+  // 注入边界花括号转义（issue #162，v0.7.4 曾修后被 v0.7.11 重构误删）：默认开启，
+  // 在 memory / 短期上下文 / 用户设置三处注入出口对连续 2+ 个花括号插 `\`
+  // （`{{a}}`→`{\{a\}\}`），让 DSH 的 interpolate() 不再扫到非法变量名而 throw。
+  // 关闭时按原样透传。
+  escapePromptVariables: z.boolean().default(true),
+  autoDream: z.boolean().default(true),
+  dreamThresholdCount: z.natural().min(1).max(1000).default(10),
+  dreamThresholdChars: z.natural().min(100).max(100000).default(5000),
+  dreamDelayMs: z.natural().min(0).max(60000).default(2000),
+  // autoDream 触发最小间隔（分钟，0 = 不限制，Issue #89 请求 2）：高频写入
+  // 场景下防止巩固调用（含失败重试）连发刷爆配额。间隔从每次实际开跑时刻
+  // 起算，失败/degraded 的 run 也占用间隔；间隔内的触发请求静默跳过，下一次
+  // 写入事件会重新评估。
+  dreamMinIntervalMinutes: z.natural().min(0).max(10080).default(0),
+  // Issue #292（#135 派生）：autoDream 连续失败退避（opt-in，默认关 = 行为与
+  // 现状逐字节一致）。开启后调度器对连续失败做指数退避：有效最小间隔 =
+  // dreamMinIntervalMinutes × 2^连续失败数（成功一次清零恢复），封顶 30 分钟。
+  // #89 的最小间隔闸失败 run 也占用，但间隔恒定——恒定失败的模型（#135 空体
+  // 面）会按固定节奏连发刷爆配额；退避把下次重试按失败次数指数推远。基数取
+  // dreamMinIntervalMinutes：基数为 0 时无闸可翻倍，本键不自己产生间隔（先配
+  // dreamMinIntervalMinutes 再开本键）。与 dreamPeakHours / dreamMinIntervalMinutes
+  // 同族（节流阀，不新增任何 LLM 调用），故不进 LIGHT_MODE_OFF。
+  autoDreamFailureBackoff: z.boolean().default(false),
+  // Issue #557（建议 2，opt-in 默认关 = 审计行逐字节一致）：dream 审计行的输入
+  // 快照瘦身。dream_runs.input 单行体积随记忆量涨（#557 实测平均 40-79 KB/轮，
+  // 绝大部分是 content），轮数又随天数涨，两者相乘超线性（报告库占 43% 的页）。
+  // 开启后 auto 轮的快照只留骨架（id/type/title/importance/updated_at，不含
+  // content）。巩固判定不回读审计行：LLM 输入由记忆库现算（prompt 不变），
+  // snapshot_hash 在内存里对含 content 的快照计算（receipt 完整性不变）；变的
+  // 只是离线回放——原文不在库里就重算不出 hash，#512「每一行都能回放一次巩固」
+  // 对瘦身轮降级为骨架级（#275 reclaim 清过 input 的库本就丢过这层，本键把同一
+  // 权衡前移到写入期）。organize 轮不经过这里（重放载荷走 organize.js 自己的
+  // saveDreamRun），写入期与 reclaim（run_type != 'organize'）同一条边界。
+  // storage-only、不新增任何 LLM 调用，不进 LIGHT_MODE_OFF（同上定性）。
+  dreamInputSummaryEnabled: z.boolean().default(false),
+  // Issue #239（第 4 项，错峰队列）镜像到巩固：高峰期不做梦。与
+  // summarizePeakHours 同一份时段语法（复用 src/summarize.js 的 parsePeakSpec /
+  // isInPeakWindow / nextOffPeakAt，不另写解析器）：逗号分隔、可带星期前缀、支持
+  // 跨零点。空串 = 关闭，行为与现状逐字节一致。
+  //   "09:00-18:00"                      每天 09:00-18:00
+  //   "mon-fri 08:00-12:00,14:00-18:00"  工作日两段（按高峰计费的供应商即此形态）
+  // 为什么巩固比蒸馏更该有这道闸：单次巩固的输入是整窗快照（dreamMaxSnapshotSize
+  // 条），实测一次 run 的 LLM 时长可达数分钟量级，撞上高峰时既贵又慢；而它由写入
+  // 事件触发、没有天然的「等到空闲再跑」路径。命中高峰时：不调 LLM、不刷新
+  // baseline（阈值继续累积，留到非高峰一次性巩固），登记一行 status='skipped' /
+  // error_message='peak-hours' 审计，并按下面的上限择时补跑。任一写法非法则整串
+  // 按「未配置」处理——排程是省钱手段，绝不该因为写错格式把巩固停掉。
+  dreamPeakHours: z.string().default(""),
+  // 高峰顺延上限（分钟，0 = 不设上限）：到点仍处高峰就照常跑，避免整天高峰把巩固
+  // 饿死。默认 120，与 summarizePeakMaxDeferMinutes 对齐。仅在时段串非空时生效。
+  dreamPeakMaxDeferMinutes: z.natural().min(0).max(1440).default(120),
+  // 巩固模型路由（settings panel「巩固模型」/ dreamProvider+dreamModel）：
+  // dream 的记忆沉淀专用 LLM 路由，显式配置优先于 agent 默认模型（config-first，
+  // Issue #25）。模型分类声明：
+  //   - 非思考模型（推荐，如 glm-5-2 类）：无 reasoning 声明，effort 请求被 harness
+  //     拒绝后 withEffortFallback 去掉字段重试即成功；空体/no json array 风险最低。
+  //   - 思考模型（如 deepseek-v4-flash-ga 等 v4-flash-ga 系）：默认开推理，可能烧光
+  //     token 预算返回空体；且部分（如 v4-flash-ga）在 harness 侧被声明为不接受任何
+  //     reasoning effort —— 即使去掉 effort 重试，harness 的 defaultEffort 也会顶上来
+  //     再次拒绝（UNSUPPORTED_REASONING_EFFORT），插件 fallback 无法绕开。
+  //     选用时建议配 dreamReasoningEffort 并实测；不行就换非思考模型。
+  dreamProvider: z.string().description("记忆巩固专用模型的服务商（settings「巩固模型」）。巩固反复失败时，优先改用官方非思考模型的服务商（如 deepseek / glm）。"),
+  dreamModel: z.string().description("记忆巩固专用模型。建议选非思考模型（如 deepseek-chat、glm-5-2 类）：思考模型可能烧光 token 预算返回空体，导致巩固失败（UNSUPPORTED_REASONING_EFFORT）。"),
+  // Issue #135 建议 3：#9 只抬了 max（8192→131072），default 停在 32768。思考型
+  // 模型的推理与正文共享该预算，effort 未压低时 32768 恰好被推理烧光 → 空体
+  // （"no json array in llm output"，报告实测 146 轮因此失败）。默认抬到上限，
+  // 让默认配置也留足正文预算；流式计费按实际用量，不按上限。
+  //
+  // 成本审计（2026-10-12，本机库只读探针）复验了「默认值该不该降回去」这个问题，
+  // 结论是**不该降**，故默认维持 131072。三条实测证据：
+  //   1. 这个键是**上限**，不是计费口径——流式按实际用量计费（与 sleepMaxTokens
+  //      的 description 同口径）。压上限只在**真撞顶**时生效：近 10 天 88 个成功
+  //      轮 output 中位 24022、73.9% 超过 16384，因此把默认压到 16384 会让近四分之三
+  //      的正常轮撞顶。
+  //   2. 撞顶的后果不是「少烧一点」，而是**整轮失败**：max_tokens 截断 → 流上没有
+  //      完整 JSON → extractJsonArray 返回 null → finish({ok:false,
+  //      error:"no json array in llm output"})（src/dream.js:1167-1171）；而调度器
+  //      **只有 result.ok 才刷新 baseline**（src/dream.js:905-915，注释明写这是刻意
+  //      设计「失败必须能立刻重试」）→ 下一次写入用**同一批输入**重跑一遍。按 133 个
+  //      有真实用量的成功轮逐轮折算：cap=16384 撞顶 78.9%、净总量 +54.1%；
+  //      cap=24576 +43.3%；cap=32768 +15.9%；cap=49152 +6.5%；98304 起为 0。
+  //      即**调低这个值会把 token 花得更多**，而不是更少。
+  //   3. 真正的大头它治不到：把「时间就近」配上的 133 次成功调用（同一次配对里取
+  //      分子与分母）的决策正文（merge/update 的 content+title，剥离代码自动补的隐式
+  //      keep）按中英分估（中文 ≈1.5 字符/token、英文 ≈4）折 419,487 token，而同一批
+  //      调用输出合计 3,543,111 token —— 正文约占 11.8%（换算方法敏感性区间
+  //      8.2%~22.0%，逐轮中位 12.1%），其余约 88% 是推理与 JSON 骨架。
+  //      注意别用「全部有 decisions 的 run」当分子配「配对子集」的分母（会得 13.9%
+  //      这种偏高的数）——跨口径比较先校量纲、分子分母必须同集合。
+  //      病根是推理与正文共享 max_tokens 单一池子。宿主（DSH）侧确有分离机制：
+  //      DEFAULT_THINKING_BUDGETS = { minimal:1024, low:2048, medium:8192, high:16384 }、
+  //      adjustMaxTokensForThinking()（正文预算 + 推理预算相加后卡模型上限）、
+  //      clampThinkingBudgetToAnswerRoom()（MIN_ANSWER_TOKENS=1024，保证正文至少留
+  //      1024 token）——但它只对 Anthropic Claude 路径默认生效；chat-completions 网关
+  //      （volcano-engine / deepseek / glm 均在此列）须由路由 profile 开
+  //      compat.supportsThinkingTokenBudget 并指定 compat.thinkingTokenBudgetField
+  //      （vLLM/Qwen/llama.cpp 风格顶层字段，上游端点还必须认它），asar 注释明写
+  //      "Off by default"。两者都是 **profile 级**配置，插件 stream 调用无法
+  //      per-request 传递（ctx.llm.stream 唯一的推理旋钮是 reasoningEffort）——故本插件
+  //      在调用面无法单独约束推理预算：抬高这个上限是当前路由下唯一可用的止损手段，
+  //      治标不治本；治本是换非思考模型，或走能分离预算的路由 profile。
+  // 显式调小仍是允许的（min 256）：适合「宁可整轮失败也要压单轮上限」的场景，但请
+  // 知悉上面第 2 条的净成本方向。需要旧行为（无上限感）的库显式设回 131072。
+  dreamMaxTokens: z.natural().min(256).max(131072).default(131072),
+  // Pass-through reasoning effort for dream's LLM calls (Issue #135 建议 4/5).
+  // Unset (no value) resolves to the LOWEST effort the model declares before
+  // streaming: background consolidation must produce JSON, and omitting the
+  // field lets the harness substitute the model's defaultEffort (thinking-type
+  // models often default to high/max) — the reasoning then drains the whole
+  // token budget and the run dies with an empty body. Explicit 'none' still
+  // omits the field (provider default applies); off/low/medium/high are
+  // forwarded verbatim, unsupported values are remapped (v0.7.26+).
+  // Caveat: on some thinking models (e.g. v4-flash-ga) the harness declares NO
+  // supported effort, so even the fallback retry (field stripped) is rejected
+  // again via its defaultEffort — prefer a non-reasoning dreamProvider/dreamModel.
+  dreamReasoningEffort: z.union([
+    z.const("off"),
+    z.const("low"),
+    z.const("medium"),
+    z.const("high"),
+    z.const("none")
+  ]).description("巩固模型的推理档位：未配置 = 自动取模型支持的最低档（避免思考模型用自带默认档烧光预算返回空体，#135）；显式 'none' = 不发送字段、用服务商自带默认；off/low/medium/high 原样传递。模型不支持的值会自动换用其支持的档位（v0.7.26+）。"),
+  // 滑动窗口上限（v0.4.4）：autoDream 每次只对最近 dreamMaxSnapshotSize 条
+  // 记忆做 consolidation。大记忆量下全量快照会把 LLM 输入撑爆（636 记忆 →
+  // 677 "missing" errors、applied=0），窗口外的旧记忆不进 snapshot。
+  dreamMaxSnapshotSize: z.natural().min(1).max(1000).default(200),
+  // Issue #104 方向 2：单轮 archive 决策上限。一次性大扫除（12 条互不相关主题
+  // 被批量归档，其中 8 条疑似误伤长保留类型）是失控信号，与 update 上限同类的
+  // 全局闸门：skipInvalid 也不豁免，超限整单拒绝。正常清理可调高。
+  dreamMaxArchivePerRun: z.natural().min(1).max(200).default(8),
+  // #135 成本审计派生：单轮 merge 决策上限。merge 是唯一**回吐正文**的动作（每条
+  // 要求模型重新写出合并后的 content，实测平均 550 字符/条），其余动作都不带正文，
+  // 所以这是「输出里正文占比」唯一可控的杠杆。与 update/archive 上限同类：全局
+  // 闸门，skipInvalid 也不豁免，超限整单拒绝（errors 由 decisions.js 的数量闸段
+  // 统一汇总，run 记 failed）。默认 40 的校准依据（只读探针 246 轮 / 近 10 天 88 轮）：
+  // 每轮 merge 数全库 p50 7 / p90 15 / p99 28 / max 39，近 10 天 p99 39 / max 39
+  // ——40 即观测分布上沿（历史命中 0/246），与 archive 闸默认 8 恰为其 p90=max 是
+  // 同一校准法。刻意保守（不取 p90=15 之类）：超限代价不对称，整单拒绝会让调度器
+  // 不刷新 baseline、下轮同输入重跑，一次误伤约等于该轮成本 ×2，而探针里 merge≥15
+  // 的大轮正文占比正常（10~22%），没有失控特征。想拿覆盖换成本的用户可调低。
+  dreamMaxMergePerRun: z.natural().min(1).max(200).default(40),
+  // Issue #125：候选集构造方式。"window"（默认，等同现状）只取最近
+  // dreamMaxSnapshotSize 条；"hybrid" 在此基础上并入**向量翻出的高相似组**——
+  // 本机实测 45 对「双方活跃且 sim≥0.85」里 0 对能同时进窗口（窗口覆盖率 11.7%），
+  // 纯时间窗口让"该合并的一对"几乎永远碰不到面。候选总量仍由下面的上限封顶、
+  // 与库总量解耦，这是相对"调大窗口"的核心收益：输入成本不随库增长。
+  dreamCandidateMode: z.union([
+    z.const("window"),
+    z.const("hybrid")
+  ]).default("window"),
+  // hybrid 的候选总量上限；0 = 复用 dreamMaxSnapshotSize（不迁移，需要时显式覆盖）。
+  dreamCandidateMax: z.natural().min(0).max(5000).default(0),
+  // Issue #258：总览（dream_summarize）独立路由。consolidate 有 dreamMaxSnapshotSize
+  // 窗口、总览原为全库无界——两者对 ctx 的需求差 4 倍以上却强制共用 dream 路由，
+  // dreamProvider 指向小 ctx 模型时总览当场 CONTEXT_WINDOW_EXCEEDED（实测 120,969
+  // tokens > 32,768），指向大 ctx 模型则 consolidate 的卸载收益归零。未配置 = 回落
+  // dream 路由，行为逐字节不变。
+  dreamSummaryProvider: z.string().default("").description("记忆总览（dream_summarize）专用模型服务商，留空用巩固模型。总览输入为全库（或 dreamSummaryMaxInputs 上限），ctx 需求远大于 consolidation，建议大 ctx 模型（issue #258）。"),
+  dreamSummaryModel: z.string().default("").description("记忆总览（dream_summarize）专用模型，留空用巩固模型；总览输入随库增长，建议大 ctx 非思考模型（issue #258）。"),
+  // Issue #258：总览输入条数硬上限。0 = 不设上限（历史行为，库增长可能撑爆小
+  // ctx 模型）；>0 时按 updated_at 倒序保留最新的 N 条（与 consolidate 窗口同一
+  // 排序口径）。总览是常驻叙述而非逐条巩固，限输入只影响口径脚注里的条数。
+  dreamSummaryMaxInputs: z.natural().min(0).max(100000).default(0),
+  // hybrid 判"高相似"的阈值；0.85 与 sleep normal 档对齐——两个模块对"高相似"
+  // 保持同一个定义。
+  dreamCandidateMinSim: z.number().min(0.5).max(0.99).default(0.85),
+  // 叙述条（#164 对齐，opt-in）：dream 期间按共享 tag 主题聚类（dream/
+  // narratives.js），每簇 LLM 合成一条叙述落库（source=narrative、evidence
+  // 回链簇内原子记忆、求交防捏造）。按需检索、不常驻注入。默认关=行为与
+  // 此前一致；lightMode 强制关闭。
+  dreamNarrativeEnabled: z.boolean().default(false),
+  // 成簇门槛：共享同一 tag 的记忆 ≥ 此值才合成叙述条。
+  dreamNarrativeMinCluster: z.natural().min(2).max(20).default(3),
+  // document 型记忆（#164/#230，opt-in）：agent 产长文档的指针行——注册校验
+  // （文件存在 + 路径合法 + evidence 求交）、摘要 + doc_path 落库、C2 比对
+  // 去重、supersede 记账。全文归 agent，管线零触碰；默认关=行为与此前一致；
+  // lightMode 强制关闭。
+  documentMemoryEnabled: z.boolean().default(false),
+  // document 摘要行的注入预算（#230 拍板）：次优先档内最多注入的 document
+  // 行数，超预算跳过由后续候选补位。只约束注入，不约束检索。
+  documentInjectBudget: z.natural().min(1).max(5).default(2),
+  // document 的 managed 落盘目录（#296 第二批）：空串 = 跟随 memoryDir 的
+  // `<memoryDir>/documents/`。`~` / `~/` / `~\` 展开到 home，绝对路径原样用，相对
+  // 路径落在 memoryDir 下（这是本键自己的规则：memoryDir 的相对路径是原样留着的
+  // cwd 语义，两者刻意不同；`~user` 形式两边都不展开）。目录由 mneme 建，里面的
+  // `index.md`
+  // 整文件机器所有。这个目录**之外**的文件只登记指针行，正文一个字节都不碰
+  // （= #230 的「管线对正文零读零写」）；与 memoryDir 一样是路径配置，不是
+  // 行为开关，故不进 settings.js 的 feature flags 白名单、也不上面板。
+  documentDir: z.string().default(""),
+  // 日记本（QQ 机器人写日记）：跨天惰性判定 + 启动补写，正文落
+  // `<memoryDir>/diaries/<项目键>/YYYY-MM-DD.md`，记忆库里留一条 document 指针行。
+  // 默认关=行为与此前一致；lightMode 强制关闭（它要调模型，与低资源档互斥）。
+  // 与 documentMemoryEnabled **成对但不相依**：关掉文档记忆只影响「能不能被检索到」，
+  // 正文照样写——那是用户自己的日记，不该被一个检索开关收走。
+  diaryEnabled: z.boolean().default(false),
+  // 日记根目录：空串 = 跟随 `<memoryDir>/diaries/`。与 documentDir 同一套路径规则
+  // （`~` 展开、绝对路径原样、相对路径落 memoryDir 下），同样是**路径配置不是行为
+  // 开关**，故不进 settings.js 白名单、也不上面板。
+  diaryDir: z.string().default(""),
+  // QQ 收件箱目录：空串 = 从 memoryDir 推（`<memoryDir>/../media/onebot`，本机即
+  // `D:\DSH\.dsh\media\onebot`）。推出不来就报 no-inbox-dir，绝不猜别的盘。
+  diaryInboxDir: z.string().default(""),
+  // 定时写（v0.13，桉桉 2026-11-09「日记本按理来说应该需要定时写，这个要存设置中」）：
+  // 每隔 N 分钟主动检查一次「今天是否还没写」，0 = 关（只在 turn/end 与启动时判，
+  // 即此前行为）。为什么要这一项：auto.js 原来只在回合结束时判跨天，用户整天不说话
+  // 就整天不写——日记不该取决于谁先开口。它仍然**不是 cron**：定时器只负责唤醒判定，
+  // 写不写在 compose 里按落盘日期去重，所以一天最多一篇，失败也只是 warn。
+  // 上限 1440（一天）：比一天更长的间隔没有意义，因为判定单位就是「天」。
+  diaryWriteEveryMinutes: z.natural().min(0).max(1440).default(0),
+  // 隐式 keep（v0.4.4）：LLM 未提及的 snapshot 记忆自动补 {action:"keep"}，
+  // 避免"未覆盖即全拒"白白浪费整轮 run。设为 false 时保留旧的严格校验
+  // （未覆盖即拒绝整单）。
+  dreamImplicitKeep: z.boolean().default(true),
+  // 显式决策覆盖率下限（v0.4.4 fix）：dreamImplicitKeep 开启时，LLM 输出被
+  // 截断只显式 claim 少量 snapshot 记忆（claimed.size / snapshot.size < 该阈值）
+  // → 整单拒绝，防止残缺输出被隐式 keep 洗白成 ok 后再被真实 apply。0-1，
+  // 默认 0.5（至少显式覆盖一半 snapshot）。
+  dreamMinExplicitCoverage: z.number().min(0).max(1).default(0.5),
+  // Issue #89：v0.6.9（Issue #26）的宽容路径回归。默认跳过单条非法决策
+  // （未知 id / 跨类型合并等）、应用合法子集、run 记 degraded；设 false 恢复
+  // 整单拒绝的严格模式。全局上限与覆盖率下限不受此开关影响、始终整单拒绝。
+  dreamSkipInvalid: z.boolean().default(true),
+  // 显式开启后放宽跨类型合并检查（类型边界由用户自行承担）；配合
+  // dreamSkipInvalid 理解：关闭 skipInvalid 时跨类型 merge 直接整单拒绝。
+  allowCrossTypeMerge: z.boolean().default(false),
+  // issue #339 / E8 考卷：merge 护栏（默认开）。开启后合并对象命中长保留类型
+  // （preference/pattern/rejected_solution/constraint/pitfall，与 archive 护栏
+  // 同一张表）的 merge 决策整条跳过——E8 实测巩固损耗里 10/26 条被丢约束已归位
+  // guarded 类型仍被 merge 吃掉，而 archive 护栏只挡 archive 不挡 merge，
+  // 「更精炼的摘要」恰是约束失真的主通道（同类压缩管线实测：安全规则被同速压缩
+  // 一轮只剩 53%、五轮只剩 10%，且全程无任何报错信号）。skipInvalid（默认开）
+  // 时被跳条目进 dream_runs.skipped、run 记 degraded；关闭 skipInvalid 时整单
+  // 拒绝。设为 false 才恢复旧行为：guarded 类型的 merge 不再被跳过，约束可被
+  // 「更精炼的摘要」吃掉。与 allowCrossTypeMerge 同用时长 guard 先判。
+  dreamMergeGuard: z.boolean().default(true),
+  // Rule version for dream adjudication: when this bumps, older dream_runs
+  // degrade to historical evidence (their receipts no longer drive live
+  // decisions). Default 0 = no versioning in use yet.
+  policyEpoch: z.natural().min(0).max(1000000).default(0),
+
+  // --- API protection ------------------------------------------------------
+  // Optional shared token for the plugin's HTTP API. Empty (default) keeps
+  // the API open (DSH binds to 127.0.0.1 and has no built-in auth); when set,
+  // sensitive endpoints (vector-config, vector-reindex, and all write ops on
+  // profile/rules/commands) require `Authorization: Bearer <apiToken>` (or
+  // `X-DSH-Mneme-Token`). Read-only list/search/semantic stay open so the
+  // Web panel keeps working without the token.
+  apiToken: z.string(),
+
+  // --- semantic: local embedding provider (v0.2) --------------------------
+  // "openai" keeps the legacy external-API path (settings vector config);
+  // "local" runs an ONNX model in-process; "ollama" calls a local Ollama.
+  embedProvider: z.union([z.const("openai"), z.const("local"), z.const("ollama")]).default("openai"),
+
+  // Local ONNX embedder (transformers.js / onnxruntime).
+  localEmbedModel: z.string().default("Xenova/bge-small-zh-v1.5"),
+  localEmbedDimension: z.natural().default(512),
+  localEmbedDevice: z.union([z.const("cpu"), z.const("gpu")]).default("cpu"),
+  localEmbedBatchSize: z.natural().min(1).max(64).default(8),
+  // 本地嵌入的池化方式（**bug 修复，不是新能力**）：BGE 系是按 CLS 池化训练的——
+  // 模型自带的 `1_Pooling/config.json` 明确写着 `pooling_mode_cls_token: true` /
+  // `pooling_mode_mean_tokens: false`，官方 README 也是「select the last hidden state of
+  // the first token」+ L2 normalize；而 transformers.js 的 `feature-extraction` 默认 mean。
+  // ⇒ 此前本地嵌入对 BGE 系一直用错池化：**不报错、只是向量系统性偏差**，检索质量静默受损。
+  // 'auto' = 按模型族判定（BGE → cls，其余 → mean，未受影响的模型行为不变）；也可显式钉住。
+  // ⚠️ 池化决定向量空间，改它会改变 modelHash（见 local-embedder.js），既有索引会被判失配并重建。
+  localEmbedPooling: z.union([
+    z.const("auto"),
+    z.const("cls"),
+    z.const("mean")
+  ]).default("auto"),
+
+  // Ollama embedder.
+  ollamaBaseUrl: z.string().default("http://localhost:11434"),
+  ollamaModel: z.string().default("nomic-embed-text"),
+
+  // Model download/cache. When empty (default), models are cached under the
+  // user-level path ~/.dsh/mneme/models (resolved in local-embedder/reranker);
+  // a non-empty value is used verbatim.
+  embedModelCacheDir: z.string().default(""),
+  embedModelMirror: z.string().default("https://hf-mirror.com"),
+
+  // issue #194：模型文件下载的断点续传与重试。开启时 transformers.js 的 env.fetch 被
+  // 替换为带断点续传的实现（已收字节落盘、Range/If-Range 续传、空闲看门狗），大文件
+  // 中断后不必整份重来；关闭 = env.fetch 保持原样（线上回滚开关）。
+  resilientModelDownload: z.boolean().default(true),
+
+  // 自管运行时目录（issue #131）。空 = ~/.dsh/mneme/runtime：里面放收编或下载来的
+  // transformers + onnxruntime 闭包，插件经 src/runtime/loader.js 的三层解析加载它。
+  // 目的就是让这条重依赖不必留在宿主 profile 的依赖图里——profile 是所有插件共用的
+  // 依赖图，留在里面会让「装任何插件都要替它重走一遍这条链」。
+  runtimeDir: z.string().default(""),
+
+  // 运行时取件的两个来源（issue #131 / PR-C）。都是「克制」的默认：留空 = 不额外改变行为。
+  // - runtimeTarballDir：本地 .tgz 目录。某个包网络下不到时（例如 onnxruntime-node），
+  //   把 `npm pack <pkg>` 出来的 tgz 丢进这个目录即可离线取件；有它就优先于联网。
+  // - runtimeMirror：registry 镜像前缀，例如 https://npmmirror.com/mirrors/npm/ 。
+  //   留空则用 runtime-manifest.json 里写死的官方地址（那是随包发布的固定清单）。
+  runtimeTarballDir: z.string().default(""),
+  runtimeMirror: z.string().default(""),
+
+  // Vector search tuning.
+  vectorSearchTopK: z.natural().min(1).max(100).default(20),
+  vectorSearchThreshold: z.number().min(0).max(1).default(0.65),
+  hybridSearchVectorWeight: z.number().min(0).max(1).default(0.6),
+  hybridSearchKeywordWeight: z.number().min(0).max(1).default(0.4),
+  // Lazy auto-backfill of missing embeddings on boot (Bug2): when the vector
+  // API is configured and rows still lack an embedding, the index is rebuilt
+  // in the background after a short delay, rate-limited in batches. On by
+  // default; set false to keep the backfill manual only.
+  autoReindexOnBoot: z.boolean().default(true),
+  // Backfill pacing (previously hardcoded 500 / 10 / 200 in semantic.js). A
+  // fixed 500-per-boot cap meant a 4k-row backlog needed nine restarts to
+  // clear, and nothing reported that the run had been capped.
+  // reindexMaxPerBoot = 0 means "no cap, drain the whole backlog this run".
+  reindexMaxPerBoot: z.natural().default(500),
+  reindexBatchSize: z.natural().min(1).max(64).default(10),
+  reindexRateLimitMs: z.natural().default(200),
+  // Semantic-first injection (Bug4): when enabled, injectCandidates with a
+  // non-empty query recalls via the vector index first and falls back to the
+  // rule-based pick to fill/dedupe. Empty query / no vector → legacy behavior.
+  hybridInject: z.boolean().default(true),
+
+  // --- recall optimization (v0.5.0) ----------------------------------------
+  // BM25 third recall path beside vector + LIKE keyword (1.1): per-token IDF
+  // scoring recalls rows whose query terms are scattered — identifiers, code
+  // fragments, mixed CJK/ASCII — where substring LIKE cannot match.
+  bm25SearchEnabled: z.boolean().default(true),
+  // Query-aware vector cutoff (1.2) replacing the fixed 0.65: entity:/attr:
+  // prefixes loosen to 0.5, short queries tighten to 0.7, long queries loosen
+  // to 0.6, and a decisive top-1/top-5 score gap loosens to 0.5 so the tail
+  // still reaches the reranker. Off = legacy fixed threshold behavior.
+  adaptiveThresholdEnabled: z.boolean().default(true),
+  // Session-scoped hot memory (1.3): the latest N dialogue rounds rendered
+  // ahead of the long-term recall block — short-term context that never
+  // enters the memory store.
+  hotMemoryEnabled: z.boolean().default(true),
+  hotMemoryRounds: z.natural().min(1).max(50).default(5),
+  hotMemoryMaxTokens: z.natural().min(200).max(32000).default(2000),
+  // Topic-ranked injection (2.2): when a query vector is available the whole
+  // injection candidate list is re-ordered by similarity to the current
+  // query instead of keeping the rule-based order.
+  selectiveInjectEnabled: z.boolean().default(true),
+  // Search-time semantic dedup (2.3): greedy pass over the merged candidate
+  // list dropping rows whose embedding cosine-similarity to an already-kept
+  // row exceeds the threshold — duplicates are filtered at recall time
+  // instead of waiting for a dream consolidation. Opt-in aggressive mode:
+  // small embedding models can collapse legitimately distinct rows, so the
+  // default keeps every recalled row.
+  searchSemanticDedup: z.boolean().default(false),
+  searchSemanticDedupThreshold: z.number().min(0.5).max(1).default(0.95),
+
+  // Recall fusion recipe (plan #1): how the keyword/vector/BM25 ranked lists
+  // are combined into the final ranking. `blend` (default) is the legacy
+  // behavior — weighted sum for vector/hybrid, union backfill for auto —
+  // unchanged. `rrf` (Reciprocal Rank Fusion) and `minmax` (min-max normalized
+  // weighted sum) are rank/scale-aware recipes that fix the unit mismatch the
+  // issue describes (raw cosine vs keyword score vs normalized IDF are added
+  // directly). Off by default so existing behavior holds exactly.
+  recallFusion: z.union([z.const("blend"), z.const("rrf"), z.const("minmax")]).default("blend"),
+  // Attach a `signals` object { keyword, vector, bm25, final } to each search
+  // result for transparency/debugging (plan #2). Default off; when on it only
+  // decorates the returned rows, never changes the ranking.
+  signalTransparency: z.boolean().default(false),
+
+  // --- semantic: rerank layer (v0.2) --------------------------------------
+  // Opt-in by default (item ⑥): the local cross-encoder pulls in onnxruntime
+  // (transformers.js) at init, so a bare install must not load it. Only an
+  // explicit rerankEnabled=true + rerankProvider="local" constructs LocalReranker.
+  rerankEnabled: z.boolean().default(false),
+  rerankProvider: z.union([z.const("local"), z.const("none")]).default("none"),
+  rerankModel: z.string().default("Xenova/bge-reranker-base"),
+  rerankBatchSize: z.natural().min(1).max(64).default(8),
+  rerankMaxCandidates: z.natural().min(5).max(100).default(30),
+  rerankScoreThreshold: z.number().min(0).max(1).default(0.1),
+  // #188：量化档，与嵌入层的 useDtype 同语义（q8 = model_quantized.onnx，约为
+  // fp32 体积的 1/4）。此前重排层不传 dtype，即使缓存里已有量化文件也会去下载
+  // 1GB 级的 model.onnx。非法值由 transformers 在 init 时抛出 → 重排降级并告警。
+  rerankDtype: z.string().default("q8"),
+
+  // --- reflection: update decision + failure tracking (v0.2.1) ------------
+  reflectionUpdateEnabled: z.boolean().default(true),
+  reflectionFailureTracking: z.boolean().default(true),
+  reflectionUpdateMaxPerRun: z.natural().min(0).max(5).default(2),
+  reflectionUpdateMinAgeHours: z.natural().min(0).max(168).default(24),
+  // failure_memories 的启动期保留期（天）。此前在 index.js 里写死 90，是这一族
+  // 四张启动期清理表里唯一没有键可陈述的一条（#275 伞下的欠账）。形态对齐
+  // recallRetentionDays：顶层扁平键、只从配置文件改；暂不进 settings.js 白名单，
+  // 面板可调是后续的事（那要同时补 api.js 的 NESTED 表与 client.js 的面板行）。
+  // 下限取 1 而非 0：这张表的用途是「挖掘重复出现的纠正模式」，窗口太短就只剩
+  // 最近一次；要彻底停掉清理应当显式关掉 reflectionFailureTracking。
+  reflectionFailureRetentionDays: z.natural().min(1).max(3650).default(90),
+
+  // --- conflict freeze: manual review for conflicting memories (v0.2.1) ---
+  // Opt-in by default: when true, conflicting memories are not auto-merged
+  // and are marked as pending manual review instead.
+  conflictFreezeEnabled: z.boolean().default(false),
+  // Maximum number of frozen conflicts to keep pending for manual review.
+  conflictFreezeMaxPending: z.natural().min(1).max(1000).default(100),
+  // Issue #603 第 4 层（自动裁决档）：freeze 模式里相似度极高的同 scope 对直接
+  // 裁决（保留信息量更大的那条、归档另一条），不进人工队列——人只看模糊地带。
+  // 默认关：这是会归档记忆的自动动作，必须显式打开。
+  //
+  // ⚠️ Issue #616：这一档有三个已知边界，打开前先读，别当成「开了就清净」。
+  //
+  //  1) 阈值论证用的是早期快照，当前库上 0.95 等于不生效。
+  //     注释此前写「345 条有相似度、>=0.95 有 20 条（5.8%）」——2026-11-09 在
+  //     live 库重跑同口径：conflict_pending 全表 748 行，similarity 非 NULL 只有
+  //     11 行，其中 >=0.95 是 0 行，最高一对 0.914。这不是说阈值错了，是说
+  //     按 0.95 打开今晚一对都不会被判，用户会以为功能坏了。真要开，先按当前
+  //     分布重定阈值（配置下限 0.85），别沿用这两个数。
+  //
+  //  2) 它不是独立开关，是 freeze 分支的子节点。整段自动裁决都在
+  //     sleep.js 的 `if (config.conflictFreezeEnabled === true)` 里；关掉 freeze
+  //     会连它一起静默消失。面板上两个键看着平行，实际是父子。
+  //
+  //  3) 未标注 scope 会被判成同 scope。isCrossScopePair 走 scopeKeyOf，NULL 归一
+  //     成 null，null !== null 为 false，于是「归属未知」被当成「归属相同」。
+  //     live 库活跃 8259 行里 2710 行（32.8%）两个 scope 全 NULL，这批因此绕过了
+  //     「归属是用户的决定、永不自动」（v0.8.1 #170）这条守卫。改判据前不要打开。
+  //
+  // 另外 autoResolved/autoFailed 目前没有任何消费者（dream.js 只取 frozen），
+  // conflict_reviewed 台账也不记赢家、无 API 暴露——自动裁决了什么是看不见的。
+  // 可见性补齐之前，这一档只适合在能盯日志的前提下短时打开。
+  conflictAutoResolveEnabled: z.boolean().default(false),
+  conflictAutoResolveMinSimilarity: z.number().min(0.85).max(1).default(0.95),
+
+  // --- conflict ledger（issue #641，beta）-----------------------------------
+  // 冲突分诊账本的档位。真实库 788 对人审队列的全量分类：46% 近重复 + 20% 跨作用域
+  // 重复 + 5% 时序演进，真矛盾只有 ~27%——现行窄 prompt 把前 71% 全逼成了「输赢」，
+  // 再由人逐对裁决（≈30 条/天，且 92% 的对从未两侧同场）。分诊把「谁该机械处理、
+  // 谁才是真矛盾」从 LLM 手里拿回来（E13b：winner-take-all 裁决 P(毒胜出)=86.8%）。
+  //
+  //   "off"     默认。不分类、不记账，conflict 相位与本键引入前逐字节一致。
+  //   "shadow"  只分类 + 落 conflict_ledger 账本（bookkeeping，不触发 write hooks），
+  //             freeze/LLM 路径零变化——beta 实验的测量期：shadow 一周拿真实分诊
+  //             分布，验证是否复现 46/20/5/27。
+  //   "enforce" 确定性处置：T1（dup）走信息量优先 supersede（supersedeInfoFirstPair，
+  //             败者归档、胜者正文不动、可追溯注记在被归档侧）；T2（跨作用域重复）
+  //             与 T4（真矛盾）只记账——不停车、不送 LLM、不动正文；T3（时序演进）
+  //             落取代链：旧行 superseded_by/superseded_at 指向新行，两行都留着、
+  //             正文都不动，检索侧按降权处理。人审队列与 LLM 裁决都不再消费冲突
+  //             候选；与 conflictFreezeEnabled 同开时 freeze 让位（降级 shadow
+  //             + warn，#616 父子绑定不继承）。
+  //
+  // 判据唯一实现在 src/dream/triage.js；处置共享实现在 decisions.js 的
+  // supersedeInfoFirstPair。每个档位的行为都真实存在——#616 的「假成功」教训
+  // （autoMin 0.95 在现库覆盖为 0，开了等于没开）。
+  conflictLedgerMode: z.union([z.const("off"), z.const("shadow"), z.const("enforce")]).default("off"),
+  // T1（dup）档的相似度下限。检测阈值（normal 0.85）与自动档 autoMin（0.95）之间
+  // 的空带由它接管：真实库 reason 相似度回声集中在 0.85-0.93，正好落在两个阈值
+  // 之间、自动档开了也接不住的那一段。下界与检测阈值同源。
+  conflictLedgerDupMinSimilarity: z.number().min(0.85).max(1).default(0.9),
+
+  // --- entity gene (v0.3.0) -----------------------------------------------
+  // Opt-in: when false (default) nothing in the pipeline extracts entities.
+  // The storage layer (entities/entity_attrs/entity_relations tables + CRUD)
+  // is always available regardless of this flag.
+  entityExtractionEnabled: z.boolean().default(false),
+  // Optional provider override for entity extraction; empty = use the caller's
+  // default provider/model. Combined with entityExtractionModel — provider
+  // without model (or vice versa) falls through to the caller default.
+  entityExtractionProvider: z.string().default(""),
+  // Optional model override for entity extraction; empty = use the caller's
+  // default provider/model.
+  entityExtractionModel: z.string().default(""),
+  // Reasoning effort for entity extraction (issue #109), mirrors
+  // dreamReasoningEffort pass-through: 'none' omits the field / provider
+  // default; off/low/medium/high passed through. A provider that rejects the
+  // effort retries once without it, so opting in is safe to experiment with.
+  entityExtractionReasoning: z.union([
+    z.const("low"),
+    z.const("medium"),
+    z.const("high"),
+    z.const("none")
+  ]).default("none"),
+  // Cap on entities per extraction pass and attributes per entity.
+  entityExtractionMaxEntities: z.natural().min(1).max(20).default(10),
+  entityExtractionMaxAttrs: z.natural().min(1).max(50).default(20),
+  // Prefix/semantic search over entity names (used by recall).
+  entitySearchEnabled: z.boolean().default(true),
+  // 图召回轴（issue #219）：查询文本命中实体名时，把该实体挂联的记忆并入
+  // 检索融合池（与 BM25 同级的确认/回填信号）。默认关=检索行为与 #219 前
+  // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
+  entityRecallEnabled: z.boolean().default(false),
+  // 边权重演化（issue #24 块2）：touch 门控是否把被寻回路径的边权重抬升。
+  // 默认关=边初值纯由建边来源决定（store.RELATION_SOURCE_DEFAULTS），演化
+  // 不生效；开=被激活的边经 bumpRelationWeight 上涨（只加不减、封顶 1.0）。
+  graphWeightEnabled: z.boolean().default(false),
+  // 单次有效触达的抬升幅度。
+  graphWeightDelta: z.number().min(0).max(1).default(0.1),
+  // 被动确认（issue #24 块4）：heat 触达（记忆被召回/注入=被用）即对该记忆
+  // 挂联的关系边做被动确认——bumpRelationWeight 抬一格。默认关=零行为变化；
+  // 开=正常触达演化边权，「关系是用出来的」闭环落地（异常路径复核留后续块）。
+  graphPassiveConfirm: z.boolean().default(false),
+
+  // --- 图谱锚定层（issue #24 · 块1 Activation Anchoring）-------------------
+  // entityRecallEnabled 之上再开一层：以查询命中的实体为种子，沿实体关系表
+  // 级联扩散（默认深度 2），把「邻居实体挂联的记忆」也带进融合池。种子集
+  // 上限 graphSeedCap、级联深度 graphCascadeDepth 一并下发到 anchorSeeds /
+  // cascadeDepths（见 src/graph/anchoring.js）。默认关=行为与 #219 单跳轴
+  // 逐字节一致；走 feature_flags 面板可启停，lightMode 强制关闭。
+  graphAnchoringEnabled: z.boolean().default(false),
+  graphSeedCap: z.natural().min(1).max(30).default(12),
+  graphCascadeDepth: z.natural().min(1).max(3).default(2),
+
+  // 关联提示防幻觉（issue #24 块3）：图召回的候选（查询命中实体的挂联记忆）
+  // 进注入时默认只参与排序、不改变注入块构成（graphInjectHint=false 保守档）；
+  // 开启后注入文本里以固定句式「[检索线索] …」标出，引导语说明这是链路信息
+  // 非事实断言，防 LLM 单次消费把桥接召回当有依据的事实回头扩散。
+  graphInjectHint: z.boolean().default(false),
+  // 图召回候选在注入块里的独立预算（条数上限）。与 pin/document 预算同构：
+  // 不占 maxInjectedItems 名额、只约束「桥接线索」这类低信任信息的常驻占比。
+  graphInjectBudget: z.natural().min(0).max(5).default(1),
+
+  // --- sleep mode: idle-triggered deep maintenance (v0.4.0) ---------------
+  // Opt-in, off by default. Unlike autoDream (threshold-triggered, lightweight)
+  // sleep fires when the store has been quiet for sleepIdleMinutes and deep-
+  // maintains the whole library: conflict resolution, archival demotion,
+  // pattern discovery and entity relation completion. Abortable on user
+  // activity, audited into dream_runs (run_type='sleep'), and serialized with
+  // autoDream so the two never overlap.
+  sleepModeEnabled: z.boolean().default(false),
+  // Quiet window before a cycle fires (minutes).
+  sleepIdleMinutes: z.natural().min(1).max(60).default(5),
+  // Minimum gap between two sleep runs (hours) — a second idle window within
+  // this interval does not retrigger.
+  sleepMinIntervalHours: z.natural().min(1).max(168).default(8),
+  // Issue #529（C 项的替代实现）：sleep 连续失败退避（默认关 = 行为逐字节不变）。
+  // 基数是 sleepMinIntervalHours，有效间隔 = 基数 × 2^连续失败数（成功清零），
+  // 封顶 max(基数, 24 小时)——不是硬 24 小时：这个键允许配到 168，用户配 48 就是
+  // 明说「两天跑一次」，退避只能放宽间隔、不该把用户自己的基数压小。
+  // 为什么不按 issue 原案用 snapshot_hash 判据：sleep 的
+  // snapshot_hash 是**跑完之后**对 phases 结果算的哈希（dream/sleep.js 的
+  // createHash(JSON.stringify(phases))），不是输入快照；同一批输入跑两次结果不同
+  // 就会得到不同哈希，用它当「同一输入又在失败」的判据不成立。退避与 #292 的
+  // autoDreamFailureBackoff 同构：只放大既有的最小间隔闸，不新增状态面。
+  sleepFailureBackoff: z.boolean().default(false),
+  // Conflict adjudication strictness:
+  //   gentle    only high-confidence conflicts (threshold 0.92) are resolved
+  //   normal    standard dream-level (threshold 0.85)
+  //   aggressive low-confidence pairs are also adjudicated (threshold 0.75)
+  sleepConflictStrictness: z.union([
+    z.const("gentle"),
+    z.const("normal"),
+    z.const("aggressive")
+  ]).default("normal"),
+  // Issue #126：冲突阶段的动作集。"conflict"（默认 = 现状）只用 conflict/keep——
+  // 后台自动流程不静默扩张行为；"full" 开放六分支（merge / update / supersede /
+  // differentiate / conflict / keep），互补型与演进型重复因此有了正确出口，不再
+  // 被迫"输赢化"（实测抽样 10 对里 2 对属演进型/互补型，用 conflict 处理会丢信息）。
+  sleepActionSet: z.union([
+    z.const("conflict"),
+    z.const("full")
+  ]).default("conflict"),
+  // Archival demotion tiering (days since last access):
+  //   >= sleepArchiveDays  → shrink to summary, full body kept in _full_content
+  //   >= sleepCompressDays → archived outright (entity relations preserved)
+  sleepArchiveDays: z.natural().min(7).max(365).default(30),
+  sleepCompressDays: z.natural().min(7).max(365).default(90),
+  // Pattern discovery scan window (most recent memories to scan).
+  sleepPatternMinMemories: z.natural().min(10).max(1000).default(100),
+  // How far back pattern discovery considers entity attr changes (days).
+  sleepPatternLookbackDays: z.natural().min(1).max(90).default(30),
+  // Max pattern memories minted per run (0 = disabled).
+  sleepMaxPatternPerRun: z.natural().min(0).max(10).default(3),
+  // --- affective attribution (v0.13.0, issue #619) --------------------------
+  // Opt-in: when false (default) the affective phase does not run at all — no
+  // LLM call, no relations written. It exists so that a situational emotion
+  // ("she was anxious on defence day") can be stored as an occasion-bound
+  // relation instead of being generalised into "she is an anxious person".
+  sleepAffectiveEnabled: z.boolean().default(false),
+  // How many **independent sessions** a candidate must span before it may be
+  // promoted to a type=pattern trait. Below this it stays an occasion-bound
+  // affective_context relation. The floor is 2 on purpose: N=1 means a single
+  // occasion, and a single occasion is exactly what must never become a trait
+  // (that is the failure mode this phase exists to prevent).
+  sleepAffectiveTraitMinSessions: z.natural().min(2).max(10).default(3),
+  // Max affective_context relations written per run. Same role as
+  // sleepMaxPatternPerRun for the relation channel: a runaway model that
+  // "finds" an emotion in every memory must be capped, not trusted.
+  sleepAffectiveMaxRelationsPerRun: z.natural().min(0).max(50).default(10),
+  // Optional LLM route override for sleep's bulk passes (empty = use dream
+  // route / agent default model).
+  sleepProvider: z.string().default("").description("sleep 深维护专用模型服务商，留空用巩固模型或当前模型。"),
+  sleepModel: z.string().default("").description("sleep 深维护专用模型，留空用巩固模型或当前模型；建议同巩固模型选非思考模型。"),
+  // Pass-through reasoning effort for sleep's LLM passes, same semantics as
+  // dreamReasoningEffort (Issue #135 建议 4/5): unset resolves to the lowest
+  // effort the model declares; explicit 'none' omits the field; off/low/
+  // medium/high are forwarded verbatim.
+  sleepReasoningEffort: z.union([
+    z.const("off"),
+    z.const("low"),
+    z.const("medium"),
+    z.const("high"),
+    z.const("none")
+  ]).description("同 dreamReasoningEffort：sleep 各阶段 LLM 的推理档位，未配置 = 自动取模型支持的最低档；显式 'none' = 不发送字段、用服务商自带默认。"),
+  // Pass-through reasoning effort for the distill (summarize) LLM call
+  // (issue #315). Mirrors entityExtractionReasoning rather than dream: the
+  // default 'none' omits the field entirely (provider default), so current
+  // behavior is unchanged until the user opts in — no auto-lowest resolution
+  // here, distill failures are retried at the window level anyway. off/low/
+  // medium/high are forwarded verbatim; a provider that rejects the effort
+  // retries once without it (withEffortFallback), so opting in is safe to
+  // experiment with. The failure being addressed is the #9 shape on the
+  // distill path: a thinking model drains the output budget on reasoning and
+  // the summary comes back empty/truncated.
+  summarizeReasoningEffort: z.union([
+    z.const("off"),
+    z.const("low"),
+    z.const("medium"),
+    z.const("high"),
+    z.const("none")
+  ]).default("none").description("蒸馏（会话总结提炼）LLM 的推理档位：默认 'none' = 不发送字段、用服务商自带默认；off/low/medium/high 原样传递，被模型拒收时自动去掉字段重试一次（与巩固/睡眠同款降级，#315）。思考型模型建议 off/low，避免推理烧光输出预算。"),
+  // Issue #257：sleep 冲突/模式两阶段的输出预算（原硬编码 2048）。实测默认档
+  // 每对裁决约 90 token、24 对 2097——2048 恰好压在边界（53 次运行 48 败）；
+  // full 档六分支实测约 290 token/对、24 对 6967，2048 必然截断。默认 8192
+  // 覆盖实测峰值（候选对按「每记忆至多一对」去重，饱和在 ~25 对、不随库无限
+  // 增长）；流式计费按实际用量，不按上限。
+  sleepMaxTokens: z.natural().min(256).max(131072).default(8192).description("sleep 冲突消解与模式发现阶段的 LLM 输出预算上限（token）。原为硬编码 2048，sleepActionSet=full 实测需约 7000 导致裁决被截断而整轮失败；流式计费按实际用量，调大不增加成本。"),
+
+  // Issue #529：冲突阶段此前没有任何输入侧预算——同 scope 的全部相似对被一次性
+  // 拼进一个 prompt，实测单请求 163,054 输入 token（服务端 --ctx-size 163,840，
+  // 占 99.5%），449 对的池子必然撞墙；而失败的轮次不落 pairs、判 keep 又是
+  // no-op，下一轮冷却结束再送**完全相同的输入**，于是 23 轮连续 llm failed。
+  // 输出侧早有 sleepMaxTokens（#257），输入侧这一半一直是空的。
+  //
+  // 每批上限：0 = 不设上限（严格回退到旧的一次性全送，用于排查"是不是分批
+  // 引入的差异"）。取 12 是因为实测单对约 112~168 输入 token、12 对落在
+  // 1.5K~2K 区间，远低于任何服务商的上下文窗口，也不至于让 LLM 在长清单里
+  // 走神。
+  sleepConflictMaxPairs: z.natural().min(0).max(500).default(12).description("sleep 冲突阶段每批送给 LLM 的候选对上限（0 = 不设上限，回退旧的一次性全送）。实测单对约 112~168 输入 token，默认 12 对约 1.5K~2K。"),
+  // 每轮总上限：分批之后仍要有个总闸，否则一个 449 对的池子会拆成 38 批、
+  // 每批一次 LLM 往返，单轮跑上几小时（本身也没比撞墙好）。0 = 不设上限。
+  // 未入选的对不是"被丢弃"——它们留在 conflict_pending 与下一轮的候选池里。
+  sleepConflictMaxPairsPerRun: z.natural().min(0).max(5000).default(60).description("sleep 冲突阶段单轮累计裁定的候选对上限（0 = 不设上限）。默认 60 对 ≈ 5 批，约 10K 输入 token。"),
+
+  // --- epistemic trust: memory source credibility (v0.4.5) -----------------
+  // Distinguish memories by source: observation (measured / witnessed),
+  // subjective (opinion / guess) and inferred (derived from other evidence).
+  // Opt-in by default: when false (default) retrieval ranking, injection
+  // marking and dream merge/conflict keepSource are untouched and
+  // epistemic_status stays inert data (still written + inferred on save, just
+  // never used to influence behavior).
+  trustEpistemicWeighting: z.boolean().default(false),
+
+  // --- memory quality filter (Bug7) ------------------------------------------
+  // Heuristic gate on what deserves the injection/recall surface. When enabled,
+  // saveWithDedupe scores each new memory after dedupe and before write:
+  //   score >= degradeThreshold (60) → stored normally
+  //   archiveThreshold (30) <= score < 60 → quality_score persisted and the
+  //       injection sort re-ranks by importance * quality_score/100 (degraded)
+  //   score < 30 → archived + tagged low_quality (still explicitly searchable)
+  // Meta-memory markers, near-duplicates and repetitive filler lose points.
+  // "Repetitive" is trigram repetition > 0.7 (this change). The shipped v0.7.12
+  // measure was unique-chars/total, which decays with length: it flagged 94% of
+  // 800-2000 char memories and 100% of longer ones, i.e. long Chinese prose was
+  // punished for being long. Threshold rationale lives in quality-filter.js.
+  memoryQualityFilter: z.object({
+    enabled: z.boolean().default(true),
+    archiveThreshold: z.natural().min(1).max(100).default(30),
+    degradeThreshold: z.natural().min(1).max(100).default(60),
+    minContentLength: z.natural().min(1).max(1000).default(10),
+    // Issue #135 附属发现 1：importance ≥ 该值的记忆不参与静默自动归档——评分
+    // 与信号标签照常写入（可观测）、注入排序照常降权，但 setArchived 跳过。
+    // 报告实测 150 条低分归档里 128 条 importance ≥ 4（51 条 = 5）。设 1 = 全部
+    // 豁免（等效关闭自动归档），设 5 = 仅最重要的豁免。
+    exemptImportance: z.natural().min(1).max(5).default(4)
+  }).default({}),
+
+  // --- LLM audit trail (Bug8) ------------------------------------------------
+  // Records every background LLM call into llm_audit_logs: tokens, duration,
+  // status and which trigger produced it. Failures are recorded as
+  // status='error' and never block the feature. retentionDays bounds the table:
+  // older rows are purged on boot.
+  //
+  // Covered trigger_source values: autoDream (consolidation + summary),
+  // autoSummarize (compression), sleep (conflict + pattern) and entityExtract
+  // (issue #250 — the last two were structurally missing the hook, not a
+  // deliberate narrowing). entityExtract runs on every memory write, so row
+  // growth scales with write volume; retentionDays caps the ceiling but not the
+  // rate. If that turns out too fast, sample by operation_type or give it a
+  // separate retention — do not add a second gate: this flag is the single one.
+  llmAudit: z.object({
+    enabled: z.boolean().default(true),
+    retentionDays: z.natural().min(1).max(3650).default(90)
+  }).default({}),
+
+  // --- distill records + provenance (#399) ------------------------------------
+  // 蒸馏把窗口压成记忆后，原文默认不留——于是「这条记忆出自哪段对话」事后无法
+  // 复核（arXiv 2609.36059 §3 Eq.1：旁路索引不丢信息，替换才丢）。开启后蒸馏时
+  // 顺带把**公开**正文原样落盘（distill_records），并给写出的记忆挂上窗口链接
+  // （memory_provenance）。默认关：这是一份对话原文副本，价值与暴露面都取决于
+  // 用户是否愿意留档，不该由升级默认打开。
+  //
+  // retentionDays 只裁 distill_records（启动即清，挂 llmAudit purge 旁）；链接
+  // 保留指向空区间，面板/CLI 显示「来源已过期」——删原文不等于篡改历史。落盘
+  // 文本不受 distillMaxChars / trim(args,300) / trim(out,500) 约束（记录是凭证，
+  // 不是喂给 LLM 的预算）；工具调用入参与结果、code 输出不落盘（推理亦然）。
+  distillRecords: z.object({
+    enabled: z.boolean().default(false),
+    retentionDays: z.natural().min(1).max(3650).default(90)
+  }).default({}),
+
+  // --- capacity warning (#275: 空间维度) ---------------------------------------
+  // 容量预警：库体积 / 归档区规模过线时在 /health 与面板上报（维护者 2026-10-21
+  // 接手口径：有 retentionDays 的时间维度，缺空间维度）。三个阈值都是**观察口**，
+  // 不是动作触发：没有任何周期性消费者（/health 被读到才算一次），预警也永不
+  // 自动归档 / 删除（#275 拍板：真删由人显式确认）——所以不设 enabled 总开关，
+  // 数字恒在 /health，阈值 0 = 显式关掉那一条检查。
+  //
+  // 默认值锚定议题里的形态区间，不是拍脑袋：
+  //   dbSizeWarnMb 256 —— 议题实测 55 MB 库 VACUUM 0.8s；按同议题的归档增速
+  //     （+143 行/天 ≈ 2.8 MB/天）留约 70 天余量，正落在「现在便宜、以后贵」
+  //     该开始看数字的量级；
+  //   archivedRowsWarn 5000 —— 「归档是数千条这个量级」的上沿（议题实测 2,400
+  //     时还没坏）；
+  //   archivedRatioWarn 0.95 —— 健康形态本身就落在 0.8~0.9（活跃数百 / 归档
+  //     数千，议题实测 0.90），0.9 会对着健康库天天报警；0.95 起才是「归档区
+  //     把活跃区吞掉」的形态。
+  // 判级实现在 service.getCapacityHealth，答复挂 /health 的 capacity 块；出口是
+  // 维护卡的无损回收（dsh-mneme reclaim，见 docs/STORAGE.md）与后续批次的归档区
+  // 周期处理。增速指标（归档净增速率）在 recall-stats 的 archive 块，不在这里重复。
+  capacityWarning: z.object({
+    dbSizeWarnMb: z.natural().min(0).max(1048576).default(CAPACITY_WARNING_DEFAULTS.dbSizeWarnMb),
+    archivedRowsWarn: z.natural().min(0).max(10000000).default(CAPACITY_WARNING_DEFAULTS.archivedRowsWarn),
+    // 浮点：与 conflictAutoResolveMinSimilarity 同款（面板整数控件吃不下小数，
+    // 走 FEATURE_FLAG_NUMBER_RANGES）。
+    archivedRatioWarn: z.number().min(0).max(1).default(CAPACITY_WARNING_DEFAULTS.archivedRatioWarn)
+  }).default({}),
+
+  // --- write admission (#254) ------------------------------------------------
+  // 写入准入：把「这条该不该进库」前移到 LLM 之前。与 memoryQualityFilter 的分工
+  // 是时点不是判据——那个是**写入后**打分归档（扣分可以错，只影响排序与归档），
+  // 这个是**写入前**判定（硬拒不能错）。
+  //
+  // 两个开关都默认关（验收第 1 条「默认关零行为变化」）：
+  //   enabled — 跑第 1 级确定性判据。关时 evaluate 的返回与只计量那一阶段逐字段
+  //     一致，写入路径完全不碰。
+  //   enforce — 命中时真的拒绝。关时判据照跑、审计照留，决策回落 allow（仅告警）。
+  //     读审计时「metadata.deny 非空且 metadata.decision=allow」就是这一档的指纹。
+  // 分层是为了能把「先观察」和「开始拦」分成两次上线：enforce 打开前先在真实流量
+  // 里看误杀面，而不是靠回滚开关当保险。
+  //
+  // 第 1 级的判据面刻意收窄到两类：密钥/PII（#164 A2 是判据来源，经
+  // createWriteAdmission 的 sensitiveScan 注入；本批只定义它怎么被消费）与空白/
+  // 纯噪声文本。去重键命中**不**进第 1 级——按维护者 09-22 的判定归 write-update
+  // 放行（2606.24535 的失效模式：同步近重复门跑在异步矛盾检测之前，把本该被裁决
+  // 的矛盾直接拒掉）；G1/G2 的阈值继续只计量，等遥测有分布再单独提。
+  writeAdmission: z.object({
+    enabled: z.boolean().default(false),
+    enforce: z.boolean().default(false)
+  }).default({}),
+
+  // --- issue #380: pre-inject gate (opinion/stance judgment before injection) -
+  // 注入前判定：每帧注入候选出池后、进入 system prompt 前，一次池级 LLM 调用判出
+  // 「会向本次请求注入意见/立场」的记忆（E12 D1 口径，判定协议同源实验
+  // protocol-preinject.txt）。两级语义复用 writeAdmission：
+  //   enabled — 跑判定。判定 async prefetch + cache、同步消费（宿主 systemPrompt
+  //     渲染是同步回调，冷缓存首帧降级为不判定原样注入，下一轮同 key 生效）；
+  //     判定完成落 llm_audit_logs（trigger_source=preInjectGate，真实 token 用量，
+  //     related_memory_ids=被标记记忆）——先在真实负载看意见占比分布。
+  //   enforce — 缓存命中帧真的滤除被标记候选。E12 实测只有过滤过判据（D1 −24.4pp，
+  //     判定+标记 D2 比它差 +17.6pp——给模型看标记的线已被 E2/E3 关闭，本闸判定
+  //     结果绝不进模型上下文）。enforce 无 enabled 时无效果。
+  // 降级路径：判定失败/超时/不可解析 → 本帧原样注入 + 审计行 degraded=true 且不
+  // 缓存——防线故障永不阻塞注入。判定 LLM 走 agentDefaultModel 当前选择（entity
+  // adapter 同款装配），不设独立 provider/model 键；llmAudit.enabled=false 时本闸
+  // 不运行（无账目的判定不可见也不该花钱）。lightMode 强制关（LLM-per-turn 附加
+  // 路径与低资源档互斥）。
+  preInjectGate: z.object({
+    enabled: z.boolean().default(false),
+    enforce: z.boolean().default(false)
+  }).default({}),
+
+  // --- #164 A2: secret / PII scan at the write boundary ----------------------
+  // 写入边界的密钥 / PII 判据（src/sensitive-scan.js）自身的闸。与 writeAdmission
+  // 的 enabled 分开是有意的：那一个管 #254 第 1 级的空白 / 噪声判据，本键管 A2 这
+  // 一类判据，两批的误杀面差一个量级（空白 / 噪声没有解释空间，邮箱 / 手机号有），
+  // 绑在同一个开关上就没法单独观察 A2 的命中分布。
+  //
+  // 分层必须写清：判据的唯一调用点在 #254 第 1 级的闸门里（write-admission.js 的
+  // firstLevelHit），闸门不走第 1 级就没人来调这个扫描器。所以本键是「闸门内这一批
+  // 判据参不参与」，不是一条能独立跑的链路——单开本键就是零行为变化：
+  //   writeAdmission.enabled 关                  → 第 1 级整个不跑，本键开也没用
+  //   enabled 开 + 本键关                        → 只跑空白 / 噪声那一批
+  //   enabled 开 + 本键开 + enforce 关           → 命中留审计，写入照常（观察档）
+  //   enabled 开 + 本键开 + enforce 开           → 命中即拒绝
+  // 默认关 = 只计量那一阶段的行为逐字节保留（#332 合并时 sensitiveScan 就是 null）。
+  // #164 的「默认仅告警、拦截 opt-in」落在 enforce 上：命中落一条审计
+  // （metadata.deny.kind）但照常写入，真要拦得 enabled 与 enforce 同时开。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  sensitiveScanEnabled: z.boolean().default(false),
+
+  // --- recall evaluation: test-result storage (v0.4.6, 方案 B) --------------
+  // Separate retrieval evaluation snapshots from the production recall audit.
+  // When false (default) evaluateRetrieval still computes precision/recall/mrr
+  // and returns them to the caller, but writes nothing to recall_evals — the
+  // eval table only grows when the operator opts in. Production searchMemories
+  // audits to recall_runs and NEVER touches recall_evals, regardless of this
+  // flag (production isolation is unconditional).
+  evalPersistTestResults: z.boolean().default(false),
+
+  // --- standalone external API (v0.7.12) ------------------------------------
+  // A plain node:http server for ecosystem integrations that cannot reach the
+  // DSH-internal webServer. Disabled by default; when enabled the Bearer token
+  // is persisted in the settings kv ("external_api"), auto-generated on first
+  // boot. Bind host: keep the loopback default — moving it to a non-loopback
+  // address exposes the whole memory store to the network and is the
+  // operator's responsibility.
+  externalApiEnabled: z.boolean().default(false),
+  externalApiPort: z.natural().default(8790),
+  externalApiHost: z.string().default("127.0.0.1"),
+
+  // --- light mode preset (v0.7.12) -------------------------------------------
+  // One switch for low-resource setups: turns off every background/semantic
+  // heavy path (dream consolidation, entity extraction, vector pipeline,
+  // reranker, BM25, semantic dedup / selective inject, sleep mode) while
+  // keeping the core loop (autoInject, autoSummarize, hot memory, quality
+  // filter, keyword search). Applied by applyLightModePreset before the config
+  // reaches any service; a persisted panel_mode="light" (settings kv) counts
+  // as lightMode=true too and wins over the bundle config.
+  lightMode: z.boolean().default(false),
+
+  // --- heat: v0.7.0 self-evolution (heat + interest drift) ----------------
+  // 总开关，默认关（v0.7.12+ 用户已习惯无 heat 行为，默认开=全员行为变更）。
+  // 开启后：提供热度字段 / sleep 降级联合判定保护 / 前端热度投影，并只在
+  // 注入排序的优先级层内乘 heat（#218 v1；store 的 order=chrono 分页序与
+  // 召回融合序不动）。关闭则跳过所有 heat 计算与热度触达，注入排序乘数
+  // 恒 1，sleep 降级退回纯时间分层。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  heatEnabled: z.boolean().default(false),
+  // issue #218 / E5 效用考卷：heat 乘进注入排序在真实年龄混合下饿死老约束
+  // （现行量级 ≡ 拟合参数，注入集逐条相同；importance-only 遵从 +12.7pp），
+  // 故注入侧 heat 改为独立 opt-in：默认关 = heatEnabled 开启后热度字段/sleep
+  // 保护/前端投影照常，但注入排序乘数恒 1（与 heat 关闭逐字节一致）；
+  // 显式开启才恢复「层内乘 heat」的旧序。召回侧时钟（touchLastAccess）与
+  // sleep 降级联判不受本键影响——它们不参与注入排序。
+  injectHeatEnabled: z.boolean().default(false),
+  // 广义指数形状参数 β（heat = exp(-λ·Δt^β)，issue #218 拍板）：β=1 纯指数。
+  // 快慢以 Δt>1 小时为准——β<1 衰减更慢（亚线性长尾）、β>1 更快（超线性）；
+  // 0<Δt<1 的首小时内方向相反（Δt^β 随 β 增大而变小）。专家调优项，不进面板白名单。
+  heatGlobalBeta: z.number().min(0.5).max(2).default(1.0),
+  // per-type 衰减因子 λ；λ=0 的类型免疫（热度恒 1.0，sleep 永不降级）。
+  // 未知类型走默认 0.002。dict 的键为 type 字符串、值为数字 λ。
+  heatTypeDecay: z.dict(z.number(), z.string()).default({ ...TYPE_DECAY_DEFAULTS }),
+  // sleep 降级联合判定的热度下限：heat < 该值 且 importance<5 才允许降级。
+  sleepHeatThreshold: z.number().min(0).max(1).default(0.05),
+  // recordRecall 默认值（recall_runs 记录默认开；显式传 false 的调用方不受影响）。
+  recallRecordDefault: z.boolean().default(true),
+  // recall_runs 滚动清理保留天数。
+  recallRetentionDays: z.natural().min(1).max(3650).default(90),
+
+  // --- tool exposure: 慢模型/轻量模型的工具往返节流（v0.8.5）----------------
+  // 跨会话记忆已由 inject.js 每轮自动注入系统提示词，memory_search 只用于
+  // 「注入里没有、需要深挖」的补充检索；memory_archive 是隐藏/恢复条目的整理
+  // 操作，正常会话里很少需要。轻量模型对「何时该用工具」判断弱，容易每轮
+  // 顺手调一遍——每次工具调用都是一次串行往返（生成参数→执行→回填→再生成），
+  // 在慢模型上会被放大成明显卡顿。这两个开关允许直接隐藏对应工具（默认全
+  // 开=行为不变），隐藏后模型根本看不到它，也就不会调。也走 feature_flags
+  // 白名单，面板可启停=线上回滚开关。
+  disableMemorySearch: z.boolean().default(false),
+  disableMemoryArchive: z.boolean().default(false),
+
+  // Issue #231 第二批：agent 主动整理接口（src/organize.js）的**暴露**闸。引擎在
+  // PR #267 就造好了，当时刻意不进工具列表、不加开关（模块头注释：「与 #249 同批
+  // 暴露时只差『注册工具 + 注入指引』一步」），配置面留到这一批再定——就是这里。
+  // 与上面两个 disable* 是**反向**语义：那两个把默认在场的工具藏起来，本键把默认
+  // 不在场的能力开出来。因为 dryRun→apply 是一套两步协议（apply 必须引用真实报告
+  // 的 run_id），让 agent 未经用户同意就能整理记忆，不是「少一次往返」的成本问题，
+  // 而是「谁在改库」的授权问题。
+  // 进 LIGHT_MODE_OFF：两步协议在弱模型上最容易走歪（漏 run_id、或跳过报告直接
+  // apply——那一拒绝就是一次失败的工具调用），而一次 dryRun 的代价是一回嵌入调用
+  // 加按 type 有界扫库。这是预设给的默认值、不是强制：用户显式勾选仍然赢（合并顺序
+  // 「用户开关 > 轻量预设 > bundle」，同 continuityRescueEnabled / distillRecords.enabled）。
+  organizeEnabled: z.boolean().default(false),
+
+  // chorography（仓库地志，spec: docs/specs/2026-11-04-chorography-design.md）的
+  // 暴露闸（opt-in，默认关）：管模型侧三个只读工具（choro_search / read_page /
+  // module_map）、面板浏览页，以及 M3 的开局注入。工具描述常驻模型上下文 = 新增
+  // 成本，按仓库纪律 opt-in；默认关=工具不存在、面板页空态、注入块不渲染，行为与
+  // 0.10.1 逐字节一致。
+  //
+  // 本键仍**不进 LIGHT_MODE_OFF**，但理由收窄成一句：它是「是否启用这个子系统」，
+  // 不是「每轮付多少」。轻量档要付的是下面那条 chorographyInject（把档位压成
+  // off）——两层分开，用户才能在轻量档里保留工具、只关掉每轮那块文本。
+  chorographyEnabled: z.boolean().default(false),
+
+  // 开局注入档位（M3，spec §7）：off / light / full，默认 light。
+  // light ≤8 行（模块名 + 文件数 + 页状态 + 页路径，按「还有 N 个」明说截断）；
+  // full 列全部模块；off 不注入但工具照旧可用。
+  // 为什么是枚举而不是布尔：spec 原文就是三档，「开了但只给 6 行」与「全给」是两种
+  // 用法，布尔键表达不了；跟随 chorographyEnabled 隐式开又会丢掉「留工具、去文本」
+  // 这个组合。
+  // 为什么写作 z.union([z.const(...)]) 而不是 z.enum：与 summarizeDedupeMode 同款，
+  // 全仓枚举键统一这一种写法（z.enum 的报错文案与既有键不一致）。
+  // 轻量档**不进 LIGHT_MODE_OFF**：那张表对平铺键一律赋 false，枚举键进去会得到与
+  // schema 不符的 false，而 false !== "off" 时注入照样渲染——静默失效比不关更糟。
+  // 轻量档的压制改在消费侧（src/wiki/inject.js 的 resolveInjectTier 判 lightMode）。
+  chorographyInject: z.union([z.const("off"), z.const("light"), z.const("full")]).default("light"),
+
+  // --- scope: v0.8.0 A1 存储层（issue #17）--------------------------------
+  // 总开关默认关：关闭时写入不标注 scope、去重维持 (type, title) 现状，行为
+  // 逐字节不变。开启后**两条写入路径都自动盖章**（*_scope_source='auto'）：
+  // ① 工具调用（tools.js：memory_save / memory_update，显式参数改标 'explicit'）
+  // ② 机器提炼（summarize.js：会话蒸馏；合并进既有行时不盖章，作用域属于那一行
+  //    原来被提炼出来的语境——v0.9.0 补，此前只有工具路径盖章，于是「项目记忆」
+  //    在库里几乎不存在）。
+  // 两路的值同源：agent 维取 session header 的 agentPreset，workspace 维取
+  // registry 反查的 canonical path（header.cwd 兜底，取不到 NULL——解析绝不阻塞
+  // 写入），去重键扩展为 (type, title, agent_scope, workspace_scope, sensitivity)。
+  // 检索侧加权/过滤在 A2/A3 落地。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  scopeEnabled: z.boolean().default(false),
+  // strictScope（A3）：硬过滤模式。关闭=A2 软隔离（他 scope 降权保留可见，
+  // 检索与注入排序同权重，issue #339 补齐注入通道）；
+  // 开启后检索/注入/list/get 按 issue #17 四象限可见性公式硬过滤——带他 scope
+  // 的记忆完全不可见，未标注（NULL）恒可见；当前会话某维度解析不到时该维度
+  // 带标注的记忆一律不可见（fail-closed：身份不明只见全局）。依赖 scopeEnabled
+  // 打开才有意义（没有写入标注就无可过滤维度），但独立成键：可先开标注积累
+  // 数据、观察 A2 加权质量后再切硬过滤。
+  strictScope: z.boolean().default(false),
+
+  // scopeState（issue #471）：政策轴——作用域级可逆闸门。与上面两个键是**两条不同
+  // 的轴**：scopeEnabled/strictScope 管「这条记忆属于谁」（事实轴：持久、跟着记忆
+  // 行走、改的是归属数据），本键管「这个作用域现在通不通」（政策轴：暂时、由人单
+  // 方面按下、松开即恢复、不改任何记忆行）。
+  // 两级语义同 writeAdmission/preInjectGate——enabled 打开时被按下的作用域其候选
+  // 照常注入，但留一条审计行说清「本应被拦下几条」（观察档，先在真实流量看会少掉
+  // 多少再决定真按）；enforce 打开才真的不注入（拦截档）。两个都默认关，打开前
+  // 行为与今天逐字段一致。
+  // 不进 LIGHT_MODE_OFF：它只是查一张小表的判定，不引入重型后台路径、不加常驻
+  // 文本（同 actionPipelineEnabled 的定性）——轻量档预设该关的是重型能力，不该替
+  // 用户关掉一个纯判定入口，用户显式勾选仍然赢。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  scopeState: z.object({
+    enabled: z.boolean().default(false),
+    enforce: z.boolean().default(false)
+  }).default({}),
+
+  // --- v0.9.0 M.O.（Modus Operandi，beta）--------------------------
+  // 命名：M.O. = Modus Operandi，拉丁语「一个人一贯的做事方式」，缩写 M.O.；
+  // 也正是 org 词根 modus（modusensus）。界面主显示 M.O.，设置项 hint 第一句
+  // 给全名——缩写不靠注释解释，靠用户第一眼能看见全名。
+  // 这是客户端只读视图（做法图谱 + 对话行结算卡）的门控。API 的 effective 取值只认
+  // config 顶层/嵌套路径，schema 里没有这个键 → effective 静默少键 → 客户端读
+  // 不到就一个座位都不注册（#254 漏登记 NESTED_FLAG_PATHS 是同一个坑）。
+  // 默认关：beta 功能必须 opt-in，老用户行为逐字节不变。不进 LIGHT_MODE_OFF——
+  // 它只是只读视图、不引入任何重型后台路径，轻量档用户显式勾选仍然赢（预设
+  // 该关的是重型能力，不该替用户关掉一个纯 UI 入口）。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  actionPipelineEnabled: z.boolean().default(false),
+
+  // M.O. 执行记账（v0.9.0 第二批）：`/mo-run` 显式开一次执行窗口，窗口内的命令执行
+  // 才可能被记成一条 run。与上面那个键**分开**：上面管「看图的座位」，这个管
+  // 「往账本里写」——看图和写账是两件事，混成一个键会让「只想看图」的人不知不觉
+  // 获得写入能力。
+  //
+  // 默认关（beta 必须 opt-in）。它挂在热路径上（每个会话事件都过一次监听），
+  // 所以轻量档要关掉：`LIGHT_MODE_OFF` 里有它。
+  actionRunEnabled: z.boolean().default(false),
+
+  // M.O. 自动沉淀（v0.9.0 第三批）：会话跑完一轮后，把这个项目自己的会话日志挖一遍，
+  // 把「反复出现的同一段能力序列」落成提议（memoryDir 下），可选再落一份 draft 草稿。
+  //
+  // 与上面两个键三件事分开：actionPipelineEnabled 管「看图的座位」，actionRunEnabled
+  // 管「往账本里写」，这个管「从日志里长出候选」。三个都是独立能力，混成一个键会让
+  // 「只想看图」的人顺手获得写盘能力。
+  //
+  // 默认关（beta 必须 opt-in），并且进 LIGHT_MODE_OFF：它挂在 session/event 热路径上，
+  // 且解压会话日志是**同步**的（本机 118 份实测 16.2s），轻量档最不该背这条路径。
+  // 触发侧另有 10 分钟/项目的冷却与 budgetMs 上限（见 src/pipeline-nudge.js 的
+  // NUDGE_AUTO_MIN_INTERVAL_MS 与 src/index.js 的装配注释）——旗标只是总闸。
+  // （冷却值以常量为准：早前这里写「30 分钟」，与实际 10 分钟不符。）
+  actionNudgeEnabled: z.boolean().default(false),
+
+  // --- 人格定义页（beta）---------------------------------------------------
+  // 注入器渲染人格段的顶层总闸（双闸门的 config 半边；user_settings "persona"
+  // 键内的 persona.enabled 是 per-agent 半边，两闸同真才渲染）。API 的 effective
+  // 必须含这个键——schema 里没有它 effective 就静默少键，面板开关形同虚设
+  // （#254 漏登记 NESTED_FLAG_PATHS 是同一个坑，计数锁 test/api.test.js 钉住）。
+  // 默认关：beta 功能必须 opt-in，老用户行为逐字节不变。不进 LIGHT_MODE_OFF——
+  // 人格段是用户自写的一小段轻量常驻文本，不引入任何重型后台路径，轻量档用户
+  // 显式勾选仍然赢（同 actionPipelineEnabled 的定性）。
+  // 也走 feature_flags（FEATURE_FLAG_BOOLEANS 白名单），面板可启停=线上回滚开关。
+  personaEnabled: z.boolean().default(false),
+
+  // 人格寻址的兜底口径（只在上一个键打开时才有意义）。关（默认，= 历史行为）：
+  // 会话身份没有卡、或有卡但卡被关掉时，一律落 default 卡——于是 default 成了
+  // 「所有没建卡的 agent 都能拿到某个人格」，宿主里跑的外部 bot（自带身份与设定）
+  // 会在同一帧里收到两句「你是谁」。开：这两种情况都不注入人格，default 退回它的
+  // 本意——只兜「这一帧解析不到会话身份」的无名会话（无身份时行为不变）。
+  // 默认关是因为这是一次口径变更：老用户升级后注入文本不许静默变化。
+  // 不进 LIGHT_MODE_OFF：它只是取卡时的一个分支，不引入常驻文本、也不引入后台路径，
+  // 且它本身只在 personaEnabled 打开时才起作用（同 scopeState 的定性）。
+  personaStrictAddressing: z.boolean().default(false),
+
+  // Issue #497：从活跃记忆反向提取「助手眼中的用户」画像**草稿**（POST
+  // /api/dsh-mneme/profile/extract）。默认关有三层理由：① 它每次点一次就是一次 LLM
+  // 调用并读上百行记忆，成本与 dream/summarize 同级，不该在没人要求时挂在面上；
+  // ② 产物会被用户当成「关于我的第一版画像」读，编造的代价不对称——所以空库直接报错、
+  // 解析失败也报错，绝不回空草稿；③ 它**不写** user_settings，采用草稿是面板里另一次
+  // 显式保存，画像正文必须是用户手写的原文，不给模型改写权。
+  // 进 LIGHT_MODE_OFF：一次调用要读上百行记忆 + 一轮模型生成，与低资源档互斥（同
+  // preInjectGate.enabled 的定性）；是预设不是强制，用户显式勾选仍然赢。
+  profileExtractEnabled: z.boolean().default(false),
+
+  // 「Agent 眼中的你」自动事实（2026-11-06，对标 ChatGPT 记忆 / DS Bot 每 bot 的
+  // MEMORY.md）：dream 巩固轮成功后按会话身份分卡增量维护一份逐条事实清单，
+  // 注入在手填画像之后（src/user-settings.js 的渲染顺序），面板可手动触发与逐条
+  // 修正（POST /api/dsh-mneme/profile-facts/*）。与 profileExtractEnabled 的三层
+  // 理由同源：① 自动轮是 dream 级别的 LLM 调用 + 读上百行记忆，不该在没人要求时
+  // 挂在面上；② 产物每帧注入，编造的代价不对称（维护 prompt 的三段硬约束与
+  // profileExtract 同源）；③ 它**不写** user_settings——手填画像神圣（#497 口径
+  // 不变），事实住独立的 profile_facts 表，可被人在面板上逐条修正。
+  // 进 LIGHT_MODE_OFF：自动维护轮与低资源档互斥（同 organizeEnabled 的定性）；
+  // 是预设不是强制，用户显式勾选仍然赢。注入段本身极轻（几十行文本），不额外
+  // 占用轻量档预算的考量见键注释末句。
+  profileFactsEnabled: z.boolean().default(false),
+
+  // chorography 面板闭环（2026-11-08 kb-qoder parity，契约见
+  // docs/plans/2026-11-08-kb-qoder-parity.md §3.1）。三个键都是「面板能不能替人
+  // 动手」的授权闸，与上面的 chorographyEnabled（子系统总闸）分层：总闸关着时
+  // 它们一律不生效，所以不必再进 LIGHT_MODE_OFF —— 轻量档要压的是「每轮付多少」，
+  // 而这三个键管的是「谁按下了重跑按钮」，关了也省不下一次调用，反倒让面板在
+  // 轻量档里静默少一块可操作区（同 chorographyEnabled 的定性与理由）。
+  //
+  // 过期的仓库在面板上直接刷新（POST /choro/run 的 refresh）。默认关：一次 T0 重跑
+  // 会扫整个仓库并重写 .chorography/ 下的页面，属于「改动工作区」的动作，不该在
+  // 没人要求时被面板顺手触发。
+  chorographyAutoRefresh: z.boolean().default(false),
+  // 面板发起 T1（POST /choro/t1）。默认**开**：这是面板闭环的主路径，关掉等于面板
+  // 上那个按钮永远是死的；真花钱的那一步仍由用户点按钮触发，且有
+  // chorographyEnabled 总闸在前面。需要「只读面板」的部署可以单独关它。
+  chorographyT1FromPanel: z.boolean().default(true),
+  // kb 子系统（知识库问答，B 线实现）的总闸。本车道只登记键与白名单，接线由后续
+  // 车道做——先有键才能让 /features 稳定暴露 false，客户端不至于静默少键。
+  kbEnabled: z.boolean().default(false),
+
+  // #539 逐会话无痕：总开关默认关，保持旧用户行为；子代理选择器默认开，但总开关
+  // 未开时不生效。手动名单是精确的 session id 匹配。
+  sessionGateEnabled: z.boolean().default(false),
+  sessionGateSubagents: z.boolean().default(true),
+  sessionGateSessions: z.array(z.string()).default([])
+});
+
+// Fields forced to false by the light-mode preset. Everything not listed here
+// (autoInject, autoSummarize, hotMemory*, memoryQualityFilter, dream
+// thresholds/delays, ...) is left untouched — those are the core loop.
+const LIGHT_MODE_OFF = [
+  "entityExtractionEnabled",
+  "autoDream",
+  "sleepModeEnabled",
+  // #619：情感归因相位要调模型、且依赖实体抽取产出（抽取关掉就没有实体可挂边），
+  // 与低资源档双重互斥。默认本就是关，这里只是轻量预设再确认一次。
+  "sleepAffectiveEnabled",
+  "rerankEnabled",
+  "autoReindexOnBoot",
+  "hybridInject",
+  // #249 第二批：能力说明在轻量档保持关闭——它是工具描述与提示段上的额外常驻
+  // 文本，轻量档（小模型 / 小上下文）不该因默认值翻转而多付这份提示成本。
+  "injectGuidanceEnabled",
+  "searchSemanticDedup",
+  "selectiveInjectEnabled",
+  "bm25SearchEnabled",
+  // 轻量模式不开图召回轴（#219，依赖实体抽取产出；抽取本身已被关掉）。
+  "entityRecallEnabled",
+  // 轻量模式不开图谱锚定层级联（#24 块1，依赖实体抽取 + 关系表，抽取已关则无边可扩）。
+  "graphAnchoringEnabled",
+  // 轻量模式不开边权重演化（#24 块2，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
+  "graphWeightEnabled",
+  // 轻量模式不开关联提示标注（#24 块3，常驻注入文本多一段提示成本）。
+  "graphInjectHint",
+  // 轻量模式不开被动确认（#24 块4，依赖实体抽取产出；抽取关则无 v08 边可抬升）。
+  "graphPassiveConfirm",
+  // 轻量模式不开叙述条（额外 LLM 调用；#164 对齐，opt-in）。
+  "dreamNarrativeEnabled",
+  // 轻量模式不开 document 指针行（#230，opt-in：注册/注入/检索增强全随闸）。
+  "documentMemoryEnabled",
+  // #231 第二批：轻量档不开 agent 主动整理。理由不是成本而是协议——dryRun→apply
+  // 要求 agent 拿住上一轮的 run_id 再回来，弱模型漏这一环就是一次被拒的调用；
+  // 预设关、不剥夺显式开启的权利（合并顺序同 continuityRescueEnabled）。
+  "organizeEnabled",
+  // 轻量档不开画像事实自动维护轮（2026-11-06）：dream 后的逐卡 LLM 调用 + 读上百行
+  // 记忆，与低资源档互斥（同 organizeEnabled 的定性）。注入段本身是几十行常驻文本，
+  // 关掉自动轮不省注入成本、省的是维护调用——这正是该进这张表的路径。
+  "profileFactsEnabled",
+  // 图像描述档：一次额外的视觉调用，与低资源档互斥（同 profileFactsEnabled 的
+  // 定性）。预设关不是强制，用户显式勾选仍然赢。
+  "imageDescribeEnabled",
+  // 轻量模式不开热计算（heat 属于重型增强；关掉后 sleep 降级也退回纯时间分层）。
+  "heatEnabled",
+  // 轻量模式不开注入前判定（#380：LLM-per-turn 附加路径，每帧注入多一次池级
+  // 判定调用——与低资源档互斥；预设给的默认值，用户显式勾选仍然赢）。点分键
+  // 由 applyLightModePreset 的嵌套赋值分支处理。
+  "preInjectGate.enabled",
+  // #249 N3：轻量档默认不开压缩边缘双落点——它往对话里追加消息（新的注入表面），
+  // 轻量档（小模型 / 小上下文）最不该再多一份注入物。这是预设给的默认值、不是强制：
+  // 用户显式勾选仍然赢（合并顺序「用户开关 > 轻量预设 > bundle 配置」，同
+  // injectGuidanceEnabled）。
+  "continuityRescueEnabled",
+  // #399：轻量档不开蒸馏原文留存——它是一份对话原文副本（磁盘 + 暴露面），
+  // 与轻量档「小模型 / 小上下文 / 少留痕」的取向相反。默认关，这里只是
+  // 轻量预设再确认一次；用户显式勾选仍然赢（合并顺序同 continuityRescueEnabled）。
+  "distillRecords.enabled",
+  // M.O. 执行记账：它挂在**热路径**上（每个会话事件都过一次监听）。轻量档的取向
+  // 是「小模型 / 小上下文 / 少常驻路径」，这与一个每事件都过一遍的监听器相冲突。
+  // 默认关，这里只是轻量预设再确认一次；用户显式勾选仍然赢（合并顺序同上面两条）。
+  "actionRunEnabled",
+  // #497：轻量档不开画像提取——一次调用要读上百行记忆再生成一段画像，与低资源档
+  // 互斥（同 preInjectGate.enabled 的定性）。默认关，这里只是预设再确认一次；
+  // 用户显式勾选仍然赢（合并顺序同 continuityRescueEnabled）。
+  "profileExtractEnabled",
+  // M.O. 自动沉淀：同样挂在 session/event 热路径上，而且解压会话日志是同步 I/O。
+  // 轻量档的取向（小模型 / 小上下文 / 少常驻路径）与它直接冲突，预设里关掉；
+  // 用户显式勾选仍然赢（合并顺序同上面几条）。
+  "actionNudgeEnabled",
+  // 日记本：一次要调模型写一整段散文，且挂 session/event 热路径做跨天判定。
+  // 与低资源档（小模型 / 小上下文 / 少常驻路径）直接冲突，预设里关掉；
+  // 用户显式勾选仍然赢（合并顺序同上面几条）。
+  "diaryEnabled"
+];
+
+/**
+ * Apply the light-mode preset to a resolved config object (pure function,
+ * exported for tests). When cfg.lightMode is not exactly true the config is
+ * returned unchanged; otherwise a shallow copy carries false for every heavy
+ * feature. Idempotent and side-effect free.
+ */
+export function applyLightModePreset(cfg) {
+  if (cfg?.lightMode !== true) return cfg;
+  const preset = { ...cfg, lightMode: true };
+  for (const key of LIGHT_MODE_OFF) {
+    // 点分键（#380 preInjectGate.enabled）：对象子键的预设翻转——浅拷贝父对象后
+    // 改子键，避免直接改到用户 config 里的同一引用。平铺键照旧直赋。
+    const dot = key.indexOf(".");
+    if (dot < 0) {
+      preset[key] = false;
+      continue;
+    }
+    const parent = key.slice(0, dot);
+    preset[parent] = { ...(preset[parent] ?? {}), [key.slice(dot + 1)]: false };
+  }
+  return preset;
+}
+
+/**
+ * #249 第二批：注入形态的父／子开关。父 = `autoInject`（既有的挂载总闸，默认
+ * 开）。子项按 #249 §10 的判据分档——看它是否引入**新的注入时机／新的注入
+ * 表面／额外成本**：
+ *
+ * - 只修正既有每轮块内的位（能力说明）→ 随父开关生效，键的默认值给开；
+ * - 需要新时机或新表面（N2 回合结束提醒、N3 压缩边缘）→ 独立开关、默认关，
+ *   实现时挂到这张表下（今天还没有这两个键，故表里只有能力说明一项）。
+ *
+ * 语义：**父关 = 子项一律不生效，但子项的持久值原样保留**（父关是「不生效」，
+ * 不是「重置用户配置」）。用户显式写进 kv 的值也不因父关被改写。
+ *
+ * 闸门放在消费点而不是合并后的 cfg 上：压 cfg 会让 `/features` 的 effective
+ * 失去「子项自己勾着、父关时当前不生效」这个状态，面板就显示不出来。跨文件
+ * 契约见 test/inject-parent-gate.test.js（含面板侧关系的漂移检查）。
+ *
+ * 表里只放**顶层扁平键**：点号键（如 `memoryQualityFilter.enabled`）在合并后的
+ * cfg 里是嵌套对象，`cfg?.["a.b"]` 取不到，挂进来会恒判不生效且不报错。N2/N3
+ * 是扁平键，不受这条限制。
+ */
+export const INJECT_CHILD_FLAGS = Object.freeze({
+  autoInject: Object.freeze(["injectGuidanceEnabled", "continuityRescueEnabled"])
+});
+
+/** 子开关的运行时生效值：父开关显式关（false）时恒不生效。 */
+export function injectChildEnabled(cfg, key) {
+  for (const [parent, children] of Object.entries(INJECT_CHILD_FLAGS)) {
+    if (children.includes(key) && cfg?.[parent] === false) return false;
+  }
+  return cfg?.[key] === true;
+}