dsh-prime-memory 0.20.0-beta.2 → 0.20.0-beta.21

package/dist/config.d.ts

@@ -76,22 +76,6 @@ export interface MemoryConfig {
          *  同时为真才执行;图谱是 L1 的可重建投影,关闭不影响记忆主链路。 */
         enabled: boolean;
     };
-    /** 长任务模式:浮动面板(非阻断建议)+ 尾部 turn 压缩 + todo 参考。
-     *  **默认关**——浮动 UI 与额外蒸馏都消耗注意力/额度,由用户显式打开。 */
-    longTask: {
-        /** 总开关:关闭时监听器不注册、RPC 返回 enabled:false、面板不挂载。 */
-        enabled: boolean;
-        /** 上下文占用告警阈值(% 窗口):最近一轮官方输入侧 token 达到该比例,
-         *  且长任务未开启时,浮动面板建议开启(压缩灾难遗忘高风险区)。 */
-        contextThresholdPct: number;
-        /** todo 漂移阈值:相邻 todo/write 快照的词面 Jaccard 相似度低于
-         *  (1 - 该值) 视为"大幅漂移"。0.6 = 相似度不足 0.4。 */
-        driftThreshold: number;
-        /** 尾部压缩一次覆盖的最近轮数。 */
-        tailTurns: number;
-        /** 达到上下文阈值时自动执行尾部压缩(无需按压面板;长任务开启才生效)。 */
-        autoCompress: boolean;
-    };
     /** §C 矛盾冻结:去重判定"两边都像是对的、机器判不了"时不自动裁决,
      *  把冲突对停放到待人工裁决区(conflict_pending)。**默认关**——
      *  冻结消耗人的注意力,不可默认全开。 */
@@ -337,19 +321,6 @@ export declare function liveSettingsSchema(): Schema<NoInfer<Schemastery.ObjectS
     embedRemoteModel: Schema<string, string, "defined">;
     embedRemoteDimensions: Schema<number, number, "defined">;
     memoryMutate: Schema<boolean, boolean, "defined">;
-    longTask: Schema<Schemastery.ObjectS<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: Schema<boolean, boolean, "defined">;
 }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
     enabled: Schema<boolean, boolean, "defined">;
@@ -447,19 +418,6 @@ export declare function liveSettingsSchema(): Schema<NoInfer<Schemastery.ObjectS
     embedRemoteModel: Schema<string, string, "defined">;
     embedRemoteDimensions: Schema<number, number, "defined">;
     memoryMutate: Schema<boolean, boolean, "defined">;
-    longTask: Schema<Schemastery.ObjectS<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: Schema<boolean, boolean, "defined">;
 }>>>, "volatile">;
 export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
@@ -522,19 +480,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
     }>>, "plain">;
-    longTask: Schema<Schemastery.ObjectS<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: Schema<Schemastery.ObjectS<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         maxPending: Schema<number, number, "defined">;
@@ -880,19 +825,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteModel: Schema<string, string, "defined">;
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
-        longTask: Schema<Schemastery.ObjectS<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
@@ -990,19 +922,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteModel: Schema<string, string, "defined">;
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
-        longTask: Schema<Schemastery.ObjectS<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
     }>>>, "volatile">;
 }>>, Schemastery.ObjectT<NoInfer<{
@@ -1065,19 +984,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
     }>>, "plain">;
-    longTask: Schema<Schemastery.ObjectS<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: Schema<boolean, boolean, "defined">;
-        contextThresholdPct: Schema<number, number, "defined">;
-        driftThreshold: Schema<number, number, "defined">;
-        tailTurns: Schema<number, number, "defined">;
-        autoCompress: Schema<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: Schema<Schemastery.ObjectS<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
         maxPending: Schema<number, number, "defined">;
@@ -1423,19 +1329,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteModel: Schema<string, string, "defined">;
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
-        longTask: Schema<Schemastery.ObjectS<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         enabled: Schema<boolean, boolean, "defined">;
@@ -1533,19 +1426,6 @@ export declare const memorySchema: Schema<Schemastery.ObjectS<NoInfer<{
         embedRemoteModel: Schema<string, string, "defined">;
         embedRemoteDimensions: Schema<number, number, "defined">;
         memoryMutate: Schema<boolean, boolean, "defined">;
-        longTask: Schema<Schemastery.ObjectS<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: Schema<boolean, boolean, "defined">;
-            contextThresholdPct: Schema<number, number, "defined">;
-            driftThreshold: Schema<number, number, "defined">;
-            tailTurns: Schema<number, number, "defined">;
-            autoCompress: Schema<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: Schema<boolean, boolean, "defined">;
     }>>>, "volatile">;
 }>>, "plain">;

package/dist/config.js

@@ -68,13 +68,6 @@ export function liveSettingsSchema() {
         // 记忆写删权限门:默认 false(模型写删风险高,须显式在面板开启高权限模式)
         memoryMutate: Schema.boolean().default(false),
         // §C 人工冲突裁决总开关:默认 false(冻结消耗注意力,不可默认全开)
-        longTask: Schema.object({
-            enabled: Schema.boolean().default(false),
-            contextThresholdPct: Schema.number().min(10).max(95).default(70),
-            driftThreshold: Schema.number().min(0.1).max(1).default(0.6),
-            tailTurns: Schema.number().min(1).max(50).default(6),
-            autoCompress: Schema.boolean().default(false),
-        }),
         conflictFreeze: Schema.boolean().default(false),
     }).volatile();
 }
@@ -120,20 +113,7 @@ export const memorySchema = Schema.object({
     graph: Schema.object({
         enabled: Schema.boolean().default(false),
     }),
-    // §C 矛盾冻结:默认关(新功能默认关)。开启后去重决策词表多出 conflict 动作,
-    // 冲突对停放待人工裁决,不再由 LLM 直接 update/merge 覆盖。
-    longTask: Schema.object({
-        // 总开关:关闭时监听器不注册、建议面板不挂载(部署级上限)。
-        enabled: Schema.boolean().default(false),
-        // 上下文占用告警阈值(%,官方输入侧 / 模型窗口)。
-        contextThresholdPct: Schema.number().min(10).max(95).default(70),
-        // todo 漂移阈值:Jaccard 相似度低于 (1 - driftThreshold) 视为大幅漂移。
-        driftThreshold: Schema.number().min(0.1).max(1).default(0.6),
-        // 尾部压缩一次覆盖的最近轮数。
-        tailTurns: Schema.number().min(1).max(50).default(6),
-        // 跨阈值自动尾部压缩(长任务开启才生效)。
-        autoCompress: Schema.boolean().default(false),
-    }),
+    // §C 矛盾冻结:默认关。开启后去重决策词表多出 conflict 动作,冲突对停放待人工裁决。
     conflictFreeze: Schema.object({
         enabled: Schema.boolean().default(false),
         // 上限给"人会看"留出余量:100 条待裁决 ≈ 连续 5~20 轮蒸馏全在冲突,

package/dist/contract.d.ts

@@ -456,14 +456,11 @@ export interface SessionModeGetResponse {
     hallIncludeUnlabeled: boolean;
     /** 锁定域边界开关:跨域兜底 general 是否参与召回(默认不含)。 */
     hallIncludeGeneral: boolean;
-    /** 长任务模式(浮动面板切换;尾部 turn 压缩与 todo 参考仅在开启时可用)。 */
-    longTask: boolean;
 }
 export interface SessionModeSetRequest {
     sessionId: string;
-    /** 档位。**与 longTask 二选一必传**:纯切档传 mode,只切长任务开关传 longTask
-     *  (mode 缺省时不触碰档位——浮动面板切开关不能顺带重置用户档位)。 */
-    mode?: MemoryMode;
+    /** 档位(必传)。 */
+    mode: MemoryMode;
     /** 会话级注入覆盖:布尔 = 设置覆盖;显式 null = 清除(跟随全局);缺省 = 不动
      *  (旧 client 纯切档兼容,覆盖不丢)。mode 与 recall 可独立设置。 */
     recall?: boolean | null;
@@ -475,8 +472,6 @@ export interface SessionModeSetRequest {
     /** 锁定域边界开关(缺省 = 不动)。 */
     hallIncludeUnlabeled?: boolean;
     hallIncludeGeneral?: boolean;
-    /** 长任务模式:布尔 = 切换(关闭时服务端同步撤下 todo 参考槽位);缺省 = 不动。 */
-    longTask?: boolean;
 }
 export interface SessionModeSetResponse {
     sessionId: string;
@@ -490,50 +485,6 @@ export interface SessionModeSetResponse {
     halls: string[];
     hallIncludeUnlabeled: boolean;
     hallIncludeGeneral: boolean;
-    /** 设置后的长任务态。 */
-    longTask: boolean;
-}
-/** dsh-memory/longtask-hint-get | 长任务建议状态(浮动面板轮询;热路径:全内存读)。 */
-export interface LongTaskHintGetRequest {
-    sessionId: string;
-}
-export interface LongTaskHintGetResponse {
-    sessionId: string;
-    /** 部署总开关(cfg.longTask.enabled):false 时面板不应挂载。 */
-    enabled: boolean;
-    /** 会话长任务态。 */
-    longTask: boolean;
-    /** 上下文占用百分比(最近官方输入侧 / 模型窗口;无样本或窗口未知 = null)。 */
-    contextPct: number | null;
-    contextThresholdPct: number;
-    /** 最近一次 todo 快照漂移度(无快照 = null)。 */
-    drift: number | null;
-    driftThreshold: number;
-    /** 最新 todo 快照条目数。 */
-    todoCount: number;
-    /** 非阻断建议:达到任一阈值且长任务未开启。 */
-    suggest: boolean;
-    reasons: Array<'context-threshold' | 'todo-drift'>;
-    /** 尾部压缩一次覆盖的轮数(cfg)。 */
-    tailTurns: number;
-    /** 已压缩水位线(null = 从未压缩)。 */
-    lastTailCompressedTurn: number | null;
-    /** 水位线之上、可压缩的已捕获轮数(长任务关闭时 null)。 */
-    pendingTailTurns: number | null;
-}
-/** dsh-memory/longtask-compress-tail | 尾部 turn 压缩(强制蒸馏最近 N 轮入记忆)。 */
-export interface LongTaskCompressTailRequest {
-    sessionId: string;
-    /** 覆盖 cfg.longTask.tailTurns(≤50)。 */
-    turns?: number;
-}
-export interface LongTaskCompressTailResponse {
-    sessionId: string;
-    /** 实际入队蒸馏的消息条数(0 = 无可压轮/长任务未开启)。 */
-    enqueued: number;
-    fromTurn: number | null;
-    toTurn: number | null;
-    longTask: boolean;
 }
 /** dsh-memory/wing-overview(八边形角计数;WingWheel 打开时拉取,非热路径)。 */
 export interface WingOverviewResponse {
@@ -557,10 +508,91 @@ export interface WingOverviewResponse {
  * 降级/无 tags 时 `rooms` 为空数组(面板显示"暂无"),不报错。
  */
 export interface RoomsGetResponse {
-    /** Room 列表(按记录数降序,同数按名升序)。 */
+    /** Room 列表(按记录数降序,同数按名升序;注册表条目 count=0 并带 source/label)。
+     *  条目可选字段 source/label 由端点层合并注册表后附带(客户端可选读,零断裂)。 */
     rooms: RoomCount[];
     /** Room 总数(= rooms.length,冗余只为前端少写一次 .length)。 */
     total: number;
+    /** 孤儿记忆数:没有任何 Room(tags 为空/缺失)的记录条数(与 rooms 同口径含已退场)。 */
+    orphanCount: number;
+    /** 注册表条目(全量含 retired;分类管理面板用;未装配 = undefined)。 */
+    registry?: Array<{
+        slug: string;
+        label?: string;
+        description?: string;
+        source: 'pre-registered' | 'grown';
+        aliases?: string[];
+        status: 'active' | 'retired';
+    }>;
+}
+/** dsh-memory/room-register(预注册 Room;高权限:面板 memoryMutate 开启才生效)。 */
+export interface RoomRegisterRequest {
+    slug: string;
+    label?: string;
+    description?: string;
+    /** 收编自生长 slug 时传 grown(缺省 pre-registered;已存在条目忽略此字段)。 */
+    source?: 'pre-registered' | 'grown';
+}
+export interface RoomRegisterResponse {
+    slug: string;
+    created: boolean;
+    /** 幂等补全时的提示(如「已存在,只补全缺失字段」)。 */
+    notice?: string;
+}
+/** dsh-memory/rooms-export(分类数据导出,CSV 直出)。 */
+export interface RoomsExportRequest {
+    /** rooms = 词表+计数;orphans = 无 Room 绑定的记录清单;records = 按 Room 的记录清单(tag 必传)。 */
+    kind: 'rooms' | 'orphans' | 'records';
+    /** 各 kind 通用上限(1..10000,默认 2000)。 */
+    limit?: number;
+    /** kind=records 的目标 Room slug。 */
+    tag?: string;
+}
+export interface RoomsExportResponse {
+    kind: 'rooms' | 'orphans' | 'records';
+    /** CSV 文本(首行表头;
+   行尾;RFC 4180 转义)。 */
+    csv: string;
+    /** 数据行数(不含表头)。 */
+    total: number;
+    /** truncated = 达到 limit 上限,结果可能不完整。 */
+    truncated: boolean;
+}
+/** dsh-memory/room-admin(Room 破坏性面管理;高权限:面板 memoryMutate 开启才生效)。 */
+export interface RoomAdminRequest {
+    /** merge/rename:from→to(mergeRoom/renameRoom 编排:预览→实跑+自动备份+入队场景重算);retire:slug 退役/恢复;update:改写 label/description。 */
+    action: 'merge' | 'rename' | 'retire' | 'update';
+    /** update 的显示名(可中文;非空才改写)。 */
+    label?: string;
+    /** update 的归类说明(喂标注器;非空才改写)。 */
+    description?: string;
+    /** merge/rename 的源 Room slug。 */
+    from?: string;
+    /** merge/rename 的目标 Room slug。 */
+    to?: string;
+    /** retire 的目标 Room slug。 */
+    slug?: string;
+    /** retire:true=恢复 active;缺省/false=退役。 */
+    active?: boolean;
+    /** retire:同时把该 room 下全部**活跃**记录退场(软删,可在「已退场」区恢复)。 */
+    withRecords?: boolean;
+    /** merge/rename:缺省 true 只返预览;实跑需显式 false。 */
+    dryRun?: boolean;
+}
+export interface RoomAdminResponse {
+    notice: string;
+    /** merge/rename 本次是否 dryRun(预览)。 */
+    dryRun?: boolean;
+    /** merge/rename 影响的记录条数(实跑 = 已改写条数)。 */
+    affected?: number;
+    /** 预览样例(受影响记录 id 的前几条)。 */
+    preview?: string[];
+    /** true = 超过单次上限,需续跑。 */
+    hasMore?: boolean;
+    /** 实跑时改写前备份文件名(rooms-merge-backups/)。 */
+    backupFile?: string;
+    /** retire withRecords 实际退场的记录条数(软删,可恢复)。 */
+    retiredRecords?: number;
 }
 /** dsh-memory/wing-backfill(一键回填,后台任务;端点立即返回,进度以 wing-overview 轮询)。 */
 export interface WingBackfillResponse {
@@ -700,6 +732,11 @@ export interface ListRecordsRequest {
      * Room 由 tags 派生(自生长),故这里传的是**具体 tag 名**而非枚举 id。
      */
     tag?: string;
+    /**
+     * 孤儿记忆筛选:true = 只列**没有任何 Room(tags 为空/缺失)**的记录。
+     * 与 `tag` 互斥;同传时 `tag` 优先(客户端保证不同传)。
+     */
+    untagged?: boolean;
     /**
      * 退场(软删)筛查:三态。省略 = 全部(活跃+已退场混排,靠 `UiRecord.retired`
      * 徽标区分);`false` = 仅活跃;`true` = 仅已退场。
@@ -736,6 +773,15 @@ export interface UiRecord {
     sourceAnchors: string[];
     /** 检索相关度(列表路径无 score → null)。 */
     score: number | null;
+    /** 老化权重:读路径衰减系数 max(0.5, 0.5^(Δ天/半衰期))(Δ=updatedAt;半衰期 0=关 → null)。 */
+    agingWeight?: number | null;
+    /** 召回使用统计:**进 topN(被注入)才算 used**;参与尝试未进 = 仅 attempts。缺省 = 未装配。 */
+    usage?: {
+        attempts: number;
+        used: number;
+        lastAttemptAt: number | null;
+        lastUsedAt: number | null;
+    } | null;
     /**
      * 是否已退场(软删)。`true` 时该记录在活动列表里仍以「已退场」态呈现(置灰 + 徽标),
      * 可被 `records-restore` 找回——这正是设计要的「不静默消失、可恢复」,而非真删。
@@ -754,6 +800,13 @@ export interface ListRecordsResponse {
     truncated: boolean;
     /** 场景筛选下拉选项(仅 offset===0 时附带)。 */
     scenes?: string[];
+    /** 召回使用汇总(老化权重效果口径:进 topN 才算 used)。未装配 = undefined。 */
+    usageSummary?: {
+        tracked: number;
+        attempted: number;
+        used: number;
+        rate: number;
+    } | null;
     /**
      * Wing 词表(R8 单一事实源:服务端随 list-records 下发,client 不再手抄;仅 offset===0 时附带)。
      * 含 8 角 + `general`(跨域兜底,存量大 reserved 值仍可筛)。缺省(旧服务端)时 client
@@ -1249,10 +1302,11 @@ export interface DshMemoryRequestMap {
     'dsh-memory/token-cost': TokenCostRequest;
     'dsh-memory/session-mode-get': SessionModeGetRequest;
     'dsh-memory/session-mode-set': SessionModeSetRequest;
-    'dsh-memory/longtask-hint-get': LongTaskHintGetRequest;
-    'dsh-memory/longtask-compress-tail': LongTaskCompressTailRequest;
     'dsh-memory/wing-overview': Record<string, never>;
     'dsh-memory/rooms-get': Record<string, never>;
+    'dsh-memory/rooms-export': RoomsExportRequest;
+    'dsh-memory/room-register': RoomRegisterRequest;
+    'dsh-memory/room-admin': RoomAdminRequest;
     'dsh-memory/wing-backfill': Record<string, never>;
     'dsh-memory/session-stats': SessionStatsRequest;
     'dsh-memory/settings-get': Record<string, never>;
@@ -1295,11 +1349,12 @@ export interface DshMemoryResponseMap {
     'dsh-memory/stats': StatsResponse;
     'dsh-memory/token-cost': TokenCostResponse;
     'dsh-memory/session-mode-get': SessionModeGetResponse;
-    'dsh-memory/longtask-hint-get': LongTaskHintGetResponse;
-    'dsh-memory/longtask-compress-tail': LongTaskCompressTailResponse;
     'dsh-memory/session-mode-set': SessionModeSetResponse;
     'dsh-memory/wing-overview': WingOverviewResponse;
     'dsh-memory/rooms-get': RoomsGetResponse;
+    'dsh-memory/rooms-export': RoomsExportResponse;
+    'dsh-memory/room-register': RoomRegisterResponse;
+    'dsh-memory/room-admin': RoomAdminResponse;
     'dsh-memory/wing-backfill': WingBackfillResponse;
     'dsh-memory/session-stats': SessionStatsResponse;
     'dsh-memory/settings-get': SettingsGetResponse;

package/dist/hooks/recall.d.ts

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

package/dist/hooks/recall.js

@@ -114,7 +114,9 @@ export function emptyRecallStats(now = Date.now()) {
         updatedAt: now,
     };
 }
-export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
+export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir, 
+/** 召回使用统计(可选;未装配 = 零成本旁路):进 topN(注入)才算 used。 */
+usage) {
     /** 召回去重存储(同会话已注入的记忆不再重复注入;写穿持久化,重启不丢)。 */
     const dedupe = new RecallDedupeStore(dataDir, logger);
     /** 记忆占用流水(账本迁移写穿;重启后历史会话账目由此复生)。 */
@@ -393,6 +395,7 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                         injectedIds: [], suppressedCount: scoped.length - fresh.length,
                         durationMs: Date.now() - searchStart, outcome: 'suppressed',
                     });
+                    usage?.recordAttempt(scoped.map((h) => h.id), []);
                     return decision;
                 }
                 const lines = applyRecallBudget(fresh.map((h) => `- [${h.scene_name ? `${h.type}|${h.scene_name}` : h.type}] ${h.content}`), { maxCharsPerMemory: cfg.recall.maxCharsPerMemory, maxTotalRecallChars: cfg.recall.maxTotalRecallChars });
@@ -404,6 +407,7 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                         injectedIds: [], suppressedCount: scoped.length - fresh.length,
                         durationMs: Date.now() - searchStart, outcome: 'suppressed',
                     });
+                    usage?.recordAttempt(fresh.map((h) => h.id), []);
                     return decision;
                 }
                 st.lastHits = lines.length;
@@ -436,6 +440,8 @@ export function registerRecall(ctx, cfg, stores, logger, live, modes, dataDir) {
                     injectedIds: fresh.slice(0, lines.length).map((h) => h.id), suppressedCount: scoped.length - fresh.length,
                     durationMs: Date.now() - searchStart, outcome: 'injected',
                 });
+                // 使用统计:候选=scoped(尝试),进 topN(注入)=used
+                usage?.recordAttempt(scoped.map((h) => h.id), fresh.slice(0, lines.length).map((h) => h.id));
                 // 入账在成功构造注入消息之后、返回 enter 之前——任何前置抛错路径账目零扰动
                 const led = ledgerFor(payload.agent.id);
                 recordRecallInjection(led, text.length);

package/dist/index.d.ts

@@ -75,19 +75,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>, "plain">;
-    longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-        enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
         maxPending: import("@deepseek-ai/schemastery").default<number, number, "defined">;
@@ -433,19 +420,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
         embedRemoteModel: import("@deepseek-ai/schemastery").default<string, string, "defined">;
         embedRemoteDimensions: import("@deepseek-ai/schemastery").default<number, number, "defined">;
         memoryMutate: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
@@ -543,19 +517,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
         embedRemoteModel: import("@deepseek-ai/schemastery").default<string, string, "defined">;
         embedRemoteDimensions: import("@deepseek-ai/schemastery").default<number, number, "defined">;
         memoryMutate: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>>, "volatile">;
 }>>, Schemastery.ObjectT<NoInfer<{
@@ -618,19 +579,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
     }>>, Schemastery.ObjectT<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>, "plain">;
-    longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-        enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-        autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-    }>>, "plain">;
     conflictFreeze: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
         maxPending: import("@deepseek-ai/schemastery").default<number, number, "defined">;
@@ -976,19 +924,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
         embedRemoteModel: import("@deepseek-ai/schemastery").default<string, string, "defined">;
         embedRemoteDimensions: import("@deepseek-ai/schemastery").default<number, number, "defined">;
         memoryMutate: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
@@ -1086,19 +1021,6 @@ export declare const Config: import("@deepseek-ai/schemastery").default<Schemast
         embedRemoteModel: import("@deepseek-ai/schemastery").default<string, string, "defined">;
         embedRemoteDimensions: import("@deepseek-ai/schemastery").default<number, number, "defined">;
         memoryMutate: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        longTask: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-            contextThresholdPct: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            driftThreshold: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            tailTurns: import("@deepseek-ai/schemastery").default<number, number, "defined">;
-            autoCompress: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
-        }>>, "plain">;
         conflictFreeze: import("@deepseek-ai/schemastery").default<boolean, boolean, "defined">;
     }>>>, "volatile">;
 }>>, "plain">;