watashi db
您拥有的个人上下文数据库。人工智能工具连接到它，而不是相反。
\[！注意\] v0.x处于早期阶段。 API和数据结构可能会发生重大变化。 所有数据都存储在本地(~/.watashi-db/default.db).没有任何东西被发送到外部。______________________________________________________________________
什么是watashi db？
每次你开始一个新的人工智能会话，你都是从零开始的——重新解释你的偏好、你的技术栈、你过去的决定。AI很聪明，但对你一无所知。
watashi db修复了这个问题。这是一个本地数据库，可以积累您的偏好、决策和经验，然后在会话开始时将它们提供给任何与MCP兼容的AI工具。
AI保持无状态。你获得了连续性。
之前/之后
| 之前 | 之后 | |
|---|---|---|
| 会话开始 | “我使用TypeScript，更喜欢日语评论，而且……”（每次） | AI都会通过以下方式自动加载您的个人资料 watashi_get(profile) |
| 过去的决定 | “我想我们上周决定了X……”（凭记忆） | /recall DB design 用推理得出确切的决定 |
| 经验教训 | 在会话之间丢失 | 随着时间的推移，剧集会提炼成可重复使用的见解 |
| 多工具 | 每个AI工具都有自己的筒仓 | 一个数据库，任何MCP客户端 |
______________________________________________________________________
这是给谁的？
每天使用MCP兼容的AI工具（Claude Code、Codex CLI、Gemini CLI、Claude Desktop等）并希望他们的AI在会话中记住上下文的开发人员，而无需将数据交给供应商。
______________________________________________________________________
主要特点
- 零努力记录 --在正常对话中，人工智能会在后台记录你的偏好、决定和经历。你不手动写任何东西。
- 体验蒸馏 --随着时间的推移，原始剧集被提炼成可重复使用的见解、模型和理论(
/groom).不仅仅是一个备忘录数据库。 - 完全本地化 --SQLite+FTS5。没有云，没有外部呼叫。您的数据保留在您的机器上。
- 供应商中立 --任何MCP客户端都可以连接。在不丢失上下文的情况下切换AI工具。
- 可审计的 --每次写入都会被记录（谁、什么、为什么）。更改将被撤回，从不删除。
- 多设备同步 --可通过Google Drive或任何云存储进行快照同步。
______________________________________________________________________
快速开始
步骤1：注册MCP服务器
# Claude Code
claude mcp add --scope user watashi-db -- npx -y watashi-db@latest
# Codex CLI
codex mcp add watashi-db -- npx -y watashi-db@latestGemini CLI
添加 ~/.gemini/settings.json:
{
"mcpServers": {
"watashi-db": {
"command": "npx",
"args": ["-y", "watashi-db@latest"]
}
}
}Claude Desktop
添加 claude_desktop_config.json:
{
"mcpServers": {
"watashi-db": {
"command": "npx",
"args": ["-y", "watashi-db@latest"]
}
}
}第二步：设置挂钩和技能（Claude Code）
npx watashi-db setup重新启动克劳德代码。就这样
- 钩子 自动提醒人工智能记录对话过程中的决策和经历
- @nologic 任何提示上的前缀都会跳过该消息的录制
- /召回 搜索您过去的决定、偏好和经历
替代方案：插件市场（克劳德代码）
如果你使用Claude Code，你可以通过插件市场一步安装所有内容（MCP服务器、钩子、技能、代理），并自动更新：
/plugin marketplace add bareforge/watashi-db
/plugin install watashi-db@watashi-db这相当于上述步骤1-2，但使用Anthropic的插件系统。
\[！提示\] @latest 确保每次重新启动客户端时都使用最新版本。有关详细设置（多设备同步、Codex CLI策略、Cowork插件、从源代码构建），请参阅 安装指南.
______________________________________________________________________
运作原理
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Claude Code │ │ Codex CLI │ │ Gemini CLI │ │ Any MCP │
│ (MCP Client) │ │ (MCP Client)│ │ (MCP Client)│ │ Client │
└──────┬───────┘ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
└─────────────────┼─────────────────┘
│ MCP (stdio)
┌─────────▼─────────┐
│ watashi-db │
│ (MCP Server) │
│ │
│ SQLite + FTS5 │
│ ~/.watashi-db/ │
└────────────────────┘- 你工作正常。 AI会在后台记录你的偏好、决定和经历。
- 旧唱片褪色。 随着时间的推移，条目自然会失去搜索优先级，不需要手动清理。
- 你跑
/groom偶尔地。 这将反复出现的模式提炼成持久的见解，因此有价值的经验教训在噪音消失时得以保留。
就是这样。没有实体类型需要学习，也没有手动标记。只需使用你的人工智能工具，让watashi db随着时间的推移构建你的上下文。
______________________________________________________________________
这有什么不同？
| 方法 | 局限性 | watashi db的答案 |
|---|---|---|
| CLAUDE.md/.cursorules | 静态指令，手动维护 | 动态体验记忆，人工智能自动记录 |
| ChatGPT内存/克劳德项目 | 供应商锁定、不透明、无导出 | 您拥有SQLite文件。任何MCP客户端都可以读取它 |
| 黑曜石+MCP | 通用笔记，无结构化体验模型 | 专为决策、事件和提炼而构建 |
| Mem0/Zep | 依赖云的内存层 | 完全本地，零外部依赖 |
watashi db是对CLAUDE.md的补充——静态规则放在CLAUDE.md中，不断发展的经验放在watashi db中。
______________________________________________________________________
文档
| 文档 | 描述 |
|---|---|
| 安装指南 | 安装、多设备同步、Cowork插件 |
| 配置指南 | 全部 config.json 选项 |
| 为什么选择watashi db | 哲学：人工智能协作中的无国籍问题 |
For contributors / deep-dive
______________________________________________________________________
发展
git clone https://github.com/bareforge/watashi-db.git && cd watashi-db
npm install && npm run build
npm test______________________________________________________________________
许可证
- 个人/非商业/教育/评估用途：始终免费
- 商业用途：需要许可证(bareforge.license@outlook.jp)
- 改变日期：2029-03-16之后，自动转换为Apache许可证2.0
\[！注意\] v0.0.12及更早版本是在MIT许可证下发布的。 如果您获得了MIT许可版本，您可以根据MIT条款继续使用该版本。