@aiwayds/dsh-topics-memory 0.6.0 → 0.8.0

package/lib/service.js

@@ -9,8 +9,8 @@ import { readFile, stat } from 'node:fs/promises';
 import { readdirSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import * as okf from "./okf.js";
-import { searchTopics, tokenize } from "./retrieval.js";
-import { assembleInjection } from "./digest.js";
+import { searchTopics, scoreTopic, passesGate, tokenize } from "./retrieval.js";
+import { assembleInjection, assemblePointer, POINTER_PER_TOPIC, POINTER_TOTAL } from "./digest.js";
 import { aggregateStats, querySample } from "./ilog.js";
 import { fileHistory, fileAtRev } from "./git.js";
 export class TopicsService {
@@ -70,6 +70,7 @@ export class TopicsService {
                 description: doc.fm.description,
                 status: doc.fm.status,
                 tags: doc.fm.tags,
+                triggers: doc.fm.triggers,
                 depends: doc.fm.depends,
                 links: okf.bodyLinkSlugs(doc.body),
                 generatedAt: doc.fm.generated.at,
@@ -116,10 +117,12 @@ export class TopicsService {
             if (doc !== undefined)
                 entries.push({ slug: hit.slug, doc, hit });
         }
-        const injection = assembleInjection(entries, {
-            perTopicBudget: cfg.perTopicBudget,
-            totalBudget: cfg.totalBudget,
-        });
+        const injection = cfg.injectMode !== 'digest'
+            ? assemblePointer(entries, { perTopicBudget: POINTER_PER_TOPIC, totalBudget: Math.min(cfg.totalBudget, POINTER_TOTAL) })
+            : assembleInjection(entries, {
+                perTopicBudget: cfg.perTopicBudget,
+                totalBudget: cfg.totalBudget,
+            });
         const record = {
             at: new Date().toISOString(),
             queryTokenCount: tokenize(query).length,
@@ -146,18 +149,52 @@ export class TopicsService {
      * would always lose the race and inject nothing. Reads files with sync fs
      * behind the mtime cache; the log record is written fire-and-forget.
      *
-     * `dedup.exclude` (session-level injection dedup) filters hits AFTER
-     * retrieval and BEFORE assembly: excluded slugs are reported back as
-     * `deduped` (and logged as `record.deduped`), never packed. `included`
-     * mirrors what actually entered the context — only these may be marked
-     * as injected by the caller; budget-dropped slugs stay injectable later.
+     * `dedup.exclude` (session-level injection dedup) filters hits AND slow
+     * picks before assembly; excluded slugs are reported back as `deduped`
+     * (and logged as `record.deduped`), never packed. `included` mirrors the
+     * fast pointers that entered the context and `slowIncluded` the slow ones
+     * — only these may be marked as injected by the caller; budget-dropped
+     * slugs stay injectable later.
+     *
+     * `slow` (v4 §4.2) carries the consumed pending when one exists: picks are
+     * packed after the fast pointers under the same budget, take log-only
+     * shadow re-gate verdicts against the CURRENT query (B3: record, never
+     * block), and fill the record's lane field family.
      */
-    retrieveSync(query, sessionId, dedup) {
+    retrieveSync(query, sessionId, dedup, slow, slowExpired) {
         const cfg = this.cfg;
         const roster = this.rosterSync();
         const empty = { hits: [], nearMisses: [], rosterSize: roster.length };
         if (!cfg.autoInject || query.trim() === '' || roster.length === 0) {
-            return { text: '', outcome: empty, deduped: [], included: [] };
+            // A consumed/expired pending must always leave an ilog trace (ADR 0014:
+            // 过期/消费都写 ilog) — even when the fast path early-returns here
+            // because the roster vanished between production and consumption.
+            if (cfg.autoInject && query.trim() !== '' && (slow !== undefined || slowExpired !== undefined)) {
+                const trace = {
+                    at: new Date().toISOString(),
+                    queryTokenCount: tokenize(query).length,
+                    querySample: querySample(query),
+                    rosterSize: roster.length,
+                    hits: [],
+                    nearMisses: [],
+                    injected: false,
+                    why: slowExpired !== undefined ? `slow-expired-${slowExpired}` : 'slow-no-roster',
+                    lane: 'slow',
+                };
+                if (sessionId !== undefined)
+                    trace.sessionId = sessionId;
+                if (slowExpired !== undefined)
+                    trace.slowExpired = slowExpired;
+                if (slow !== undefined) {
+                    trace.computedAt = slow.computedAt;
+                    trace.queryBuild = slow.queryBuild;
+                    trace.slowModel = slow.model;
+                    trace.slowMs = slow.ms;
+                    trace.slow = [];
+                }
+                void this.store.appendInjectionRecord(trace).catch(() => undefined);
+            }
+            return { text: '', outcome: empty, deduped: [], included: [], slowIncluded: [] };
         }
         const conflicts = this.store.getConflictsSync();
         const outcome = searchTopics(query, roster, {
@@ -170,25 +207,81 @@ export class TopicsService {
         });
         const exclude = dedup?.exclude;
         const deduped = exclude === undefined ? [] : outcome.hits.filter((h) => exclude.has(h.slug)).map((h) => h.slug);
+        const bySlug = new Map(roster.map((r) => [r.slug, r]));
         const entries = [];
+        const unreadable = [];
         for (const hit of outcome.hits) {
             if (exclude?.has(hit.slug))
                 continue;
             const doc = this.readDocSync(hit.slug);
-            if (doc !== undefined)
-                entries.push({ slug: hit.slug, doc, hit });
+            if (doc === undefined) {
+                // The hit has no readable doc — without this accounting it used to
+                // vanish from `included` AND `dropped` (v4 design §2 疑点).
+                unreadable.push(hit.slug);
+                continue;
+            }
+            entries.push({ slug: hit.slug, doc, hit });
+        }
+        // ---- Slow-lane merge (log-only shadow gate; consumption bookkeeping) ----
+        const slowPointers = [];
+        const slowDelivered = [];
+        const shadow = [];
+        let slowIncluded = [];
+        const consumedAt = new Date().toISOString();
+        if (slow !== undefined) {
+            const queryTokens = new Set(tokenize(query));
+            for (const item of slow.items) {
+                if (exclude?.has(item.slug)) {
+                    if (!deduped.includes(item.slug))
+                        deduped.push(item.slug);
+                    continue;
+                }
+                const meta = bySlug.get(item.slug);
+                if (meta === undefined)
+                    continue; // vanished between production and consumption
+                const verdict = scoreTopic(queryTokens, meta, {
+                    threshold: cfg.matchThreshold,
+                    topK: cfg.topK,
+                    tagBoost: cfg.tagBoost,
+                    graphDepth: cfg.graphDepth,
+                    recencyWindowDays: cfg.recencyWindowDays,
+                    conflicts,
+                    structuralGate: true,
+                });
+                shadow.push({
+                    slug: item.slug,
+                    pass: passesGate(verdict),
+                    why: verdict.strong ? `strong:${verdict.reasons[0] ?? 'field'}` : `body-hits:${verdict.bodyHits}`,
+                });
+                slowPointers.push({
+                    slug: item.slug,
+                    title: meta.title,
+                    status: meta.status,
+                    description: meta.description,
+                    why: item.why,
+                });
+            }
+        }
+        const pointerMode = cfg.injectMode !== 'digest';
+        // Pointer budget: per-entry fixed at the design's 80, total clamped to the
+        // fast-lane upper bound of 600 (I4) — totalBudget stays tunable downward.
+        const injection = pointerMode
+            ? assemblePointer(entries, { perTopicBudget: POINTER_PER_TOPIC, totalBudget: Math.min(cfg.totalBudget, POINTER_TOTAL) }, slowPointers)
+            : assembleInjection(entries, { perTopicBudget: cfg.perTopicBudget, totalBudget: cfg.totalBudget }, slowPointers);
+        slowIncluded = injection.slowIncluded ?? [];
+        for (const pointer of slowPointers) {
+            if (slowIncluded.includes(pointer.slug))
+                slowDelivered.push({ slug: pointer.slug, why: pointer.why });
         }
-        const injection = assembleInjection(entries, {
-            perTopicBudget: cfg.perTopicBudget,
-            totalBudget: cfg.totalBudget,
-        });
         const record = {
             at: new Date().toISOString(),
             queryTokenCount: tokenize(query).length,
             querySample: querySample(query),
             rosterSize: outcome.rosterSize,
-            hits: outcome.hits.map((h) => ({ slug: h.slug, score: h.score, reasons: h.reasons, viaGraph: h.viaGraph })),
-            nearMisses: outcome.nearMisses.map((h) => ({ slug: h.slug, score: h.score })),
+            hits: outcome.hits.map((h) => ({ slug: h.slug, score: h.score, reasons: h.reasons, viaGraph: h.viaGraph, strong: h.strong, bodyHits: h.bodyHits })),
+            // Reasons ride along: the gate-blocked marker is the replay evidence
+            // the P3 threshold decision needs (ADR 0014).
+            nearMisses: outcome.nearMisses.map((h) => ({ slug: h.slug, score: h.score, reasons: h.reasons })),
             injected: injection.text !== '',
             usedTokens: injection.usedTokens,
         };
@@ -196,14 +289,73 @@ export class TopicsService {
             record.sessionId = sessionId;
         if (deduped.length > 0)
             record.deduped = deduped;
-        if (injection.text === '' && outcome.hits.length > 0) {
+        if (unreadable.length > 0) {
+            record.dropped = [...(record.dropped ?? []), ...unreadable.map((slug) => ({ slug, reason: 'doc-unreadable' }))];
+        }
+        if (slow !== undefined) {
+            // Any round whose pending was consumed is a slow-participating round —
+            // lane never stays undefined when the lane family is present (a
+            // delivered pick with fast pointers is 'mixed'; a consumed-but-empty
+            // round beside fast pointers stays 'fast'; everything else 'slow').
+            record.lane = slowDelivered.length > 0 ? (injection.included.length > 0 ? 'mixed' : 'slow') : injection.included.length > 0 ? 'fast' : 'slow';
+            record.computedAt = slow.computedAt;
+            record.consumedAt = consumedAt;
+            if (shadow.length > 0)
+                record.shadowVerdict = shadow;
+            record.queryBuild = slow.queryBuild;
+            record.slowModel = slow.model;
+            record.slowMs = slow.ms;
+            record.slow = slowDelivered;
+        }
+        if (slowExpired !== undefined) {
+            // Expiry is recorded INDEPENDENT of whether the fast lane injected —
+            // the 赶上率 denominator must not lose rounds to a coincidental hit.
+            record.slowExpired = slowExpired;
+            if (record.lane === undefined)
+                record.lane = injection.text !== '' ? 'fast' : 'slow';
+        }
+        if (injection.text === '' && (outcome.hits.length > 0 || slowPointers.length > 0)) {
             // All hits deduped is a different story than a budget squeeze — say so.
-            record.why = deduped.length === outcome.hits.length ? 'dedup' : 'below-budget-or-dropped';
+            record.why = deduped.length === outcome.hits.length && outcome.hits.length > 0 ? 'dedup' : 'below-budget-or-dropped';
+        }
+        else if (injection.text === '' && slowExpired !== undefined) {
+            // The pending died at its hard bounds (TTL / turn-lag) without ever
+            // being delivered — the denominator the 赶上率 needs (v4 B4).
+            record.why = `slow-expired-${slowExpired}`;
         }
+        if (slowExpired !== undefined && injection.text === '')
+            record.lane = 'slow';
         if (injection.dropped.length > 0)
-            record.dropped = injection.dropped;
+            record.dropped = [...(record.dropped ?? []), ...injection.dropped];
         void this.store.appendInjectionRecord(record).catch(() => undefined);
-        return { text: injection.text, outcome, deduped, included: injection.included };
+        return { text: injection.text, outcome, deduped, included: injection.included, slowIncluded };
+    }
+    /**
+     * topic_open tool path (v4 §4.1): full conclusion / open questions /
+     * recommendations plus the staleness notice timestamp (fm.generated.at —
+     * the store stamps it on every write, so it IS the last-updated instant).
+     * Logs an open record for the pointer-open-rate stat.
+     */
+    async openTopic(slug, sessionId) {
+        const doc = await this.store.readTopic(slug).catch(() => undefined);
+        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.
+        await this.store
+            .appendOpenRecord({ slug, at: new Date().toISOString(), ...(sessionId !== undefined ? { sessionId } : {}) })
+            .catch(() => undefined);
+        return {
+            found: true,
+            slug,
+            title: doc.fm.title,
+            status: doc.fm.status,
+            updatedAt: doc.fm.generated.at,
+            description: doc.fm.description,
+            conclusion: okf.sectionOf(doc.body, okf.CONCLUSION_HEADING) ?? '',
+            openQuestions: doc.fm.open_questions,
+            recommendations: okf.sectionOf(doc.body, okf.RECOMMENDATIONS_HEADING) ?? '',
+        };
     }
     /** Sync roster read (same mtime cache as roster()). */
     rosterSync() {
@@ -248,6 +400,7 @@ export class TopicsService {
                 description: doc.fm.description,
                 status: doc.fm.status,
                 tags: doc.fm.tags,
+                triggers: doc.fm.triggers,
                 depends: doc.fm.depends,
                 links: okf.bodyLinkSlugs(doc.body),
                 generatedAt: doc.fm.generated.at,
@@ -301,6 +454,11 @@ export class TopicsService {
         };
         if (input.description !== undefined && input.description !== '')
             fm.description = input.description;
+        // Triggers pass through on create; on update the caller's value wins, else
+        // the stored list survives (same preserve-on-update semantics as tags).
+        const triggers = sanitizeTriggers(input.triggers ?? existing?.fm.triggers ?? []);
+        if (triggers.length > 0)
+            fm.triggers = triggers;
         if (existing !== undefined && existing.fm.verified !== undefined)
             fm.verified = existing.fm.verified;
         const result = await this.store.saveTopic({ slug, doc: { fm, body } }, { message: existing === undefined ? `topics(topic): create ${slug}` : `topics(topic): update ${slug}`, created: existing === undefined });
@@ -319,6 +477,9 @@ export class TopicsService {
             tagBoost: cfg.tagBoost,
             graphDepth: cfg.graphDepth,
             recencyWindowDays: cfg.recencyWindowDays,
+            // Explicit tool: the model asked for recall, so the injection-only
+            // structural gate must not hide results.
+            structuralGate: false,
             conflicts: await this.store.getConflicts(),
         });
     }
@@ -373,3 +534,15 @@ function dedupeLower(tags) {
     }
     return out;
 }
+function sanitizeTriggers(triggers) {
+    const out = [];
+    for (const t of triggers) {
+        if (typeof t !== 'string')
+            continue;
+        const key = t.trim();
+        if (key === '')
+            continue;
+        out.push(key);
+    }
+    return out;
+}

package/lib/store.d.ts

@@ -135,6 +135,19 @@ export declare class BundleStore {
     appendInjectionRecord(record: unknown): Promise<void>;
     private compactInjectionsIfNeeded;
     readInjectionRecords(limit?: number): Promise<InjectionRecord[]>;
+    private opensPath;
+    appendOpenRecord(record: {
+        slug: string;
+        at: string;
+        sessionId?: string;
+    }): 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;
+    }[]>;
     getConflicts(): Promise<Set<string>>;
     /** Sync variant for the injection hot path. */
     getConflictsSync(): Set<string>;

package/lib/store.js

@@ -425,6 +425,60 @@ export class BundleStore {
         return out.slice(-limit);
     }
     // ------------------------------------------------------------------
+    // Pointer-open log (v4 §4.3) — one line per topic_open call; feeds the
+    // 「指针打开率」 stat. Features only (slug/time), never conversation text.
+    // ------------------------------------------------------------------
+    opensPath() {
+        return join(this.metaDir(), 'opens.jsonl');
+    }
+    async appendOpenRecord(record) {
+        await mkdir(this.metaDir(), { recursive: true });
+        await appendFile(this.opensPath(), `${JSON.stringify(record)}\n`, 'utf8');
+        await this.compactOpensIfNeeded();
+    }
+    async compactOpensIfNeeded() {
+        const file = this.opensPath();
+        let size = 0;
+        try {
+            size = (await readFile(file, 'utf8')).length;
+        }
+        catch {
+            return;
+        }
+        if (size <= 512 * 1024)
+            return;
+        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. */
+    async readOpenRecords(limit = 2000) {
+        let raw;
+        try {
+            raw = await readFile(this.opensPath(), 'utf8');
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const line of raw.split('\n')) {
+            if (line.trim() === '')
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed.slug === 'string' && typeof parsed.at === 'string') {
+                    const rec = { slug: parsed.slug, at: parsed.at };
+                    if (typeof parsed.sessionId === 'string')
+                        rec.sessionId = parsed.sessionId;
+                    out.push(rec);
+                }
+            }
+            catch {
+                // Torn tail line tolerated.
+            }
+        }
+        return out.slice(-limit);
+    }
+    // ------------------------------------------------------------------
     // Conflicted topics (ADR 0003) — retrieval demotes these
     // ------------------------------------------------------------------
     async getConflicts() {

package/lib/tools.js

@@ -22,6 +22,7 @@ export function buildTopicTools(service) {
             conclusion: { type: 'string', required: true, description: 'The current best conclusion, self-contained markdown prose' },
             description: { type: 'string', description: 'One-line summary for indexes and snippets' },
             tags: { ...STRING_ARRAY, description: 'Cross-cutting tags (project, domain, component); lowercased on save' },
+            triggers: { ...STRING_ARRAY, description: 'Short recall phrases that should bring this topic back (specific nouns/terms, no generic words)' },
             depends: { ...STRING_ARRAY, description: 'Slugs of prerequisite topics (topics this one builds on)' },
             open_questions: { ...STRING_ARRAY, description: 'Unresolved questions this topic still carries' },
             impact: { ...STRING_ARRAY, description: 'What this conclusion affects: topics, projects, decisions' },
@@ -53,6 +54,7 @@ export function buildTopicTools(service) {
                 conclusion: args.conclusion,
                 description: args.description,
                 tags: args.tags,
+                triggers: args.triggers,
                 depends: args.depends,
                 openQuestions: args.open_questions,
                 impact: args.impact,
@@ -64,6 +66,52 @@ export function buildTopicTools(service) {
             return { slug: result.slug, path: result.path, created: result.created, committed: result.committed };
         },
     });
+    const topicOpen = defineTool({
+        name: 'topic_open',
+        description: 'Open one topic from the long-term memory in full: conclusion, open questions, recommendations, ' +
+            'plus a staleness notice. Use when a <topic-memory> pointer (or a search hit) is actually relevant — ' +
+            'pointers are one-line hints; this fetches the real content.',
+        parameters: {
+            slug: { type: 'string', required: true, description: 'Topic slug (from a pointer or topic_search)' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    found: { type: 'boolean', required: true },
+                    slug: { type: 'string', required: true },
+                    title: { type: 'string' },
+                    status: { type: 'string' },
+                    updatedAt: { type: 'string' },
+                    description: { type: 'string' },
+                    conclusion: { type: 'string' },
+                    openQuestions: { type: 'array', items: { type: 'string' } },
+                    recommendations: { type: 'string' },
+                },
+            },
+            render: (_args, value) => [
+                {
+                    type: 'text',
+                    text: !value.found
+                        ? `Topic \`${value.slug}\` 不存在（可能已合并或改名；用 topic_search 找）。`
+                        : [
+                            `快照于 ${value.updatedAt}，代码事实以源码为准。`,
+                            `### ${value.title} [${value.status}] (topics:${value.slug})`,
+                            value.description ?? '',
+                            value.conclusion !== '' ? `# Conclusion\n\n${value.conclusion}` : '',
+                            value.openQuestions !== undefined && value.openQuestions.length > 0 ? `待决: ${value.openQuestions.join('；')}` : '',
+                            value.recommendations !== '' ? `# Recommendations\n\n${value.recommendations}` : '',
+                        ]
+                            .filter((l) => l !== '')
+                            .join('\n\n'),
+                },
+            ],
+        },
+        async execute(args) {
+            return await service.openTopic(args.slug);
+        },
+    });
     const topicSearch = defineTool({
         name: 'topic_search',
         description: 'Search the long-term topic memory by keywords (hot path, no LLM). ' +
@@ -199,7 +247,7 @@ export function buildTopicTools(service) {
             return { entries: entries.map((e) => ({ ...e, conclusion: e.conclusion })) };
         },
     });
-    return [topicSave, topicSearch, topicObserve, topicHistory];
+    return [topicSave, topicOpen, topicSearch, topicObserve, topicHistory];
 }
 function extractConclusion(body) {
     // Local copy to avoid importing okf section helpers into the hot render path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "dsh-plugin: OKF v0.2 topic memory for dsh - local-first git-tracked bundle, hot-path LLM-free injection, two-stage observer with background distill",
   "type": "module",
   "main": "lib/index.js",
@@ -38,16 +38,16 @@
     "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/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/settings-migration.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/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/settings-migration.test.mjs test/quality.test.mjs test/replay-gate.test.mjs"
   },
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-commands": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-util-values": ">=0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-util-values": ">=0.1.2-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependenciesMeta": {
@@ -75,21 +75,21 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-attachment": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-brand": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-code-runtime": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-commands": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-invariants": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-scope": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-session": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-timeout": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-tools": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-user-approval": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-util-values": "0.1.2-alpha.4",
+    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-brand": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-code-runtime": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.2-rc.1",
     "@deepseek-ai/schemastery": "3.18.2",
     "@types/node": "^22.19.0",
     "typescript": "^5.9.2"

package/src/commands.ts

@@ -122,8 +122,9 @@ async function renderStatus(service: TopicsService): Promise<string> {
     `  冲突：${s.conflicts.length === 0 ? '无' : s.conflicts.join('、')}`,
     `  损坏文件：${s.broken.length === 0 ? '无' : s.broken.join('、')}`,
     `  git：${s.git ? `是（HEAD ${s.head?.slice(0, 10) ?? '??'}）` : '否'}`,
-    `  注入：${cfg.autoInject ? `开（topK ${cfg.topK}，预算 ${cfg.totalBudget} tok，阈值 ${cfg.matchThreshold}）` : '关'}`,
+    `  注入：${cfg.autoInject ? `${cfg.injectMode === 'digest' ? 'digest' : 'pointer'} 模式（topK ${cfg.topK}，预算 ${cfg.injectMode === 'digest' ? cfg.totalBudget : Math.min(cfg.totalBudget, 600)} tok，阈值 ${cfg.matchThreshold}）` : '关'}`,
     `  去重：${cfg.injectDedup ? '开（同会话已注入的 Topic 不重注）' : '关'}`,
+    `  慢道：${cfg.qualityLane === 'off' ? '关' : cfg.qualityLane === 'always' ? `每轮（${cfg.distillProvider}/${cfg.distillModel}）` : `采样 1/3（${cfg.distillProvider}/${cfg.distillModel}）`}`,
     `  蒸馏：${cfg.distillProvider !== '' && cfg.distillModel !== '' ? `${cfg.distillProvider}/${cfg.distillModel}，每 ${cfg.distillEveryTurns} 轮` : '未配置模型（/topics set distill-provider / distill-model）'}`,
   ]
   // Last lane outcome (distill-state summary) — what "checkable via
@@ -181,12 +182,35 @@ async function renderStats(service: TopicsService): Promise<string> {
     `  零命中轮：${stats.zeroHitRounds}；平均命中 ${stats.avgHitsPerRound} 条/轮`,
     `  平均预算占用：${stats.avgBudgetUtilization} tok`,
   ]
+  // v4 lane split — how much of the injection traffic each lane carries.
+  const slowRounds = records.filter((r) => r.lane === 'slow' || r.lane === 'mixed').length
+  if (slowRounds > 0) {
+    const consumed = records.filter((r) => r.consumedAt !== undefined && r.computedAt !== undefined)
+    let medianLag = ''
+    if (consumed.length > 0) {
+      const lags = consumed
+        .map((r) => Math.max(0, Date.parse(r.consumedAt as string) - Date.parse(r.computedAt as string)))
+        .sort((a, b) => a - b)
+      medianLag = `，赶上中位时延 ${(lags[Math.floor(lags.length / 2)] / 1000).toFixed(1)}s`
+    }
+    lines.push(`  慢道参与轮：${slowRounds}（快 ${(records.length - slowRounds)} / 慢或混合 ${slowRounds}${medianLag}）`)
+  }
+  // Pointer open rate (v4 §4.3): topic_open calls vs pointer entries injected.
+  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)).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} 条注入指针）`)
+  }
   if (stats.topTopics.length > 0) {
     lines.push('  Top-N 被注入 Topic：')
     for (const t of stats.topTopics.slice(0, 5)) lines.push(`    ${t.slug} ×${t.count}`)
   }
   if (stats.nearMissHistogram.length > 0) {
-    lines.push('  Near-miss 分布（低于阈值被挡）：')
+    lines.push('  Near-miss 分布（低于阈值或被结构门挡下）：')
     for (const b of stats.nearMissHistogram) lines.push(`    ${b.bucket}: ${b.count}`)
     const hint = tuningHint(stats, service.cfg.matchThreshold)
     if (hint !== undefined) lines.push(`  💡 ${hint}`)

package/src/config.ts

@@ -22,16 +22,22 @@ export const TopicsConfig = z.object({
   totalBudget: z.number().default(1500),
   /** Retrieval score threshold — tune via /topics stats near-miss evidence. */
   matchThreshold: z.number().default(0.3),
-  /** Additive boost per tag hit. */
+  /** Additive boost per tag hit (v4: total cap = this value, was ×3). */
   tagBoost: z.number().default(0.15),
+  /** Injection shape: pointer (default, ≤600 tok) keeps the legacy digest view. */
+  injectMode: z.string().default('pointer'),
+  /** Slow quality lane (v4 §4.2): off | sampled (1/3 of turns) | always. */
+  qualityLane: z.string().default('sampled'),
   /** depends-graph expansion depth (0 disables). */
   graphDepth: z.number().default(2),
   /** Days within which a topic counts as recent (+0.2). */
   recencyWindowDays: z.number().default(7),
   /** Capture each turn's user/assistant text as raw observations (M2). */
   autoObserve: z.boolean().default(true),
-  /** Whether injection and observation also engage delegated subagent sessions (ADR 0011). */
-  includeSubagents: z.boolean().default(true),
+  /** Whether injection and observation also engage delegated subagent sessions (ADR 0011).
+   *  v4 default flipped to false: one-shot subagent turns diluted the pool.
+   *  The slow quality lane never runs for subagents either way (hard guard). */
+  includeSubagents: z.boolean().default(false),
   /** Max auto-captured chars per side (user/assistant) per turn. */
   observationMaxChars: z.number().default(2000),
   /** Background distill cadence: every N turns of a long session. */
@@ -60,6 +66,8 @@ export type TopicsConfigValue = {
   totalBudget: number
   matchThreshold: number
   tagBoost: number
+  injectMode: string
+  qualityLane: string
   graphDepth: number
   recencyWindowDays: number
   autoObserve: boolean
@@ -83,6 +91,8 @@ export const CONFIG_KEYS = [
   'totalBudget',
   'matchThreshold',
   'tagBoost',
+  'injectMode',
+  'qualityLane',
   'graphDepth',
   'recencyWindowDays',
   'autoObserve',
@@ -136,6 +146,14 @@ export function parseConfigValue(key: ConfigKey, raw: string): boolean | number
       if (!Number.isFinite(n) || n < 0 || !Number.isInteger(n)) return { error: `${key} 需要非负整数` }
       return n
     }
+    case 'injectMode': {
+      if (raw === 'pointer' || raw === 'digest') return raw
+      return { error: 'inject-mode 取值 pointer|digest' }
+    }
+    case 'qualityLane': {
+      if (raw === 'off' || raw === 'sampled' || raw === 'always') return raw
+      return { error: 'quality-lane 取值 off|sampled|always' }
+    }
     case 'matchThreshold':
     case 'tagBoost': {
       const n = Number(raw)