@nightpainters/dsh-ling 1.6.2 → 1.7.0

package/lib/host/archive.js

@@ -1,6 +1,6 @@
 // dsh-ling host — 改动前的归档落盘(Part G · G2,2026-09-25)
 //
-// **原则(尝生定):永远不做彻底删除。**
+// **原则(用户定):永远不做彻底删除。**
 // 任何"清除/覆盖"类的操作,动手之前先把原数据**完整写到磁盘上的历史目录**,并附一份
 // 人可读的改动日志 —— 谁、什么时候、为什么、以及怎么还原。
 //
@@ -106,7 +106,7 @@ export function archiveBefore(memory, { source, convId, kind = 'forget', reason
 /** 改动日志 —— 这份文件是给**将来的人**看的,所以写全:是什么、为什么、怎么还原。 */
 function readme({ at, s, c, kind, reason, actor, turns }) {
   const who = actor === 'ling' ? '鱼姬(工具通道)' : '主人(界面通道)';
-  // A-01(1.5.1):第三种 kind —— 主脉记忆覆盖(同一主脉再次采纳提炼结果;尝生裁决"备份并覆盖")。
+  // A-01(1.5.1):第三种 kind —— 主脉记忆覆盖(同一主脉再次采纳提炼结果;用户裁决"备份并覆盖")。
   const what = kind === 'forget' ? '遗忘(软标记 —— **库里的行没有删**)'
     : kind === 'vein-overwrite' ? '主脉记忆**覆盖**(同一主脉再次采纳 —— **上一版正文完整存在这里**)'
     : '回灌(用归档恢复一条记忆 —— **覆盖前的状态已存这里**)';
@@ -150,7 +150,7 @@ ${restoreBlock}
 
 ## 为什么保留
 
-忘错了要能回头。这是尝生定的规矩:**永远不做彻底删除** ——
+忘错了要能回头。这是用户定的规矩:**永远不做彻底删除** ——
 所以这个目录是"曾经发生过什么"的证据,不是垃圾。不要随手清。
 
 > 生成于 dsh-ling · Part G(器灵侧正规通道)

package/lib/host/autotree.js

@@ -1,4 +1,4 @@
-// dsh-ling host — 一键生成记忆树(D9-b,2026-09-20 与尝生定案)。
+// dsh-ling host — 一键生成记忆树(D9-b,2026-09-20 与用户定案)。
 //
 // 主干 1593 条太粗,需要先把树"初步划一遍"。分两阶段:
 //   ① 机械分段  —— 按时序相邻性把全库概述切成若干簇(零成本、确定、可复现);
@@ -6,7 +6,7 @@
 //   ③ 主人审核后落库(apply 在 api.js 侧) —— 建枝/主脉 + 挂会话。
 //
 // 为什么不把 1593 条直接丢给模型:装不进上下文,而且"按时序切段"本就是机械活。
-// 模型擅长的是"给一段对话起主题名",不是"在 1593 条里做聚类"(设计稿 §8 / 尝生 2026-09-20)。
+// 模型擅长的是"给一段对话起主题名",不是"在 1593 条里做聚类"(设计稿 §8 / 用户 2026-09-20)。
 //
 // 不变量:本模块**只读概述索引**、只产出候选,**从不改写任何记忆内容**。
 

package/lib/host/clock-skill.js

@@ -1,4 +1,4 @@
-// dsh-ling host — clock skill:精确时间按需查询(2026-09-23 尝生定)。
+// dsh-ling host — clock skill:精确时间按需查询(2026-09-23 用户定)。
 //
 // 为什么做成 skill 而不常驻注入:
 // 时间锚搬迁之后(见内部时间锚设计笔记),system 侧只留 [今天](日期+星期,一天变一次),

package/lib/host/config.js

@@ -0,0 +1,38 @@
+import Schema from '@deepseek-ai/schemastery';
+import { DEFAULT_LIBRARY_LIMITS } from './library-store.js';
+import { normalizeLibraryConfig } from './library-runtime.js';
+
+const libraryFields = Schema.object({
+  enabled: Schema.boolean().default(true).description('启用独立图书馆;不迁移记忆、不参与开场注入。'),
+  codeRoots: Schema.array(Schema.string()).default([]).description('管理员登记的绝对代码根目录。'),
+  officialUrls: Schema.array(Schema.string()).default([]).description('管理员登记的精确 HTTPS 文档 URL。'),
+  limits: Schema.object(Object.fromEntries(Object.entries(DEFAULT_LIBRARY_LIMITS)
+    .map(([key, value]) => [key, Schema.number().default(value)]))),
+  // F10(1.7 修复批次):图书馆配置校验失败的原因。非空 ⇒ **图书馆整块**不可用,记忆/人格/工具照常。
+  // 它是"响亮"的载体:理由词给上层,出错的键名给用户。
+  configError: Schema.string().default('').description('图书馆配置校验失败的原因(非空 ⇒ 图书馆整块不可用,其余功能照常)'),
+});
+const fields = Schema.object({ library: libraryFields });
+
+// Validate raw keys before Schemastery fills defaults or adapts values. Its
+// object resolver otherwise preserves unknown keys, including library hooks.
+// Existing non-library settings keep their established configuration semantics.
+export const Config = Schema.transform(Schema.any().default({}), (raw) => {
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+    throw new TypeError('dsh-ling 配置必须是对象');
+  }
+  // F10(1.7 修复批次):以前 `normalizeLibraryConfig` 抛在这里 ⇒ 异常一路冒到 `apply()` ⇒
+  //   **记忆 / 人格 / 全部 11 件工具一起不加载**,而且没有任何可指认面;而 `lib/index.js` 对
+  //   "库打不开"却是有界重试 + 降级 + 排查指引 ⇒ 两种口径自相矛盾。
+  //   修法:**不吞、不静默** —— 原因带进 config(含出错的键名,可执行),图书馆进不可用态,
+  //   插件其余部分照常加载。**绝不**拿半套配置去开库(那会把"配置写错"变成看不懂的运行期怪象)。
+  let library = null;
+  let libraryConfigError = '';
+  try {
+    library = normalizeLibraryConfig(raw.library);
+  } catch (error) {
+    libraryConfigError = String(error?.message ?? error).slice(0, 300);
+    library = normalizeLibraryConfig({});   // 结构仍是合法形状(默认:enabled=true、空白名单)
+  }
+  return fields({ ...raw, library: { ...library, configError: libraryConfigError } });
+}, true).default({});

package/lib/host/deepsummary.js

@@ -8,6 +8,10 @@ import { RAW_IMPORT_PREFIX, rawSessionCandidates } from './memory.js';
 import { pickSessionFile } from './backfill.js';
 import { currentModelSelection } from './mode.js';
 import { decodeAll } from './zstd.js';
+// 「后台自动行为」的默认值真源(persona.DEFAULT_SETTINGS.auto)与区间真源(guard.AUTO_NUMBER_RANGES)
+// 都各有唯一一处 —— 本模块只**取来用**,不另抄一份数字(抄一份 = 下次改默认必然漏改一处)。
+import { DEFAULT_SETTINGS } from './persona.js';
+import { AUTO_NUMBER_RANGES } from './guard.js';
 
 // 循环外调用(深摘要 / 诞生仪式 / 语气归纳 / 自述起草)一律**跟随用户当前的模型选择**:
 // 平台 API 要求显式给出 {provider, model},故读 agentDefaultModel.currentSelection();
@@ -23,10 +27,79 @@ export const DEEP_CFG = {
   temperature: 0.2,
   inputCap: 26000,
   diskMinBytes: 64 * 1024,
-  autoIntervalMin: 30,
-  perRunLimit: 2,
+  autoIntervalMin: 30,   // 旧默认值;1.7 起"自动间隔"的真源是 DEFAULT_SETTINGS.auto.deepIntervalMin(同值,见 resolveAuto)
+  perRunLimit: 2,        // 仍是 deepCandidates 自己的默认每轮上限;启动块已改走 resolveAuto
 };
 
+/**
+ * 读出**用户真的写过**的 auto 子树(settings.json 只持久化用户补丁,见 settings-file.js 文件头)。
+ *
+ * 为什么不能用 `settings.get().auto` 判优先级:`get()` 把 DEFAULT_SETTINGS 深合并了进来
+ * ⇒ 那五个键**永远存在**,于是"代码默认值"会冒充"用户设定":插件配置里的旧键
+ * (`feedbackAuto` / `deepSummaryAuto` / `deepIntervalMin` / `deepMaxPerRun`)被永久压掉
+ * (老用户升级上来行为就变了),面板的 `source` 也会永远显示 settings。
+ * 入参两种都收:SettingsFile 实例(读 `.user.auto` —— 真实运行时)或普通设置对象(退回 `.auto`,测试桩用);
+ * **「有 .user 但没写 auto」与「没有 .user」必须分开**:前者 = 用户什么都没写 ⇒ `{}`,后者才回退到 `.auto`。
+ */
+export function storedAuto(settingsLike) {
+  const s = (settingsLike && typeof settingsLike === 'object') ? settingsLike : {};
+  const hasUser = (s.user && typeof s.user === 'object' && !Array.isArray(s.user)) ? s.user : null;
+  const cand = hasUser ? hasUser.auto : s.auto;
+  return (cand && typeof cand === 'object' && !Array.isArray(cand)) ? cand : {};
+}
+
+/**
+ * 「后台自动行为」的**唯一解析处**(2026-10-16 与用户定):settings.auto > 插件配置旧键 > 代码默认。
+ *
+ * 为什么要收成一支:三级优先级原先散在 `index.js` 的启动块里(且探活延时是裸的 12000、根本没有配置键),
+ * 而设置面板必须能如实显示"这个值是谁定的" —— 两处各判一次,迟早会漂成两个答案。
+ *
+ * 默认值**只从 `DEFAULT_SETTINGS.auto` 取**(不在这里另抄一份数字);区间只从 `AUTO_NUMBER_RANGES` 取。
+ * cfg 一侧刻意保留旧代码的 `Number(...)` 口径:插件配置里写 `'60'` 这种字符串,旧实现是生效的,
+ * 这里不能因为"更严格"就把它变成没设过(那才是行为变了)。
+ *
+ * @param {object} settings SettingsFile 实例(读用户补丁)或普通设置对象;见 storedAuto
+ * @param {object} [cfg] 插件配置(旧键名:`deepSummaryAuto` / `deepIntervalMin` / `deepMaxPerRun` / `feedbackAuto`)
+ * @returns {{deepSummary: boolean, deepIntervalMin: number, deepMaxPerRun: number,
+ *   bootProbeDelayMs: number, feedbackAuto: boolean,
+ *   source: Record<string, 'settings'|'config'|'default'>}}
+ */
+export function resolveAuto(settings, cfg = {}) {
+  const sAuto = storedAuto(settings);
+  const c = (cfg && typeof cfg === 'object' && !Array.isArray(cfg)) ? cfg : {};
+  const D = DEFAULT_SETTINGS.auto;
+  const source = {};
+  /** 布尔:settings 里必须是**真布尔**才算命中(字符串 "false" 不算设过 —— 与写面同一把尺)。 */
+  const boolOf = (key, cfgKey, def) => {
+    if (typeof sAuto[key] === 'boolean') { source[key] = 'settings'; return sAuto[key]; }
+    if (cfgKey && typeof c[cfgKey] === 'boolean') { source[key] = 'config'; return c[cfgKey]; }
+    source[key] = 'default'; return def;
+  };
+  /** 数字:settings 收有限数;cfg 沿用 `?? + Number()` 的旧口径(只有 undefined/null 算"没写");
+   *  非有限数(如 'abc')落到默认 —— 旧实现会把它变成 NaN(interval 变 0 = 空转),那不是要保留的行为。 */
+  const numOf = (key, cfgKey, def) => {
+    const [lo, hi] = AUTO_NUMBER_RANGES[key];
+    let raw;
+    if (typeof sAuto[key] === 'number' && Number.isFinite(sAuto[key])) { raw = sAuto[key]; source[key] = 'settings'; }
+    else {
+      const has = cfgKey !== undefined && cfgKey !== null && c[cfgKey] !== undefined && c[cfgKey] !== null;
+      const cv = has ? Number(c[cfgKey]) : NaN;
+      if (has && Number.isFinite(cv)) { raw = cv; source[key] = 'config'; }
+      else { raw = def; source[key] = 'default'; }
+    }
+    return Math.min(hi, Math.max(lo, raw));
+  };
+  return {
+    // 探活延时**没有**旧配置键(此前硬编码 12000)⇒ 它只可能来自 settings 或默认。
+    deepSummary: boolOf('deepSummary', 'deepSummaryAuto', D.deepSummary),
+    deepIntervalMin: numOf('deepIntervalMin', 'deepIntervalMin', D.deepIntervalMin),
+    deepMaxPerRun: numOf('deepMaxPerRun', 'deepMaxPerRun', D.deepMaxPerRun),
+    bootProbeDelayMs: numOf('bootProbeDelayMs', null, D.bootProbeDelayMs),
+    feedbackAuto: boolOf('feedbackAuto', 'feedbackAuto', D.feedbackAuto),
+    source,
+  };
+}
+
 /** 解析循环外调用使用的模型:跟随当前选择;不可读则用兜底值并留一行 debug。 */
 export function resolveLlmTarget(ctx) {
   const cur = typeof currentModelSelection === 'function' ? currentModelSelection(ctx) : null;

package/lib/host/dsweb-summary.js

@@ -137,7 +137,7 @@ export async function probeAssistant(baseUrl = ASSISTANT_DEFAULT, { timeoutMs =
  *   · **Ollama 原生 `/api/chat` + `think:false` 有效**:实测 thinking 长度 0、正文正常。
  * 因此默认走原生端点(把 base 末尾的 `/v1` 去掉),`noThink:false` 时才用兼容端点。
  */
-export async function summarizeLocal(baseUrl, model, { system = SUMMARY_SYS, text, maxTokens = MAX_TOKENS_DEFAULT, timeoutMs = 90000, noThink = true } = {}) {
+export async function summarizeLocal(baseUrl, model, { system = SUMMARY_SYS, text, maxTokens = MAX_TOKENS_DEFAULT, timeoutMs = 90000, noThink = true, clean = true } = {}) {
   const t0 = Date.now();
   const base = String(baseUrl).replace(/\/+$/, '');
   const native = base.replace(/\/v1$/, '');
@@ -181,8 +181,11 @@ export async function summarizeLocal(baseUrl, model, { system = SUMMARY_SYS, tex
       completionTokens: noThink ? (j?.eval_count ?? null) : (j?.usage?.completion_tokens ?? null),
       promptTokens: noThink ? (j?.prompt_eval_count ?? null) : (j?.usage?.prompt_tokens ?? null),
     };
-    const summary = cleanSummary(raw);
-    return { ok: !!summary, summary, error: summary ? null : (diag.reasoningLen > 0 ? 'reasoning-only' : 'empty'), ms: Date.now() - t0, diag };
+    // `clean:false`(2026-10-12,给图书馆导入通道的模型段用):**原样交出模型回复**。
+    // 为什么必须有这一档:`cleanSummary` 会把回复压成一行、截到 300 字 —— 对"一句摘要"正好,
+    // 对**要 JSON 的调用方**等于把结构撕碎(它连换行都吃掉)。摘要路径一个字节没变(默认仍是 clean:true)。
+    const summary = clean ? cleanSummary(raw) : String(raw || '').trim();
+    return { ok: clean ? !!summary : summary !== '', summary, raw, error: (clean ? !!summary : summary !== '') ? null : (diag.reasoningLen > 0 ? 'reasoning-only' : 'empty'), ms: Date.now() - t0, diag };
   } catch (e) {
     return { ok: false, error: String(e?.name === 'AbortError' ? 'timeout' : (e?.message ?? e)).slice(0, 120), ms: Date.now() - t0, path: noThink ? 'native' : 'compat' };
   } finally {

package/lib/host/guard.js

@@ -219,3 +219,56 @@ export function sanitizePersonaPatch(patch) {
   }
   return { clean, dropped };
 }
+
+// ── ⑤ 后台行为补丁白名单(2026-10-16)──────────────────────────────────────────────
+// 与 ④ 同一纪律、同一原因:`POST /auto` 也把 body 交给 `settings.update`(深合并,**不做键过滤**)
+// ⇒ 不设白名单就等于给了一条新旁路 —— 拿 `/auto` 往 settings.json 里写 `guard.enforce:false` 或
+// 整棵 persona(④ 那次堵的正是这条链)。故:只有下面 5 个键能出这个函数。
+// 额外收窄(比 ④ 更严):**只收扁平对象**。auto 子树没有嵌套语义,接受嵌套/数组纯粹是给原型污染留门
+// (`{"__proto__":{…}}` 经深合并会落到 Object.prototype 上,那是全进程级污染,不是一个设置项)。
+/** auto 子树里允许经 /auto 写入的键(= DEFAULT_SETTINGS.auto 的全部字段)。 */
+export const AUTO_PATCH_KEYS = Object.freeze([
+  'deepSummary', 'deepIntervalMin', 'deepMaxPerRun', 'bootProbeDelayMs', 'feedbackAuto',
+]);
+/** 布尔键(其余三个是数字键:类型不符一律丢弃,不猜用户想说什么)。 */
+export const AUTO_BOOL_KEYS = Object.freeze(['deepSummary', 'feedbackAuto']);
+/** 数字键的合法区间 [lo, hi]:**唯一定义处** —— sanitizeAutoPatch(写面)与 resolveAuto(读面)同取这一份,
+ *  两处各写一遍迟早会漂成"写得进 5、读出来 10"这种自相矛盾的设置。 */
+export const AUTO_NUMBER_RANGES = Object.freeze({
+  deepIntervalMin: Object.freeze([10, 1440]),
+  deepMaxPerRun: Object.freeze([1, 20]),
+  bootProbeDelayMs: Object.freeze([0, 600000]),
+});
+
+/**
+ * 把一份「后台行为」补丁收窄成"只能落在这 5 个白名单键上"的安全扁平补丁。
+ * @param {unknown} patch 待写入的补丁(通常是 body.patch,也接受 body 本身)
+ * @returns {{ clean: object, dropped: string[], clamped: string[] }} clean = 可交给 settings.update 的补丁;
+ *   dropped = 被丢弃的键(白名单外 / 类型不符 / 整个 body 不是普通对象);
+ *   clamped = 被夹取到区间的键(用于如实回报"你填的值没被原样采纳")
+ */
+export function sanitizeAutoPatch(patch) {
+  const clean = {};
+  const dropped = [];
+  const clamped = [];
+  // 数组与 null 都不是补丁(数组的 Object.entries 会给出 "0"/"1" 这类下标键,没有语义)
+  if (!patch || typeof patch !== 'object' || Array.isArray(patch)) return { clean, dropped, clamped };
+  for (const [k, v] of Object.entries(patch)) {
+    if (!Object.prototype.hasOwnProperty.call(AUTO_NUMBER_RANGES, k)) {
+      // 布尔键:只收真正的布尔;字符串 "false" 不猜(猜错方向 = 悄悄关掉一个后台行为)
+      if (AUTO_BOOL_KEYS.includes(k)) {
+        if (typeof v === 'boolean') clean[k] = v;
+        else dropped.push(k);
+        continue;
+      }
+      dropped.push(k);
+      continue;
+    }
+    if (typeof v !== 'number' || !Number.isFinite(v)) { dropped.push(k); continue; }
+    const [lo, hi] = AUTO_NUMBER_RANGES[k];
+    const c = Math.min(hi, Math.max(lo, v));
+    clean[k] = c;
+    if (c !== v) clamped.push(k);
+  }
+  return { clean, dropped, clamped };
+}

package/lib/host/inject.js

@@ -88,7 +88,7 @@ function advanceLogWatermark(memory, sessionId, maxId, shownMaxId, retiredMaxId,
     if (retired > 0 && retired > Number(memory.kvGet('branch_log_wm.retired') || 0)) {
       memory.kvSet('branch_log_wm.retired', String(retired));
     }
-    // 复盘守门(2026-09-22 尝生:「动记忆树不能是随意的,应该是慎重严肃的」):
+    // 复盘守门(2026-09-22 用户:「动记忆树不能是随意的,应该是慎重严肃的」):
     // 另记一个**全局最后同步**水位,回答"自器灵上次开口以来累积了多少笔改动还没交代"
     // (memory.branchLogPending 读它)。与会话水位互补 —— 会话水位管"这个会话看到什么",
     // 本键管"是否还没跟器灵交代过"。
@@ -96,7 +96,17 @@ function advanceLogWatermark(memory, sessionId, maxId, shownMaxId, retiredMaxId,
   } catch { /* 推进失败仅导致下次重复提示,不影响注入 */ }
 }
 
-export function registerMemorySection(ctx, gate, memory, settings) {
+/** 注册记忆注入段(order 1500)+ 时间锚 context。
+ *
+ *  ── F5(1.7 修复批次,2026-10-15)────────────────────────────────────────────
+ *  第 5 参是**逃生开关**:`cordis.patch.yml:16` 早就承诺 `injectEnabled: false` 能关掉注入,
+ *  但在这次修之前全仓 `cfg.injectEnabled` **零处读** ⇒ 用户以为关掉了、实际照注(静默失效)。
+ *  现在关到底 ⇒ **一段都不注册**(section 与 clock context 都不挂),留痕仍由
+ *  index.js 的 `inject_enabled_config` 负责。默认(true / 不传)行为**逐字不变**。
+ *  ⚠️ 这一道只管**记忆段**;人格段走 `settings.persona.enabled`(persona.js:166),两者并列。
+ *  回归:tests/injectlog.test.mjs 第 5 节(关到底零注册 + 默认行为正对照 + 接线判据)。 */
+export function registerMemorySection(ctx, gate, memory, settings, { enabled = true } = {}) {
+  if (enabled === false) return () => {};
   const sp = svc(ctx, 'systemPrompt');
   if (!sp || typeof sp.section !== 'function') {
     console.debug('[dsh-ling] systemPrompt service unavailable; injection disabled');

package/lib/host/l1.js

@@ -95,7 +95,7 @@ function kwOverlap(queryKeywords, rowKeywords) {
  *  (为"查询 4-gram vs 存储 6-gram 的**关键词表**"设计的),而条目路的右操作数是**条目正文**
  *  (全库均 52 字)。中文常用 3-gram 遍地都是 ⇒ 几乎任何查询都会命中 3 条以上 ⇒ 打满
  *  `KW_BONUS_CAP`(+1.8),把新近(最多 0.3)和 hit(尚为 0)全压死。
- *  实测病灶(尝生 2026-10-04 开新会话看到):开场 8 条**全是同一次生图会话的条目** ——
+ *  实测病灶(用户 2026-10-04 开新会话看到):开场 8 条**全是同一次生图会话的条目** ——
  *  排序实际上等于"谁的字面碰巧撞上查询词"。
  *  长句只做**连续子串**匹配:那个词真出现在那句话里才算命中。 */
 function kwHitInText(queryKeywords, text) {
@@ -154,7 +154,7 @@ const HIT_SATURATION = 5;     // 采用满 5 次即拿满分(与记忆行 freq
 //   新近对**结论层**本就该是弱信号(结论的价值在长期),压到 0.1 后不再主导。
 const RECENCY_W = 0.1;
 const DEEP_HALF_LIFE = 365;   // 半衰期一年(旧的概述行是 90 天)
-/** **硬度分**(1.6,2026-10-04 尝生的判断:「能不能做成从根源上判断这些条目到底是临时的还是永久的,
+/** **硬度分**(1.6,2026-10-04 用户的判断:「能不能做成从根源上判断这些条目到底是临时的还是永久的,
  *  或者加"硬度"评分来衡量临时程度/永久程度」)。
  *  它**同时**用于两处:出局(见 `selectL1` 里 `ephemeral` 的 continue)与**排序**。
  *  只做前者是不够的 —— 上一版就只做了前者,于是"长期原则"和"阶段性结论"在排序里**同权**,
@@ -305,7 +305,7 @@ export function selectL1(store, opts) {
   const now = Date.now();
   const summaryBonus = Number.isFinite(Number(o.summaryBonus)) ? Number(o.summaryBonus) : SUMMARY_BONUS_DEFAULT;
   // 2026-09-21:归档会话不参与召回 —— 归档是主人的明确动作("这条别再提了"),
-  //   而此前 selectL1 直接吃 listOverviews 全量:归档只影响界面,召回照旧(尝生实测反馈)。
+  //   而此前 selectL1 直接吃 listOverviews 全量:归档只影响界面,召回照旧(用户实测反馈)。
   //   只对 source='dsh' 生效:archived 是会话级标记,历史网页端/导入条目没有会话行。
   const archived = (() => {
     try {
@@ -353,7 +353,7 @@ export function selectL1(store, opts) {
   //   真库实测 **393/393 条全为空**(schema 注释早写明"记忆树是空间维度、深层库是内容维度,
   //   条目不隶属任何枝"),照那个字段接等于"接了也没接"。走会话归属才有意义:
   //   dsh 侧实测主干 73 / 开发日志 25 / 运维排障 18 / 日常 4,非 dsh 侧已挂枝 34、未挂枝 179。
-  //   取值:默认 1.0 ⇒ **接线当下零行为变化**(实测全库 20 条枝的 weight_scale 全是 1);
+  //   取值:默认 1.0 ⇒ **接线当下零行为变化**(枝系数没被调过时,一切排序与接线前逐字相同);
   //   复盘期调过谁,谁的记忆才在开场里前后移动 —— 这就是 `README` U-10「装饰性交互要么真生效、
   //   要么删掉」要的那个"真生效"。
   //   ⚠️ 它乘在**最后**一项(`raw × 血缘 × 矛盾 × 枝系数`),与 `LINEAGE_*` 同一层:*打对折*,
@@ -402,7 +402,12 @@ export function selectL1(store, opts) {
       //   而 `MAX_PER_CONV` 压的是症状(临时结论往往扎堆在一次会话里)⇒ 两者并存、分工不同。
       if (String(row.durability || 'long') === 'ephemeral') { excluded.ephemeral += 1; continue; }
       const hit = Number(row.hit_count ?? 0);
-      const kw = kwHitInText(o.keywords || [], row.text);
+      // ⚠️ 2026-10-06:**类目名(kind)也参与关键词命中** —— 修前只匹配 `row.text`,于是查询里的
+      //   类目词打不中它们**自己的**条目:实测搜「纪律」时那 18 条纪律一条都加不上分(`kw` 恒为 0),
+      //   开场里只靠权重挤进 2 席 —— 同族缺陷对"承诺 / 决定 / 关系"一样成立。
+      //   kind 是 2 字精确词、且 `kwHitInText` 只做**连续子串**匹配(不共享 n-gram)
+      //   ⇒ 不会重蹈它上面那段注释里"3-gram 遍地都是、几乎任何查询都打满"的覆辙。
+      const kw = kwHitInText(o.keywords || [], row.text + ' ' + String(row.kind || ''));
       const t = toEpochMs(row.at || row.created_at);
       const recency = decayWeight(t === null ? 0 : Math.max(0, (now - t) / DAY_MS), DEEP_HALF_LIFE);
       // 硬度参与排序(不只是出局):`durable` 抬 0.6,与 `long` 拉开约 7 倍 ⇒ 长期原则/承诺/关系
@@ -439,7 +444,7 @@ export function selectL1(store, opts) {
     .filter((x) => !x.pinned)
     .sort((a, b) => b.score - a.score
       || String(b.row.at || b.row.created_at || '').localeCompare(String(a.row.at || a.row.created_at || '')));
-  // **同源限额**(2026-10-04 尝生实测:「会话内的、临时的结论会被灌入」):
+  // **同源限额**(2026-10-04 用户实测:「会话内的、临时的结论会被灌入」):
   //   同一次会话最多进 `MAX_PER_CONV` 条 —— 否则一次"高产出"的会话能把整个开场占满
   //   (实测某次生图会话有 13 条,开场 8 条里它一家全占)。同源被挡下的**进落选者名单**
   //   (`reason='conv'`),这样"它为什么没进"仍可查,而不是凭空消失。
@@ -471,7 +476,7 @@ export function selectL1(store, opts) {
   const keepPinned = ranked.filter((x) => x.pinned);
   const restRanked = ranked.filter((x) => !x.pinned);
   const restQuota = Math.max(0, max - keepPinned.length);
-  // **事实席位**(尝生 2026-10-04:「8 条也可以考虑改 10 条,其中 2 条作为最硬的事实的席位」)——
+  // **事实席位**(用户 2026-10-04:「8 条也可以考虑改 10 条,其中 2 条作为最硬的事实的席位」)——
   //   动机是他看到的偏斜:承诺/关系优先之后,「我在什么环境里干活」这类**稳定事实**因为类别分为 0
   //   而永远进不来;但它们确实是"接下来要干什么"的前提。⇒ 10 个位置里留 2 个给**最硬的事实**
   //   (`durable` 的「事实」类),既不挤占"关于人"的主体(那 8 个),也不让环境事实缺席。
@@ -634,7 +639,7 @@ const L1_FRAME_CALLNAME_FALLBACK = '主人';
 /**
  * 视角框的称呼 —— **跟随 `persona.userTitle`**,不硬编码。
  *
- * 为什么走配置而不是写死(2026-10-04 尝生的判断:「提早换更合适」):
+ * 为什么走配置而不是写死(2026-10-04 用户的判断:「提早换更合适」):
  *  - `dsh-ling` 是要发 npm 的通用包,**把某个用户的名字写死会污染公开件**;
  *  - `userTitle` 本来就是**主人自己可编辑**的字段(`persona.js`:「空 = 用"你"」),
  *    走它 = 本机显示他设的称呼、别人的实例显示他们自己的,**本机效果不打折**;