zhitongblog/solomd

解决的问题

SoloMD 是一款以本地优先的 Markdown 编辑器，旨在为 AI 代理提供一个可以直接在您的笔记上运行的环境。它通过整合一级代理界面、MCP (Model Context Protocol) 端点以及版本控制库，解决了 AI 工作流程碎片化的问题，让用户在不牺牲隐私或数据所有权的情况下，与笔记对话并通过排程配方自动化任务。

运作方式

SoloMD 在 Markdown 文件文件夹上运行。它结合了三个核心组件：

• 编辑器：具备语义搜索、维基链接与 tldraw 白板功能的所见即所得编辑器。
• 端点：一个内置的 solomd-mcp 二进制文件，通过 13 种内置工具将数据库暴露给任何兼容 MCP 的 AI 客户端（如 Claude Desktop 或 Cursor）。
• 代理界面：一个集成式面板，用于流式「与数据库对话」以及「配方」——即在独立的 AutoGit 分支上运行的 YAML 定义工作（例如：每周回顾、待办事项提取）。这确保了 AI 产生的变更处于沙盒环境中，且必须由用户接受或拒绝后，才能合并到主分支。

目标用户

适合想要强大、私密、本地优先知识库的用户，这些知识库可由 AI 代理主动管理；也适合使用 MCP 客户端的开发者，以及偏好具备内置版本控制与 AI 辅助的 Markdown 工作流程的写作者。

特色亮点

• 代理原生工作流程：集成式代理面板与排程配方，并具备用于安全 AI 写入的沙盒 (AutoGit)。
• MCP 整合：内置 MCP 服务器，允许外部 LLM 客户端驱动同一个数据库。
• MCP 联合：能够在单一 MCP 会话中处理多个数据库。
• 本地优先与私密：所有笔记、API 密钥（存储于操作系统钥匙串）与嵌入向量皆保留在机器上；无需云端服务器。
• 知识图谱层：用于 YAML 前言、类型化关系与关系图的属性检查器。
• 广泛的 AI 提供者支持：支持 14 种 BYOK (自备密钥) 提供者，包括通过 Ollama 运行的本地模型。
• AutoGit 版本控制：每次保存皆自动进行本地提交，确保每则笔记皆有完整历史记录。