dsh-prime-memory 0.22.1 → 0.22.2

package/dist/tools/skills.js

@@ -0,0 +1,130 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+const MUTATE_OFF_NOTICE = '记忆写删未开放：请在记忆库面板开启「高权限模式」后，模型才能改动技能。';
+export function registerSkillTools(ctx, cfg, skills, logger, live) {
+    if (!(cfg.skills.enabled === true || live.get().skillsEnabled === true))
+        return; // 默认关：部署 cfg 或看板 live 任一开才注册
+    // memory_skill_list：列全部技能摘要（含 status/sessionCount，candidate 也列出供审阅）。
+    ctx.tools.register(defineTool({
+        name: 'memory_skill_list',
+        description: '列出已沉淀的技能(程序性记忆)摘要：id/标题/状态/档位/覆盖会话数。用于查看技能库现状与候选晋升情况。',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'object',
+                properties: {
+                    skills: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                id: { type: 'string' },
+                                title: { type: 'string' },
+                                status: { type: 'string' },
+                                tier: { type: 'string' },
+                                pinned: { type: 'boolean' },
+                                sessionCount: { type: 'number' },
+                            },
+                            additionalProperties: false,
+                        },
+                    },
+                    notice: { type: 'string' },
+                },
+                additionalProperties: false,
+            },
+            render: (_a, v) => [{ type: 'text', text: v.notice ?? `共 ${v.skills?.length ?? 0} 个技能` }],
+        },
+        execute: async () => {
+            const list = skills.list().map((s) => ({
+                id: s.id,
+                title: s.title,
+                status: s.status,
+                tier: s.injectionTier,
+                pinned: s.pinned,
+                sessionCount: skills.sessionCount(s.id),
+            }));
+            return { skills: list, notice: `共 ${list.length} 个技能` };
+        },
+    }));
+    // memory_skill_read：取某技能完整正文 + 步骤。
+    ctx.tools.register(defineTool({
+        name: 'memory_skill_read',
+        description: '读取一条技能的完整正文与步骤清单（按 id）。用于展开注入里被截断/excerpt 档的技能细节。',
+        parameters: { id: { type: 'string', required: true, description: '技能 id（来自 memory_skill_list 或注入头）' } },
+        output: {
+            schema: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    title: { type: 'string' },
+                    body: { type: 'string' },
+                    steps: { type: 'array', items: { type: 'string' } },
+                    notice: { type: 'string' },
+                },
+                additionalProperties: false,
+            },
+            render: (_a, v) => [
+                {
+                    type: 'text',
+                    text: v.notice ?? [`【${v.title}】`, v.body, ...(v.steps || []).map((s) => `  - ${s}`)].join('\n'),
+                },
+            ],
+        },
+        execute: async (args) => {
+            const id = String(args?.id ?? '').trim();
+            const s = skills.get(id);
+            if (!s)
+                return { id, title: '', body: '', steps: [], notice: `未找到技能 ${id}` };
+            return { id: s.id, title: s.title, body: s.body, steps: s.steps };
+        },
+    }));
+    // memory_skill_pin：pin/unpin（高权限门）。pinned 技能不受闲置归档影响。
+    ctx.tools.register(defineTool({
+        name: 'memory_skill_pin',
+        description: '固定/取消固定一条技能（按 id）。固定后不参与闲置自动归档。仅用户显式要求时用；需高权限模式。',
+        parameters: {
+            id: { type: 'string', required: true, description: '技能 id' },
+            pinned: { type: 'boolean', required: true, description: 'true=固定，false=取消固定' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                properties: { notice: { type: 'string' } },
+                additionalProperties: false,
+            },
+            render: (_a, v) => [{ type: 'text', text: v.notice ?? '' }],
+        },
+        execute: async (args) => {
+            if (!live.get().memoryMutate)
+                return { notice: MUTATE_OFF_NOTICE };
+            const id = String(args?.id ?? '').trim();
+            const changed = await skills.update(id, { pinned: args?.pinned === true });
+            return { notice: changed ? `已${args?.pinned === true ? '固定' : '取消固定'}技能 ${id}` : `未找到技能 ${id} 或无变化` };
+        },
+    }));
+    // memory_skill_archive：归档（高权限门）；走 sidecar 生命周期，不触碰 l1_records 退场。
+    ctx.tools.register(defineTool({
+        name: 'memory_skill_archive',
+        description: '归档一条技能（按 id，可给原因）。归档后不再注入，但记录保留可恢复。仅用户显式要求时用；需高权限模式。',
+        parameters: {
+            id: { type: 'string', required: true, description: '技能 id' },
+            reason: { type: 'string', description: '归档原因（可选，供审计）' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                properties: { notice: { type: 'string' } },
+                additionalProperties: false,
+            },
+            render: (_a, v) => [{ type: 'text', text: v.notice ?? '' }],
+        },
+        execute: async (args) => {
+            if (!live.get().memoryMutate)
+                return { notice: MUTATE_OFF_NOTICE };
+            const id = String(args?.id ?? '').trim();
+            const done = await skills.archive(id, String(args?.reason ?? 'manual').slice(0, 120) || 'manual');
+            if (done)
+                logger.info(`[memory] 技能归档 ${id}`);
+            return { notice: done ? `已归档技能 ${id}` : `未找到技能 ${id} 或已归档` };
+        },
+    }));
+}

package/dist/types.d.ts

@@ -226,6 +226,12 @@ export interface MemoryRecord {
     repoKeyOwner?: string;
     /** 记录级 applicability(ADR-0015 T1.10):'' 未声明(不围栏)| 'this-repo' | 'cross-project';显式不从 family 推导。 */
     applicability?: string;
+    /**
+     * 外部导入幂等键(轨3-P0):`sha1(source_id \0 身份)`;非外部导入(内部蒸馏/add)= undefined/''。
+     * 非空值受 `l1_records` 上部分唯一索引约束——同一 (来源, 内容/稳定身份) 重复导入结构性不可能。
+     * 与 `scene_name`/`metadata.origin` 不同:这是**存储层强制去重键**,不是展示用的溯源标签。
+     */
+    extKey?: string;
 }
 /** L2 场景块摘要(META 解析结果)。 */
 export interface SceneSummary {

package/dist/util/maturity.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 成熟度（maturity）合成——G3，单一事实源的纯函数。
+ *
+ * 把三个**已存在**的信号合成一个可解释的置信档，供面板显示（后续可作召回排序/矛盾旁注）：
+ * - `priority`（L1 真实列，0-100）：写入时的重要性先验；
+ * - `usage.used`（recall-usage，进 topN 被注入才计）：被反复用到 = 越"确立"；
+ * - `agingWeight`（读路径衰减系数 0.5~1，null=关）：新鲜度。
+ *
+ * 刻意**读时派生、不落库**（Agent B/C 结论）：落库会在每轮 recordAttempt 触发双写 + 值随时间陈旧，
+ * 且顶层列不进快照哈希=隐形改写。三输入即时可得，纯函数零 IO。
+ *
+ * 权重/阈值集中为常量，便于回归与调参；缺 usage（未装配）按 0 强化处理（不虚构成熟度）。
+ */
+export type Maturity = 'low' | 'mid' | 'high';
+export interface MaturityUsage {
+    used: number;
+}
+export interface MaturityInput {
+    priority: number;
+    usage?: MaturityUsage | null;
+    /** 读路径老化权重（0.5~1）；null = 衰减关闭 → 视为 1（不惩罚）。 */
+    agingWeight?: number | null;
+}
+/** 合成分值（0~1），导出供测试与未来排序复用。 */
+export declare function maturityScore(i: MaturityInput): number;
+/** 三档成熟度：high ≥0.66、mid ≥0.40、否则 low。 */
+export declare function computeMaturity(i: MaturityInput): Maturity;

package/dist/util/maturity.js

@@ -0,0 +1,26 @@
+const W_PRIORITY = 0.45;
+const W_USAGE = 0.3;
+const W_AGING = 0.25;
+/** used 达到该数即满强化（再高不加分）。 */
+const USAGE_SATURATE = 5;
+const HIGH_THRESHOLD = 0.66;
+const MID_THRESHOLD = 0.4;
+function clamp01(x) {
+    return Math.max(0, Math.min(1, x));
+}
+/** 合成分值（0~1），导出供测试与未来排序复用。 */
+export function maturityScore(i) {
+    const p = clamp01(i.priority / 100);
+    const u = i.usage ? clamp01(i.usage.used / USAGE_SATURATE) : 0;
+    const a = i.agingWeight == null ? 1 : clamp01(i.agingWeight);
+    return W_PRIORITY * p + W_USAGE * u + W_AGING * a;
+}
+/** 三档成熟度：high ≥0.66、mid ≥0.40、否则 low。 */
+export function computeMaturity(i) {
+    const s = maturityScore(i);
+    if (s >= HIGH_THRESHOLD)
+        return 'high';
+    if (s >= MID_THRESHOLD)
+        return 'mid';
+    return 'low';
+}

package/dist/wing-backfill.js

@@ -4,8 +4,10 @@ import { WING_FALLBACK } from './types.js';
 import { parseJsonLogged } from './llm.js';
 import { isWingId, normTags } from './metadata-validators.js';
 import { yieldLoop } from './util/yield.js';
-/** 单次任务处理上限(524 条存量一次跑完约为 LLM 成本大头;分批触发,可重复执行)。 */
-const MAX_RECORDS = 300;
+/** 单次任务处理上限默认值(可被 cfg.backfill.maxRecords 覆盖;分批触发,可重复执行)。 */
+const DEFAULT_MAX_RECORDS = 300;
+/** 墙钟预算默认值 ms(可被 cfg.backfill.timeBudgetMs 覆盖):超时剩留待再次触发。 */
+const DEFAULT_TIME_BUDGET_MS = 120_000;
 /** 每块条数(一次 LLM 调用判定的记录数)。 */
 const CHUNK = 20;
 const state = { running: false, updated: 0, failed: 0 };
@@ -31,14 +33,15 @@ export function startWingBackfill(deps) {
 }
 async function run(deps) {
     const { ctx, cfg, backend, logger } = deps;
+    const MAX_RECORDS = cfg.backfill?.maxRecords ?? DEFAULT_MAX_RECORDS;
+    const TIME_BUDGET_MS = cfg.backfill?.timeBudgetMs ?? DEFAULT_TIME_BUDGET_MS;
     const halls = normWingEnabled(cfg.hall?.enabled);
     if (halls.length === 0) {
         logger.warn('[memory] wing 回填跳过:wing.enabled 为空(打标功能已关闭)');
         return;
     }
-    // 墙钟预算:超时即停,剩余留待再次触发(任务本身设计为可重复执行)。
+    // 墙钟预算(cfg.backfill.timeBudgetMs,默认 120s):超时即停,剩余留待再次触发(任务本身设计为可重复执行)。
     // 保证后台回填不长时间占据事件循环,设置面板的状态 RPC 始终优先。
-    const TIME_BUDGET_MS = 120_000;
     const startedAt = Date.now();
     const candidates = [...halls, WING_FALLBACK].join(' / ');
     // 未打标集:游标分批扫描轻量投影(不一次性全量反序列化含正文的记录)。

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.22.1",
+  "version": "0.22.2",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.22.1",
+  "version": "0.22.2",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",