10分钟上手SoloMD:从安装到第一次与笔记库对话的完整教程

原创2026-10-14 10:37:012,289 阅读

10分钟上手SoloMD:从安装到第一次与笔记库对话的完整教程

SoloMD 是一款本地优先(local-first)的 Markdown 编辑器,内置 AI 智能体面板,让你直接与自己的笔记库对话——约 15 MB、免费开源(MIT 协议)、无需订阅。它自带 solomd-mcp 服务,Claude Code / Cursor 等工具可以直连你的笔记库;内置 14 家 AI 服务商,自带密钥(BYOK)即用。本文带你从安装到完成第一次"与笔记库对话",全程约 10 分钟。

SoloMD Markdown 编辑器分栏视图:左侧源码编辑,右侧实时预览

SoloMD 是什么?三大核心能力

把 SoloMD 理解成三合一:

能力 说明
📝 所见即所得编辑器 Typora 风格实时编辑、标签 + 分栏、KaTeX 公式、Mermaid 图表、幻灯片模式
💬 Agent Panel 智能体面板 右侧内置聊天面板,多轮流式对话,回答可直接插入当前笔记
🔌 MCP 端点 内置 solomd-mcp,任何 MCP 客户端都能读取/编辑你的笔记库

你的笔记就是一个文件夹里的 .md 文件,⌘S 每次保存都会在本地生成 AutoGit 版本历史——文件、历史、AI 密钥全部留在自己机器上。

最快安装方式:macOS / Windows / Linux 三平台命令

系统要求: Windows 10+、macOS 10.15+、主流 Linux 发行版、iOS 15+、Android 7+。安装包很小:macOS 约 32 MB,Windows 约 10 MB。

macOS 一键安装

brew install --cask zhitongblog/solomd/solomd

或者从发行版下载 SoloMD_<version>_universal.dmg(Apple Silicon + Intel 通用,已签名公证)。

Windows 安装

在 PowerShell 中执行:

winget install solomd

或从发行版页下载 .msi 安装包 / 免安装的 portable zip。

Linux 安装

提供 .AppImage(通用)、.deb(Debian/Ubuntu)、.rpm(Fedora)三种格式,x86_64 与 aarch64 双架构;Arch 用户可直接安装 AUR 上的 solomd-bin(见 aur-solomd-bin/PKGBUILD)。

💡 完整平台对比与安装细节见 README.md。

首次启动:三步完成基础设置

  1. 打开笔记库:首次启动会提示选择一个文件夹(默认 ~/Documents/SoloMD)。这就是你的"vault",所有 .md 文件都在其中。
  2. 界面语言:右上角 ⚙️ 打开设置,语言 选"中文",界面立即切换。
  3. 常用开关:自动换行、实时预览(编辑时隐藏标记符)、显示文件树、拼写检查。

SoloMD 设置界面:中文界面中配置语言、主题与字体

设置项对应源码中的 app/src/components/AISettings.vue 与设置 Store,API 密钥不会写进配置文件,而是存入 操作系统密钥链(macOS Keychain / Windows 凭据管理器 / Linux libsecret)。

SoloMD 深色主题下编辑代码块与任务清单

编辑体验速览:实时预览、大纲与 Mermaid 图表

SoloMD 默认提供"分栏"模式:左侧是 Markdown 源码(带语法高亮),右侧实时渲染成漂亮的预览,光标移动时标记符会自动淡化——写起来几乎没有 Markdown 符号的打扰。

SoloMD 编辑器中的 Mermaid 流程图实时渲染效果

几个高频快捷键(完整列表可用命令面板查看):

功能 快捷键
命令面板 ⌘K
全局搜索 ⌘⇧F
大纲视图 ⌘0
切换 Agent Panel 命令面板输入 "Agent"
幻灯片放映 ⌘⌥P

图表支持 KaTeX 数学公式与 Mermaid 流程图/时序图,点击图表还能全屏放大查看。

配置 AI:14 家服务商自带密钥(BYOK)

要让 Agent Panel 与笔记库对话,需要先配置一个 AI 服务商。打开 设置 → AI,从 14 家服务商中任选一家,粘贴你的 API Key:

  • 国际:OpenAI、Claude、Gemini、xAI、Mistral、Groq
  • 国内:DeepSeek、Qwen(通义)、GLM、Kimi、豆包、SiliconFlow、MiniMax
  • 聚合与本地:OpenRouter、Ollama(本地模型,零云成本)

服务商目录定义在 app/src/lib/ai-providers.ts,各家都有合理的默认模型,填 Key 后即可使用。若使用本地 Ollama,SoloMD 会自动检测 localhost:11434,并提供 qwen2.5:1.5b / 7b / 14b 三个预设。

🔒 隐私说明:AI 请求从你的机器直连所选服务商,不经过任何 SoloMD 中转服务器。

第一次与笔记库对话:打开 Agent Panel

这是 SoloMD 最核心的功能——把右侧的智能体面板当作"住在你笔记库里的 AI 助手":

  1. 按 ⌘K 打开命令面板,输入并执行 "View: Toggle Agent Panel"(对应命令定义见 app/src/composables/useCommands.ts);
  2. 面板从右侧滑出,直接输入问题,例如:
    • "帮我总结一下这个笔记库里所有未完成的任务"
    • "找出提到'项目A'的所有笔记,整理成清单"
  3. 回答流式输出,AI 读取/搜索笔记时会以工具调用卡片内联展示每一步操作,引用的笔记带 [[wikilink]] 角标,可点击跳转;
  4. 回复满意后,点 Insert(插入) 把内容直接写入当前笔记的光标位置,或 Copy(复制) 到剪贴板。

面板逻辑实现在 app/src/components/AgentPanel.vue,运行历史以纯 Markdown 持久化在 .solomd/agent-runs/ 下,随时可回看。

进阶:定时任务 Recipes

在 设置 → Recipes 中可从内置 cookbook 安装 11 个开箱即用的 YAML 任务(周回顾、每日总结、TODO 提取、翻译校对……),保存在 <workspace>/.solomd/agents/*.yml。每个任务按 cron / 保存时 / 提交时等触发器运行,且每次运行都在独立的 AutoGit 分支上沙箱执行——你 Accept 之前,main 分支绝不会被改动。

让 Claude Code / Cursor 直连笔记库(MCP)

SoloMD 安装包自带 solomd-mcp 二进制,暴露 16 个工具(list_notes、read_note、search、get_backlinks、list_tasks 等),任何 MCP 客户端都能直接驱动你的笔记库,默认只读,写操作需显式 --allow-write 开启。

一条命令生成配置片段:

solomd mcp-config

输出示例(粘贴进 Claude Desktop / Cursor 即可):

{
  "mcpServers": {
    "solomd": {
      "command": "/Applications/SoloMD.app/Contents/MacOS/solomd-mcp",
      "args": ["--workspace", "/Users/me/Documents/SoloMD"]
    }
  }
}

想同时挂载多个笔记库,重复 --workspace 参数即可(工作区联邦)。各客户端的安装配置文档见 marketplace/client-docs/,MCP 服务器完整说明见 mcp-server/README.md。

常见问题

Q:SoloMD 收费吗? 免费,MIT 开源,无订阅、无 SoloMD 托管服务器。费用只有你自己的 AI API Key。

Q:笔记会被上传到云端吗? 不会。文件保存在你选择的本地文件夹;可选的 GitHub 同步(支持端到端加密)和 RAG 向量索引均为本地生成、按需开启。

Q:不装桌面版能用 MCP 吗? 可以。solomd-mcp 是独立 Rust 二进制,针对任意 Markdown 文件夹运行,无需先安装 SoloMD 主程序。

Q:Windows 7/8 支持吗? 不支持,需要 Windows 10+(Rust 工具链与 WebView2 的限制)。

小结

10 分钟回顾一下我们完成的事:

  • ✅ 通过 brew / winget / AppImage 装好 SoloMD
  • ✅ 打开笔记库、切换中文界面
  • ✅ 体验分栏实时编辑与 Mermaid 图表
  • ✅ 配置 BYOK AI 密钥,打开 Agent Panel 完成第一次"与笔记库对话"
  • ✅ 用 solomd mcp-config 把笔记库接入 Claude Code / Cursor

SoloMD 的核心哲学是"一个文件、一个窗口,专心写作"——AI 是住在编辑器里的助手,而不是把笔记搬去云端。现在就装一个,让你的笔记库开口说话吧 🚀

登录后查看全文
solomd