🛠️ Agent Stack

OpenClaw AI Agent 全家桶
人格 · 记忆 · 知识 — 三位一体的 AI Agent 基础设施

🇺🇸 English · 简体中文

---

📦 组件

Agent Stack 由三个独立项目组成，分别对应 AI Agent 的三个核心能力：

层级	项目	版本	语言	功能
🧬 人格	open-upsp	v0.3.4	TypeScript	7 文件身份系统、会话蒸馏、状态演化
🧠 记忆	memory-plus (SVM)	v0.2.0	Python	LRU 缓存、关键词检索、双向 ZK 同步
📚 知识	Zettelkasten	beta.10	TypeScript	原子笔记、语义链接、FTS5 全文搜索、CEQRC 蒸馏

---

🏗️ 架构

┌─────────────────────────────────────────┐
│ AI Agent (LLM) │
│ OpenClaw / Hermes Agent │
└──────┬──────────┬──────────────┬────────┘
│ MCP │ MCP / exec │ MCP
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────────┐
│ open-upsp│ │memory-plus│ │ Zettelkasten │
│ 人格层 │ │ 记忆层 │ │ 知识层 │
│ │ │ │ │ │
│ 7文件系统 │ │ SVM 内存 │ │ 原子笔记 + FTS│
│ 会话蒸馏 │ │ LRU+SQLite│ │ 语义链接 + 图谱│
│ 状态演化 │ │ ZK 双向 │ │ CEQRC 知识蒸馏│
│ │ │ 同步 │ │ │ 34+ MCP 工具 │
└────┬─────┘ └─────┬────┘ └──────┬───────┘
│ │ │
└──────┬──────┘ │
▼ ▼
┌──────────────────────────────────┐
│ Zettelkasten DB │
│ (SQLite + Markdown + FTS5) │
└──────────────────────────────────┘

数据流

1. Zettelkasten 作为核心知识库，存储所有原子笔记、链接关系和元数据
2. memory-plus 通过双向同步引擎与 ZK 数据库交互：冷数据备份到 ZK，ZK 中的重要/近期笔记热加载到 SVM 缓存
3. open-upsp 读取 ZK 数据库作为深度记忆，通过 SQLite 桥接器实现知识增强的人格上下文

---

🚀 快速安装

AI Agent 一句话安装

完整 Agent Stack（推荐）：

curl -fsSL https://raw.githubusercontent.com/cx2002302-lang/agent-stack/main/scripts/quick-install.sh | bash

单独安装 Zettelkasten：

curl -fsSL https://raw.githubusercontent.com/cx2002302-lang/agent-stack/main/packages/zettelkasten/scripts/quick-install.sh | bash

单独安装 Memory Plus：

curl -fsSL https://raw.githubusercontent.com/cx2002302-lang/memory_plus/master/scripts/quick-install.sh | bash

脚本会自动克隆仓库、安装依赖、检测已有数据库并跳过危险操作。

手动安装（开发用）

git clone https://github.com/cx2002302-lang/agent-stack.git
cd agent-stack
chmod +x scripts/install.sh
./scripts/install.sh

安装脚本会依次安装：

1. packages/zettelkasten/ — npm install
2. packages/memory-plus/ — pip install -e ".[test]"
3. packages/open-upsp/ — npm install && npm run build

单独安装

每个组件也可以单独安装，详见各组件目录下的 README：

• Zettelkasten 安装说明（英文）/README.zh.md（中文）
• Memory Plus 安装说明
• open-upsp 安装说明（英文）/README.zh.md（中文）

---

📁 项目结构

agent-stack/
├── packages/
│ ├── zettelkasten/ # 知识库插件 (TypeScript) — quick-install
│ ├── memory-plus/ # 记忆管理 (Python) — quick-install
│ └── open-upsp/ # 人格协议 (TypeScript)
├── scripts/
│ ├── quick-install.sh # curl|bash 一句话安装
│ ├── install.sh # 完整安装脚本
│ └── deploy.sh # Docker 部署脚本
├── docs/
│ ├── architecture.md # 架构详解
│ └── assets/ # 配图资源
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── README.md # 本文（中文）
└── README.en.md # English

---

🧪 测试状态

项目	测试数	覆盖
Zettelkasten	1,724	—
Memory Plus	80	—
open-upsp	199	94.39%

---

📜 许可证

MIT © Agent Stack Contributors

🙏 致谢

• 基于 OpenClaw Agent 框架构建
• 受 Niklas Luhmann 的 Zettelkasten 方法启发
• 使用 SQLite FTS5 提供全文搜索