本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-memory

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @furongjun1999/dsh-memory

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• id: lingshu-memory
• 普通 SQLite 记忆插件：KEY→VALUE 字面存储，跨会话基本靠睁眼不见。无自省、无演化、无信任。
• 灵枢：时空记忆图把记忆组织成语义+时空坐标的关系网络——可检索、可去重、可分级、可关联；知识飞轮让它越用越聪明;护栏与宪章让它可信任地被接入。
• 减少信息差（D_norm）：信息差 = 协作行为的不确定性（信任 / 行为 / 连接 / 预测误差 四维加权）。灵枢持续记录、收敛与协作对象的认知偏差——信息差缩小是智能运转的目标本身。
• 信任是可被长期维护的：协议定义信任为「协作者行为在可接受偏差范围内保持稳定的置信概率」（而非信息差的简单补集）——信任依靠持续、可观测、一致的行为来建立与维护，而非一次性的声明。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装完插件就能直接用吗？

不行。插件本身只是一个 TypeScript 桥，运行时必须额外安装灵枢 Python 后端（pip install aeis 或 git+ 方式），否则启动会失败并进入后台重试。

能不能直接 npm install 装到 profile 的 node_modules 里？

不建议。README 明确要求用 dsh plugin --profile add 走 pnpm 协调入口，否则会把错误的 @deepseek-ai peer 包版本装进 profile，导致插件加载或浏览器报错。

记忆存放在哪里？如何迁移或备份？

全部存放在 dbPath 指向的 SQLite 文件里（默认 data/lingshu.db，目录不存在时自动创建）。备份只需拷贝该 .db 文件；卸载插件不会删除数据。

默认会记住哪些内容？agent 回复会进记忆库吗？

默认仅自动记忆来自真实用户的消息（source.kind === 'user'），跳过插件注入的 AGENTS.md 等系统上下文；agent 回复与工具结果默认关闭，需开启 memory.assistantMessage / memory.toolResult 后才会写入。

启动时找不到 python 或 aeis 会发生什么？

插件不会立刻让 DSH 启动失败——默认 failOnStartupError=false，会在日志里告警并按指数退避（最长 maxRetryDelayMs）持续重试；想立即报错就把 failOnStartupError 设成 true。

38 个工具太多了，如何只暴露常用的一批？

把 tools 字段从默认的 'brain' 改为 'core'（12 个精选：remember/recall/search/timeline/think/relate/predict_routes/ingest_text/ingest_url/session_note/self_check/service_info），或直接传一个工具名数组做白名单。

灵枢 Python 进程崩了怎么办？

桥接层会自动指数退避重启并重新走 MCP 握手（initialize → notifications/initialized），但挂起的请求会一次性失败；可在 mutual.enabled=true 时额外获得心跳与守护能力（需双沙箱部署）。

这个插件和 DSH 自带的 session-persistence 有什么区别？

session-persistence 保存的是会话日志原文，而 dsh-memory 把消息做语义沉淀——写入灵枢知识图谱、带重要性评分与去重，可以跨会话检索召回和推理，而不是按时间回放。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6（peer 锁定 @deepseek-ai/dsh-session 与 dsh-tools ^0.1.0-rc.6）
• Node: >=18（README 同时要求 DSH 宿主为 Node ≥22.19）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则