image-posting — チャット応答への画像表示

概要

チャット応答に画像を含める仕組みは2系統ある:

1. ツール結果からの自動抽出 — ツール結果に画像URLやパスが含まれると、フレームワークが自動検出してチャットバブルに表示する
2. Markdown画像構文 — 応答テキスト内に ![alt](url) を書くとフロントエンドがレンダリングする

方法1: ツール結果からの自動表示

ツール（web_search、image_gen等）を呼び出した結果に画像情報が含まれていれば、フレームワークが自動でチャットバブルに画像を表示する。Anima側で特別な操作は不要。

自動検出される条件

ツール結果のJSON内で以下が検出されると画像として扱われる:

• パス検出: path, file, filepath, asset_path キーの値、または結果文字列内に assets/ / attachments/ で始まるパス（.png .jpg .jpeg .gif .webp）→ source: generated（信頼済み）
• URL検出: url, image_url, thumbnail, src キーに画像URLがある場合 → source: searched（プロキシ経由、許可ドメインのみ）
• image_gen専用: ツール結果全体を正規表現で走査し、assets/ または attachments/ を含むパスを自動抽出

1応答あたり最大5枚まで。

image_gen ツールの実装とパイプライン

• エントリ: core/tools/image_gen.py の dispatch() が generate_character_assets ほか各ツール名を処理する。GLB 周りのテスト用可変属性（_FBX2GLTF_PATH 等）は _image_glb へプロキシされるファサードでもある。
• 一括生成の本体: core/tools/_image_pipeline.py の ImageGenPipeline.generate_all() が7ステップをオーケストする。
• APIクライアント・定数・プロンプト: core/tools/image/（例: novelai.py, fal.py, meshy.py, constants.py の NOVELAI_MODEL / _DEFAULT_ANIMATIONS, prompts.py の表情用プロンプト）。

7ステップの内容（アニメ系で steps 未指定のフルパイプライン時）:

1. fullbody — アニメ（image_style が realistic 以外）: NOVELAI_TOKEN があれば NovelAI（NOVELAI_MODEL = nai-diffusion-4-5-full）。無ければ FAL_KEY があれば Fal Flux Pro。どちらも無ければエラー。リアリスティック: 常に Fal Flux Pro のみ（FAL_KEY 必須。NovelAI にはフォールバックしない）。config.image_gen の style_prefix / style_suffix / negative_prompt_extra、style_reference（画像バイト）および Vibe Transfer 用の vibe_strength / vibe_info_extracted がここで反映される。
2. bustup — Flux Kontext（fal）でバストアップ。表情名は core.schemas.VALID_EMOTIONS（neutral, smile, laugh, troubled, surprised, thinking, embarrassed）のみ有効。デフォルトでは上記すべてを生成。neutral は全身参照から、その他は可能なら中立バストを参照（無ければ全身にフォールバック）。リアル/アニメで別プロンプト・ガイダンス（prompts.py）。
3. icon — 中立バストを参照に Flux Kontext で正方形アイコン。成功時、persist_anima_icon_path_template() でアイコンパステンプレを更新しようとする（失敗しても処理は継続）。
4. chibi — 全身を参照に Flux Kontext でちびキャラ画像。
5. 3d — Meshy Image-to-3D（デフォルト ai_model: meshy-6）で chibi から avatar_chibi.glb。
6. rigging — パイプライン内では 直前の Image-to-3D の task_id から create_rigging_task でリギング（input_task_id 経由）。リグ済み GLB 保存後 optimize_glb、付属の歩行などは download_rigging_animations で anim_*.glb 化（可能なら strip_mesh_from_glb）。単体ツール generate_rigged_model / generate_animations の dispatch 側は、既存 GLB を data URI にして MESHY_RIGGING_URL へ POST する経路（パイプライン6と入力経路が異なる点に注意）。
7. animations — animations 引数が渡されなければ _DEFAULT_ANIMATIONS（idle, sitting, waving, talking と Meshy アクション ID）。同一実行でリギングしていない場合、既存の avatar_chibi.glb から create_rigging_task_from_glb で rig_task_id を取り直してから追加アニメを生成する。

リアリスティックスタイル（config.image_gen.image_style == "realistic"）では、steps 未指定時のデフォルト有効ステップは fullbody / bustup / icon のみ（chibi・3D・リギング・追加アニメは既定では走らない）。dispatch の generate_character_assets では、プロンプトが Danbooru 風タグに見える場合 _looks_like_anime_prompt により _convert_anime_to_realistic でリアル向けに自動変換されることがある。

スタイル参照（Vibe Transfer）: ImageGenPipeline は config.style_reference のパス（存在時）を全身生成に渡す。加えて generate_character_assets で supervisor_name が指定され、上司の assets/ に avatar_fullbody.png または avatar_fullbody_realistic.png（スタイルに応じて）があれば、それを style_reference として上書き読み込みする。generate_all() には vibe_image / vibe_strength / vibe_info_extracted / seed / expressions / steps / progress_callback などもあるが、現在の dispatch がツール引数から渡すのは prompt, negative_prompt, skip_existing, steps, animations, supervisor_name（およびハンドラ注入の anima_dir）に限られる。

generate_fullbody（単体）: dispatch 実装は 常に NovelAIClient のみ（環境に Fal があってもフォールバックしない）。image_style も参照しない。出力は常に avatar_fullbody.png。リアリスティック用の全身やパイプライン整合が必要なら generate_character_assets を使う。

generate_character_assets の戻り値（JSON）

PipelineResult.to_dict() 相当のキー（パスは文字列、無ければ null）:

PNG のパスはチャット自動表示の対象。GLB はアセット保存・ワークスペース等で別扱い。

出力ファイル名の対応表

パイプライン（アニメ image_style）

パイプライン（リアリスティック） — 全身・バスト・表情・アイコンはファイル名末尾に _realistic が付く:

• 全身: avatar_fullbody_realistic.png
• 中立バスト: avatar_bustup_realistic.png
• 表情: avatar_bustup_smile_realistic.png など（bustup_expressions に集約）
• アイコン: icon_realistic.png

単体ディスパッチ（dispatch 内の個別ツール）

デフォルトの追加アニメーション名と Meshy アクション ID（パイプライン animations ステップ）: idle: 0, sitting: 32, waving: 28, talking: 307（animations 引数で上書き可）。

searched画像のプロキシ制限

外部URL画像はセキュリティのためプロキシ経由で配信される。アーティファクト抽出時点で以下の許可ドメインのみが検出対象となる:

• cdn.search.brave.com
• images.unsplash.com
• images.pexels.com
• upload.wikimedia.org

上記以外のドメインのURLはツール結果に含まれていても自動表示されない。プロキシ自体はHTTPS強制・private/local拒否・magic bytes検証・SVG拒否・サイズ・レート制限などの安全検査を実施する（config.server.media_proxy で open_with_scan / allowlist モードを切り替え可能）。

方法2: Markdown画像構文

応答テキスト内にMarkdown画像構文を直接書いて画像を表示する。

短縮パス（推奨）

フロントエンドが自動的に自分のAnima名でAPIパスを補完する。ファイル名だけ書けばOK:

![説明](attachments/ファイル名)
![説明](assets/ファイル名)

例:

スクショ撮りました！
![ANAトップページ](attachments/ana_top.png)

フルパス

明示的にAPIパスを書くこともできる:

![説明](/api/animas/{自分の名前}/assets/{ファイル名})
![説明](/api/animas/{自分の名前}/attachments/{ファイル名})

スクリーンショットの保存先

agent-browser等でスクリーンショットを撮る場合、自分のattachmentsディレクトリに直接保存するのが確実:

agent-browser screenshot ~/.animaworks/animas/{自分の名前}/attachments/screenshot.png

例（aoiの場合）:

agent-browser screenshot ~/.animaworks/animas/aoi/attachments/page_screenshot.png

保存後、応答に以下を書けば表示される:

![ページのスクショ](attachments/page_screenshot.png)

~/.animaworks/tmp/attachments/ に保存した場合もフォールバックで表示されるが、一時ディレクトリなので永続性は保証されない。

注意事項

• 他のAnimaのアセットパスは直接参照できない（権限外）
• 外部URLの直リンクは非推奨。許可ドメイン外は自動表示されず、プロキシの安全検査でブロックされる場合がある
• generate_character_assets の結果は fullbody / bustup / bustup_expressions / icon / chibi などのパスがJSONに含まれるため、PNGは自動表示され、Markdown構文は不要なことが多い
• 単体の generate_bustup / generate_chibi は参照が avatar_fullbody.png 固定（リアリスティック用の avatar_fullbody_realistic.png は読まない）。単体 generate_fullbody は上表のとおり NovelAI 専用で、パイプラインのリアリスティック全身とファイル名・生成経路が揃わない。パイプラインと単体ツールを混用する場合は assets/ の実ファイルを確認すること
• 画像生成は処理時間が長い。フレームワークでは専用スレッドプール実行・バックグラウンドツール設定の対象になる。CLI からは animaworks-tool submit image_gen … 等の非同期実行が推奨される場合がある（common_knowledge/operations/background-tasks.md 等を参照）
• 1応答あたりの自動表示は最大5枚