dsh-prime-memory 0.21.0 → 0.22.2

package/dist/config.d.ts

@@ -90,6 +90,49 @@ export interface MemoryConfig {
          *  **0 = 不做超时降级**(显式关闭,而非"立刻全部超时")。 */
         timeoutDays: number;
     };
+    /** 轨3 memport Connect:外部记忆来源登记与只读扫描。**默认关**——
+     *  scan 仅预览(不写库)，写库仍走 memory_import；enabled 关时 memory-sources 与 memport-scan 端点均不可用。 */
+    memport: {
+        enabled: boolean;
+        /** 单源扫描记录上限(0 = 不限;仍受总护栏)。 */
+        scanMaxRecords: number;
+    };
+    /** 轨2 技能结晶(程序性记忆)。**默认关**：allowPromote 也默认关（上线先只计数不晋升，
+     *  distinct-session 达阈后才开）；injectionTier 不用 union，消费侧归一。 */
+    skills: {
+        enabled: boolean;
+        /** 开且 enabled 时，每轮 pre-step 才注入 active 技能。 */
+        inject: boolean;
+        /** candidate→active 自动晋升总闸（默认关，只计数）。 */
+        allowPromote: boolean;
+        /** 晋升需 distinct session 数。 */
+        minSessions: number;
+        /** 晋升需证据条数下限（与 minSessions 同时满足）。 */
+        minEvidence: number;
+        /** 每轮技能注入字节预算（独立于召回 2000 预算）。 */
+        maxPerTurnBytes: number;
+        /** 技能目录常驻字节预算。 */
+        maxSkillCatalogBytes: number;
+        /** excerpt 档每技能正文截断。 */
+        excerptChars: number;
+        /** active 技能闲置多少天后自动归档（0 = 不做闲置归档）。 */
+        idleArchiveDays: number;
+    };
+    /** wing 存量回填护栏（默认 300 条/120s；想一次多跑点可调大，代价是后台占用更久）。 */
+    backfill: {
+        /** 单次回填处理条数上限。 */
+        maxRecords: number;
+        /** 单次回填墙钟预算(ms)，超时剩留待再次触发。 */
+        timeBudgetMs: number;
+    };
+    /** 使用场景（G1）：抽取时产出“何时该浮现”数组落 metadata.dsh_usage_scenario。默认关，关时抽取产物逐字不变。 */
+    usageScenario: {
+        enabled: boolean;
+    };
+    /** 类型叙述模板（G2）：抽取时按 7 类型各自的“前因后果”骨架写 content。默认关，关时 prompt 逐字不变。 */
+    narrativeTemplates: {
+        enabled: boolean;
+    };
     recall: {
         enabled: boolean;
         /** 每步自动召回注入的 L1 条数。 */
@@ -203,6 +246,12 @@ export interface MemoryConfig {
         maxAlwaysOnBytes: number;
         /** 槽位正文最大字符数。 */
         maxBodyChars: number;
+        /**
+         * 旧语义迁移（默认关）：反刍收尾时，把“钉成常驻、但内容已由一条活 L1 记忆承载”的
+         * rule 槽位软退场（dropped），让那条记忆回到相关性召回而非每轮硬注入。
+         * 需用户显式授权：动的是手动建的约定，不自动生效。
+         */
+        migrateLegacy: boolean;
     };
     /** 是否注册模型可调用的记忆工具。 */
     tools: boolean;
@@ -322,6 +371,7 @@ export declare function liveSettingsSchema(): Schema<NoInfer<Schemastery.ObjectS
     embedRemoteDimensions: Schema<number, number, "defined">;
     memoryMutate: Schema<boolean, boolean, "defined">;
     conflictFreeze: Schema<boolean, boolean, "defined">;
+    skillsEnabled: Schema<boolean, boolean, "defined">;
     toolRoom: Schema<boolean, boolean, "defined">;
     toolGraph: Schema<boolean, boolean, "defined">;
     toolRuminate: Schema<boolean, boolean, "defined">;
@@ -424,6 +474,7 @@ export declare function liveSettingsSchema(): Schema<NoInfer<Schemastery.ObjectS
     embedRemoteDimensions: Schema<number, number, "defined">;
     memoryMutate: Schema<boolean, boolean, "defined">;
     conflictFreeze: Schema<boolean, boolean, "defined">;
+    skillsEnabled: Schema<boolean, boolean, "defined">;
     toolRoom: Schema<boolean, boolean, "defined">;
     toolGraph: Schema<boolean, boolean, "defined">;
     toolRuminate: Schema<boolean, boolean, "defined">;
@@ -499,6 +550,51 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         maxPending: Schema<number, number, "defined">;
         timeoutDays: Schema<number, number, "defined">;
     }>>, "plain">;
+    memport: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        scanMaxRecords: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        scanMaxRecords: Schema<number, number, "defined">;
+    }>>, "plain">;
+    skills: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        inject: Schema<boolean, boolean, "defined">;
+        allowPromote: Schema<boolean, boolean, "defined">;
+        minSessions: Schema<number, number, "defined">;
+        minEvidence: Schema<number, number, "defined">;
+        maxPerTurnBytes: Schema<number, number, "defined">;
+        maxSkillCatalogBytes: Schema<number, number, "defined">;
+        excerptChars: Schema<number, number, "defined">;
+        idleArchiveDays: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        inject: Schema<boolean, boolean, "defined">;
+        allowPromote: Schema<boolean, boolean, "defined">;
+        minSessions: Schema<number, number, "defined">;
+        minEvidence: Schema<number, number, "defined">;
+        maxPerTurnBytes: Schema<number, number, "defined">;
+        maxSkillCatalogBytes: Schema<number, number, "defined">;
+        excerptChars: Schema<number, number, "defined">;
+        idleArchiveDays: Schema<number, number, "defined">;
+    }>>, "plain">;
+    backfill: Schema<Schemastery.ObjectS<NoInfer<{
+        maxRecords: Schema<number, number, "defined">;
+        timeBudgetMs: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxRecords: Schema<number, number, "defined">;
+        timeBudgetMs: Schema<number, number, "defined">;
+    }>>, "plain">;
+    usageScenario: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, "plain">;
+    narrativeTemplates: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, "plain">;
     recall: Schema<Schemastery.ObjectS<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         maxResults: Schema<number, number, "defined">;
@@ -730,12 +826,14 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         maxSlots: Schema<number, number, "defined">;
         maxAlwaysOnBytes: Schema<number, number, "defined">;
         maxBodyChars: Schema<number, number, "defined">;
+        migrateLegacy: Schema<boolean, boolean, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         inject: Schema<boolean, boolean, "defined">;
         maxSlots: Schema<number, number, "defined">;
         maxAlwaysOnBytes: Schema<number, number, "defined">;
         maxBodyChars: Schema<number, number, "defined">;
+        migrateLegacy: Schema<boolean, boolean, "defined">;
     }>>, "plain">;
     tools: Schema<boolean, boolean, "defined">;
     benchControl: Schema<boolean, boolean, "defined">;
@@ -836,6 +934,7 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
+        skillsEnabled: Schema<boolean, boolean, "defined">;
         toolRoom: Schema<boolean, boolean, "defined">;
         toolGraph: Schema<boolean, boolean, "defined">;
         toolRuminate: Schema<boolean, boolean, "defined">;
@@ -938,6 +1037,7 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
+        skillsEnabled: Schema<boolean, boolean, "defined">;
         toolRoom: Schema<boolean, boolean, "defined">;
         toolGraph: Schema<boolean, boolean, "defined">;
         toolRuminate: Schema<boolean, boolean, "defined">;
@@ -1013,6 +1113,51 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         maxPending: Schema<number, number, "defined">;
         timeoutDays: Schema<number, number, "defined">;
     }>>, "plain">;
+    memport: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        scanMaxRecords: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        scanMaxRecords: Schema<number, number, "defined">;
+    }>>, "plain">;
+    skills: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        inject: Schema<boolean, boolean, "defined">;
+        allowPromote: Schema<boolean, boolean, "defined">;
+        minSessions: Schema<number, number, "defined">;
+        minEvidence: Schema<number, number, "defined">;
+        maxPerTurnBytes: Schema<number, number, "defined">;
+        maxSkillCatalogBytes: Schema<number, number, "defined">;
+        excerptChars: Schema<number, number, "defined">;
+        idleArchiveDays: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        inject: Schema<boolean, boolean, "defined">;
+        allowPromote: Schema<boolean, boolean, "defined">;
+        minSessions: Schema<number, number, "defined">;
+        minEvidence: Schema<number, number, "defined">;
+        maxPerTurnBytes: Schema<number, number, "defined">;
+        maxSkillCatalogBytes: Schema<number, number, "defined">;
+        excerptChars: Schema<number, number, "defined">;
+        idleArchiveDays: Schema<number, number, "defined">;
+    }>>, "plain">;
+    backfill: Schema<Schemastery.ObjectS<NoInfer<{
+        maxRecords: Schema<number, number, "defined">;
+        timeBudgetMs: Schema<number, number, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        maxRecords: Schema<number, number, "defined">;
+        timeBudgetMs: Schema<number, number, "defined">;
+    }>>, "plain">;
+    usageScenario: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, "plain">;
+    narrativeTemplates: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+    }>>, "plain">;
     recall: Schema<Schemastery.ObjectS<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         maxResults: Schema<number, number, "defined">;
@@ -1244,12 +1389,14 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         maxSlots: Schema<number, number, "defined">;
         maxAlwaysOnBytes: Schema<number, number, "defined">;
         maxBodyChars: Schema<number, number, "defined">;
+        migrateLegacy: Schema<boolean, boolean, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         inject: Schema<boolean, boolean, "defined">;
         maxSlots: Schema<number, number, "defined">;
         maxAlwaysOnBytes: Schema<number, number, "defined">;
         maxBodyChars: Schema<number, number, "defined">;
+        migrateLegacy: Schema<boolean, boolean, "defined">;
     }>>, "plain">;
     tools: Schema<boolean, boolean, "defined">;
     benchControl: Schema<boolean, boolean, "defined">;
@@ -1350,6 +1497,7 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
+        skillsEnabled: Schema<boolean, boolean, "defined">;
         toolRoom: Schema<boolean, boolean, "defined">;
         toolGraph: Schema<boolean, boolean, "defined">;
         toolRuminate: Schema<boolean, boolean, "defined">;
@@ -1452,6 +1600,7 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
+        skillsEnabled: Schema<boolean, boolean, "defined">;
         toolRoom: Schema<boolean, boolean, "defined">;
         toolGraph: Schema<boolean, boolean, "defined">;
         toolRuminate: Schema<boolean, boolean, "defined">;

package/dist/config.js

@@ -69,6 +69,8 @@ export function liveSettingsSchema() {
         memoryMutate: Schema.boolean().default(false),
         // §C 人工冲突裁决总开关:默认 false(冻结消耗注意力,不可默认全开)
         conflictFreeze: Schema.boolean().default(false),
+        // 轨2 技能结晶总开关(看板可拨):默认 false。开=注册 memory_skill_* 工具 + 注入 active 技能 + skills-* 端点可用。
+        skillsEnabled: Schema.boolean().default(false),
         // 工具分组封印(v0.21.0):false = 该组工具不注册,从模型工具列表消失。
         // 核心读(memory_search/read_scene/receipts/conversation_search)与槽位三件不受控。
         toolRoom: Schema.boolean().default(true),
@@ -129,6 +131,37 @@ export const memorySchema = Schema.object({
         // 30 天:足够跨过假期与项目间歇,又不至于让互相矛盾的两条记忆长期并列召回。
         timeoutDays: Schema.number().min(0).max(3650).default(30),
     }),
+    // 轨3 memport Connect:默认关(新功能默认关)。scan 为**只读预览**，写库仍走 memory_import。
+    memport: Schema.object({
+        enabled: Schema.boolean().default(false),
+        // 单源扫描上限（防极端大包在事件循环里阻塞 RPC；scan 是手动触发，仍留护栏）。
+        scanMaxRecords: Schema.number().min(0).max(20_000).default(5000),
+    }),
+    // 轨2 技能结晶：默认关 + allowPromote 关（先只计数不晋升）。
+    skills: Schema.object({
+        enabled: Schema.boolean().default(false),
+        inject: Schema.boolean().default(true),
+        allowPromote: Schema.boolean().default(false),
+        minSessions: Schema.number().min(1).max(100).default(3),
+        minEvidence: Schema.number().min(1).max(1000).default(5),
+        maxPerTurnBytes: Schema.number().min(0).max(8192).default(600),
+        maxSkillCatalogBytes: Schema.number().min(0).max(8192).default(2048),
+        excerptChars: Schema.number().min(0).max(4000).default(240),
+        idleArchiveDays: Schema.number().min(0).max(3650).default(90),
+    }),
+    // wing 回填护栏：默认与旧行为一致(300 条 / 120s)，需一次多跑点时调大。
+    backfill: Schema.object({
+        maxRecords: Schema.number().min(1).max(10_000).default(300),
+        timeBudgetMs: Schema.number().min(1000).max(1_800_000).default(120_000),
+    }),
+    // 使用场景（G1）：默认关；开时抽取 prompt 追加 usageScenario 指令（off 逐字不变）。
+    usageScenario: Schema.object({
+        enabled: Schema.boolean().default(false),
+    }),
+    // 类型叙述模板（G2）：默认关；开时抽取 prompt 追加分类型 content 骨架（off 逐字不变）。
+    narrativeTemplates: Schema.object({
+        enabled: Schema.boolean().default(false),
+    }),
     recall: Schema.object({
         enabled: Schema.boolean().default(true),
         maxResults: Schema.number().min(1).max(20).default(5),
@@ -221,6 +254,8 @@ export const memorySchema = Schema.object({
         maxSlots: Schema.number().min(1).max(32).default(8),
         maxAlwaysOnBytes: Schema.number().min(128).max(16_384).default(2048),
         maxBodyChars: Schema.number().min(32).max(2048).default(512),
+        // 旧 slot 语义迁移：默认关（不自动碰用户手动 pin 的常驻约定）。
+        migrateLegacy: Schema.boolean().default(false),
     }),
     tools: Schema.boolean().default(true),
     benchControl: Schema.boolean().default(false),

package/dist/conflict-service.d.ts

@@ -39,6 +39,14 @@ export interface ConflictListDeps {
     l1: Pick<L1Store, 'listConflictPending' | 'countConflictPendingUnresolved' | 'getByIds'>;
     /** `conflictFreeze.enabled`。 */
     conflictFreezeEnabled: boolean;
+    /** G3 成熟度旁注用：召回使用统计（缺省按 0 强化）。 */
+    usage?: {
+        get(id: string): {
+            used: number;
+        } | null | undefined;
+    };
+    /** 时效半衰期（天）；≤0 = 衰减关 → aging 视为 null。 */
+    decayHalfLifeDays?: number;
 }
 /**
  * 列出待裁决对。

package/dist/conflict-service.js

@@ -1,4 +1,5 @@
 import { DEFER_MAX } from './store/conflicts.js';
+import { computeMaturity } from './util/maturity.js';
 const OUTCOMES = ['winner', 'loser', 'both', 'defer'];
 function view(partial) {
     return { pair_id: '', outcome: '', resolved_at: '', removed_record_id: '', ...partial };
@@ -150,6 +151,9 @@ export function listConflictPairs(deps, opts = {}) {
     const contentById = new Map();
     // §C 三轴(conflict-3axis):记忆记录自带有效期与持续性,取出来用于裁决视图对比。
     const axisById = new Map();
+    // G3 成熟度旁注：取 priority/updatedAt 供 computeMaturity（读时派生，不落库）。
+    const priorityById = new Map();
+    const updatedAtById = new Map();
     for (const r of deps.l1.getByIds([...ids])) {
         contentById.set(r.id, r.content);
         axisById.set(r.id, {
@@ -157,8 +161,18 @@ export function listConflictPairs(deps, opts = {}) {
             validTo: (r.validTo ?? null),
             persistence: (r.persistence ?? null),
         });
+        priorityById.set(r.id, r.priority ?? 60);
+        updatedAtById.set(r.id, r.updatedAt ?? 0);
     }
     const axisOf = (id) => axisById.get(id) ?? { validFrom: null, validTo: null, persistence: null };
+    // 成熟度（priority + 被用次数 + 老化）——仅帮人工裁决看“哪条更确立”，不参与自动了结。
+    const halfLife = deps.decayHalfLifeDays ?? 0;
+    const maturityOf = (id) => {
+        const aging = halfLife > 0
+            ? Math.max(0.5, Math.pow(0.5, Math.max(0, (Date.now() - (updatedAtById.get(id) ?? 0)) / 86_400_000) / halfLife))
+            : null;
+        return computeMaturity({ priority: priorityById.get(id) ?? 60, usage: deps.usage?.get(id) ?? null, agingWeight: aging });
+    };
     const items = pending.map((p) => {
         const w = axisOf(p.winnerId);
         const l = axisOf(p.loserId);
@@ -184,6 +198,8 @@ export function listConflictPairs(deps, opts = {}) {
             // ('hard' / ''),使"旧行经 ALTER 回填"与"读取面兜底"呈现同一个形状。
             conflict_type: p.conflictType ?? 'hard',
             claim_key: p.claimKey ?? '',
+            winner_maturity: maturityOf(p.winnerId),
+            loser_maturity: maturityOf(p.loserId),
         };
     });
     return { enabled: true, total: deps.l1.countConflictPendingUnresolved(), items };
@@ -201,6 +217,7 @@ export function renderConflicts(v) {
         const vf = side === 'winner' ? p.winner_valid_from_ms : p.loser_valid_from_ms;
         const vt = side === 'winner' ? p.winner_valid_to_ms : p.loser_valid_to_ms;
         const ps = side === 'winner' ? p.winner_persistence : p.loser_persistence;
+        const mt = side === 'winner' ? p.winner_maturity : p.loser_maturity;
         const parts = [];
         const vfS = iso(vf);
         const vtS = iso(vt);
@@ -210,6 +227,8 @@ export function renderConflicts(v) {
             parts.push(`有效期止 ${vtS}`);
         if (ps)
             parts.push(`持续性 ${ps}`);
+        if (mt)
+            parts.push(`成熟度 ${mt}`);
         return parts.length ? `   三轴: ${parts.join(' / ')}` : '';
     };
     const rows = v.items.map((p, i) => {

package/dist/contract.d.ts

@@ -103,6 +103,9 @@ export interface MemoryLiveSettings {
     /** §C 人工冲突裁决总开关:true = 去重判定"两边都像对的"时冻结冲突对,停放到待人工裁决区;
      *  false = 默认,冲突按 LLM 的 winner/loser 自动了结。运行时覆盖静态 config 的 conflictFreeze.enabled。 */
     conflictFreeze: boolean;
+    /** 轨2 技能结晶总开关（看板可拨）:true = 注册 memory_skill_* 工具、注入 active 技能、skills-* 端点可用。
+     *  默认 false（新功能默认关）；与部署 cfg.skills.enabled 取或（任一开则生效）。 */
+    skillsEnabled: boolean;
 }
 /** 召回停用原因(session-stats recall.enabled=false 时带出;短路序第一个为假的因子)。 */
 export type RecallDisabledReason = 'deploy' | 'global' | 'session' | 'mode';
@@ -796,6 +799,13 @@ export interface UiRecord {
     retired?: boolean;
     /** 退场原因:`conflict`(裁决) / `superseded`(取代) / `manual`(人工) / `unknown`。未退场为 null。 */
     retiredReason?: string | null;
+    /**
+     * 成熟度(G3 读时派生):priority + 被用次数 + 老化权重合成。
+     * 可选字段——旧 client 忽略=向后兼容；不参与存储/快照（纯投影）。
+     */
+    maturity?: 'low' | 'mid' | 'high';
+    /** 使用场景（G1）：从 metadata.dsh_usage_scenario 读出；功能关/无则 undefined。 */
+    usageScenario?: string[];
 }
 export interface ListRecordsResponse {
     items: UiRecord[];
@@ -1218,6 +1228,9 @@ export interface ConflictPairView {
     loser_valid_from_ms?: number | null;
     loser_valid_to_ms?: number | null;
     loser_persistence?: string | null;
+    /** G3 成熟度旁注（读时派生，仅帮人工看“哪条更确立”，不参与自动裁决）。 */
+    winner_maturity?: 'low' | 'mid' | 'high';
+    loser_maturity?: 'low' | 'mid' | 'high';
     review_state?: 'unseen' | 'deferred';
     /** R1:复看次数(面板据此显示"已复看 N 次");达 `DEFER_MAX` 即钉子户。 */
     defer_count?: number;
@@ -1303,6 +1316,110 @@ export interface ReceiptsResponse {
     items: ReceiptItemView[];
     total: number;
 }
+/** 外部来源视图（轨3 Connect；路径指针，不含正文）。 */
+export interface MemorySourceView {
+    id: string;
+    kind: string;
+    path: string;
+    label?: string;
+    lastScanAt: string;
+    lastImportAt: string;
+    disabled: boolean;
+    status: 'active' | 'retired';
+}
+export interface MemorySourcesListResponse {
+    sources: MemorySourceView[];
+    /** 写门/启用态提示（面板据它显示“导入需开高权限”）。 */
+    memoryMutate: boolean;
+}
+export interface MemorySourcesAddRequest {
+    id: string;
+    kind: string;
+    path: string;
+    label?: string;
+}
+export interface MemorySourcesAddResponse {
+    id: string;
+    created: boolean;
+    notice: string;
+}
+export interface MemorySourcesRetireRequest {
+    id: string;
+    /** true = 恢复为 active；缺省/ false = 退役（不删数据，来源仍可重放）。 */
+    active?: boolean;
+}
+export interface MemorySourcesRetireResponse {
+    changed: boolean;
+    notice: string;
+}
+export interface MemportScanRequest {
+    /** 省略 = 扫描全部启用来源；指定 = 只扫该 id。 */
+    sourceId?: string;
+}
+export interface MemportScanCounts {
+    dup: number;
+    'near-dup': number;
+    'conflict-candidate': number;
+    new: number;
+}
+export interface MemportScanSourceResult {
+    sourceId: string;
+    label?: string;
+    /** 命中的 .mem 包数（只读，未写库）。 */
+    files: number;
+    /** 解析出的总条数（受 scanMaxRecords 上限）。 */
+    total: number;
+    /** 每包校验失败原因（不阻断其余来源）。 */
+    errors: string[];
+    counts: MemportScanCounts;
+    /** 新记录样本预览（正文截断；实际写库走 memory_import，那里才做脱敏）。 */
+    sampleNew: Array<{
+        type: string;
+        content: string;
+    }>;
+}
+export interface MemportScanResponse {
+    /** cfg.memport.enabled——关时 sources 为空并附 notice。 */
+    enabled: boolean;
+    sources: MemportScanSourceResult[];
+    notice?: string;
+}
+/** 技能摘要（轨2 SkillsTab；供人工审阅/晋升/pin/归档）。 */
+export interface SkillView {
+    id: string;
+    title: string;
+    status: 'candidate' | 'active' | 'archived';
+    tier: 'full' | 'excerpt' | 'hint';
+    pinned: boolean;
+    sessionCount: number;
+    updatedAt: string;
+}
+export interface SkillsListResponse {
+    enabled: boolean;
+    /** 自动晋升总闸（allowPromote）；关时 promote 动作会被拒。 */
+    allowPromote: boolean;
+    memoryMutate: boolean;
+    skills: SkillView[];
+}
+export interface SkillsActionRequest {
+    id: string;
+    action: 'promote' | 'archive' | 'pin' | 'unpin' | 'set-tier';
+    tier?: 'full' | 'excerpt' | 'hint';
+    reason?: string;
+}
+export interface SkillsActionResponse {
+    changed: boolean;
+    notice: string;
+}
+/** dsh-memory/session-recalled (G-live)：本会话已注入、未被压缩覆盖的召回集。 */
+export interface SessionRecalledRequest {
+    sessionId: string;
+}
+export interface SessionRecalledResponse {
+    sessionId: string;
+    /** 按召回插入序（旧→新）；复用 UiRecord（含 maturity/usageScenario）。 */
+    records: UiRecord[];
+}
 export interface DshMemoryRequestMap {
     'dsh-memory/stats': Record<string, never>;
     'dsh-memory/token-cost': TokenCostRequest;
@@ -1350,6 +1467,13 @@ export interface DshMemoryRequestMap {
     'dsh-memory/cleanup-retired': CleanupRetiredRequest;
     'dsh-memory/snapshots-list': SnapshotsListRequest;
     'dsh-memory/snapshot-restore': SnapshotRestoreRequest;
+    'dsh-memory/memory-sources-list': Record<string, never>;
+    'dsh-memory/memory-sources-add': MemorySourcesAddRequest;
+    'dsh-memory/memory-sources-retire': MemorySourcesRetireRequest;
+    'dsh-memory/memport-scan': MemportScanRequest;
+    'dsh-memory/skills-list': Record<string, never>;
+    'dsh-memory/session-recalled': SessionRecalledRequest;
+    'dsh-memory/skills-action': SkillsActionRequest;
 }
 export interface DshMemoryResponseMap {
     'dsh-memory/stats': StatsResponse;
@@ -1398,6 +1522,13 @@ export interface DshMemoryResponseMap {
     'dsh-memory/cleanup-retired': CleanupRetiredResponse;
     'dsh-memory/snapshots-list': SnapshotsListResponse;
     'dsh-memory/snapshot-restore': SnapshotRestoreResponse;
+    'dsh-memory/memory-sources-list': MemorySourcesListResponse;
+    'dsh-memory/memory-sources-add': MemorySourcesAddResponse;
+    'dsh-memory/memory-sources-retire': MemorySourcesRetireResponse;
+    'dsh-memory/memport-scan': MemportScanResponse;
+    'dsh-memory/skills-list': SkillsListResponse;
+    'dsh-memory/session-recalled': SessionRecalledResponse;
+    'dsh-memory/skills-action': SkillsActionResponse;
 }
 /** 全部端点名(client 调用与 host case 表的共用字面量来源)。 */
 export type DshMemoryEndpoint = keyof DshMemoryResponseMap;

package/dist/domain-gate.d.ts

@@ -47,3 +47,11 @@ export declare function sortByDomainWeight<T extends {
     id: string;
     score: number;
 }>(hits: readonly T[], wingOf: (id: string) => unknown, weights: Record<string, number>): T[];
+/**
+ * G1 使用场景细排(纯函数、**score 不改写**、默认关时不进此路径):
+ * 命中查询词的 usageScenario 记忆上浮；未命中/无场景的记录保持原序(fail-open)。
+ * 保守：只按“命中强度”重排，不引入新相关性判断；无查询词时原样返回。
+ */
+export declare function sortByUsageScenario<T extends {
+    id: string;
+}>(hits: readonly T[], scenariosOf: (id: string) => readonly string[], query: string): T[];

package/dist/domain-gate.js

@@ -149,3 +149,33 @@ export function sortByDomainWeight(hits, wingOf, weights) {
     };
     return [...hits].sort((a, b) => weightOf(b.id) - weightOf(a.id) || b.score - a.score);
 }
+/** 分词(小写、按非字母数字/非 CJK 切、去长度<2 的碎片)。供场景词重叠用。 */
+function normTokens(s) {
+    return new Set(s.toLowerCase().split(/[^0-9a-z\u4e00-\u9fa5]+/).map((t) => t.trim()).filter((t) => t.length >= 2));
+}
+/**
+ * G1 使用场景细排(纯函数、**score 不改写**、默认关时不进此路径):
+ * 命中查询词的 usageScenario 记忆上浮；未命中/无场景的记录保持原序(fail-open)。
+ * 保守：只按“命中强度”重排，不引入新相关性判断；无查询词时原样返回。
+ */
+export function sortByUsageScenario(hits, scenariosOf, query) {
+    const q = normTokens(query);
+    if (q.size === 0)
+        return [...hits];
+    const matchOf = (id) => {
+        let best = 0;
+        for (const s of scenariosOf(id)) {
+            let ov = 0;
+            for (const t of normTokens(s))
+                if (q.has(t))
+                    ov++;
+            if (ov > best)
+                best = ov;
+        }
+        return best;
+    };
+    return hits
+        .map((h, i) => ({ h, i, m: matchOf(h.id) }))
+        .sort((a, b) => b.m - a.m || a.i - b.i)
+        .map((x) => x.h);
+}

package/dist/graph/constraints.d.ts

@@ -13,8 +13,10 @@ export declare const GRAPH_NODE_TYPE_SET: ReadonlySet<string>;
 /** 记录生命周期四态(节点/fact/边通用)。 */
 export declare const GRAPH_STATUSES: readonly GraphRecordStatus[];
 export declare const GRAPH_STATUS_SET: ReadonlySet<string>;
-/** 规范中文关系词(提示词给枚举;校验不做白名单——关系是开放词表,只做长度钳制)。 */
-export declare const GRAPH_RELATION_WORDS: readonly ["使用", "属于", "创建", "参与", "贡献", "依赖", "位于", "相关"];
+/** 规范中文关系词(提示词给枚举;校验不做白名单——关系是开放词表,只做长度钳制)。
+ *  后四个为因果边(导致/因为/修复了/取代)——让"前因后果"跨记录成链;仅当 graph.enabled 时
+ *  才参与投影(整块图谱默认关,不碰非图谱用户的蒸馏产物)。 */
+export declare const GRAPH_RELATION_WORDS: readonly ["使用", "属于", "创建", "参与", "贡献", "依赖", "位于", "相关", "导致", "因为", "修复了", "取代"];
 /** 提案字段上限(校验侧截断/丢弃与提示词内插共用同一组数字)。 */
 export declare const GRAPH_CAP: {
     /** 提案内临时引用(ref)长度。 */

package/dist/graph/constraints.js

@@ -4,8 +4,10 @@ export const GRAPH_NODE_TYPE_SET = new Set(GRAPH_NODE_TYPES);
 /** 记录生命周期四态(节点/fact/边通用)。 */
 export const GRAPH_STATUSES = ['active', 'superseded', 'disputed', 'archived'];
 export const GRAPH_STATUS_SET = new Set(GRAPH_STATUSES);
-/** 规范中文关系词(提示词给枚举;校验不做白名单——关系是开放词表,只做长度钳制)。 */
-export const GRAPH_RELATION_WORDS = ['使用', '属于', '创建', '参与', '贡献', '依赖', '位于', '相关'];
+/** 规范中文关系词(提示词给枚举;校验不做白名单——关系是开放词表,只做长度钳制)。
+ *  后四个为因果边(导致/因为/修复了/取代)——让"前因后果"跨记录成链;仅当 graph.enabled 时
+ *  才参与投影(整块图谱默认关,不碰非图谱用户的蒸馏产物)。 */
+export const GRAPH_RELATION_WORDS = ['使用', '属于', '创建', '参与', '贡献', '依赖', '位于', '相关', '导致', '因为', '修复了', '取代'];
 /** 提案字段上限(校验侧截断/丢弃与提示词内插共用同一组数字)。 */
 export const GRAPH_CAP = {
     /** 提案内临时引用(ref)长度。 */

package/dist/hooks/recall.d.ts

@@ -20,6 +20,7 @@ import type { MemoryConfig } from '../config.js';
 import type { LiveSettingsHandle } from '../settings.js';
 import type { L1Store } from '../store/l1.js';
 import type { PersonaStore } from '../store/persona.js';
+import type { SessionRecalledStore } from '../store/session-recalled.js';
 import type { SceneStore } from '../store/scenes.js';
 import type { SessionModeStore } from '../store/session-modes.js';
 import type { RecallUsageStore } from '../store/recall-usage.js';
@@ -90,6 +91,7 @@ export declare function registerRecall(ctx: Context, cfg: MemoryConfig, stores:
     l1: L1Store;
     scenes: Record<'chat' | 'work', SceneStore>;
     persona: Record<'chat' | 'work', PersonaStore>;
+    recalled?: SessionRecalledStore;
 }, logger: MemoryLogger, live: LiveSettingsHandle, modes: SessionModeStore, dataDir: string, 
 /** 召回使用统计(可选;未装配 = 零成本旁路):进 topN(注入)才算 used。 */
 usage?: RecallUsageStore): RecallHooks;