自架服務
zhitongblog/solomd avatar
zhitongblog/solomd

SoloMD:一款內建 MCP 伺服器的本機 Markdown 編輯器

Markdown 編輯器,以及通往法學碩士的橋樑。本地優先,麻省理工學院,~15 MB。捆綁的 MCP 伺服器讓 Claude Code / Codex / Cursor 直接驅動您的保管庫。 14 家 AI 供應商 BYOK。

1,045 個 Star66 個 ForkTypeScriptMIT

秒懂

它是什麼?
一款以 Tauri 2 和 Vue 3 打造的免費 MIT 授權 Markdown 編輯器,透過內建的 MCP 伺服器,讓同一個筆記資料夾同時面向編輯器、應用程式內的代理面板和外部 LLM 用戶端。
適合誰用?
SoloMD 採用 MIT 授權,README 顯示由單一維護者維護,儲存庫中繼資料記錄為 715 個星標、36 個 fork 和 47 個未關閉議題。README 自身的版本號並不一致:開頭部分描述 4.6 的新功能,比較表標示 v4.5,安裝連結指向 v4.0.0,因此要鎖定某個版本,應查閱發佈頁面而不是 README。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 2 天前。
用什麼語言寫的?
主要是 TypeScript(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。

開源專案深度解析

通往同一個筆記資料夾的三條路徑

SoloMD 把自己描述為一款 Markdown 編輯器,筆記存放在一個普通的 .md 檔案資料夾中,而同一個資料夾可以從三個方向存取:編輯器視窗、右側的代理面板,以及可供 Claude Code、Codex、Cursor 等外部 LLM 用戶端驅動的 MCP 端點。技術棧是 Tauri 2、Vue 3 和 CodeMirror 6。macOS 通用 dmg 約為 32 MB,專案中繼資料給出的體積約為 15 MB,README 反覆強調應用程式保持在這個量級,同時免費、MIT 授權,而且沒有 SoloMD 託管的伺服器。筆記、AI 金鑰、嵌入索引和 AutoGit 歷史都被描述為留在使用者自己的機器上。

在核對 zhaoxuya520-reverse-skill-deep-analysis 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

4.6 的知識圖譜層

README 的功能介紹以知識圖譜層開頭,稱其為 4.6 的新內容。它包含一個屬性檢查器,可以用類型、日期、狀態和關係選擇器編輯 YAML frontmatter,並透過逐行寫入保留註解、內聯陣列和引號。類型驅動的側邊欄把帶有 Project 等 type 欄位的筆記變成可摺疊的分區,帶自訂圖示、顏色和欄位。belongs_to、related_to、has 這類類型化關係會自動產生反向關係,並在伺服器端解析。名為 Neighborhood 的逐筆記關係圖展示出向和反向連結,command 加點擊可以切換視角。儲存的篩選檢視持久化在 .solomd/views 下,收件匣工作流用 Cmd+E 把筆記標記為已整理,tldraw 白板以 markdown 圍欄內的程式碼區塊形式存在,與 Tolaria 的磁碟格式相容。同一節還提到統一的 macOS 標題列,以及從零設計的設計系統和 Vue 元件庫。

在核對 zhayujie-cowagent-deep-analysis 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

編輯器這半邊

編輯器的部分是 Typora 風格的所見即所得即時編輯器。README 列出了分頁和分欄、KaTeX 和 Mermaid 轉譯、貼上圖片到 _assets 資料夾、投影片模式、Vim 模式、Hunspell 加中日韓校對、語意搜尋、wikilink 加反向連結,以及 Pandoc 匯出。它還能自動偵測 GBK、Big5 和 Shift-JIS 這些中日韓編碼。在編輯器之下是 AutoGit:每次 Cmd+S 都會在 workspace 內的本地 .git 目錄裡產生一次提交,使用內建的 libgit2,因此不需要安裝系統級 git,這些提交也永遠不會自動推送。

在核對 zhengwenming-wmplayer-guide 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

代理表面:面板、配方與分支沙箱

代理表面被描述為 v4.0 的新內容,由三部分組成。Agent 面板串流呈現與筆記庫的對話,顯示 wikilink 引用,內聯轉譯工具呼叫卡片,並提供 Insert 和 Copy 按鈕,把回覆放入目前筆記。配方是 .solomd/agents 下的宣告式 YAML 檔案,可由 cron、on-save、on-commit、on-tag-add 或手動觸發;儲存庫內附帶 11 個配方的範例集。每次代理寫入都落在自己的 AutoGit 分支上,使用者接受或拒絕之後才會進入 main。執行器每次執行的寫入上限預設為 5,硬上限為 50;工作樹不乾淨時拒絕啟動;每次執行會記錄可重放的 trace.jsonl,可透過 read_agent_trace 這個 MCP 工具讀取。README 還列出對 localhost:11434 的 Ollama 自動偵測和三個模型預設,以及一個用於本地配方的 provider 別名,讓自主迴圈不依賴雲端。

在核對 zheyi-d-quota-monitor-guide 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

MCP 伺服器與它的用戶端

安裝包內建的 solomd-mcp 二進位檔把同一個筆記庫暴露給任何 MCP 用戶端。README 統計為 13 個工具,其中 5 個是 SoloMD 獨有:autogit_log、autogit_diff、autogit_rollback、sync_status 和 share_url。伺服器只走 stdio,不開放任何網路連接埠,預設唯讀,--allow-write 為明確開啟。--workspace 參數可以重複,從而在一個 MCP 工作階段裡聯合多個筆記庫。solomd agent 命令列工具把提示詞交給預接 MCP 的 Claude Code 或 Codex CLI,另外還有一個帶權杖驗證的 localhost REST API,為不識別 MCP 的用戶端提供同樣的介面。README 為 Claude Desktop、Claude Code、Cursor、Cline、Continue.dev 和 Zed 提供了設定片段,還介紹了一種公開唯讀分享連結,可以在無帳號的情況下轉譯公共 GitHub 儲存庫裡的任意檔案。它還說,即使不安裝 SoloMD 本身,MCP 伺服器也能對任何 Markdown 資料夾運作。

在核對 zhitongblog-solomd-deep-analysis 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

README 記載的隱私與安全

README 的隱私一節描述了一種純用戶端設計。API 金鑰存放在作業系統鑰匙圈裡,絕不進入 localStorage 或任何設定檔。AI 請求直接從使用者機器發往所選供應商,不經過 SoloMD 中繼。嵌入和 AutoGit 存放庫都只在本機,MCP 伺服器不開放網路連接埠。代理安全防護寫得很具體:每次配方執行都從自己的 AutoGit 分支開始,寫入上限限制失控迴圈,骯髒工作樹會阻止啟動,路徑穿越防護在每一個接受使用者提供路徑的 Tauri、MCP 或 REST 端點拒絕 .. 片段和絕對路徑。對於同步,README 描述的是 Argon2id(RFC 9106 預設參數)加 XChaCha20-Poly1305,使用確定性 nonce 和路徑作為 AAD,sync.json 解析失敗時採取 fail-closed 行為。它連結到單獨的 security 頁面查看完整說明,任何獨立的驗證都只能來自那個頁面。

在核對 zhongjhatc-albumcamerarecorder-deep-analysis 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

授權、建置方式與 README 未言明之處

儲存庫採用 MIT 授權,版權歸 xiangdong li(2026 年),授權授予使用、複製、修改、合併、發佈、散佈、再授權和出售的權利,軟體按現狀提供且不附帶任何保證。從原始碼建置需要 Rust stable、Node 18 或更高版本以及 pnpm;README 給出的命令是 pnpm install、pnpm tauri dev(熱重載開發)和 pnpm tauri build(產生發佈產物)。Linux 還需要 libdbus-1-dev 作為鑰匙圈後端。儲存庫中繼資料記錄為 715 個星標、36 個 fork 和 47 個未關閉議題。README 沒有說明發佈節奏、支援承諾、基準數字或獨立稽核,而且版本標示並不一致:開頭描述 4.6,比較表寫 v4.5,安裝連結指向 v4.0.0。

在核對 zhongyang219-trafficmonitor-guide 時,應以 README 中列出的檔名、方法名、命令與版本記錄為準;素材沒有說明的預設行為,不延伸成保證。

編輯結論

SoloMD 採用 MIT 授權,README 顯示由單一維護者維護,儲存庫中繼資料記錄為 715 個星標、36 個 fork 和 47 個未關閉議題。README 自身的版本號並不一致:開頭部分描述 4.6 的新功能,比較表標示 v4.5,安裝連結指向 v4.0.0,因此要鎖定某個版本,應查閱發佈頁面而不是 README。 先核對專案 README、具體版本與對應命令,再決定是否納入正式流程。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記