v1.0.0

SonicNoteSync-Vscode

妙记录音同步 VSCode 插件 — 一键拉取录音、转录、总结为本地 Markdown 文件

下载安装包

前置要求

功能特性

🔄
录音同步
从妙记服务器拉取录音列表，同步为本地 Markdown 文件
📝
逐字转录
自动获取录音的转写文本，支持说话人标注
🤖
AI 智能总结
内置 AI 总结模板，自动生成会议纪要、课堂笔记等
📁
本地化管理
文件列表支持打开、访达查看、复制内容、删除等操作

安装方法

方法一：命令行安装（推荐）

  1. 点击上方按钮下载 SonicNoteSync-vscode-1.0.0.vsix
  2. 打开终端，运行安装命令：
code --install-extension SonicNoteSync-vscode-1.0.0.vsix --force

如果 code 命令未配置，先在 VSCode 中按 ⇧⌘P，输入 Shell Command: Install 'code' command in PATH 进行安装。

方法二：界面安装

  1. 下载 .vsix 文件
  2. 打开 VSCode → 扩展面板 (⇧⌘X) → 点击右上角 ⋯ → 从 VSIX 安装...
  3. 选择下载的 .vsix 文件完成安装
提示：安装前请关闭 VSCode 中已打开的 SonicNoteSync 插件实例（如有），避免冲突。

快速开始

  1. 点击 VSCode 左侧活动栏的 SonicNote Sync 图标打开侧边栏
  2. 在设置面板中填入 API 地址 和 MCP Key（获取方式见下方）
  3. 点击 登录 完成认证
  4. 点击 选择同步文件夹 设置 Markdown 文件存放目录
  5. 点击 同步录音 拉取录音并生成 Markdown 文件

MCP Key 获取方式

  1. 打开妙记 App
  2. 进入 我的 → MCP Key 管理
  3. 点击 创建 Key，复制生成的 Key（格式：sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）
  4. 回到 VSCode 插件面板，粘贴 Key 后点击登录

配置说明

配置项说明默认值
API 地址SonicNote 服务器地址https://ainote.easylinkin.com:18048/prod-api
同步目录Markdown 文件存放路径~/Documents/SonicNoteSync
每页数量每次获取的录音条数50
包含转录是否同步逐字转写内容开启
自动同步启动 VSCode 时自动同步关闭
定时重同步间隔分钟数自动重新同步0（关闭）

可在 VSCode 设置 (⌘,) 中搜索 sonicnote-sync 查看所有配置项。

常见问题

Q: 登录失败提示 "认证失败"？

A: 请检查 MCP Key 是否正确，以及 API 地址是否可访问。Key 格式应为 sk- 开头。

Q: 同步后没有生成文件？

A: 请检查同步文件夹路径是否有写入权限，以及录音列表中是否有已转录完成的录音。

Q: 插件侧边栏显示空白？

A: 请确认 VSCode 版本 >= 1.85.0，WebviewView 需要此版本以上支持。也可尝试重新加载窗口 (⌘R)。

Q: 如何更新插件？

A: 下载最新版 .vsix 文件，用相同命令重新安装即可覆盖旧版本。

更新方法

下载最新版安装包，运行 code --install-extension SonicNoteSync-vscode-<版本号>.vsix --force 即可覆盖安装，无需先卸载旧版。