@aiwayds/dsh-topics-memory 0.16.1-next.1 → 0.18.0

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-topics-memory",
+    "description": "Quality-first topic memory: each topic keeps the question, conclusion, impact and dependencies in a local git-traced OKF bundle."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-topics-memory",
+    "description": "质量优先的主题记忆：每个主题留存问题、结论、影响与依赖，落在本地 git 追踪的 OKF 包里，注入零 LLM 开销。"
+  }
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.16.1-next.1",
+  "version": "0.18.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",
   "types": "lib/index.d.ts",
+  "icon": "./icon.svg",
   "license": "MIT",
   "keywords": [
     "dsh",
@@ -33,25 +34,27 @@
     "lib",
     "cordis.patch.yml",
     "src",
-    "skills"
+    "skills",
+    "icon.svg",
+    "locale/*.json"
   ],
   "scripts": {
     "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/settings-migration.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.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",
     "smoke": "node scripts/smoke-boot.mjs"
   },
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": ">=0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-commands": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-values": ">=0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -81,23 +84,23 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-code-runtime": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-brand": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-commands": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22.19.0",
     "typescript": "^5.9.2"
   }

package/skills/dsh-topics-memory-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dsh-topics-memory-config
-description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指南。凡涉及 dsh 记忆/话题库/GitHub 同步/蒸馏/整理，或要配置 topics 段时先读本指南：settings.yaml 顶层 `topics:` 段全部键（repo/autoInject/topK/注入预算/蒸馏/整理/观察/图游走等）、/topics 命令族（onboard/status/distill/consolidate/stats/list/show/history/graph/sync/config/set）、首次配置 ask_user_question 向导（local-only 或绑 GitHub 仓、蒸馏模型路由、注入档位、自动观察）、注入形态 pointer/digest、legacy llmwiki 段自动迁移。触发词：topics、记忆、topic、蒸馏、distill、整理、consolidate、合并重复、deprecatedTtl、usageBoost、使用加成、autoInject、记忆库、llmwiki、include-subagents。"
+description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指南。凡涉及 dsh 记忆/话题库/GitHub 同步/蒸馏/整理，或要配置 topics 时先读本指南：设置页 `dsh-topics-memory` 条目全部键（repo/autoInject/topK/注入预算/蒸馏/整理/观察/图游走等）、/topics 命令族（onboard/status/distill/consolidate/stats/list/show/history/graph/sync/config/set）、首次配置 ask_user_question 向导（local-only 或绑 GitHub 仓、蒸馏模型路由、注入档位、自动观察）、注入形态 pointer/digest。触发词：topics、记忆、topic、蒸馏、distill、整理、consolidate、合并重复、deprecatedTtl、usageBoost、使用加成、autoInject、记忆库、include-subagents。"
 ---
 
 # dsh-topics-memory 使用指南（工作记忆 / 蒸馏 / 注入）
@@ -9,9 +9,9 @@ description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指
 > 可选同步 GitHub 私有仓跨机共享。记忆是编辑出来的不是攒出来的——一个 topic 只记四件事
 > （起始问题、结论、影响、依赖），过程属于 session，结束就随它去。
 
-## 配置入口（settings.yaml 顶层 `topics:` 段）
+## 配置入口（设置页 `dsh-topics-memory` 条目）
 
-在 `~/.dsh/settings.yaml` 写顶层 `topics:` 段（只写非默认值即可）：
+0.1.7+ 宿主在设置页编辑 `dsh-topics-memory` 条目（全部字段免重启热更）；`/topics set` 写同一处，profile patch 持久化：
 
 | 键 | 默认 | 作用 |
 |---|---|---|
@@ -95,6 +95,6 @@ GitHub 模式凭据走 `$GITHUB_TOKEN` 或已登录的 gh CLI（`gh auth status`
 4. **GitHub 同步**：repo 须形如 owner/name；推送有 push-debounce-seconds 去抖；退出只做
    本地 commit 不等网络，推迟的 push 由下次启动 pull 后补推；rebase 冲突的 topic 降权标记，
    `/topics status` 可查。
-5. **旧版 llmwiki 段自动迁移**：0.5.x 的 `llmwiki:` 设置段与 `~/.dsh/llmwiki` 数据目录在
-   首次启动时自动迁移到 `topics` / `~/.dsh/topics`，无需手工；旧插件还在运行时会警告跳过
-   （防双载脑裂），先从 profile 移除旧包。
+5. **旧版数据目录迁移**：0.5.x 的 `~/.dsh/llmwiki` 数据目录在首次启动时自动迁移到
+   `~/.dsh/topics`，无需手工。旧版 `llmwiki:` 设置段不再自动迁移（0.1.7 宿主一次性导入
+   settings.yaml 后改名 settings.yaml.imported）；如有残留旧值，在设置页手工搬入。

package/src/commands.ts

@@ -149,6 +149,32 @@ async function renderStatus(service: TopicsService): Promise<string> {
     const gc = typeof lastRun.gcDropped === 'number' && lastRun.gcDropped > 0 ? `，GC 回收 ${lastRun.gcDropped}` : ''
     rows.push(['最近蒸馏', `${outcome}${gc} @ ${cell(String(lastRun.at ?? '').slice(0, 19).replace('T', ' '))}`])
   }
+  // Fast-lane heartbeat (0.17.0): pair "observer lane recorded recently"
+  // with "no injection round for >48h" — exactly the asymmetry a silent
+  // fast-lane death produces (the 0.1.5-rc.2 claim-order incident shape).
+  // With autoInject off there is no fast lane to be stale.
+  if (cfg.autoInject) {
+    const HOUR = 3_600_000
+    const hb = await service.store.readLaneHeartbeat()
+    const stamp = (iso: string): string => cell(iso.slice(0, 19).replace('T', ' '))
+    const ago = (ms: number): string => {
+      const h = ms / HOUR
+      if (!Number.isFinite(h)) return ''
+      return h < 1 ? `${Math.max(1, Math.round(h * 60))} 分钟前` : h < 48 ? `${Math.round(h)}h 前` : `${Math.round(h / 24)} 天前`
+    }
+    const lastAt = hb.lastInjectionAt
+    const fastIdleMs = lastAt !== undefined ? Date.now() - Date.parse(lastAt) : Number.POSITIVE_INFINITY
+    const obsAgeMs = hb.lastObservationAt !== undefined ? Date.now() - Date.parse(hb.lastObservationAt) : Number.POSITIVE_INFINITY
+    const obsRecent = obsAgeMs < 24 * HOUR
+    if (lastAt === undefined) {
+      rows.push(['快道心跳', obsRecent ? `⚠️ 从未注入，但观察 lane ${ago(obsAgeMs)}仍在记录——快道疑似静默死亡` : '从未注入'])
+    } else if (fastIdleMs > 48 * HOUR && obsRecent) {
+      rows.push(['快道心跳', `⚠️ ${stamp(lastAt)}（${ago(fastIdleMs)}）无注入轮次，而观察 lane ${ago(obsAgeMs)}仍在记录——快道疑似静默死亡`])
+    } else {
+      const since = ago(fastIdleMs)
+      rows.push(['快道心跳', `${stamp(lastAt)}${since === '' ? '' : `（${since}）`}`])
+    }
+  }
   const lastConsolidate = await service.store.readConsolidateState()
   if (lastConsolidate !== undefined) {
     const count = (v: unknown): number => (Array.isArray(v) ? v.length : 0)

package/src/config.ts

@@ -9,71 +9,71 @@ import z from '@deepseek-ai/schemastery'
 
 export const TopicsConfig = z.object({
   /** GitHub repo `owner/name`; empty = local-only mode (ADR 0008). */
-  repo: z.string().default(''),
+  repo: z.string().default('').volatile(),
   /** Master switch for per-turn injection. */
-  autoInject: z.boolean().default(true),
+  autoInject: z.boolean().default(true).volatile(),
   /** Skip re-injecting topics already injected earlier in the same session. */
-  injectDedup: z.boolean().default(true),
+  injectDedup: z.boolean().default(true).volatile(),
   /** Skip re-injecting topics distilled from the CURRENT session's own turns
    *  (蒸馏回声): the conversation already carries that knowledge, so a
    *  pointer is a stale echo at best (2026-09 audit: 3 of 6 useless rounds).
    *  Provenance rides the observations log (sessionId → distilledInto). */
-  suppressEcho: z.boolean().default(true),
+  suppressEcho: z.boolean().default(true).volatile(),
   /** Max topics injected per round (ADR 0006: ≤4). */
-  topK: z.number().default(4),
+  topK: z.number().default(4).volatile(),
   /** Per-topic digest budget in tokens. */
-  perTopicBudget: z.number().default(300),
+  perTopicBudget: z.number().default(300).volatile(),
   /** Total injection budget in tokens. */
-  totalBudget: z.number().default(1500),
+  totalBudget: z.number().default(1500).volatile(),
   /** Retrieval score threshold — tune via /topics stats near-miss evidence. */
-  matchThreshold: z.number().default(0.3),
+  matchThreshold: z.number().default(0.3).volatile(),
   /** Additive boost per tag hit (v4: total cap = this value, was ×3). */
-  tagBoost: z.number().default(0.15),
+  tagBoost: z.number().default(0.15).volatile(),
   /** Injection shape: pointer (default, ≤600 tok) keeps the legacy digest view. */
-  injectMode: z.string().default('pointer'),
+  injectMode: z.string().default('pointer').volatile(),
   /** Slow quality lane (v4 §4.2): off | sampled (1/3 of turns) | always. */
-  qualityLane: z.string().default('sampled'),
+  qualityLane: z.string().default('sampled').volatile(),
   /** depends-graph expansion depth (0 disables). */
-  graphDepth: z.number().default(2),
+  graphDepth: z.number().default(2).volatile(),
   /** Days within which a topic counts as recent (+0.2). */
-  recencyWindowDays: z.number().default(7),
+  recencyWindowDays: z.number().default(7).volatile(),
   /** Capture each turn's user/assistant text as raw observations (M2). */
-  autoObserve: z.boolean().default(true),
+  autoObserve: z.boolean().default(true).volatile(),
   /** 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),
+  includeSubagents: z.boolean().default(false).volatile(),
   /** Max auto-captured chars per side (user/assistant) per turn. */
-  observationMaxChars: z.number().default(2000),
+  observationMaxChars: z.number().default(2000).volatile(),
   /** Background distill cadence: every N turns of a long session. */
-  distillEveryTurns: z.number().default(5),
+  distillEveryTurns: z.number().default(5).volatile(),
   /** Distill once when a session ends. */
-  distillOnSessionEnd: z.boolean().default(true),
+  distillOnSessionEnd: z.boolean().default(true).volatile(),
   /** Distill lane model route; both must be set, else distill stays idle. */
-  distillProvider: z.string().default(''),
-  distillModel: z.string().default(''),
+  distillProvider: z.string().default('').volatile(),
+  distillModel: z.string().default('').volatile(),
   /** Observations per distill model call; auto-halves on output-limit failures (floor 5). */
-  distillBatchSize: z.number().default(40),
+  distillBatchSize: z.number().default(40).volatile(),
   /** Max model calls per distill run — successful batches keep their marks (partial progress).
    *  Default 8: with the batch loop, one run then drains ~30-40 observations
    *  instead of ~10, which is what makes a real backlog actually shrink. */
-  distillMaxModelCalls: z.number().default(8),
+  distillMaxModelCalls: z.number().default(8).volatile(),
   /** Consolidation lane (整理) cadence: how often a session start may run the
    *  LLM gardener over the EXISTING pool (merge near-duplicates, promote
    *  settled drafts, deprecate superseded, refresh metadata). Reuses the
    *  distill model route; off disables the lane entirely. */
-  consolidateCadence: z.string().default('daily'),
+  consolidateCadence: z.string().default('daily').volatile(),
   /** Deprecated topics older than this many days are dropped at session start
    *  (local TTL sweep, no model; each drop is its own git commit, so history
    *  stays recoverable on the remote). 0 disables the sweep. */
-  deprecatedTtlDays: z.number().default(15),
+  deprecatedTtlDays: z.number().default(15).volatile(),
   /** UsageBoost (ADR 0015): behavioral bonus for topics injected/opened in
    *  the last 30 days, folded into the gate score — capped at 0.2 and never
    *  granted to zero-lexical candidates; the structural gate still applies.
    *  0 = off. */
-  usageBoost: z.number().default(0.15),
+  usageBoost: z.number().default(0.15).volatile(),
   /** Debounced push delay in GitHub mode. */
-  pushDebounceSeconds: z.number().default(45),
+  pushDebounceSeconds: z.number().default(45).volatile(),
 })
 
 export type TopicsConfigValue = {

package/src/distill.ts

@@ -13,6 +13,20 @@
 import * as okf from './okf.ts'
 import type { TopicsService } from './service.ts'
 
+// dsh 0.1.7 removed the shared catch-all 'plugin' message-source kind:
+// MessageSourceMap is now a merge-extensible sum type and every producer
+// declares its own kind in its own module (dsh-skill: 'skill-invocation',
+// dsh-agent: 'model-selection', …). This plugin's distill call therefore
+// registers 'topics-memory' — consumers fall through unknown kinds by
+// contract, so hosts without the augmentation still render the message.
+declare module '@deepseek-ai/dsh-llm' {
+  interface MessageSourceMap {
+    /** Producer context contributed by the dsh-topics-memory plugin. */
+    'topics-memory': { kind: 'topics-memory' }
+  }
+}
+
+
 export interface ModelRequest {
   system: string
   user: string
@@ -838,7 +852,7 @@ export function defaultModelCaller(
     const messages = [
       createUserMessage({
         content: [{ type: 'text', text: req.user }],
-        source: { kind: 'plugin', plugin: 'dsh-topics-memory' },
+        source: { kind: 'topics-memory' },
       }),
     ]
     const options = deepFreeze({