統合小説執筆環境(VSCode拡張機能)
書くこと以外、引き受けます。 プロットづくり・設定資料づくり・見直し・投稿の準備・電子書籍とPDFでの出版までを、原稿に手を触れないAIと一緒に片づけるVS Code拡張機能です。
すでに投稿サイトで書いている方は、サイトのバックアップを渡すところから始められます(カクヨム・小説家になろう・アルファポリス)。話ごとに切り分けて登録するまで、キーを打つ必要はありません。
大切な原稿は、GitHub同期などでバックアップを取りながらお使いください。


このリポジトリの版:1.0.19(Marketplace に出ている版は 1.0.11)。Marketplace に出ている版はこれより遅れることがあります。
Cursor・VSCodium など VS Code 以外のエディターでは、Open VSX から入れられます。
- 原稿を書き換えるAIはいません。提案を適用するのは、いつもあなたです。
- 手元AI(Ollama / LM Studio)なら無料で使えます。クラウドAIも、鍵を入れれば機能ごとに選べます。
- 原稿がどこへ出るかは、作品ごとにあなたが決めます。外部AI(MCP)は既定で拒否します。GitHubへ出るのは、同期を設定した作品だけです。外部AIに読まれた記録は編集履歴に残ります。
- 原稿はただのテキスト/Markdownファイルです。他のエディターとも共存できます。
できること
| 場面 |
できること |
| 始める |
プロットから/本文から新規作品を作る。投稿サイトのバックアップから取り込む(カクヨム・小説家になろう・アルファポリス)。既存のフォルダーやGitHubの作品を登録する |
| 書く |
文字数の自動集計、原稿用紙換算、執筆量の記録とグラフ、縦書き/横書きの原稿エディター、ルビ・傍点、用語の色分け、校正・メモパネル、読み上げ |
| 段取りを組む |
公募の締切・自費出版や出版社の発売日・WEB連載の開始日から作業を逆算し、全作品を縦が時間・横が作品の1枚に並べる。機器間で同期する |
| 資料をためる |
本文から登場人物・能力・組織・場所・世界観を抽出する。名前の点検と付け替え、人物相関図、年表 |
| 整える |
本文からプロットを起こす。各話あらすじ・作品紹介文・キャッチコピー・更新告知文。感情曲線 |
| 直す |
誤字脱字・表記ゆれ・推敲・矛盾・プロット逸脱・伏線の検知。指摘は1件ずつ確認して適用する |
| 相談する |
開いている画面についてAIに日本語で質問する。この拡張機能の使い方も聞ける。あなた自身が「読者として」何を求めるかを覚え、作品の読者との違いを知らせる |
| 持ち運ぶ |
GitHubで複数の環境を行き来する。1つのリポジトリ(書庫)に複数の作品を置ける |
| 投稿する |
投稿サイトごとのルビ・傍点記法へ変換してコピーする。投稿状況・ランキングの記録と推移のグラフ。なろうAPIによる自分の作品の数と順位の取得。読者の反応を、そのサイトの言葉で記録する(PV・お気に入り・評価・話ごとの反応) |
| 出版する |
EPUBエディター(表紙・目次・挿絵・奥付)、印刷用のPDF出力 |
| 書き出す |
設定資料集のMarkdown(提供先別にも)、IME辞書(Google日本語入力・MS-IME・ATOK) |
インストール
VS Codeの拡張機能ビュー(Ctrl + Shift + X、Mac は Cmd + Shift + X)で「統合小説執筆環境」を検索してインストールしてください。更新はVS Codeが自動で行います。対応バージョンはVS Code 1.90.0以降です。
code --install-extension nonahisa.novel-ai-assistant
再読み込みすると、左端のアクティビティバーに、キーボードと芽の出た万年筆のアイコンが追加されます。
VSIXファイルから入れる(配布前の版を試す場合)
GitHubのReleaseに置いたVSIXからも入れられます。新規のインストールにも上書き更新にも使えます。
$v = (gh release list --repo nonahisa/novel-ai-assistant --limit 1 --json tagName | ConvertFrom-Json).tagName
gh release download $v --repo nonahisa/novel-ai-assistant --pattern "*.vsix" --clobber
code --install-extension ".\novel-ai-assistant-$($v.TrimStart('v')).vsix" --force
Mac のターミナル(zsh)では次のとおりです。code が見つからないときは、VS Code のコマンドパレットで「シェル コマンド: PATH 内に 'code' コマンドをインストールします」を選んでから実行してください。
v=$(gh release list --repo nonahisa/novel-ai-assistant --limit 1 --json tagName --jq '.[0].tagName')
gh release download "$v" --repo nonahisa/novel-ai-assistant --pattern "*.vsix" --clobber
code --install-extension "./novel-ai-assistant-${v#v}.vsix" --force
画面から入れる場合は、「拡張機能」ビュー右上の ... →「VSIXからのインストール」で同じファイルを指定します。
必要なもの
動く OS は Windows と macOS で、VS Code 1.90.0 以降が要ります。Linux では動作を確かめていません。
作品の管理・文字数・執筆量のグラフは、入れただけで使えます。AIを使う機能には準備が要ります。はじめて開くと「小説執筆へようこそ」と声をかけるので、[AIを選ぶ]を押すと使うAIを選べます。コマンドパレット(Ctrl+Shift+P、Mac は Cmd+Shift+P)で「統合小説執筆環境: セットアップ(必要なものを入れる)」を選ぶと、足りないものを一覧から選んで入れられます。取得量を先に表示し、途中で中止もできます。
| 何 |
何のために |
要否 |
大きさ |
| Ollama本体 |
手元のパソコンでAIを動かす(無料・原稿を外へ送らない) |
必須 |
約1GB |
会話モデル(セットアップで入るのは gemma4:e4b) |
抽出・生成・校正・相談 |
必須 |
約9.6GB |
埋め込みモデル(bge-m3) |
相談の意味検索 |
任意 |
約1.2GB |
| Git |
複数のパソコンで書く。過去の版へ戻す |
任意 |
約60MB |
| GitHub CLI |
非公開リポジトリの作成・取り寄せ |
任意 |
約12MB |
クラウドAIだけを使うならOllamaとモデルは要らず、1台だけで書くならGitとGitHub CLIも要りません。
誤字脱字・矛盾・伏線などの検知に使うなら、gemma4:26b(8GBのGPUでも動きます)かクラウドAIを勧めます。機能別AI割当で、機能ごとに選べます。
使い方
VS Codeの「ヘルプ → はじめに」にある「統合小説執筆環境をはじめる」から、書き方の診断・AIの選択・作品の用意・原稿エディター・困ったときの入口を順にたどれます。
はじめの案内(作家タイプ診断)
はじめて開いたときに声をかけます。詳細メニューの「作品執筆 › 相談・助言 › 作家タイプ診断」からも、いつでも呼べます。
5問(いま書いているもの/どこまで決めてから書くか/いつ直すか/設定はどこにあるか/どこへ出すか)に答えると、次にすることを、勧める理由を添えて案内します。案内は横に紙として開くので、あとから読み返せます。AIは使いません。
すでに原稿をお持ちなら既存フォルダーの登録から、これから書き始めるなら始め方から案内します。
答えはいつでも変えられます。同じ入口から「答え直す」を選んでください(前回の答えに印が付きます)。「答えを消す」を選ぶと、はじめて使うときの状態に戻り、開き直したときにまた声をかけます。
手が止まっているときの行き先も、いつでも選べます(前の話の終わり・読み上げ・相談・次の1話のプロット)。
案内の最後には、ほかのタイプの一覧が載ります。当たっていないと感じたら答え直してください。
続けて9問(相談の助言方針)に答えると、AIの言い方もそれに合わせます。9問は断れます。
画面
左端のアイコンを押すと4つのビューが並びます。
- 作品一覧:登録した作品と話数ファイル。右クリック(Mac は2本指で押すか、control を押しながらクリック)で作品ごとの操作ができます
- 簡単ステップメニュー:執筆の流れに沿った8つのステップ。迷ったらこちらから
- 詳細メニュー:全操作の一覧。分類 → 小分類 → 操作の3階層です。新作構想〜電子出版等の5つの分類は、簡単ステップメニューの段と同じ名前です
- AIに相談:開いている画面についてAIと話す窓
執筆データ 全作品執筆統計/執筆統計/作品目標設定/スケジュール/編集履歴
作品管理 作品名変更/シリーズ連結/メモ追加/新規執筆開始/既存原稿登録/クラウド取得/GitHub作品管理/編集者連携/作品別設定
新作構想 支援機能全工程実行/プロット自力作成/プロットモード/対話式プロット作成/プロット逆算/単話プロット作成/名前点検
作品執筆 相談・助言/原稿整備
自己校正 校正・校閲/読者診断
投稿脱稿 広報支援/投稿・出力
電子出版等 PDF出力/EPUBエディター
資料管理 資料抽出/資料閲覧(年表・作中時期・別筋登録を含む)
環境設定 設定管理/AI/初回設定
ヘルプ 使い方/場面別案内/ログ表示/障害報告用の記録/相談ログ/バージョン確認
項目末尾の「AI」はAIを呼ぶ操作(クラウドAIは実行のたびに課金)、数字は承認待ちの件数です。作品を登録していないあいだは、作品が要る操作が灰色になり、理由が出ます。
作品を登録する
- フォルダー登録(作品管理 → 既存原稿登録):すでに原稿があるフォルダーを指定します。カクヨム・小説家になろうからダウンロードしたファイルでも構いません
- GitHubから追加(作品管理 → クラウド取得):別の環境で書いている作品を取り寄せます。非公開リポジトリはGitHub CLI(
gh)を通して取り寄せます
- 新規執筆開始(作品管理):プロット起点(
設定/plot.md を用意)か、本文起点(本文/001.txt を作る)かを選びます。あとからどちらへも移れます
作品名/
├─ 本文/ ← 原稿
├─ 設定/ ← plot.md・設定資料・icons/
├─ .aiwriter/ ← 拡張機能の管理領域
└─ .gitignore
書庫:既定では1つのGitHubリポジトリに複数の作品を置きます。「作品管理 → GitHub作品管理 → GitHub初期設定」を選ぶと、隣に作品があれば、まとめるかどうかを訊きます。別々に作った作品は「環境設定 → 初回設定 → 書庫集約」で1つの書庫へ寄せられます。写すだけで、元のフォルダーは消しません。
話数の自動認識
| ファイル名 |
認識 |
001.txt |
第1話 |
007_湖畔の誓い.txt |
第7話「湖畔の誓い」 |
003-005_合本.txt |
第3〜5話 |
第12話 再会.md |
第12話「再会」 |
プロローグ.txt / 幕間1.txt |
プロローグ/幕間 |
全角数字と 〜 の範囲指定にも対応します。全話が1ファイルにまとまった形式(小説家になろうのダウンロード)は、中を読んで話ごとに分けて扱います。後書き・リアクションは本文に含めず、文字数にも数えません。
作品を右クリック →「新規話数ファイルを追加」で、最大話数+1のファイルを作れます。
文字数と執筆量
ツリーにはファイルごと・作品ごとの文字数が、ステータスバーには開いているファイル(と選択範囲)の文字数が出ます。ツールチップには総文字数・段落数・原稿用紙換算が出ます。原稿用紙の枚数は、20字×20行に組んだときの行数から数えます。
本文を保存するたびに、前回からの増減をその日の執筆量として記録します。「執筆データ → 執筆統計」でパネルが開きます。
- 執筆量タブ:日次30日・週次12週・月次12か月・年次のグラフ。目標線・達成率・連続日数
- 話ごとタブ:話数・タイトル・文字数・枚数・平均比の一覧(押すとその話が開きます)
目標(1日・1か月の字数、作品の文字量、締切前の書き上げ)に届くと、執筆統計に風船が上がります(作品の文字量と締切は花火も)。原稿エディターでは下の欄に一言出るだけです。同じ目標で祝うのは一度だけです。
初回の測定、ファイルの増減、競合件数の変化、pullによる増減は執筆量に数えません。記録は .aiwriter/stats/<環境名>.json に環境ごとに置き、読むときは合算します。「執筆データ → 全作品執筆統計」で全作品の合計を見られます。
「執筆データ → スケジュール」では、締切・発売日・連載開始から段取り(執筆・推敲・入稿など)を逆算し、縦が時間・横が作品の1枚に並べます。公募・自費出版・出版社・WEB連載に対応し、1つの作品にいくつでも置けます。作品の 設定/スケジュール.json に置くので、同期で機器間を行き来します。
原稿エディター(縦書き・横書き)
作品一覧から本文を開くと、原稿エディター(横書き)で開きます。上の列の[表示]→[縦書きにする]を押すと縦書きになります。素のエディターで開いた本文は、右クリックの「原稿エディターで開く」で原稿エディターへ移せます。
- ルビは振り仮名、傍点は圏点として組んだまま打ち込めます(
.md の {漢字\|かんじ} も、.txt の |漢字《かんじ》・《《強調》》 も表示します)
- 登場人物(青)・場所(緑)・能力(紫)・組織(橙)を色分けします。カーソルを合わせると設定の要点が出て、右クリックで設定資料を開けます。設定の食い違いは「変化かもしれない(外見): 黒髪(第1〜3話)→ 銀髪(第7話)」のように話数と並べて出ます
- 上の列には[入力][出力][補助][表示]の4つが並びます。押すと、その下に次のボタンが開きます
- [入力]:[テキストファイルから]・[バックアップから]・[Word から]・[口述]
- [出力]:[投稿](投稿ヘルパーへ渡す・コピー(投稿サイト用)・投稿サイト設定・投稿と読者の反応)・[読み上げ]・[PDF(この話)]・[音声に書き出す](人物の声で1話を MP3 に書き出す。先に読み上げの段の[声]で人物の声を選んでおきます)
- [補助]:[校正]・[単話プロット]・[ルビ]・[傍点](傍点は
.md のみ)
- [表示]:[縦書きにする]/[横書きにする]・[書体]・文字の大きさ([ー][+])。note の作品では[note風][貼り付け後]も出ます
- 下の欄:[← 前の話][次の話 →][最新話]と、右端に[保存]。その下に作品の総字数・このファイルの字数・今日書いた字数が出ます
- 保存・元に戻す・外部ツールで書き換えられたときの読み直しは、ふつうのエディターと同じです(文字コードと改行も変わりません)。ファイルの関連付けも変えないので、エクスプローラーから開けば従来どおりです
キー操作
原稿エディターの中で使えるキーです。
| Windows |
Mac |
すること |
Ctrl+S |
Cmd+S |
保存(下の欄に「保存しました(N字)」が出る) |
Ctrl+F |
Cmd+F |
本文を探す(Enter で次、Shift+Enter で前、Esc で閉じる) |
Alt+↑ / Alt+↓ |
Option+↑ / Option+↓ |
前の話 / 次の話を開く |
Ctrl++ / Ctrl+- / Ctrl+0、Ctrl+ホイール |
Cmd++ / Cmd+- / Cmd+0、Cmd+ホイール |
本文の字の大きさ(Ctrl+0、Mac は Cmd+0 で元に戻す) |
Ctrl+Alt+T |
Cmd+Option+T |
この話の誤字脱字を検知 |
Ctrl+Alt+P |
Cmd+Option+P |
推敲(範囲は「この話だけ」が先頭) |
Ctrl+Alt+H |
Cmd+Option+H |
表記ゆれ検知 |
Ctrl+Alt+A |
Cmd+Option+A |
校正一括実行 |
Ctrl+Alt+M |
Cmd+Option+M |
校正・メモパネルを横に開く |
F8 / Shift+F8 |
F8 / Shift+F8 |
次のメモへ / 前のメモへ |
Ctrl+/ |
Cmd+/ |
ここにメモを足す |
Ctrl+Alt+C |
Cmd+Option+C |
AIに相談 |
Ctrl+Alt+R |
Cmd+Option+R |
選んだ語にルビを振る |
Ctrl+Alt+K |
Cmd+Option+K |
選んだ語に傍点を付ける。傍点の付いた所なら外れる(.md のみ) |
日本語の変換中のキーと F6〜F10 は、日本語入力のまま使えます。変換中の F8 は半角カナへの変換になり、次のメモへは移りません。
これらのキーは原稿エディターを開いているときだけ使え、開いている原稿の作品・話に対して働きます。ほかの画面では、Ctrl+/・F8 はVS Codeのふだんの動きのままです。押したあとに出る窓は Enter で進み、Esc で取りやめられます。キーはVS Codeの「キーボード ショートカット」(Ctrl+K Ctrl+S、Mac は Cmd+K Cmd+S)で「統合小説執筆環境」と探すと変えられます。
テキストファイル・Word から取り込む
上の列の「入力」→「テキストファイルから」(.txt・.md)か「Word から」(.docx)を押し、ファイルを1つ選びます。文字コードは UTF-8・Shift_JIS・UTF-16 を読めます。Word の文書は、ルビと傍点を残して取り込みます。選んだファイルは書き換えません。
- 開いている話の本文が空なら、その話に入ります。題などの冒頭の欄はそのまま残ります
- 本文が入っていれば、どうするかを選びます
- 次の話として足す:開いている話のすぐ後ろに入れます。後ろの話は番号が1つずつずれ、ファイル名が変わります
- 最後に加える:最後の話の次の番号で足します。ほかの話は変わりません
- 上書きする:本文を取り込んだ文に置き換えます。消える字数は選ぶ前の窓に出ます。置き換える前の本文は控えに残ります
開いている話が最後の話なら、「次の話として足す」は出ません(「最後に加える」と同じになるため)。
1行目が題のように見えるときは、題にするかを先に訊きます。題にすると、1行目を本文から外し、冒頭の題の欄か、ファイル名のサブタイトルにします。.txt の話へ入れるルビと傍点は、投稿サイト設定で最初に登録したサイトの書き方になります(登録が無ければカクヨムの書き方)。
バックアップから話を足す
上の列の「入力」→「バックアップから」を押し、投稿サイトのバックアップ(カクヨム・小説家になろうの ZIP、アルファポリスや展開したなろうの .txt)を選びます。中の話が一覧に並びます。はじめは全部に印が付いているので、足さない話の印を外して OK を押します。
- 2話以上を選んだとき
- 次の話として足す:開いている話のすぐ後ろに、バックアップの中の順に入れます。後ろの話は足した数だけ番号がずれ、ファイル名が変わります
- 最後に加える:最後の話の次の番号から順に足します。ほかの話は変わりません
- 1話だけを選んだときは、「テキストファイルから」と同じです(本文が空の話ならその話へ入れ、入っていれば上書きも選べます)
話の題は、新しく作る話のファイル名のサブタイトルになります。入るのは本文だけで、前書き・後書き・リアクションは入りません。文字コード・改行は手元の原稿に合わせます。選んだバックアップは書き換えません。
この話だけを PDF にする
上の列の「出力」→「PDF(この話)」を押すと、開いている話だけを印刷用に組んでブラウザで開きます。組み方は「PDF出力」と同じです。ブラウザの印刷で「PDFに保存」を選ぶと PDF になります。
- 紙・向き・余白は、前に「PDF出力」で書き出したときのものです(まだ書き出していなければ文庫サイズ・縦書き)。変えるときは「PDF出力」で一度書き出してください
- 何話も入ったファイル(合本)では、カーソルのある話だけを組みます
- ブラウザ版の VS Code ではボタンが出ません
読み上げ(音読推敲)
原稿エディターの上の列の[出力]→[読み上げ]を押し、開いた読み上げの段の[▶ 読む]を押すと、OSの音声で読み上げ、読んでいる文が光ります。AIも通信も使いません。「⚑ 引っかかった」を押すと、その文の前にメモを残して一時停止します。
読み上げの段の[声]で「人物の声(AivisSpeech)」か「人物の声(VOICEVOX)」を選ぶと、手元のそのエンジンで人物ごとに声を変えて読みます。[声の割り当て]では AivisSpeech と VOICEVOX の両方の声から選べるので、人物ごとにエンジンを混ぜて読めます。「音声に書き出す」を押すと、1話を音声ファイル(MP3)にでき、クレジットと利用条件の注意書きも同じフォルダーに作ります。試作・テスト中です。
作品一覧の話を右クリックして「読み間違いを調べる」を選ぶと、ルビ・読みの辞書・設定資料で読みが分かっている語を、エンジンが別の読みで読みそうな所が校正・メモパネルに並びます。行の[読みの辞書へ足す]か[ここにルビを振る]で直せます。「音声に書き出す」の前にも自動で調べ、件数を確認の窓に出します。
メモと校正・メモパネル
行頭に //(全角 // も可)で書くと付箋になります。最初の語がタグです(TODO・要確認・伏線・アイデア・自由)。
// TODO ここに潮の匂いの描写を足す
作品ごとに \\(¥¥)・%%・<!-- ~ --> もメモの印にできます。左の端の統合小説執筆環境のアイコン → 詳細メニュー → 作品管理 → 作品別設定 → メモの印 で、作品と印を選びます(印は複数選べます)。
メモは蛍光黄色で示され、字数・投稿用コピー・PDF・プレビュー・AIへ渡す本文には入りません。原稿エディターの右クリック「校正・メモパネルを開く」で、メモと校正の指摘が位置順に並び、「次へ」「戻る」で話をまたいで移れます。
ルビと傍点
本文を範囲選択して、右クリック →「ルビ付与」「傍点付与」を選びます。漢字の直後にカーソルがあれば、範囲を選ばなくても拾います。傍点の付いた所なら、傍点付与で外れます(傍点の上で右クリックすると「傍点消去」が出ます)。
ルビは .md でも .txt でも振れます。書き方はファイルに合わせて入ります(.md は {漢字|かんじ}、.txt は |漢字《かんじ》)。すでにルビのあるところを選ぶと、いまの読みが入った入力欄が出て直せます。空にして確定すると外れます。傍点は .md だけです。
|
書き方 |
表示 |
| ルビ |
{漢字\|かんじ} |
漢字の上に「かんじ」 |
| 傍点 |
{{強調}} |
各文字の右上に点 |
投稿サイト用に変換するときは「コピー(投稿サイト用)」を使います。原稿エディターの右クリックなら選んだ範囲(選ばなければその話ぜんぶ)、作品一覧の話の右クリックならその話の本文、.md の右クリックとコマンドパレットなら開いているファイルの本文を写します。クリップボードへ入れるだけで、原稿は書き換えません。
| サイト |
ルビ |
傍点 |
| カクヨム/ネオページ |
|漢字《かんじ》 |
《《強調》》 |
| 小説家になろう/アルファポリス |
|漢字《かんじ》 |
|強調《・・》 |
| note |
漢字(かんじ) |
印を外す |
サイトの記法を取り込むときは「投稿脱稿 → 投稿・出力 → 投稿サイトルビ取込」を使い、サイトの記法を拡張機能の書き方へ読み替えます。件数は先に表示します。
読み仮名からまとめてルビを振るときは、設定資料パネルの「ルビを追加」を使います。範囲(すべての話/開いている話/話数を選ぶ)と、最初の1回だけか全部かを選べます。
テキストをMarkdownにする
「作品執筆 → 原稿整備 → 本文 .md 化」を選ぶか、話数を右クリックします。ファイル名を変え、投稿サイト記法のルビ・傍点だけをこの拡張機能の書き方へ直します。字そのもの・文字コード・改行はそのままです。直す前の本文は控えが残ります。
Shift_JIS の原稿を UTF-8 にする
「作品執筆 → 原稿整備 → 原稿 UTF-8 変換」を選ぶか、話数を右クリックします。「この話だけ」か「作品の Shift_JIS の話すべて」かを選び、変える話の名前の一覧を確かめてから変換します。UTF-8 にすると、♡や絵文字など Shift_JIS に無い字も書けます。字と改行は変わらず、変える前の本文は控えに残ります。
AI機能
AIを設定する
サイドバー右上の歯車、コマンドパレット(Ctrl+Shift+P、Mac は Cmd+Shift+P)の「統合小説執筆環境: AI設定」、または「環境設定 → AI → AI設定」から開きます。使うAIを選ぶと接続テストが走り、モデルの一覧から選べます。
| AI |
費用 |
APIキーの発行元 |
| Ollama |
無料・オフライン可 |
不要 |
| LM Studio |
無料・オフライン可 |
不要 |
| Gemini |
無料枠あり。超えると課金 |
aistudio.google.com |
| さくらのAI Engine |
無料枠あり。超えると課金 |
さくらのクラウド コントロールパネル |
| ChatGPT |
実行するたびに課金 |
platform.openai.com |
| Claude |
実行するたびに課金。Max・Team プランなら毎月のAPIクレジットの範囲で使えます(受け取り方) |
console.anthropic.com |
| VS Code 経由 |
VS Code 側の契約による |
不要(VS Code が持っています) |
APIキーはOSの資格情報ストアへ保存し、settings.json や作品フォルダーには書き込みません。 ログでは伏せ字にします。クラウドAIでは、呼び出しの多い処理の前にトークン量の目安を表示します。
- Ollama:事前に起動してモデルを取得します(検知に使うなら
ollama pull gemma4:26b)。コマンドパレットの「統合小説執筆環境: Ollama導入」で、足りないところだけを案内します
- LM Studio:モデルを読み込み、左の「Developer」からローカルサーバーを開始してから使います(APIキー不要)
- VS Code 経由:VS Codeに繋いであるAIを借ります(APIキー不要)。GitHub Copilotにサインインするか、VS Codeの設定に各社の鍵を入れてあれば選べます。モデルの名前に提供元が付きます。初回は許可を確認します。本文を分けて何度も送る機能(抽出・誤字脱字・推敲の通し)には向きません。Copilotの無料枠(チャット50回/月)では足りません
- コンテキスト長:ChatGPT・さくらのAI Engine・LM StudioはAPIから取得できないため、下記の
contextWindow に実際の値を入れてください。実際より大きいと、入力が知らないうちに切り捨てられます
- 機能別AI割当(環境設定 → 設定管理):8つの単位(抽出/誤字脱字/推敲/矛盾/逸脱/伏線/生成/相談)で使い分けられます
- AIチューニング(環境設定 → 初回設定・AIを使います):合言葉を入れた詰め物を送り、実際に読める上限を測ります。結果は「設定に書く」を押したときだけ設定へ入ります
設定資料をためる
- 一括抽出(資料管理 → 資料抽出):全話から登場人物・能力・組織・場所・世界観を1回の応答でまとめて取り出し、
設定/characters/ などのJSONと、読み用の characters.md・abilities.md・organizations.md・locations.md・world.md を作ります
- 設定資料集出力(投稿脱稿 → 投稿・出力):JSONから上の5つのMarkdownを作り直します(AIを呼びません)
- 設定資料集閲覧(資料管理 → 資料閲覧):左が一覧、右が詳細です。名前・読み・別名・性別・役割・性格・外見・説明・作者メモをその場で直せます。保存した項目は、以後の抽出で上書きされません
- 名前点検(新作構想):響きの近い名前を、強さと理由をつけて並べます(AI不要)。「候補を出す」で新しい名前を10件出し(AIを使います)、「付け替える」で本文の登場箇所を提案パネルに並べます。1件ずつでも、まとめてでも適用できます
- 人物相関図:「関係」と「呼称」から図を作ります(AI不要)。人物ごとの中心図とSVGの書き出しもできます
- 年表(資料管理 → 資料閲覧):1行が1話で、登場人物・作中の変化・能力の習得・呼称・伏線・あらすじが並びます。「作中時期・別筋登録」で時期を割り当てると、時系列順に並べ替えられます
- 設定資料項目追加(作品管理 → 作品別設定):誕生日・身長などを人物設定に足せます(定義は
設定/custom_fields.json)
- AIで再読込:各項目に入れる内容をAIが提案します。空欄を埋める提案だけが最初からチェックされ、既存の内容を置き換える提案には警告が付きます
- AIに相談する(設定資料パネル):人物についての質問や掘り下げができます。承認したものだけが
aiNotes へ追記されます
- 人物重複統合:「リン」と「リンセップ・アウクト」のような重複を1件にします(自動では統合しません)
- 設定資料更新分反映:再抽出で見つかった既存人物への変更は承認待ちになり、何が変わるかを見てから取り込めます
抽出するのは、名前、別名、役割、性格、外見、一人称、呼称(誰が誰をどう呼ぶか。相手ごと・呼び方ごと)、関係、登場話数です。同じ相手への複数の呼び方は、話数付きで全部残します。保存は1人1ファイル(char_001_月島灯.json)で、変更のないファイルは再処理しません。
ほかのAIに頼むこともできます。設定/_schema/ にAI向けの定義(日本語の README.md と JSON Schema)を書き出しているので、Copilot・Claude Codeなどに「設定/_schema/README.md を読んでから 設定/characters/ を更新して」と頼めます。外部から設定JSONが書き換えられると通知するので、内容を確認してから取り込めます。
整える・直す・相談する
- プロット逆算:各話あらすじを材料に、ログライン・テーマ・世界観・舞台・人称・行動原理・あらすじ・主要人物を
設定/plot.md へ書きます。作者が書いた項目は、確認せずに書き換えません
- 各話あらすじ:あらすじと一緒に感情曲線(盛り上がり0〜10・明暗−5〜+5)を測り、
設定/synopsis.md にグラフで入ります
- 作品紹介文・キャッチコピー・章立て:本文から下書きを作ります
- 更新SNS告知文作成(投稿脱稿 → 広報支援):ネタバレしない告知文を3種(X用・活動報告/近況ノート用・後書き用)作ります。貼るのは作者です(サイトへ自動で書き込みません)
- 誤字脱字・推敲・矛盾・プロット逸脱・伏線の検知(自己校正 → 校正・校閲):誤字脱字・推敲・矛盾・プロット逸脱の候補は校正・メモパネルに、伏線の候補は「提案」パネルに並べ、1件ずつ確認して適用します。方言や口癖は「直さない語」に登録して守れます
- 矛盾検知(事実の照合):同じ人が同じ時刻に離れた場所にいる・移動の時間が足りない・死んだ人物が地の文で動く、といった食い違いを照らします。本文の「馬で三日」「翌朝」も読み、読んだ距離は設定資料へ提案します。人物の「心と体が別の人物」を記録すると、憑依や入れ替わりの場面も照らします
- 表記ゆれ検知:「良い/よい」のような揺れを作品全体から探します(AIを使いません)。どちらに揃えるかを選ぶと、少数派の箇所が提案パネルに並びます
- AIに相談:左サイドバーの「AIに相談」、本文の右クリック、または詳細メニューの「作品執筆 → 相談・助言 → AIに相談」から始めます。いま開いているファイルについて日本語で質問できます(範囲を選ぶと、そこについての相談になります)。プロット・紹介文・キャッチコピー・各話あらすじは、確かめてボタンを押すと書き込めます(本文は対象外)
長い作品は、AIへ本文を丸ごと渡さず、その名前が出てくる場面だけを集めて渡します(既定で30箇所・12,000字まで、作品全体から均等に)。相談では、質問に近い場面を本文・設定資料・各話あらすじから探し、出どころ(《本文/第105話》)を添えて渡します。コマンドパレットの「統合小説執筆環境: ベクトル検索準備」を済ませておくと、言い換えでも見つかりやすくなります。埋め込みモデルは約1.2GBで、手元のOllamaで作るので無料です。既定は「切」です。
ログ
「ヘルプ → ログ表示」で見られます。.aiwriter/logs/actions.log にも保存されます(Gitの同期対象外)。本文そのものは書かず、APIキーらしき文字列は伏せ字にします。
不具合を伝えるときは「ヘルプ → 障害報告用の記録」で、直近の記録をテキスト1枚に書き出せます。前半の要約を Discord の /不具合を報告 に貼り、ファイルを添付してください。原稿の本文・AIの応答・人物名・作品名・APIキーは伏せます。外へは送りません。
使い方の質問・不具合の報告・機能の提案は、コミュニティ(Discord)で受け付けています:https://discord.gg/6pcuUaCMax (「ヘルプ → コミュニティ(Discord)」からも開けます)
Claude Codeから使う(MCPサーバー)
VS Code 版の Claude Code から、この拡張機能の道具(MCPサーバー novel-ai-assistant)を使えます。
- 左の端の統合小説執筆環境のアイコン → 詳細メニュー → 作品管理 → 作品別設定 → Claude Code接続 を押します
- 何をどこへ書くかが出るので、確かめて[つなぐ]を押します
- Claude Code のチャットで「/」を打ち、「novel-ai-assistant:setup」を選ぶと、会話しながら最初の作品まで準備できます
「ヘルプ → はじめに → 統合小説執筆環境をはじめる」の「Claude Code接続(任意)」からもつなげます。一度つなぐと、どのフォルダーで Claude Code を開いても使えます。
使う前に、作品ごとに許可が要ります。既定は拒否で、許可するまで外からは1文字も読めません。VS Codeでその作品を開き、「詳細メニュー → 作品管理 → 作品別設定 → 外部AI許可/取消」から許可してください。許可はこのパソコンだけに効き、いつでも取り消せます。
できることは、作品フォルダーの走査(合本は話ごとに分けます)と、誤字脱字・推敲・矛盾検知・伏線・相談・設定資料の抽出・各話あらすじ・プロット逸脱・単話プロット・表記ゆれのプロンプト作り・検算・実行です。原稿も設定資料も書き換えません。
- 本文をどこへ送るかは、毎回
runner で指定します。ollama は手元のOllamaで検算まで通し、結果だけを返します。claude はプロンプトを返し、Claudeが読んだ応答を検算へ戻します(このとき本文がAnthropicへ渡ります)
- 手元以外のOllamaへ送るときは
allowRemote を付けます
- 読むのは、指定した作品フォルダーの中だけです
- 読まれた記録は残ります。「執筆データ → 編集履歴」の下に、いつ・どの道具が・本文をどこまで外へ出したかが並びます。許可していない作品へのノックも残ります
開発する人向けの使い方
このリポジトリを Claude Code で開くと、.mcp.json の登録で novel-ai-assistant の道具が一覧に出ます。先に npm run build で dist/mcp-server.mjs を作っておきます。VS Code が起動していなくても動きます。
編集者の方と一緒に使う
設定 novelai.mode を editor にすると、本文の校正・校閲だけが使える状態になります(誤字脱字・表記ゆれ・推敲・直さない語・GitHub からの受け取り・文字数・設定資料の閲覧)。設定資料の抽出や更新、プロット、あらすじ、執筆統計、新規作品の作成は押せなくなり、理由が出ます。
作者が編集者へ渡す
- 左の端の統合小説執筆環境のアイコンを押し、作品一覧で渡す作品を選びます
- 左の端の統合小説執筆環境のアイコン → 簡単ステップメニュー → 6. 編集者校正・校閲 → 編集者へ渡す を押し、確認の窓で進めます。はじめてのときだけ、編集者の GitHub 名を訊かれます
- 作品だけの非公開リポジトリができ、編集者への招待が届きます。右下に出る[リンクを写す]を押し、写したリンクを編集者へメールやチャットで送ります
作者が編集者の提案を決める
左の端の統合小説執筆環境のアイコン → 簡単ステップメニュー → 6. 編集者校正・校閲 → 編集者の提案を見る を押すと、GitHub から受け取って、まだ決めていない提案が校正・メモパネルに並びます。行の[採る]か[見送る]で1件ずつ決めます(採る直前に本文と照らし合わせます)。意見は[読んだ]で片づけます。最後の1件を決めると、採否が編集者へ自動で送り返されます。
編集者として参加する
- 作者から届いたリンクを写しておきます
- 左の端の統合小説執筆環境のアイコン → 簡単ステップメニュー → 6. 編集者校正・校閲 → 編集者として参加 を押し、リンクを貼ります
- 招待の受け入れ・取り寄せ・登録・編集者モードへの切り替えまでが1回で進みます。切り替える前に、使えなくなる操作の一覧が出ます
すでに編集者モードのときは、左の端の統合小説執筆環境のアイコン → 編集者メニュー → 作品を足す(参加のリンクを貼る)を押してリンクを貼ります。
編集者メニュー
編集者モードでは、左の端の統合小説執筆環境のアイコンを押すと、いちばん上に「編集者メニュー」が出ます。手順が7つ上から並ぶので、順に押していけば、作者の原稿を受け取ってから作者へ返すまで進めます。
- 作者の最新の原稿を受け取る
- 校閲する話を選ぶ
- 機械に探させる
- 直しを提案する・メモ(意見)を書く
- 置いた提案を見直す
- 校閲を終えて作者へ返す
- 作者の採否を見る
- 各手順の左に「済み」「次はここ」「まだ」の印が付きます。作品名の下には、校閲中の話・置いた提案の件数・作者の採否・最後に受け取った時刻が出ます
- 複数の作品に参加しているときは、左の端の統合小説執筆環境のアイコン → 編集者メニュー → いちばん上の作品の行を押すと、作品を切り替えられます
- 左の端の統合小説執筆環境のアイコン → 編集者メニュー → この作品の編集を終える を押すと、その作品の登録が外れます。取り寄せたフォルダーは残ります
編集者モードでできること
- 編集者は本文を書き換えません。 「適用」を押しても提案として置かれます。作者が「編集者の提案を見る」を押すと、まだ決めていない提案が校正・メモパネルに並びます
- 校閲ロック:編集者モードの「作品管理 → 編集者連携 → 校閲開始/終了」で、始めの話と終わりの話を選ぶと、その範囲の話が「校閲中」になります。範囲の外の話は、作者が同時に書けます。作者は「編集者連携を解除」でいつでも外せます
- 編集者モードの「保存・同期」は GitHub から受け取るだけです。提案を作者へ送るのは「校閲を終えて返す」です
- 編集履歴:「執筆データ → 編集履歴」で、作者(●)・編集者(▲)・AI(■)を色分けして並べます(
.aiwriter/history/edits.jsonl。GitHubで同期されます)
- 競合:それぞれの版を最後に触った人の名前(gitの
user.name)が出ます
- 編集者がGitHub経由で設定資料を直したときは、通知の「この変更を守る」を押すと、以後AIに上書きさせません
GitHubで持ち運ぶ
「作品管理 → GitHub作品管理」から、同期・競合解決・復元を行います。Gitの用語を知らなくても使えます。
復元では、日時と件名の一覧から版を選ぶと、戻すと何が起きるか(内容が戻る/消える/復活するファイル)を先に見せます。いまの原稿は戻す前に履歴へ自動で残すので、やり直せます。
投稿・出版・書き出し
- コピー(投稿サイト用):上の「ルビと傍点」を参照
- 投稿状況の記録:投稿サイトごとの投稿状況・作品情報・ランキングを手元に記録します(サイトへの自動アクセスはしません)。順位は執筆統計のサイトごとのタブに推移のグラフで出ます。ランキングに入ったり順位が上がったりすると、風船や花火でお祝いします
- なろうAPIによる作品情報取得:小説家になろうの自分の作品(Nコードを登録した作品)の数と順位を、執筆統計の「なろうの反応」から取れます。なろうデベロッパー利用ガイドラインを開いて同意すると押せます(押したときだけ。同じ作品は1時間に1回まで。取った数はAIに渡しません)
- EPUBエディター:表紙・目次・挿絵・奥付・人物紹介を、プレビューで確かめながら組みます。飾り(SVG)は
設定/書籍/飾り/ か novelai.epub.ornamentFolder から足せます
- PDF出力:印刷用の組版
- 設定資料集のMarkdown:編集部向け・イラスト発注向けなど、提供先別にも出せます
- IME辞書:Google日本語入力・MS-IME・ATOK用
文字コードは、UTF-8(BOMの有無どちらも)とShift_JISを自動判別して読み込み、同じ文字コード・改行コードのまま書き戻します。
設定
Ctrl + ,(Mac は Cmd + ,)で設定を開き、「novelai」で検索してください。
執筆・表示
| 設定 |
既定値 |
説明 |
novelai.countMode |
net |
ステータスバーに表示する文字数の種類 |
novelai.excludeRubyFromCount |
true |
ルビ部分を文字数から除外する |
novelai.manuscriptEditor.vertical |
true |
「原稿エディターで開く」で開いた原稿を、はじめから縦書きにする |
novelai.manuscriptEditor.fontFamily |
(空) |
原稿の画面で使う書体。空なら明朝体 |
novelai.manuscriptEditor.readAloudRate |
1 |
読み上げの速さ(0.5〜2) |
novelai.readAloud.aivisSpeechUrl |
http://127.0.0.1:10101 |
人物の声で朗読するときの AivisSpeech の接続先。この PC の外のホストを書くと、本文がそのホストへ送られます(最初に確認を出します)。試作・テスト中 |
novelai.readAloud.voicevoxUrl |
http://127.0.0.1:50021 |
人物の声で朗読するときの VOICEVOX の接続先。この PC の外のホストを書くと、本文がそのホストへ送られます(最初に確認を出します)。試作・テスト中 |
novelai.readAloud.voiceEngineUrl |
http://127.0.0.1:10101 |
古い設定です。既定と違う値を書いてあれば、ポート番号が 50021 なら VOICEVOX、それ以外なら AivisSpeech の接続先として使います。新しい設定を書いたエンジンでは、新しい設定を使います |
novelai.episodeFileExtension |
.txt |
新規ファイルの既定の拡張子 |
novelai.episodeNumberDigits |
3 |
話数のゼロ埋め桁数(3なら 001.txt) |
novelai.chatter.enabled |
true |
書いている最中に、AIが相談パネルへひとこと差し込む(Ollamaのみ) |
novelai.stats.enabled |
true |
保存のたびに執筆量を記録する |
novelai.stats.showInStatusBar |
true |
ステータスバーに今日の執筆量を出す |
novelai.stats.dailyGoal |
0(目標なし) |
1日の目標字数 |
novelai.stats.monthlyGoal |
0(目標なし) |
1か月の目標字数 |
novelai.stats.dayBoundaryHour |
4 |
1日の区切りとする時刻 |
novelai.stats.weekStart |
monday |
週次グラフで週の始まりとする曜日 |
novelai.schedule.notify |
true |
スケジュールの段の開始・期日、締切・発売日・連載開始が近づいたら1日1回知らせる |
novelai.schedule.weekdayWeight |
1 |
スケジュールの逆算で、平日にどれだけ進むか(0 は休み)。平日は少し・休日に多く書くなら、平日を小さく・土日祝を大きく |
novelai.schedule.weekendWeight |
1 |
土日にどれだけ進むか(0 は休み) |
novelai.schedule.holidayWeight |
1 |
祝日にどれだけ進むか(0 は休み。土日と重なる祝日もこの割合) |
novelai.schedule.overlapPenalty |
0.1 |
自分で進める作業が同じ日に重なったときの、重なり1つごとに落ちる速さの割合 |
novelai.celebrations.enabled |
true |
目標に届いたら、執筆統計に風船(大きな目標は花火も)、原稿エディターの下の欄に一言 |
novelai.readerStats.importOnFocus |
true |
VS Code に戻ったとき、統合小説執筆環境ヘルパーがコピーした読者の反応を取り込むか訊く |
novelai.ownWorks.downloadFolder |
""(ホームの「ダウンロード」〔Downloads〕) |
「未登録の自分の作品」の[バックアップを取る]のあと、届いたバックアップを探すフォルダー |
novelai.epub.ornamentFolder |
""(指していない) |
EPUBの飾り(*.svg)を追加で読み込むフォルダーの絶対パス |
novelai.mode |
author |
この環境を作者(author)と編集者(editor)のどちらとして使うか |
曜日ごとに割合を変えたいときは novelai.schedule.weekdayOverrides に書きます(例:水曜は書かない → { "wed": 0 }。書いていない曜日は平日・土日の割合のまま)。
AI
| 設定 |
既定値 |
説明 |
novelai.ollama.endpoint |
http://localhost:11434 |
OllamaのURL |
novelai.ollama.executablePath |
""(自動検出) |
ollama 実行ファイルの場所 |
novelai.ollama.numCtx |
0(自動) |
AIへ渡すコンテキスト長。指定しないと入力が切り捨てられます |
novelai.ollama.streaming |
true |
Ollama の応答を流しながら受け取り、相談パネルに考えている中身を流す |
novelai.ollama.timeoutSeconds |
300 |
Ollamaの1回の呼び出しのタイムアウト |
novelai.lmstudio.endpoint |
http://localhost:1234/v1 |
LM StudioのローカルサーバーのURL |
novelai.lmstudio.contextWindow |
8192 |
LM Studioのコンテキスト長。読み込んだモデルに合わせてください |
novelai.lmstudio.timeoutSeconds |
300 |
LM Studioの1回の呼び出しのタイムアウト |
novelai.lmstudio.cliPath |
""(自動検出) |
LM Studioのコマンド(lms)の場所 |
novelai.lmstudio.loadContextLength |
0(モデルの最大) |
モデルを読み込むときの文脈の長さ |
novelai.gemini.endpoint |
https://generativelanguage.googleapis.com/v1beta |
GeminiのURL |
novelai.gemini.timeoutSeconds |
300 |
Geminiの1回の呼び出しのタイムアウト |
novelai.openai.endpoint |
https://api.openai.com/v1 |
ChatGPTのURL |
novelai.openai.timeoutSeconds |
300 |
ChatGPTの1回の呼び出しのタイムアウト |
novelai.openai.contextWindow |
128000 |
ChatGPTのコンテキスト長。実際より大きいと入力が切り捨てられます |
novelai.sakura.endpoint |
https://api.ai.sakura.ad.jp/v1 |
さくらのAI EngineのURL |
novelai.sakura.timeoutSeconds |
300 |
さくらのAI Engineの1回の呼び出しのタイムアウト |
novelai.sakura.contextWindow |
32000 |
さくらのAI Engineのコンテキスト長。実際に合わせてください |
novelai.claude.timeoutSeconds |
300 |
Claudeの1回の呼び出しのタイムアウト |
novelai.cloudMaxTimeoutSeconds |
600 |
クラウドのAIで待つ時間の上限。最大1800秒まで延ばせます |
novelai.maxOutputTokens |
16384 |
1回の応答で受け取る最大トークン数(出力は入力より単価が高い) |
novelai.chunkSizeMode |
モデルによって可変 |
AIへ1回に送る本文の量の決め方。既定はコンテキスト長から自動 |
novelai.chunkChars |
0(指定なし) |
1チャンクの文字数。「文字数を指定する」のときだけ使います |
novelai.mergeChunkChars |
6000 |
短い話をまとめて送るときの目安。「文字数を指定する」のときだけ(0 でまとめない) |
Git・検索・ログ
| 設定 |
既定値 |
説明 |
novelai.git.autoFetch |
true |
別の環境の変更を自動で取得する。取得だけで、原稿は書き換わりません |
novelai.git.autoFetchIntervalMinutes |
10 |
自動取得の最小間隔 |
novelai.git.autoResend |
true |
記録済みで送れていない分を、回線が戻ったら自動で送り直す。送るだけで、取り込みや合流はしません |
novelai.git.autoResendIntervalMinutes |
5 |
自動の送り直しを試す間隔(分) |
novelai.git.syncCache |
false |
抽出キャッシュをGitの同期対象にするか |
novelai.vectorSearch.enabled |
false |
相談で使う意味検索(ベクトルDB)を使うか |
novelai.vectorSearch.model |
bge-m3 |
意味検索に使う埋め込みモデル(変更すると索引は作り直し) |
novelai.vectorSearch.autoUpdate |
true |
相談を始めるときに、変更ぶんだけ索引を追加する |
novelai.vectorSearch.useInChecks |
false |
矛盾検知で意味の近い前の場面も渡し、伏線回収確認で意味の近い箇所だけを照らす |
novelai.chatLog.enabled |
true |
相談のやり取りを .aiwriter/logs/chat.md に残す(原稿の一部を含みます) |
novelai.usageLog.enabled |
true |
送った量を .aiwriter/logs/usage.md に1行残す(字数だけ) |
novelai.logs.retentionDays |
7 |
ログに残す日数(0で消さない) |
novelai.findings.retentionDays |
3 |
AIの指摘を並べ続ける日数(0でずっと並べる) |
novelai.proposals.showInBottomPanel |
false |
提案パネルを画面下のパネル領域にも出す(既定はエディターの右の列だけ) |
novelai.timeline.show |
false |
左のエクスプローラーの下の「タイムライン」欄に、話ごとの記録(編集履歴・提案・指摘・投稿・控えなど)を出す |
novelai.modelTuning は「AIが実際に読める長さを測る」が書き込む記録です(手で書く項目ではありません)。novelai.claude.maxOutputTokens は旧設定で、novelai.maxOutputTokens に置き換わりました。
novelai.confirm.remembered は、確認の画面で「以降は訊かない」を押したときに書き込まれる控えです。戻すときは、この設定の説明にある「訊かないことにした確認を見直す」から選ぶか、ここを空({})にしてください。
注意
- AIの結果は作者が確認してください。 抽出結果は本文との逐語照合で根拠のないものを除きますが、精度を保証するものではありません
- 本文(原稿)をAIが勝手に書き換えることはありません。適用するのは作者が押したときだけです(1件ずつでも、まとめてでも)。書き戻す前に本文が変わっていないかを照合し、変わっていれば中止します
- 安全対策:Gitの未解決競合(
<<<<<<<)を含むファイルは処理しません。未保存の変更が残る場合は開始せず、壊れたJSONがあれば上書きせず中止します
- 対応する投稿サイトの記法:カクヨム・ネオページ・小説家になろう・アルファポリス。noteへコピーするときは、ルビを括弧書き(漢字(かんじ))にし、傍点の印を外します
- 実データで確かめたAIは、Ollama・Gemini・さくらのAI Engine・LM Studio・Claudeの5つです。ChatGPTは実サービスへ繋いだ確認をしていません
- ブラウザ版(vscode.dev / github.dev)
- 確かめたこと:作品の登録(開いているリポジトリ・別のリポジトリ・「GitHubから追加」)と一覧表示、本文を開いて文字数を数えること、本文を書き換えて保存すること、設定資料・提案・執筆統計・プロットモードのパネル、設定資料の作者メモの保存、さくらのAI Engineでの相談、Claude に繋いで動くこと、ソース管理からGitHubへの保存
- GitHubとの同期:この拡張機能からはGitHubへ送れません。「作品管理 → GitHub作品管理 → 保存・同期」を押すと保存の手順が出ます。[ソース管理を開く]を押すと、VS Codeの「ソース管理」が開きます。そこで確定するとGitHubへ届きます。過去の版は、GitHubのサイトでファイルの履歴を開くと見られます
- 使えないこと:手元で動くAI(Ollama・LM Studio)と意味検索の準備、過去の版に戻す、競合の解決、全作品同期、GitHubのセットアップ、編集者とのやり取り(渡す・参加する・返す・取り消す)、PDF出力、Claude Codeとつなぐ、人物の声での朗読と音声への書き出し、なろうAPIによる作品情報取得、未登録の自分の作品の[バックアップを取る]。これらはメニューに出さないか、押したときに理由を出します
- まだ確かめていないこと:Gemini・ChatGPT・VS Code 経由のAI、相談以外のAI機能(抽出・誤字脱字の検知など)
- 未実装:相談パネルから、人物以外の設定資料(能力・組織・場所・世界観)へ書き込むこと。人物は「相談を資料へ反映」で、紹介文と新しい人物を資料へ直接書くか、承認待ちに積むかを選べます
アンインストール
拡張機能ビューから、または次を実行します。原稿、.aiwriter/、設定/characters/ は削除されません。
code --uninstall-extension nonahisa.novel-ai-assistant
開発者向け
npm install # 依存の取得
npm run build # ビルド
npm run watch # 監視ビルド
npm run check # 型検査+単体テスト+本番ビルド
npm run test:e2e # 画面の自動テスト(本物のVS Codeを外から押す)。check には入らない
VS Codeで F5 を押すと拡張機能開発ホストが起動します。
npm run package:vsix # release/ にVSIXを作る(リリースゲートを通ります)
npm run verify:vsix # 中身・隔離インストール・版を検証する
npm run release:github # タグを押して Release を作り、VSIXを添付する
release:github は、作業ツリーがきれいで、main が origin/main と同じで、gh にログイン済みでなければ止まります。ノートは docs/releases/vX.Y.Z.md を使い、無ければ CHANGELOG.md の先頭の節を使います。Marketplaceへの公開(npm run publish:marketplace)は別の操作です。
さくらのAI Engineのスモークテストは、GitHub Actionsの「Sakura AI Engine Smoke Test」で走ります(シークレット SAKURA_AI_ACCOUNT_TOKEN が要ります)。設計・仕様の文書は docs/ にあります。
ライセンス
MITライセンスです(全文は配布物に同梱の LICENSE.txt)。自由に使い、改変し、再配布できます。作者は何の保証も負いません。「バージョン情報」の[ライセンスを見る]からも開けます。
あなたが書いた小説・プロット・設定資料は、このライセンスの対象外です。 作品の権利はあなたのものです(この拡張機能が作ったファイルも同じです)。
組み込んで配布しているライブラリは次のとおりです(全文は配布物に同梱の THIRD-PARTY-NOTICES.md)。
| ライブラリ |
ライセンス |
用途 |
iconv-lite |
MIT |
Shift_JIS の読み書き |
diff |
BSD-3-Clause |
本文の差分 |
fflate |
MIT |
EPUB・Word 原稿・作品のまとめ(zip) |
undici |
MIT |
AIとの通信の待ち時間 |
buffer・path-browserify |
MIT |
ブラウザ版 |
@modelcontextprotocol/sdk・zod・ajv |
MIT |
外部AIとの接続(MCPサーバー) |
ほかに、これらが使う部品(base64-js・ieee754・safer-buffer など)も含みます。
リポジトリ:https://github.com/nonahisa/novel-ai-assistant