AIの「忘れっぽさ」を克服！200万字級のWeb小説をAIと一緒に書き続ける創作支援システム — webnovel-writer

アーキテクチャ・仕組み

• Claude Codeプラグインとして動作し、Skills（スキル）・Agents（エージェント）・References（参照情報）の3層構成
• RAG（Retrieval-Augmented Generation）: 過去の章やキャラクター設定を自動検索して文脈に注入することで、AIの「遺忘（忘れ）」と「幻覚（でっち上げ）」を抑制
  • 埋め込みモデル（Qwen3-Embedding-8B等）でテキストをベクトル化
  • リランクモデル（jina-reranker-v3等）で検索精度を向上
  • auto/graph_hybrid モードではBM25（キーワード検索）へのフォールバックも対応
• エンティティグラフ: キャラクター・場所・アイテムなどの関係をグラフ構造で管理

主要コマンド一覧

追読力システム

v5.3で導入された独自機能で、読者を引きつける要素を定量的に追跡：

• Hook（フック）: 読者の興味を引く仕掛け
• Cool-point: 盛り上がりポイント
• 微兌現（マイクロペイオフ）: 小さな伏線回収
• 債務追跡: 未回収の伏線を管理

ダッシュボード

• 読み取り専用のWebベース可視化パネル
• プロジェクト状態、エンティティグラフ（人物関係図）、章・大綱の閲覧、追読力の確認が可能
• フロントエンドはプラグインに同梱済みで、ユーザー側での npm build は不要

Agentモデル設定

• デフォルトは model: inherit（親セッションのモデルを継承）
• 個別にsonnet / opus / haikuなど指定可能
• 設定は webnovel-writer/agents/*.md のfrontmatterで変更

対応環境

• Python: 3.10以上
• Claude Code: 互換（公式Plugin Marketplace対応）
• 外部API: 埋め込みモデル（ModelScope等）、リランクモデル（Jina等）が必要

ライセンス

• GPL v3: コピーレフト型のオープンソースライセンス。改変・再配布時にもソースコード公開が必要

開発手法

• Claude Code + Gemini CLI + Codex を組み合わせた「Vibe Coding」方式で開発

1. プラグインのインストール（Claude Code公式マーケットプレイスから）

claude plugin marketplace add lingfengQAQ/webnovel-writer --scope user
claude plugin install webnovel-writer@webnovel-writer-marketplace --scope user

2. Python依存パッケージのインストール

python -m pip install -r https://raw.githubusercontent.com/lingfengQAQ/webnovel-writer/HEAD/requirements.txt

3. 小説プロジェクトの初期化（Claude Code内で実行）

/webnovel-init

4. RAG環境の設定（必須）

プロジェクトルートで .env を作成し、埋め込みモデルとリランクモデルのAPIキーを設定：

cp .env.example .env

.env の最小構成例：

EMBED_BASE_URL=https://api-inference.modelscope.cn/v1
EMBED_MODEL=Qwen/Qwen3-Embedding-8B
EMBED_API_KEY=your_embed_api_key
RERANK_BASE_URL=https://api.jina.ai/v1
RERANK_MODEL=jina-reranker-v3
RERANK_API_KEY=your_rerank_api_key

5. 執筆開始

/webnovel-plan 1
/webnovel-write 1
/webnovel-review 1-5