AI导哈

语音备忘录转录工具

一款本地运行的语音备忘录工具，能够实时录音并自动转录为文字，支持后台常驻录音和无音区间自动跳过。

  • by Kaiji-erig
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Kaiji-erig/voice-memo

使用说明

语音备忘

经常录音对话，自动引起文字并保存的工具。 语音识别全部在本地执行，因此语音数据不会向外发送。

能做的事

  • 用麦克风录音的声音自动引起文字保存
  • 在后台经常录音（每30秒自动缩写）
  • 检索并参照Claude Code中保存的文字提示（MCP协作）
  • 无声区间自动跳过，误认（harucinection）也自动过滤器

需要的东西

  • Mac（Apple Silicon 推奨）
  • Python 3.10 以上
  • FFmpeg

安装，安装

1.安装ffmpeg

brew install ffmpeg

2.下载项目

git clone https://github.com/your-username/voice-memo.git
cd voice-memo

3.创建和安装Python环境

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

4.通过PATH（可从任何地方使用）

echo 'export PATH="$(pwd)/.venv/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

5.下载Whisper型号（仅第一次，约3GB）

python -c "import whisper; whisper.load_model('large-v3')"

如果出现SSL错误：

python -c "
import ssl; ssl._create_default_https_context = ssl._create_unverified_context
import whisper; whisper.load_model('large-v3')
"

使用方法

经常录音（主要功能）

# 開始（バックグラウンドで動き続けます）
voice-memo start

# 状態確認
voice-memo status

# 停止
voice-memo stop

缺省情况下，每隔30秒分隔一次区块，并在large-v3模型中进行字符生成。 无声区间将自动跳过。

手动録音

# Ctrl+C で停止するまで録音→文字起こし→保存
voice-memo record

# 録音時間を指定（秒）
voice-memo record --duration 60

确认已保存的文字提示

voice-memo list

Claude Code使用（MCP协作）

在Claude Code中注册为MCP服务器后，可以在任何项目中搜索文字生成数据。

claude mcp add --transport stdio voice-memo --scope user \
  /path/to/voice-memo/.venv/bin/python -- -m voice_memo.mcp_server

注册后，可以在Claude Code中听到以下内容：

  • “让我看看今天的笔记。”
  • “搜索关于预算的内容”
  • “请让我看一下备注ID3的全文”

数据位置

文件/位置 |---------|------| 数据库 ~/.voice-memo/voice-memo.db | 后台进程日志 ~/.voice-memo/daemon.log | 守护程序PID ~/.voice-memo/daemon.pid |

语音文件在文字唤醒后自动删除。仅保存文本。

隐私

  • 所有的语音识别 本地运行（无外部发送）
  • 声音数据是 未保存（文字启动后立即删除）
  • 仅保存文本

相关 MCP