dsh-layered-memory 0.10.0 → 0.11.0

package/README.en.md

@@ -70,6 +70,26 @@ and the memory chip in the input bar (`Memory · Auto`) mean the client half is
 **Uninstall**: `dsh plugin --profile web remove dsh-layered-memory` + restart. Data
 stays in `~/.dsh/memory/`; delete the whole directory manually if you don't need it.
 
+### Terminal Hosts (TUI / headless)
+
+Beyond web, the same plugin installs into terminal-shaped hosts:
+
+```bash
+# dsh-tui (Claude Code style TUI front door — see github.com/ccch1mneyyy/dsh-TUI · site https://dshtui.com)
+dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui   # first time: create profile + install the TUI host
+dsh plugin --profile dsh-tui add dsh-layered-memory
+dsh --profile dsh-tui
+```
+
+- **`/memory <auto|chat|work|off>`** switches the current session's memory mode; with no
+  argument a selection panel pops up;
+- **Status line**: a persistent `记忆:智能`-style mode readout sits right above the prompt;
+- **`/settings` section**: master switch, capture, distill, recall, distill model routing and
+  input budget are editable in place (same store as the web settings panel; complex routing
+  chains still go through web / YAML);
+- **headless** (`dsh --profile headless "one-shot task"`): capture and distillation work as
+  usual with no UI elements. Web and terminal hosts share the same `~/.dsh/memory/` store.
+
 ### Development from Source
 
 ```bash
@@ -184,6 +204,8 @@ lives in the native host seat designed for it; the plugin no longer owns a strip
   toggle in Automation. Ideal for debug/eval/sensitive sessions that should absorb
   without interference. Orthogonal to Paused: paused is full stealth (capture off
   too), while write-only keeps the "in" and gates the "out".
+- **Terminal host (TUI)**: the same mode system surfaces in the dsh-tui host as the
+  `/memory` command, a status line and a `/settings` section (see Quick Start).
 
 ## UI Preview
 

package/README.md

@@ -61,6 +61,24 @@ Agent 应当返回安装结果，并明确告诉你配置中是否已经出现 `
 **卸载**：`dsh plugin --profile web remove dsh-layered-memory` + 重启。数据保留在
 `~/.dsh/memory/`，不需要时手动删除整个目录即可。
 
+### 终端形态（TUI / headless）
+
+除 web 外，同一插件可直接装进终端形态宿主：
+
+```bash
+# dsh-tui（Claude Code 风格 TUI 前门，详见 github.com/ccch1mneyyy/dsh-TUI · 官网 https://dshtui.com）
+dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui   # 首次：建 profile 并装 TUI 宿主
+dsh plugin --profile dsh-tui add dsh-layered-memory
+dsh --profile dsh-tui
+```
+
+- **`/memory <auto|chat|work|off>`** 切换当前会话档位，无参数时弹出档位选择面板；
+- **状态行**：提示框上方常驻 `记忆:智能` 等当前档位读数；
+- **`/settings` 设置区块**：总开关、捕获、蒸馏、召回、蒸馏模型路由与输入预算可直接编辑
+  （与 web 设置面板同一存储；复杂路由链仍走 web / YAML）；
+- **headless**（`dsh --profile headless "一次性任务"`）：捕获与蒸馏照常工作，无界面元素。
+  web 与终端形态共享 `~/.dsh/memory/` 同一份记忆。
+
 ### 从源码开发
 
 ```bash
@@ -143,6 +161,8 @@ L1/L2/L3 层级过滤）、层级 × 时间窗口表格（调用数 / 输出与
   一并停止；`memory_search` 等读工具返回只写提示）。覆盖按会话持久化，切回
   「跟随全局」即清除、跟随自动化区的召回开关；适合调试/评测/敏感会话「只吸收不干扰」。
   与暂停正交：暂停是完全隐身（连捕获都关），只写保留「进」关「出」。
+- **终端形态（TUI）**：同一档位体系在 dsh-tui 宿主下以 `/memory` 命令、状态行与
+  `/settings` 区块呈现（安装见快速开始）。
 
 ## 界面预览
 

package/dist/index.js

@@ -38,6 +38,7 @@ import { SceneStore } from './store/scenes.js';
 import { SessionModeStore } from './store/session-modes.js';
 import { StateStore } from './store/state.js';
 import { registerMemoryTools } from './tools/index.js';
+import { registerTuiSurface } from './tui.js';
 import { errDetail, withFileLog } from './util/filelog.js';
 import { buildRouteChain, resolveModelRoute, invalidateEffortCache } from './llm.js';
 import { effectiveCfg } from './pipeline/runner.js';
@@ -287,6 +288,9 @@ export async function apply(ctx, config) {
     await runner.init();
     // 档位切换同步（ADR-0003）：切走按捕获档位落袋 / 切 off 挂起 / 切回清挂起
     modes.setModeChangeHandler((sessionId, oldMode, newMode) => runner.onModeChange(sessionId, oldMode, newMode));
+    // ── TUI 形态原生接入（dsh-tui/官方 TUI 宿主；软探测，web/headless 下全部 no-op）。
+    //    放切换链接线之后：/memory 在启动窗口内派发也不会绕过 runner.onModeChange ──
+    registerTuiSurface(ctx, { logger, live, modes });
     // 闲置兜底：静默达标会话的未蒸馏切片自动落袋（idleSeconds=0 关闭）
     runner.startIdleTimer();
     // 重建控制器（存储降级时不建——RPC 端点走 supported=false 分支）

package/dist/settings.d.ts

@@ -37,6 +37,8 @@ export interface LiveSettingsHandle {
     get(): MemoryLiveSettings;
     /** UI 写入入口；不支持时抛错由 RPC 层转成业务错误 */
     update(patch: Partial<MemoryLiveSettings>): Promise<void>;
+    /** 订阅开关变更（TUI 状态行等即时刷新；可选——缺省方退化为下次交互时刷新）。返回退订。 */
+    onChange?(cb: () => void): () => void;
 }
 export declare function liveSettingsSchema(): Schema<MemoryLiveSettings>;
 export declare function registerLiveSettings(ctx: Context, logger: MemoryLogger): LiveSettingsHandle;

package/dist/settings.js

@@ -134,6 +134,9 @@ export function registerLiveSettings(ctx, logger) {
         get: () => ALWAYS_ON,
         update: () => Promise.reject(new Error('settings 服务不可用')),
     };
+    // 变更订阅者（handle.onChange）：挂接在闭包层，inner 换新（服务迁移）后由新 scope 的
+    // watch 继续驱动——订阅方无感
+    const changeCbs = new Set();
     /** 挂接一个（新注册或复用的）scope：重挂前先摘旧 watcher，防跨重启累积。 */
     const wireScope = (scope) => {
         cachedUnwatch?.();
@@ -141,6 +144,14 @@ export function registerLiveSettings(ctx, logger) {
         cachedUnwatch = scope.watch((next) => {
             const prev = current;
             current = resolveSettings(next);
+            for (const cb of changeCbs) {
+                try {
+                    cb();
+                }
+                catch {
+                    // 订阅方异常不阻断开关链（与档位切换回调同纪律）
+                }
+            }
             const b = current.distillBudgets;
             const budgetNote = (b.extract || b.dedup || b.l2 || b.l3)
                 ? `，输出预算=抽取 ${b.extract || '默认'}/去重 ${b.dedup || '默认'}/L2 ${b.l2 || '默认'}/L3 ${b.l3 || '默认'}`
@@ -226,6 +237,12 @@ export function registerLiveSettings(ctx, logger) {
         },
         get: () => inner.get(),
         update: (patch) => inner.update(patch),
+        onChange: (cb) => {
+            changeCbs.add(cb);
+            return () => {
+                changeCbs.delete(cb);
+            };
+        },
     };
 }
 /** scope.get() 的防御性解析：异常值回退全开（宁可多记不可静默停摆）。 */

package/dist/tui.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TUI 形态原生接入（dsh-tui / 官方 TUI 宿主）——软探测、静默降级，绝不拖垮宿主。
+ *
+ * 接缝出处：dsh-ecosystem-spec《终端交互生态插件准入与开发指南》（dsh-TUI 生态）。
+ * web/headless profile 缺这些服务时全部 no-op；服务形状走内联结构类型，不引
+ * 第三方包依赖（与 sessions/connection 的鸭子探测同款纪律——tsc 抓不到运行时
+ * 漂移，升级 dsh-tui 后须真机复验）。
+ * - tuiSettingsSections：/settings 声明式设置区块（settings 命名空间 dsh-memory 的编辑面）；
+ * - tuiStatus：提示框上方键控状态行（当前会话记忆档位；清理是调用者责任，挂 ctx.effect）；
+ * - tuiDialogs：托管单选弹窗（/memory 无参数时的档位选择）；
+ * - commands（dsh-base 服务，全形态存在）：/memory 命令——TUI/web 均可派发，headless 无 UI 自然闲置。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { LiveSettingsHandle } from './settings.js';
+import type { SessionModeStore } from './store/session-modes.js';
+import type { MemoryLogger } from './types.js';
+export interface TuiSurfaceDeps {
+    logger: MemoryLogger;
+    live: LiveSettingsHandle;
+    modes: SessionModeStore;
+}
+export declare function registerTuiSurface(ctx: Context, deps: TuiSurfaceDeps): void;

package/dist/tui.js

@@ -0,0 +1,201 @@
+import { EFFORT_CHOICES } from './config.js';
+import { errDetail } from './util/filelog.js';
+/** 状态行/命令回显的档位短名（与 web 芯片「记忆 · 智能」同口径）。 */
+const MODE_LABEL = { auto: '智能', chat: '对话', work: '工作', off: '暂停' };
+/**
+ * 单服务的「现在挂 + internal/service 补挂」：服务晚于本插件就绪（行序 ≠ 发布序）
+ * 或换实例时自动重挂；下线即摘。fiber 卸载统一清理（disposer 指向已死服务时吞错）。
+ */
+function watchService(ctx, name, attach, logger) {
+    let disposer;
+    let bound;
+    const up = () => {
+        const svc = ctx.get?.(name);
+        if (!svc || svc === bound)
+            return;
+        try {
+            const d = attach(svc);
+            if (!d)
+                return;
+            // 换实例摘旧：旧 disposer 可能指向已死服务，吞错不阻断新挂接
+            try {
+                disposer?.();
+            }
+            catch {
+                // 旧服务所在宿主行已先一步卸载
+            }
+            disposer = d;
+            bound = svc;
+        }
+        catch (err) {
+            logger.warn(`[memory] TUI 接缝 ${name} 挂接失败（忽略）: ${errDetail(err)}`);
+        }
+    };
+    const down = () => {
+        try {
+            disposer?.();
+        }
+        catch {
+            // 服务所在宿主行已先一步卸载，残留引用调用必抛——吞掉
+        }
+        disposer = undefined;
+        bound = undefined;
+    };
+    up();
+    ctx.on('internal/service', (n, impl) => {
+        if (n !== name)
+            return;
+        if (impl)
+            up();
+        else if (bound)
+            down();
+    });
+    ctx.effect(() => () => down());
+}
+export function registerTuiSurface(ctx, deps) {
+    const { logger, live, modes } = deps;
+    // ── 状态行：当前会话的记忆档位（TUI 单活动 agent；agent/session-start 覆盖
+    //    /new、/resume、rewind 全部切换路径） ──
+    let lastSid = '';
+    let lastText = '';
+    let refreshStatus;
+    const statusText = () => {
+        if (!live.get().enabled)
+            return '记忆:停用';
+        return `记忆:${MODE_LABEL[modes.get(lastSid)]}`;
+    };
+    watchService(ctx, 'tuiStatus', (svc) => {
+        const status = svc;
+        refreshStatus = () => {
+            const text = statusText();
+            if (text === lastText)
+                return;
+            lastText = text;
+            // 第三参 identity（插件 ctx）只喂 dsh-tui 的效果台账归属（C-060），省略记 undeclared
+            status.set('memory', text, ctx);
+        };
+        refreshStatus();
+        logger.info('[memory] TUI 状态行已接入（当前会话记忆档位可见）');
+        return () => {
+            refreshStatus = undefined;
+            lastText = '';
+            try {
+                // 本插件独占该 key，显式清行与保留 set() 返回的 disposer 语义等价（后者只清
+                // 自己那次写——这里没有并发写者，选更直白的一种）
+                status.set('memory', undefined);
+            }
+            catch {
+                // 宿主行已卸载
+            }
+        };
+    }, logger);
+    ctx.on('agent/session-start', (payload) => {
+        const sid = String(payload?.agent?.id ?? '');
+        if (!sid || sid === lastSid)
+            return;
+        lastSid = sid;
+        refreshStatus?.();
+    });
+    // 全局开关在 /settings 里被改动 → 状态行即时跟随（否则「记忆:停用」读数要等下次交互才刷新）
+    const unsubscribeLive = live.onChange?.(() => refreshStatus?.());
+    if (unsubscribeLive)
+        ctx.effect(() => () => unsubscribeLive());
+    // ── /memory 命令：切当前会话档位；无参数时 TUI 环境弹托管单选 ──
+    const MODE_OPTIONS = [
+        { id: 'auto', label: '智能', description: '按会话类型自动选 chat/work 族' },
+        { id: 'chat', label: '对话', description: '用户画像与偏好（chat 族）' },
+        { id: 'work', label: '工作', description: '团队操作准则（work 族）' },
+        { id: 'off', label: '暂停', description: '本会话停用记忆，可随时切回' },
+    ];
+    const MODE_USAGE = '用法：/memory <auto|chat|work|off>';
+    watchService(ctx, 'commands', (svc) => {
+        const commands = svc;
+        const dispose = commands.register({
+            name: 'memory',
+            description: '切换本会话记忆档位（auto/chat/work/off，无参数弹出选择）',
+            handler: async (inv) => {
+                // 宿主侧 Agent 身份契约是 id（见 CommandsLike 注释）；sessionId 仅作兜底
+                const agentId = inv.agent ?? {};
+                const sid = String(agentId.id ?? agentId.sessionId ?? '');
+                if (!sid)
+                    return { kind: 'error', text: '无法确定当前会话' };
+                const arg = inv.rawInput.trim().toLowerCase();
+                let mode = ['auto', 'chat', 'work', 'off'].includes(arg)
+                    ? arg
+                    : undefined;
+                if (!mode) {
+                    const dialogs = ctx.get?.('tuiDialogs');
+                    if (!dialogs)
+                        return { kind: 'error', text: MODE_USAGE };
+                    const picked = await dialogs.select(ctx, {
+                        title: '记忆档位',
+                        options: MODE_OPTIONS,
+                        timeoutMs: 60_000,
+                        signal: inv.signal,
+                    });
+                    if (!picked)
+                        return { kind: 'success', text: '已取消（档位未变）' };
+                    mode = picked;
+                }
+                const old = modes.get(sid);
+                // ADR-0003 切换链（切走落袋/off 挂起/切回恢复）随 onModeChange 回调自动走
+                modes.set(sid, mode);
+                lastSid = sid;
+                refreshStatus?.();
+                logger.info(`[memory] /memory 切档 session=${sid} ${old}→${mode}`);
+                return { kind: 'success', text: `记忆档位：${MODE_LABEL[old]} → ${MODE_LABEL[mode]}（本会话）` };
+            },
+        });
+        logger.info('[memory] /memory 命令已注册（会话档位切换）');
+        return dispose;
+    }, logger);
+    // ── /settings 设置区块：dsh-memory 命名空间的声明式编辑面（渲染/草稿/保存
+    //    全由 TUI 宿主负责；复杂嵌套键如路由链仍走 YAML/web 面板） ──
+    watchService(ctx, 'tuiSettingsSections', (svc) => {
+        const sections = svc;
+        const dispose = sections.register({
+            ns: 'dsh-memory',
+            title: 'Layered Memory',
+            descriptions: { zh: '分层蒸馏记忆' },
+            fields: [
+                { path: ['enabled'], label: 'Master switch', descriptions: { zh: '总开关（关闭即全停）' }, kind: 'boolean' },
+                { path: ['capture'], label: 'Capture', descriptions: { zh: '捕获（L0 对话留档）' }, kind: 'boolean' },
+                { path: ['distill'], label: 'Distill', descriptions: { zh: '蒸馏（L1~L3 记忆整理）' }, kind: 'boolean' },
+                { path: ['recall'], label: 'Recall injection', descriptions: { zh: '召回注入' }, kind: 'boolean' },
+                {
+                    path: ['reasoningEffort'],
+                    label: 'Distill reasoning effort',
+                    descriptions: { zh: '蒸馏思考档位' },
+                    kind: 'select',
+                    options: EFFORT_CHOICES.map((e) => ({ value: e, label: e === '' ? 'follow config' : e })),
+                },
+                {
+                    path: ['distillProvider'],
+                    label: 'Distill provider',
+                    descriptions: { zh: '蒸馏模型供应商' },
+                    kind: 'text',
+                    hint: 'Empty = follow default model',
+                    hintDescriptions: { zh: '留空跟随默认模型' },
+                },
+                {
+                    path: ['distillModel'],
+                    label: 'Distill model',
+                    descriptions: { zh: '蒸馏模型' },
+                    kind: 'text',
+                    hint: 'Empty = follow default model',
+                    hintDescriptions: { zh: '留空跟随默认模型' },
+                },
+                {
+                    path: ['distillMaxInputChars'],
+                    label: 'Distill input budget',
+                    descriptions: { zh: '蒸馏输入预算（字符）' },
+                    kind: 'number',
+                    hint: '0 = default',
+                    hintDescriptions: { zh: '0 = 默认' },
+                },
+            ],
+        });
+        logger.info('[memory] TUI 设置区块已注册（/settings · 分层蒸馏记忆）');
+        return dispose;
+    }, logger);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-layered-memory",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "L0~L3 分层蒸馏记忆插件 for DeepSeek Harness：自动捕获对话（L0）、抽取原子记忆（L1）、整合场景块（L2）、蒸馏核心画像/团队方法论（L3），并在模型步骤前自动召回注入。移植自 MemoryCore (TencentDB Agent Memory) 的管线设计。",
   "type": "module",
   "main": "dist/index.js",