内容
# 回溯记录
**您的 AI 工作日志 — 自动、隐私、本地。**
回溯记录会在您编码时自动记录您的工作内容 — 决策、错误、人员、参考资料 — 所有内容都存储在本地的 SQLite 数据库中。无需账户，无需云存储，无需数据离开您的机器。
您可以查询您的工作历史记录，时间范围可达数月：
- "上个月的缓存错误是什么？"
- "谁负责支付集成？"
- "给我昨天的日报总结"
## 设置
无需安装 — 只需将回溯记录添加到您的 MCP 客户端配置文件中。它会在首次运行时自动下载。
### Claude Desktop
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"retrace": {
"command": "npx",
"args": ["-y", "retrace-mcp"]
}
}
}
```
### VS Code (GitHub Copilot)
添加到您的 `.vscode/mcp.json`：
```json
{
"servers": {
"retrace": {
"command": "npx",
"args": ["-y", "retrace-mcp"]
}
}
}
```
### Cursor
添加到 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"retrace": {
"command": "npx",
"args": ["-y", "retrace-mcp"]
}
}
}
```
就这样。开始编码会话，回溯记录将自动开始记录您的工作。
> **可选：** 如果您更喜欢永久安装，请运行 `npm install -g retrace-mcp`。
## 工作原理
1. **添加配置** — 粘贴上面的代码段，无需账户
2. **正常编码** — 您的 AI 代理自动记录有意义的工作条目
3. **随时查询** — 询问过去的工作，获取完美的总结，找到谁了解什么
AI 会在您工作时主动记录条目。您无需打开应用程序或手动编写任何内容。
## 工具
| 工具 | 描述 |
|------|-------------|
| `log_entry` | 记录一个工作记忆条目（AI 自动调用此功能） |
| `query_journal` | 按日期、项目、类别、人员、组件搜索和筛选条目 |
| `recall` | 跨所有条目的自然语言搜索 |
| `get_summary` | 用于日报的每日总结 |
| `list_projects` | 列出所有记录的项目 |
| `who_knows_about` | 查找对某个主题有经验的人员 |
| `delete_entry` | 按 ID 删除条目 |
## 数据存储
所有数据都存储在本地 SQLite 数据库中：
```
~/.retrace/journal.db
```
要使用自定义路径：
```bash
retrace-mcp --db-path /path/to/my/journal.db
```
或设置环境变量：
```bash
RETRACE_DB_PATH=/path/to/my/journal.db
```
### 备份
只需复制数据库文件：
```bash
cp ~/.retrace/journal.db ~/.retrace/journal.backup.db
```
## 云升级
想要多设备同步、网页仪表盘、团队记忆和加密云存储？请直接将您的 MCP 客户端连接到回溯记录云端点 — 无需本地安装。
了解更多信息，请访问 [retrace-zeta.vercel.app](https://retrace-zeta.vercel.app)
## 要求
- Node.js 18+
## License
MIT
