@aiwayds/dsh-topics-memory 0.21.0 → 0.22.0

package/lib/service.d.ts

@@ -38,7 +38,13 @@ export declare class TopicsService {
     private cache;
     /** mtime-keyed parse of the observations log, grouped by session. */
     private echoCache;
-    private usageCache;
+    /** Single shared cache over the two feedback JSONL logs (S2): the key is
+     *  the (mtime,size) quartet of injections.jsonl + opens.jsonl, one read
+     *  and one tail parse feed BOTH aggregates — usageSignalsSync and
+     *  zeroOpenSlugsSync used to each keep a full-parse cache of their own.
+     *  Invalidation stays append-driven: the store only ever appends, so any
+     *  write moves mtime+size. Never populated when a read failed (N1). */
+    private logSignalsCache;
     readonly store: BundleStore;
     private readonly getConfig;
     readonly sync?: Sync;
@@ -63,10 +69,38 @@ export declare class TopicsService {
      * Usage signals (ADR 0015): mtime-cached aggregate over the injection log
      * and the opens log, rolling USAGE_WINDOW_DAYS. Synchronous like
      * echoSlugsSync — the retrieval hot path is sync — and cheap when warm:
-     * a fresh cache costs two stat() calls. Unreadable logs fail open to an
+     * a fresh cache costs two stat() calls, one read of each log, and feeds
+     * the zero-open set from the same parse. Unreadable logs fail open to an
      * empty map (no boost), never an error.
      */
     usageSignalsSync(): Map<string, UsageSignal>;
+    /**
+     * Zero-open slug set for the decay (v5): the shared aggregateZeroOpen
+     * rule over the injection tail and the whole opens log (compacted, so a
+     * full read stays small). Shares one cache and one parse with
+     * usageSignalsSync; unreadable logs fail open to an empty set (no
+     * decay), never an error. Only called when zeroOpenDecay is on.
+     */
+    zeroOpenSlugsSync(): ReadonlySet<string>;
+    /**
+     * The one shared feedback-log read behind both signals: stat both files
+     * (mtime+size quartet key), parse the injections TAIL only
+     * (ZERO_OPEN_TAIL rounds comfortably cover both 30-day windows) and the
+     * opens log whole (the zero-open rule is whole-history), then feed the
+     * two pure aggregates from that single parse. A failed read still fails
+     * open to empty inputs but NEVER populates the cache (N1) — otherwise a
+     * stat-success/read-failure race would freeze an empty snapshot until
+     * the next append.
+     */
+    private logSignalsSync;
+    /**
+     * zeroOpenDecay fields for scoring calls: empty when the gate is off —
+     * no file reads, zero behavior change — and the shared mtime-cached set
+     * when on. Spread into every searchTopics/scoreTopic cfg that already
+     * carries the usage signals (injection paths + explicit topic_search;
+     * the slow lane's recall band stays untouched, mirroring usageBoost).
+     */
+    private zeroOpenCfg;
     /**
      * Full retrieval round: search → assemble → log (ADR 0006/0007). The
      * injection record is written even for zero-hit rounds — the hit-rate
@@ -124,6 +158,13 @@ export declare class TopicsService {
         openQuestions?: string[];
         recommendations?: string;
     }>;
+    /**
+     * Resolve the open's source attribution: the injections tail (bounded by
+     * OPEN_ATTRIBUTION_TAIL) scanned for a same-session hit within the
+     * attribution window. Read failures degrade to 'search' — attribution is
+     * telemetry, never a blocker.
+     */
+    private attributeOpen;
     /** Sync roster read (same mtime cache as roster()). */
     rosterSync(): RetrievableTopic[];
     private readDocSync;

package/lib/service.js

@@ -11,13 +11,51 @@ import { join } from 'node:path';
 import * as okf from "./okf.js";
 import { searchTopics, scoreTopic, passesGate, tokenize } from "./retrieval.js";
 import { assembleInjection, assemblePointer, POINTER_PER_TOPIC, POINTER_TOTAL } from "./digest.js";
-import { aggregateStats, querySample, aggregateUsage, USAGE_WINDOW_DAYS } from "./ilog.js";
+import { aggregateStats, querySample, aggregateUsage, aggregateZeroOpen, ZERO_OPEN_TAIL, USAGE_WINDOW_DAYS, attributeOpen, OPEN_ATTRIBUTION_TAIL } from "./ilog.js";
 import { fileHistory, fileAtRev } from "./git.js";
+/** Tolerant JSONL line read: undefined = unreadable file. Unlike an empty
+ *  array, undefined tells the caller to fail open AND skip caching — a
+ *  successful stat paired with a failed read must not freeze an empty
+ *  snapshot into the cache until the next append. */
+function readLogLinesSync(file) {
+    try {
+        return readFileSync(file, 'utf8').split('\n');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Parse already-split lines back-to-front, keeping the last `tail` parsed
+ *  records in order: blanks and torn JSON lines are skipped (and never
+ *  consume tail budget), so a torn tail line cannot crowd out a good one.
+ *  Shared by the usage/zero-open cache — one tail parse feeds both. */
+function parseJsonlLinesSync(lines, tail = Number.POSITIVE_INFINITY) {
+    const out = [];
+    for (let i = lines.length - 1; i >= 0 && out.length < tail; i -= 1) {
+        const line = lines[i];
+        if (line.trim() === '')
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            continue; // torn tail line
+        }
+    }
+    out.reverse();
+    return out;
+}
 export class TopicsService {
     cache = new Map();
     /** mtime-keyed parse of the observations log, grouped by session. */
     echoCache;
-    usageCache;
+    /** Single shared cache over the two feedback JSONL logs (S2): the key is
+     *  the (mtime,size) quartet of injections.jsonl + opens.jsonl, one read
+     *  and one tail parse feed BOTH aggregates — usageSignalsSync and
+     *  zeroOpenSlugsSync used to each keep a full-parse cache of their own.
+     *  Invalidation stays append-driven: the store only ever appends, so any
+     *  write moves mtime+size. Never populated when a read failed (N1). */
+    logSignalsCache;
     store;
     getConfig;
     sync;
@@ -92,7 +130,7 @@ export class TopicsService {
     invalidate() {
         this.cache.clear();
         this.echoCache = undefined;
-        this.usageCache = undefined;
+        this.logSignalsCache = undefined;
     }
     /**
      * Slugs distilled from THIS session's own turns — the echo set (2026-09
@@ -151,10 +189,34 @@ export class TopicsService {
      * Usage signals (ADR 0015): mtime-cached aggregate over the injection log
      * and the opens log, rolling USAGE_WINDOW_DAYS. Synchronous like
      * echoSlugsSync — the retrieval hot path is sync — and cheap when warm:
-     * a fresh cache costs two stat() calls. Unreadable logs fail open to an
+     * a fresh cache costs two stat() calls, one read of each log, and feeds
+     * the zero-open set from the same parse. Unreadable logs fail open to an
      * empty map (no boost), never an error.
      */
     usageSignalsSync() {
+        return this.logSignalsSync().signals;
+    }
+    /**
+     * Zero-open slug set for the decay (v5): the shared aggregateZeroOpen
+     * rule over the injection tail and the whole opens log (compacted, so a
+     * full read stays small). Shares one cache and one parse with
+     * usageSignalsSync; unreadable logs fail open to an empty set (no
+     * decay), never an error. Only called when zeroOpenDecay is on.
+     */
+    zeroOpenSlugsSync() {
+        return this.logSignalsSync().zeroOpenSlugs;
+    }
+    /**
+     * The one shared feedback-log read behind both signals: stat both files
+     * (mtime+size quartet key), parse the injections TAIL only
+     * (ZERO_OPEN_TAIL rounds comfortably cover both 30-day windows) and the
+     * opens log whole (the zero-open rule is whole-history), then feed the
+     * two pure aggregates from that single parse. A failed read still fails
+     * open to empty inputs but NEVER populates the cache (N1) — otherwise a
+     * stat-success/read-failure race would freeze an empty snapshot until
+     * the next append.
+     */
+    logSignalsSync() {
         const injFile = join(this.store.metaDir(), 'injections.jsonl');
         const opensFile = join(this.store.metaDir(), 'opens.jsonl');
         const statOf = (file) => {
@@ -168,42 +230,44 @@ export class TopicsService {
         };
         const injSt = statOf(injFile);
         const opensSt = statOf(opensFile);
-        const cached = this.usageCache;
+        const cached = this.logSignalsCache;
         if (cached !== undefined &&
             cached.injMs === injSt.mtimeMs &&
             cached.injSize === injSt.size &&
             cached.opensMs === opensSt.mtimeMs &&
             cached.opensSize === opensSt.size) {
-            return cached.signals;
+            return cached;
         }
-        const parseLines = (file) => {
-            const out = [];
-            try {
-                for (const line of readFileSync(file, 'utf8').split('\n')) {
-                    if (line.trim() === '')
-                        continue;
-                    try {
-                        out.push(JSON.parse(line));
-                    }
-                    catch {
-                        continue; // torn tail line
-                    }
-                }
-            }
-            catch {
-                // unreadable log: contribute nothing
-            }
-            return out;
-        };
-        const signals = aggregateUsage(parseLines(injFile), parseLines(opensFile), USAGE_WINDOW_DAYS, Date.now());
-        this.usageCache = {
-            injMs: injSt.mtimeMs,
-            injSize: injSt.size,
-            opensMs: opensSt.mtimeMs,
-            opensSize: opensSt.size,
-            signals,
-        };
-        return signals;
+        const injLines = readLogLinesSync(injFile);
+        const opensLines = readLogLinesSync(opensFile);
+        const injections = parseJsonlLinesSync(injLines ?? [], ZERO_OPEN_TAIL);
+        const opens = parseJsonlLinesSync(opensLines ?? []);
+        const now = Date.now();
+        const signals = aggregateUsage(injections, opens, USAGE_WINDOW_DAYS, now);
+        const zeroOpenSlugs = new Set(aggregateZeroOpen(injections, opens, now).keys());
+        if (injLines !== undefined && opensLines !== undefined) {
+            this.logSignalsCache = {
+                injMs: injSt.mtimeMs,
+                injSize: injSt.size,
+                opensMs: opensSt.mtimeMs,
+                opensSize: opensSt.size,
+                signals,
+                zeroOpenSlugs,
+            };
+        }
+        return { signals, zeroOpenSlugs };
+    }
+    /**
+     * zeroOpenDecay fields for scoring calls: empty when the gate is off —
+     * no file reads, zero behavior change — and the shared mtime-cached set
+     * when on. Spread into every searchTopics/scoreTopic cfg that already
+     * carries the usage signals (injection paths + explicit topic_search;
+     * the slow lane's recall band stays untouched, mirroring usageBoost).
+     */
+    zeroOpenCfg() {
+        if (this.cfg.zeroOpenDecay !== true)
+            return {};
+        return { zeroOpenDecay: true, zeroOpenSlugs: this.zeroOpenSlugsSync() };
     }
     /**
      * Full retrieval round: search → assemble → log (ADR 0006/0007). The
@@ -230,6 +294,7 @@ export class TopicsService {
             conflicts,
             usageBoost: cfg.usageBoost,
             usage: this.usageSignalsSync(),
+            ...this.zeroOpenCfg(),
         });
         const bySlug = new Map(roster.map((r) => [r.slug, r]));
         const entries = [];
@@ -334,6 +399,7 @@ export class TopicsService {
             conflicts,
             usageBoost: cfg.usageBoost,
             usage: this.usageSignalsSync(),
+            ...this.zeroOpenCfg(),
         });
         const exclude = dedup?.exclude;
         const echo = dedup?.echo;
@@ -397,6 +463,7 @@ export class TopicsService {
                     structuralGate: true,
                     usageBoost: cfg.usageBoost,
                     usage: this.usageSignalsSync(),
+                    ...this.zeroOpenCfg(),
                 });
                 shadow.push({
                     slug: item.slug,
@@ -501,9 +568,14 @@ export class TopicsService {
         if (doc === undefined)
             return { found: false, slug };
         // Awaited (tool path, not hot): a settled write makes the pointer-open
-        // stat reliable; a failed log write must not fail the tool.
+        // stat reliable; a failed log write must not fail the tool. Source
+        // attribution rides the same write: a cheap injections-tail scan decides
+        // pointer vs search and, for pointers, carries the hit score and the
+        // open→injection lag (ilog.attributeOpen).
+        const at = new Date().toISOString();
+        const attribution = await this.attributeOpen(slug, sessionId, Date.parse(at));
         await this.store
-            .appendOpenRecord({ slug, at: new Date().toISOString(), ...(sessionId !== undefined ? { sessionId } : {}) })
+            .appendOpenRecord({ slug, at, ...(sessionId !== undefined ? { sessionId } : {}), ...attribution })
             .catch(() => undefined);
         // Optional fields are OMITTED, never present-as-undefined: the host's
         // tool-output validation rejects any object carrying an undefined-valued
@@ -523,6 +595,18 @@ export class TopicsService {
             found.description = doc.fm.description;
         return found;
     }
+    /**
+     * Resolve the open's source attribution: the injections tail (bounded by
+     * OPEN_ATTRIBUTION_TAIL) scanned for a same-session hit within the
+     * attribution window. Read failures degrade to 'search' — attribution is
+     * telemetry, never a blocker.
+     */
+    async attributeOpen(slug, sessionId, nowMs) {
+        if (sessionId === undefined)
+            return { source: 'search' };
+        const tail = await this.store.readInjectionRecords(OPEN_ATTRIBUTION_TAIL).catch(() => []);
+        return attributeOpen(tail, slug, sessionId, nowMs);
+    }
     /** Sync roster read (same mtime cache as roster()). */
     rosterSync() {
         let files;
@@ -656,6 +740,7 @@ export class TopicsService {
             conflicts: await this.store.getConflicts(),
             usageBoost: cfg.usageBoost,
             usage: this.usageSignalsSync(),
+            ...this.zeroOpenCfg(),
         });
     }
     async history(slug, limit = 20) {

package/lib/store.d.ts

@@ -9,7 +9,7 @@
  * @module store
  */
 import * as okf from './okf.ts';
-import type { InjectionRecord } from './ilog.ts';
+import type { InjectionRecord, OpenRecord } from './ilog.ts';
 export interface TopicMeta {
     slug: string;
     title: string;
@@ -171,18 +171,12 @@ export declare class BundleStore {
     private compactInjectionsIfNeeded;
     readInjectionRecords(limit?: number): Promise<InjectionRecord[]>;
     private opensPath;
-    appendOpenRecord(record: {
-        slug: string;
-        at: string;
-        sessionId?: string;
-    }): Promise<void>;
+    appendOpenRecord(record: OpenRecord): Promise<void>;
     private compactOpensIfNeeded;
-    /** Opens in the recent window; tolerant of a torn tail like the other JSONLs. */
-    readOpenRecords(limit?: number): Promise<{
-        slug: string;
-        at: string;
-        sessionId?: string;
-    }[]>;
+    /** Opens in the recent window; tolerant of a torn tail like the other JSONLs.
+     *  Enrichment fields (sessionId/source/score/sinceInjectionMs) are optional:
+     *  pre-enrichment lines carry only slug/at and read back without them. */
+    readOpenRecords(limit?: number): Promise<OpenRecord[]>;
     getConflicts(): Promise<Set<string>>;
     /** Sync variant for the injection hot path. */
     getConflictsSync(): Set<string>;

package/lib/store.js

@@ -544,7 +544,8 @@ export class BundleStore {
     }
     // ------------------------------------------------------------------
     // Pointer-open log (v4 §4.3) — one line per topic_open call; feeds the
-    // 「指针打开率」 stat. Features only (slug/time), never conversation text.
+    // 「指针打开率」 stat. Features only (slug/time + attribution), never
+    // conversation text.
     // ------------------------------------------------------------------
     opensPath() {
         return join(this.metaDir(), 'opens.jsonl');
@@ -568,7 +569,9 @@ export class BundleStore {
         const lines = (await readFile(file, 'utf8')).split('\n').filter((l) => l.trim() !== '');
         await atomicWrite(file, lines.slice(-Math.max(1, Math.floor(lines.length / 4))).map((l) => `${l}\n`).join(''));
     }
-    /** Opens in the recent window; tolerant of a torn tail like the other JSONLs. */
+    /** Opens in the recent window; tolerant of a torn tail like the other JSONLs.
+     *  Enrichment fields (sessionId/source/score/sinceInjectionMs) are optional:
+     *  pre-enrichment lines carry only slug/at and read back without them. */
     async readOpenRecords(limit = 2000) {
         let raw;
         try {
@@ -587,6 +590,12 @@ export class BundleStore {
                     const rec = { slug: parsed.slug, at: parsed.at };
                     if (typeof parsed.sessionId === 'string')
                         rec.sessionId = parsed.sessionId;
+                    if (parsed.source === 'pointer' || parsed.source === 'search')
+                        rec.source = parsed.source;
+                    if (typeof parsed.score === 'number')
+                        rec.score = parsed.score;
+                    if (typeof parsed.sinceInjectionMs === 'number')
+                        rec.sinceInjectionMs = parsed.sinceInjectionMs;
                     out.push(rec);
                 }
             }

package/lib/tools.js

@@ -108,8 +108,12 @@ export function buildTopicTools(service) {
                 },
             ],
         },
-        async execute(args) {
-            return await service.openTopic(args.slug);
+        async execute(args, exec) {
+            // The agent handle on the run context IS the session (Agent.id is the
+            // session id — the same key the injection records use). Absent in
+            // bare test/host contexts: attribution then degrades to 'search'.
+            const sessionId = exec?.agent !== undefined ? String(exec.agent.id) : undefined;
+            return await service.openTopic(args.slug, sessionId);
         },
     });
     const topicSearch = defineTool({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "dsh-plugin: quality-first topic memory for dsh — a topic keeps the starting question, conclusion, impact and dependencies, not the process; local-first git-traced OKF bundle, budgeted LLM-free injection",
   "type": "module",
   "main": "lib/index.js",
@@ -42,7 +42,7 @@
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
     "pretest": "tsc -p tsconfig.json",
-    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs test/legacy-import.test.mjs test/jev-config.test.mjs test/jev-gate.test.mjs test/jev-client.test.mjs test/jev-log.test.mjs test/jev-dual.test.mjs test/jev-fastgate.test.mjs",
+    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs test/legacy-import.test.mjs test/jev-config.test.mjs test/jev-gate.test.mjs test/jev-client.test.mjs test/jev-log.test.mjs test/jev-dual.test.mjs test/jev-fastgate.test.mjs test/zero-open-decay.test.mjs",
     "smoke": "node scripts/smoke-boot.mjs"
   },
   "dependencies": {},

package/src/commands.ts

@@ -17,7 +17,7 @@ import { serializeTopicDoc, slugify, firstParagraph } from './okf.ts'
 import { buildGraph, renderGraphHtml } from './viz.ts'
 import { CONFIG_KEYS, displayKey, type ConfigKey, type TopicsConfigValue, parseConfigValue } from './config.ts'
 import { reloadSecrets } from './jev/gate.ts'
-import { aggregateStats } from './ilog.ts'
+import { aggregateStats, aggregateOpenPanel, ZERO_OPEN_MIN_INJECTIONS } from './ilog.ts'
 import {
   askDistillSingle,
   createOnboardHandler,
@@ -52,7 +52,7 @@ export const HELP = [
   '  /topics status              bundle 健康：topic 数、观察积压、冲突、同步状态',
   '  /topics distill             手动触发一次蒸馏（观察池 → Topic，输出 marked/created/updated/gc 摘要）',
   '  /topics consolidate         手动触发一次整理（合并重复/晋升 stable/废弃过时/刷新元数据，无视 cadence 立即跑）',
-  '  /topics stats               注入统计：hit rate、top-N、near-miss 分布与调参建议',
+  '  /topics stats               注入统计：hit rate、open rate、注入 vs 打开、near-miss 分布与调参建议',
   '  /topics list                列出全部 Topic',
   '  /topics show <slug>         查看一个 Topic 全文（含反向引用）',
   '  /topics history <slug>      一个 Topic 的结论变更史（git log）',
@@ -285,7 +285,7 @@ async function doDistill(service: TopicsService, invocation: CommandInvocation,
 
 async function renderStats(service: TopicsService): Promise<string> {
   const records = await service.store.readInjectionRecords()
-  const stats = aggregateStats(records as never)
+  const stats = aggregateStats(records)
   if (records.length === 0) return '还没有注入记录 —— 用起来之后这里会有 hit rate / top-N / near-miss 分布。'
   const lines = [
     `注入统计（最近 ${records.length} 轮）：`,
@@ -310,20 +310,14 @@ async function renderStats(service: TopicsService): Promise<string> {
     }
     lines.push(`| 慢道参与轮 | ${slowRounds}（快 ${records.length - slowRounds} / 慢或混合 ${slowRounds}${medianLag}） |`)
   }
-  // Pointer open rate (v4 §4.3): topic_open calls vs pointer entries injected.
-  // Echoed hits ride the retrieval but never became pointers — excluded here.
+  // Injection-vs-open metrics (v5): the denominator counts only pointers
+  // that truly rendered (deduped/echoed/dropped all excluded, slow pointers
+  // included) and the numerator only counts DISTINCT slugs from that
+  // rendered set opened inside the injection window — search opens and
+  // never-rendered slugs cannot inflate the rate.
   const opens = await service.store.readOpenRecords()
-  if (opens.length > 0 || records.some((r) => r.lane !== undefined)) {
-    const entries = records.reduce(
-      (acc, r) =>
-        acc +
-        r.hits.filter((h) => !(r.deduped ?? []).includes(h.slug) && !(r.echoed ?? []).includes(h.slug)).length +
-        (r.slow?.length ?? 0),
-      0,
-    )
-    const rate = entries === 0 ? 0 : Math.min(1, opens.length / entries)
-    lines.push(`| 指针打开率 | ${(rate * 100).toFixed(1)}%（${opens.length} 次 topic_open / ${entries} 条注入指针） |`)
-  }
+  const panel = aggregateOpenPanel(records, opens)
+  lines.push(`| open rate | ${(panel.openRate * 100).toFixed(1)}%（${panel.opensInWindow} 个被打开指针 / ${panel.pointerEntries} 条注入指针） |`)
   const echoedCount = records.reduce((acc, r) => acc + (r.echoed?.length ?? 0), 0)
   if (echoedCount > 0) {
     lines.push(`| 回声抑制 | ${echoedCount} 次（本会话蒸馏出的 topic 不回注） |`)
@@ -332,6 +326,31 @@ async function renderStats(service: TopicsService): Promise<string> {
     lines.push('', 'Top-N 被注入 Topic：', '', '| Slug | 注入次数 |', '| --- | --- |')
     for (const t of stats.topTopics.slice(0, 5)) lines.push(`| \`${cell(t.slug)}\` | ${t.count} |`)
   }
+  // ---- 注入 vs 打开 panel ----
+  // Per-topic cut: what the header's windowed rate cannot show — which
+  // topics the model actually bothers to open (wide-scope slug attribution).
+  if (panel.topics.length > 0) {
+    lines.push(
+      '',
+      '注入 vs 打开（Top-10，注入=真正渲染的指针；打开按 slug 归因，全窗口）：',
+      '',
+      '| Topic | 注入 | 打开 | 打开率 |',
+      '| --- | --- | --- | --- |',
+      ...panel.topics.map((t) => `| \`${cell(t.slug)}\` | ${t.injections} | ${t.opens} | ${(t.openRate * 100).toFixed(1)}% |`),
+    )
+  }
+  if (panel.zeroOpenTotal > 0) {
+    const shown = panel.zeroOpen.map((z) => `\`${cell(z.slug)}\``).join('、')
+    const more = panel.zeroOpenTotal > panel.zeroOpen.length ? `（共 ${panel.zeroOpenTotal} 个）` : ''
+    lines.push('', `零打开高频（注入 ≥${ZERO_OPEN_MIN_INJECTIONS}、打开 0）：${shown}${more}`)
+  }
+  lines.push('', panel.hasSourceData ? `打开来源：pointer ${panel.pointerOpens} / search ${panel.searchOpens}` : '打开来源：暂无来源数据（需新版本 open 记录）')
+  if (panel.pointerEntries > 0) {
+    lines.push('', '| 分桶 | 指针 | 打开率 |', '| --- | --- | --- |')
+    for (const b of panel.bands) {
+      lines.push(`| ${b.label} | ${b.pointers} | ${b.pointers === 0 ? '—' : `${(b.openRate * 100).toFixed(1)}%`} |`)
+    }
+  }
   if (stats.nearMissHistogram.length > 0) {
     lines.push(
       '',

package/src/config.ts

@@ -72,6 +72,12 @@ export const TopicsConfig = z.object({
    *  granted to zero-lexical candidates; the structural gate still applies.
    *  0 = off. */
   usageBoost: z.number().default(0.15).volatile(),
+  /** Zero-open decay (v5, default off): halve the retrieval score of slugs
+   *  injected ≥5 times in the rolling 30 days with zero opens ever — the
+   *  零打开高频 leaderboard stops out-ranking topics the model actually
+   *  reads. false = zero behavior change; the reason tag `zero-open-decay`
+   *  rides the hit/near-miss reasons when on. */
+  zeroOpenDecay: z.boolean().default(false).volatile(),
   /** Debounced push delay in GitHub mode. */
   pushDebounceSeconds: z.number().default(45).volatile(),
   /** System One decision-model integration (design 2026-09-25), default-off
@@ -127,6 +133,10 @@ export type TopicsConfigValue = {
   consolidateCadence: string
   deprecatedTtlDays: number
   usageBoost: number
+  /** Zero-open decay (v5). Optional in this TS view only (same sentinel
+   *  pattern as the jev keys): bare-harness DEFAULTS predates it —
+   *  consumers must treat undefined as the documented default (false). */
+  zeroOpenDecay?: boolean
   pushDebounceSeconds: number
   /** System One integration keys (design 2026-09-25 §4). Optional in this TS
    *  view only: index.ts's bare-harness DEFAULTS literal predates them and
@@ -167,6 +177,7 @@ export const CONFIG_KEYS = [
   'consolidateCadence',
   'deprecatedTtlDays',
   'usageBoost',
+  'zeroOpenDecay',
   'pushDebounceSeconds',
   'jevEnabled',
   'jevBackend',
@@ -199,7 +210,8 @@ export function parseConfigValue(key: ConfigKey, raw: string): boolean | number
     case 'autoObserve':
     case 'distillOnSessionEnd':
     case 'includeSubagents':
-    case 'jevEnabled': {
+    case 'jevEnabled':
+    case 'zeroOpenDecay': {
       if (raw === 'on' || raw === 'true') return true
       if (raw === 'off' || raw === 'false') return false
       return { error: `${key} 取值 on|off` }