dsh-prime-memory 0.11.0

package/assets/readme/bench-workflow.svg

@@ -0,0 +1,79 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="1200" height="660" viewBox="0 0 1200 660"
+     role="img" aria-labelledby="benchWorkflowTitle benchWorkflowDesc">
+  <title id="benchWorkflowTitle">DSH-MemBench 工作流赛道：A/B 两组完成度与成本对照</title>
+  <desc id="benchWorkflowDesc">真实工具沙箱（7 场景，A 组 3 轮 / B 组 1 轮）探针段合计：任务完成度 A 组 59/69（85.5%）对 B 组 10/23（43.5%）；成本对比以 B 组为满格基准（每场景均值），A 组相对更省——步骤 24.3 对 41.4（B +70%）、工具调用 37.7 对 62.1（B +65%）、输入 token 266k 对 1.81M（B 6.8 倍）；风格规范场景探针 A 12/12 对 B 0/4；向用户求助 A 组 3 轮共 1 次、B 组 1 轮 1 次。</desc>
+
+  <rect width="1200" height="660" rx="26" fill="#0D1526"/>
+
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">
+
+    <!-- ── 标题与图例 ── -->
+    <text x="64" y="66" font-size="26" font-weight="700" fill="#EFF3FA">工作流赛道：真实工具沙箱 · 做得对，也更省</text>
+    <text x="64" y="94" font-size="18" fill="#8296B3">7 场景 · A 组 3 轮 / B 组 1 轮（成本护栏）· 探针段合计 · 成本行以 B 组为满格基准</text>
+
+    <rect x="842" y="50" width="18" height="18" rx="5" fill="#FFD15D"/>
+    <text x="868" y="65" font-size="18" fill="#C2CDDE">A 组 · 记忆开</text>
+    <rect x="842" y="76" width="18" height="18" rx="5" fill="#4E6DA8"/>
+    <text x="868" y="91" font-size="18" fill="#C2CDDE">B 组 · 记忆关</text>
+
+    <!-- ── 探针段完成度 ── -->
+    <text x="64" y="152" font-size="20" font-weight="700" fill="#EFF3FA">探针段完成度</text>
+    <text x="216" y="152" font-size="17" fill="#8296B3">（新会话延续任务，产物程序化校验）</text>
+
+    <rect x="260" y="170" width="598" height="26" rx="6" fill="#FFD15D"/>
+    <text x="872" y="191" font-size="22" font-weight="700" fill="#FFD15D">59/69 · 85.5%</text>
+    <rect x="260" y="206" width="304" height="26" rx="6" fill="#4E6DA8"/>
+    <text x="578" y="227" font-size="22" font-weight="700" fill="#8FA6C6">10/23 · 43.5%</text>
+
+    <line x1="64" y1="258" x2="1136" y2="258" stroke="#263A5C" stroke-width="1.5"/>
+
+    <!-- ── 成本对比（B = 满格基准）── -->
+    <text x="64" y="290" font-size="20" font-weight="700" fill="#EFF3FA">成本对比</text>
+    <text x="166" y="290" font-size="17" fill="#8296B3">（每场景均值，B 组 = 满格基准，条越短越省）</text>
+
+    <!-- 步骤 -->
+    <text x="240" y="348" font-size="19" fill="#C2CDDE" text-anchor="end">步骤</text>
+    <rect x="260" y="318" width="329" height="18" rx="5" fill="#FFD15D"/>
+    <text x="603" y="333" font-size="18" font-weight="700" fill="#FFD15D" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">24.3</text>
+    <rect x="260" y="342" width="560" height="18" rx="5" fill="#4E6DA8"/>
+    <text x="834" y="357" font-size="18" font-weight="700" fill="#8FA6C6" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">41.4</text>
+    <rect x="980" y="321" width="136" height="36" rx="10" fill="#315DA6"/>
+    <text x="1048" y="345" font-size="19" font-weight="700" fill="#FFD15D" text-anchor="middle">B +70%</text>
+
+    <!-- 工具调用 -->
+    <text x="240" y="430" font-size="19" fill="#C2CDDE" text-anchor="end">工具调用</text>
+    <rect x="260" y="400" width="340" height="18" rx="5" fill="#FFD15D"/>
+    <text x="614" y="415" font-size="18" font-weight="700" fill="#FFD15D" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">37.7</text>
+    <rect x="260" y="424" width="560" height="18" rx="5" fill="#4E6DA8"/>
+    <text x="834" y="439" font-size="18" font-weight="700" fill="#8FA6C6" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">62.1</text>
+    <rect x="980" y="403" width="136" height="36" rx="10" fill="#315DA6"/>
+    <text x="1048" y="427" font-size="19" font-weight="700" fill="#FFD15D" text-anchor="middle">B +65%</text>
+
+    <!-- 输入 token -->
+    <text x="240" y="512" font-size="19" fill="#C2CDDE" text-anchor="end">输入 token</text>
+    <rect x="260" y="482" width="82" height="18" rx="5" fill="#FFD15D"/>
+    <text x="356" y="497" font-size="18" font-weight="700" fill="#FFD15D" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">266k</text>
+    <rect x="260" y="506" width="560" height="18" rx="5" fill="#4E6DA8"/>
+    <text x="834" y="521" font-size="18" font-weight="700" fill="#8FA6C6" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace">1.81M</text>
+    <rect x="980" y="485" width="136" height="36" rx="10" fill="#315DA6"/>
+    <text x="1048" y="509" font-size="19" font-weight="700" fill="#FFD15D" text-anchor="middle">B +580%</text>
+
+    <!-- ── 底部特写卡片 ── -->
+    <rect x="64" y="544" width="512" height="72" rx="14" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+    <text x="88" y="574" font-size="17" fill="#8296B3">风格规范场景 · 探针段（约定只存记忆，沙箱探不出来）</text>
+    <text x="88" y="600" font-size="20" font-weight="700">
+      <tspan fill="#FFD15D">A 12/12</tspan>
+      <tspan fill="#8FA6C6"> · B 0/4</tspan>
+    </text>
+
+    <rect x="624" y="544" width="512" height="72" rx="14" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+    <text x="648" y="574" font-size="17" fill="#8296B3">长任务成本 · 每场景输入 token（B 无记忆重新探索）</text>
+    <text x="648" y="600" font-size="20" font-weight="700">
+      <tspan fill="#FFD15D">A 266k</tspan>
+      <tspan fill="#8FA6C6"> · B 1.81M</tspan>
+    </text>
+    <rect x="1040" y="578" width="72" height="26" rx="8" fill="#315DA6"/>
+    <text x="1076" y="597" font-size="18" font-weight="700" fill="#FFD15D" text-anchor="middle">6.8×</text>
+  </g>
+</svg>

package/assets/readme/flow.svg

@@ -0,0 +1,189 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     xmlns:xlink="http://www.w3.org/1999/xlink"
+     width="1200" height="600" viewBox="0 0 1200 600"
+     role="img" aria-labelledby="flowTitle flowDesc">
+  <title id="flowTitle">dsh-prime-memory 运行时数据流</title>
+  <desc id="flowDesc">左侧 User 与 Assistant 的会话事件（session/event）流入中间的 dsh-prime-memory 插件：L0 捕获、L1–L3 蒸馏、检索召回与记忆工具；插件在 agent/pre-step 把相关记忆注入右侧 DeepSeek Harness 核心，蒸馏调用复用核心的 ctx.llm；数据双写 ~/.dsh/memory/。</desc>
+
+  <defs>
+    <marker id="arr-teal" markerWidth="9" markerHeight="9" refX="7" refY="4" orient="auto">
+      <path d="M0 0 L8 4 L0 8 Z" fill="#FFD15D"/>
+    </marker>
+    <marker id="arr-orange" markerWidth="9" markerHeight="9" refX="7" refY="4" orient="auto">
+      <path d="M0 0 L8 4 L0 8 Z" fill="#7FA6E3"/>
+    </marker>
+  </defs>
+
+  <rect width="1200" height="600" rx="26" fill="#0D1526"/>
+
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">
+
+    <!-- ── 图例 ── -->
+    <circle cx="72" cy="58" r="5" fill="#FFD15D"/>
+    <text x="86" y="64" font-size="18" fill="#C2CDDE">捕获 / 写入</text>
+    <circle cx="250" cy="58" r="5" fill="#7FA6E3"/>
+    <text x="264" y="64" font-size="18" fill="#C2CDDE">召回 / 注入</text>
+
+    <!-- ── 左列：User ── -->
+    <g id="node-user">
+      <rect x="64" y="120" width="190" height="92" rx="16" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+      <circle cx="102" cy="152" r="9" fill="none" stroke="#8296B3" stroke-width="2"/>
+      <path d="M86 182 a16 16 0 0 1 32 0" fill="none" stroke="#8296B3" stroke-width="2"/>
+      <text x="126" y="162" font-size="20" font-weight="700" fill="#EFF3FA">User</text>
+      <text x="126" y="188" font-size="18" fill="#8296B3">用户消息</text>
+    </g>
+
+    <!-- ── 左列：Assistant ── -->
+    <g id="node-assistant">
+      <rect x="64" y="348" width="190" height="92" rx="16" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+      <path d="M102 376 L106 390 L120 394 L106 398 L102 412 L98 398 L84 394 L98 390 Z" fill="#8296B3"/>
+      <text x="126" y="392" font-size="20" font-weight="700" fill="#EFF3FA">Assistant</text>
+      <text x="126" y="418" font-size="18" fill="#8296B3">助手回复</text>
+    </g>
+
+    <!-- ── 中列：插件 ── -->
+    <g id="node-plugin">
+      <rect x="430" y="96" width="290" height="356" rx="18" fill="#15223A" stroke="#FFD15D" stroke-opacity="0.55" stroke-width="1.5"/>
+      <text x="575" y="138" text-anchor="middle" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="22" font-weight="700" fill="#EFF3FA">dsh-prime-memory</text>
+      <text x="575" y="166" text-anchor="middle" font-size="18" fill="#8296B3">分层蒸馏记忆插件</text>
+
+      <g id="plugin-modules">
+        <rect x="452" y="188" width="246" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="470" cy="211" r="4" fill="#FFD15D"/>
+        <text x="486" y="218" font-size="19" fill="#EFF3FA">L0 捕获 capture</text>
+
+        <rect x="452" y="244" width="246" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="470" cy="267" r="4" fill="#FFD15D"/>
+        <text x="486" y="274" font-size="19" fill="#EFF3FA">L1–L3 蒸馏 distill</text>
+
+        <rect x="452" y="300" width="246" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="470" cy="323" r="4" fill="#FFD15D"/>
+        <text x="486" y="330" font-size="19" fill="#EFF3FA">检索召回 · 三策略</text>
+
+        <rect x="452" y="356" width="246" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="470" cy="379" r="4" fill="#FFD15D"/>
+        <text x="486" y="386" font-size="19" fill="#EFF3FA">记忆工具 ×3</text>
+      </g>
+    </g>
+
+    <!-- ── 存储条 ── -->
+    <g id="node-storage">
+      <path id="sto-write" d="M545 456 V482" stroke="#FFD15D" stroke-width="2.5" fill="none" marker-end="url(#arr-teal)"/>
+      <path id="sto-read" d="M605 482 V456" stroke="#7FA6E3" stroke-width="2.5" fill="none" marker-end="url(#arr-orange)"/>
+      <text x="531" y="472" text-anchor="end" font-size="16" fill="#FFD15D">写</text>
+      <text x="619" y="472" font-size="16" fill="#7FA6E3">读</text>
+      <circle r="3.5" fill="#FFD15D" cx="545" cy="470">
+        <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+        <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+        <animateMotion dur="1.6s" begin="0s" repeatCount="indefinite"><mpath href="#sto-write" xlink:href="#sto-write"/></animateMotion>
+      </circle>
+      <circle r="3.5" fill="#7FA6E3" cx="605" cy="468">
+        <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+        <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+        <animateMotion dur="1.6s" begin="-0.8s" repeatCount="indefinite"><mpath href="#sto-read" xlink:href="#sto-read"/></animateMotion>
+      </circle>
+
+      <rect x="430" y="486" width="290" height="54" rx="12" fill="#101B30" stroke="#263A5C" stroke-dasharray="6 4"/>
+      <text x="575" y="509" text-anchor="middle" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#FFD15D">~/.dsh/memory/</text>
+      <text x="575" y="531" text-anchor="middle" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="16" fill="#6E82A3">memory.db · JSONL · Markdown</text>
+    </g>
+
+    <!-- ── 右列：DSH 核心 ── -->
+    <g id="node-core">
+      <rect x="920" y="96" width="216" height="356" rx="18" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+      <text x="1028" y="138" text-anchor="middle" font-size="22" font-weight="700" fill="#EFF3FA">DSH 核心</text>
+      <text x="1028" y="166" text-anchor="middle" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#8296B3">DeepSeek Harness</text>
+
+      <g id="core-modules">
+        <rect x="936" y="188" width="184" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="954" cy="211" r="4" fill="#7FA6E3"/>
+        <text x="970" y="218" font-size="19" fill="#EFF3FA">agent 循环</text>
+
+        <rect x="936" y="244" width="184" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="954" cy="267" r="4" fill="#7FA6E3"/>
+        <text x="970" y="274" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="19" fill="#EFF3FA">ctx.llm</text>
+
+        <rect x="936" y="300" width="184" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="954" cy="323" r="4" fill="#7FA6E3"/>
+        <text x="970" y="330" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="19" fill="#EFF3FA">systemPrompt</text>
+
+        <rect x="936" y="356" width="184" height="46" rx="10" fill="#101B30" stroke="#263A5C"/>
+        <circle cx="954" cy="379" r="4" fill="#7FA6E3"/>
+        <text x="970" y="386" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="19" fill="#EFF3FA">tools·settings</text>
+      </g>
+    </g>
+
+    <!-- ── 连接 1：User → 插件（捕获） ── -->
+    <path id="cap-user" d="M254 166 H430" stroke="#FFD15D" stroke-width="2.5" fill="none" marker-end="url(#arr-teal)"/>
+    <text x="342" y="142" text-anchor="middle" font-size="18" fill="#C2CDDE">对话输入</text>
+    <circle r="4" fill="#FFD15D" cx="320" cy="166">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="0s" repeatCount="indefinite"><mpath href="#cap-user" xlink:href="#cap-user"/></animateMotion>
+    </circle>
+    <circle r="4" fill="#FFD15D" opacity="0.7" cx="368" cy="166">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-1.2s" repeatCount="indefinite"><mpath href="#cap-user" xlink:href="#cap-user"/></animateMotion>
+    </circle>
+
+    <!-- ── 连接 2：Assistant → 插件（捕获） ── -->
+    <path id="cap-asst" d="M254 394 H430" stroke="#FFD15D" stroke-width="2.5" fill="none" marker-end="url(#arr-teal)"/>
+    <text x="342" y="370" text-anchor="middle" font-size="18" fill="#C2CDDE">回复捕获</text>
+    <circle r="4" fill="#FFD15D" cx="320" cy="394">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-0.6s" repeatCount="indefinite"><mpath href="#cap-asst" xlink:href="#cap-asst"/></animateMotion>
+    </circle>
+    <circle r="4" fill="#FFD15D" opacity="0.7" cx="368" cy="394">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-1.8s" repeatCount="indefinite"><mpath href="#cap-asst" xlink:href="#cap-asst"/></animateMotion>
+    </circle>
+
+    <!-- ── 连接 3：插件 → 核心（召回注入） ── -->
+    <path id="flow-recall" d="M720 192 L920 214" stroke="#7FA6E3" stroke-width="2.5" fill="none" marker-end="url(#arr-orange)"/>
+    <text x="820" y="166" text-anchor="middle" font-size="18" fill="#7FA6E3">召回注入 pre-step</text>
+    <circle r="3.5" fill="#7FA6E3" cx="770" cy="198">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="0s" repeatCount="indefinite"><mpath href="#flow-recall" xlink:href="#flow-recall"/></animateMotion>
+    </circle>
+    <circle r="3.5" fill="#7FA6E3" cx="815" cy="202.5">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-0.8s" repeatCount="indefinite"><mpath href="#flow-recall" xlink:href="#flow-recall"/></animateMotion>
+    </circle>
+    <circle r="3.5" fill="#7FA6E3" cx="860" cy="207">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-1.6s" repeatCount="indefinite"><mpath href="#flow-recall" xlink:href="#flow-recall"/></animateMotion>
+    </circle>
+
+    <!-- ── 连接 4：核心 → 插件（蒸馏复用 LLM） ── -->
+    <path id="flow-distill" d="M920 320 L720 342" stroke="#FFD15D" stroke-width="2.5" fill="none" marker-end="url(#arr-teal)"/>
+    <text x="820" y="374" text-anchor="middle" font-size="18" fill="#FFD15D">蒸馏复用 ctx.llm</text>
+    <circle r="3.5" fill="#FFD15D" cx="865" cy="327">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-0.4s" repeatCount="indefinite"><mpath href="#flow-distill" xlink:href="#flow-distill"/></animateMotion>
+    </circle>
+    <circle r="3.5" fill="#FFD15D" cx="820" cy="331">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-1.2s" repeatCount="indefinite"><mpath href="#flow-distill" xlink:href="#flow-distill"/></animateMotion>
+    </circle>
+    <circle r="3.5" fill="#FFD15D" cx="775" cy="335">
+      <animate attributeName="cx" to="0" dur="1ms" fill="freeze"/>
+      <animate attributeName="cy" to="0" dur="1ms" fill="freeze"/>
+      <animateMotion dur="2.4s" begin="-2s" repeatCount="indefinite"><mpath href="#flow-distill" xlink:href="#flow-distill"/></animateMotion>
+    </circle>
+
+    <!-- ── 底注 ── -->
+    <text x="600" y="576" text-anchor="middle" font-size="18" fill="#8296B3">事件缝 session/event · 注入缝 agent/pre-step + systemPrompt.context · 全程无感，用户与模型零操作</text>
+  </g>
+</svg>

package/assets/readme/storage.svg

@@ -0,0 +1,115 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="1200" height="800" viewBox="0 0 1200 800"
+     role="img" aria-labelledby="storageTitle storageDesc">
+  <title id="storageTitle">存储布局与检索</title>
+  <desc id="storageDesc">双写架构：JSONL 按天追加只增不改（事实源），memory.db 为主检索引擎。文件形态含 conversations、records、scenes、persona、state、pending、session-modes、embedding-source、models、runtime、日志与重建归档；检索三策略 keyword/embedding/hybrid（RRF k=60 融合）；嵌入源三态 off/remote/local（生效 = 部署上限 AND 运行时选择）；降级链保证永不阻塞宿主，唯一检索缝为 L1Store.search()。</desc>
+
+  <rect width="1200" height="800" rx="26" fill="#0D1526"/>
+
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">
+
+    <!-- ── 双写架构 ── -->
+    <rect x="64" y="56" width="1072" height="56" rx="14" fill="#15223A" stroke="#263A5C" stroke-width="1.5"/>
+    <text x="600" y="91" text-anchor="middle" font-size="20" fill="#EFF3FA">双写架构：JSONL 按天追加、只增不改（备份 / 恢复事实源）· memory.db 主检索引擎（去重合并只动检索库）</text>
+
+    <!-- ── 左：文件形态 ── -->
+    <g id="files">
+      <rect x="64" y="140" width="560" height="610" rx="16" fill="#101B30" stroke="#263A5C" stroke-width="1.5"/>
+      <text x="92" y="176" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#FFD15D">文件形态 · ~/.dsh/memory/</text>
+
+      <g font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18">
+        <text x="92" y="210" fill="#EFF3FA">memory.db</text>
+        <text x="352" y="210" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">SQLite 检索库 · FTS5+向量</text>
+
+        <text x="92" y="252" fill="#EFF3FA">conversations/*.jsonl</text>
+        <text x="352" y="252" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">L0 事实源 · 只增不改</text>
+
+        <text x="92" y="294" fill="#EFF3FA">records/*.jsonl</text>
+        <text x="352" y="294" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">L1 事实源 · 含 family</text>
+
+        <text x="92" y="336" fill="#EFF3FA">scenes/&lt;family&gt;/*.md</text>
+        <text x="352" y="336" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">L2 场景块 · 按族</text>
+
+        <text x="92" y="378" fill="#EFF3FA">persona-&lt;family&gt;.md</text>
+        <text x="352" y="378" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">L3 画像 · 每族一份</text>
+
+        <text x="92" y="420" fill="#EFF3FA">state.json</text>
+        <text x="352" y="420" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">checkpoint · v2 分族</text>
+
+        <text x="92" y="462" fill="#EFF3FA">pending.json</text>
+        <text x="352" y="462" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">未蒸馏缓冲 · 重启恢复</text>
+
+        <text x="92" y="504" fill="#EFF3FA">session-modes.json</text>
+        <text x="352" y="504" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">会话档位 · 90 天清理</text>
+
+        <text x="92" y="546" fill="#EFF3FA">embedding-source.json</text>
+        <text x="352" y="546" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">嵌入源三态 · 运行时切换</text>
+
+        <text x="92" y="588" fill="#EFF3FA">models/&lt;id&gt;/</text>
+        <text x="352" y="588" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">本地嵌入模型 · sha256 校验</text>
+
+        <text x="92" y="630" fill="#EFF3FA">runtime/</text>
+        <text x="352" y="630" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">推理运行时 · 按需安装</text>
+
+        <text x="92" y="672" fill="#EFF3FA">*.bak.&lt;ts&gt;/</text>
+        <text x="352" y="672" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">重建归档（改名保留）</text>
+
+        <text x="92" y="714" fill="#EFF3FA">memory.log</text>
+        <text x="352" y="714" fill="#8296B3" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif">诊断日志 · 2MB 轮转</text>
+      </g>
+    </g>
+
+    <!-- ── 右上：检索三策略 ── -->
+    <g id="retrieval">
+      <rect x="656" y="140" width="480" height="210" rx="16" fill="#101B30" stroke="#263A5C" stroke-width="1.5"/>
+      <text x="684" y="174" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#7FA6E3">检索三策略 · recall.strategy</text>
+
+      <text x="684" y="210" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">keyword</text>
+      <text x="800" y="210" font-size="18" fill="#8296B3">FTS5 BM25</text>
+
+      <text x="684" y="244" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">embedding</text>
+      <text x="800" y="244" font-size="18" fill="#8296B3">vec0 余弦 KNN</text>
+
+      <text x="684" y="278" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">hybrid</text>
+      <rect x="798" y="262" width="48" height="24" rx="12" fill="#FFD15D"/>
+      <text x="822" y="279" text-anchor="middle" font-size="15" font-weight="700" fill="#0D1526">默认</text>
+      <text x="860" y="278" font-size="18" fill="#8296B3">双路并行 + RRF k=60</text>
+
+      <text x="684" y="322" font-size="18" fill="#6E82A3">conversation_search（L0）同款融合</text>
+    </g>
+
+    <!-- ── 右中：嵌入源三态 ── -->
+    <g id="embedding-source">
+      <rect x="656" y="370" width="480" height="184" rx="16" fill="#101B30" stroke="#263A5C" stroke-width="1.5"/>
+      <text x="684" y="404" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#93A8FF">嵌入源三态 · 运行时切换</text>
+
+      <text x="684" y="438" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">off</text>
+      <text x="800" y="438" font-size="18" fill="#8296B3">纯 FTS（默认）</text>
+
+      <text x="684" y="471" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">remote</text>
+      <text x="800" y="471" font-size="18" fill="#8296B3">OpenAI 兼容 /embeddings</text>
+
+      <text x="684" y="504" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace" font-size="18" fill="#EFF3FA">local</text>
+      <text x="800" y="504" font-size="18" fill="#8296B3">内置目录 · CPU 推理</text>
+
+      <text x="684" y="536" font-size="16" fill="#6E82A3">生效 = 部署上限 AND 运行时选择 · 本地模型免 API Key</text>
+    </g>
+
+    <!-- ── 右下：降级链 ── -->
+    <g id="degradation">
+      <rect x="656" y="574" width="480" height="176" rx="16" fill="#101B30" stroke="#263A5C" stroke-width="1.5"/>
+      <text x="684" y="608" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#8296B3">降级链 · 永不阻塞宿主</text>
+
+      <text x="684" y="642" font-size="18" fill="#C2CDDE">sqlite-vec 加载失败 → 纯 FTS</text>
+      <text x="684" y="675" font-size="18" fill="#C2CDDE">embedding 调用失败 → 该次降级 FTS</text>
+      <text x="684" y="708" font-size="18" fill="#C2CDDE">初始化失败 → 记忆停用 · dsh 照常启动</text>
+
+      <text x="684" y="740" font-family="ui-monospace,SFMono-Regular,Menlo,Consolas,monospace"
+            font-size="18" fill="#FFD15D">唯一检索缝：L1Store.search()</text>
+    </g>
+  </g>
+</svg>

package/cordis.patch.yml

@@ -0,0 +1,16 @@
+# dsh-prime-memory 组合包层：安装（dsh plugin --profile <name> add dsh-prime-memory）
+# 后自动挂载插件行，无需再手改 profile 的 cordis.patch.yml。
+# 覆盖配置请在 profile 自己的 cordis.patch.yml 里写顶层裸 patch（直接 id:，不要包 insert:，
+# 同 id 再 insert 会报 duplicate loader entry id 启动失败）：
+#   - id: dsh-memory
+#     name: dsh-prime-memory
+#     config: { family: auto }   # 键按行整体替换，不深合并
+- insert:
+    - id: dsh-memory
+      name: dsh-prime-memory
+      # config:                      # 全部字段有默认值，按需覆盖：
+      #   family: auto               #   新会话默认档：auto | chat | work
+      #   dataDir: ''                #   默认 $DSH_HOME/memory
+      #   llm:
+      #     provider: ''             #   蒸馏模型路由（默认跟随当前默认模型）
+      #     model: ''

package/dist/bench-control.d.ts

@@ -0,0 +1,34 @@
+/**
+ * bench 控制服务(config `benchControl` 门控,默认关):为同进程的基准驱动插件
+ * (dsh-bench-runner 的 lifecycle 赛道)提供进程内控制面。
+ *
+ * 为什么不走 RPC:宿主侧 connection.rpc 只有 handle/intercept、没有 call(),
+ * 基准驱动包在 dsh 宿主进程内无法调用插件的 loopback RPC 端点;cordis 服务
+ * (ctx.provide / ctx.get)是唯一干净的进程内通道。生产部署不开启该配置,
+ * 服务不注册、零表面积;即便开启,暴露的也只是既有公开 API 的薄包装,
+ * 不引入新逻辑:
+ *   - RebuildController.start()/getStatus()(重建触发与状态轮询);
+ *   - SessionModeStore.set()/get()(会话档位——走 onModeChange 回调的
+ *     pending 落袋/挂起语义,不是裸改 Map)。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { MemoryLogger, MemoryMode } from './types.js';
+import type { RebuildController, RebuildStatus } from './pipeline/rebuild.js';
+import type { SessionModeStore } from './store/session-modes.js';
+import type { DistillUsageSnapshot } from './llm-usage.js';
+/** 服务名(消费方:bench/harness/dsh-bench-runner 的 lifecycle 赛道)。 */
+export declare const BENCH_CONTROL_SERVICE = "dsh-memory-bench";
+export interface BenchControlSurface {
+    /** 触发全量重建(从 L0 重导派生层);前置条件不满足时抛错(调用方捕获)。 */
+    rebuildStart(): RebuildStatus;
+    /** 重建状态快照(phase/running/recordsBuilt/…,轮询至 done/failed/cancelled)。 */
+    rebuildStatus(): RebuildStatus;
+    /** 设置会话档位(chat/work/off/auto);对全新会话应在首条消息前设置。 */
+    setSessionMode(sessionId: string, mode: MemoryMode): void;
+    /** 查询会话档位(未设过的会话返回部署默认档)。 */
+    getSessionMode(sessionId: string): MemoryMode;
+    /** 蒸馏用量快照(按层累计的调用数/输入字符/输出 token——「记忆开销」记账)。 */
+    getDistillUsage(): DistillUsageSnapshot;
+}
+/** 注册控制服务,返回注销函数(调用方在插件 dispose 时执行)。 */
+export declare function registerBenchControl(ctx: Context, rebuild: RebuildController, modes: SessionModeStore, logger: MemoryLogger): () => void;

package/dist/bench-control.js

@@ -0,0 +1,16 @@
+import { snapshotDistillUsage } from './llm-usage.js';
+/** 服务名(消费方:bench/harness/dsh-bench-runner 的 lifecycle 赛道)。 */
+export const BENCH_CONTROL_SERVICE = 'dsh-memory-bench';
+/** 注册控制服务,返回注销函数(调用方在插件 dispose 时执行)。 */
+export function registerBenchControl(ctx, rebuild, modes, logger) {
+    const surface = {
+        rebuildStart: () => rebuild.start(),
+        rebuildStatus: () => rebuild.getStatus(),
+        setSessionMode: (sessionId, mode) => modes.set(sessionId, mode),
+        getSessionMode: (sessionId) => modes.get(sessionId),
+        getDistillUsage: () => snapshotDistillUsage(),
+    };
+    const dispose = ctx.provide(BENCH_CONTROL_SERVICE, surface);
+    logger.info('[memory] bench 控制服务已提供(dsh-memory-bench,仅基准/调试部署)');
+    return dispose;
+}