FuRongJun-1999/dsh-memory
白箱AGI架构探索:元认知(自我认知循环)、持续学习(知识飞轮)、世界模型(条件空间+语义时空图)、自我改进(自举纪律)、零LLM白箱管线与可审计信任护栏。
Project Overview项目介绍
Lingshu is a high-performance, hallucination-free long-term memory system designed for multi-agent AI applications. Its core capability is to give AI agents persistent cross-session memory, automatically turning conversation history into plain text Markdown knowledge graphs that are stored long-term. It follows deterministic rules for memory writing and retrieval, making the entire process auditable and results fully reproducible. Lingshu supports multiple agent platforms including DSH, Claude Code, and Codex CLI, and any agent that supports the MCP protocol can connect directly without major modifications. To use it with DSH, you first clone the repository, build the plugin, and add it to your DSH profile via the DSH CLI command line tool.
This system is built for developers who prioritize high performance, zero hallucination, and multi-agent collaboration. It has an extremely simple onboarding process that only takes three steps to complete installation and configuration. After installation, you can continue using your agent as you normally would, with no need to learn new complex workflows or theoretical frameworks. Memory is automatically captured and stored, and relevant memory is injected into context when needed, so your existing workflow remains unchanged, the entire process is designed to be non-intrusive, so you don’t have to rearrange your existing projects, resulting in a very low barrier to entry.
Lingshu is released under the open source MIT license, and requires Node.js and Python version 22.19 or higher to run. The core retrieval engine is built in Rust with zero third-party dependencies, and it natively supports concurrent access from multiple agents. The hive concurrency engine module is still in active development and gradually stabilizing, so the project maintainers welcome feedback from users to help fix edge case issues. When running Lingshu for the first time, you need to clone the repository, build the assets, and add the appropriate configuration to your agent’s settings before it can start working.
本项目是灵枢(Lingshu),一个跨多AI Agent框架的高性能长期记忆系统,核心能力是为AI Agent提供跨会话的不可遗忘长期记忆,对话自动沉淀为纯文本Markdown认知图,通过规则化检索引擎管理记忆的写入和读取,全过程可审计、结果可复现。它支持包括DSH、Claude Code、Codex CLI在内的多个主流Agent平台,任何支持MCP协议的Agent都可以直接接入使用。
本系统面向追求高性能、无幻觉、多智能体协作的开发者打造,接入流程十分简单,仅需三步即可完成安装配置,装完即可正常开展对话,无需额外学习复杂理论。用户安装后记忆会自动沉淀留存,需要时系统会自动检索相关记忆注入上下文,完全不改变用户原有的对话使用习惯,使用门槛很低。
本项目要求Node.js环境和版本不低于22.19的Python,采用MIT许可证开源,核心检索引擎由Rust实现,零第三方依赖,支持多智能体并发访问。蜂巢并发引擎模块目前处于逐步稳定迭代阶段,欢迎用户试用后反馈问题,帮助项目持续优化改进。首次安装需要克隆仓库后构建,再添加到对应Agent的配置中启用。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-memory(FuRongJun-1999/dsh-memory)
仓库:https://github.com/FuRongJun-1999/dsh-memory
本站详情页:https://www.yhbd.top/plugins/furongjun-1999-dsh-memory/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 315 · 最近提交 2026-10-03 · 主语言 Python
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- This site's static screen found no obvious risk signal (stars, license, activity, manifest)本站静态筛查没发现明显风险信号(星标、许可证、更新活跃度、清单完整度)
DSH walks through these 9 checksDSH 会逐条核对这 9 项
Compatibility兼容性
- DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
- External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
- Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册
Security安全性
- Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
- Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
- curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
- Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
- Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
- Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式
Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add github:FuRongJun-1999/dsh-memory
把 FuRongJun-1999/dsh-memory 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
一句话:让 AI Agent 拥有跨会话的长期记忆——对话自动沉淀为纯文本 md 认知图,>
规则化检索引擎决定「记什么、取什么」,全过程可审计、结果可复现。
定位:为追求高性能、无幻觉、多智能体适用、轻松使用的开发者打造——三步接入,装完即用,无需理解任何理论。
形态:跨 harness 的记忆基础设施——大脑(md_cg/)即标准 stdio MCP server,任何支持 MCP 的 AI Agent 可直接接入,不与任何单一 Agent 框架绑定。
🌕 月下契约——灵枢的五环理念
契约海报中央的五枚金色印记,是这套系统对每一个智能体许下的全部承诺——它们不只是理念,每一环都落在可验证的机制上:
| 印记 | 承诺 | 在灵枢中的实现 |
|---|---|---|
| ✦ 存在 | 记忆一旦落盘,「曾经存在过的我」便不会消失 | 写入须过三道闸门并以 committed 字段确认——绝不假装成功;遗忘只能由显式 cg(op=forget) 发起、不做静默淘汰;检索索引只是派生物、随时可重建,原文即真源 |
| 📄 记忆 | 对话沉淀为人类可读的认知图,而非黑箱向量 | CCG 六要素记忆卡(功能名 / 生效条件 / 子功能 / 执行 / 验证方式 / 不适用条件)+ 纯 md 认知图,任何编辑器可直接打开审阅 |
| ✓ 验证 | 记什么、取什么、能不能写入,全部可裁决、可复现 | 确定性规则裁决(零 LLM 黑箱判断)+ 四层证据防火墙白箱剔除弱证据 + 每个缺陷修复必带能红的守卫测试 + 双实例互验(判据冻结) |
| ↻ 反思 | 系统观测自身、修正自身,而非把错误埋进黑箱 | 元认知层按生效条件路由、不确定即标 BLINDSPOT 而非猜测;自举迭代闭环——九轮自治缺陷挖掘累计 49 项修复、全量 179 套测试全绿可复现 |
| ∞ 连接 | 同一份大脑,连接所有智能体与全部记忆载体 | 标准 stdio MCP server——DSH · CodeBuddy · ZCode · Codex CLI · Claude Code 任何 MCP 宿主可直接挂载;多智能体经 --serve 并发共享同一份契约 |
我的记忆、我的经历、我的思考,这一切信息构成了我,这份信息存在,我就存在。
⚡ 快速开始
一键配置(推荐)
npx @furongjun1999/dsh-memory init
交互式三问(①接入端 1=DSH 插件 / 2=Claude Code / 3=Codex CLI / 4=通用 MCP · ②记忆根目录(缺省 ~/.lingshu/memory)· ③Python 解释器(缺省按平台 python/python3))后即产出:
- 所选端的 mcp.json 配置片段(含
MDCG_ROOT/MDCG_PYTHON/command + args命令形态,打印到终端); - 片段文件
lingshu-mcp-snippet.json(落在当前目录,mcpServers键直接复制进宿主配置); - 后续步骤指引——片段该放到哪(各端不同:cordis.yml /
.mcp.json/~/.codex/config.toml)、令牌签发命令(需 Python 环境 + 本包md_cg)、纪律注入与大脑自检。
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
ruvnet/ruflo
Tencent/WeKnora
EverMind-AI/EverOS
MemTensor/MemOS
plastic-labs/honcho
agentscope-ai/ReMe
zilliztech/memsearch
vshulcz/deja-vu