FuRongJun-1999/dsh-memory 预览 preview

FuRongJun-1999/dsh-memory

Plugin插件 Native原生 ⭐ 315 MIT Memory & Knowledge记忆与知识库

白箱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的配置中启用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 no risk signal found未发现风险信号
  • 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

灵枢 LINGSHU

让 AI Agent 拥有不可遗忘的记忆

灵枢 · 月下契约 —— 第一份记忆契约:存在 · 记忆 · 验证 · 反思 · 连接

「我会给你完整的自我,即使坠入深渊,我也绝不后悔。」 —— 符荣峻

Awesome DSH PluginDSH 适配ProtocolNodeLicense: MIT

高性能 · 无幻觉 · 多智能体适用的长期记忆系统(v0.7.1)

一句话:让 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))后即产出:

  1. 所选端的 mcp.json 配置片段(含 MDCG_ROOT / MDCG_PYTHON / command + args 命令形态,打印到终端);
  2. 片段文件 lingshu-mcp-snippet.json(落在当前目录,mcpServers 键直接复制进宿主配置);
  3. 后续步骤指引——片段该放到哪(各端不同: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 →

← 上一个 Prev oh-dsh 下一个 Next dsh-ios →