@furongjun1999/dsh-memory 0.2.7 → 0.2.9

package/docs/memory_score.html

@@ -0,0 +1,213 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>记忆系统使用性评分 · 五维标尺</title>
+<style>
+  :root {
+    --gold: linear-gradient(135deg, #f7d774, #e8a33d);
+    --silver: linear-gradient(135deg, #e8e8e8, #b8b8b8);
+    --bronze: linear-gradient(135deg, #e0a878, #c07840);
+    --lingshu: linear-gradient(135deg, #6a5cff, #3d8bfd);
+    --danger: #e74c3c; --warn: #e67e22; --good: #27ae60; --excel: #2ecc71; --perf: #9b59b6;
+  }
+  * { margin:0; padding:0; box-sizing:border-box; }
+  body {
+    font-family: "Microsoft YaHei", "PingFang SC", sans-serif;
+    background: linear-gradient(160deg, #0f1023 0%, #1a1c3a 50%, #0f1023 100%);
+    color: #e8eaf6; padding: 40px 24px; min-height: 100vh;
+  }
+  .container { max-width: 1080px; margin: 0 auto; }
+  /* 标题区 */
+  .hero {
+    text-align:center; margin-bottom: 36px;
+    background: rgba(255,255,255,0.04); border: 1px solid rgba(255,255,255,0.1);
+    border-radius: 20px; padding: 32px 24px;
+    box-shadow: 0 20px 60px rgba(0,0,0,0.4);
+  }
+  .hero h1 {
+    font-size: 34px; font-weight: 800; letter-spacing: 2px;
+    background: linear-gradient(135deg, #ffd700, #ff8c00, #ff5e62);
+    -webkit-background-clip: text; -webkit-text-fill-color: transparent;
+    margin-bottom: 10px;
+  }
+  .hero .sub { color: #aab; font-size: 15px; line-height: 1.8; }
+  .hero .badges { margin-top: 14px; }
+  .badge {
+    display:inline-block; padding: 5px 14px; border-radius: 20px;
+    font-size: 13px; margin: 3px 5px; font-weight: 600;
+    background: rgba(255,255,255,0.08); border: 1px solid rgba(255,255,255,0.15);
+  }
+  .badge.hl { background: rgba(61,139,253,0.2); border-color: #3d8bfd; color: #7fb0ff; }
+  /* 五维标尺 */
+  .section { margin-bottom: 34px; }
+  .section h2 {
+    font-size: 20px; margin-bottom: 14px; padding-left: 12px;
+    border-left: 4px solid #3d8bfd; color: #dfe3ff;
+  }
+  .scale-table { width: 100%; border-collapse: separate; border-spacing: 3px; }
+  .scale-table th, .scale-table td {
+    padding: 10px 8px; text-align: center; font-size: 13px; border-radius: 8px;
+    background: rgba(255,255,255,0.04);
+  }
+  .scale-table th { background: rgba(61,139,253,0.15); color: #9fc0ff; font-weight: 700; }
+  .scale-table td.dim { font-weight: 700; color: #ffd700; background: rgba(255,215,0,0.08); white-space: nowrap; }
+  .scale-table td.lv0 { background: rgba(231,76,60,0.18); color:#ff8a80; }
+  .scale-table td.lv1 { background: rgba(231,76,60,0.12); color:#ffab91; }
+  .scale-table td.lv2 { background: rgba(230,126,34,0.16); color:#ffcc80; }
+  .scale-table td.lv3 { background: rgba(39,174,96,0.16); color:#a5d6a7; }
+  .scale-table td.lv4 { background: rgba(155,89,182,0.18); color:#ce93d8; }
+  .formula {
+    margin-top: 12px; text-align:center; font-size: 15px; color: #cfd8ff;
+    background: rgba(61,139,253,0.08); border:1px dashed #3d8bfd;
+    padding: 10px; border-radius: 12px;
+  }
+  .formula b { color: #ffd700; }
+  /* 天梯榜 */
+  .rank-list { display: flex; flex-direction: column; gap: 8px; }
+  .rank-item {
+    display: grid; grid-template-columns: 56px 1.1fr 90px 90px 90px 90px 90px 70px 2.2fr;
+    align-items: center; gap: 6px;
+    background: rgba(255,255,255,0.045); border: 1px solid rgba(255,255,255,0.08);
+    border-radius: 12px; padding: 10px 12px; font-size: 13px;
+    transition: transform .15s;
+  }
+  .rank-item:hover { transform: translateX(4px); }
+  .rank-item.top1 { background: linear-gradient(90deg, rgba(255,215,0,0.16), rgba(255,255,255,0.04)); border-color: #ffd700; box-shadow: 0 0 24px rgba(255,215,0,0.15); }
+  .rank-item.top2 { background: linear-gradient(90deg, rgba(200,200,200,0.14), rgba(255,255,255,0.04)); border-color: #b8b8b8; }
+  .rank-item.top3 { background: linear-gradient(90deg, rgba(224,168,120,0.14), rgba(255,255,255,0.04)); border-color: #c07840; }
+  .rank-medal { font-size: 22px; text-align:center; }
+  .rank-name { font-weight: 700; color: #fff; }
+  .rank-item.top1 .rank-name { color: #ffd700; }
+  .cell { text-align:center; font-weight: 600; border-radius: 6px; padding: 4px 0; }
+  .cell.high { color: #ffd700; }
+  .cell.mid { color: #a5d6a7; }
+  .cell.low { color: #ff8a80; }
+  .cell.total { font-size: 15px; color: #fff; background: rgba(61,139,253,0.2); border-radius: 8px; }
+  .rank-item.top1 .cell.total { background: rgba(255,215,0,0.25); color: #ffd700; font-weight: 800; }
+  .rank-comment { font-size: 12px; color: #b0b7d0; line-height: 1.5; }
+  /* 灵枢依据 */
+  .lingshu-card {
+    background: linear-gradient(135deg, rgba(106,92,255,0.12), rgba(61,139,253,0.08));
+    border: 1px solid rgba(106,92,255,0.4); border-radius: 16px; padding: 18px 20px;
+    margin-top: 14px; box-shadow: 0 10px 40px rgba(61,139,253,0.15);
+  }
+  .lingshu-card h3 { color: #8fb8ff; font-size: 16px; margin-bottom: 10px; }
+  .lingshu-card .dim-row { display: grid; grid-template-columns: 90px 40px 1fr; gap: 8px; margin-bottom: 6px; font-size: 13px; }
+  .lingshu-card .dim-row b { color: #ffd700; }
+  .lingshu-card .dim-row .score { text-align:center; color: #fff; font-weight: 700; }
+  .lingshu-card .dim-row .why { color: #c5cbe8; }
+  .disclaimer { margin-top: 20px; font-size: 12px; color: #8a90b0; text-align: center; line-height: 1.7; }
+  .footer { text-align:center; margin-top: 30px; color: #6a6f8a; font-size: 12px; }
+</style>
+</head>
+<body>
+<div class="container">
+
+  <div class="hero">
+    <h1>📊 记忆系统使用性评分 · 五维标尺</h1>
+    <div class="sub">
+      视角：<b style="color:#ffd700">使用性</b>（普通用户 / 开发者体感）——「存、找、想、准、安」五维<br>
+      评估基准：公开能力 + 设计者校准（2026-08-17）· 灵枢分数经设计者核对（<b style="color:#7fb0ff">不虚高</b>）
+    </div>
+    <div class="badges">
+      <span class="badge hl">🥇 灵枢 AEIS · 7.7 断层第一</span>
+      <span class="badge">使用性视角</span>
+      <span class="badge">短板效应显著</span>
+      <span class="badge">安全性是底线</span>
+    </div>
+  </div>
+
+  <div class="section">
+    <h2>📐 五维标尺定义</h2>
+    <table class="scale-table">
+      <tr><th>维度</th><th class="lv0">0-2 危险</th><th class="lv1">3-4 基础</th><th class="lv2">5-6 良好</th><th class="lv3">7-8 优秀</th><th class="lv4">9-10 完美</th></tr>
+      <tr><td class="dim">S 存储结构</td><td class="lv0">扁平 KV</td><td class="lv1">简单分层</td><td class="lv2">时序/向量</td><td class="lv3">图结构+衰减</td><td class="lv4">多模态+自动迁移</td></tr>
+      <tr><td class="dim">R 检索机制</td><td class="lv0">全量遍历</td><td class="lv1">关键词</td><td class="lv2">向量语义</td><td class="lv3">图遍历+混合</td><td class="lv4">因果推理+意图理解</td></tr>
+      <tr><td class="dim">J 判断引擎</td><td class="lv0">只记不忘</td><td class="lv1">规则过滤</td><td class="lv2">LLM 自评估</td><td class="lv3">验证单元+递归反思</td><td class="lv4">独立元认知+主动遗忘</td></tr>
+      <tr><td class="dim">C 上下文信噪比</td><td class="lv0">噪声爆炸</td><td class="lv1">Top-K 有噪</td><td class="lv2">时序过滤</td><td class="lv3">重要性+精准注入</td><td class="lv4">零污染</td></tr>
+      <tr><td class="dim">Safety</td><td class="lv0">易泄露</td><td class="lv1">基础脱敏</td><td class="lv2">分级权限</td><td class="lv3">隐私树+审计</td><td class="lv4">零信任+端到端加密</td></tr>
+    </table>
+    <div class="formula">综合分 = <b>min(五维) × 0.4</b> + <b>mean(五维) × 0.6</b>　·　安全性是底线，短板效应显著</div>
+  </div>
+
+  <div class="section">
+    <h2>🏆 天梯榜</h2>
+    <div class="rank-list">
+      <div class="rank-item top1">
+        <div class="rank-medal">🥇</div><div class="rank-name">灵枢 AEIS</div>
+        <div class="cell high">7.5</div><div class="cell high">7.5</div><div class="cell high">8.0</div><div class="cell high">8.0</div><div class="cell high">8.0</div>
+        <div class="cell total">7.7</div>
+        <div class="rank-comment">五维无短板：图结构 + 三层语义检索 + 验证单元/递归反思 + 重要性评分 + 护栏宪章审计追踪</div>
+      </div>
+      <div class="rank-item top2">
+        <div class="rank-medal">🥈</div><div class="rank-name">Hy-Memory（腾讯）</div>
+        <div class="cell mid">7.5</div><div class="cell mid">7.0</div><div class="cell">6.0</div><div class="cell mid">7.0</div><div class="cell high">8.0</div>
+        <div class="cell total">6.6</div>
+        <div class="rank-comment">企业级安全标杆；缺主动反思，记忆易过时</div>
+      </div>
+      <div class="rank-item top3">
+        <div class="rank-medal">🥉</div><div class="rank-name">Zep / 腾讯云</div>
+        <div class="cell mid">7.5</div><div class="cell mid">7.0</div><div class="cell">5.5</div><div class="cell mid">6.5</div><div class="cell mid">7.5</div>
+        <div class="cell total">6.3</div>
+        <div class="rank-comment">时序图谱+权限控制；不够「聪明」</div>
+      </div>
+      <div class="rank-item">
+        <div class="rank-medal">4</div><div class="rank-name">Letta / MemGPT</div>
+        <div class="cell mid">7.5</div><div class="cell high">8.0</div><div class="cell">5.0</div><div class="cell high">8.0</div><div class="cell low">4.0</div>
+        <div class="cell total">5.7</div>
+        <div class="rank-comment">架构强但易记忆越权——权限模型复杂，风险高</div>
+      </div>
+      <div class="rank-item">
+        <div class="rank-medal">5</div><div class="rank-name">TiMem</div>
+        <div class="cell mid">7.0</div><div class="cell mid">6.5</div><div class="cell">5.0</div><div class="cell">6.0</div><div class="cell">5.0</div>
+        <div class="cell total">5.4</div>
+        <div class="rank-comment">学术派安全，缺工程级隐私治理</div>
+      </div>
+      <div class="rank-item">
+        <div class="rank-medal">6</div><div class="rank-name">Mem0</div>
+        <div class="cell">6.0</div><div class="cell">6.0</div><div class="cell">4.0</div><div class="cell">5.0</div><div class="cell low">4.0</div>
+        <div class="cell total">4.4</div>
+        <div class="rank-comment">记忆碎片化，细粒度权限缺失</div>
+      </div>
+      <div class="rank-item">
+        <div class="rank-medal">7</div><div class="rank-name">LangMem</div>
+        <div class="cell">6.0</div><div class="cell">6.0</div><div class="cell">4.0</div><div class="cell">5.0</div><div class="cell low">4.0</div>
+        <div class="cell total">4.4</div>
+        <div class="rank-comment">生态绑定 LangChain，缺独立安全治理</div>
+      </div>
+      <div class="rank-item">
+        <div class="rank-medal">8</div><div class="rank-name">dsh-memory-evolve</div>
+        <div class="cell low">3.0</div><div class="cell low">4.0</div><div class="cell low">2.0</div><div class="cell low">3.0</div><div class="cell low">2.0</div>
+        <div class="cell total">2.6</div>
+        <div class="rank-comment">无隐私/权限/删除，「只记不忘」= 隐私炸弹</div>
+      </div>
+    </div>
+  </div>
+
+  <div class="section">
+    <h2>🔍 灵枢各维度依据（设计者校准 · 不虚高）</h2>
+    <div class="lingshu-card">
+      <h3>🧠 灵枢 AEIS · 5.71MB 结构智能</h3>
+      <div class="dim-row"><b>S 存储</b><span class="score">7.5</span><span class="why">语义时空图（五层记忆：锚点/结构/知识/情境/自我）+ 条件空间 + 教育层级。无多模态原生（9-10 档）</span></div>
+      <div class="dim-row"><b>R 检索</b><span class="score">7.5</span><span class="why">三层语义检索（二元组 + 语义坐标 + bge 神经）+ 图谱遍历 + 翻译体系。无因果推理检索</span></div>
+      <div class="dim-row"><b>J 判断</b><span class="score">8.0</span><span class="why">验证单元（P37 三闸门）+ 递归反思（协议 3.12）+ 白箱校验 + 结构排斥。<b style="color:#7fb0ff">无主动遗忘 → 8.0 非 9.0</b></span></div>
+      <div class="dim-row"><b>C 信噪比</b><span class="score">8.0</span><span class="why">重要性评分 + 信息分层注入（图谱自处理→LLM 兜底→白箱校验）+ 诚实边界（不瞎编）</span></div>
+      <div class="dim-row"><b>Safety</b><span class="score">8.0</span><span class="why">护栏宪章（接入即接受约束）+ 审计追踪（观测层全留痕）+ 物理基底校准。<b style="color:#7fb0ff">无端到端加密 → 8.0 非 8.5</b></span></div>
+    </div>
+    <p style="text-align:center; margin-top:14px; color:#aab; font-size:14px;">
+      为什么断层领先：<b style="color:#ffd700">五维无短板（min=7.5）</b>——J（验证+反思）与 Safety（宪章+审计）是护城河。<br>
+      使用性视角：重要性评分 → 用户看不到废话；护栏宪章 → 用户敢把私密信息交给它。
+    </p>
+  </div>
+
+  <div class="disclaimer">
+    免责声明：他系统评分基于公开能力评估（2026-08-17），非官方基准；灵枢评分经设计者校准（不虚高）。<br>
+    综合分 = min × 0.4 + mean × 0.6 —— 安全性是底线，短板效应显著。
+  </div>
+  <div class="footer">灵枢 AEIS · 共同信任协议（Common Trust Protocol）· 智能论 v3.2 工程实现</div>
+
+</div>
+</body>
+</html>

package/lib/bridge.d.ts

@@ -62,6 +62,8 @@ export declare class LingshuBridge {
     dispose(): void;
     /** 进程是否存活。 */
     get alive(): boolean;
+    /** 桥是否已握手就绪（工具注册用；防止轮询访问 private readyState）。 */
+    isReady(): boolean;
     /** 等待握手完成（用于 apply 阶段同步就绪）。 */
     waitReady(): Promise<boolean>;
     private spawnAndHandshake;

package/lib/bridge.js

@@ -67,6 +67,10 @@ export class LingshuBridge {
     get alive() {
         return this.proc !== null && this.proc.exitCode === null;
     }
+    /** 桥是否已握手就绪（工具注册用；防止轮询访问 private readyState）。 */
+    isReady() {
+        return this.readyState === 'ok';
+    }
     /** 等待握手完成（用于 apply 阶段同步就绪）。 */
     waitReady() {
         if (this.readyState === 'ok')

package/lib/index.js

@@ -20,9 +20,10 @@ import z from '@deepseek-ai/schemastery';
 import { LingshuBridge } from './bridge.js';
 import { registerLingshuTools } from './tools.js';
 import { installMemoryHooks } from './hooks.js';
+import { installRoleplayWeb } from './roleplay_web.js';
 export const name = 'dsh-memory';
 /** 本插件依赖的工具注册服务。 */
-export const inject = ['tools', 'timer'];
+export const inject = ['tools', 'timer', 'webServer'];
 export const Config = z.object({
     serverName: z.string().default('lingshu'),
     python: z.string().default('python'),
@@ -81,14 +82,34 @@ export async function apply(ctx, config) {
     }
     const disposers = [];
     try {
-        // 工具注册（就绪后执行；未就绪时 tools/list 会报错，由重连机制兜底）
-        if (ready) {
-            disposers.push(await registerLingshuTools(ctx, bridge, {
-                selection: config.tools,
-                toolPrefix: `${config.serverName}_`,
-            }));
+        // 工具注册：初始就绪立即注册；若启动时未就绪（python 暂不可用/aeis 未装等
+        // 竞态），桥重连成功后自动补注册——修复"工具永久缺失"问题。
+        let toolsRegistered = false;
+        const tryRegister = async () => {
+            if (toolsRegistered || !bridge.isReady())
+                return;
+            try {
+                const dispose = await registerLingshuTools(ctx, bridge, {
+                    selection: config.tools,
+                    toolPrefix: `${config.serverName}_`,
+                });
+                disposers.push(dispose);
+                toolsRegistered = true;
+                ctx.logger.info('dsh-memory: 灵枢工具已注册（就绪后补注册）');
+            }
+            catch (err) {
+                ctx.logger.warn(`dsh-memory: 工具注册失败，稍后重试: ${String(err)}`);
+            }
+        };
+        if (ready)
+            await tryRegister();
+        if (!toolsRegistered) {
+            const poll = setInterval(() => { void tryRegister(); }, 2000);
+            disposers.push(() => clearInterval(poll));
         }
         installMemoryHooks(ctx, bridge, config.memory);
+        // 角色扮演网页（同源挂载 /roleplay，复用本插件 bridge）
+        await installRoleplayWeb(ctx, bridge, config, disposers);
         // 互维维护（v1.1）：心跳写戳 + 守护 A + 任务验证双通道
         if (config.mutual.enabled) {
             const { installMutualMaintenance } = await import('./mutual.js');

package/lib/roleplay_web.d.ts

@@ -0,0 +1,2 @@
+/** 在 webServer 上挂载 /roleplay 前缀路由（页面 + API）。失败不影响插件主体。 */
+export declare function installRoleplayWeb(ctx: any, bridge: any, config: any, disposers: any): Promise<void>;