内容
论上内存
TIM 是一个面向 AI 代理的本地优先内存系统。在中，核心用户界面是 `tim`界面、 `cp` 服务器 SQLite 的存储以及用于旧 `.hmem` 数据库的迁移工具。
本项目处于 **公开测试** 阶段。核心功能可用，但接口和发布形态仍在调整中。请预期会有破坏性变更。
## 要求
- Node.js 22 或更新版本
- npm 10 或更新版本
- 通过捆绑包使用基于 SQLite 的存储
## 快速入门
```bash install
npm run build
npm run lint
```
在工作运行 CLI：
```bash
node packages/tim-cli/dist/cli.js init
node packages/tim-cli/dist/cli.js doctor
node packages/tim-cli/dist/cli.js stats
```
默认数据库路径是 `~/.tim/tim.db`。如果您希望 TIM 使用其他位置，请使用 `TIM` 环境变量覆盖它。
## 常用命令
- `tim init` - 创建数据库、注册默认代理并写入 MCP 配置
- `tim doctor` - 检查健康状况、计数、损坏的链接和孤立的条目
- `tim stats` - 以 JSON 格式打印数据库统计信息
- `tim import <file.hmem>` - 导入旧mem 数据库
- `tim export <file.hmem>` - 导出当前的 TIM 数据库
- `tim snapshot` - 创建 SQLite 备份快照
- `tim restore` - 从快照恢复
- `tim record-commit` - 在项目树中记录 git 提交
- `tim statusline` - 为 shell 或 TUI 渲染紧凑的状态行
运行 <command> --help特定命令的使用帮助。`init`、`doctor`、`stats` 和 `import` 命令的帮助任何数据库工作之前退出 从 hmem 迁移
帮助 h切换到 TIM 的代理应遵循 [`docs/hmem-to-tim-migration.md`](docs-to-tim-migration.md) 中的迁移操作手册。安全的流程是：`tim doctor`、`tim import <file.hmem> --dry-run --deduplicate`、`tim，然后 `tim import <file.hmem> --dedu。
## MCP 设置
`tim init` 会写入 `~/.tim/mcp.json`，其中包含一个-mcp` 条目本地数据库。如果您手动配置，服务器是 `tim-mcp它会读取 `TIM_DB_PATH## 备份和恢复
使用 `tim snapshot` 创建 SQLite 数据库的备份副本，然后使用 `tim restore` 将其恢复。快照/恢复流程旨在用于本地恢复和在机器之间迁移。
## 同步
TIM-sync 存在于此工作区中，但它是可选的，不属于此处记录的核心本地内存路径。不要期望它对于基本 CLI、MCP
