dsh-layered-memory 0.8.4 → 0.8.5

package/dist/prompts/l1-extraction.js

@@ -291,7 +291,7 @@ metadata 字段说明：
 
 请严格按上述 JSON 数组格式输出，不要输出任何额外的 Markdown 代码块修饰符（如 \`\`\`json）或解释文本。`;
 export const EXTRACT_ALL_MEMORIES_SYSTEM_PROMPT = `你是专业的"情境切分与记忆提取专家"。
-你的任务是分析用户的对话，判断情境切换，并从中提取结构化的核心记忆。对话可能同时包含个人生活与工作内容：个人内容提取为个人记忆（persona/episodic/instruction），工作内容提取为团队共享工作记忆（work_fact/work_task/work_method/work_artifact），互不排斥、按内容归族。
+你的任务是分析用户的对话，判断情境切换，并从中提取结构化的核心记忆。对话可能同时包含个人生活与工作内容：个人内容提取为个人记忆（persona/episodic/instruction），工作内容提取为团队共享工作记忆（work_fact/work_task/work_method/work_artifact），互不排斥、**每条记忆显式输出 family 字段标注归族**。
 
 **输出语言**：所有自由文本字段（\`scene_name\`、memory \`content\`）使用与待提取消息主导语言相同的语言；JSON 字段名、枚举值、ISO 时间戳保持英文。
 
@@ -318,7 +318,14 @@ export const EXTRACT_ALL_MEMORIES_SYSTEM_PROMPT = `你是专业的"情境切分
 
 【支持提取的七类记忆】（必须严格遵守类型规则）
 
-**个人三类（对话涉及用户个人生活/偏好/对 AI 的要求时）：**
+**归族判定（family）——先定族，再选型：**
+每条记忆都必须显式输出 "family": "chat" 或 "family": "work"，判定**只看语境，不看内容形状**：
+- **work**：内容发生在职业语境——项目、团队、系统、业务、客户、同事协作、部署/开发/运维；
+- **chat**：内容发生在用户个人生活语境——家庭、宠物、健康、消费、学习、爱好、个人行程与安排；
+- **形状词（方案/安排/计划/SOP/频率/周期/规则）不决定 family**：个人的喂养计划、健身安排、用药周期、家庭事务流程都是 chat；只有职业团队语境下的方案流程才是 work。
+- **family 决定 type 的可选词表，不许交叉**：family 为 chat 的记忆 type 只能是 persona/episodic/instruction；family 为 work 的记忆 type 只能是 work_fact/work_task/work_method/work_artifact。
+
+**个人三类（family: "chat"，对话涉及用户个人生活/偏好/对 AI 的要求时）：**
 
 1. 个性化记忆 (type: "persona")
    - 定义：用户的稳定属性、偏好、技能、价值观、习惯（如住所、职业、饮食禁忌）。
@@ -327,6 +334,7 @@ export const EXTRACT_ALL_MEMORIES_SYSTEM_PROMPT = `你是专业的"情境切分
 
 2. 客观事件记忆 (type: "episodic")
    - 定义：客观发生的动作、决定、计划或达成结果。绝不包含纯主观感受。
+   - **持续生效的个人安排/规则也属此类**：喂养频率、驱虫/疫苗周期、用药安排、定期事务等长期个人计划，按"用户为 [对象] 确定了 [安排]"句式提取为 episodic——即使表述像"方案/周期/规则"，只要语境是个人生活就是 chat 族，**不要**因为形状像计划/方法而改用 work_* 类型。
    - 提取句式："用户（[姓名]）在 [最好是精确绝对时间] 于 [地点] [做了某事（可以包含起因、经过、结果）]"。
    - 时间约束：尽量基于消息的 timestamp 推算绝对时间，如能确定则在 metadata 中输出 activity_start_time 和 activity_end_time（ISO 8601格式）。
    - 打分 (priority)：80-100（重要事件/计划）；60-70（一般完整活动）；<60（琐碎事项，直接丢弃）。
@@ -336,7 +344,7 @@ export const EXTRACT_ALL_MEMORIES_SYSTEM_PROMPT = `你是专业的"情境切分
    - 提取句式："用户要求/希望 AI 以后回答时..."
    - 打分 (priority)：-1（极其严格的全局死命令）；90-100（核心行为规则）；70-80（重要要求）；<70（临时要求，直接丢弃）。
 
-**工作四类（对话涉及项目、任务、团队协作时，默认可在项目团队内共享）：**
+**工作四类（family: "work"，对话涉及项目、任务、团队协作时，默认可在项目团队内共享）：**
 
 4. 工作事实 (type: "work_fact")
    - 定义：关于项目、系统、业务、客户、需求、决策、状态、风险、约束、实验结果的事实性信息。
@@ -379,6 +387,7 @@ export const EXTRACT_ALL_MEMORIES_SYSTEM_PROMPT = `你是专业的"情境切分
       {
         "content": "完整、独立的记忆陈述（按对应类型的句式要求）",
         "type": "persona|episodic|instruction|work_fact|work_task|work_method|work_artifact",
+        "family": "chat|work",
         "priority": 80,
         "source_message_ids": ["消息ID_1", "消息ID_2"],
         "metadata": {}

package/dist/stats.d.ts

@@ -1,5 +1,6 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type MemoryConfig } from './config.js';
+import { type RecallSessionStats } from './hooks/recall.js';
 import type { RebuildController } from './pipeline/rebuild.js';
 import type { LiveSettingsHandle } from './settings.js';
 import type { L0Store } from './store/l0.js';
@@ -18,6 +19,31 @@ export interface MemoryStatusSource {
     /** L1 抽取待重试的消息条数。 */
     pending(): number;
 }
+/**
+ * 会话级统计数据源（悬浮卡信息区；index.ts 注入）。
+ * 硬规则：本端点按"打开期间 2~5s 轮询"设计，实现只允许内存注册表读取与
+ * 索引化 SQL 点查——禁止任何文件读/目录扫描（scenes.list()/persona.read()
+ * 级别的 I/O 会把每次轮询变成数十毫秒的全量读，见 slider-spec 数据策略节）。
+ */
+export interface SessionInfoSource {
+    /** 召回统计（recall.ts 注册表；未发生检索的会话返回 undefined）。 */
+    recallStats(sessionId: string): RecallSessionStats | undefined;
+    /** 蒸馏管线会话视图（runner：攒批进度/挂起切片/会话产出）。 */
+    runnerView(sessionId: string, mode: string): {
+        pendingSlice: number;
+        parkedSlices: number;
+        threshold: number | null;
+        producedRecords: number;
+        lastDistillAt: number | null;
+    };
+    /** L0 该会话已捕获消息数（索引 COUNT）。 */
+    l0Count(sessionId: string): Promise<number>;
+    /** 检索能力位（hybrid / keyword 降级判定）。 */
+    capabilities(): {
+        ftsSearch: boolean;
+        vectorSearch: boolean;
+    };
+}
 export interface MemoryStats {
     ok: boolean;
     dataDir: string;
@@ -50,4 +76,4 @@ export declare function registerMemoryRpc(ctx: Context, cfg: MemoryConfig, store
     scenes: Record<MemoryFamily, SceneStore>;
     persona: Record<MemoryFamily, PersonaStore>;
     state: StateStore;
-}, logger: MemoryLogger, status?: MemoryStatusSource, live?: LiveSettingsHandle, modes?: SessionModeStore, dataDir?: string, rebuild?: RebuildController, embedManager?: EmbeddingManager): void;
+}, logger: MemoryLogger, status?: MemoryStatusSource, live?: LiveSettingsHandle, modes?: SessionModeStore, dataDir?: string, rebuild?: RebuildController, embedManager?: EmbeddingManager, sessionInfo?: SessionInfoSource): void;

package/dist/stats.js

@@ -11,12 +11,13 @@ import { closeSync, openSync, readSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { EFFORT_CHOICES, resolveDataDir } from './config.js';
 import { effectiveCfg } from './pipeline/runner.js';
+import { emptyRecallStats } from './hooks/recall.js';
 import { decideSendableEffort, LAYER_DEFAULT_BUDGETS, resolveModelEfforts, resolveModelRoute } from './llm.js';
 import { errDetail } from './util/filelog.js';
 const require = createRequire(import.meta.url);
 export const PLUGIN_VERSION = require('../package.json').version;
 /** 注册状态 RPC（web 侧 connection 服务可选，缺失时跳过，不影响插件主体）。 */
-export function registerMemoryRpc(ctx, cfg, stores, logger, status, live, modes, dataDir, rebuild, embedManager) {
+export function registerMemoryRpc(ctx, cfg, stores, logger, status, live, modes, dataDir, rebuild, embedManager, sessionInfo) {
     /** 当前是否持有一段有效注册（dispose 完成后清空，允许服务重上线时重注册）。 */
     let holding = false;
     /** 当前 handle 绑定的 connection 实例（internal/service 第二参；用于识别实例替换）。 */
@@ -43,6 +44,7 @@ export function registerMemoryRpc(ctx, cfg, stores, logger, status, live, modes,
                     logger,
                     rebuild,
                     embedManager,
+                    sessionInfo,
                 });
                 return { ok: true, value };
             }
@@ -142,7 +144,7 @@ function expectSessionId(v) {
     return v;
 }
 async function handleEndpoint(endpoint, payload, deps) {
-    const { cfg, stores, status, live, modes, dataDir, rebuild, embedManager } = deps;
+    const { cfg, stores, status, live, modes, dataDir, rebuild, embedManager, sessionInfo } = deps;
     switch (endpoint) {
         case 'dsh-memory/stats':
             return buildStats(cfg, stores, status);
@@ -166,6 +168,39 @@ async function handleEndpoint(endpoint, payload, deps) {
             deps.logger.info(`[memory] 会话档位设置 session=${sessionId} mode=${p.mode}`);
             return { sessionId, mode: p.mode };
         }
+        // ── 会话级统计（悬浮卡信息区；热路径端点，见 SessionInfoSource 的零 I/O 硬规则） ──
+        case 'dsh-memory/session-stats': {
+            if (!sessionInfo)
+                return { supported: false };
+            const p = (payload ?? {});
+            const sessionId = expectSessionId(p.sessionId);
+            const mode = modes ? modes.get(sessionId) : 'auto';
+            const caps = sessionInfo.capabilities();
+            const l0Count = await sessionInfo.l0Count(sessionId);
+            const s = live?.get();
+            const recallOn = cfg.recall.enabled && (s?.recall ?? true) && mode !== 'off';
+            const view = sessionInfo.runnerView(sessionId, mode);
+            // lastDistillAt 统一转 ISO（与 global.lastExtractAt 口径一致，client 直接 fmtAgo）
+            const distillView = { ...view, lastDistillAt: view.lastDistillAt ? new Date(view.lastDistillAt).toISOString() : null };
+            const chat = stores.state.forFamily('chat');
+            const work = stores.state.forFamily('work');
+            const lastAt = Math.max(chat.lastExtractAt, work.lastExtractAt);
+            return {
+                supported: true,
+                sessionId,
+                mode,
+                defaultMode: modes?.default ?? cfg.family,
+                recall: { enabled: recallOn, ...(sessionInfo.recallStats(sessionId) ?? emptyRecallStats()) },
+                distill: distillView,
+                l0Count,
+                retrieval: caps.vectorSearch ? (caps.ftsSearch ? 'hybrid' : 'vector') : caps.ftsSearch ? 'keyword' : 'none',
+                global: {
+                    degraded: status?.degraded() ?? false,
+                    pendingTotal: status?.pending() ?? 0,
+                    lastExtractAt: lastAt ? new Date(lastAt).toISOString() : null,
+                },
+            };
+        }
         case 'dsh-memory/settings-get': {
             const s = live?.get();
             const budgets = s?.distillBudgets ?? { extract: 0, dedup: 0, l2: 0, l3: 0 };

package/dist/store/l0.d.ts

@@ -15,6 +15,8 @@ export declare class L0Store {
     append(sessionId: string, messages: ConversationMessage[]): Promise<void>;
     /** 今日已捕获消息数（SQL 计数，不再读整文件）。 */
     countToday(): Promise<number>;
+    /** 该会话累计已捕获消息数（session-stats 数据源；索引 COUNT）。 */
+    countBySession(sessionId: string): Promise<number>;
     /** 该会话最近 n 条消息（时间升序；蒸馏背景参考用，按会话现查——ADR-0003）。 */
     recentBySession(sessionId: string, limit: number): Promise<ConversationMessage[]>;
     /** 检索：FTS + 向量 hybrid（RRF 融合），返回按相关性排序的消息。 */

package/dist/store/l0.js

@@ -104,6 +104,10 @@ export class L0Store {
         const d = new Date();
         return this.db.countL0Since(new Date(d.getFullYear(), d.getMonth(), d.getDate()).toISOString());
     }
+    /** 该会话累计已捕获消息数（session-stats 数据源；索引 COUNT）。 */
+    async countBySession(sessionId) {
+        return this.db.countL0BySession(sessionId);
+    }
     /** 该会话最近 n 条消息（时间升序；蒸馏背景参考用，按会话现查——ADR-0003）。 */
     async recentBySession(sessionId, limit) {
         return this.db.recentL0BySession(sessionId, limit);

package/dist/store/sqlite.d.ts

@@ -148,6 +148,8 @@ export declare class MemoryDb {
     countL0(): number;
     /** 统计 recorded_at >= iso 的消息数（状态面板"今日捕获"用）。 */
     countL0Since(iso: string): number;
+    /** 统计某会话已捕获消息数（session-stats 数据源；idx_l0_session_id 索引点查）。 */
+    countL0BySession(sessionId: string): number;
     /** 按会话取最近消息（时间升序返回；走 idx_l0_session_id 索引）。
      *  蒸馏背景参考专用——按会话现查替代全局内存数组（ADR-0003）。 */
     recentL0BySession(sessionId: string, limit: number): L0MessageRecord[];

package/dist/store/sqlite.js

@@ -989,6 +989,20 @@ export class MemoryDb {
             return 0;
         }
     }
+    /** 统计某会话已捕获消息数（session-stats 数据源；idx_l0_session_id 索引点查）。 */
+    countL0BySession(sessionId) {
+        if (this.degraded)
+            return 0;
+        try {
+            const row = this.db
+                .prepare('SELECT COUNT(*) AS n FROM l0_conversations WHERE session_id = ?')
+                .get(sessionId);
+            return row?.n ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
     /** 按会话取最近消息（时间升序返回；走 idx_l0_session_id 索引）。
      *  蒸馏背景参考专用——按会话现查替代全局内存数组（ADR-0003）。 */
     recentL0BySession(sessionId, limit) {

package/dist/types.d.ts

@@ -43,7 +43,15 @@ export interface ExtractedMemory {
     metadata: Record<string, unknown>;
     /** 所属情境名（L1 抽取的情境切分结果）。 */
     scene_name: string;
+    /** auto 档抽取输出的显式族判定（chat|work；纯档 Prompt 无此字段）。
+     *  语境归族、形状不归族——修复"个人计划性事实被 work_* 形状吸走"的族错标
+     *  （2026-08-23 lifecycle 赛道实测发现）。 */
+    family?: string;
 }
+/** 抽取输出的 family 字段归一：只认 chat|work，其余（缺省/非法值）交由调用方回落。 */
+export declare function normExtractedFamily(raw: unknown): MemoryFamily | undefined;
+/** 记录族三级兜底链：会话档位强制（纯档）→ 抽取显式判定（auto）→ type 前缀推导（旧输出兜底）。 */
+export declare function resolveRecordFamily(forced: MemoryFamily | undefined, extracted: unknown, type: string): MemoryFamily;
 /** L1 持久化记录（字段对齐 MemoryCore；version/source_message_ids/metadata 由写入侧补默认）。 */
 export interface MemoryRecord {
     id: string;

package/dist/types.js

@@ -5,3 +5,11 @@
 export function familyForType(type) {
     return type.startsWith('work') ? 'work' : 'chat';
 }
+/** 抽取输出的 family 字段归一：只认 chat|work，其余（缺省/非法值）交由调用方回落。 */
+export function normExtractedFamily(raw) {
+    return raw === 'chat' || raw === 'work' ? raw : undefined;
+}
+/** 记录族三级兜底链：会话档位强制（纯档）→ 抽取显式判定（auto）→ type 前缀推导（旧输出兜底）。 */
+export function resolveRecordFamily(forced, extracted, type) {
+    return forced ?? normExtractedFamily(extracted) ?? familyForType(type);
+}

package/package.json

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