内容
# 回声记忆
[中文文档](README.zh-CN.md) · [代理上下文](docs/agent-context.md) · [MCP 参考](docs/mcp.md) · [安全](SECURITY.md)
**一款适用于 macOS 的本地优先的对话记忆库。** 回声记忆将重要的音频转换为可搜索的文字记录、可追溯的决策、行动项和可重用的 AI 工具上下文。
它的目的不是一次性会议总结应用，而是帮助您回到**说了什么、为什么做出决定以及在哪里找到支持证据**。
> 当前状态：Alpha。源代码构建支持；尚未发布签名的 macOS 安装程序。
## 为什么选择回声记忆
重要的项目上下文通常存在于通话、采访、客户对话和个人语音笔记中。录音很难回顾，总结可能会丢失证据，而 AI 工具经常缺乏过去决策背后的背景。
回声记忆将音频、带有时间戳的文字记录、结构化分析和源引用一起保存在您的 Mac 上，以便结论可以追溯到原始文字和音频位置。
## 功能
- 将 `MP3`、`M4A` 和 `WAV` 文件导入带有重复检测的托管本地库。
- 使用嵌入式 Whisper 或本地 `whisper.cpp` 命令进行本地转录；点击文字记录段落即可跳转到音频并编辑更正，而不会覆盖原始文本。
- 通过本地 Ollama 模型提取摘要、关键点、决策、行动项和开放性问题。
- 要求决策和行动项引用源文字记录段落；未验证的引用将被标记，而不是捏造。
- 构建基于项目的个人知识库，并搜索标题、文字记录、摘要、决策和行动项，限定时间范围。
- 暴露一个用户启用、仅限本地、只读的 MCP 服务器，以便 AI 工具可以检索相关的历史上下文和源证据。
## 设计本地优先
音频、文字记录、SQLite 数据和 MCP 在您的机器上运行。在当前的 Alpha 版本中，回声记忆不会上传音频或文字记录，静默回落到云处理，暴露公共网络监听器，或让 MCP 写入您的库。
权衡是刻意的：本地转录和分析需要本地依赖。缺少的模型或失败的分析会被清楚地显示，并且永远不会破坏已经保存的音频或文字记录。
## 产品流程
```text
导入音频
-> 本地带时间戳的文字记录
-> 基于源的决策和行动项
-> 项目知识库 + 全文搜索
-> AI 工具的只读 MCP 查询
```
## 产品概述
以下概念界面使用虚构的演示数据。它说明了核心工作流程：导入音频、导航带时间戳的证据，并将结果保存在本地项目库中。
## MCP：通往 AI 的桥梁，而不是数据导出
MCP 默认禁用。当您在应用中启用它时，回声记忆提供一个本地 stdio 服务器，带有用于搜索记录、读取限定文字记录范围、列出项目、检索项目上下文和列出行动项的只读工具。
服务器记录查询元数据，而不是音频、文字记录主体或密钥。它永远不会打开公共端口，也不能写入、编辑或删除您的记录。有关工具列表和开发配置，请参阅 [MCP 参考](docs/mcp.md)。
## 个人知识库和第二大脑
每个对话都可以分配给一个项目。随着时间的推移，库使重复的决策、承诺、问题和原始措辞在对话中可发现。目标不是取代您的笔记；而是保留一层可验证的工作记忆，您和您的 AI 工具可以重温。
## 音频硬件和录音卡
回声记忆当前接受导出的音频文件。如果 AI 记录器、录音卡、电话或现场录音机可以导出 MP3、M4A 或 WAV 文件，则该文件可以进入相同的本地工作流程。直接设备集成不是当前 Alpha 版本的一部分，也不是此存储库的隐含内容。
## 要求
- macOS
- Node.js 18+，Rust 稳定版，Cargo，Xcode 命令行工具和 CMake，用于第一个嵌入式 Whisper 构建
- 用于转录的本地 Whisper `ggml-*.bin` 模型
- 可选的本地 `whisper-cli` / `WHISPER_CPP_BIN`
- 可选的本地 Ollama 服务和模型用于分析
## 在本地运行
```bash
cd app
npm install
bash scripts/check-env.sh
npm run tauri dev
```
默认本地库是 `~/Library/Application Support/回声记忆`。对于开发和测试，请将 `ECHO_LIBRARY_ROOT` 设置为隔离目录。
## 验证
```bash
cd app
npm run typecheck
npm run build
cd src-tauri
cargo fmt --check
cargo test --features mcp-bin
```
## 范围和路线图
Alpha 版本专注于单用户、单设备本地工作流程。它当前不提供实时录音、自动会议加入、移动或 Windows 应用、云同步、团队协作、付款/积分、公共 API、外部系统写入或 MCP 写入。
未来的探索可能包括更高质量的处理和音频硬件工作流程，但这些不是当前的产品声明。
## 贡献和安全
欢迎贡献。请在打开问题或拉取请求之前阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。永远不要将带有敏感内容、凭证或付款数据的真实音频、文字记录、日志附加到公共问题上。请参阅 [SECURITY.md](SECURITY.md) 以进行私人漏洞报告。
## 支持
回声记忆是免费且开源的。如果它对您的工作有帮助，您可以给项目买一杯咖啡。支持有助于覆盖持续的维护、兼容性测试和文档；它不授予付费功能或优先支持。
<p align="center">
<img src="docs/images/support-qr.png" alt="给回声记忆买一杯咖啡" width="260">
</p>
## 许可证
Apache-2.0。请参阅 [LICENSE](LICENSE)。
