よくある質問

購入した note 販売記事のコメント欄までお願いします（個人情報は書かないでください）。返信はベストエフォートで、買い切りソフトウェアという性質上、即時対応は保証していません。

起動時に EADDRINUSE が出る場合、同じポートを使う別プロセスがあります。別ポートで起動するか、元のプロセスを止めてください。

# 別ポートで起動（PORT と API_PORT を同じ番号に）
PORT=3010 API_PORT=3010 npm run dev

多くは前回の Inkubus 自身のサーバが残っているのが原因です（Windows: netstat -ano | findstr :3000 → taskkill / macOS・Linux: lsof -ti:3000 | xargs kill）。

① Ollama が起動しているか（ローカルは ollama list、リモートは URL にブラウザでアクセスして「Ollama is running」）。② 設定画面の「接続テスト」で到達確認。③ OLLAMA_BASE 環境変数が変な値になっていないか。

• コンテキストが小さい: 64K（65536）以上を推奨。
• temperature が高すぎる: 1.5 以上だと日本語が崩れやすい。推奨 0.9〜1.1。
• モデルが小さい: 7B クラスは長文で破綻しがち。20B 以上推奨。

まず作品数 1・章数 4 で 1 本の所要時間を計測してください。総所要 ≒ 1 本の時間 × 100 + スリープ × 99。GPU 冷却スリープは「作品間スリープ (ms)」で調整可能（既定 60 秒）。途中で止めたくなったら「バッチを停止」でソフト/強制が選べます。

Ollama がフリーズすると「実行中」フラグが立ったままになることがあります。設定画面の「LLM 排他フラグ」から該当処理を強制クリアできます（誤クリアは二重発火の可能性、DB 整合性は保たれます）。詳細は ジョブの排他制御。

Inkubus はローカル LLM が書いた文章をそのまま表示・保存します。品質・適法性・倫理性は LLM の性能に依存し、保証はされません。利用前に必ず内容を確認してください。

メタは server/data/app.sqlite、本文は server/output/{runId}/{workId}/*.md。UI からも .md / .txt でダウンロードできます。

「削除」はソフト削除（DB 上で隠すだけ）です。ファイル実体は残ります。完全に消すには手動で server/output/{runId}/ を削除してください。

過去の作品・バッチは壊れません（ロール名は文字列として保存済み）。ただしそのロールで新規バッチを起動しようとするとエラーになります。

止まりません。バッチはサーバプロセスで走り、ブラウザは表示だけ。閉じてもヘッダの「実行中」バッジから戻れます。サーバプロセスが落ちた場合は、途中のバッチが interrupted 状態で保存されます。

キューはサーバ再起動で自動的に停止状態にリセットされます（意図せぬ自動起動を避けるため）。朝ジョブ画面を開いて「稼働中」に戻してください（キュー内容は消えていません）。また連続 2 回失敗でも自動停止します。

同じ Wi-Fi の PC で npm run dev を起動すれば http://<PC の IP>:5173 でアクセスできます（詳細は セットアップ）。LAN 公開に不安があれば HOST=127.0.0.1 npm run dev で localhost-only に戻せます。

Inkubus に認証はありません（LAN 内の全員にアクセスされる前提）。信頼できないネットワークでは LAN 公開をやめる（HOST=127.0.0.1）か、ファイアウォールで 3000 / 5173 への外部アクセスを遮断してください。外出先からは VPN 経由を。

アップデート手順を参照してください。サーバ停止 → 上書き展開 → npm ci → 起動の流れで、作品データ（server/data/ と server/output/）は消えません。