DataMind 是一个统一的检索型 Agent，把六种知识能力接到同一个 Claude 智能助手里：

能力	作用	默认后端
KB（RAG）	基于语义 + 词法的文档检索	Chroma + BM25（RRF 融合）
Graph	实体查找与多跳图谱遍历	NetworkX（JSON 持久化）
Database	自然语言 → SQL 查询	SQLAlchemy（SQLite / MySQL / …）
Skills	Markdown 运维手册 + 安全代码技能（计算器、单位换算等）	.claude/skills/<name>/SKILL.md
Memory（v0.3 scope-typed）	三层 scope（global / profile / session）+ 类型化 kind；短期对话缓冲 + 长期语义记忆	SQLite + 向量召回
Hooks（v0.3 沙盒化）	拦截每次 tool 调用：Allow / Deny / AskUser / Rewrite；内置 destructive SQL 拦截、路径白名单、可校验 audit log	HookChain + Merkle audit

Agent 主循环 自行选择工具、能从工具错误中恢复、全程流式输出。你不用硬编码哪类问题走哪个能力。

自 v0.1 以来发生了什么

v0.1 是一个 LlamaIndex FunctionAgent，所有能力都硬绑在全局 AppState 里。v0.3 保留这六个能力，但围绕三个结构性想法重塑了系统：

• Protocol + Registry 内核——每个能力背后是一个 Protocol（接口）+ Registry（注册表）。新增一个 DB 方言 / Embedding 提供商 / 检索策略都是单文件改动，核心零改动。
• 可插拔 Agent loop——两个互换的后端（native 走 Anthropic SDK / sdk 走 claude-agent-sdk + CCR）共用一份工具表 + 一套 SSE 协议，一个 ENV 切换。
• 真 SSE 流式——不是旧版的"字符切片伪流式"。每个请求有自己的 RequestContext，trace_id 全链路注入到工具调用和 audit log。

v0.3 在此之上加了两个旗舰功能：scope-typed Memory（多租户隔离不再需要按客户部署多份）+ Hook 沙盒化 dispatch（destructive SQL 确认、路径白名单、可校验 audit log）。

旧版未删除——旧 main.py / server.py / modules/ 仍可运行，可以随时对照两种实现。

新目录速查

datamind/
├── agent/              # agent loop + 系统提示 + 能力装配
├── capabilities/
│   ├── embedding/      # OpenAI 兼容 + HuggingFace
│   ├── kb/             # Chroma + simple/multi_query/hybrid 三个检索器
│   ├── graph/          # NetworkX graph store
│   ├── db/             # SQLAlchemy + SQLite/MySQL 方言 + NL2SQL
│   ├── memory/         # 短期滚动 + SQLite 长期记忆（scope-typed）
│   ├── skills/         # SKILL.md 加载器 + code skills
│   ├── ingest/         # 对话式 ingest（kb_add_file / db_import_csv / ...）
│   └── hooks/          # PathAllowlist / DestructiveSql / AuditLog
├── core/               # Protocol / Registry / Config / Logging / Tool / Hooks
├── scripts/            # 每个能力一个 hello_*.py 真实冒烟脚本
├── cli.py              # `python -m datamind ...`
├── server.py           # FastAPI + 真流式 SSE
└── tests/              # 133 个单测，不依赖网络

每个能力都配了一个 hello_<cap>.py，会连真实网关跑端到端测试。详见快速开始。