Molio Knowledge Base

---

あなたが蓄積してきたものは、ひとつの種類に限りません。メモ、ドキュメント、チャットログに散らばった経験や手法だけでなく、書籍、図版を含む PDF、膨大な業界資料もあります。その大半は AI が読めない形式のまま保管されているため、会話のたびにゼロから始めることになります。

Molio は、蓄積してきたすべてを AI が読み、活用できる個人用ナレッジベースに変えます。Claude Code、Codex などのエージェントがあなたの知識空間に入り、調査、執筆、質問への回答、分析など、蓄積したすべての情報を活用して作業し、その成果を Markdown として書き戻すため、タスクのたびにナレッジベースが充実していきます。すべての処理はあなたのマシン上で実行され、サードパーティのサーバーを経由することはありません。

ゼロから始めますか？リソースライブラリには、すぐに使えて継続的に拡充されるナレッジベースが用意されています。ひとつインポートして、すぐに質問を始められます。

🔁 仕組み

01 · 収集と処理 — 散在する断片も、一冊の本も、すべて呼び出し可能なナレッジベースに

入力できる形式に制限はありません。Web クリッパーでワンクリックでページを取り込んだり、Obsidian の保管庫を直接開いたり、ローカルのドキュメントを一括インポートしたりできます。スキャンした PDF や Word／PPT／Excel ファイルは、同梱の docling でレイアウト解析、OCR、表の再構成を行います。画像は OCR で読み取り、数百万文字に及ぶ書籍は、処理を再開できる進捗管理付きの分割前処理・要約パイプラインで処理します。ディスクに保存されるのはプレーンな Markdown です。移行は不要で、ロックインもありません。

その後、Wiki エンジンが統一された Markdown レイヤーからエンティティや概念を抽出し、密な相互リンクと階層的なインデックスを織り上げます。データは処理されて初めて基盤になります。

02 · 作業とタスク — エージェントがあなたのデータを活用

Claude Code、Codex、Gemini CLI、Qwen Code などのエージェントがあなたの知識空間で作業し、調査、執筆、質問への回答、分析を行います。エージェントが目にするのは何もない状態ではなく、あなたが蓄積してきたすべてです。統一 GUI でエージェントを選び、ストリーミング出力を確認できます。QR コードをスキャンすれば、WeChat 経由でスマートフォンからナレッジベースとチャットできます。

03 · 再構成と蓄積 — 使うほどナレッジベースが充実

各タスクの成果は Markdown として書き戻され、再利用可能な長期資産になります。ナレッジグラフは成長し続けるため、次のタスクはより高い地点から始められます。公開する準備ができたら、doocs/md で組版し、30 以上のプラットフォームにワンクリックで配信できます。

📥 対応入力

入力	処理内容
Markdown / TXT / HTML / CSV などのテキスト	そのまま読み込みます — ナレッジベースの標準的な形式です
PDF	レイアウト解析 + OCR + 表の再構成 → Markdown
Word / PPT / Excel	同じパイプラインで処理し、見出しの階層と表を保持します
画像（PNG / JPG / TIFF）	OCR によるテキスト抽出
Web ページ	ワンクリックでクリップ、または WeChat 投稿から記事を抽出します
Obsidian vault	その場で開きます — 元のファイルは読み取り専用です
100 万語の書籍	チャンク分割による前処理 + ダイジェストのパイプラインで処理し、再開できます

PDF および Office の変換には、同梱の docling スキルを使用します。初回の変換時にツールと約 500MB のモデルをダウンロードします。以降の実行ではキャッシュを再利用します。

📦 すぐに使えるナレッジベース

Molio はツール本体に加えて、すぐに使える構造化ナレッジグラフも提供しています。書籍や専門分野全体をあらかじめ整理し、AI が利用できるナレッジベースとして構成したもので、ゼロから構築することなくワンクリックでインポートできます。

対象分野は、文学、歴史、哲学、中国伝統医学、医学、AI エンジニアリングです。新しいリソースも定期的に追加されています。注目のリソースには、オントロジー・ナレッジベース、『資治通鑑』知識体系、産科超音波ナレッジベースなどがあります。最新の全カタログはリソースライブラリをご覧ください。

これらは、AI が独力で生み出せない、独自に構造化された資産です。Molio にインポートすれば、すぐに AI による質疑応答、関係の検索、テーマ別の調査を実行できます。

• 『紅楼夢』：全 120 回にわたる人物とイメージ
• 『金瓶梅』：人物、商業、社会構造
• 『史記』：人物、制度、思想
• 『資治通鑑』：1362 年にわたる興亡
• 『明史』：帝国、制度、宮廷政治
• 『周易』：64 卦すべての爻変と象数の分析
• 老子・荘子：中核となる概念体系
• 中国・西洋哲学：ローカル AI 向けナレッジベース
• 中国伝統医学の古典：六経・三焦の弁証体系
• 産婦人科超音波：胎児異常、徴候、鑑別診断
• 知識工学：オントロジー、RAG、GraphRAG、エージェントエンジニアリング
• 広東省大学入試の出願計画：大学と専攻
• 『三国志演義』：全 120 回の人物相関図
• 図面データの抽出：エンジニアリング図面から計算可能なデータへ
• PCB フレキシブル製造：オンライン注文から無人稼働工場へ
• 司法試験の刑法：131 の出題ポイントと記述式問題の演習
• 中国古典詩文：全体を俯瞰できるナレッジベース

すべてのリソースを見る →

📡 チャネル

1 つの Molio インスタンスで、複数のチャネルに同時に対応できます。ほとんどのチャネルは、Web コンソールから直接追加できます。

チャネル	テキスト	画像	ファイル	音声	グループ
Web コンソール (デフォルト)	✅	✅	✅	✅	—
WeChat	✅	✅	✅	⏳	⏳
Feishu	✅	✅	✅	⏳	✅
Telegram	⏳	⏳	⏳	⏳	⏳
Slack	⏳	⏳	⏳	—	⏳
Discord	⏳	⏳	⏳	—	⏳

✅ 対応済み · ⏳ 対応予定 · — 該当なし

🖼️ スクリーンショット

エージェントワークベンチ：ストリーミング応答に対応したマルチエージェント機能	ナレッジスペース：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 サービスとして実行します。1 つのコンテナーにデーモン、Web UI、Claude Code CLI が含まれており、linux/amd64 と linux/arm64 の両方で動作します。Synology、QNAP、TerraMaster、TrueNAS、Unraid をはじめ、ほとんどの NAS デバイスに対応しています。

⚠️ デスクトップアプリとの違い（デプロイ前にお読みください）

• アクセス方法はブラウザーのみです。このモードではデスクトップクライアントはありません。 Electron デスクトップアプリは、起動したローカルのデーモン（localhost）とのみ通信します。リモートの NAS／サーバー上で動作するコンテナーには接続できません。
• デーモンはコンテナー内で動作し、コンテナーにマウントされたディレクトリのみ読み書きできます。 「フォルダーピッカーでローカルの任意のフォルダーをナレッジベースとして選ぶ」デスクトップのワークフローは利用できません。ブラウザーにはフォルダーピッカーがないため、ナレッジベースを追加する際は、NAS ホストのパスではなく、コンテナー内部のパス（例：/vaults/your-folder）を入力します。
• フォルダーをナレッジベースとして公開するには、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 を開き、Settings → Runtimes に移動して、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

既存のドキュメントフォルダーをコンテナー内の /vaults にマウントするには、.env で MOLIO_VAULT_PATH を設定します。すべてのオプションについては、install.sh と .env.example を参照してください。

開発（ソースから）

ソースからビルドする場合や、開発に貢献する場合：

前提条件：

• Node.js >= 22
• pnpm >= 9
• 次のAIランタイムCLIのうち、少なくとも1つ：
  • 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のエージェントがローカルのMolio vaultを検索して読み取れます。

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ワークスペースのモノレポ

❓ よくある質問

macOSで「アプリが破損しているため開けません」と表示される

これはmacOS Gatekeeperのセキュリティ警告です。Molioは現在、Appleの公証を受けていないためです（年間99ドルのApple Developer Programへの登録が必要です）。アプリ自体に問題があるわけではありません。次のいずれかをお試しください。

オプション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でイシューを作成するか、以下のQRコードを読み取ってWeChatコミュニティに参加してください。

❤️ 謝辞

Molioは、次の優れたオープンソースプロジェクトから着想を得て、支援を受けています。

• multica — オープンソースのエージェント管理プラットフォーム。Molioのマルチランタイムオーケストレーションの着想源です
• doocs/md — WeChat Markdownエディター。Molioの組版エンジンを支えています
• doocs/cose — マルチプラットフォーム向けコンテンツ配信拡張機能。Molioの公開機能を支えています
• WeKnora — Tencentのオープンソースのナレッジ管理プラットフォーム。設計思想の参考にしています

これらのプロジェクトの作者とコミュニティに感謝します！

📄 ライセンス

Modified Apache 2.0 — Apache License 2.0をベースに、商用利用に関する追加の制限を設けています。社内利用および非商用利用は無料です。商用ホスティング／組み込みには商用ライセンスが必要です。

---