@aiwayds/dsh-topics-memory 0.17.1 → 0.18.0

package/lib/index.js

@@ -2,7 +2,8 @@
  * dsh-topics-memory — OKF topic memory for DeepSeek Harness.
  *
  * Wiring (per ADR 0001–0008):
- *  - `topics` settings namespace (user-tunable via /topics set)
+ *  - settings page = projection of the plugin `Config` schema, namespace =
+ *    profile entry id `dsh-topics-memory` (user-tunable via /topics set)
  *  - static systemPrompt section teaching the topic tools (never volatile
  *    content — the provider cache prefix stays byte-stable)
  *  - same-turn injection: retrieval runs synchronously at inbox-claim time
@@ -154,68 +155,20 @@ export function resolveClaimedText(input) {
         source: 'projection',
     };
 }
-// dsh-settings 0.1.2-alpha.3 removed the runtime settingsNamespace() helper:
-// register() now brand-checks the namespace at the type level
-// (SettingsNamespaceInput) and validates the same lowercase-hyphenated
-// pattern at runtime via parseSettingsNamespace. A plain literal is the
-// supported spelling (same adaptation as dsh-cron / dsh-model-sync).
-const OWN_NS = 'topics';
-/** Pre-rename settings namespace (dsh-llmwiki-memory ≤ 0.5.x). The plugin
- *  itself never writes to it, but while the migration window is open the
- *  registration shows up in config UIs like any other namespace (ADR 0013). */
-const LEGACY_NS = 'llmwiki';
-/**
- * One-time carry-over of user-tuned values from the pre-rename `llmwiki`
- * settings namespace into `topics` (ADR 0013). Constraints:
- * - one-time: only fires while the new namespace holds NO raw user overrides —
- *   describe().user is the only way to tell user keys from schema defaults,
- *   because scope.get() folds the defaults in;
- * - idempotent: after the copy (or any config written on the new name) the
- *   override check short-circuits every later boot;
- * - fail-open: registering the legacy namespace can throw (duplicate or
- *   schema-invalid stored section) and the write can reject — both contained,
- *   so plugin startup never depends on the migration.
- * Keys whose stored value equals the schema default are not copied (nothing
- * user-tuned to preserve). Returns the in-flight write for tests; apply()
- * fire-and-forgets it.
- */
-export function migrateLegacySettings(settings, warn) {
-    try {
-        const describe = settings.describe?.bind(settings);
-        if (describe === undefined)
-            return undefined;
-        const findUser = (ns) => {
-            const user = describe().find((entry) => entry.ns === ns)?.user;
-            return user !== undefined && user !== null && typeof user === 'object' ? user : undefined;
-        };
-        // Already migrated / user-configured on the new name — never touch it.
-        if (findUser(OWN_NS) !== undefined)
-            return undefined;
-        // Old-plugin coexistence (ADR 0013): `llmwiki` already registered means
-        // the pre-rename dsh-llmwiki-memory 0.5.x is still loaded in this host.
-        // Our register below would hit the duplicate guard, migration would
-        // silently skip, and both plugins would drift onto separate bundles
-        // (split brain). Warn loudly instead of registering blind.
-        if (describe().some((entry) => entry.ns === LEGACY_NS)) {
-            warn?.('dsh-topics-memory: the legacy dsh-llmwiki-memory (0.5.x) is still running in this host — ' +
-                'settings migration was skipped because the "llmwiki" namespace is already registered. ' +
-                'Remove @aiwayds/dsh-llmwiki-memory from this profile so only dsh-topics-memory loads.');
-            return undefined;
-        }
-        // Registering the legacy namespace is the only API that surfaces its
-        // stored section; a duplicate or schema-invalid section throws — contained.
-        settings.register(LEGACY_NS, TopicsConfig);
-        const legacyUser = findUser(LEGACY_NS);
-        if (legacyUser === undefined)
-            return undefined;
-        const ops = CONFIG_KEYS.filter((k) => k in legacyUser && legacyUser[k] !== DEFAULTS[k]).map((k) => ({ op: 'set', path: [k], value: legacyUser[k] }));
-        if (ops.length === 0)
-            return undefined;
-        return settings.mutate?.call(settings, OWN_NS, ops)?.catch(() => undefined);
-    }
-    catch {
-        return undefined;
-    }
+// dsh 0.1.7 settings: the runtime namespace registry (register/describe per
+// plugin) is gone. A plugin's settings page is the projection of its `Config`
+// schema below, and the settings namespace is the profile entry id
+// (`dsh-topics-memory`, cordis.patch.yml) — the same spelling /topics set
+// passes to ctx.settings.mutate(). A legacy top-level `topics:` section in
+// settings.yaml is NOT auto-imported under this id — the host imports the
+// old settings.yaml once, then renames it to settings.yaml.imported.
+export const Config = TopicsConfig;
+/** Settings namespace this plugin reads and writes: the profile entry id. */
+const ENTRY_ID = 'dsh-topics-memory';
+/** Snapshot one config slot: live ref → current value, plain value → itself. */
+function readConfigValue(slot) {
+    const ref = slot;
+    return typeof ref?.get === 'function' ? ref.get() : slot;
 }
 // --- Bundled skill -----------------------------------------------------------
 /** Provider name under `ctx.skills`; doubles as the skill name. */
@@ -229,7 +182,7 @@ const SKILL_RESOURCE_BASE = {
 };
 const SKILL_INVOCATION = { modelInvocable: true, userInvocable: true };
 /** Routing description; must stay identical to the SKILL.md frontmatter (asserted in tests). */
-const SKILL_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。';
+const SKILL_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。';
 const SKILL_CANDIDATE = {
     name: SKILL_PROVIDER_NAME,
     description: SKILL_DESCRIPTION,
@@ -282,19 +235,16 @@ export function stripFrontmatter(raw) {
     }
     return raw;
 }
-export function apply(ctx) {
+export function apply(ctx, config = {}) {
     // `inject = ['skills']` guarantees the service exists on every real host;
     // register unconditionally so a missing service fails loud instead of
     // silently dropping the bundled skill.
     ctx.skills.registerProvider(() => skillProvider);
-    // dsh-settings is part of every real host closure but is a runtime-optional
-    // peer so bare test harnesses can still load this module.
-    const settingsNs = ctx.settings;
-    if (settingsNs === undefined)
-        return;
-    const scope = settingsNs.register(OWN_NS, TopicsConfig);
+    // 0.1.7 hosts validate the profile patch against `Config` above and hand
+    // apply() live volatile references; bare harnesses pass plain values (or
+    // nothing) — readConfigValue treats both shapes the same.
     // Host logger access is best-effort: cordis always provides one, but bare
-    // test harnesses may not — the migration stays silent rather than throwing.
+    // test harnesses may not — the logging stays silent rather than throwing.
     const warn = (message) => {
         try {
             const logger = ctx.logger;
@@ -305,10 +255,6 @@ export function apply(ctx) {
             // contained — a missing/broken logger must not break startup
         }
     };
-    // Carry user-tuned values over from the pre-rename namespace (one-time,
-    // fail-open, idempotent — see migrateLegacySettings). Fire-and-forget: the
-    // write settles on its own; a rejection only skips the migration.
-    void migrateLegacySettings(settingsNs, warn);
     // Low-noise observability for the fast lane's early exits. The 2026-09-21
     // silent-death incident (0.1.5-rc.2 claim order) died precisely because
     // every exit path was silent: the injected log stayed empty for weeks
@@ -326,7 +272,14 @@ export function apply(ctx) {
         }
     };
     const cfgNow = () => {
-        const v = scope.get();
+        const v = {};
+        for (const k of CONFIG_KEYS) {
+            const slot = config[k];
+            // Skip absent keys so the DEFAULTS fold below keeps them (an explicit
+            // undefined spread would wipe the default).
+            if (slot !== undefined)
+                v[k] = readConfigValue(slot);
+        }
         // Schema defaults may not be applied by bare test harnesses; fill them in.
         return { ...DEFAULTS, ...v };
     };
@@ -616,6 +569,11 @@ export function apply(ctx) {
             let logEvents;
             if (typeof seq === 'number') {
                 try {
+                    // Soft-deprecated surface, deliberately kept (dsh 0.17 migration):
+                    // `snapshotEvents` still ships in dsh-session 0.1.7-rc.1 and this is
+                    // the replay's data source, reachable only behind event.seq with a
+                    // full projection-read fallback below. Migrating to registered
+                    // SessionMessageProjections is a dedicated project, not a drive-by.
                     const snapshot = session.snapshotEvents;
                     if (typeof snapshot === 'function')
                         logEvents = snapshot.call(session, 0, seq);
@@ -668,10 +626,6 @@ export function apply(ctx) {
         if (event.type === 'turn/end')
             dispatchSlowLane(sessionId);
     }));
-    // Session-start boot chain dedup: rc.2's creation transaction emits BOTH
-    // `agent/session-start` and `agent/created`, so the pair collapses to one
-    // chain run per session; teardown clears the entry.
-    const bootedSessions = new Set();
     // ---- Session teardown: real cordis events, not session/event types ----
     // dsh-session 0.1.2-alpha.4's SessionEventMap has no `agent/disposed` or
     // `session/disposed` event type — the old `event.type === 'agent/disposed'`
@@ -696,7 +650,6 @@ export function apply(ctx) {
             observer.onSessionEvent(sessionId, name, undefined);
             injectedBySession.delete(sessionId);
             slowLane.clear(sessionId);
-            bootedSessions.delete(sessionId);
             // A teardown-triggered run (session-end distill) reads the payload
             // capture lazily: drop the entry here only when no run can still read
             // it. The slow lane's in-flight pipeline reads it too (shared caller);
@@ -704,91 +657,128 @@ export function apply(ctx) {
             releaseSessionLlm(sessionId);
         }));
     }
-    // ---- Sync lifecycle: pull on session start, local commit on dispose ----
+    // ---- Boot chain: pull on session start, replay-distill, consolidate, TTL ----
     // Session start is an agent-bus event, never a session/event firehose type:
-    // the firehose only carries Session.append types. Tarball-verified emission
-    // sites: `agent/session-start` (sync, payload { agent, source }) is emitted
-    // by dsh-agent-loop up to 0.1.5; 0.1.6-alpha.1 merges the startup
-    // notification into the serial `agent/created` announcement (payload
-    // { agent, source, signal? }) and drops the old name. So one registration
-    // per name — a host that never emits a name simply never calls that
-    // listener. Only { agent } is structural; the rest is defensive.
+    // the firehose only carries Session.append types. dsh 0.1.7 announces ONE
+    // serial `agent/created` event (payload { agent, source, signal? }, source
+    // ∈ 'startup' | 'resume' | 'clear' | 'compact') and `agent/session-start`
+    // is gone with no shim — 0.16.1's dual-name registration collapses to a
+    // single listener, and with it the per-session dedup Set: the registry
+    // guarantees exactly one announce per agent entry (a second announce
+    // throws), so a 'clear'/'compact' re-creation legitimately re-runs the
+    // chain on its fresh entry and teardown has nothing to re-arm. Only
+    // { agent } is structural; the rest is defensive.
+    //
+    // BOOT GUARANTEE (dsh 0.1.7): the serial dispatch awaits every
+    // `agent/created` listener and a throw or rejection ROLLS THE ENTIRE AGENT
+    // CREATION BACK. This listener is therefore total and synchronous — it
+    // never throws, never returns a promise — and the chain is deferred off
+    // the creation transaction entirely (setImmediate, unref'd): the pull /
+    // replay-distill / consolidation slow work starts only after the serial
+    // dispatch has moved on. Plugin initialization must never block, delay,
+    // or abort session startup; a chain failure at most warns.
     const runBootChain = (sessionId) => {
-        void sync
-            .pull()
-            .catch(() => undefined)
-            .finally(() => store.ensure().catch(() => undefined))
-            .then(() => {
-            // Boot replay: the observations JSONL is the durable distill queue.
-            // Whatever the previous exit skipped (local-only exit since the
-            // no-network exit commit) or a killed run left unmarked is still
-            // undistilled here. Empty pool and no-model are cheap no-ops inside
-            // the distiller; the per-session dedup guards double runs.
-            void store
-                .undistilledObservations(1)
-                .then((pending) => {
-                if (pending.length === 0)
-                    return;
-                // Same trigger-time capture the observer callback does: the
-                // replay run's caller resolves candidates lazily and a fresh
-                // session has no prior capture to lean on.
+        // Contained at the top too: a synchronous prologue throw (config read,
+        // sync bookkeeping) must degrade to a warn, not leak toward the host.
+        try {
+            void sync
+                .pull()
+                .catch((error) => {
+                // The pull failing must stay non-fatal for the chain (replay and
+                // TTL still run on the local pool), but no longer silent — a dead
+                // sync route should leave a host-log trace.
+                warn(`dsh-topics-memory 启动同步 pull 失败（继续本地启动链）：${error instanceof Error ? error.message : String(error)}`);
+            })
+                .finally(() => store.ensure().catch(() => undefined))
+                .then(() => {
+                // Boot replay: the observations JSONL is the durable distill queue.
+                // Whatever the previous exit skipped (local-only exit since the
+                // no-network exit commit) or a killed run left unmarked is still
+                // undistilled here. Empty pool and no-model are cheap no-ops inside
+                // the distiller; the per-session dedup guards double runs.
+                void store
+                    .undistilledObservations(1)
+                    .then((pending) => {
+                    if (pending.length === 0)
+                        return;
+                    // Same trigger-time capture the observer callback does: the
+                    // replay run's caller resolves candidates lazily and a fresh
+                    // session has no prior capture to lean on.
+                    try {
+                        captureFromAgent(agents()?.get(sessionId));
+                    }
+                    catch {
+                        // contained — the run below fails with the readable
+                        // no-adapter detail instead
+                    }
+                    const run = distiller.request(sessionId, 'boot-replay');
+                    if (run !== undefined)
+                        void run.catch(() => undefined);
+                })
+                    .catch(() => undefined);
+                // Consolidation cadence check — after the pull (freshest pool),
+                // fully fire-and-forget: cadence/single-flight gates live inside
+                // maybeRun, and a no-model boot just skips (no stamp advanced).
+                // Failures are NOT silent at the host log: the 2026-09-09 real-host
+                // test showed a dead distill route would otherwise hide here with
+                // zero observable trace (the state file only advances on success).
                 try {
                     captureFromAgent(agents()?.get(sessionId));
                 }
                 catch {
-                    // contained — the run below fails with the readable
-                    // no-adapter detail instead
+                    // contained — the run below fails with a readable no-model detail
                 }
-                const run = distiller.request(sessionId, 'boot-replay');
-                if (run !== undefined)
-                    void run.catch(() => undefined);
-            })
-                .catch(() => undefined);
-            // Consolidation cadence check — after the pull (freshest pool),
-            // fully fire-and-forget: cadence/single-flight gates live inside
-            // maybeRun, and a no-model boot just skips (no stamp advanced).
-            // Failures are NOT silent at the host log: the 2026-09-09 real-host
-            // test showed a dead distill route would otherwise hide here with
-            // zero observable trace (the state file only advances on success).
-            try {
-                captureFromAgent(agents()?.get(sessionId));
-            }
-            catch {
-                // contained — the run below fails with a readable no-model detail
-            }
-            void consolidator
-                .maybeRun({ sessionId })
-                .then((r) => {
-                if (r !== undefined && !r.ok && r.reason !== 'no-clusters') {
-                    warn(`dsh-topics-memory 整理 lane 未执行：${r.reason ?? 'unknown'}${r.detail !== undefined ? `（${r.detail}）` : ''}`);
-                }
-            })
-                .catch(() => undefined);
-            // Deprecated-TTL sweep — pure local rule, no model, runs even when
-            // the distill route is unconfigured. Drops are logged: deletion is
-            // the one housekeeping action the user should always see happened.
-            const ttl = cfgNow().deprecatedTtlDays;
-            if (ttl > 0) {
-                void dropExpiredDeprecated(service, ttl)
-                    .then((dropped) => {
-                    if (dropped.length > 0) {
-                        warn(`dsh-topics-memory：按 ${ttl} 天 TTL 删除了 ${dropped.length} 条 deprecated topic（${dropped.map((s) => `topics/${s}`).join('、')}）；git 历史可找回`);
+                void consolidator
+                    .maybeRun({ sessionId })
+                    .then((r) => {
+                    if (r !== undefined && !r.ok && r.reason !== 'no-clusters') {
+                        warn(`dsh-topics-memory 整理 lane 未执行：${r.reason ?? 'unknown'}${r.detail !== undefined ? `（${r.detail}）` : ''}`);
                     }
                 })
                     .catch(() => undefined);
-            }
-        })
-            .catch(() => undefined);
+                // Deprecated-TTL sweep — pure local rule, no model, runs even when
+                // the distill route is unconfigured. Drops are logged: deletion is
+                // the one housekeeping action the user should always see happened.
+                const ttl = cfgNow().deprecatedTtlDays;
+                if (ttl > 0) {
+                    void dropExpiredDeprecated(service, ttl)
+                        .then((dropped) => {
+                        if (dropped.length > 0) {
+                            warn(`dsh-topics-memory：按 ${ttl} 天 TTL 删除了 ${dropped.length} 条 deprecated topic（${dropped.map((s) => `topics/${s}`).join('、')}）；git 历史可找回`);
+                        }
+                    })
+                        .catch(() => undefined);
+                }
+            })
+                .catch((error) => {
+                warn(`dsh-topics-memory 启动链失败（不影响会话启动）：${error instanceof Error ? error.message : String(error)}`);
+            });
+        }
+        catch (error) {
+            warn(`dsh-topics-memory 启动链无法启动（不影响会话启动）：${error instanceof Error ? error.message : String(error)}`);
+        }
     };
-    for (const name of ['agent/session-start', 'agent/created']) {
-        ctx.on(name, ((payload) => {
+    ctx.on('agent/created', ((payload) => {
+        // The boot-fallback contract lives HERE, not inside runBootChain: dsh
+        // 0.1.7 rolls agent creation back when this listener throws, so even a
+        // hostile/malformed payload (a throwing getter, a proxy trap) degrades to
+        // a warn. Returning undefined (never a thenable) keeps the serial
+        // dispatch from awaiting anything.
+        try {
             const sessionId = String(payload?.agent?.id ?? '');
-            if (sessionId === '' || bootedSessions.has(sessionId))
+            if (sessionId === '')
                 return;
-            bootedSessions.add(sessionId);
-            runBootChain(sessionId);
-        }));
-    }
+            // Off the creation transaction: the unref'd immediate fires after the
+            // current serial dispatch slice, so the chain's synchronous prologue
+            // (config read, sync state) never delays the remaining listeners nor
+            // the loop start, and the timer cannot hold a dying process open.
+            const deferred = setImmediate(() => runBootChain(sessionId));
+            deferred.unref?.();
+        }
+        catch (error) {
+            warn(`dsh-topics-memory boot 链触发失败（不影响会话启动）：${error instanceof Error ? error.message : String(error)}`);
+        }
+    }));
     ctx.effect(() => {
         void store.ensure().catch(() => undefined);
         // Async disposer: cordis awaits it during unload (Disposable may be
@@ -821,7 +811,9 @@ export function apply(ctx) {
         const mutate = async (ops) => {
             if (settingsMutator?.mutate === undefined)
                 throw new Error('settings 服务不可用，无法写入配置');
-            await settingsMutator.mutate(OWN_NS, ops);
+            // 0.1.7: the settings namespace is the profile entry id, not the old
+            // `topics` namespace name.
+            await settingsMutator.mutate(ENTRY_ID, ops);
         };
         // Resolved lazily at invocation time: whichever UI registered the ask-user
         // provider (TUI panel / web composer / feishu card, ask-router optional)

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.17.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/fast-lane.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）；如有残留旧值，在设置页手工搬入。