InkOS Logo InkOS

Story Creation AI Agent
長編・短編小説、脚本、インタラクティブ影遊、IP コンテンツ、多言語翻訳のための創作 AI Agent システム

npm version License: AGPL-3.0 GitHub stars npm downloads ClawHub Skill

Kimi Open Source Friends

kkaiapi ホームページ

**[kkaiapi](https://kkaiapi.com/?utm_source=inkos&utm_medium=repo&utm_campaign=kk-models-readme&utm_content=ja-brand)｜APIキー1つでモデルを、MCP接続1つでデータとツールを利用。**
Claude、GPT、Gemini、DeepSeek などを InkOS の執筆・レビュー・表紙生成に。従量課金で、残高は共通です。
[モデルと料金 →](https://kkaiapi.com/models?utm_source=inkos&utm_medium=repo&utm_campaign=kk-models-readme&utm_content=ja-models) · [InkOS 接続ガイド →](https://kkaiapi.com/docs/inkos?utm_source=inkos&utm_medium=repo&utm_campaign=kk-models-readme&utm_content=ja-guide) · [MCP 接続 →](https://kkaiapi.com/api/information/skill?utm_source=inkos&utm_medium=repo&utm_campaign=kk-models-readme&utm_content=ja-mcp)

中文 | English | 日本語

--- InkOS は、物語創作と多言語翻訳のための AI Agent システムです。長編小説、独立短編、脚本、絵コンテ、二次創作、番外、文体模倣、続き書き、インタラクティブ影遊、インタラクティブ世界、長文翻訳を同じワークベンチから始められます。Studio Chat、CLI、TUI は同じ action surface を共有し、相談、確認、生成、レビュー、永続編集、言語をまたぐ納品を一つの流れで扱えます。 ## v2.0.0 統一 Pi Agent Harness と専門創作カーネル 1.x からの移行は `inkos work migrate --json` で確認し、`inkos work migrate --apply` で実行します。書籍の既定値、ルール、状態スナップショットを変換し、元のディレクトリと未記入の履歴情報を保持します。旧執筆設定は原本に残り、2.0 は Profile の操作方針を使います。実行状態が不足する作品は、再構築が必要な下書きとして登録されます。 InkOS 2.0 は、Chat Agent と各作品パイプラインを一つの pi-agent 中心 harness に統合します。モデルは理解・提案・能力呼び出しを担当し、InkOS は確認、コンテキスト、状態、原子的な保存、成果物の真実性を管理します。長編、短編、脚本、絵コンテ、インタラクティブ影遊、Play、翻訳は、それぞれの専門手法を保ちながら、実行・検索・観測・復旧基盤を共有します。 - **モデル設定**：Studio はサービス設定、モデルルーティング、表紙サービス、[kkaiapi](https://kkaiapi.com/models?utm_source=inkos&utm_medium=repo&utm_campaign=kk-models-readme&utm_content=ja-models) / OpenRouter などのモデル集約入口、カスタム OpenAI-compatible エンドポイントに対応します。 - **単一の production harness**：Studio Chat、TUI、`inkos interact`、production worker が pi-agent のツールループと型付き action/result 境界を共有します。既存 pipeline は並行する自然言語判断エンジンではなく、決定論的で中断可能な能力になります。 - **15 個の内蔵専門 Skills**：長編執筆 / レビュー、商業短編、Play、脚本、絵コンテ、インタラクティブ影遊、翻訳、分析、市場調査、取り込み、表紙、脱 AI 表現を専用 `SKILL.md` で提供します。 - **統一本地検索**：物語メモリ、資料庫、Skill 参考資料を、再構築可能な SQLite FTS5 / BM25 投影で検索します。原本ファイルが正規データであり、検索結果には出典位置が残ります。 - **書籍への参考資料バインド**：取り込んだ資料を用途付きで書籍に結び、タスクごとに関連部分だけを取得できます。 - **安全な章ワークスペース**：本文、状態、フック、実行スナップショットを検証してから原子的に保存し、状態だけが先に進む事故を防ぎます。 - **作品形式をまたぐ共通基盤**：Short、脚本、絵コンテ、インタラクティブ影遊、Play、翻訳が run snapshot、Skill、文字数観測、中断、復旧を共有しつつ、それぞれの状態と創作規則を保持します。 - **長時間タスクの安定化**：複数章は一つの復旧可能タスクとして順番に生成され、first-token / stream-idle timeout、古い状態の修復、atomic file set が受動的な停止と半端な完了を減らします。 - **TUI を Studio と整合**：`/new`、`/short`、`/play`、`/cover`、`/write`、構造化 `/confirm` / `/cancel`、セッション単位 `/model`、明暗背景対応カラーを追加しました。 - **モデルとワークベンチ**：LM Studio、永続化される動的モデル一覧と外部母本、カスタム表紙 Base URL、広い章プレビュー、安全な章リライトワークスペースに対応します。

InkOS インタラクティブ影遊ストーリーグラフ E2E スクリーンショット

### 主な創作形式

InkOS Short 表紙例 InkOS Play ファンタジー開放世界例 InkOS Play 恋愛例 InkOS Play 探偵例

**長編小説** — ブリーフから書籍を作成し、基礎設定、章の意図、コンテキスト、本文、レビュー、修正、状態更新まで管理します。長編でも制御を失わないように、コンテキストは protected / compressible に分けて扱います。 **物語の複数ルート予測** — 次章を書く前に、現在の正史から互いに独立した 2-5 本の未来ルートを生成し、章のビート、人物の決断、予想される変化、リスク、作者意図との一致度を Studio Chat で横並びに比較できます。ルートを採用しても保存されるのは `selected-branch-plan.md` だけで、本文、アウトライン、正史状態は変更されません。正史が変わると古い予測は stale として扱われます。 **InkOS Short** — Studio Chat と CLI から独立した短編パッケージを生成できます。完成本文、アウトライン記録、レビュー記録、あらすじ、セールスポイント、表紙プロンプト、表紙画像に対応します。 **InkOS Play** — 自然言語の世界契約から、開放世界や分岐型インタラクティブ物語を開始できます。時間の進み方、キャラクター agent、所持品、証拠、関係性、シーン状態、ビジュアルルール、自由行動、選択肢、画像生成に対応します。 **インタラクティブ影遊** — アイデア、脚本、または小説素材から、分岐シーン、変数、エンディング、画像プロンプト、ノード画像、エクスポート可能なプロジェクトを生成します。 **Studio Chat** — 質問応答だけでなく、長編作成、Short、表紙生成、Play、永続テキスト編集を扱います。重いアクションは確認してから実行し、ツール結果がないのに成功したとは扱いません。 **Agent Skills とリサーチ** — `.agents/skills/`、標準 AgentSkills / OpenClaw ディレクトリ、または Studio のフォルダー導入から標準 `SKILL.md` を追加できます。Chat Agent は意図に応じて利用し、`@skill-id` で強制使用もできます。外部 skill のスクリプトは自動実行しません。外部事実が必要な場合は出典付き Markdown リサーチレポートを生成できます。

InkOS Play アイテム画像例

**英語ネイティブ小説執筆に対応！** — 10種類の英語ジャンルプロファイルを内蔵し、専用のペーシングルール、疲労語リスト、監査ディメンションを搭載。`--lang en` を設定するだけですぐに始められます。 ## クイックスタート ### インストール **Node.js 22.16 以降**が必要です。 ```bash npm i -g @actalk/inkos ``` ### OpenClaw 🦞 経由で使用 InkOS は [OpenClaw](https://clawhub.ai/narcooo/inkos) Skill として公開されており、互換エージェント（Claude Code、OpenClaw など）から呼び出し可能です： ```bash clawhub install inkos # ClawHub からインストール ``` npm でインストール済み、またはリポジトリをクローン済みの場合、`skills/SKILL.md` が含まれているため、ClawHub の別途インストールなしで 🦞 が直接読み取れます。 インストール後、Claw は共有インタラクション入口を優先してください： ```bash inkos interact --json --message "continue the current book, but keep the pacing tighter" ``` この入口はプロジェクト TUI と同じ会話実行カーネルを使います。現在の JSON 出力には assistant の返信と interaction session が含まれます。実際に完了したかどうかは、モデルの文章ではなく、ツール結果と生成ファイルで判断します。`plan` / `compose` / `draft` / `audit` / `revise` / `write next` などのアトミックコマンドも、スクリプトや上級者向けの下位ツールとして残っています。 ### 設定 InkOS は設定経路を分けています。**Studio は可視化されたサービス設定**を使い、**CLI / daemon / デプロイ環境は env オーバーライド**を使えます。両者は暗黙に上書きしません。 **方法1：Studio サービス設定（ローカル執筆に推奨）** ```bash inkos init my-novel cd my-novel inkos ``` 起動ログに表示されたローカル URL から Studio を開いてください。既定のローカルサーバーは同一オリジンのブラウザー要求を受け付けます。独自の埋め込みやリバースプロキシでは、起動オプション `allowedOrigins` で信頼するオリジンを指定できます。 **モデル設定**へ進みます： 1. Google Gemini、Moonshot、MiniMax、DeepSeek、kkaiapi、OpenRouter、またはカスタムエンドポイントを選択。 2. API Key を貼り付けて接続をテスト。 3. 利用可能なモデルを選んで保存。 4. Studio Chat または書籍ページに戻って創作を開始。 Studio はプロジェクトのサービス設定と `.inkos/secrets.json` を使います。env が検出されてもヒントとして表示するだけで、Studio で選んだ service / model / base URL / API Key を上書きしません。 MiniMax は公式 OpenAI-compatible `/v1/chat/completions` エンドポイントを使用します。InkOS は `MiniMax-M3*` の thinking 返却をデフォルトで無効化します。M2.x の thinking は上流サービス側の制限により無効化できません。 **方法2：CLI / daemon / デプロイ環境の env 設定** ```bash inkos config set-global \ --lang en \ --provider \ --base-url \ --api-key \ --model <モデル名> # provider: openai / anthropic / custom（OpenAI互換プロキシにはcustomを使用） # base-url: APIプロバイダーURL # api-key: APIキー # model: モデル名 ``` `--lang en` は CLI / daemon 実行時のデフォルト執筆言語を英語に設定します。`~/.inkos/.env` に保存されます。 グローバル `~/.inkos/.env` またはプロジェクト `.env` を手動で編集することもできます： ```bash # 必須 INKOS_LLM_PROVIDER= # openai / anthropic / custom（OpenAI互換APIにはcustomを使用） INKOS_LLM_BASE_URL= # APIエンドポイント INKOS_LLM_API_KEY= # APIキー INKOS_LLM_MODEL= # モデル名 # 言語（グローバル設定またはジャンルのデフォルトに準拠） # INKOS_DEFAULT_LANGUAGE=en # en または zh # オプション # INKOS_LLM_TEMPERATURE=0.7 # Temperature # INKOS_LLM_THINKING_BUDGET=0 # Anthropic拡張思考バジェット ``` CLI の解決順序は、Studio/project サービス設定、サービス secrets、グローバル env、プロジェクト env、プロセス env、CLI フラグです。つまり CLI は Studio で設定したサービスを再利用でき、env やコマンドライン引数は明示的な上書きとして扱われます。 **方法3：マルチモデルルーティング（オプション）** 異なるエージェントに異なるモデルを割り当て、品質とコストのバランスを調整： ```bash # 異なるエージェントに異なるモデル/プロバイダーを割り当て inkos config set-model writer --provider --base-url --api-key-env inkos config set-model auditor --provider inkos config show-models # 現在のルーティングを表示 ``` 明示的なオーバーライドがないエージェントはグローバルモデルにフォールバックします。 ### 現在のインタラクション入口 **Studio Chat + CLI + TUI は同じ実行面を共有します** - **Studio Chat**：相談、書籍作成、Short、表紙、Play、永続ファイル編集を一つのチャット入口から扱えます。重い操作は確認カードを表示します。 - **創作入口**：長編、短編、二次創作、番外、文体模倣、続き書き、分岐インタラクション、開放世界を Studio の上部入口から開始できます。 - **TUI ダッシュボード**：`inkos tui` でフルスクリーン端末 UI を開き、`/new`、`/short`、`/play`、`/cover`、`/write`、`/confirm`、`/cancel`、セッション単位の `/model ` を利用できます。 - **外部 Agent 入口**：`inkos interact --json --message "..."` は OpenClaw など外部 agent 向けの構造化入口です。 - **明示的なコマンド**：`write next`、`revise`、`review`、import、export は直接実行できます。内部の計画とコンテキスト段階は Harness が管理します。 ### 最初の本を書く 英語ジャンルプロファイルではデフォルトで英語が使用されます。ジャンルを選んで始めましょう： ```bash inkos book create --title "The Last Delver" --genre litrpg # LitRPG小説（デフォルトで英語） inkos write next my-book # 次章を執筆・保存（レビューと改稿は明示的な操作） inkos status # ステータスを確認 inkos review my-book # 保存済み review observation を確認 inkos export my-book --format epub # EPUB形式でエクスポート（スマホ/Kindleで読める） ``` 言語はジャンルごとにデフォルトで設定されます。`--lang en` または `--lang zh` で明示的に上書き可能です。`inkos genre list` で利用可能なすべてのジャンルとデフォルト言語を確認できます。 ### 完成短編を書く Studio のチャットでは、次のように依頼できます： ```text 現代の結婚リバーサルを題材に、主人公が証拠で逆転する12章の短編を書いて。 ``` CLI からも実行できます： ```bash inkos short run \ --direction "modern short fiction marriage reversal evidence-driven heroine" \ --chapters 12 \ --chars 1000 ``` 生成物は `shorts//final/` に保存され、`full.md`、`sales-package.md`、`cover-prompt.md`、表紙生成が設定済みの場合は `cover.png` が含まれます。 ### 表紙だけを作る 既存タイトルやあらすじに対して表紙だけを作る場合は、短編本文を再生成せず、Studio チャットで直接依頼できます： ```text 「彼が後悔した離婚届」の短編表紙を作って。現代都市、強い逆転感。 ``` 表紙ツールは `covers//cover-prompt.md` と `covers/<title>/cover.png` を生成します。表紙サービス未設定の場合は、先に Studio のモデル設定で表紙サービスと API Key を設定してください。 生成後もチャットで表紙プロンプトを調整できます。例：「人物をもっと近く、タイトル文字を大きく、冷たい笑みにして」。InkOS は新しい指示を `coverPrompt` として渡し、`cover-prompt.md` を更新して表紙を再生成します。本文を書き直す必要はありません。 <p align="center"> <img src="assets/inkos-short-demo-cover.png" width="260" alt="InkOS Short 表紙例"> <img src="assets/play-openworld-warcraft.png" width="260" alt="InkOS Play 開放世界例"> <img src="assets/play-openworld-detective.png" width="260" alt="InkOS Play 探偵例"> </p> ### 開放世界 / 分岐型インタラクションを始める Studio Chat で **Open World** または **Branching Interactive** を選び、自然言語で世界を説明します： ```text Warcraft 風の国境見張り塔を舞台にした開放世界を作って。時間は固定ターンではなく、巡回は1時間、訓練は数日かかる。装備には希少感があるが、数値表は使わず、素材・光沢・雰囲気で表現する。 ``` InkOS は世界、キャラクター、アイテム、証拠、関係性、現在シーン、候補アクションを生成します。Open World は自由入力の行動に対応し、Branching Interactive はクリック可能な選択肢を提示します。画像生成を設定すると、キャラクター、アイテム、証拠、シーン画像をチャットの流れの中で表示できます。 --- ## 英語ジャンルプロファイル InkOS には10種類の英語ネイティブジャンルプロファイルが同梱されています。各プロファイルにはジャンル固有のルール、ペーシング、疲労語検出、監査ディメンションが含まれます： | ジャンル | 主要メカニクス | |---------|--------------| | **LitRPG** | 数値システム、パワースケーリング、ステータス成長 | | **プログレッションファンタジー** | パワースケーリング、数値システム不要 | | **異世界転生（Isekai）** | 時代考証、世界観の対比、文化的な異邦人体験 | | **修行もの（Cultivation）** | パワースケーリング、境地の進行 | | **システムアポカリプス** | 数値システム、サバイバルメカニクス | | **ダンジョンコア** | 数値システム、パワースケーリング、領地管理 | | **ロマンタジー** | 感情アーク、二重視点ペーシング | | **SF** | 時代考証、技術の一貫性 | | **タワークライマー** | 数値システム、階層進行 | | **コージーファンタジー** | ローステークスペーシング、コンフォートファーストのトーン | バイリンガルクリエイター向けに、5種類の中国語Web小説ジャンル（玄幻、仙侠、都市、ホラー、その他）にも対応しています。 すべてのジャンルに **疲労語リスト** が含まれています（例：LitRPGの場合 "delve"、"tapestry"、"testament"、"intricate"、"pivotal"）。監査エージェントがこれらを自動的にフラグ付けするため、他のAI生成小説と同じような文体になるのを防ぎます。 --- ## 主な機能 ### Studio Chat + Action Surface Studio Chat は単なる Q&A ではありません。長編作成、Short、表紙生成、Play 起動、永続テキストファイル編集を扱い、重いアクションの前に確認を出します。普通の相談は普通に回答し、明確な創作アクションだけがツール実行になります。 ### InkOS Play：開放世界と分岐インタラクション Play は、キャラクター、場所、アイテム、証拠、関係性、時間、現在シーン、HUD、画像を含む持続的な世界状態を管理します。固定 RPG システムではありません。修仙世界なら希少度や境界、恋愛ものなら感情段階、探偵ものなら証拠のライフサイクルを、ユーザーの世界契約として状態に保存できます。 ### 定性的レビューと明示的な改稿 レビュー Agent は、ユーザー意図、正典、現在状態、章計画、選択された Skill と原稿を比較し、証拠と修正方向を含む具体的な観察を返します。原稿を採点・却下・自動改稿せず、改稿は追跡可能な新しい成果物リビジョンを作る明示的な操作です。 脱AI化の専門手法は交換可能な `inkos-story-deslop` Skill にあり、必要なときだけ `revise --mode anti-detect` で明示的に使用します。 ### 文体クローニング `inkos style analyze` は分析・模倣 Skill を使い、参考テキストを証拠付きの実行可能な文体ガイドへコンパイルします。`inkos style import` でガイドを作品に紐づけます。 ### クリエイティブブリーフ `inkos book create --brief my-ideas.md` はブレインストーミング、世界観、キャラクター資料を渡します。Architect は `outline/story_frame.md`、`outline/volume_map.md`、役割カード、`book_rules.md/json` を作成し、長期方向を `story/author_intent.md` に保存します。 ### 入力ガバナンスコントロールサーフェス すべての書籍に2つの長期保存型Markdownコントロールドキュメントが付属： - `story/author_intent.md`：この書籍が長期的にどうあるべきか - `story/current_focus.md`：次の1〜3章で注意を引き戻すべき事柄 方向は Studio Chat、TUI、`inkos agent` から調整します。Planner がタスク関連の意味的ワーキングセットを選び `intent.md` を作成し、Composer が実際の source、保護 tier、検索、圧縮を `context.json` と `trace.json` に記録します。 ### 文字数管理 `write next` と `revise` は同じ決定論的な文字数テレメトリを共有： - `--words` は正確なハード制限ではなく、目標バンドを設定 - 中国語の章はデフォルトで `zh_chars`、英語の章はデフォルトで `en_words` を使用 - 章がソフトバンドから逸脱した場合、InkOS はプロを乱暴にカットするのではなく、1回の補正正規化パス（圧縮または拡張）を実行する場合があります - 1回のパス後もハードレンジを外れる場合、InkOS は保存しますが、結果とチャプターインデックスに可視的な文字数警告とテレメトリを表示 ### 続編執筆 `inkos import chapters` で既存の小説テキストをインポートし、構造化状態、章サマリー、フック、キャラクター関係、人間が読める Markdown プロジェクションを自動で再構築。`Chapter N` とカスタム分割パターンに対応し、再開可能なインポートをサポート。インポート後、`inkos write next` で物語を継続できます。 ### 二次創作 `inkos fanfic init --from source.txt --mode canon` で原作素材から二次創作書籍を作成。4つのモード：canon（忠実な続編）、au（パラレルワールド）、ooc（キャラクター崩壊）、cp（カップリング重視）。原作インポーター、二次創作専用の監査ディメンション、設定の一貫性を保つ情報境界管理を搭載。 ### マルチモデルルーティング 異なるエージェントに異なるモデルとプロバイダーを使用可能。WriterにClaude（より強力なクリエイティブ）、AuditorにGPT-4o（安価で高速）、Radarにローカルモデル（コストゼロ）。`inkos config set-model` でエージェントごとに設定可能；未設定のエージェントはグローバルモデルにフォールバック。 ### デーモンモード + 通知 `inkos up` で自律的なバックグラウンドループを開始し、スケジュールに従って章を執筆。処理可能な非重要問題は自動で進め、人間の判断が必要な場合はレビュー可能な結果を残して一時停止します。TelegramとWebhook（HMAC-SHA256署名 + イベントフィルタリング）による通知。`inkos.log`（JSON Lines）にログ出力、`-q` でクワイエットモード。 ### ローカルモデル互換性 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、カスタム互換エンドポイントに対応します。構造化出力欠落、ストリーム中断、出力上限は明示的に扱い、部分テキストを成功として保存しません。 ### 信頼性 章ごとにステートスナップショットを作成し、本文・索引・構造化状態を一つのアトミックファイルセットとして保存します。ファイルロックと Action キューが同時書き込みを防ぎ、レビューは observation を記録し、改稿は明示的な Action として実行されます。 フックシステムはZodスキーマバリデーションを使用 — `lastAdvancedChapter` は整数、`status` は open/progressing/deferred/resolved のみ。LLMからのJSONデルタは `applyRuntimeStateDelta`（イミュータブル更新）と `validateRuntimeState`（構造チェック）を経て永続化。破損データは伝播されず、拒否されます。 モデル出力上限は provider bank のモデルカードで管理されます。`llm.extra` の予約キー（max_tokens、temperature、model、messages、stream など）は自動的に除去され、コアリクエストパラメータの意図しない上書きを防止します。 --- ## 仕組み InkOS は pi-agent harness を共通の推論・ツール呼び出しカーネルとして使用します。Agent がユーザー意図を解釈して型付き action を生成し、host が決定論的ツールの実行、確認と権限、状態管理、実ファイルと tool result による完了判定を担当します。長編、短編、脚本、絵コンテ、インタラクティブ影遊、Play、翻訳はこの構造を共有しつつ、専用 Skill、状態モデル、制作工程を保持します。 <p align="center"> <img src="assets/arch-system.svg" width="900" alt="システム構成"> </p> 長編の各章は複数のエージェントが順次処理します： <p align="center"> <img src="assets/arch-pipeline.svg" width="900" alt="章生産パイプライン"> </p> | エージェント | 担当 | |-------------|------| | **Radar** | プラットフォームのトレンドと読者の好みをスキャンして物語の方向性に反映（プラグイン可能、スキップ可能） | | **Planner** | 著者の意図 + 現在のフォーカス + メモリ取得結果を読み取り、章の意図（必須保持 / 必須回避）を生成 | | **Composer** | 構造化状態、制御ドキュメント、Markdownプロジェクションからタスクに関連するコンテキストを選択し、ルールスタックとランタイムアーティファクトをコンパイル | | **Architect** | 書籍作成・インポート・スピンオフ初期化時に基盤ファイルを生成：物語フレーム、ルール、キャラクター、長期制御ファイル | | **Writer** | コンパイル済みコンテキストから散文を生成（文字数管理、対話駆動） | | **Observer** | 章テキストから9カテゴリのファクトを過剰抽出（キャラクター、ロケーション、リソース、関係性、感情、情報、フック、時間、身体状態） | | **Reflector** | JSONデルタを出力（フルMarkdownではない）；コードレイヤーがZodスキーマバリデーション後にイミュータブル書き込みを実行 | | **Continuity Auditor** | 構造化状態、制御ドキュメント、章コンテキストに対して下書きを検証 | | **Reviser** | ユーザー、Agent、または保存済み observation からの明示的な修正要求を適用し、新しい版をアトミックに記録 | 章本文と派生ストーリー状態はハード検証後にアトミックに保存されます。継続性と文章上の指摘は observation として保存され、修正は追跡可能な独立アクションとして実行されます。 ### 長期記憶 正規メモリと検索プロジェクションは分離されています： | 層 | 目的 | |----|------| | `story/state/*.json` | 正規の構造化状態：現在状態、フック、章サマリーなど。Zodスキーマで検証 | | `story/*.md` | 人間が読めるプロジェクション：`current_state.md`、`pending_hooks.md`、`chapter_summaries.md`、`character_matrix.md` など | | `story/memory.db` | 再構築可能な SQLite FTS5/BM25 検索プロジェクション。正規ストーリー事実ではない | 継続性監査エージェントが下書きをこれらの状態に対してチェックします。キャラクターが目撃していないことを「覚えて」いたり、2章前に失った武器を取り出したりすると、監査エージェントがそれを検出します。 Settler は typed tool で完全な増分 delta を提出し、Host がイミュータブルに適用・検証します。検索インデックスは正規 JSON から再構築され、BM25 候補に LLM の意味選択を適用します。 <p align="center"> <img src="assets/arch-memory.svg" width="900" alt="長期記憶と状態"> </p> ### コントロールサーフェスとランタイムアーティファクト ランタイム状態に加え、InkOS はガードレールをカスタマイズからレビュー可能なコントロールドキュメントに分離します： - `story/author_intent.md`：長期的な著者の意図 - `story/current_focus.md`：短期的なステアリング - `story/runtime/chapter-XXXX.intent.md`：章の目標、保持/回避リスト、対立の解決 - `story/runtime/chapter-XXXX.context.json`：この章のために選択された実際のコンテキスト - `story/runtime/chapter-XXXX.trace.json`：この章のコンパイルトレース つまり、ブリーフ、アウトラインノード、ブックルール、現在のリクエストが1つのプロンプトブロブに混ぜ合わされることはなくなりました。InkOS はまずコンパイルし、それから執筆します。 ### 執筆ルールシステム 専門創作方法は Work Profile の Skill にあり、同じ ID のプロジェクト `SKILL.md` で置き換えられます。Agent コードは動的タスク、権威コンテキスト、typed tool protocol だけを保持します。 ## 使用モード InkOS は4つのインタラクションモードを提供し、すべて同じアトミック操作を共有します： ### 1. フルパイプライン（ワンコマンド） ```bash inkos write next my-book # Draft → audit → 自動修正、すべて一括 inkos write next my-book --count 5 # 5章連続で執筆 ``` `write next` は唯一の `plan -> compose -> write -> review -> commit` 創作チェーンを使用します。レビューは observation を生成し、技術検証がアトミック保存を制御します。意味的な指摘が章の失敗状態へ変換されることはありません。 ### 2. 明示的な能力コマンド ```bash inkos write next my-book --count 3 inkos revise my-book 31 --json inkos review my-book --json inkos export my-book --format epub ``` これらは既に確定したユーザー操作です。自然言語の意図は pi-agent Harness に入り、現在の Work Profile capability surface で解決されます。 ### 3. 自然言語エージェントモード ```bash inkos agent "ダンジョン世界のヒーラークラスのMCを持つLitRPG小説を書いて" inkos agent "次の章を書いて、ボス戦と戦利品の分配にフォーカス" inkos agent "1つの呪文しか使えない魔法使いのプログレッションファンタジーを作成して" ``` Agent モードは現在の session 種別に応じてツールを絞ります。書籍作成、コントロールサーフェス編集、計画、コンテキスト編成、執筆、監査、修正、Short、表紙、Play は、必要な場面でだけ利用可能になります。推奨フローは、まずコントロールサーフェスを調整し、次に `plan` / `compose`、最後にドラフトのみかフルパイプライン執筆を選ぶ形です。 ### 4. Studio Play モード Studio の **Open World** と **Branching Interactive** は、先に書籍を作らなくても開始できるインタラクティブ創作入口です。世界の動き方、時間の進み方、キャラクターが agent として動くか、アイテムや証拠がどう効くかを説明すると、InkOS は継続可能なローカル世界状態として保存します。 ## Studio スクリーンショットと実行結果 <p align="center"> <img src="assets/studio-dashboard.png" width="760" alt="InkOS Studio 創作入口スクリーンショット"> </p> <p align="center"> <img src="assets/inkos-short-demo-cover.png" width="230" alt="短編表紙の出力例"> <img src="assets/play-openworld-romance.png" width="230" alt="恋愛インタラクティブ世界の出力例"> <img src="assets/play-openworld-detective.png" width="230" alt="探偵インタラクティブ世界の出力例"> <img src="assets/play-item-warcraft.png" width="230" alt="インタラクティブ世界のアイテム画像出力例"> </p> 最初の画像はローカル Studio のスクリーンショットです。ほかの画像は InkOS Short と InkOS Play のローカル実行で生成された実例で、短編表紙、開放世界シーン、探偵証拠ビジュアル、アイテム画像を示します。 ## CLIリファレンス | コマンド | 説明 | |---------|------| | `inkos init [name]` | プロジェクトを初期化（nameを省略するとカレントディレクトリを初期化） | | `inkos book create` | 新しい書籍を作成（`--genre`、`--chapter-words`、`--target-chapters`、`--brief <file>`、`--lang en/zh`） | | `inkos book update [id]` | 書籍設定を更新（`--chapter-words`、`--target-chapters`、`--status`、`--lang`） | | `inkos book list` | すべての書籍を一覧表示 | | `inkos book delete <id>` | 書籍とそのすべてのデータを削除（`--force` で確認をスキップ） | | `inkos genre list/show/copy/create` | ジャンルの表示、コピー、作成 | | `inkos write next [id]` | フルパイプライン：次の章を執筆（`--words` でオーバーライド、`--count` でバッチ、`-q` クワイエットモード） | | `inkos write rewrite [id] <n>` | 第N章をリライト（ステートスナップショットを復元、`--force` で確認をスキップ） | | `inkos revise [id] [n]` | 特定の章を修正 | | `inkos agent <instruction>` | 自然言語エージェントモード | | `inkos review [id]` | 保存済み review observation を表示 | | `inkos status [id]` | プロジェクトのステータス | | `inkos export [id]` | 書籍をエクスポート（`--format txt/md/epub`、`--output <path>`） | | `inkos radar scan` | 新規書籍の方向性に使う市場 / トレンド入力をスキャン | | `inkos fanfic init` | 原作素材から二次創作書籍を作成（`--from`、`--mode canon/au/ooc/cp`） | | `inkos short run` | 独立短編パッケージを生成 | | `inkos forecast create/show/select` | 長編の非正史ルートを生成・再検証・選択。選択時は候補計画だけを保存し、正史は変更しない | | `inkos interact` | 外部 agent / CLI 自然言語入口（`--json`、`--message`、`--book`） | | `inkos config set-global` | グローバルLLM設定を設定（~/.inkos/.env） | | `inkos config set-model <agent> <model>` | エージェントごとのモデルオーバーライド（`--base-url`、`--provider`、`--api-key-env`） | | `inkos config show-models` | 現在のモデルルーティングを表示 | | `inkos doctor` | セットアップの問題を診断（API接続テスト + プロバイダー互換性ヒント） | | `inkos detect [id] [n]` | AIGC検出（`--all` で全章、`--stats` で統計） | | `inkos style analyze <file>` | 参考テキストを分析してスタイルフィンガープリントを抽出 | | `inkos style import <file> [id]` | スタイルフィンガープリントを書籍にインポート | | `inkos import canon [id] --from <parent>` | 番外 / スピンオフ用に親作品の正典を導入 | | `inkos import chapters [id] --from <path>` | 続編執筆用に既存の章をインポート（`--split`、`--resume-from`） | | `inkos analytics [id]` / `inkos stats [id]` | 書籍分析（observation、章の長さ、トークン使用量） | | `inkos update` | 最新バージョンへ更新 | | `inkos` / `inkos studio` | Webワークベンチを起動（`-p` でポート指定、デフォルト4567） | | `inkos tui` | 端末フルスクリーン TUI を起動 | | `inkos up / down` | デーモンの開始/停止（`-q` クワイエットモード、`inkos.log` に自動出力） | `[id]` はプロジェクトに書籍が1つしかない場合に自動検出されます。すべてのコマンドが `--json` による構造化出力に対応。`draft` / `write next` / `plan chapter` / `compose chapter` は `--context` でステアリング可能、`--words` で目標章サイズをオーバーライド。`book create` は `--brief <file>` でクリエイティブブリーフを渡せます — アーキテクトがゼロから生成するのではなく、あなたのアイデアを基に構築します。`plan chapter` は LLM を呼び出して章の意図を作成します。`compose chapter` はライブLLMを必要としないため、APIセットアップ完了前でも管理された入力を確認できます。 ## ロードマップ - [x] ~~`packages/studio` Webワークベンチ（Vite + React + Hono）~~ — リリース済み、`inkos` または `inkos studio` で起動 - [x] ~~インタラクティブフィクション / 開放世界（分岐選択 + 自由行動 + 画像生成）~~ — Studio Play としてリリース済み - [ ] 部分的な章介入（章の半分をリライト + 真実ファイルの連鎖更新） - [ ] カスタムエージェントプラグインシステム ## コントリビューション コントリビューション歓迎。IssueまたはPRを作成してください。 ```bash pnpm install pnpm dev # すべてのパッケージのウォッチモード pnpm test # テストを実行 pnpm typecheck # 出力なしで型チェック ``` ## Star History <a href="https://www.star-history.com/#Narcooo/inkos&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Narcooo/inkos&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Narcooo/inkos&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Narcooo/inkos&type=date&legend=top-left" /> </picture> </a> ## Skills Download History <div align="center"> <a href="https://skill-history.com/narcooo/inkos"> <img alt="Skills Download History" src="https://skill-history.com/chart/narcooo/inkos.svg" /> </a> </div> ## Repobeats ![Alt](https://repobeats.axiom.co/api/embed/024114415c1505a8c27fb121e3b392524e48f583.svg "Repobeats analytics image") ## 謝辞 InkOS のエージェントランタイムは Mario Zechner 氏の [pi](https://github.com/badlogic/pi-mono)（`@mariozechner/pi-ai` と `@mariozechner/pi-agent-core`）の上に構築されています。堅実な土台を提供してくれた pi に感謝します。 ## ライセンス [AGPL-3.0](LICENSE)