GPU機 fox に ComfyUI Portable を NSSM 常駐で導入
カテゴリ: dev
正規ID: modernization-20260904/p0-box
登録済みの前提工程はありません。図だけではdispatch可否を判定しません。
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画正本 docs/plan_modernization-20260904.md Phase 0。Windows ネイティブ。C:\Users\kite_\ComfyUI に Portable(Python 3.13 + CUDA 13.0)を置き、NSSM サービス ComfyUI(--listen 0.0.0.0 --port 8188、LocalSystem)、ファイアウォール 8188、メインサーバー(ssh main-server)の鍵を fox の authorized_keys へ。custom node は ComfyUI-RMBG だけ。Windows のシェルでコードを書かない(導入コマンドを叩くだけ)。第三者コード導入が harness に止められたら親(bell)へ DM して手順を渡す。受入: メインサーバーから curl http://192.168.1.11:8188/system_stats が返り、/object_info に RMBG node が見える。
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p0-box- anchor
- anchor_missing
候補モデル一式を fox の ComfyUI に配置
カテゴリ: dev
正規ID: modernization-20260904/p0-models
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 0 のモデル表。Anima Base v1.0 / Turbo v1.1 + qwen_3_06b_base + qwen_image_vae、Anima-Control-Pose preview-2、Mage-Flow と Mage-Flow-Edit(bf16 と int8_convrot)+ qwen3vl_4b_bf16 + mage_flow_vae_bf16、JoyAI-Image-Edit-Plus(int8)+ qwen3vl_8b_joyimage_edit + wan_2.1_vae、Krea 2、ToonOut(RMBG フォルダ)、SAM 3.1。配置先は各 ComfyUI/models/<種別>。ダウンロード元は HF 本家か Comfy-Org 再パック。受入: /object_info の各 loader で候補が選べる。docs/models.md を新モデル表に書き換える。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p0-models- anchor
- anchor_missing
fox に sd-scripts(Anima 対応)と Python 入口 train.py を置く
カテゴリ: dev
正規ID: modernization-20260904/p0-trainer
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
Windows ネイティブ venv(torch cu130、bf16)に kohya sd-scripts 本線(anima_train_network.py を含む版)。C:\sf\train.py は toml と出力名を受けて accelerate launch を起動し進捗を stdout に出す Python 一枚。PowerShell を書かない。学習前の GPU 解放は ComfyUI の /free(HTTP)。受入: ssh fox python C:\sf\train.py --help が通り、教材数枚のドライラン(数 step)が完走して safetensors が出る。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p0-trainer- anchor
- anchor_missing
素体生成の新顔比較(Anima / Mage-Flow / Krea 2)
カテゴリ: dev
正規ID: modernization-20260904/p1-base
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表の素体行。同じ JRPG スプライト指示で 3 モデル各 4 枚。判定: JRPG 画風の追従、輪郭の抜きやすさ、1枚の秒数、LoRA 学習器の有無(Anima=sd-scripts、Krea 2=musubi、Mage-Flow=要確認)。旧世代(Illustrious・Qwen)は比べない。結果を docs/09_modernization_bench.md へ画像パス付きで記し、勝者を1つ決める。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-base- anchor
- anchor_missing
ダメージ版の疎通(SAM 3.1 マスク + 編集モデル + マスク外復元)
カテゴリ: dev
正規ID: modernization-20260904/p1-damage
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表のダメージ版行。SAM 3.1 で衣装マスク → 編集の勝者で破損版 → マスク外をベースの画素で復元 → bbox 中心差を数値で記録(ゲートにしない)。docs/09 へ。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-damage- anchor
- anchor_missing
編集・設定画の新顔比較(Mage-Flow-Edit / JoyAI-Image-Edit-Plus)
カテゴリ: dev
正規ID: modernization-20260904/p1-edit
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表の編集行。既存の bible_firemage の素体を参照に、8 方向+表情 3 種+衣装 1 種を両モデルで生成。判定: 同一人物に見えるか、後ろ姿が正しいか、1枚の秒数と VRAM。docs/09 へ記し勝者を決める。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-edit- anchor
- anchor_missing
キャラ LoRA を1本学習し、素体モデル + LoRA で任意ポーズを出す
カテゴリ: dev
正規ID: modernization-20260904/p1-lora
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表の LoRA 行。編集比較の勝者が出したパネルを教材に、p0-trainer の入口で LoRA を 1 本学習(step 数・解像度の当たりを取る)。判定: 学習後の同一性、学習時間。素体の勝者が Anima 以外なら学習器を差し替えてから。docs/09 へ。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-lora- anchor
- anchor_missing
透過の新顔比較(ToonOut / SAM 3.1)
カテゴリ: dev
正規ID: modernization-20260904/p1-matte
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表の透過行。素体比較の出力 3 枚に対し ToonOut(ComfyUI-RMBG)と SAM 3.1(文字プロンプト『character』)で alpha を出す。判定: 毛先・指・半透明の残り、四隅 alpha=0、縁のにじみ。docs/09 へ記し勝者を決める。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-matte- anchor
- anchor_missing
ポーズ指定の新顔比較(Anima-Control-Pose / 編集モデルへの骨格参照)
カテゴリ: dev
正規ID: modernization-20260904/p1-pose
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 1 表のポーズ行。素体の勝者に対し、Anima-Control-Pose preview-2(素体が Anima の時)と、編集の勝者へ骨格画像を参照として渡す方式を比べる。判定: ポーズ追従と同一性。docs/09 へ。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p1-pose- anchor
- anchor_missing
backend を新スタックに再構築(撤去・欠陥修正・comfy/box/events/workflows/services)
カテゴリ: dev
正規ID: modernization-20260904/p2-core
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『撤去』『欠陥修正』『構造』。撤去: rpgdev 一式と adopt、採用ゲート・force・chroma・black_leak・halo・_auto_bg・SAFE_CHROMA・STYLE_PHRASE、app.py の try/except 変換、comfy_client の WS/SSE/再接続/40回ポーリング、training.py の PowerShell 生成と SF_DONE と TRAIN_TIMEOUT、Qwen/SDXL/LayerDiffuse workflow、rembg、.venv-sam2、sam2_bridge.py、chroma-key。計測(四隅 alpha・bbox 差・canvas 一致)は数値で返すだけ。修正: uuid4 ジョブID と .cache/jobs/.json、Pillow 処理の to_thread、her 固定の代名詞化、STYLE_LORA 実行時書き換え廃止、list_loras を /object_info、MCP/REST の二重定義を services に一本化。新規: backend/comfy.py(HTTP だけ)、backend/box.py(ssh fox python train.py と scp だけ)、backend/events.py(events.ndjson、各行 event_id/job_id/seq/schema_version/at/kind/payload)、backend/workflows.py(Phase 1 の勝者 4 builder)。Python 3.13、pyproject.toml + uv.lock。受入: pytest(GPU なし)green、MCP list_tools に残すツールが出る。
安全上表示できない要素を除外しました。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p2-core- anchor
- anchor_missing
docs・AGENTS.md・rag を新スタックに書き換える
カテゴリ: dev
正規ID: modernization-20260904/p2-docs
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『文書』。docs/03,04,05 を新スタックに、docs/09 は比較結果、CLAUDE.md は @AGENTS.md 一行、AGENTS.md を本体に(古い機械置換版は破棄済み)、HANDOFF.md 破棄。AGENTS.md に『軸はメインサーバー』『最新一択・新顔同士だけ比較』『GPU 機再インストール』を記す。今回の調査(FastMCP 4、Anima、Mage-Flow、JoyAI、ToonOut、SAM 3.1、WSL2 Blackwell 問題)を rag/ へ還流し INDEX を更新。受入: docs と実装の記述が一致し、drift が無い。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p2-docs- anchor
- anchor_missing
FastMCP 4.0 化と REST の薄層化、compose 配置ファイル
カテゴリ: dev
正規ID: modernization-20260904/p2-mcp
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『構造』。FastMCP 4.0.x(combine_lifespans、fastmcp.apps)、長時間ジョブは start/status 形を維持(Claude Code の task mode 未対応 #18617)。REST は services を呼ぶだけの薄層で MCP と引数・既定値を同じ関数から取る。compose.yaml(1 サービス、port 8765、.cache volume、ssh 鍵と .env は volume)。受入: ローカルで uvicorn 起動し MCP と REST が同じ services を通る focused test。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p2-mcp- anchor
- anchor_missing
pytest と CI を新スタックに合わせる
カテゴリ: dev
正規ID: modernization-20260904/p2-tests
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『試験』。tests/(GPU なしで回る): audit の純関数、workflow builder の JSON 形、box.py のコマンド文字列、events の追記と読み出し。CI は compileall を pytest に置換。受入: ローカルと CI で green。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p2-tests- anchor
- anchor_missing
WebUI を作り直す(作業台・設定画・LoRA・過程・記録の 5 画面)
カテゴリ: dev
正規ID: modernization-20260904/p2-web
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『WebUI 作り直し』。vanilla ESM・ビルドなし。api.js/state.js/ui.js の骨は流用。①作業台(素体・編集・ダメージ版、候補カードに計測値)②設定画(多方向+表情/衣装、ジョブ進捗)③LoRA(教材確認・学習開始・進捗・一覧)④過程(events.ndjson を SSE で流す)⑤記録(過去の生成・設定画・LoRA を辿る)。SSE は自分の events.ndjson だけ。受入: Playwright でコンソールエラー 0 と主要導線 1 周。
前提工程
後続工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p2-web- anchor
- anchor_missing
メインサーバーへ配置し Bot から 1 周実走
カテゴリ: dev
正規ID: modernization-20260904/p3-deploy
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 3。メインサーバーで git clone と docker compose up、Bot 側の .mcp.json を http://192.168.1.2:8765/mcp/ へ、Claude Code から generate_sprite → generate_character_bible → train_character_lora → generate_sprite(lora) を 1 周。受入: events.ndjson に全工程が記録され、WebUI の記録画面で辿れる。push は親(bell)がオーナーへ一言入れてから行う。
前提工程
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904/p3-deploy- anchor
- anchor_missing
ComfyUI workflow builder 4 本(Anima txt2img / JoyAI edit / ToonOut / SAM 3.1)
カテゴリ: defect
正規ID: modernization-20260904-b/b1-workflows
登録済みの前提工程はありません。図だけではdispatch可否を判定しません。
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画正本 docs/plan_modernization-20260904.md Phase 2『構造』の backend/workflows.py。①Anima txt2img(Base/Turbo 選択、LoRA 任意、Anima-Control-Pose の骨格画像任意)②JoyAI-Image-Edit-Plus(参照画像 1〜6 枚+指示文)③ToonOut(ComfyUI-RMBG、RGB→RGBA)④SAM 3.1(文字プロンプトまたは点で mask 出力)。各 builder は {node_id:{class_type,inputs}} を返し、node 名と入力名は fox の /object_info と一致させる。受入: tests/test_workflows.py で 4 本の JSON 形を固定し、fox の ComfyUI へ 4 本を実際に投げて出力画像/mask が得られた証跡(.cache/generated 配下のパスと /history の抜粋)を evidence に残す。旧世代(Qwen/SDXL)の builder は置かない。
依存: なし
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b1-workflows- anchor
- anchor_missing
generate_sprite: Anima(+LoRA +Control-Pose)→ ToonOut で RGBA 候補を返す
カテゴリ: defect
正規ID: modernization-20260904-b/b2-sprite
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
MCP ツール generate_sprite(prompt, count, seed, lora_name?, lora_trigger?, pose_image?, turbo=true) と同じ services 関数を REST /api/generate から呼ぶ。b1 の builder ①→③ を連結し、候補ごとに RGBA PNG を .cache/generated に保存、計測(四隅 alpha・bbox・canvas)を数値で付けて返す(ゲートにしない)。list_loras は /object_info の LoraLoader から。受入: Claude Code から MCP を呼んで 4 枚の RGBA が出て、四隅 alpha=0 の候補があることを evidence の画像パスで示す。
依存: b1-workflows
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b2-sprite- anchor
- anchor_missing
generate_character_bible / bible_status: JoyAI で多方向+表情+衣装の設定画
カテゴリ: defect
正規ID: modernization-20260904-b/b3-bible
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
MCP generate_character_bible(source, name, char_desc, attr) と bible_status(job_id)。source は候補 id か画像パス。JoyAI-Image-Edit-Plus(b1 の②)で 8 方向・表情 6・衣装 3・ちび等のパネルを生成し、パネルを .cache/generated/bible__panels/ に保存(LoRA 教材)、Pillow で 1 枚の設定画と自己完結 HTML を合成。代名詞は char_desc から組み、her 固定にしない。ジョブは uuid4、状態は .cache/jobs/.json。受入: MCP から実行して設定画 PNG と panels が出た証跡(パス)。
依存: b1-workflows
安全上表示できない要素を除外しました。
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b3-bible- anchor
- anchor_missing
train_character_lora / train_status: box.py 経由で fox の sd-scripts(Anima)を回し LoRA を配置
カテゴリ: defect
正規ID: modernization-20260904-b/b4-lora-train
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
MCP train_character_lora(bible_name, trigger?, steps?) と train_status(job_id)。backend/box.py は scp で教材を fox へ送り、ssh fox python C:\sf\train.py --config <toml> を起動して stdout を読み進捗(step/total)を job に反映、完了後に LoRA を fox の ComfyUI/models/loras へ配置(ssh の cp ではなく train.py 側に出力先を渡す)。学習前に ComfyUI /free を叩く。PowerShell 文字列を持たない。受入: p1-lora の教材で実際に短時間学習を回し、list_loras に新 LoRA が出て generate_sprite(lora_name=…) で 1 枚出た証跡。
依存: b3-bible
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b4-lora-train- anchor
- anchor_missing
generate_variant / make_mask / make_transparent / pixelize: ダメージ版と派生
カテゴリ: defect
正規ID: modernization-20260904-b/b5-variant
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
MCP make_mask(image_id, prompt|points) は SAM 3.1(b1 の④)で mask 候補を返す。generate_variant(base_id, prompt, mask_id?) は JoyAI 編集→mask 内だけ差し替え(mask 外はベースの画素を復元)→計測(bbox 中心差)を数値で返す。make_transparent(image_id) は ToonOut、pixelize(image_id, block, posterize) は Pillow。受入: 素体 1 枚から mask→ダメージ版→透過→ドット化を MCP で通した証跡(各段の画像パスと bbox 差)。
依存: b1-workflows
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b5-variant- anchor
- anchor_missing
記録一本 events.ndjson と SSE、MCP/REST の一本化
カテゴリ: defect
正規ID: modernization-20260904-b/b6-events
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
backend/events.py: services の全ツール呼び出し・ジョブ状態変化・生成完了で 1 行追記(event_id, job_id, seq, schema_version, at, kind, payload)。REST /api/events は SSE で events.ndjson を追従、/api/events?since= で過去分。MCP ツールと REST は同じ services 関数を呼び、引数・既定値を二重定義しない(既定値は services のシグネチャだけ)。受入: tests/test_events.py と、MCP から generate_sprite を 1 回呼ぶと events.ndjson に呼び出し・完了の 2 行が増える証跡。
依存: b2-sprite, b3-bible, b4-lora-train, b5-variant
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b6-events- anchor
- anchor_missing
WebUI 5 画面を新 API に接続して実走確認(作業台・設定画・LoRA・過程・記録)
カテゴリ: defect
正規ID: modernization-20260904-b/b7-web
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
計画 Phase 2『WebUI 作り直し』の 5 画面が b2〜b6 の API で実際に動くことを確認し、足りない画面・導線を実装する。①作業台: 素体生成→候補カード(計測値表示)→透過・ドット化・ダメージ版 ②設定画: 生成開始→進捗→完成画像と HTML ③LoRA: 教材確認→学習開始→進捗→一覧 ④過程: /api/events の SSE を流す ⑤記録: 過去の生成・設定画・LoRA を辿る。受入: Playwright でコンソールエラー 0、5 画面それぞれの主要導線 1 周の証跡(スクリーンショットのパス)。
依存: b6-events
前提工程
後続工程
元plan: docs/plan_modernization-20260904-b.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/modernization-20260904-b/b7-web- anchor
- anchor_missing
AnimaでOK/NG選好学習を成立させる
カテゴリ: F
正規ID: preview-feedback-20260906/01-feasibility
登録済みの前提工程はありません。図だけではdispatch可否を判定しません。
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
導入済みsd-scriptsのremote・commitとAnimaのflow目標を確認する。Diffusion-DPO系の目的関数を第一候補として、現行キャラクターLoRAを含む学習前モデルを凍結基準にした最小試作を本repoのbox配下へ置く。foxで一組のOK/NGによる順伝播・逆伝播・保存・再読込み・ComfyUI推論を確認し、VRAMと時間を測る。NGラベルの入替えで損失・更新が変わること、基準モデルが変わらないことをfocused testで固定する。OKのみ学習は比較対照に限定する。Animaへの移植を実証できなければ方式の調査と最小試作を更新し、画面だけの完成へ進まない。学習量・保持学習の必要性は実測で決める。
後続工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
note head: none
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/01-feasibility- anchor
- anchor_missing
10枚の生成画像と判定を正しく保存する
カテゴリ: F
正規ID: preview-feedback-20260906/02-reviews
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
services/events/台帳に生成ジョブと画像識別子、生成元LoRA・注文・seed・生成設定、OK/NG/未判定・理由・判定版を持たせる。既定10枚と逐次結果を公開する。RESTとMCPは同一サービスを呼ぶ。任意パスでなく画像の所属を検証し、判定変更・競合・再読込み・旧ジョブの不足情報を扱う。生成画像を元サンプルへ混ぜない。fixtureで別画像への付替え、別キャラクター混入、再表示、未判定、同時更新を確認する。学習データの契約は成立確認した方式に合わせる。
前提工程
後続工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行判定保存を拡張:生成画像と元サンプルの参照、コメント原文、修正対象・維持対象・質問・解釈状態、判定と解釈の版、訂正履歴を保存。判定変更で原文を保持し旧解釈を失効させる。intent_service.py・intent.pyと既存解釈入口を対象に含める。実装仕様は設計書の判定コメントのAI解釈。
来歴: v1/02-reviews・記録者 KaitonoMacBook-Air.local/kite
note head: e15a6f7ab0c76a5dff2da1715901c3ff800fce7e3d46b6e690d2da8deaf26154
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/02-reviews- anchor
- anchor_missing
判定から再学習と再プレビューを一回で実行する
カテゴリ: F
正規ID: preview-feedback-20260906/03-relearning
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
判定の固定版から同一条件内のOK/NG対を作り、services→box.py→train.pyの正規入口で教材転送・選好学習・新版LoRA保存・10枚の再プレビューを連続実行する。既存サンプルと学習前LoRAを保全する。NG理由は任意。片方のラベルしかない場合は学習を開始せず理由を表示し、未判定は対象外にする。過去評価は生成元を保持し、対を水増しした独立標本数にしない。中断後は同一ジョブを表示し二重起動しない。学習中の判定変更は次回分とする。fixtureのデータ固定・二重要求・途中失敗と、foxで公開入口からの保存結果を確認する。
前提工程
後続工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行合意の再照合により質問回答後の同一要求継続を実装。同じrequest_idで、回答前の準備をpreparation_historyへ保持して教材を作り直す。未変更の再接続・学習開始済みは重複実行しない。UIはawaiting_answersの同IDを再利用する。
来歴: v1/03-relearning・記録者 KaitonoMacBook-Air.local/kite
現行コードは79258bcまでmainへpush済み。保存/AI解釈/正規学習入口のfixtureと実CLI4例成功。実機は832x1216で元のOK/NG画像と画素一致し、正規入口の一更新・保存まで成功。18:42 JST時点は10枚再プレビュー中。サーバー .cache/preview-feedback-pipeline/result.json の完了結果を回収し、画像と学習結果を確認して第3工程を閉じる。次は第4工程UI。GPU待ちが1分を超えたため指定に従い待機を終了。継続PTYはsprite-preview-review、ローカルログ /tmp/sprite-preference-pipeline.log。
来歴: v1/03-relearning・記録者 KaitonoMacBook-Air.local/kite
現行再学習準備へ任意コメントのAI解釈を接続する。対象生成画像・元サンプル・判定・原文を渡し、修正と維持を分ける。コメントなしは解釈不要。明確な内容は追加承認不要。曖昧・矛盾時だけ確認し、解釈失敗や未回答を黙って除外して開始しない。回答後は同じ要求を継続し、判定・解釈の固定版を教材へ渡す。LoRA重みの修正が目的で、生成文の変更だけで代用しない。
来歴: v1/03-relearning・記録者 KaitonoMacBook-Air.local/kite
note head: af6e1d4adb0143193cd6c2e5395a422c5f4cc10aa6baaccd5c753ebc8ac816f4
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/03-relearning- anchor
- anchor_missing
生成画像の横で判定・再学習・新版採用を操作する
カテゴリ: A
正規ID: preview-feedback-20260906/04-ui
設計メモ
既存の注文機能を再利用し通常表示する。10枚にOK/NG・解除・任意理由・保存状態を表示する。未判定/OK/NGの件数、再学習開始、学習状況、旧版と新版の比較、使うLoRA版の明示採用と設定画への接続を実装する。全OKは設定画へ、全NGは追加生成・注文修正・サンプル見直しへ進める。実ブラウザーで判定・保存・再表示・通信失敗・新版採用・設定画への版の引継ぎを通し、狭い幅でも確認する。10枚生成と学習の開始を混同せず、既存の単発注文と画風指定を保つ。
前提工程
後続工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行NG欄は「この画像のどこがNGでしたか?」、補足「直してほしい箇所を書いてください(任意)」、例「髪型がサンプルと違う。ツインテールがなくなっている」。OK欄は「この画像で残したいところは?(任意)」。髪・顔・衣装等は任意選択。例文を実入力にしない。画像のそばにAIの修正対象・維持対象・質問を表示し訂正可能にする。判定だけで利用可能。曖昧時だけ確認し、原文の自動保存と学習後の閲覧を保つ。
来歴: v1/04-ui・記録者 KaitonoMacBook-Air.local/kite
note head: b19ad52530b5cb0ce98d168ff7b93bb71185de469099a475ad99a29fb0a34d2a
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/04-ui- anchor
- anchor_missing
未知の生成画像でNGの改善と本人の特徴を確かめる
カテゴリ: F
正規ID: preview-feedback-20260906/05-quality
並列可否: 未検査です。競合が無いのではなく、まだ判定していません。このplanには独立性の記録がまだありません。宣言を書いて lattice todo independence compile --plan preview-feedback-20260906 --input <ref> を通すと判定できます。
設計メモ
隔離した教材・LoRAで、学習前/OKのみ学習/OKとNGの学習を同じ注文・推論条件・未学習seedで比較する。NGラベルが学習へ効く検証と実画像の改善を分ける。髪型の既知事例と異なる衣装・体形・人外を含む事例で、対象特徴の改善と顔・衣装・画風の維持を全画像で確認する。元画像単位で学習と評価を分け、10枚や全組合せを過大な証拠としない。画像・判定数と母数・評価者・設定・時間・VRAM・失敗を既存の閲覧面へ示す。改善未達なら原因を特定し学習方式を直して同条件で検証する。固定の自動合否判定器やNGゼロ保証は作らない。
前提工程
後続工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行学習量だけを切り分ける選好100step実験を49b9ea9から開始し、28/100の更新を実測。元の教材・モデル・生成条件・評価seed21–30は維持。出力はmain-server .cache/preview-feedback-quality-100、実行ログは同名.log、学習ログは同ディレクトリ/preference.log。Aiterm sprite-preview-reviewが実行を継続。20stepの全30枚の比較結果はquality-20.mdとquality-review.json、ローカルhttp://127.0.0.1:8880/report.html。外部待ちが1分を超えたため待機を終了。次は100step全画像を評価し、改善未達なら教材の構図差の交絡を切り分ける。工程05は未完了、06本番反映は未着手。
来歴: v1/05-quality・記録者 KaitonoMacBook-Air.local/kite
現行30枚の目視比較を完了。twintailsは学習前5/10、OKのみ20step2/10、選好20step4/10で改善未達。衣装基本特徴は各10/10、紫の瞳は7/10・8/10・7/10。比較用seed21–30、学習seed1,2。NGラベルを実際に使った更新は成立するが品質受入は未達。quality-review.jsonに全画像の観測と基準を記録し、ローカル8880/report.htmlで画像を横並び表示。サーバー再起動後、完了済みOK学習を再利用して10枚生成し直した。空ファイルとの因果は未確定で製品へ推測修正は加えていない。符号・正規化・LoRA適用の独立反証と、学習量不足対画像構成の交絡の切分けを進める。
来歴: v1/05-quality・記録者 KaitonoMacBook-Air.local/kite
現行画面工程は4bae605で完了。比較実験f6b74fbを既定ブランチへpushし、main-server隔離worktreeからfoxで実行中。学習前seed21–30の10枚は60.44秒で生成完了、OK-only20step実行中。続いて選好学習20stepと10枚を同じ入力・設定で実行する。外部処理待ちが1分を超えるため待機を終了。再開時はssh main-serverで.cache/preview-feedback-quality/report.jsonと同名.logを確認し、全画像目視、既存閲覧面への比較表示、別事例、品質成立後の本番反映を続ける。Aiterm sprite-preview-recordが実験を継続。現在の本番は未反映。
来歴: v1/05-quality・記録者 KaitonoMacBook-Air.local/kite
現行追加受入:NGで「衣装は合っている」は衣装維持+NG箇所質問、「髪型が違う。衣装は合っている」は髪修正+衣装維持。空欄、矛盾、否定・引用、判定変更、失敗、訂正と再表示をfixture・実CLI・実ブラウザーで確認。学習ではNG改善と既存OK特徴の維持を両方測る。部位別学習の効果を未検証で主張しない。
来歴: v1/05-quality・記録者 KaitonoMacBook-Air.local/kite
note head: 49087563e47201dbb45b1c961735cd58c623c16269c9efbcc9e5510de6aafb14
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/05-quality- anchor
- anchor_missing
関連試験を完了して本番の制作工程へ届ける
カテゴリ: F
正規ID: preview-feedback-20260906/06-delivery
並列可否: 未検査です。競合が無いのではなく、まだ判定していません。このplanには独立性の記録がまだありません。宣言を書いて lattice todo independence compile --plan preview-feedback-20260906 --input <ref> を通すと判定できます。
設計メモ
各機能のfocused testと実機確認後に関連JavaScript試験とuv run pytestを通す。保存契約と学習契約・本番反映は独立反証を受ける。変更を既定ブランチへ着地させ、既定ブランチ祖先を確認してmain-serverのcomposeとfoxの学習入口を配備する。ローカル/サーバーの既存差分と永続データを保持する。本番で10枚表示・判定保存・再学習経路・旧新版の明示採用・設定画のLoRA参照を確認し、試験データと利用者のデータを分ける。GPUや外部完了待ちが長い時は状態と再開commandを残す。文書だけの今回には配備や学習を含めない。
前提工程
作業記録
現行2026-09-06 オーナー合意による計画更新。現在のキャラクターLoRA自体をOK/NGで修正し、NGの改善と既存OK特徴の維持を両方受け入れる。NG欄は「この画像のどこがNGでしたか?」と明記。コメントは任意、入力時は生成画像・元サンプル・判定を合わせてAI解釈し、修正対象と維持対象を分ける。NGに「衣装は合っている」だけなら維持対象として扱い、NG箇所だけ質問する。明確な内容は追加承認不要、曖昧・矛盾時だけ確認。解釈結果は画像のそばで表示・訂正し、原文と履歴を保持する。詳細はdocs/preview-feedback-design-20260906.mdの利用者の操作・判定コメントのAI解釈・受入条件。既存設計メモのコメントを任意理由だけとして扱う記述は本追記で更新。今回は計画更新のみ。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
note head: none
元plan: docs/preview-feedback-design-20260906.md — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/preview-feedback-20260906/06-delivery- anchor
- anchor_missing
画風の注文を既存LoRA選択へ接続する
カテゴリ: F
正規ID: user-intent-agent-20260905/01-style
登録済みの前提工程はありません。図だけではdispatch可否を判定しません。
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
実装
登録済みの学習済み画風一覧を現在の解釈担当へ渡し、利用者が確認した画風選択を既存のLoRA設定へ接続する。一つのシートは一つの画風とし、パネル単位の画風指定を確認画面から外す。衣装・顔・髪の内容指定と画風の選択を分ける。既存の原文・解釈・確定記録、キャラクターLoRAと強度を維持し、新しいエージェント、画風専用の別台帳、画風語の固定挿入は追加しない。
未解決の注文
対応する学習済み画風がなければ未解決と表示し、既存の明示的な画風学習へ案内する。衣装等と混在した注文は全体を一律に拒否せず、未解決の画風を残すか訂正するか利用者が明示的に確認できるようにする。黙って一部採用しない。画風自体の教材工程では、画像の観察と望む変更を混同しない。
受入
既存画風の採用・維持・解除、今回だけと今後も、未登録画風、衣装との混在、シート全体と部分描き直しの画風維持をfocused testと画面で確認する。画風は内容プロンプトやパネル修正へ二重保存しない。既存の手動選択との矛盾は画面で解決する。
現在地
画風を含む提案を一律拒否する処理と、画風にもパネル範囲を出す画面を確認済み。直前の画風接続案は未実装。2026-09-05の会話でオーナーが上記の完成形を了承した。
後続工程
作業記録
現行2026-09-05のオーナー承認でMarkdown工程から移行。残作業5件と依存・受入条件をLatticeへ登録し、旧計画はdocs/archive/plan_user-intent-agent-20260905.mdへ凍結した。進捗はLatticeだけへ更新する。原文・参照・確定案を保存する汎用ツール、シート内の画風統一、既存契約内の公式CLI、Anima+LoRAと明示的学習を維持する。直前の実画像・試験証拠は既存evidenceを参照し、未配備を完了扱いしない。今回の移行は親が直接行い、製品実装と実行の起動はしていない。旧近代化runは停止済み・未クローズだが、この計画とは別のため変更していない。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行画風接続は完了(commit 74ab980)。設計メモの「現在地」は着手前の記録。関連Python159件・画面単体9件が成功。ローカルの実WebUIから契約認証済みTerraを呼び、24.02秒で画風と衣装・背景・顔髪を分けて提案。画面で採用し、生成処理へキャラクターLoRA 0.8+画風LoRA 0.7と衣装文が渡ること、再表示・390px幅での表示を確認した。GPU部分は模擬処理なので、画質の成功を示す結果ではない。確認役の指摘2件は修正済みで、新旧シートの描き直しで元の画風名・強度を保持する試験も成功。次の工程は本番実行環境から契約内CLIを呼ぶ接続。本番配備と実画像評価は未完了。
来歴: v1/01-style・記録者 KaitonoMacBook-Air.local/kite
note head: eeb7a8b8e56d03d22aaa1280fe847b2c0988966b92fa88997cfd3778f0389bc5
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/user-intent-agent-20260905/01-style- anchor
- anchor_missing
本番アプリから契約内のコメント解釈を呼び出す
カテゴリ: F
正規ID: user-intent-agent-20260905/02-cli
登録済みの前提工程はありません。図だけではdispatch可否を判定しません。
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
実装
既存の公式CLI呼出しとホスト接続設定を本番の実行環境へ接続する。採用済みのTerraとChatGPTの契約ログインを維持し、Sonnet・直接従量制API・追加使用量・新しいキー・認証ファイルの転用は使わない。接続先や認証は正規入口で確認し、既存接続実装を活かす。
受入
アプリで新しく入力した原文と参考画像が実CLIへ届き、その実応答が確認画面へ戻ることを隔離台帳で確認する。保存済み応答の再生を新規呼出しの証拠にしない。失敗時に原文が残り、別モデルへの切替・自動再試行・架空進捗がないことを確認する。ログインに人の操作が必要なら必要条件を伝える。
現在地
ローカルの実CLI解釈と、メインサーバーの隔離環境で保存済み解釈からGPU生成する経路は確認済み。本番アプリからの新規CLI呼出しと機能配備は未確認。
後続工程
作業記録
現行2026-09-05のオーナー承認でMarkdown工程から移行。残作業5件と依存・受入条件をLatticeへ登録し、旧計画はdocs/archive/plan_user-intent-agent-20260905.mdへ凍結した。進捗はLatticeだけへ更新する。原文・参照・確定案を保存する汎用ツール、シート内の画風統一、既存契約内の公式CLI、Anima+LoRAと明示的学習を維持する。直前の実画像・試験証拠は既存evidenceを参照し、未配備を完了扱いしない。今回の移行は親が直接行い、製品実装と実行の起動はしていない。旧近代化runは停止済み・未クローズだが、この計画とは別のため変更していない。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行サーバーへの正式なChatGPT再ログイン後、隔離WebUIから同じ画像と原文を再送し、新規CLI実応答を19.17秒で受信。画像コメントから上下セパレート・腹部露出の衣装を今後も共通とする案になり、背景・ポーズは共通条件に追加されなかった。画面で採用し、再読み込み後も採用済みと衣装条件が残ることを確認。前回の認証失敗記録・原文・画像は保持。関連14試験と独立確認は前commitで完了。接続工程を受入し、実画像の品質検証と本番配備は後続工程で行う。
来歴: v1/02-cli・記録者 KaitonoMacBook-Air.local/kite
現行接続設定は実装・独立確認済み、関連14試験成功。オーナー了承に基づき既存SSH登録をバックアップし、解釈CLI限定の鍵登録を追加。コンテナの認証失敗によるfail2ban遮断を当該IPだけ解除し、任意コマンドが実行されないことを実測。本番とは別の台帳と画面から画像付き新規注文を送ったところ、ホストCodexのrefresh token revokedで失敗。画面に理由を表示し、原文・画像コメント・参照画像を保存した。再ログインが必要。実応答を受け取る受入は未達で02を継続中。保存済み応答の再生・API切替・自動再試行・本番配備は行っていない。
来歴: v1/02-cli・記録者 KaitonoMacBook-Air.local/kite
現行本番接続の調査: ホスト側codex-cli 0.153.2はcodex login statusでChatGPTログイン済み。ホストrepoは432059dでclean、本番コンテナは稼働中。composeは解釈接続用の環境変数をまだ渡していない。既存コンテナにはmain-serverというSSH接続定義がなく、ホストのLANアドレスへ既存の標準SSH鍵で接続するとPermission denied (publickey)。詳細ログで認証拒否を確認した。既存の他鍵は別用途なので試用していない。次に必要なのはアプリの既存SSH鍵にホスト上の解釈CLIを呼ぶ権限を与えるかのオーナー確認。認証ファイル転用・APIキー・本番再起動・作品データ変更は行っていない。権限合意後、接続設定を実装し、隔離アプリから新規画像コメントを実CLIへ通して受入する。
来歴: v1/02-cli・記録者 KaitonoMacBook-Air.local/kite
note head: 79920c95b65deb5d0b64e85421dcb7f8f6dc7a351f7cfc3f8d9468599b776681
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/user-intent-agent-20260905/02-cli- anchor
- anchor_missing
注文反映と特徴・画風の維持を実画像で確認する
カテゴリ: F
正規ID: user-intent-agent-20260905/03-images
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
検証
01の画風接続と02の実CLI接続を使い、未確認のプレビュー、キャラクターの一枚生成、画風からの一枚生成を実画像で確認する。人間の顔・髪・衣装、向き・表情・単品とシート内の画風統一を主な基準とし、スライムは補助例に留める。ベル固有の服・名前・画像番号を製品条件へ固定しない。
既存証拠と未達
参考画像4枚と正面・左側面・靴の実生成3枚は保存済み。上下セパレート・主要な顔髪・各一人・脚なしの靴一足は確認済みだが、靴のファーなど細部は未達。既存の入力・応答・画像を起点に未達の原因を切り分け、必要な変更だけ実装してfocused testと対象の実画像で確認する。過去の72解釈や成功画像一式を無条件に再走しない。
学習の条件
教材確認・履歴の実装は済んでいる。キャラクター/新しい画風の再学習が必要と分かった場合だけ、実教材・説明・パラメータ・影響を提示し、オーナーの明示合意後に実行して同条件で効果を確認する。再学習そのものを必須作業にしない。未登録画風を学習済みと扱わない。
受入
実入力、実解釈、確定した条件、GPU条件、生成画像と観察結果を対応させ、成功も失敗も閲覧できる面へ出す。未達を全成功と呼ばず、好みの判断と技術的な不具合を分ける。
前提工程
後続工程
作業記録
現行2026-09-05のオーナー承認でMarkdown工程から移行。残作業5件と依存・受入条件をLatticeへ登録し、旧計画はdocs/archive/plan_user-intent-agent-20260905.mdへ凍結した。進捗はLatticeだけへ更新する。原文・参照・確定案を保存する汎用ツール、シート内の画風統一、既存契約内の公式CLI、Anima+LoRAと明示的学習を維持する。直前の実画像・試験証拠は既存evidenceを参照し、未配備を完了扱いしない。今回の移行は親が直接行い、製品実装と実行の起動はしていない。旧近代化runは停止済み・未クローズだが、この計画とは別のため変更していない。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行画像別採用指定の第一修正を8689b81で通常push・本番反映、CI success。全Python256件・Web34件成功。本番公式CLI 40.29秒で顔=画像2、体格と衣装=画像4のpersistent案を作成。確認用キャラクターでWeb採用後、別工程のプレビュー2枚(seed1/2)を実生成し、実記録の参照先継承を確認。2枚とも上下セパレートと腹部露出を目視確認。顔の類似度・年齢感の十分な再現と特徴別LoRA学習重みは未達。元ベル変更・再学習なし。実画像比較 /api/file?path=/app/.cache/feature-references-20260906.html 。検証補助scriptの一覧対詳細比較は管理項目差で失敗したため、詳細対詳細へ修理。製品動作の失敗ではない。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行画像別の強い採用指定を修理中。実CLI baselineは顔=画像2、体格服装=画像4を正しく読むがsamples工程で全件this_runとなり後続生成へ残らない。指示修正後の実CLIは同参照をpersistentへ保存提案、質問なし。画像別コメントの指示対象以外を採用しないことと学習回数変更ではないことを明記。UIへ特徴ごとの参照元表示を追加。次工程への保存・生成条件の継承focused試験とWeb12件成功。特徴別の学習重み変更は未実装、再学習なし。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行第一修正を25b06ccで通常push・本番配備、healthyとCI success確認。本番の新規training解釈eecba5d9-1fae-45a6-a5d0-e103fe3df74bは原文空・同素材で14.55秒、young adultと頭身・身体比率を日本語観察と英語教材説明へ記述。確認待ちに留め、教材採用・学習は未実行。現在のベル台帳のtraining_captionは4件ともnullであり、今回の欠落修理が旧LoRAを改善したという証拠にはならない。過去の学習説明とLoRA寄与は未確定。新たな説明と生成経路の第一改善は配備済み、年齢感の完全再現は未達として継続課題。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行年齢感引継ぎの第一修正:教材説明training_captionsのCLI伝達欠落を再現・修理。学習教材と生成snapshotの保持試験を追加。関連23件、全Python255件成功。元本番入力を公式CLIで再解釈29.5秒、成人指定を入力せずyoung adultと身体比率を観察。seed1/1024角/LoRA0.8/同衣装髪背景除外のままsubject・faceだけ変更した診断job f539e1b7-62f0-4a41-b1bb-14b03aa5c1b8を生成。輪郭と身体つきは素材へ近づいたが幼い印象は残り、完全解決ではない。再学習なし、元教材の書換えなし。公開比較 /api/file?path=/app/.cache/identity-comparison-20260906.html。新説明は今後の明示的な観察確認・解釈で利用する。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行追加GO 2026-09-06:素材の年齢感・頭身・顔立ちを学習説明と生成へ引き継ぐ改善に着手。確認済みtraining_captionsがCLI payloadへ渡らない欠落をfocused testで再現。既存説明を渡し、観察と生成案で年齢感と身体比率を別々に保持する指示を追加。再学習なし、実CLIと同条件画像の比較はこれから。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行オーナー裁定を更新。コメント反映は限界を明示した研究中の機能として提供する。加えて詳細設定にキャラクターの特徴の強さ(研究中)と既定値へ戻す操作を追加することが承認された。未操作時は従来の0.8を維持、自動調整・特定キャラ補正・自動再学習なし。既存の画風強度と別に保存し、次の新規生成へ適用。既存シートの部分修正は生成時の構成を維持する。追加機能の合意待ちは解消。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
現行実画像10枚を生成し全件を目録駆動で掲載。通常API3件(プレビュー・キャラクター単画・画風単独)は公式CLIの提案確認と採用を経て完走。コメントが生成命令へ届くことは確認したが、通常強度では左向き/別衣装/雨の背景に不履行あり。診断7枚・同seed73ではキャラクター0.4+画風0.3でコート・傘・雨の公園が改善、顔髪の描かれ方も変化。既定値変更・再学習・本番配備は未実施。キャラクター強度は現行0.8固定。汎用の利用者向け強度調整を追加する案は新しい操作仕様になるため、比較を提示して合意を求める。工程は未完了のまま。証跡: evidence/user-intent-agent-20260905/generation-observations.json、同report_generation_probe.py。画像・実記録は同private/generation-v1/cache。公開比較: http://192.168.1.2:8766/api/file?path=/app/.cache/intent-generation-20260905.html 。Webで10枚と実行条件表示を確認済み。次は強度調整の仕様合意後、正規経路の実装と実画像再検証を行う。04-finishと05-deployは未着手。
来歴: v1/03-images・記録者 KaitonoMacBook-Air.local/kite
note head: a9a507b8eec55502625e9de62f3a60f0665d8611c89dd942210d537ae31dc580
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/user-intent-agent-20260905/03-images- anchor
- anchor_missing
画面・旧データ・操作経路を仕上げる
カテゴリ: F
正規ID: user-intent-agent-20260905/04-finish
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
実装と検証
既存の三段階の制作導線を保ち、スマホ幅で画像ごとの説明・注文・解釈の訂正・保存・再表示・工程移動を確認する。解釈中、確認待ち、生成待ち、生成中を実状態に合わせる。RESTとMCPが同じ処理・条件を使い、旧台帳・保存済み構成を壊さないことを関連試験で確認する。
既知の保守
一枚画像の拡大画面でdialog.appendへnullを渡して文字表示になる原因は確認済み。web/ui.jsでその原因を修理し対象試験を行う。uv run pytestのimport失敗とuv run python -m pytestが通る相違は、テスト入口の原因を確認して正規入口と文書を一致させる。別製品の改造や新しい管理機構を追加しない。
受入
変更した操作の実ブラウザー確認と関連試験を終えた後、Python・JavaScriptの全試験を最終確認として一度実行する。実機未確認をfixture成功で代用しない。
前提工程
後続工程
作業記録
現行2026-09-05のオーナー承認でMarkdown工程から移行。残作業5件と依存・受入条件をLatticeへ登録し、旧計画はdocs/archive/plan_user-intent-agent-20260905.mdへ凍結した。進捗はLatticeだけへ更新する。原文・参照・確定案を保存する汎用ツール、シート内の画風統一、既存契約内の公式CLI、Anima+LoRAと明示的学習を維持する。直前の実画像・試験証拠は既存evidenceを参照し、未配備を完了扱いしない。今回の移行は親が直接行い、製品実装と実行の起動はしていない。旧近代化runは停止済み・未クローズだが、この計画とは別のため変更していない。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
note head: none
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/user-intent-agent-20260905/04-finish- anchor
- anchor_missing
本番へ反映して完成状態を確認する
カテゴリ: F
正規ID: user-intent-agent-20260905/05-deploy
完走済みのため既定の図には描いていません。左上の「完走済み」バッジを押すと、このページ内で表示できます。
設計メモ
反映
01〜04の完了後、ローカルとメインサーバーの差分・永続データ・対象commitを確認し、プロジェクトの正規手順でバックエンドとWebUIを配備する。既存の教材・台帳・LoRA・生成画像を保持する。pushと公開commitの条件は実行時の適用正典で確認し、影響と戻し方を先に説明する。BellTeamの配備手順は使わない。
最終受入
本番で原文保存、新規解釈、案の訂正・確定、生成、画像表示、再表示までを確認する。通常の利用画面でコメントの効果と一枚のシートの画風統一を確認できる状態を届ける。試験用操作は隔離した台帳を使い、既存作品を無断で書き換えない。
完了条件
残作業と未達をLattice上で照合し、未接続・未配備を残して完了扱いにしない。技術的な合否は開発担当が判断し、画像の好みや明示的な再学習などオーナー固有の判断が必要な場合だけ尋ねる。
前提工程
作業記録
現行2026-09-05のオーナー承認でMarkdown工程から移行。残作業5件と依存・受入条件をLatticeへ登録し、旧計画はdocs/archive/plan_user-intent-agent-20260905.mdへ凍結した。進捗はLatticeだけへ更新する。原文・参照・確定案を保存する汎用ツール、シート内の画風統一、既存契約内の公式CLI、Anima+LoRAと明示的学習を維持する。直前の実画像・試験証拠は既存evidenceを参照し、未配備を完了扱いしない。今回の移行は親が直接行い、製品実装と実行の起動はしていない。旧近代化runは停止済み・未クローズだが、この計画とは別のため変更していない。
来歴: v1/null・記録者 KaitonoMacBook-Air.local/kite
現行本番 5085388 で drawing の学習欄非採用を実測。interpret a6080204 HTTP 200 elapsed_ms 177748 awaiting_confirmation training_samples None n_changes 5。confirm confirmed。from-bible 77340b54 HTTP 200 elapsed_s 9.0 completed。VRAM peak 32089/99/32607。隔離キャラ key 20260908 を DELETE 済み。既存 ndac1de01 / bell_glow は残る。画像は private 782266 bytes。証跡 evidence/user-intent-agent-20260905/20260908-qwen-vl-interpret-4bit-drawing-accept.json。05-quality は触っていない。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行max_tokens=2048 再実測。job f4f34940-eed5-41f7-97e8-1287df65e0fc へ interpret 一回。Comfy 2ee3e49c success、JSON 4159文字で閉じ parse_ok。VRAM ピーク 32068/120/32607、所要 204s、OOMなし。製品は drawing で training_samples=list(1) のため ValueError で failed。from-bible 未実施。この id へ再送禁止。05-quality と stash は未操作。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行オーナーが最終受入の続行を指示。2026-09-08T11:34+09:00 再確認でも fox 192.168.1.11 は Mac と main-server の二経路から到達不能。Comfy 8188 接続失敗。本番 /api/gpu は ConnectError。隔離キャラ 20260908 は残置。confirm / from-bible 未実施。failed job fdc09726 へ interpret 再送なし。別モデル切替なし。05-quality 未着手。証跡 evidence/user-intent-agent-20260905/20260908-qwen-vl-interpret-blocked.json に recheck を追記。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行最終受入は blocked。GPU ping smoke は通過済み。本番 interpret job fdc09726 は running のまま fox (192.168.1.11) が LAN 二経路から消え、history 待ち中に httpx.ConnectError で failed。ジョブ JSON の error 欄は空。別モデルへは切替していない。隔離キャラ 20260908 は再開用に残した。confirm / from-bible 未実施。証跡 evidence/user-intent-agent-20260905/20260908-qwen-vl-interpret-blocked.json。fox が Comfy に応答したら同じ台帳で新規 draft から再開。failed ジョブへ interpret 再送はしない。05-quality は触らない。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行GPU実解釈smoke成功 2026-09-08。入口は本番コンテナ /app/.venv/bin/python の backend.intent_cli._ask。AUTH=comfy、MODEL=Qwen3-VL-32B-Instruct、量子化 8-bit、videoキーなし、画像なし、keep_model_loaded=true。既存台帳未使用。/free 未使用。別モデルへ切替なし。Comfyキューは実行前に空。
実測:
prompt_id 8c946c74-f893-4071-9cf0-c3a01a7e774c: 未キャッシュ、Comfy 115723ms、text=pong。32B 8-bit のコールドロード。
prompt_id 6421e2a6-95c7-416c-94f4-f08ce4ebb441: 同一プロンプトのグラフキャッシュ、Comfy 1ms。GPU実測に数えない。
prompt_id 9ed55fc6-546a-4e7d-a23f-2c522bc2b71d: 固有プロンプトで未キャッシュ、壁時計 2.04s、Comfy 1378ms、text=pong。モデル常駐後のウォーム実行。
証跡: evidence/user-intent-agent-20260905/20260908-qwen-vl-gpu-smoke.json。05-quality は未着手。このToDoは閉じ直していない。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行2026-09-07: コメント解釈を Qwen3-VL-32B-Instruct 8-bit に差し替えた commit 61adcf5672270a83342c1ebb733b7f2bbe447dbb を本番へ反映。GitHub origin/main と一致。配備前に worktree tarball・旧 image sprite-forge-rollback:before-qwen-vl-20260907・stash 0 before-qwen-vl-20260907 を退避。stash は preview-feedback 05-quality の未コミット作業で、pop していない。本番 worktree は清潔な 61adcf5 の main。docker compose up -d --build 後コンテナ healthy。LAN 8766 は 200。API 台帳はキャラ1 ndac1de01・画風1 bell_glow を保持。コンテナ内 qwen_vl_interpret は class AILab_QwenVL_Advanced・quant 8-bit (Balanced)・video キーなし・MODEL Qwen3-VL-32B-Instruct・AUTH comfy。fox object_info にも同ノードと 8-bit 選択肢あり。32B の GPU 実解釈は未実行(当初GOの完了条件外)。既存作品は触っていない。05-quality の active_run は未着手のまま。この ToDo は 2026-09-05 時点で done 済みで、閉じ直しも新規 ToDo もしていない。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/cursor
現行通常pushと本番反映までの明示承認を得た。GitHub origin/mainにローカル実装38commitが未送信、さらに仕上げcommitを作成。サーバーは432059dの独立履歴、originは既存ローカルbundle、dirtyなし。既存履歴・remoteを保持したまま、GitHub mainへ到達した対象commitのbundleをfetchしdetached HEADで配備する。配備前にcache334MB・git履歴・実行imageを退避し、環境は公式CLI専用SSHの本番root指定だけ追加。認証情報のコピーや再学習なし。
来歴: v1/05-deploy・記録者 KaitonoMacBook-Air.local/kite
note head: 641d50566640a965daf184ff1ca6c72f0ce740ea52c629455136eb573aac2ead
元plan: 参照なし — 行対応を確認できないため、本文位置との対応は表示していません
開発者向け診断
- canonical ref
sprite-forge-mcp/user-intent-agent-20260905/05-deploy- anchor
- anchor_missing