Molio Knowledge Base

---

你积累的内容并非只有一种：散落在笔记、文档和聊天记录中的经验与方法，还有整本书、满是图表的 PDF，以及成堆的行业资料。大部分内容都以 AI 无法读取的形式存在，因此每次对话都得从零开始。

Molio 将这些内容全部转化为 个人知识库，供 AI 读取和使用：Claude Code、Codex 和其他 Agent 可以进入你的知识空间，在你积累的一切基础上开展研究、写作、答疑和分析，并将结果以 Markdown 写回，让知识库在每项任务后都更加丰富。一切都在你的设备上运行，不经过任何第三方服务。

从零开始？资源库提供持续扩充的现成知识库——导入一个就可以开始提问。

🔁 工作原理

01 · 收集与处理——零散片段或整本书籍，都能变成可调用的知识库

输入不受格式限制：通过 Web Clipper 一键剪藏网页，直接打开 Obsidian 库，或批量导入本地文档。扫描版 PDF 和 Word / PPT / Excel 文件会通过内置的 docling 进行版面分析、OCR 和表格重建；图片通过 OCR 读取；百万字书籍则通过分块预处理和摘要流水线处理，并支持断点续传。最终写入磁盘的是纯 Markdown——无需迁移，没有锁定。

随后，Wiki 引擎从这一统一的 Markdown 层提取实体和概念，编织出密集的交叉链接与分层索引——只有经过处理，数据才能成为基础。

02 · 工作与任务——Agent 基于你的数据运行

Claude Code、Codex、Gemini CLI、Qwen Code 等 Agent 在你的知识空间中开展研究、写作、答疑和分析。它们看到的不是一张白纸，而是你积累的一切。通过统一 GUI 选择 Agent 并查看流式输出；扫描二维码，即可通过微信在手机上与你的知识库对话。

03 · 重流转与沉淀——知识库在使用中不断丰富

每项任务的输出都会以 Markdown 写回，成为可复用的长期资产。知识图谱持续增长，让下一项任务站在更高的起点上。准备好发布了吗？使用 doocs/md 排版，一键分发到 30 多个平台。

📥 支持的输入

输入	处理方式
Markdown / TXT / HTML / CSV 及其他文本	按原样读取——知识库的默认形态
PDF	布局分析 + OCR + 表格重建 → Markdown
Word / PPT / Excel	使用相同的处理流程，并保留标题层级和表格
图片（PNG / JPG / TIFF）	OCR 文本提取
网页	一键剪藏，或提取微信公众号文章
Obsidian 知识库	就地打开——原始文件为只读
百万字书籍	分块预处理 + 摘要流程，可断点续跑

PDF 和 Office 转换由内置的 docling 技能处理。首次转换时会下载工具和约 500MB 的模型；后续运行会复用缓存。

📦 现成知识库

除工具本身外，Molio 还提供现成的结构化知识图谱——将整本书籍和专业领域预先整理成适用于 AI 的知识库，只需一键导入，无需从头构建。

涵盖文学、历史、哲学、中医、医学和 AI 工程，并且定期新增资源。精选资源包括本体知识库、《资治通鉴》知识体系和产科超声知识库。请访问资源库，查看完整且持续更新的目录。

这些是 AI 无法凭空生成的独特结构化资源。将其导入 Molio，即可立即开展 AI 问答、关系查询和专题研究。

• 《红楼梦》：120 回中的人物与意象
• 《金瓶梅》：人物、商业与社会结构
• 《史记》：人物、制度与思想
• 《资治通鉴》：1,362 年的兴衰历程
• 《明史》：帝国、制度与朝廷政治
• 《周易》：全部 64 卦，含爻变与象数分析
• 老子与庄子：核心概念体系
• 中西哲学：本地 AI 知识库
• 中医经典：六经与三焦辨证
• 产科与妇科超声：胎儿异常、征象与鉴别诊断
• 知识工程：本体、RAG、GraphRAG 与 Agent 工程
• 广东高考志愿规划：高校与专业
• 《三国演义》：人物关系图谱，涵盖全部 120 回
• 工程图纸数据提取：从工程图纸到可计算数据
• PCB 柔性制造：从在线下单到无人化工厂
• 法考刑法：131 个考点与主观题训练
• 中国古典诗词与散文：全景式知识库

浏览全部资源 →

📡 渠道

单个 Molio 实例可并行服务多个渠道。大多数渠道都可以直接通过 Web 控制台接入。

渠道	文本	图片	文件	语音	群组
Web 控制台 (默认)	✅	✅	✅	✅	—
微信	✅	✅	✅	⏳	⏳
飞书	✅	✅	✅	⏳	✅
Telegram	⏳	⏳	⏳	⏳	⏳
Slack	⏳	⏳	⏳	—	⏳
Discord	⏳	⏳	⏳	—	⏳

✅ 已支持 · ⏳ 计划中 · — 不适用

🖼️ 截图

Agent 工作台：支持多 Agent 和流式响应	知识空间：带 Markdown 渲染的知识库文件树
知识图谱：以可视化方式呈现知识之间的关联	发布：一键同步至 30 多个平台

🚀 快速开始

安装

从 GitHub Releases 下载最新版本：

• Windows：Molio-Setup-x.x.x.exe
• macOS：Molio-x.x.x.dmg

安装并启动。首次运行时，系统会引导你配置 AI 运行时 CLI（例如 Claude Code、Codex、Gemini）。

🐳 Docker / NAS 部署（可自托管）

在 NAS 或服务器上将 Molio 作为可自托管的 Web 服务运行。单个容器包含守护进程、Web UI 和 Claude Code CLI，可运行于 linux/amd64 和 linux/arm64，适用于 Synology、QNAP、TerraMaster、TrueNAS、Unraid 及大多数其他 NAS 设备。

⚠️ 此部署方式与桌面应用的区别（部署前请阅读）

• 只能通过浏览器访问，此模式没有桌面客户端。 Electron 桌面应用只会连接其在本地启动的守护进程（localhost），无法连接运行在远程 NAS/服务器上的容器。
• 守护进程在容器内运行，只能读写挂载到容器中的目录。 桌面工作流中“通过文件夹选择器将任意本地文件夹选作知识库”的方式不适用于此处——浏览器没有文件夹选择器，因此添加知识库时，你需要输入容器内部路径（例如 /vaults/your-folder，而不是 NAS 主机路径）。
• 如需将文件夹作为知识库使用，请在 docker-compose.yml 的 volumes 中将其挂载到 /vaults 下。你的数据仍完全由你掌控（存储在你的 NAS 上），变化的只有访问方式：从“桌面应用”变为“浏览器 + 挂载卷”。

一键安装（需要 Docker + Docker Compose v2）：

# China (recommended)
curl -fsSL https://molio-releases.oss-cn-guangzhou.aliyuncs.com/script/install.sh | bash
# Overseas
curl -fsSL https://raw.githubusercontent.com/zhuzhaoyun/Molio/main/install.sh | bash
# Offline (clone the repo first, then run the bundled script)
bash install.sh

脚本会询问你的知识库目录和端口，然后拉取镜像并启动服务。完成后，打开 http://<your-server-ip>:3100，然后前往 设置 → 运行时 配置 AI 模型和 API 密钥。首次启动时，Molio 会在挂载目录中自动创建默认知识库，因此你会直接进入其中，无需手动设置。

手动安装（如果你更喜欢直接使用 docker compose）：

git clone https://github.com/zhuzhaoyun/Molio.git && cd Molio
cp .env.example .env      # AI model is configured later in the web UI
docker compose up -d      # then open http://<your-server-ip>:3100

日常命令（在安装目录中运行，默认为 ~/molio）：

docker compose logs -f                          # follow logs
docker compose restart                          # restart
docker compose pull && docker compose up -d     # update to the latest image
docker compose down                             # stop

在 .env 中设置 MOLIO_VAULT_PATH，即可将现有文档文件夹挂载到容器中的 /vaults。所有选项请参阅 install.sh 和 .env.example。

开发（从源代码构建）

如果你想从源代码构建或参与开发：

前置条件：

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

# Clone the repository
git clone https://github.com/zhuzhaoyun/Molio.git
cd Molio

# Install dependencies
pnpm install

# Start development environment (daemon + web)
pnpm dev

# Or start individually
pnpm dev:daemon   # Backend only (port 3100)
pnpm dev:web      # Frontend only (port 5173)

桌面版构建：

# One-click build + generate unpacked version
pnpm desktop:run

# Or full packaging as installer
pnpm package

# Generate unpacked directory only (no installer)
pnpm package:dir

测试：

pnpm test         # Run all tests (node:test)
pnpm typecheck    # Type checking
pnpm build        # Build all packages
pnpm test:e2e     # E2E tests (requires pnpm dev running)

🧩 DeepSeek Harness (dsh) 插件

Molio 的知识库也提供 DeepSeek Harness (dsh) 只读插件，让 dsh Agent 能在对话期间搜索和读取本地 Molio 知识库：

dsh plugin add dsh-plugin-molio

它通过本地 Molio 守护进程 HTTP API 提供 5 个只读工具（molio_status、molio_kb_vaults、molio_kb_tree、molio_kb_search、molio_kb_read）。需要运行中的 Molio 服务（桌面应用或 Docker）。详情：packages/dsh-plugin-molio/README.md · npm：dsh-plugin-molio

🏗️ 架构

Molio/
├── packages/
│   └── contracts/       @molio/contracts — Shared type definitions
├── apps/
│   ├── daemon/          @molio/daemon   — Hono HTTP server (API + SSE)
│   ├── web/             @molio/web      — Vite + React frontend
│   └── desktop/         @molio/desktop  — Electron desktop shell
└── package.json         Monorepo root config

技术栈：

• 前端： React 19 + Vite 6 + TypeScript
• 后端： Hono + Node.js + SQLite (better-sqlite3)
• 桌面端： Electron 40 + electron-builder
• 构建： pnpm workspace 单体仓库

❓ 常见问题

macOS 提示应用“已损坏，无法打开”

这是 macOS Gatekeeper 发出的安全警告，因为 Molio 目前尚未通过 Apple 公证（需要订阅 Apple Developer Program，每年 $99）。这并非应用本身的问题。你可以：

**选项 1（推荐）：**右键点击应用 →“打开”→ 在对话框中点击“打开”（仅首次启动时需要）。

**选项 2：**在终端中运行：

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

之后，双击即可正常打开。

🏢 定制服务

把核心知识留在自己的环境中——按需提供数据处理、咨询和私有化部署。一个演示，足以说明一切。

了解更多 →

🤝 参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解相关指南。

主要原则：

• 所有更改都必须通过 Pull Request（不得直接推送到 main）
• 遵循 Conventional Commits 规范：feat(scope): description
• 为错误修复添加测试（守护进程/桌面端使用单元测试，Web 使用 E2E 测试）
• 提交 PR 前运行冒烟测试

💬 社区与支持

在 GitHub 提交问题，或扫描下方二维码加入我们的微信社区：

❤️ 致谢

Molio 的灵感和支持来自以下优秀的开源项目：

• multica — 开源 Agent 管理平台，启发了 Molio 的多运行时编排
• doocs/md — 微信 Markdown 编辑器，为 Molio 的排版引擎提供支持
• doocs/cose — 多平台内容分发扩展，为 Molio 的发布能力提供支持
• WeKnora — 腾讯开源的知识管理平台，为设计理念提供参考

感谢这些项目的作者和社区！

📄 许可证

修改版 Apache 2.0 — 基于 Apache License 2.0，并附加了商业使用限制。可免费用于内部和非商业用途；商业托管/嵌入需取得商业许可证。

---