# codebuddy-mem

跨会话持久记忆系统 — 基于 [claude-mem](https://github.com/thedotmack/claude-mem) AGPL-3.0 分叉，适配 DeepSeek V4 / CodeBuddy Code。

## 与 claude-mem 的区别

| 项目 | claude-mem | codebuddy-mem |
|------|-----------|---------------|
| AI 后端 | Claude API | DeepSeek V4（直连） |
| MCP 客户端 | Claude Code | CodeBuddy Code |
| 仓库 | github.com/thedotmack | git.yxcowork.vip/qiukai |
| 维护 | @thedotmack | 筑基阁 / 开阳星 |

## 功能

- **跨会话记忆**：自动记录所有操作，下次会话自动恢复上下文
- **语义搜索**：搜索历史会话中的工具调用、观察记录、输出
- **语料库**：构建知识语料库，通过 AI 问答检索
- **代码结构**：smart_outline / smart_unfold 快速浏览代码

## 安装

### 方式一：独立 MCP 服务

```bash
# 克隆仓库
git clone https://git.yxcowork.vip/qiukai/codebuddy-mem.git ~/.codebuddy-mem

# 安装依赖
cd ~/.codebuddy-mem && bun install

# 配置 MCP（~/.codebuddy/.mcp.json）
{
  "mcpServers": {
    "codebuddy-mem": {
      "type": "stdio",
      "command": "bun",
      "args": ["~/.codebuddy-mem/scripts/mcp-server.cjs"]
    }
  }
}
```

### 方式二：CodeBuddy 插件

```bash
bash install.sh
```

## 配置

配置文件：`~/.codebuddy-mem/settings.json`

```json
{
  "CODEBUDDY_MEM_PROVIDER": "deepseek",
  "CODEBUDDY_MEM_DEEPSEEK_API_KEY": "sk-xxx",
  "CODEBUDDY_MEM_MODEL": "deepseek-chat",
  "CODEBUDDY_MEM_WORKER_PORT": "37701"
}
```

## 协议

AGPL-3.0 — 继承自 claude-mem，源码必须保持开放。

## 上游

本仓库基于 [claude-mem v12.6.0](https://github.com/thedotmack/claude-mem) 分叉。详见 [UPSTREAM.md](./UPSTREAM.md)。
