Aerdelan/MirrorNovel

MirrorNovel – AI駆動の長編フィクション執筆プラットフォーム

何であるか

• 大規模言語モデルの助けを借りて、小説（従来のWeb小説やライトノベルスタイル）を執筆できるフルスタックWeb/デスクトップ/モバイルアプリ。
• ワークフローは アウトライン → ブループリント → 章の文章 → 仕上げ であり、各ステップがUIにストリーミングされるため、著者はモデルの「思考」をリアルタイムで観察でき、いつでも中断可能。

主な機能

機能	得られるもの
一冊全体または単一章モード	一気に一冊の小説を書くか、1章ずつ集中して執筆。
ストリーミング生成（SSE）	オウトライン、ブループリント、文章、仕上げ、編集プロセスが生成される度にブラウザにプッシュされ、リアルタイムのトークン使用量カウンター付き。
コンティニュイティエンジン	永続的な章要約、伏線、登場人物の状態、感情の推移、未解決の疑問などが保存され、章間で自動的に再利用。
書き手のパーソナ	事前設定されたパーソナを選択、テンプレートを編集、またはAIが生成するパーソナで声、テンポ、スタイルを制御。各小説はパーソナをスナップショットするため、後からの変更が既存のテキストに影響しない。
専門家レビューモード	各章の後にシステムが自動的にコンティニュイティチェックを行い、問題箇所を自動修正可能。
仕上げ・編集エンジン	2段階の「AI除去」再構成（差分表示付き）と、3段階ワークフロー（構造 → スタイル → AI除去）。
インポート＆継続	.txt ファイルをアップロードするか、既存の文章を貼り付ける。AIが文脈（登場人物、プロットポイントなど）を抽出して物語を継続。
マルチモデルルーティング	各タスク（アウトライン、執筆、推論、仕上げ、記憶）に対して、OpenAI互換エンドポイントまたはOllamaサーバーを指定可能。
管理コンソール	ユーザー管理、モデルルート設定、データ概要のダッシュボード。
マルチプラットフォームクライアント	Vue 3 Web UI、ElectronベースのWindowsデスクトップクライアント、uni-appモバイルアプリ（Android APK）。

動作方法

• フロントエンド：著者用のVue 3 SPA、別途のVue 3管理用SPA、uni-appモバイルビルド。すべてRESTとServer-Sent Events（SSE）経由でバックエンドと通信。
• バックエンド：Node.jsで書かれたExpress 4 API。Mongooseを使用して、小説、章、パーソナ、要約などをMongoDBに保存。
• AIレイヤー：OpenAI互換のチャットコンプリーションサービス（またはローカルのOllama）を各タスクにルーティング。深層思考モデル（例：GLM-thinking、DeepSeek-R1）をサポート。推論予算を文章生成予算と分離し、「トークンの無駄遣い」を回避。
• デスクトップクライアント：静的Webアセットをバンドルし、API呼び出しをプロキシするElectronシェル。NSISでWindowsインストーラーにパッケージ化。

クイックスタート（開発用）

# クローンしてすべての部分をインストール
git clone https://github.com/Aerdelan/MirrorNovel.git
cd MirrorNovel

# サーバー依存関係
cd server && npm install && cp .env.example .env   # .envを編集：MongoDB、JWTシークレット、モデルキー

# クライアント、管理、モバイルの依存関係
cd ../client && npm install
cd ../admin && npm install
cd ../app && npm install

# 別々のターミナルで3つのサービスを実行
cd ../server && npm run dev   # APIは :3000
cd ../client && npm run dev   # 著者UIは :5173
cd ../admin && npm run dev    # 管理UIは :5174

要件：Node ≥ 18、MongoDB ≥ 6、OpenAI互換モデルエンドポイント（またはOllama）。

デスクトップ配布

• 各タグでGitHub Actionsにより自動的にプリビルドWindowsインストーラー（MirrorNovel Setup x.y.z.exe、約79 MB）とポータブルwin-unpackedフォルダがアップロードされる。
• インストーラーは署名されていないため、初回起動時にWindows SmartScreenが警告を表示する。
• デスクトップアプリは単なるシェル。依然としてリモートバックエンド（デフォルトは公式サーバー）に接続しており、設定で変更可能。

デプロイのヒント

• Vueクライアントをビルドする（npm run build）し、Nginx/Caddyで静的ファイルを配信。
• Express APIはプロセスマネージャー（PM2、systemd、Docker-Compose）で実行。/apiをAPIにプロキシし、SSEタイムアウトを長めに設定。
• MongoDBインスタンスをセキュアに保ち、JWTシークレットとモデルキーをリポジトリ外に保ち、HTTPSを有効化し、認証エンドポイントにレートリミットを追加。

ライセンス

• リポジトリは LICENSE に記載されたライセンスの下でリリース（READMEには正確なSPDX識別子は表示されない）。ユーザーは接続する任意のサードパーティモデルサービスの利用条件も遵守する必要がある。

---

MirrorNovel は、ストリーミングLLM生成、長距離ナラティブ記憶、マルチプラットフォームUIを組み合わせた本格的なオープンソースAI支援執筆プラットフォームであり、著者が長編フィクションを構築するのを支援します。