wly8691-jpg/knowlp-rag

KnowLP-RAG: dual knowledge-graph RAG for Markdown notes — dsh plugin add @eqman00003/knowlp-rag · MCP + native Cordis plugin for DeepSeek Harness (dsh) & Claude Code

Bundle 已验证 MIT Python 未知

★ 3 在 GitHub 查看

版本未知

语言Python

许可证MIT

在 GitHub 查看

预览

功能介绍

Markdown 笔记的双知识图谱 RAG：前置依赖 + 相似关联双图（P/S-Agent 遍历）、段落级匹配、ngram/embedding 混合检索、显式权重反馈闭环，以 MCP 接入。

适合

希望按前置依赖和相似替代关系安排检索与阅读顺序的 Markdown 笔记库。
需要在 DSH 或 Claude Code 中结合段落级匹配、ngram、向量与知识图谱检索的工作流。
希望通过显式反馈持续调整图关系权重的知识库。

不适合

并非以 Markdown 笔记存储，或不需要关系感知检索的资料库。
无法同时提供 Markdown 笔记目录和可写图索引目录的环境；缺少这些配置时只剩全文搜索。
只需一次性关键词搜索，不需要索引、图遍历或反馈闭环的用户。

README

KnowLP-RAG

双图检索 + 衰减遗忘的记忆插件 —— 把你的 Markdown 笔记建成会”用进废退”的知识图谱,给 DSH / Claude Code 提供带阅读路径的检索:该读哪几篇、按什么顺序读、哪篇是相似替代。

快速开始(3 步)

# ① 安装(npm 官方源)
dsh plugin add "@eqman00003/knowlp-rag"

# ② 必配两个环境变量(不配则双图引擎空转,只剩全文搜索)
export KNOWLP_VAULT="$HOME/Notes"              # 你的 Markdown 笔记目录
export KNOWLP_GRAPH_DIR="$HOME/.knowlp-dsh"    # 可写索引目录

# ③ 重启 dsh web,首次搜索触发 Python 环境自举(约 30s,勿中断)

五个工具

工具	作用
`knowlp_search`	四引擎扇出检索(双图 P/S-Agent + 向量 + 全文)
`knowlp_get_note`	读笔记内容(只读,防路径穿越)
`knowlp_stats`	引擎/图健康度自检(排障第一入口)
`knowlp_record_feedback`	显式反馈(权重闭环唯一入口)
`skill_search`	技能索引检索

文档

安装与使用说明:docs/usage.md
排障手册:docs/troubleshooting.md
dsh 接入细节(环境变量/Cordis 插件):dsh/README.md

为什么是 KnowLP?

Grep 搜 “RAG architecture” 给你 105 个文件。KnowLP 给你 3 条带依赖上下文的排序命中。

	`grep`	朴素向量库	KnowLP
结果排序	❌	✅	✅
依赖链(P-Agent)	❌	❌	✅
相似替代(S-Agent)	❌	❌	✅
无 GPU 可用	✅	❌	✅(n-gram 模式)
越用越好(反馈)	❌	❌	✅(权重闭环)
段落级匹配	❌	❌	✅
衰减遗忘(用进废退)	❌	❌	✅(半衰期三档)

区别:向量搜索找”包含关键词”的文档;KnowLP 找”因你的查询而该读”的文档,附阅读路径。笔记间的权重随使用演化——被消费的边加强,长期不用的边按半衰期衰减(过程性 1 天 / 一般 30 天 / 陈述性永不)。

Demo

$ knowlp_search "RAG architecture"
  1. [HIT]  RAG检索架构.md (score 0.77)
  2. [LINK] 向量数据库选型.md (score 0.61)     ← 前置依赖链
  3. [LINK] 检索评估踩坑记录.md (score 0.42)
  4. [LINK] _索引-阅读顺序 (depth 1)            ← 告诉你从哪里读起
  5. [LINK] _索引-相关概念.md (depth 2)

本地开发

git clone https://github.com/wly8691-jpg/knowlp-rag.git
cd knowlp-rag
pip install -e .            # 生成 knowlp-mcp / knowlp-build / knowlp-search

# config.yaml 里配 vault → 建图 → 检索
python build_graph.py
python knowlp_search.py "RAG architecture"

View Architecture Diagram

安装

dsh plugin --profile default add github:wly8691-jpg/knowlp-rag

卸载：dsh plugin --profile default remove github:wly8691-jpg/knowlp-rag

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:wly8691-jpg/knowlp-rag。命令会解析公开 package 元数据，并保持插件与本页展示的目录身份一致。

volcengine/OpenViking · examples/dsh-memory-plugin★ 28,960

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件：pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护，以及对接 OpenViking 服务端的 recall/write 记忆工具。

AGPL-3.0

vectorize-io/hindsight · coding-agents★ 20,126

Hindsight：会学习的 Agent 长期记忆系统，自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。

MIT

Ikalus1988/MisakaNet★ 404

失败恢复记忆库：从真实工程会话中搜索和记录失败恢复教训，支持 BM25 + 语义 RAG 检索和知识库管理。

Apache-2.0

text2future/flowix · dsh-flowix-memory★ 316

将本地 flowix-cli 注册为 MCP 服务，让 agent 可以搜索、读取、创建和编辑 Flowix 备忘与思维导图产物。

MIT