notnotype/neuro-book

NeuroBook – AI拡張型執筆環境

概要 – NeuroBookは、AIエージェントの助けを借りて長編小説（または構造化された物語）を執筆し、物語の世界観の一貫性を保つためのデスクトップファーストのアプリケーションです。小説をソフトウェアプロジェクトとして扱い、世界状態、プロットの概要、原稿をプレーンテキストのMarkdownとローカルのSQLiteデータベースとして保存します。World Engineにより、タイムライン上の任意の時点におけるキャラクター、場所、リソースの正確な状態を再計算できます。

重要性 – 大規模言語モデルは短い文章の生成には優れていますが、長編作品では一貫性が失われたり、伏線を忘れたり、散文に機械的な「AIっぽさ」が残ったりします。NeuroBookは以下の方法でこれらの問題を解決します：

• 会話メモリに頼るのではなく、時間とともに進化する world state を永続化します。
• 伏線の提示から回収までを追跡する commit-style の「約束台帳」（promise ledger）を提供します。
• 360のルールを持つリンター (llmlint) を実行し、典型的なAI生成の執筆上の欠陥を検出し、自動的に修正します。
• AIエージェント（リーダー、ライター、リサーチャー）に対する詳細な制御と、AIが変更を加える前に明示的な承認を必要とする3モードのワークフロー（議論 → 計画 → 適用）を作者に提供します。

主要コンポーネント

コンポーネント	役割
World Engine	タイムスタンプ付きスナップショットを持つ主体（キャラクター、王国など）を保存します。イベントソーシングログから任意の時点の状態を再計算可能です。
Plot Workbench	章、シーン、因果関係の連鎖を整理するための視覚的な「承載樹」（ストーリー構造ツリー）と「因果樹」（因果関係ツリー）。
Multi-Agent Studio	設定可能な権限とプロンプトを持つ個別のAIエージェント（リーダー、ライター、リサーチャー）を実行するハーネス。
llmlint	冗長な言葉、機械的な接続詞、定型的な言い回しなどをフラグ立てするリンター。多くの問題を自動修復可能です。
Profile & Workflow editor	コードを書かずにエージェントのコンテキスト、ツール、ステップバイステップのジョブを定義するためのTSXベースの視覚的エディタ。

入手方法

• Windows – Releasesページからポータブルzipをダウンロードし、Start Neuro Book.cmdを実行します。
• Linux / macOS – 提供されているインストールスクリプト (curl … | sh) を実行します。
• Docker / マルチインスタンス – NeuroBook Manager (bunx @notnotype/neuro-book-manager@canary) を使用すると、分離されたインスタンスの起動、更新の管理、Web UI経由でのアプリ公開が可能です。
• すべてのインストールで環境チェックが実行され、好みのLLMプロバイダーとAPIキーを選択できます。

典型的なワークフロー

1. 初期化 – 新しい「本」を作成すると、Markdown/TSファイルを含む lorebook/、manuscript/、world-engine/ フォルダが生成されます。
2. 世界の設定 – World Engine UIでキャラクター、派閥、暦などを追加します。変更はすべてタイムスタンプ付きで記録されます。
3. プロットの計画 – Plot Workbenchを使用して章とシーンをマッピングし、伏線を付与します。
4. AIエージェントの招待 – leader（プロット計画）、writer（ドラフト生成）、researcher（事実確認）を設定します。UIにインライン提案が表示され、書き込み前に承認を行います。
5. 執筆 – Markdown原稿を直接編集します。統合されたAIが選択したテキストの書き換え、続きの提案、リンターによるチェックを実行できます。
6. 監査 – いつでも過去の日付の世界状態を照会したり、約束台帳を表示したり、llmlintを実行して散文をクリーンアップしたりできます。

対象ユーザー

• 物語の制御権を失わずにAIの支援を受けたい小説家やワールドビルダー。
• 一貫した設定と追跡可能なプロットの伏線を必要とするゲームデザイナーやTRPGクリエイター。
• 物語をソフトウェアプロジェクトのように扱う（バージョン管理された状態、リンティング、自動チェック）という考え方を好む方。

コミュニティと貢献

• 公式Discord、QQグループ、および公開ドキュメントサイト（中国語と英語）。
• リポジトリは約15のワークスペース（コアアプリ、マネージャー、各種ライブラリ、llmlintパッケージなど）を含むモノレポです。
• プロンプトエンジニアリング、UI再設計、ドキュメント作成、テスト、または非技術的なコミュニティ活動など、貢献を歓迎します。

ライセンス – AGPL-3.0-only。執筆した作品は自身の所有物であり、NeuroBook自体の修正のみがコピーレフト条項の対象となります。

---

上記の詳細はすべてリポジトリのREADMEから直接引用したものであり、追加機能の推論は含まれていません。