アプリ内ヘルプ

ヘルプは、いま開いているステップにカードがあるときだけ表示されます

ヘルプカードを開く操作はウィザードのヘッダーにあり、その下のステップに結び付いています。対応表が知らない組み合わせでは、別のステップのカードが開くのではなくアイコンが出ません。そして開いたカードは、使っている表示言語で書かれています。

ヘルプは画面ではなくステップに結び付いています

作成フローは、ヘルプをウィザードのヘッダーに載せています。ウィザードはいま開いているステップのヘルプキーを解決し、キーがあるときにだけカードを開くハンドラーを作ります。そしてヘッダーは、そのハンドラーが渡されたときにだけ操作を描きます。該当するファイルはapps/jewelry-mobile/src/features/generation/create-flow/create-wizard.tsx、create-flow/wizard-header.tsx:37で、2026年8月にアプリのソースから読み取りました。

そこから出てくる結論は狭く、はっきり書く価値があります。「？」があるかどうかは、その下のステップについての表明です。アプリの健全性、通信の状態、選んだツールが動いているかどうかを示す合図ではありません。

処理中の画面は同じ属性を自前で渡すため（create-flow/processing-screen.tsx:133）、そこでの操作もウィザードの中と同じ条件に従います。

ヘッダーの表示、状態ごとに

4つの状態と、それぞれを決めるものです。これらの行は操作についてだけ述べており、カードの中身については述べていません。

どこにいるか	「？」アイコン	何が決めたか
ツールをまだ選んでいない、最初のステップ	描かれる	対応表がツール未選択の状態をツール選択のカードに解決する
対応表が知っているツールとステップの組み合わせ	描かれる	その組み合わせそのものにカードが定義されている
対応表が知らない組み合わせ	まったく描かれない	別のステップのカードに解決するのではなく、ヘルプが隠される
処理中の画面	同じ属性に従う	その画面が属性を自前で渡す（processing-screen.tsx:133）

アイコンがないことは判断であって、読み込みの失敗ではありません

以下はいずれもcreate-flow/help-content.tsと、上で挙げた2つのウィザードのファイルで読み取れます。

操作は不在であって、灰色表示ではありません。: 解釈すべき薄い表示や押せない状態のアイコンはありません。ハンドラーが渡されない場所では、ヘッダーには描くものがありません。
別のステップ向けに書かれたカードよりも、沈黙が選ばれます。: 対応表が認識できないツールとステップの組み合わせは何も返さず、最も近いカードにフォールバックするのではなく操作が隠されます。
最初のステップがヘルプなしで残ることはありません。: ツールがまだ選ばれていない状態はツール選択のカードに直接対応付けられているため、そのステップには必ず操作があります。
この規則は、どのツールを使えるかについては何も述べていません。: ツールが有効かどうかはサーバー側の設定から解決され、ヘルプの画面からはまったく読み取れません。

ソースには書かれていて、体験には現れないもの

探して時間を使う人が出ないように記録しています。いずれも機能ではなく、ここで開けるものとして案内しているわけでもありません。

ソースには2つのヘルプカードが存在します。1つは結果画面の変更前／変更後の表示向け、もう1つはライブラリから選ぶ画面向けですが、どのステップもそれらに解決せず、それらの画面ではシートが描かれません。欠けているのはカードであって、画面ではありません。
ヘルプカードのレイアウトにはプライバシーの行が含まれます。それを埋めるヘルプカードはないため、この画面ではどのステップでもプライバシーの記載は出ません。
この観察は作成フローのヘルプカードに限られます。アプリの他の場所にある文言については何も述べていません。
どのツールが有効かはここからは読み取れません。それはサーバー側の設定から解決されます。
個々のカードの中にある助言は、このページでは再掲しません。このページが述べるのは、ヘルプがどこに出て、どこに出ないかです。

ヘルプのアイコンを不具合として報告する前に

定義された不在と本当の欠陥を切り分ける順に並べた、5つの確認です。

どのツールで、どのステップにいたかを正確に書き留める。対応付けはツールごと、ステップごとであって、画面ごとではありません。
そもそもツールが選ばれていたかを確認する。選ぶ前の状態には必ずカードがあります。
ステップの本文ではなく、ウィザードのヘッダーを見ていたかを確かめる。
表示言語は別の項目として控える。カードが中途半端に翻訳された状態で出ることはないため、言語の疑問とアイコンの不在は別々の報告になります。
1つ前のステップに戻ると操作が現れるかを確認する。対応付けはステップごとに評価されます。

このページが開いたままにしている問い

撮影の技術はここでは扱いません。ガイドがその役割を担っています。現時点でどのツールが利用できるかはサーバー側の設定から解決され、ヘルプの画面からは読み取れません。生成が動いている間に待機画面が何を約束するかは専用のページがあり、ここでは繰り返しません。

以上はすべて、2026年8月にJewelry AIのモバイルアプリのソースから、本文中に挙げたファイルで読み取りました。create-flow/create-wizard.tsx、create-flow/wizard-header.tsx:37、create-flow/processing-screen.tsx:133、create-flow/help-content.ts、src/i18n/translate.tsです。

よくある質問

なぜ一部のステップで「？」が消えるのですか？

1つの対応表がツールとステップの組み合わせをヘルプカードに対応させており、認識できない組み合わせには何も返さないからです。するとウィザードは開くハンドラーを渡さず、ヘッダーは操作を描きません（create-flow/help-content.ts、create-flow/create-wizard.tsx）。

アイコンは無効化されているのですか、それとも存在しないのですか？

存在しません。薄く表示された状態や押せない状態があるわけではなく、ハンドラーがない場所ではヘッダーに描くものがありません（create-flow/wizard-header.tsx:37）。

ヘルプカードは自分の言語で表示されますか？

すべてのヘルプカードはすべての表示言語に項目を持ち、実行時に英語へフォールバックする仕組みはありません。キーが欠けている場合は、一部しか翻訳されていないカードを表示するのではなくビルド時に失敗します（src/i18n/translate.ts）。これはキーがそろっていることだけを指し、翻訳の品質や承認については述べていません。

ヘルプカードは、自分の写真がどう扱われるかを教えてくれますか？

カードのレイアウトにはプライバシーの行がありますが、それを埋めるヘルプカードはないため、この画面ではどのステップでもその記載は出ません。この記述は作成フローのヘルプカードに限られ、アプリの他の場所にある文言については何も述べていません。