Solomd

SoloMD

Agent 的栖身之所。

🌐 中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português · Italiano · Polski · Nederlands · Türkçe · Svenska · Українська · 🪞 Gitee 镜像 →（在中国下载更快）

下载最新版本 · 发布文章 · 我们如何构建它 · 网站 · 安全

⭐ 如果 SoloMD 值得常驻你的设备，请在 GitHub 上为它点星——它免费，由一位开发者打造，而星标能帮助其他人发现它。

🤖 由 Claude 构建并维护

SoloMD 几乎完全由 Anthropic 的编码 Agent Claude Code 编写、测试和发布，并由一位负责确定方向和决定发布内容的人类维护者把关。Issue 和 Pull Request 也由 Claude 分类并回复——你在这里收到的回复由 AI 撰写，而非人工打字。

我们告诉你这些有两个原因。你应该了解自己把笔记托付给了什么：阅读代码吧，它采用 MIT 许可证，全部公开。如果回复自信满满却错了——这种情况确实会发生——请在讨论串中指出。纠正错误正是我们依靠的机制。

你的笔记存放在一个文件夹里。**SoloMD 是其上的编辑器——在编辑器内提供一流的 Agent 操作界面，并提供一个 MCP 端点，供 Claude Code / Cursor 从外部调用。**使用相同的 .md 文件。与你的知识库对话。安排配方在你不在键盘前时运行。将同一个知识库交给任何 MCP 客户端。

基于 Tauri 2 + Vue 3 + CodeMirror 6 构建。通用版 macOS dmg 约 32 MB。免费、MIT 许可证、无订阅，也没有由 SoloMD 托管的服务。你的笔记、AI 密钥、嵌入索引和 Git 历史记录都留在你的设备上。

4.6 新增内容 — 知识图谱层

补上了 Obsidian 和 Tolaria 具备、SoloMD 缺少的结构层——现已构建完成，并采用 SoloMD 自有的温暖设计系统：

• 属性检查器（⌘⇧I）——使用类型／日期／状态／关系选择器编辑 YAML frontmatter；精确到行的写入可逐字节保留你的注释、内联数组和引号。
• 类型驱动的侧边栏——为笔记添加 type: Project，其成员便会成为一等公民的可折叠分区，并支持自定义图标／颜色／列（以类型为透镜）。
• 带类型的关系——frontmatter 支持 belongs_to / related_to / has，并自动生成反向关系；大型 vault 中的关系由服务端解析。
• 关系图谱（“邻域”）——逐笔记探索外链和反向链接；点击即可跳转，⌘-点击即可切换中心。
• 已保存的筛选视图——持久化侧边栏视图（.solomd/views/*.yml），带递归的 all/any 筛选构建器（类型／状态／日期／正则表达式）。
• 收件箱工作流——按 ⌘E 标记为已整理，并自动切换到收件箱清零流程。
• tldraw 白板——以 Markdown 为基础的白板（```tldraw 围栏代码块），与 Tolaria 的磁盘格式兼容，并按需加载以保持核心轻量。

此外，还新增了统一的 macOS 标题栏（将红绿灯按钮内嵌在工具栏中），以及从零构建的设计系统和 Vue 组件库。大小仍约为 15–32 MB，仍然免费，仍以本地优先。→ 与 Obsidian / Typora / Tolaria 对比

一款产品的三个部分

编辑器。 所见即所得的实时编辑（Typora 风格）、标签页 + 分屏、KaTeX + Mermaid、将粘贴的图片保存到 _assets/、幻灯片模式（⌘⌥P）、Vim 模式、Hunspell + CJK 校对、语义搜索（⌘⇧F）、维基链接 + 反向链接、Pandoc 导出。自动检测 CJK 编码（GBK / Big5 / Shift-JIS）。

端点。 随附的 solomd-mcp 二进制文件可将同一知识库提供给任意 MCP 客户端，开箱即用，包含 16 个工具，其中包括只有 SoloMD 才有的工具（autogit_log、autogit_diff、autogit_rollback、sync_status、share_url、read_agent_trace），其他 Markdown 服务都没有。v4.0 新增 --workspace path1 --workspace path2 联合模式——一个 MCP 会话，多个知识库。此外，还提供 solomd agent <prompt> 命令行，可将任务交给 Claude Code / Codex CLI，并预先配置好 MCP。

Agent 界面（v4.0）。 右侧 Agent 面板：可流式传输、结合知识库的聊天，提供 [[wikilink]] 引用、内嵌工具调用卡片，插入 / 复制 按钮可将回复放入当前笔记。此外，还可在 <workspace>/.solomd/agents/*.yml 中以 YAML 声明式定义配方——支持 cron / on-save / on-commit / on-tag-add / 手动触发。每次 Agent 写入都会进入独立的 AutoGit 分支，须由你接受或拒绝后才会影响 main；默认写入上限为 5；工作区有未提交更改时拒绝启动；每次运行都会生成可重放的 trace.jsonl，并提供 read_agent_trace MCP 工具。

功能
Agent 面板 （v4.0）	可流式传输、结合知识库的聊天，与大纲 / 反向链接 / 标签 / 历史记录并列。工具调用卡片可展开显示；可将回复插入当前编辑器或复制到剪贴板；运行历史以纯 Markdown 格式保存在 .solomd/agent-runs/ 下。
定时配方 （v4.0）	知识库中的 YAML 任务。合并前提供 AutoGit 分支沙盒 + 接受/拒绝界面。每次运行都有写入上限（默认 5，最高 50）。内置 11 个配方示例。
可重放的跟踪记录 （v4.0）	每个步骤都记录在 trace.jsonl 中（prompt / model_call / tool_call / tool_result / git_commit）。可从指定步骤重放，回退并重新执行。
工作区联合 （v4.0）	solomd-mcp --workspace path1 --workspace path2。一个 Claude Desktop 会话，多个知识库。可在“设置 → 集成”中配置 MCP 配置文件。
一等支持 Ollama （v4.0）	自动检测 localhost:11434。提供三个模型预设（qwen2.5:1.5b/7b/14b）。配方可使用 provider: local 别名，实现零云端成本的自主循环。
AI 改写，自带密钥（BYOK）	支持 14 家服务商——OpenAI · Claude · Gemini · DeepSeek · Qwen · GLM · Kimi · Doubao · SiliconFlow · OpenRouter · Mistral · Groq · xAI · Ollama。直接调用服务商接口。密钥保存在操作系统钥匙串中。
基于 GitHub 的同步	每次保存时将知识库推送到私有 GitHub 仓库。可选端到端加密（Argon2id + XChaCha20-Poly1305）。也支持 GitLab / Gitea / 任意 HTTPS Git URL。
逐笔记 AutoGit	每次 ⌘S 都会在工作区内的本地 .git 仓库中创建一次提交。libgit2 已随程序打包，无需安装系统 Git。绝不会自动推送。
内置 MCP 服务	安装包中包含 solomd-mcp。提供 16 个工具（见工具列表）。默认使用 stdio；可选择启用 Streamable HTTP（--transport http，仅限回环地址 + bearer token）。默认只读；可选择启用 --allow-write。
REST API （v4.0）	仅限 localhost，使用令牌认证。为尚不支持 MCP 的客户端提供与 MCP 相同的功能——Alfred / Raycast / n8n / 你自己的脚本。
BYOK 成本计量器 （v4.0）	按服务商统计持续累积的 token 消耗量，可选择启用。在“设置 → 集成”中配置。
云文件夹模式	如果知识库位于 ~/Library/Mobile Documents/... 或 ~/Dropbox/...，SoloMD 会自动检测，并在此基础上添加跨设备会话恢复功能——文件同步已由操作系统负责。
公开只读分享	在命令面板中复制 solomd.app/share/?repo=...&path=... 链接。可渲染公开 GitHub 仓库中的任意文件，查看时无需 SoloMD 账户。

开始使用

在 macOS / Linux 上安装 SoloMD 后：

1. 与你的知识库对话。 打开右侧的 Agent 面板（如果面板隐藏，请按 ⌘⇧P → “View: Toggle Agent Panel”）。围绕笔记进行多轮流式对话；工具调用卡片会内联显示每次读取或写入。回复太长？点击 插入，即可在光标处将内容插入当前笔记（替换所选内容）；点击 复制，即可复制到剪贴板。

2. 安排一个配方。 进入“设置” → “配方” → “浏览配方库”。已有 11 个配方可供使用：每周回顾、每日摘要、TODO 提取、翻译润色、引文清理、CJK 校对 Agent、失效链接检测、frontmatter 规范化、大纲转博客、重构润色、每周标签整理。安装一个配方，编辑提示词，然后运行。

3. 从其他大模型客户端操作同一个知识库。 单次运行（需要 solomd CLI）：

# Print the MCP config snippet for your AI client…
solomd mcp-config
# …or write it straight into every AI client found on this machine.
solomd mcp install

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

粘贴到 Claude Desktop / Cursor / 等客户端中。要联合多个知识库，请重复指定 --workspace：

"args": [
  "--workspace", "/Users/me/Documents/SoloMD",
  "--workspace", "/Users/me/Documents/work-notes"
]

4. 或直接将提示词交给 claude / codex CLI：

solomd agent "rewrite this week of dailies into a weekly review and commit it"

已防护路径遍历。大模型只能看到你指定给工作区的内容。

MCP 工具

类型	工具
读取（始终启用）	list_notes、read_note、search、get_backlinks、get_outline、list_tags、list_tasks、autogit_log、autogit_diff、sync_status、share_url、read_agent_trace
写入（--allow-write）	write_note、append_to_note、autogit_rollback、export_note

export_note（html / md / txt / docx）通过 Node.js 运行无头导出器，因此只有在 SoloMD 源码检出目录中执行过 pnpm install（或 SOLOMD_EXPORT_SCRIPT 指向其 app/scripts/solomd-export.mjs）时才会列出；除非调用时传入 overwrite: true，否则不会覆盖已有文件。所有工具的行号均从文件顶部开始计数，包括 front matter。

传输方式：stdio（默认，Claude Desktop / Cursor / Cline / Codex 使用），或供托管客户端使用的 Streamable HTTP：

solomd-mcp --workspace ~/Documents/SoloMD --transport http --bind 127.0.0.1:8765 --auth-token "$TOKEN"

HTTP 默认绑定到环回地址；使用 --auth-token（或 SOLOMD_MCP_TOKEN）时，每个请求都需要 Authorization: Bearer <token>。请参阅 mcp-server/README.md。

命令行（CLI）

solomd 是一个小型 bash CLI（macOS / Linux），用于编写知识库脚本并配置 MCP：

curl -fsSL https://raw.githubusercontent.com/zhitongblog/solomd/main/scripts/install-cli.sh | bash
solomd help

open、new、list、search、cat、agent、mcp list|install|uninstall|config、mcp-config、--version；每条命令都支持 -h。笔记文件夹为 $SOLOMD_NOTES（默认为 ~/Documents/SoloMD）。solomd export 使用与 export_note 相同的 Node 导出器，因此需要源码检出目录：在已于 app/ 中运行过 pnpm install 的克隆仓库中运行 scripts/solomd，或设置 SOLOMD_EXPORT_SCRIPT。在应用中，请使用“文件” → “导出”。

安装

最新版本及所有下载内容：发布页面。

系统要求： Windows 10+、macOS 10.15+、当前主流 Linux、iOS 15+、Android 7+（API 24）。 不支持 Windows 7/8/8.1——Rust 工具链要求 Windows 10（从 Rust 1.78 起），且 Microsoft 已将 Windows 7 上的 WebView2（SoloMD 的渲染引擎）冻结在 109 版本，不再提供安全更新；也没有旧版构建。

macOS — 通用 dmg（Apple Silicon + Intel，已签名并公证）

brew install --cask zhitongblog/solomd/solomd

也可直接从发布页面下载 SoloMD_<version>_universal.dmg。

或使用一行命令安装：

curl -fsSL https://solomd.app/install.sh | bash

Windows — x64

• 从发布页面下载 SoloMD_<version>_x64_en-US.msi，或 SoloMD_<version>_x64-portable.zip（无需安装程序）

irm https://solomd.app/install.ps1 | iex

winget install solomd

Linux — x86_64 + aarch64

• .AppImage（通用版）、.deb（Debian/Ubuntu）、.rpm（Fedora/RHEL）——两个架构均可从发布页面下载。
• Arch 用户：在 AUR 上使用 solomd-bin。

iPad

App Store — 同一引擎，原生 iPad 界面。

市场平台与集成

内置的 solomd-mcp 服务可处理任意 Markdown 文件夹 — 你无需安装 SoloMD，即可通过 Claude / Cursor / Cline / Continue / Zed 操作你的知识库。各客户端的安装片段：

客户端	配置片段
Claude Desktop	marketplace/client-docs/claude-desktop.md
Claude Code	marketplace/client-docs/claude-code.md
Cursor	marketplace/client-docs/cursor.md
Cline (VS Code)	marketplace/client-docs/cline.md
Continue.dev	marketplace/client-docs/continue.md
Zed	marketplace/client-docs/zed.md

提供形式：

• 技能包（发布页面上的 solomd-skills-v<version>.zip）— 11 个参考 Agent Recipes（每周回顾、待办提取、链接建议器等），可放入 <vault>/.solomd/agents/。每次发布都会附带。
• Claude Code Skill — SKILL.md + install.sh，用于将 solomd-mcp 注册为用户范围的 MCP 服务，并向 Claude Code 提供其 16 个工具以及模式和入门配方。
• Smithery — marketplace/smithery/ 中的 smithery.yaml + Dockerfile（等待提交）。
• Awesome MCP Servers — 在最大的三个社区索引（punkpeye/、appcypher/、wong2/awesome-mcp-servers，合计约 14k 个分支）提交 PR 条目，见 marketplace/awesome-mcp/。

完整概览与提交状态：marketplace/README.md。

对比

	SoloMD v4.5	Obsidian	Typora	Tolaria
许可证	MIT	专有（免费）	付费（$14.99）	AGPL
技术栈	Tauri 2（Rust + WebView）	Electron	Electron	Tauri 2
平台	macOS · Win · Linux · iPad/iOS/Android	macOS · Win · Linux · iOS · Android	macOS · Win · Linux	macOS · Win · Linux
安装包	~32 MB（mac）/ ~10 MB（win）	~120 MB	~95 MB	~25 MB
内联 Agent 面板	✅ v4.0	🟡 付费插件（Smart Composer / Copilot）	❌	🟡 提供方 + Agent，无内联面板
定时 Agent 配方	✅ v4.0	❌	❌	❌
AutoGit 分支沙盒 + 接受/拒绝	✅ v4.0	❌	❌	❌
可回放的 Agent 轨迹	✅ v4.0	❌	❌	❌
多工作区	✅ v4.0 MCP 联邦	❌	❌	🟡 多知识库
内置 MCP 服务	✅ 16 个工具，其中 6 个为 SoloMD 专属	❌（社区插件）	❌	✅ 通用
内置 AI 改写	✅ 14 个 BYOK 提供方	仅限插件	❌	✅ 内置提供方
GitHub 支持的同步	✅	❌（Obsidian Sync $5/月）	❌	❌
端到端加密	✅ 存储在你的仓库中	✅ 存储在 Obsidian 的服务器上	❌	❌
本地 RAG / 语义搜索	✅ 默认关闭	仅限插件	❌	❌
每篇笔记的版本历史	✅ AutoGit	仅限插件	❌	✅
Markdown 白板（tldraw）	❌	🟡 Canvas（自有格式）	❌	✅
CJK 编码（GBK / Big5）	✅ 自动检测	❌	❌	❌

详细对比：与 Obsidian 对比 · 与 Typora 对比 · 与 Tolaria 对比 · 与 Marktext 对比。

隐私与安全

完全在客户端运行。你的 .md 文件会保留在你选择的文件夹中。API 密钥存储在操作系统钥匙串中（macOS Keychain / Windows Credential Manager / Linux libsecret），绝不会存入 localStorage 或任何配置文件。AI 请求会从你的设备直接发送到你选择的服务提供商，不经过 SoloMD 中转。RAG 嵌入和 AutoGit 仓库仅存储在本地。MCP 服务默认使用 stdio 通信；其可选的 HTTP 传输会绑定到环回地址，除非你另行选择，并且可以要求提供 bearer 令牌。整个代码库采用 MIT 许可，可供审计。

Agent 安全防护措施（v4.0）。 每次配方运行都会在独立的 AutoGit 分支上启动——在你点击差异视图中的 Accept 之前，你的 main 分支不会受到影响。每次运行的写入上限（默认为 5，最高不超过 50）可防止循环失控。工作区有未提交的更改时，配方运行器会拒绝启动（Agent 绝不会将你的进行中工作一并提交）。所有接受用户提供路径的 Tauri / MCP / REST 端点都会预先拒绝 .. 路径段和绝对路径，以防止路径遍历。

E2EE 同步使用 Argon2id（RFC9106 默认参数）→ XChaCha20-Poly1305，并采用确定性 nonce 和以路径作为 AAD。明文仅保留在你的设备上；远程服务只能看到密文。若 sync.json 解析失败，系统会默认拒绝操作——拒绝推送，而不会降级为明文（这是 v3.0.x 审计修复项）。

完整说明：https://solomd.app/security。

从源代码构建

前置要求：Rust（stable）、Node 18+、pnpm。

git clone https://github.com/zhitongblog/solomd.git
cd solomd/app
pnpm install
pnpm tauri dev      # dev with hot reload
pnpm tauri build    # release artifacts → src-tauri/target/release/bundle/

Linux 还需要安装 libdbus-1-dev，用于钥匙串后端。

MCP 服务是位于 mcp-server/ 的独立 crate；用于端到端测试的开发 MCP 测试工具位于 dev-mcp/。端到端测试入口：scripts/v4-self-test.sh（如需完整覆盖，请使用 --with-release --with-ollama --with-ui 运行）。

参与贡献

欢迎提交 Issue 和 PR——提交一个。如需了解项目方向，请参阅 docs/roadmap.md。v4.0 的构建日志见 solomd.app/blog/v4-0-0-how-we-built-it/——如果你想在提交 PR 前了解工程原则，可以从这里开始。

联系方式 / 联系

由一位维护者通过两种渠道联系。你可以在 GitHub Discussions 异步交流，也可以实时聊天：

• Telegram（国际）： @SOLOMDAPP — 发布公告与聊天
• WeChat（中文）： 扫码添加我——备注“SoloMD”，注明 SoloMD 直接通过

  

赞助者

感谢所有赞助 SoloMD 的朋友：tyysoft(太阳雨)

✨ 永久完全免费与支持者徽章： SoloMD 的所有功能永久免费——没有付费墙、订阅或广告。你可以通过 GitHub Sponsors / PayPal / Alipay / WeChat Pay 赞助，支持独立开源开发；也可以使用 Mac App Store、iOS App Store 和 Google Play 中 3 种可选的一次性应用内打赏档位（☕ Buy a Coffee $0.99 · 🍜 Buy a Lunch $2.99 · 🚀 Generous Support $9.99），永久解锁“设置”和“关于”中的专属 ✨ Supporter 徽章。

贡献者

代码记录在提交历史中。这些人通过其他方式支持 SoloMD 持续发展——赞助者 💵、测试者 🐛🤔 和推广者 📣（All Contributors 规范）。想在这里留下名字？solomd.app/promote

tyysoft(太阳雨) 💵 🐛 🤔

张工 🐛 🤔

Garfield 📣

lcfactorization 📣

^9星守辰^ 📣

许可证与致谢

MIT © 2026 xiangdong li。SoloMD 基于 Tauri 2、Vue 3、CodeMirror 6、markdown-it、KaTeX、Mermaid、libgit2、Pandoc、Hunspell、keyring-rs 和 rmcp 构建。欢迎通过 GitHub Sponsors 或 solomd.app/#sponsor 赞助。