Molio (墨流)

兼容 Obsidian Vault 的本地知识库 + Claude Code 图形界面 + 微信 AI 助手 — 数据全在你自己的电脑上

English | 中文

Molio 是一款本地优先的桌面应用，将知识库管理、AI 写作和多平台发布串联为一体。直接打开你的 Obsidian Vault，通过 Chrome 扩展一键剪藏网页，在 UI 里调用 Claude Code / Codex / Gemini CLI 写文档，扫个码就能在手机微信里跟知识库对话 — 所有内容存在你自己的电脑上，不经过任何第三方服务器。

核心功能

• 🗂️ 兼容 Obsidian Vault — 直接打开你的 Obsidian 目录，零迁移成本；纯 Markdown 文件，无厂商锁定，随时可以切回去
• ✂️ 自带 Web Clipper — Chrome 扩展一键剪藏网页到知识库，自动唤起桌面端定位到刚保存的文件
• 🤖 Claude Code / Codex / Gemini CLI 图形界面 — 不用敲命令行，在 UI 里选 Agent、发消息、看流式输出，自动加载项目 CLAUDE.md 上下文
• 💬 微信 AI 助手 — 扫个码就连上个人微信，在手机里跟你的本地知识库对话；发公众号链接还能自动总结并存入知识库
• 🎨 内置 doocs/md 排版 — 微信公众号、知乎等平台格式一键转换，左右分栏实时预览
• 🚀 30+ 平台一键发布 — 基于 doocs/cose，写完即发，告别逐平台复制粘贴
• 🔒 数据全在本地 — 知识库、AI 对话、微信消息全部存在你自己的电脑上，不经过任何第三方服务器

界面预览

AI 对话：选择 Agent 发送消息，支持流式响应	Vault 文件树管理，Markdown 渲染与浏览
左右分栏实时预览，主题/字体/颜色可调	一键同步到 30+ 内容平台

技术栈

项目结构

Molio/
├── packages/
│   └── contracts/       @molio/contracts — 共享类型定义
├── apps/
│   ├── daemon/          @molio/daemon   — Hono HTTP 服务端 (API + SSE)
│   ├── web/             @molio/web      — Vite + React 前端
│   └── desktop/         @molio/desktop  — Electron 桌面壳
└── package.json         monorepo 根配置

快速开始

前置要求

• Node.js >= 22
• pnpm >= 9
• 至少安装一个 AI 运行时 CLI：
  • Claude Code
  • OpenAI Codex CLI
  • Gemini CLI
  • Qwen Code

安装与运行

# 克隆项目
git clone https://github.com/zhuzhaoyun/Molio.git
cd Molio

# 安装依赖
pnpm install

# 启动开发环境 (daemon + web)
pnpm dev

# 或分别启动
pnpm dev:daemon   # 仅后端 :3100
pnpm dev:web      # 仅前端 :5173

构建桌面应用

# 一键构建 + 生成未打包版本
pnpm desktop:run

# 或完整打包为安装程序
pnpm package

# 仅生成未打包目录 (不生成安装包)
pnpm package:dir

测试与类型检查

pnpm test         # 运行所有测试 (node:test)
pnpm typecheck    # 全量类型检查
pnpm build        # 构建所有子包

常见问题

macOS 提示"已损坏，无法打开"

这是 macOS Gatekeeper 的安全提示，因为 Molio 目前未经过 Apple 公证（需要 Apple Developer Program 年费 $99）。这不是应用本身的问题，请按以下任一方法解决：

方法一（推荐）：右键点击应用 → 选择"打开" → 点击"打开"按钮（只需第一次）

方法二：打开终端，运行：

sudo xattr -d com.apple.quarantine /Applications/Molio.app

之后即可正常双击打开。

用户交流群

致谢

Molio 的诞生离不开以下优秀开源项目的启发与支持：

• multica — 开源 Agent 管理平台，启发了 Molio 的多运行时编排与 Agent 交互设计
• doocs/md — 微信 Markdown 编辑器，Molio 的文档排版与多平台格式化能力基于其核心渲染引擎 @md/core 构建
• doocs/cose — 全平台内容分发扩展，Molio 的多平台发布能力由其平台适配器层提供支持
• WeKnora — 腾讯开源知识库管理平台，为 Molio 的知识库模块提供了设计理念参考

感谢这些项目的作者和社区，让 Molio 能站在巨人的肩膀上快速成长。

License

Modified Apache 2.0 — 基于 Apache License 2.0，附加商业使用限制条款。内部使用和非商业场景完全免费，商业托管/嵌入需获取商业授权。