addashboard-cli 0.11.0 → 0.13.0

package/skills/ad-ops/ad-planner.html

@@ -190,6 +190,11 @@
   .ddrow:hover{background:var(--accent-soft);}
   .ddrow.cur{background:var(--accent-soft); box-shadow:inset 3px 0 0 var(--accent);}
   .ddrow .ddno{font-family:var(--mono); color:var(--accent); font-weight:700; flex:0 0 auto; min-width:40px;}
+  /* 一覧の末尾に置く「＋ 新規登録」。既存の番号行と地続きに見えないよう上の区切りを強くする */
+  .ddrow.ddnew{border-top:1px solid var(--line); border-bottom:none; background:var(--soft);
+    position:sticky; bottom:0; font-weight:600;}
+  .ddrow.ddnew:hover{background:var(--accent-soft);}
+  .ddrow.ddnew .ddno{font-size:15px;}
   .ddrow .ddtx{color:var(--fg); overflow:hidden; text-overflow:ellipsis;}
   /* サムネ (#157)。Finder のリスト表示に寄せて「小さい画像 + 名前」の1行にする。
      画像が無いアカウントでも崩れないよう、読み込み失敗時は onerror で枠ごと畳む。 */
@@ -344,6 +349,24 @@
   .mrow{display:grid; grid-template-columns:1fr 1fr; gap:12px;}
   .modal .mfoot{display:flex; justify-content:flex-end; gap:8px; padding:14px 20px 18px; border-top:1px solid var(--line2); margin-top:8px; position:sticky; bottom:0; background:#fff;}
   .hint{font-size:11.5px; color:var(--faint); margin-top:4px;}
+  /* 「＋ 新規登録」の2ステップ (保存フォルダ → 素材) */
+  .nmstep{border:1px solid var(--line2); border-radius:10px; padding:12px 14px; margin:10px 0;}
+  .nmstep.cur{border-color:var(--accent);}
+  .nmstep.wait{opacity:.55;}
+  .nmstep .nmhead{display:flex; align-items:center; gap:8px; font-size:13px; font-weight:600;}
+  .nmstep .nmno{display:inline-flex; align-items:center; justify-content:center; width:20px; height:20px; border-radius:50%; background:var(--soft); font-size:11.5px;}
+  .nmstep.done .nmno{background:var(--green-soft); color:var(--green);}
+  .nmstep .nmbody{display:flex; flex-wrap:wrap; align-items:center; gap:8px; margin-top:8px; font-size:12.5px;}
+  .nmstep .nmbody .hint{flex-basis:100%; margin-top:0;}
+  .nmstep .nmpath{flex-basis:100%; display:flex; align-items:center; gap:8px; background:var(--soft); border-radius:8px; padding:8px 10px;}
+  .nmstep .nmpath .mono{flex:1; font-size:12px; word-break:break-all;}
+  .nmstep .nmhead .pill{font-weight:500; margin-left:4px;}
+  .nmitem{display:flex; gap:12px; align-items:flex-start; border:1px solid var(--line2); border-radius:10px; padding:10px; margin:8px 0;}
+  .nmitem img{width:120px; border:1px solid var(--line); border-radius:4px; flex:0 0 auto;}
+  .nmitem .nmmeta{flex:1; min-width:0;}
+  .nmitem .nmfile{font-size:12px; word-break:break-all; margin-bottom:6px;}
+  .nmitem .nmfields{display:flex; gap:10px; flex-wrap:wrap; font-size:12px;}
+  .nmitem .nmfields input{width:90px; font-size:13px; border:1px solid var(--line); border-radius:6px; padding:4px 6px;}
   .toast{position:fixed; bottom:22px; left:50%; transform:translateX(-50%); background:#111418; color:#fff; font-size:12.5px; padding:9px 16px; border-radius:9px; z-index:100; box-shadow:0 8px 24px rgba(0,0,0,.25); opacity:0; transition:opacity .2s, transform .2s; max-width:min(720px,92vw); text-align:left; line-height:1.6;}
   .toast.show{opacity:1; transform:translateX(-50%) translateY(-2px);}
   /* 書き出しをブロックしたときは自動で消さない。原因を読み返せないと直しようがない */
@@ -424,6 +447,7 @@
         <button data-yt="overview" class="active">概要</button>
         <button data-yt="resp">レスポンシブ</button>
         <button data-yt="banner">バナー</button>
+        <button data-yt="video">動画</button>
         <button data-yt="param">パラメータ</button>
         <button data-yt="guide">使い方</button>
       </div>
@@ -487,7 +511,7 @@
         <table class="g"><thead><tr><th>形式</th><th>入稿経路</th><th>利用</th><th>備考</th></tr></thead><tbody>
           <tr><td><b>レスポンシブ(画像)・固定型</b></td><td><span class="pill green">API入稿 ★主用途</span></td><td>★★★</td><td>タイトル/説明文/画像を人が1通りに固定し、成果を自分で検証。<code>Card</code>(1200x628)/<code>SQ</code>(1080x1080) の2形式。API上は <code>RESPONSIVE_AD + mainMediaFormat:IMAGE</code>、画像は <code>asset.mediaAssets[].mediaId</code>（PR #82・実API疎通は検証中）</td></tr>
           <tr><td>レスポンシブ(画像)・アセット型</td><td><span class="pill amber">非対象</span></td><td>—</td><td>複数タイトル/画像を登録しYahoo側が自動最適化。<b>1広告=単一組合せの本ツールでは非対象</b></td></tr>
-          <tr><td>レスポンシブ(動画)</td><td><span class="pill gray">別フロー(CLI)</span></td><td>—</td><td><code>webgram upload-video → submit</code> のAPI入稿（本番実績あり）。<code>thumbnailFlg:'TRUE'</code> のサムネ画像は動画専用で、画像広告のメイン画像とは排他</td></tr>
+          <tr><td><b>レスポンシブ(動画)</b></td><td><span class="pill green">API入稿 対応済</span></td><td>★★☆</td><td>広告行の<b>形式列で「動画」</b>を選ぶ（広告タイプはレスポンシブのまま）。参照表は <code>refs.media[番号].video</code>／<code>.thumb</code>。<b>サムネイル画像が必須</b>で、<b>YDA は動画からサムネを自動生成しない</b>（本番実測）ため、クリエイティブ番号セルの ▾ → サイドバー最下部の<b>「＋ 新規登録」</b>で動画を選び、0 秒フレームを抜いて入稿計画に載せる。<code>thumbnailFlg:'TRUE'</code> のサムネ画像は動画専用で、画像広告のメイン画像とは排他</td></tr>
           <tr><td><b>バナー(静止画・固定サイズ)</b></td><td><span class="pill green">API入稿 対応済</span></td><td>★★★</td><td>広告行の<b>広告タイプ列で「バナー」</b>を選ぶ（画像は形式列＝Card／SQ のまま、<b>レスポンシブと同じ画像プールを共用</b>）。API上は <code>BANNER_AD + mainMediaFormat:IMAGE</code>、画像は <b>operand 直下の <code>mediaId</code></b>。<b>タイトル/説明文/主体者/CTAはAPIフィールド自体が無い</b>（画像に焼き込み）。2026-08-19 に本番実機で add 成功・読み戻し検証済み</td></tr>
           <tr><td>カルーセル / テキスト</td><td><span class="pill gray">未使用</span></td><td>—</td><td>運用では使わない</td></tr>
         </tbody></table>
@@ -556,6 +580,21 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
 <span class="c">// 読み戻すと ad.responsiveAd === null になる</span></div>
       </div></details>
       </div>
+      <div id="yt-video" style="display:none">
+<details class="sec" open><summary><span class="num">1</span><span class="stitle">レスポンシブ動画 — 形式列で「動画」を選ぶ</span><span class="chev"></span></summary>
+      <div class="body">
+        <p class="lead">画像との違いは <b>素材の参照先</b> と <b>サムネイル</b> の 2 つだけ。広告タイプは「レスポンシブ」のまま、<b>形式列で「動画」</b>を選ぶ（API 上は <code>RESPONSIVE_AD + mainMediaFormat:VIDEO</code>）。タイトル・説明文・主体者・CTA は画像のレスポンシブと同じものを使う。</p>
+        <div class="callout"><b>サムネイル画像は必ず要る。</b> Yahoo は動画からサムネイルを自動生成しない（本番実測で確認済み）。サムネイルが無いと広告の作成そのものが失敗するので、プランナーが <b>動画の 0 秒フレームを抜いて</b>一緒に入稿する。</div>
+        <table class="g"><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody>
+          <tr><td>参照表</td><td><code>refs.media[番号].video</code>（動画 mediaID）と <code>.thumb</code>（サムネ mediaID）。画像の <code>.card</code>／<code>.sq</code> とは別枠で、<b>同じ管理番号に画像と動画がぶら下がる</b></td></tr>
+          <tr><td>未登録素材</td><td>広告行の<b>「動画パス」「サムネパス」</b>に計画JSON基準の相対パスを入れる。本実行の直前に CLI が <code>/yda/upload-video</code> へ上げて mediaID に解決する（dry-run では上げない）</td></tr>
+          <tr><td><b>動画の取り込み</b></td><td>形式=動画 の行でクリエイティブ番号セルの ▾ を押し、サイドバー最下部の <b>「＋ 新規登録」</b>を押す。モーダルで <b>① 保存フォルダ（<code>入稿計画/</code>）を選ぶ → ② 動画を選ぶ</b> の順に進めると、<b>動画パスと 0 秒サムネの両方が自動で入る</b>（素材は入稿計画フォルダの <code>素材/</code> に置かれる。保存フォルダは次回から自動でつながる）。<b>審査でサムネだけ落ちたときは、抽出位置（秒）を変えて取り直す</b></td></tr>
+          <tr><td>クリエイティブ名</td><td>形式記号は <code>v</code>（Card は <code>c</code>／SQ は <code>s</code>）。例 <code>957v-45L60-jv_Cac_148</code></td></tr>
+          <tr><td>できない組み合わせ</td><td><b>広告タイプ=バナー × 形式=動画</b>。入稿計画の書き出し前にエラーで止まる</td></tr>
+        </tbody></table>
+        <div class="callout">素材の置き場所は<b>入稿計画フォルダ配下の <code>素材/</code></b>。接続フォルダの外にある動画を選んだ場合はそこへコピーする（パスを自動で入れられるようにするため）。</div>
+      </div></details>
+      </div>
       <div id="yt-param" style="display:none">
 <details class="sec" open><summary><span class="num">1</span><span class="stitle">画面の入力項目（どこで何を設定するか）</span><span class="chev"></span></summary>
       <div class="body">
@@ -617,7 +656,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
           <li><b>プラン作成</b>：プランビューは「戦略メモ → 案件設定 → シート/ツリー切替」の順。シート選択時はさらに広告/広告グループ/キャンペーンのタブで編集する。AI が生成した state JSON は「JSON読込」で取り込む（旧v1形式も自動マイグレーション）。</li>
           <li><b>確認</b>：バリデーションバッジ（タイトル35字超・参照未解決・paramCode未払出）が緑になるまで修正。バナーは広告行の「広告タイプ」列で「バナー」を選ぶ（タイトル/説明文は無効化される。画像はレスポンシブと同じ Card／SQ を使う）。</li>
           <li><b>バージョン保存</b>：ヘッダーの「バージョン保存」。保存のたびに<b>常に新バージョン</b>（v1, v2…）として名称・メモ・作成者付きで保存される（上書きなし）。<b>履歴本体はブラウザ内に自動保存</b>されるため、フォルダ設定なしでも一覧・再読込できる。</li>
-          <li><b>保存フォルダ接続（初回に1回だけ）</b>：履歴ビューの「📁 保存フォルダに接続」でスキル同梱の <code>入稿計画/</code> フォルダを一度選ぶと、<b>次回からは開くだけで自動接続</b>され、保存のたびにファイルにも書き出される。未接続時はダウンロード動作。</li>
+          <li><b>保存フォルダ接続（初回に1回だけ）</b>：素材の「＋ 新規登録」のモーダル、または履歴ビューの「📁 保存フォルダに接続」でスキル同梱の <code>入稿計画/</code> フォルダを一度選ぶと（<code>入稿計画/</code> 以外のフォルダは接続できない）、<b>次回からは開くだけで自動接続</b>され、保存のたびにファイルにも書き出される。未接続時はダウンロード動作。</li>
           <li><b>履歴の確認・再利用</b>：履歴ビューで一覧（Ver/日時/媒体/名称）を確認し、「読込」で過去バージョンを復元、「編集」で名称・メモ変更、「削除」で破棄。</li>
           <li><b>入稿JSON書き出し</b>：ヘッダーの「入稿JSON書き出し」をワンクリック。アカウントID・目的・配信開始日は案件設定チップ、ターゲティングは広告グループ行の列から自動変換される（<code>*_入稿計画_*.json</code>）。</li>
           <li><b>入稿（dry-run → 本実行）</b>：<code>webgram submit-plan --plan-file &lt;入稿計画&gt;</code>。dry-run が全キャンペーンを一括検証 → OKなら <code>--no-dry-run --yes</code> で本実行（1キャンペーンずつ入稿・進捗書き戻しで中断後も再開可能）。実行後は管理画面の一覧でOK確認。</li>
@@ -802,6 +841,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
       <div class="toolbar2">
         <button class="act ghost" id="btnDupSel" title="選択した行を複製">⧉ 選択を複製</button>
         <button class="act ghost" id="btnSeqParam" style="display:none" title="選択した列（paramCode / 画像番号 / タイトル番号 / 説明文番号）を先頭セル基点に連番採番">🔢 連番</button>
+
         <span class="hinttxt">セル選択(クリック/Shift+クリック/ドラッグ)→ Cmd/Ctrl+C コピー・Cmd/Ctrl+V 貼付(1セルのコピーは選択範囲全体へ充填)／範囲選択のままプルダウン・入力欄を確定すると同じ列へ一括、ターゲティング列はサイドバーで一括ON/OFF</span>
       </div>
       <!-- シートタブと表示フィルタは同じ行に並べ、表の上辺に接合する (フォルダタブ風)。
@@ -878,7 +918,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
    （cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
    手で書き換えて放置するとテストが落ちる）。
    利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
-const APP_VERSION = '0.11.0'; /* version:sync */
+const APP_VERSION = '0.13.0'; /* version:sync */
 /* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
    同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
    固有名詞はハードコードせず、すべて外部JSON由来にする。 */
@@ -1140,6 +1180,11 @@ const EC = {
   CAMPAIGN_NAME_DUPLICATE:'CAMPAIGN_NAME_DUPLICATE'  /* 既存CPと同名。Google は同名を拒否する */,
   CAMPAIGN_NAME_DUPLICATE_IN_PLAN:'CAMPAIGN_NAME_DUPLICATE_IN_PLAN' /* 同じ計画の中で新規CP名が重複 */,
   LOCATION_EMPTY:'LOCATION_EMPTY'               /* 地域未指定。google は全世界配信 (warn) / bytedance は入稿不可 (err) */,
+  /* YDA レスポンシブ動画 固有 */
+  VIDEO_PATH_MISSING:'VIDEO_PATH_MISSING' /* 動画 mediaID 未登録なのに動画パスも未入力 = 上げるものが無い */,
+  THUMB_MISSING:'THUMB_MISSING'           /* YDA は動画からサムネを自動生成しないので必ず要る */,
+  VIDEO_PATH_IGNORED:'VIDEO_PATH_IGNORED' /* 動画 mediaID が解決済みなのにローカル動画パスも入力 (warn) */,
+  BANNER_VIDEO_UNSUPPORTED:'BANNER_VIDEO_UNSUPPORTED' /* 広告タイプ=バナー × 形式=動画 は未対応 */,
   /* ByteDance (TikTok) 固有 */
   IDENTITY_MISSING:'IDENTITY_MISSING'  /* 広告主として表示する TikTok アカウント未設定 = 広告が作れない */,
   IDENTITY_BC_MISSING:'IDENTITY_BC_MISSING' /* identityType=BC_AUTH_TT なのに BC ID が無い (実運用の identity はほぼ BC_AUTH_TT) */,
@@ -1307,24 +1352,34 @@ const REF_TABLES = {
       {label:'文字数', width:'70px', cls:(no,v)=>'reflen '+refLenCls(REF_TABLES.descriptions,v), cell:(no,v)=>glen(v)}
     ],
     optionLabel:v=>String(v==null?'':v) },
-  media:{ key:'media', label:'画像', countLabel:'登録画像', editable:true, required:true,
-    keyKind:'number', keyLabel:'画像番号', keyWidth:'80px',
-    addSub:'画像番号→Card/SQ の mediaID。新規作成した画像をメディアに登録',
-    emptyMsg:'該当する画像がありません',
+  media:{ key:'media', label:'クリエイティブ', countLabel:'登録クリエイティブ', editable:true, required:true,
+    keyKind:'number', keyLabel:'クリエイティブ番号', keyWidth:'110px',
+    addSub:'クリエイティブ番号→Card/SQ/動画 の mediaID。新規作成した素材をメディアに登録',
+    emptyMsg:'該当するクリエイティブがありません',
     /* YDA のメディアライブラリはアカウントに1つだけ (バナー専用プールは存在しない)。
        バナー広告もここの card / sq をそのまま使う。 */
+    /* video / thumb は **レスポンシブ動画広告** 用 (動画 mediaId とサムネ画像 mediaId の組)。
+       画像の card / sq と同じ番号を共有する = 1つの管理番号に画像・動画がぶら下がる。 */
     valueFields:[{k:'card',   label:'Card mediaID (1200)', editLabel:'Card mediaID'},
-                 {k:'sq',     label:'SQ mediaID (1080)',   editLabel:'SQ mediaID'}],
+                 {k:'sq',     label:'SQ mediaID (1080)',   editLabel:'SQ mediaID'},
+                 {k:'video',  label:'動画 mediaID',        editLabel:'動画 mediaID'},
+                 {k:'thumb',  label:'動画サムネ mediaID',  editLabel:'サムネ mediaID'}],
     keyCell:no=>'<td><span class="sw" style="display:inline-flex;width:26px;height:26px;vertical-align:middle">'+esc(no)+'</span> '+newBadge('media',no)+'</td>',
     columns:[
       {label:'Card mediaID (1200)', cls:'mono', cell:(no,v)=>esc(v&&v.card||'—')},
       {label:'SQ mediaID (1080)',   cls:'mono', cell:(no,v)=>esc(v&&v.sq||'—')},
+      {label:'動画 mediaID',        cls:'mono', cell:(no,v)=>esc(v&&v.video||'—')},
+      {label:'サムネ mediaID',      cls:'mono', cell:(no,v)=>esc(v&&v.thumb||'—')},
+      /* 番号が動画として登録されているなら動画のファイル名を出す (画像の固定名を見せない) */
       {label:'ファイル名', cls:'mono', style:'color:var(--faint);font-size:11px',
-       cell:no=>esc(no)+'-1200.jpg / '+esc(no)+'-1080.jpg'}
+       cell:(no,v)=>(v&&v.video)
+         ? esc(no)+'.mp4'+(v.thumb?(' / '+esc(no)+'-thumb.jpg'):'')
+         : esc(no)+'-1200.jpg / '+esc(no)+'-1080.jpg'}
     ],
-    optionLabel:v=>[v&&v.card?'Card':'', v&&v.sq?'SQ':''].filter(Boolean).join('/'),
+    optionLabel:v=>[v&&v.card?'Card':'', v&&v.sq?'SQ':'', v&&v.video?'動画':''].filter(Boolean).join('/'),
     /* ▼ドロワー(一覧)の1行テキスト。媒体ごとの値の見せ方はここだけが持つ */
-    drawerLabel:v=>'Card '+esc(v&&v.card||'—')+' ／ SQ '+esc(v&&v.sq||'—') },
+    drawerLabel:v=>'Card '+esc(v&&v.card||'—')+' ／ SQ '+esc(v&&v.sq||'—')
+      +(v&&v.video?(' ／ 動画 '+esc(v.video)):'') },
   adGroups:{ key:'adGroups', label:'広告グループ', countLabel:'広告グループ', editable:false, required:false,
     keyKind:'string', keyLabel:'広告グループID', keyWidth:'110px',
     emptyMsg:'既存の広告グループがありません（アカウントJSONの refs.adGroups）',
@@ -1434,9 +1489,14 @@ PLATFORMS.yda = {
      (アップロードは base64 のみ、広告作成は mediaId のみ)。
      → **バナーもレスポンシブも同じ画像プール (refs.media[番号].card / .sq) を共用する**。
      広告タイプ (RESPONSIVE_AD / BANNER_AD) は別の軸で、広告行の「広告タイプ」列 (ad.adKind) が持つ。 */
+  /* 動画 (VIDEO) は画像と同じ「形式」軸に並ぶ第3の値。広告タイプ (レスポンシブ/バナー) とは直交し、
+     レスポンシブ動画 = RESPONSIVE_AD + mainMediaFormat:VIDEO になる。
+     動画は Card/SQ のようなサイズ区分を持たない (1本の動画 mediaId + サムネ画像 mediaId の組)。 */
   mediaFormats:[
     {id:'Card',   crSuffix:'c', mediaKey:'card', apiMediaKind:'IMAGE', label:'Card mediaID (1200)'},
-    {id:'SQ',     crSuffix:'s', mediaKey:'sq',   apiMediaKind:'IMAGE', label:'SQ mediaID (1080)'}
+    {id:'SQ',     crSuffix:'s', mediaKey:'sq',   apiMediaKind:'IMAGE', label:'SQ mediaID (1080)'},
+    {id:'動画',   crSuffix:'v', mediaKey:'video', apiMediaKind:'VIDEO', label:'動画 mediaID',
+     thumbKey:'thumb'}
   ],
   /* 広告タイプがバナー (BANNER_AD) か。**サイズ(形式)ではなく ad.adKind で決まる**。
      (タイトル/説明文セルの無効化・広告名・入稿ボディのテキスト系省略の判定はすべてここを見る。
@@ -1445,6 +1505,9 @@ PLATFORMS.yda = {
      adKind:' バナー ' のような値で adType だけ BANNER_AD になり、
      テキスト系フィールドが入稿計画JSONに混入する。 */
   isBanner(ad){ return PLATFORMS.yda.mappers.adType((ad&&ad.adKind), PLATFORMS.yda)==='BANNER_AD'; },
+  /* 形式=動画 か。**広告タイプ (adKind) ではなく形式 (format) の軸**。
+     列の有効/無効・参照するメディアキー・入稿ボディの mediaType はすべてここを見る。 */
+  isVideo(ad){ return PLATFORMS.yda.fmtOf(ad).apiMediaKind==='VIDEO'; },
   fmtOf(ad){ const F=PLATFORMS.yda.mediaFormats; return F.find(x=>x.id===(ad&&ad.format)) || F[0]; },
 
   /* ---- 参照テーブル (S6 の REF_TABLES) ---- */
@@ -1557,7 +1620,8 @@ PLATFORMS.yda = {
     },
     /* C6: adName は空 = 自動生成 (naming.adName)。C1: imagePath は空 = 従来挙動 */
     /* adKind = 広告タイプ軸 (レスポンシブ / バナー)。format はサイズ軸 (Card / SQ) で直交する */
-    ad:{format:'Card', adKind:'レスポンシブ', imageNo:'', titleNo:'', descNo:'', imagePath:'', adName:'', desc2:''},
+    ad:{format:'Card', adKind:'レスポンシブ', imageNo:'', titleNo:'', descNo:'', imagePath:'',
+        videoPath:'', thumbnailPath:'', adName:'', desc2:''},
     /* S14: freq* は「案件設定チップの既定を新規CP作成時にコピーする」ので factories.newCampaign 側で入れる */
     campaign:{name:'新規キャンペーン', campaignId:'', isExisting:false, urlNumber:'',
       freqMode:'default', freqOn:false, freqLevel:'AD_GROUP', freqUnit:'WEEK', freqCount:3}
@@ -1621,7 +1685,7 @@ PLATFORMS.yda = {
     }
   },
   /* 「クリエイティブをクリア」対象フィールド */
-  creativeFields:['imageNo','titleNo','descNo','imagePath'],
+  creativeFields:['imageNo','titleNo','descNo','imagePath','videoPath','thumbnailPath'],
   /* AG の 未反映列 (入稿JSONに載らない = tgDropped 警告の対象)。
      C7: オーディエンス/配置は実ID入稿に対応したので **未反映列から外した** */
   notSubmittedFields:['tg_region','tg_searchKw'],
@@ -1635,7 +1699,8 @@ PLATFORMS.yda = {
            + '<span class="chip">'+esc(c.biddingStrategy||p.biddingStrategyDefault)+' <b>'+esc((c.tcpa??p.tcpaDefault))+'</b></span>';
     },
     groupBadges(g){ return '<span class="pill mono">【'+esc(g.paramCode||'—')+'】</span>'; },
-    adBadge(a, r){ return '<span class="cbadge">'+esc(a.imageNo||'—')+(a.format||'Card')[0].toLowerCase()+'</span>'; },
+    /* 形式記号は mediaFormats.crSuffix が正 (c / s / v)。format の1文字目を取ると「動画」が「動」になる */
+    adBadge(a, r){ return '<span class="cbadge">'+esc(a.imageNo||'—')+esc(PLATFORMS.yda.fmtOf(a).crSuffix)+'</span>'; },
     adSub(a, r){ return r.isBanner ? 'バナー' : esc(a.titleNo)+'L'+esc(a.descNo); },
     /* バナーにはタイトルが存在しない。シート側は「—」で無効化しているのに
        ツリーが「(未入力)」と出すと「埋めるべき欄」に見えるので別表記にする。 */
@@ -1652,11 +1717,20 @@ PLATFORMS.yda = {
     const autoAdName=P.naming.adName(ad, group, crName, p);
     const adName=String(ad.adName||'').trim() || autoAdName;
     const me = refs.media[String(ad.imageNo)];
-    const mediaId = me ? me[fmt.mediaKey] : undefined;
+    /* 参照表の編集モーダル (refEdit) は空欄を **空文字で保存する** ので、'' も未登録として扱う。
+       undefined だけを見ていると ID が空のまま「登録済み」と判定され、警告も出ずに
+       mediaIds:[''] の計画が書き出されて dry-run も通る。YDA には自動ロールバックが無いので、
+       本実行では CP と広告グループだけが残る。Meta の resolve と同じ判定に揃えている。 */
+    const mediaId = (me ? me[fmt.mediaKey] : undefined) || undefined;
     /* バナー広告 (BANNER_AD) はタイトル/説明文のAPI項目が存在しない (画像に焼き込む運用) ので、
        参照も検証もしない。セル自体も列記述子の col.disabled で無効化している。
        判定は「広告タイプ」列 (ad.adKind) — 画像サイズ (Card/SQ) とは独立した軸。 */
     const isBanner = P.isBanner(ad);
+    /* 形式=動画 のときは動画 mediaId (me.video) とサムネ mediaId (me.thumb) の組で解決する。
+       サムネは YDA が自動生成しないので、mediaId かローカルパスのどちらかが必ず要る。 */
+    const isVideo = P.isVideo(ad);
+    // mediaId と同じ理由で '' も未登録として扱う（サムネ未設定のまま入稿されるのを防ぐ）
+    const thumbId = ((isVideo && me) ? me[fmt.thumbKey] : undefined) || undefined;
     const titleText = isBanner ? undefined : refs.titles[ad.titleNo];
     const descText = isBanner ? undefined : (refs.descriptions||{})[ad.descNo]; // A-5: 説明文テーブルのみ参照 (titlesへのフォールバックなし)
     const finalUrl = P.naming.finalUrl(ad, group, adName, p);
@@ -1681,11 +1755,27 @@ PLATFORMS.yda = {
     // B11: paramCode空はエラー(export対象外・URL生成に必須)。F-6: refs.groups 払出判定は廃止。
     /* C8: URLパラメータ OFF の案件では paramCode 自体が不要 (列も隠す) のでエラーにしない */
     if(p.urlParams!==false && String(group.paramCode||'').trim()==='') pushErr('paramCode未入力', EC.PARAM_CODE_EMPTY);
-    if(pendingImage) pushWarn('画像未登録（要アップロード）', EC.MEDIA_MISSING); // errではなくwarn: 新規作成対象として保持
+    if(pendingImage) pushWarn(isVideo?'動画未登録（要アップロード）':'画像未登録（要アップロード）', EC.MEDIA_MISSING); // errではなくwarn: 新規作成対象として保持
+    /* 動画 (レスポンシブ動画) の検証。画像とは要求が違う:
+       ・動画 mediaId も動画パスも無ければ **上げるものが無い** → err (TikTok と同じ。画像の warn 止まりとは違う)
+       ・**サムネは必須**。YDA は動画からサムネを自動生成しないので (本番実測)、
+         mediaId かローカルパスのどちらかが無いと広告作成が R0001 で落ちる
+       ・バナー × 動画 は backend の zod が弾く組み合わせ。dry-run より手前で気づけるよう err にする */
+    const videoPath=String(ad.videoPath||'').trim();
+    const thumbnailPath=String(ad.thumbnailPath||'').trim();
+    if(isVideo){
+      if(isBanner) pushErr('バナー×動画は未対応', EC.BANNER_VIDEO_UNSUPPORTED);
+      if(imgNoStr!=='' && pendingImage && videoPath==='') pushErr('動画パス未入力（動画mediaID未登録）', EC.VIDEO_PATH_MISSING);
+      if(!pendingImage && videoPath!=='') pushWarn('動画パス無視（動画mediaIDが解決済み）', EC.VIDEO_PATH_IGNORED);
+      /* サムネのローカルパスは **動画を上げるときにしか送れない** (CLI は upload-video の multipart に
+         添える形でしか受け取らない)。動画 mediaID が解決済みの行では thumb mediaID が無いと入稿できない。 */
+      if(imgNoStr!=='' && thumbId===undefined && (thumbnailPath==='' || !pendingImage))
+        pushErr(pendingImage?'サムネ未設定（動画広告に必須）':'サムネ mediaID 未登録（動画が登録済みの行ではパスを使えません）', EC.THUMB_MISSING);
+    }
     // C6-1: 未登録画像なのにローカル画像パス未入力 = 入稿時にアップロード元が無い。
     //       ただし err にはしない (CLI/agent が後から imagePaths を補完する運用と共存する)
-    const imagePaths=String(ad.imagePath||'').split(',').map(s=>s.trim()).filter(Boolean);
-    if(pendingImage && imagePaths.length===0) pushWarn('画像パス未入力', EC.IMAGE_PATH_MISSING);
+    const imagePaths=isVideo?[]:String(ad.imagePath||'').split(',').map(s=>s.trim()).filter(Boolean);
+    if(!isVideo && pendingImage && imagePaths.length===0) pushWarn('画像パス未入力', EC.IMAGE_PATH_MISSING);
     /* 逆に mediaID が解決済みの広告に画像パスを足しても、その画像は広告には使われない
        (CLI はアップロードした mediaId を末尾に **追記** し、backend は mediaIds[0] しか見ない)。
        黙って古い画像で入稿されるのが最悪なので、書き出しでは落とし、ここで警告する。
@@ -1694,7 +1784,8 @@ PLATFORMS.yda = {
     // F-6: ID解決は adGroupId ベース。campaignId は idsCell表示用に持たない(親CP参照は呼び出し側)
     const aid=String(group.adGroupId||'').trim();
     return {crName, adName, autoAdName, imagePaths, campaignId:'', adGroupId:aid, mediaKind:fmt.apiMediaKind,
-      adType:P.mappers.adType(ad.adKind, P), isBanner, imageNo:imgNoStr,
+      adType:P.mappers.adType(ad.adKind, P), isBanner, isVideo, imageNo:imgNoStr,
+      videoPath, thumbnailPath, thumbId:thumbId||'',
       mediaId:mediaId||'', pendingImage, titleText:titleText===undefined?'':titleText,
       descText:descText===undefined?'':descText, finalUrl, errs, warns, errCodes, warnCodes, resolvedGroup:!!aid};
   },
@@ -1785,7 +1876,9 @@ PLATFORMS.yda = {
       const ad={
         adName:r.adName,
         status:P.mappers.status(g.deliveryStatus||p.deliveryStatus, P),
-        mediaType:'IMAGE',            // 画像広告 (backend ydaAdSchema IMAGE)。バナーもメイン形式は IMAGE
+        /* 形式 (Card/SQ/動画) 由来。画像広告は IMAGE (バナーもメイン形式は IMAGE)、
+           レスポンシブ動画は VIDEO (backend ydaAdSchema mediaType)。 */
+        mediaType:r.mediaKind,
         adType:r.adType,
         finalUrl:r.finalUrl           // 実データ準拠 (?ad=paramCode&creative=...)
       };
@@ -1798,6 +1891,17 @@ PLATFORMS.yda = {
         ad.principal=p.principal||'';    // E-1: 主体者はアカウントJSON由来 (st.project.principal)
         ad.buttonText=P.mappers.cta(p.cta, P); // CTA(案件設定)→ YDA buttonText enum。入稿ADD必須
       }
+      /* レスポンシブ動画 (mediaType:VIDEO)。画像の mediaIds ではなく videoMediaId + thumbnailMediaId を送る。
+         未登録なら videoPath / thumbnailPath を残し、CLI が本実行の直前に /yda/upload-video へ上げて
+         両IDに解決する (dry-run では上げない)。**IDとパスを同時に載せない** — 載せると CLI が
+         余計にアップロードして、広告には古いIDが使われる (画像側で踏んだのと同じ罠)。 */
+      if(r.isVideo){
+        if(r.pendingImage){ ad.videoPath=r.videoPath; ad.imageNo=r.imageNo; ad.pendingImageNo=r.imageNo; }
+        else ad.videoMediaId=String(r.mediaId);
+        if(r.thumbId) ad.thumbnailMediaId=String(r.thumbId);
+        else if(r.thumbnailPath) ad.thumbnailPath=r.thumbnailPath;
+        return ad;
+      }
       if(r.pendingImage){
         // 未登録画像: mediaId未確定。管理番号を残し CLI が先にアップロードして解決する
         // C6-1: 画像パス列 (カンマ区切り) を imagePaths に展開する。空なら [] のまま (agent/CLI が補完)
@@ -1907,7 +2011,8 @@ PLATFORMS.yda = {
     }
   },
   docTabs:[{id:'overview',label:'概要'},{id:'resp',label:'レスポンシブ'},
-           {id:'banner',label:'バナー'},{id:'param',label:'パラメータ'},{id:'guide',label:'運用手順'}]
+           {id:'banner',label:'バナー'},{id:'video',label:'動画'},
+           {id:'param',label:'パラメータ'},{id:'guide',label:'運用手順'}]
 };
 
 /* 宣言に載せない旧テーブル。resolveGroupIds/maxParamNum が参照中のため S11 の撤去まで温存する。 */
@@ -2085,6 +2190,7 @@ function initialState(){
       campaigns.forEach(c=>{ c.uid=uid('c'); (c.adGroups||[]).forEach(g=>{ g.uid=uid('g'); (g.ads||[]).forEach(a=>{ a.uid=uid('a'); }); }); });
       migrateArticleSlug(campaigns); // C8: 旧 articleSlug / articleUrl を除去
       migratePlatformValues(campaigns); // 媒体側の旧値を現行の語彙へ
+      project.localMedia=samplePlanLocalMedia();
     }
   }
   return {schemaVersion:SCHEMA_VERSION, meta:defaultMeta(), project, refs, campaigns, ui:{expanded:{}}};
@@ -2603,7 +2709,9 @@ function refEdit(tableKey,no){
       value:single?cur:((cur||{})[fd.k]||'')})),
     onOk:v=>{ refCommit(()=>{
       if(single){ store[no]=v[T.valueFields[0].k]; return; }
-      const e={}; T.valueFields.forEach(fd=>{ e[fd.k]=String(v[fd.k]).trim(); }); store[no]=e;
+      /* 空欄は **キーごと落とす**。空文字を入れると resolve が「登録済み」と誤判定し、
+         ID が空のまま入稿されて広告作成で落ちる (作りかけの CP が残る)。 */
+      const e={}; T.valueFields.forEach(fd=>{ const sv=String(v[fd.k]).trim(); if(sv!=='') e[fd.k]=sv; }); store[no]=e;
     }, '更新しました'); }});
 }
 function refDel(tableKey,no){
@@ -2729,10 +2837,11 @@ const COLS = {
   ads:[
     /* 形式 = **画像のサイズ軸** (Card=1200x628 / SQ=1080x1080)。参照表 refs.media[番号].card / .sq を引く。
        広告タイプ (レスポンシブ/バナー) とは直交する軸で、バナーも同じ画像プールを使う。 */
-    {field:'format',      label:'形式',                kind:'optpick',  options:['Card','SQ'], width:'72px',
-     title:'画像のサイズ。参照表の Card / SQ mediaID を引きます（バナーも同じ画像プールを使います）',
-     coerce:v=>{ const s=String(v).trim().toUpperCase();
-       if(s==='SQ') return 'SQ';
+    {field:'format',      label:'形式',                kind:'optpick',  options:['Card','SQ','動画'], width:'72px',
+     title:'素材の種類。Card / SQ は画像のサイズ（バナーも同じ画像プールを使います）、動画はレスポンシブ動画広告',
+     coerce:v=>{ const s=String(v).trim(), u=s.toUpperCase();
+       if(s==='動画'||u==='VIDEO') return '動画';
+       if(u==='SQ') return 'SQ';
        return 'Card'; }},
     /* 広告タイプ = **RESPONSIVE_AD / BANNER_AD の軸**。行単位で切り替えるので同一キャンペーン内に混在できる。
        バナー行はタイトル/説明文のセルが col.disabled で無効化される (PLATFORMS.yda.isBanner)。 */
@@ -2741,9 +2850,9 @@ const COLS = {
      get:row=>row.adKind||'レスポンシブ',
      coerce:v=>{ const s=String(v).trim();
        return (s==='バナー'||s.toUpperCase()==='BANNER'||s.toUpperCase()==='BANNER_AD')?'バナー':'レスポンシブ'; }},
-    {field:'imageNo',     label:'画像番号',            kind:'refcombo', refTable:'media',        drawerType:'media',  mediaAxis:'format',
+    {field:'imageNo',     label:'クリエイティブ番号',  kind:'refcombo', refTable:'media',        drawerType:'media',  mediaAxis:'format',
      width:'6ch',  sequenceable:true, errCodes:[EC.IMAGE_UNRESOLVED],
-     ghostKey:'media', ddTitle:'登録画像から選択', ghostTitle:r=>'メディアID '+r.mediaId,
+     ghostKey:'media', ddTitle:'登録クリエイティブから選択', ghostTitle:r=>'メディアID '+r.mediaId,
      ghost:(r,a)=>{ if(!a.imageNo) return '<span class="idpill" style="color:var(--faint)">—</span>';
        if(r.mediaId!=='') return '<span class="idpill">ID '+esc(r.mediaId)+'</span>';
        if(r.pendingImage) return '<span class="idpill warn" title="アカウント未登録。入稿前にアップロードして新規登録">🆕未登録</span>';
@@ -2784,7 +2893,25 @@ const COLS = {
        disabledTitle:'バナー広告（BANNER_AD）には説明文のAPI項目がありません（画像に焼き込み）'}),
     /* C6-1: 量産時のローカル画像パス担体 (カンマ区切りで複数可)。少数入稿は Skill の画像入稿フローが主導線 */
     {field:'imagePath',   label:'画像パス',            kind:'mono',     width:'150px',
+     disabled:it=>it.kind==='a' && PLATFORMS.yda.isVideo(it.a),
+     disabledTitle:'形式=動画の行では画像パスを使いません（動画パス / サムネパスを使います）',
      title:'ローカル画像の絶対 / ~/… / 計画JSON基準の相対パス。カンマ区切りで複数可。※画像番号が参照表で解決できる行では入稿JSONに載りません（差し替えたいときは画像番号を空に）'},
+    /* 形式=動画 のローカル素材パス。**クリエイティブ番号の右サイドバー「＋ 新規登録」から選ぶと、
+       動画パスと 0 秒サムネ (自動抽出→接続フォルダへ書き出し) の両方が自動で入る**。手入力も可。
+       本実行の直前に CLI が /yda/upload-video へ上げて videoMediaId / thumbnailMediaId に解決する
+       (dry-run では上げない)。動画 mediaID が参照表で解決済みの行では入稿JSONに載らない。 */
+    {field:'videoPath',   label:'動画パス',            kind:'mono',     width:'150px',
+     disabled:it=>it.kind==='a' && !PLATFORMS.yda.isVideo(it.a),
+     disabledTitle:'形式が「動画」の行だけで使います',
+     errCodes:[EC.VIDEO_PATH_MISSING],
+     title:'ローカル動画の絶対 / ~/… / 計画JSON基準の相対パス。※動画 mediaID が参照表で解決できる行では入稿JSONに載りません'},
+    /* 動画広告のサムネイル画像。YDA は **動画からサムネを自動生成しない** (本番実測) ので、
+       0 秒フレームを抽出した画像を必ず一緒に入稿する必要がある。 */
+    {field:'thumbnailPath', label:'サムネパス',        kind:'mono',     width:'150px',
+     disabled:it=>it.kind==='a' && !PLATFORMS.yda.isVideo(it.a),
+     disabledTitle:'形式が「動画」の行だけで使います',
+     errCodes:[EC.THUMB_MISSING],
+     title:'動画サムネイル画像のパス。クリエイティブ番号のサイドバー「＋ 新規登録」で動画を選ぶと、0 秒フレームを自動抽出して埋まります（審査で落ちたときだけ差し替える）'},
     /* C6: 広告名は自由入力 (空 = 自動生成)。placeholder に自動生成値を出す */
     {field:'adName',      label:'広告名',              kind:'mono',     width:'170px',
      title:'空欄なら自動生成（レスポンシブ: {画像番号}{c|s}-{タイトル番号}L{説明文番号}-{paramCode} ／ バナー: {画像番号}{c|s}-{paramCode}）。手入力すると最終リンク先URLの creative= も変わります',
@@ -5161,7 +5288,9 @@ function applySequentialParamCodes(){
     const m=String(rows[0].a[sc.field]||'').trim().match(/^(.*?)(\d+)\s*$/);
     if(!m){ toast('基点の'+lbl+'を先頭セルに入力してください（例 954）'); return; }
     const prefix=m[1], startNum=parseInt(m[2],10), width=m[2].length;
-    mutate(()=>{ rows.forEach((it,i)=>{ if(i===0) return; it.a[sc.field]=prefix+String(startNum+i).padStart(width,'0'); }); });
+    mutate(()=>{ rows.forEach((it,i)=>{ if(i===0) return; it.a[sc.field]=prefix+String(startNum+i).padStart(width,'0');
+      /* この計画で新規登録した番号になったら、その素材のパスも入れる */
+      if(sc.field==='imageNo') applyLocalMediaPaths(it, it.a[sc.field]); }); });
     toast((rows.length-1)+'件の'+lbl+'に連番を採番しました（'+prefix+(startNum+1)+'〜）');
   }
 }
@@ -5451,18 +5580,101 @@ function renderDrawer(){
   const rkey=(dcol&&dcol.refTable) || (drawerTarget.type==='titles'?'titles':'media');
   const T=refTableDef(rkey)||{}, store=st.refs[rkey]||{};
   const single=!!(T.valueFields&&T.valueFields.length===1);
-  titleEl.textContent = single ? ((T.label||'')+'一覧（文言ライブラリ）') : ((T.countLabel||T.label||'')+' 一覧');
+  /* 素材の一覧は **その行の形式に合うものだけ** 出す。動画行に画像しか持たない番号を
+     並べても選べないため。形式ごとの参照キー (YDA=card/sq/video ／ Meta・Google=image/video
+     ／ TikTok=video) は媒体定義の mediaFormats が持つので、コアは mediaKey だけを見る。 */
+  const isMedia = rkey==='media';
+  const fmt = (isMedia && fa) ? pf().fmtOf(fa.a) : null;
+  const hasFmt = v => !fmt || !fmt.mediaKey || String((v||{})[fmt.mediaKey]||'').trim()!=='';
+  titleEl.textContent = single ? ((T.label||'')+'一覧（文言ライブラリ）')
+    : ((T.countLabel||T.label||'')+' 一覧'+(fmt?('（'+fmt.id+'）'):''));
   let html='';
   refSortedKeys({keyKind:'number'},store).forEach(no=>{
     const v=store[no];
     if(T.dropEmpty && String(v==null?'':v).trim()==='') return;
+    if(isMedia && !hasFmt(v)) return;
     if(q && !refSearchStrings(T,no,v).some(s=>s.includes(q))) return;
     const txt = T.drawerLabel ? T.drawerLabel(v) : esc(String(v==null?'':v));
     html+='<div class="ddrow'+(String(no)===curNo?' cur':'')+'" data-no="'+esc(no)+'">'
       +(single?'':thumbImgHtml(no))+'<span class="ddno">'+esc(no)+'</span>'
       +(single?'':newBadge(rkey,no))+'<span class="ddtx">'+txt+'</span></div>';
   });
-  listEl.innerHTML=html||'<div class="empty" style="padding:24px">該当なし</div>';
+  /* この計画で新しく登録した素材。**まだ媒体に上がっていないので mediaID が無く、refs には入れない**
+     (空の ID を入れると「登録済み」と誤判定され、CLI のアップロードが走らない)。
+     一覧には出して、2行目以降でも同じ番号を選べるようにする。 */
+  if(isMedia) pendingMediaNos().forEach(no=>{
+    if(q && !String(no).includes(q)) return;
+    const lm=((st.project&&st.project.localMedia)||{})[no];
+    /* 種類 (動画 / 画像) が行と違う素材は出さない */
+    if(lm && fmt && ((fmt.apiMediaKind==='VIDEO') !== !!lm.video)) return;
+    const thumb=lm ? (lm.thumb||lm.image) : '';
+    html+='<div class="ddrow'+(String(no)===curNo?' cur':'')+'" data-no="'+esc(no)+'">'
+      +(thumb?'<img class="ddthumb" data-localthumb="'+esc(thumb)+'" alt="">':'')
+      +'<span class="ddno">'+esc(no)+'</span>'
+      +'<span class="idpill warn">🆕未登録</span>'
+      +'<span class="ddtx">'+(lm&&lm.file?esc(lm.file)+'　':'')+'この計画で追加（入稿時にアップロードします）</span></div>';
+  });
+  listEl.innerHTML=seqRowHtml()+(html||'<div class="empty" style="padding:24px">該当なし</div>')
+    + ((isMedia && newMediaFields(fmt)) ? newMediaRowHtml() : '');
+  hydrateLocalThumbs(listEl);
+}
+
+/** サイドバー末尾の1行。**素材の置き場所が無いと登録できない**ので、
+    未接続のときは登録ではなく接続を促す（ヘッダーに接続ボタンは無く、履歴ビューの奥にある）。 */
+/** 複数行を選んでいるとき、サイドバーの先頭に「連番」を出す (ツールバーの 🔢 連番 と同じ処理) */
+function seqRowHtml(){
+  const btn=document.getElementById('btnSeqParam');
+  if(!btn || btn.style.display==='none') return '';
+  const sc=seqColInfo(); if(!sc) return '';
+  return '<div class="ddrow ddseq" data-seq="1"><span class="ddno">🔢</span>'
+    +'<span class="ddtx">選択した行の'+esc(sc.label)+'を連番にする<span class="sm" style="color:var(--faint)">　先頭のセルの番号から</span></span></div>';
+}
+function newMediaRowHtml(){
+  if(!fsSupported)
+    return '<div class="ddrow ddnew" style="cursor:default;color:var(--faint)">'
+      + '<span class="ddno">—</span><span class="ddtx">このブラウザでは素材を登録できません'
+      + '（Chrome 系で開いてください）</span></div>';
+  /* 保存フォルダの接続は「＋ 新規登録」のモーダル (openNewMediaWizard) の中で案内する */
+  return '<div class="ddrow ddnew" data-newmedia="1"><span class="ddno">＋</span>'
+    + '<span class="ddtx">新規登録（手元のファイルから）'
+    + (dirHandle ? '<span class="sm" style="color:var(--faint)">　保存先: '+esc(dirHandle.name)+'/</span>' : '')
+    + '</span></div>';
+}
+
+/** 新規登録で使う**パス列**。素材を置いてもパスを入れる先が無い媒体・形式では登録させない
+    (入れ先が無いまま番号だけ入ると、入稿時にアップロード元が見つからない)。
+    列は field 名で引く — 媒体ごとに名前が違う (YDA/Meta=thumbnailPath ／ TikTok=coverImagePath)。 */
+function newMediaFields(fmt){
+  if(!fmt) return null;
+  const has=f=>colDefs('ads').some(c=>c.field===f);
+  if(fmt.apiMediaKind==='VIDEO'){
+    if(!has('videoPath')) return null;
+    const thumb=has('thumbnailPath')?'thumbnailPath':(has('coverImagePath')?'coverImagePath':'');
+    return thumb ? {video:'videoPath', thumb} : null;   // サムネの置き場が無ければ登録させない
+  }
+  return has('imagePath') ? {image:'imagePath'} : null;
+}
+
+/** 計画内で使われているが参照表に無い管理番号 = 新規登録してまだ上げていない素材。 */
+function pendingMediaNos(){
+  const store=st.refs.media||{}, seen=new Set();
+  st.campaigns.forEach(c=>(c.adGroups||[]).forEach(g=>(g.ads||[]).forEach(a=>{
+    const no=String(a.imageNo||'').trim();
+    if(no!=='' && !store[no]) seen.add(no);
+  })));
+  Object.keys((st.project&&st.project.localMedia)||{}).forEach(no=>{ if(!store[no]) seen.add(no); });
+  return [...seen].sort((a,b)=>Number(a)-Number(b));
+}
+
+/** 空き番号 = 参照表と計画内で使われている番号の最大値 +1。
+    ⚠ `Math.max(...nums)` は使わない — 引数がスタックに積まれるので、
+    参照表が大きいアカウントで `Maximum call stack size exceeded` になる。 */
+function nextMediaNo(){
+  let max=0;
+  Object.keys(st.refs.media||{}).concat(pendingMediaNos()).forEach(k=>{
+    const n=Number(k); if(Number.isFinite(n) && n>max) max=n;
+  });
+  return String(max+1);
 }
 /* ============ 素材サムネ (#157) ============
    媒体側の画像URLはどれも一時URL・CORS 制限つきで、プランナーから直接は表示できない。
@@ -5541,8 +5753,10 @@ function drawerPick(no){
   const compat = compatColsFor(drawerTarget.type, sheetTab);
   const rg=selRange(); let applied=0;
   mutate(()=>{
-    if(rg){ const vis=flatVisible(); for(let rr=rg.r0; rr<=rg.r1; rr++){ const item=vis[rr]; if(!item) continue; for(let cc=rg.c0; cc<=rg.c1; cc++){ if(compat.indexOf(cc)>=0){ setVar(item,cc,num); applied++; } } } }
-    if(applied===0){ setField(drawerTarget.u,f,num); applied=1; }
+    /* この計画で新規登録した番号なら、番号に紐づくローカル素材のパスも一緒に入れる */
+    const withPaths=item=>{ if(drawerTarget.type==='media') applyLocalMediaPaths(item, no); };
+    if(rg){ const vis=flatVisible(); for(let rr=rg.r0; rr<=rg.r1; rr++){ const item=vis[rr]; if(!item) continue; for(let cc=rg.c0; cc<=rg.c1; cc++){ if(compat.indexOf(cc)>=0){ setVar(item,cc,num); withPaths(item); applied++; } } } }
+    if(applied===0){ setField(drawerTarget.u,f,num); const fa=findAd(drawerTarget.u); if(fa) withPaths({kind:'a',a:fa.a,g:fa.g,c:fa.c}); applied=1; }
   });
   toast('番号 '+no+' を'+applied+'セルに入力');
   closeDrawer();
@@ -5842,9 +6056,16 @@ function openModal(cfg){
   const getVals=()=>{ const o={}; (cfg.fields||[]).forEach(f=>{ const el=document.getElementById(fid(f.key)); if(!el) return; o[f.key]= f.type==='check'? el.checked : el.value; }); return o; };
   const setVal=(k,val)=>{ const el=document.getElementById(fid(k)); if(el) el.value=val; };
   const close=()=>root.innerHTML='';
-  root.querySelector('[data-mo="cancel"]').addEventListener('click',close);
-  root.querySelector('.overlay').addEventListener('mousedown',ev=>{ if(ev.target.classList.contains('overlay')) close(); });
-  root.querySelector('[data-mo="ok"]').addEventListener('click',()=>{ const v=getVals(); close(); if(cfg.onOk) cfg.onOk(v); });
+  /* onCancel: 閉じたときの後片付け (プレビュー用の ObjectURL の解放など) */
+  const bail=()=>{ close(); if(cfg.onCancel) cfg.onCancel(); };
+  root.querySelector('[data-mo="cancel"]').addEventListener('click',bail);
+  root.querySelector('.overlay').addEventListener('mousedown',ev=>{ if(ev.target.classList.contains('overlay')) bail(); });
+  root.querySelector('[data-mo="ok"]').addEventListener('click',()=>{
+    const v=getVals();
+    /* validate: 空文字なら通す / メッセージを返したら **閉じずに** 差し戻す */
+    if(cfg.validate){ const msg=cfg.validate(v); if(msg){ toast(msg); return; } }
+    close(); if(cfg.onOk) cfg.onOk(v);
+  });
   if(cfg.onMount) cfg.onMount(root, getVals, setVal);
   const first=root.querySelector('input,select,textarea'); if(first) first.focus();
 }
@@ -5909,13 +6130,66 @@ let _idbPromise=null;
 function idb(){ if(!_idbPromise) _idbPromise=idbOpen(IDB_NAME).then(async db=>{ await migrateLegacyIdb(db); return db; }); return _idbPromise; }
 async function idbSet(k,v){ const db=await idb(); return new Promise((res,rej)=>{ const tx=db.transaction('handles','readwrite'); tx.objectStore('handles').put(v,k); tx.oncomplete=res; tx.onerror=()=>rej(tx.error); }); }
 async function idbGet(k){ const db=await idb(); return new Promise((res,rej)=>{ const tx=db.transaction('handles','readonly'); const rq=tx.objectStore('handles').get(k); rq.onsuccess=()=>res(rq.result); rq.onerror=()=>rej(rq.error); }); }
-async function connectFolder(){
-  if(!fsSupported){ toast('このブラウザはフォルダ連携非対応です（保存はダウンロード動作）'); return; }
+/* ---- 入稿計画フォルダかどうかの判定 ----
+   このフォルダは 素材/ の置き場所であり、「保存して入稿」で入稿計画ファイルを書き出す先でもある。
+   保存後の入稿手順は `入稿計画/<file>` にある前提で CLI を案内し、CLI は計画ファイルの場所を基準に
+   素材/ を探すので、**別のフォルダに接続すると本実行のアップロードまで誰も気づけない**。
+   そのため 入稿計画/ 以外には接続させない。
+   判定: 目印ファイル (PLANS_MARKER) があるか、フォルダ名が 入稿計画 か。
+   名前で通すのは目印の無い旧配布物のためで、そのときは目印を足して以後は目印で判定する。 */
+const PLANS_DIR_NAME='入稿計画';
+const PLANS_MARKER='.ad-planner-plans';
+async function checkPlansDir(h){
+  try{ await h.getFileHandle(PLANS_MARKER); return {ok:true}; }catch(e){}
+  if(h.name===PLANS_DIR_NAME){
+    try{ const fh=await h.getFileHandle(PLANS_MARKER,{create:true});
+      await writeToHandle(fh,'ad-planner の入稿計画フォルダの目印です。消さないでください。\n'); }catch(e){}
+    return {ok:true};
+  }
+  return {ok:false, reason:'選んだフォルダ「'+h.name+'」は入稿計画フォルダではありません。'
+    +(plannerEnv.plansDir ? '下のパスのフォルダを選んでください' : 'ad-ops スキルの中にある「'+PLANS_DIR_NAME+'」フォルダを選んでください')};
+}
+/* ブラウザはフォルダの絶対パスを知る手段が無いので、配信元の adops.sh planner が書いた
+   .planner-env.json から 入稿計画/ の場所を読んで案内に使う。別の方法で開いたときは無い。 */
+/* 読むのは「＋ 新規登録」を押したときだけ。起動時に読むと、ファイルの無い環境 (CI・adops.sh を通さない開き方)
+   で 404 がコンソールエラーとして出て、「起動時に JS エラーが出ない」系のテストが一斉に落ちる */
+let plannerEnv={}, plannerEnvLoaded=false;
+async function loadPlannerEnv(){
+  if(plannerEnvLoaded) return; plannerEnvLoaded=true;
+  try{ const r=await fetch('.planner-env.json',{cache:'no-store'}); if(r.ok) plannerEnv=(await r.json())||{}; }catch(e){}
+}
+async function adoptPlansDir(h){
+  dirHandle=h; pendingDirHandle=null; await idbSet('dir',h); renderHist(); updateSubmitJsonBtn();
+}
+/** 入稿計画フォルダを選んで接続する。**クリック起点で呼ぶ** (ピッカーと権限の再要求はユーザー操作が要る)。
+    入稿計画フォルダでなければ接続しない。fresh=true なら記憶中のフォルダの再許可を飛ばして選び直させる。
+    @returns {{ok:boolean, name?:string, reconnected?:boolean, aborted?:boolean, reason?:string}} */
+async function pickPlansFolder(fresh){
+  if(!fsSupported) return {ok:false, reason:'このブラウザはフォルダ連携に未対応です（Chrome 系で開いてください）'};
   try{
-    if(pendingDirHandle){ const p=await pendingDirHandle.requestPermission({mode:'readwrite'}); if(p==='granted'){ dirHandle=pendingDirHandle; pendingDirHandle=null; renderHist(); toast('保存フォルダに再接続しました'); return; } }
-    dirHandle=await window.showDirectoryPicker({id:'ad-planner-plans', mode:'readwrite'});
-    pendingDirHandle=null; await idbSet('dir',dirHandle); renderHist(); updateSubmitJsonBtn(); toast('保存フォルダに接続しました: '+dirHandle.name);
-  }catch(e){ if(e && e.name!=='AbortError') toast('フォルダ接続に失敗: '+e.message); }
+    if(pendingDirHandle && !fresh){
+      const h=pendingDirHandle;
+      const p=await h.requestPermission({mode:'readwrite'});
+      if(p==='granted'){
+        const c=await checkPlansDir(h);
+        if(!c.ok){ pendingDirHandle=null; return {ok:false, reason:c.reason}; } // 記憶していたのが別のフォルダ
+        await adoptPlansDir(h); return {ok:true, name:h.name, reconnected:true};
+      }
+    }
+    const h=await window.showDirectoryPicker({id:'ad-planner-plans', mode:'readwrite'});
+    const c=await checkPlansDir(h);
+    if(!c.ok) return {ok:false, reason:c.reason};
+    await adoptPlansDir(h); return {ok:true, name:h.name};
+  }catch(e){
+    if(e && e.name==='AbortError') return {ok:false, aborted:true};
+    return {ok:false, reason:'フォルダ接続に失敗: '+(e&&e.message)};
+  }
+}
+/** 履歴ビューの「📁 保存フォルダに接続」 */
+async function connectFolder(){
+  const r=await pickPlansFolder(false);
+  if(r.ok) toast(r.reconnected?'保存フォルダに再接続しました':'保存フォルダに接続しました: '+r.name);
+  else if(!r.aborted) toast(r.reason, {sticky:true});
 }
 /* 入稿計画フォルダ未接続なら書き出しボタンを「接続」ボタンに切替（接続後は書き出し） */
 function updateSubmitJsonBtn(){ /* ボタンは『サンプルプラン更新』に用途変更したためラベル切替は無効化 */ }
@@ -5923,8 +6197,14 @@ async function restoreFolder(){
   if(!fsSupported) return;
   try{ const h=await idbGet('dir'); if(!h) return;
     const p=await h.queryPermission({mode:'readwrite'});
-    if(p==='granted'){ dirHandle=h; toast('入稿計画フォルダ（'+h.name+'/）に自動接続しました'); }
-    else pendingDirHandle=h; // 権限失効時はボタン押下(ユーザー操作)で1クリック再要求
+    if(p==='granted'){
+      /* 記憶しているのが別のフォルダなら自動接続しない (すでに違うフォルダを選んでいた人のため) */
+      const c=await checkPlansDir(h);
+      if(c.ok){ dirHandle=h; toast('入稿計画フォルダ（'+h.name+'/）に自動接続しました'); }
+      else toast('記憶していた保存フォルダ「'+h.name+'」は入稿計画フォルダではないため、接続しませんでした。'
+        +'素材の「＋ 新規登録」から選び直してください', {sticky:true});
+    }
+    else pendingDirHandle=h; // 権限失効時はボタン押下(ユーザー操作)で1クリック再要求。判定は再許可のあと
   }catch(e){}
   if(activeView==='hist') renderHist();
 }
@@ -5934,6 +6214,331 @@ async function writePlanFile(name, text){
   catch(e){ toast('フォルダ書き込み失敗: '+e.message+'（ダウンロードに切替）'); return false; }
 }
 
+/* ============================================================
+   レスポンシブ動画の取り込み (#324)
+   ------------------------------------------------------------
+   ブラウザは列に書いた「パス文字列」だけではローカル動画を読めないので、ファイルピッカーで
+   選んでもらう。選んだ動画から **0 秒フレームを canvas で抜いてサムネにする**。
+   YDA は動画からサムネを自動生成しないので (本番実測。connectors/yahooSubmission.ts uploadVideo
+   のコメント参照)、入稿には必ずサムネ画像が要る。審査でサムネだけ落ちることがあるため、
+   抽出位置(秒)を変えてやり直せるようにしている。
+
+   素材は入稿計画フォルダ配下の 素材/ に置き、列には **計画JSON基準の相対パス** を入れる
+   (CLI の resolveLocalMediaPath が plan ファイルのディレクトリを基準に解決する)。
+   接続フォルダの外にある動画はそこへコピーする — パスを自動で入れられないと
+   「ファイルを選んだら両方埋まる」が成立しないため。
+   ============================================================ */
+const MEDIA_SUBDIR='素材';
+
+/** 動画の指定秒のフレームを JPEG Blob で返す。
+    sec=0 は seek せず loadeddata のフレームを使う (currentTime=0 の代入では seeked が
+    発火しないブラウザがあり、待ち続けて固まるため)。 */
+function grabVideoFrame(file, sec){
+  return new Promise((resolve, reject)=>{
+    const url=URL.createObjectURL(file);
+    const v=document.createElement('video');
+    v.preload='auto'; v.muted=true; v.playsInline=true;
+    let settled=false;
+    const fail=e=>{ if(settled) return; settled=true; URL.revokeObjectURL(url); reject(e instanceof Error?e:new Error('動画を読み込めません: '+file.name)); };
+    const shoot=()=>{
+      if(settled) return;
+      try{
+        const c=document.createElement('canvas');
+        c.width=v.videoWidth; c.height=v.videoHeight;
+        if(!c.width||!c.height) return fail(new Error('動画のサイズを取得できません: '+file.name));
+        c.getContext('2d').drawImage(v,0,0,c.width,c.height);
+        c.toBlob(b=>{ if(settled) return; settled=true; URL.revokeObjectURL(url);
+          b?resolve({blob:b, width:c.width, height:c.height, duration:v.duration||0}):reject(new Error('サムネを作れません: '+file.name)); },
+          'image/jpeg', 0.92);
+      }catch(e){ fail(e); }
+    };
+    v.onerror=()=>fail(new Error('動画を読み込めません（対応していない形式かもしれません）: '+file.name));
+    v.onseeked=shoot;
+    v.onloadeddata=()=>{
+      const want=Math.max(0, Number(sec)||0);
+      const max=Math.max(0,(v.duration||0)-0.05);
+      const at=Math.min(want, max);
+      if(at<=0) shoot(); else { try{ v.currentTime=at; }catch(e){ fail(e); } }
+    };
+    v.src=url;
+  });
+}
+
+/** 入稿計画フォルダ配下 素材/ にファイルを書き、計画JSON基準の相対パスを返す */
+async function writeMediaFile(name, data){
+  if(!dirHandle) throw new Error('入稿計画フォルダに接続していません（素材の「＋ 新規登録」から保存フォルダを選んでください）');
+  const dir=await dirHandle.getDirectoryHandle(MEDIA_SUBDIR,{create:true});
+  const fh=await dir.getFileHandle(name,{create:true});
+  const w=await fh.createWritable(); await w.write(data); await w.close();
+  return MEDIA_SUBDIR+'/'+name;
+}
+/** 既に接続フォルダの中にある動画はコピーせず、その相対パスをそのまま使う */
+async function videoRelPath(handle, file){
+  try{
+    const seg=await dirHandle.resolve(handle);
+    if(seg&&seg.length) return seg.join('/');
+  }catch(e){}
+  return await writeMediaFile(safeFileName(file.name), file);
+}
+/** ファイル名に使えない文字を落とす (広告名や日本語はそのまま通す) */
+function safeFileName(n){ return String(n||'file').replace(/[\/\\:*?"<>|]/g,'_'); }
+
+/* ---- サイドバーの「＋ 新規登録」 ----
+   画像も動画も**番号セルの右サイドバーから**登録する (ツールバーに別動線を作らない)。
+   参照表に無い番号を行に入れ、素材は 素材/ へ置いてパス列に入れるだけ。mediaID は
+   入稿の直前に CLI がアップロードして解決するので、ここでは refs.media に触らない。
+
+   ⚠ showOpenFilePicker / showDirectoryPicker は**ユーザー操作の直後**にしか開けない
+   (await を挟むと失効する。フォルダを選んだ直後に続けてファイル選択を開くと失敗する)。
+   そのため「① 保存フォルダ → ② 素材」をモーダルのボタンで1クリックずつ進めてもらい、
+   番号の確認はファイルを選び終わってから出す。 */
+async function openNewMediaWizard(){
+  if(!drawerTarget || !drawerTarget.u){ return; }
+  const target={u:drawerTarget.u, f:drawerTarget.f};   // await の前に確定させる
+  await loadPlannerEnv();
+  /* ダイアログを開いている間に drawer が閉じられると drawerTarget が null になる。
+     **対象の行はここで確定させて持ち回る** (await をまたいで drawerTarget を読まない)。 */
+  const fa=findAd(target.u); if(!fa) return;
+  const fmt=pf().fmtOf(fa.a);
+  const isVideo=fmt && fmt.apiMediaKind==='VIDEO';
+  const kind=isVideo?'動画':'画像';
+  if(!fsSupported){ toast('このブラウザはローカルフォルダ連携に未対応です（Chrome 系で開いてください）'); return; }
+
+  const root=document.getElementById('modalRoot');
+  let error='', busy=false;
+  const close=()=>{ root.innerHTML=''; };
+  /* キャンセルか、入稿計画フォルダを選んで素材まで進むまで閉じない (オーバーレイのクリックでも閉じない) */
+  const render=()=>{
+    const ok=!!dirHandle;
+    const step1 = ok
+      ? '<div class="nmstep done"><div class="nmhead"><span class="nmno">✓</span>保存フォルダ</div>'
+        +'<div class="nmbody"><span class="mono">'+esc(dirHandle.name)+'/</span>'
+        +'<button class="act ghost" data-nm="dirfresh">変更</button></div></div>'
+      : '<div class="nmstep cur"><div class="nmhead"><span class="nmno">1</span>保存フォルダ（'+PLANS_DIR_NAME+'）を選ぶ'
+        +'<span class="pill">初期設定（初回のみ）</span></div>'
+        +'<div class="nmbody"><div class="hint">最初の1回だけの設定です。次回からは自動でつながります。'
+        +'素材（'+MEDIA_SUBDIR+'/）と入稿計画ファイルの保存先になります。</div>'
+        +(plannerEnv.plansDir
+          ? '<div class="nmpath"><span class="mono">'+esc(plannerEnv.plansDir)+'</span>'
+            +'<button class="act ghost" data-nm="copypath">パスをコピー</button></div>'
+            +'<div class="hint">「保存フォルダを選ぶ」で開く画面で <b>Cmd+Shift+G</b>（Windows はアドレス欄）にこのパスを貼り付けて移動し、そのまま「選択」を押してください</div>'
+          : '<div class="hint">ad-ops スキルの中にある「'+PLANS_DIR_NAME+'」フォルダを選んでください</div>')
+        +(pendingDirHandle
+          ? '<button class="act primary" data-nm="dir">前回のフォルダ（'+esc(pendingDirHandle.name)+'）を再許可する</button>'
+            +'<button class="act ghost" data-nm="dirfresh">別のフォルダを選ぶ</button>'
+          : '<button class="act primary" data-nm="dir">保存フォルダを選ぶ</button>')
+        +'</div></div>';
+    const step2 = '<div class="nmstep '+(ok?'cur':'wait')+'"><div class="nmhead"><span class="nmno">2</span>'+kind+'を選ぶ</div>'
+      +'<div class="nmbody"><div class="hint">'+(isVideo
+        ? '選んだ動画から 0 秒目のフレームをサムネイルとして切り出します（次の画面で確認・変更できます）'
+        : '選んだ画像を '+MEDIA_SUBDIR+'/ に置き、入稿時にアップロードします')
+      +'。<b>複数選べます</b>（選択中の行に上から順に入ります）</div>'
+      +'<button class="act primary" data-nm="file"'+(ok?'':' disabled')+'>'+kind+'を選ぶ</button>'
+      +(ok?'':'<span class="sm" style="color:var(--faint)">　先に保存フォルダを選んでください</span>')
+      +'</div></div>';
+    root.innerHTML='<div class="overlay"><div class="modal" id="newMediaWizard"><h3>'+kind+'を新規登録</h3>'
+      +'<div class="msub">保存フォルダを決めてから、'+kind+'を選びます</div>'
+      +'<div class="mbody">'+(error?'<div class="callout danger" data-nm-error>'+esc(error)+'</div>':'')+step1+step2+'</div>'
+      +'<div class="mfoot"><button class="act" data-nm="cancel">キャンセル</button></div></div></div>';
+    root.querySelector('[data-nm="cancel"]').addEventListener('click', close);
+    const copyBtn=root.querySelector('[data-nm="copypath"]');
+    if(copyBtn) copyBtn.addEventListener('click', async ()=>{
+      try{ await navigator.clipboard.writeText(plannerEnv.plansDir); copyBtn.textContent='コピーしました'; }
+      catch(e){ toast('コピーできませんでした。パスを選択してコピーしてください'); }
+    });
+    root.querySelectorAll('[data-nm="dir"],[data-nm="dirfresh"]').forEach(b=>b.addEventListener('click', async ()=>{
+      if(busy) return; busy=true;
+      let r;
+      try{ r=await pickPlansFolder(b.dataset.nm==='dirfresh'); }
+      catch(e){ r={ok:false, reason:'フォルダ接続に失敗: '+(e&&e.message)}; }
+      finally{ busy=false; }
+      console.info('[planner] 保存フォルダの選択:', r);
+      /* 黙って元の画面に戻すと「選んだのに進まない」ように見える。キャンセルも理由を出す
+         (フォルダ選択のあとに出る「編集を許可」を閉じてもキャンセル扱いになる) */
+      if(r.ok) error='';
+      else error = r.aborted
+        ? 'フォルダの選択、または続けて出る「ファイルの編集を許可」がキャンセルされました。もう一度「保存フォルダを選ぶ」を押し、最後に「編集を許可」を押してください'
+        : r.reason;
+      render();
+      if(r.ok){ try{ renderDrawer(); }catch(e){ recordError('drawer', e, 'サイドバーの再描画'); } }
+    }));
+    const fileBtn=root.querySelector('[data-nm="file"]');
+    if(fileBtn) fileBtn.addEventListener('click', ()=>{
+      if(!dirHandle || busy) return;
+      /* ここで await を挟まずにピッカーを開く (ユーザー操作の有効期限内に呼ぶ) */
+      pickNewMediaFiles(isVideo).then(handles=>{
+        if(!handles.length) return;     // ピッカーをキャンセル → モーダルに戻る
+        close();
+        continueNewMedia({handles, isVideo, fmt, target});
+      });
+    });
+  };
+  render();
+}
+/** 素材ファイルを選ばせる (複数可)。キャンセルなら [] */
+async function pickNewMediaFiles(isVideo){
+  try{
+    const handles = isVideo
+      ? await window.showOpenFilePicker({ id:'ad-planner-video', multiple:true,
+          types:[{description:'動画', accept:{'video/mp4':['.mp4'],'video/quicktime':['.mov']}}] })
+      : await window.showOpenFilePicker({ id:'ad-planner-image', multiple:true,
+          types:[{description:'画像', accept:{'image/jpeg':['.jpg','.jpeg'],'image/png':['.png']}}] });
+    return handles || [];
+  }catch(e){ return []; } // ユーザーがキャンセル
+}
+
+/* ---- この計画で新規登録した素材 (管理番号 → ローカルパス) ----
+   パスは「登録した行」ではなく**番号**に持つ。こうしないと、同じ番号を別の行で選んだときに
+   パスが付かず、一覧にもサムネを出せない。mediaID がまだ無いので refs.media には入れない
+   (空の ID を入れると「登録済み」と誤判定され、CLI のアップロードが走らない)。
+   st.project に置くので保存 JSON と往復する (入稿計画JSONには出ない)。 */
+function localMedia(){
+  if(!st.project.localMedia || typeof st.project.localMedia!=='object') st.project.localMedia={};
+  return st.project.localMedia;
+}
+/** 番号に登録したローカル素材のパスを、その行のパス列へ入れる (行の形式と素材の種類が合うときだけ) */
+function applyLocalMediaPaths(item, no){
+  if(!item || item.kind!=='a') return;
+  const e=localMedia()[String(no)]; if(!e) return;
+  const F=newMediaFields(pf().fmtOf(item.a)); if(!F) return;
+  if(F.video && e.video){ setVarByField(item,'ads',F.video,e.video); setVarByField(item,'ads',F.thumb,e.thumb||''); }
+  else if(F.image && e.image){ setVarByField(item,'ads',F.image,e.image); }
+}
+/* ローカル素材のサムネ。接続フォルダから読んで ObjectURL にする (登録直後は手元の Blob をそのまま使う) */
+const localThumbUrls=new Map();
+async function localFileUrl(rel){
+  if(localThumbUrls.has(rel)) return localThumbUrls.get(rel);
+  if(!dirHandle || !rel) return '';
+  try{
+    const parts=String(rel).split('/'); let d=dirHandle;
+    for(let i=0;i<parts.length-1;i++) d=await d.getDirectoryHandle(parts[i]);
+    const f=await (await d.getFileHandle(parts[parts.length-1])).getFile();
+    const u=URL.createObjectURL(f); localThumbUrls.set(rel,u); return u;
+  }catch(e){ return ''; }
+}
+function hydrateLocalThumbs(root){
+  root.querySelectorAll('img[data-localthumb]').forEach(async img=>{
+    const u=await localFileUrl(img.dataset.localthumb);
+    if(u) img.src=u; else img.remove();
+  });
+}
+
+/** 新規登録の対象行。範囲選択中なら「選択範囲の広告行のうち、同じ種類 (動画 / 画像) の行」を上から順に。
+    選択が無ければ ▾ を押した行だけ。 */
+function newMediaTargets(target, isVideo){
+  const rg=selRange(), vis=flatVisible(), out=[];
+  if(rg && rg.r1>rg.r0){
+    for(let r=rg.r0;r<=rg.r1;r++){
+      const it=vis[r]; if(!it || it.kind!=='a') continue;
+      const f=pf().fmtOf(it.a); if(!f || (f.apiMediaKind==='VIDEO')!==isVideo) continue;
+      out.push({u:it.a.uid, row:r+1});
+    }
+  }
+  if(!out.length){ const r=vis.findIndex(it=>it && it.kind==='a' && it.a.uid===target.u); out.push({u:target.u, row:r+1}); }
+  return out;
+}
+
+/** 選んだ素材から (動画なら 0 秒サムネを抜いて) 番号と行を確認するモーダルへ進む */
+async function continueNewMedia({handles, isVideo, fmt, target}){
+  const items=[];
+  for(const handle of handles){
+    const file=await handle.getFile();
+    let frame=null;
+    if(isVideo){
+      try{ frame=await grabVideoFrame(file, 0); }
+      catch(e){ recordError('videoFrame', e, '動画サムネの抽出'); toast('動画サムネを作れませんでした（'+file.name+'）: '+e.message); return; }
+    }
+    items.push({handle, file, frame, sec:0});
+  }
+  if(!items.length) return;
+  openNewMediaModal({items, isVideo, fmt, target, targets:newMediaTargets(target, isVideo)});
+}
+
+/** 管理番号と入れる行を決めるモーダル。動画はサムネのプレビューと抽出位置もここで出す。
+    番号は空き番号からの連番を初期値に出し、書き換えられる。行より素材が多い分は一覧にだけ登録する。 */
+function openNewMediaModal(ctx){
+  const n0=Number(nextMediaNo());
+  ctx.items.forEach((it,i)=>{ it.no=String(n0+i); it.row=ctx.targets[i]||null; });
+  const urls=ctx.items.map(it=>URL.createObjectURL(ctx.isVideo?it.frame.blob:it.file));
+  const revoke=()=>urls.forEach(u=>{ try{ URL.revokeObjectURL(u); }catch(e){} });
+  const kind=ctx.isVideo?'動画':'画像';
+  const root=document.getElementById('modalRoot');
+  const close=()=>{ root.innerHTML=''; };
+  const rowsHtml=()=>ctx.items.map((it,i)=>'<div class="nmitem" data-i="'+i+'">'
+    +'<img src="'+esc(urls[i])+'" alt="">'
+    +'<div class="nmmeta"><div class="mono nmfile">'+esc(it.file.name)+'</div>'
+    +'<div class="nmfields"><label>管理番号 <input type="text" class="nm-no" value="'+esc(it.no)+'"></label>'
+    +(ctx.isVideo?'<label>サムネ位置（秒） <input type="number" min="0" class="nm-sec" value="'+it.sec+'"></label>':'')
+    +'</div><div class="hint">'+(it.row?('広告 '+it.row.row+' 行目に入れます'):'行が足りないため、一覧にだけ登録します（あとで他の行から選べます）')+'</div></div></div>').join('');
+  root.innerHTML='<div class="overlay"><div class="modal" id="newMediaModal"><h3>'+kind+'を新規登録（'+ctx.items.length+'件）</h3>'
+    +'<div class="msub">番号は空き番号からの連番です。広告名に出る番号なので、運用の番号に変えられます</div>'
+    +'<div class="mbody">'+rowsHtml()+'</div>'
+    +'<div class="mfoot"><button class="act" data-mo="cancel">キャンセル</button><button class="act primary" data-mo="ok">登録する</button></div></div></div>';
+  root.querySelector('[data-mo="cancel"]').addEventListener('click',()=>{ close(); revoke(); });
+  root.querySelectorAll('.nm-sec').forEach(el=>el.addEventListener('change', async ()=>{
+    const i=Number(el.closest('.nmitem').dataset.i), it=ctx.items[i];
+    const sec=Math.max(0, Number(el.value)||0);
+    try{
+      it.frame=await grabVideoFrame(it.file, sec); it.sec=sec;
+      try{ URL.revokeObjectURL(urls[i]); }catch(e){}
+      urls[i]=URL.createObjectURL(it.frame.blob);
+      el.closest('.nmitem').querySelector('img').src=urls[i];
+    }catch(e){ recordError('videoFrame', e, '動画サムネの再抽出'); toast('サムネを取り直せませんでした: '+e.message); }
+  }));
+  root.querySelector('[data-mo="ok"]').addEventListener('click', async ()=>{
+    const nos=[...root.querySelectorAll('.nm-no')].map(el=>String(el.value||'').trim());
+    /* 既存番号への上書きは許さない。参照表の mediaID を持つ番号にパスが被さると、
+       どちらが入稿に使われるか画面から分からなくなる。 */
+    for(const no of nos){
+      if(no==='') return toast('管理番号を入れてください');
+      if((st.refs.media||{})[no]) return toast('番号 '+no+' は参照データに登録済みです。別の番号にしてください');
+      if(localMedia()[no]) return toast('番号 '+no+' はこの計画で登録済みです。別の番号にしてください');
+    }
+    if(new Set(nos).size!==nos.length) return toast('同じ管理番号が重複しています');
+    ctx.items.forEach((it,i)=>{ it.no=nos[i]; });
+    close(); revoke();
+    for(const it of ctx.items){
+      const ok=await applyNewMedia({isVideo:ctx.isVideo, fmt:ctx.fmt, file:it.file, handle:it.handle, frame:it.frame, sec:it.sec,
+        target:it.row?{u:it.row.u, f:ctx.target.f}:null}, it.no, {quiet:true});
+      if(!ok) return;
+    }
+    const placed=ctx.items.filter(it=>it.row).length;
+    toast(ctx.items.length+'件を登録しました（行に入れたもの '+placed+'件・'+MEDIA_SUBDIR+'/ に書き出し。入稿時にアップロードされます）');
+  });
+}
+
+/** 素材を 素材/ へ書き出して番号に登録し、target があればその行に番号とパスを入れる。
+    @returns {Promise<boolean>} 書き出せたか */
+async function applyNewMedia(ctx, no, opts){
+  const F=newMediaFields(ctx.fmt); if(!F) return false;
+  const entry={file:ctx.file.name};
+  try{
+    if(ctx.isVideo){
+      const base=safeFileName(ctx.file.name).replace(/\.[^.]+$/,'');
+      entry.video=await videoRelPath(ctx.handle, ctx.file);
+      entry.thumb=await writeMediaFile(base+'_'+ctx.sec+'s.jpg', ctx.frame.blob);
+      localThumbUrls.set(entry.thumb, URL.createObjectURL(ctx.frame.blob));
+    }else{
+      entry.image=await videoRelPath(ctx.handle, ctx.file);
+      localThumbUrls.set(entry.image, URL.createObjectURL(ctx.file));
+    }
+  }catch(e){ recordError('mediaWrite', e, '素材の書き出し'); toast('素材を書き出せませんでした: '+e.message); return false; }
+
+  mutate(()=>{ localMedia()[String(no)]=entry; });
+  if(ctx.target){
+    const fa=findAd(ctx.target.u);
+    if(!fa){ toast('対象の広告行が見つかりません'); return false; }
+    /* ⚠ setVar の第1引数は **flatVisible() の行オブジェクト**（`rowOf` が kind で実体を選ぶ）。
+       広告オブジェクトを直接渡すと `rowOf` が行を取れず、**黙って何も書かずに返る**。 */
+    const item={kind:'a', a:fa.a, g:fa.g, c:fa.c};
+    const num=/^\d+$/.test(String(no))?Number(no):no;
+    mutate(()=>{ setVarByField(item,'ads',ctx.target.f||'imageNo',num); applyLocalMediaPaths(item, no); });
+  }
+  if(!(opts&&opts.quiet)) toast('番号 '+no+' で登録しました（'+MEDIA_SUBDIR+'/ に書き出し。入稿時にアップロードされます）');
+  if(typeof renderDrawer==='function') renderDrawer();
+  return true;
+}
+
 /* ============================================================
    B-1: アカウント別参照データ (アカウント/<媒体>/ フォルダ + <名前>.json)
    File System Access API 前提 (Chrome系・フォールバックなし)。未接続時は同梱デフォルト(<account.dir>/index.json 先頭)を使用。
@@ -6092,6 +6697,7 @@ window.applyAccountJson=function(obj){
     st.campaigns.forEach(c=>{ c.uid=uid('c'); (c.adGroups||[]).forEach(g=>{ g.uid=uid('g'); (g.ads||[]).forEach(a=>{ a.uid=uid('a'); }); }); });
     migrateArticleSlug(st.campaigns); // C8: 旧 articleSlug / articleUrl を除去
     migratePlatformValues(st.campaigns); // 媒体側の旧値を現行の語彙へ
+    st.project.localMedia=samplePlanLocalMedia();
     planMismatchMsg='';
     if(typeof renderPlanWarn==='function') renderPlanWarn();
   }
@@ -6447,14 +7053,27 @@ function openHelpModal(){
 
 /* 「サンプルプラン更新」: 現在のプラン(共通設定+キャンペーン)を サンプルプラン.json に書き戻す。
    初回だけ File System Access でファイルを選び、以後は IndexedDB 保持ハンドルで Finder無し更新。 */
+/** サンプルプラン.json に書き戻す中身。
+    localMedia (この計画で新規登録した素材: 番号 → ローカルパス) も持つ。無いと保存して開き直したときに、
+    一覧にだけ登録した素材と、番号に紐づくパス・サムネが消える (行に入ったパスは campaigns 側に残る)。 */
+function samplePlanData(){
+  const data={schemaVersion:SCHEMA_VERSION, platform:curPf, accountId:st.project.accountId||'', campaigns:st.campaigns};
+  const lm=st.project.localMedia;
+  if(lm && typeof lm==='object' && Object.keys(lm).length) data.localMedia=lm;
+  return data;
+}
+/** サンプルプランの localMedia を読む (無い・壊れているときは空) */
+function samplePlanLocalMedia(){
+  const lm=samplePlan && samplePlan.localMedia;
+  return (lm && typeof lm==='object' && !Array.isArray(lm)) ? JSON.parse(JSON.stringify(lm)) : {};
+}
 async function updateSamplePlan(){
   /* S13: 書き出しスキーマは同梱の サンプルプラン*.json と同形 {schemaVersion, platform, accountId, campaigns} に揃える。
      ・accountId が無いと initialState() のアカウント不一致ガードが素通りし、別アカウントのプランが
        無警告で読み込まれる（誤入稿に直結）ので必ず出す
      ・project は読み戻し側が存在しない（案件設定はアカウントJSON由来で defaultProject() が作る）。
        書いても次回起動で必ず捨てられるため出さない = 「保存したのに戻る」の誤解を断つ */
-  const data={schemaVersion:SCHEMA_VERSION, platform:curPf, accountId:st.project.accountId||'', campaigns:st.campaigns};
-  const json=JSON.stringify(data,null,1);
+  const json=JSON.stringify(samplePlanData(),null,1);
   if(!samplePlanFileHandle){ try{ const h=await idbGet(idbKeySamplePlan()); if(h){ const perm=await h.queryPermission({mode:'readwrite'}); if(perm==='granted') samplePlanFileHandle=h; else samplePlanFileHandle=h; } }catch(e){} }
   if(samplePlanFileHandle){ try{ let perm=await samplePlanFileHandle.queryPermission({mode:'readwrite'}); if(perm!=='granted') perm=await samplePlanFileHandle.requestPermission({mode:'readwrite'}); if(perm!=='granted') samplePlanFileHandle=null; }catch(e){ samplePlanFileHandle=null; } }
   if(!samplePlanFileHandle){
@@ -6562,7 +7181,7 @@ document.getElementById('sheetFilter').addEventListener('change',()=>{ clearSel(
 document.getElementById('modeSeg').addEventListener('click',e=>{ const b=e.target.closest('button[data-m]'); if(!b) return; clearSel(); closeDrawer(); planMode=b.dataset.m; document.querySelectorAll('#modeSeg button').forEach(x=>x.classList.toggle('active',x===b)); render(); });
 /* S11: 媒体セレクタ (#pfSeg) / 媒体要件タブ (#mediaTabs) は廃止。媒体切替はヘッダーの統合プルダウンに一本化 */
 /* YDA内: 概要 / レスポンシブ / バナー / パラメータ / 使い方 タブ切替 */
-document.getElementById('ydaTabs').addEventListener('click',e=>{ const b=e.target.closest('button[data-yt]'); if(!b) return; document.querySelectorAll('#ydaTabs button').forEach(x=>x.classList.toggle('active',x===b)); ['overview','resp','banner','param','guide'].forEach(k=>{ document.getElementById('yt-'+k).style.display = b.dataset.yt===k?'':'none'; }); });
+document.getElementById('ydaTabs').addEventListener('click',e=>{ const b=e.target.closest('button[data-yt]'); if(!b) return; document.querySelectorAll('#ydaTabs button').forEach(x=>x.classList.toggle('active',x===b)); ['overview','resp','banner','video','param','guide'].forEach(k=>{ document.getElementById('yt-'+k).style.display = b.dataset.yt===k?'':'none'; }); });
 /* 案件テンプレ: チップ直接編集 */
 document.getElementById('tplChips').addEventListener('change',e=>{
   /* S12: kind:'datetime' は日付/時刻の2入力で1つのキーを作るので、[data-proj] の汎用処理より先に分岐する
@@ -6674,7 +7293,7 @@ sheetHostEl.addEventListener('mousedown',e=>{
   pendingDrawer=null; dragMoved=false;
   // S3: 旧 [1,2,3] リテラルを撤去。列記述子の kind で「▼参照ドロワー列」「ターゲティング列」を判定する
   const col=colDefs()[c];
-  if(e.shiftKey && selA){ selB={r,c}; e.preventDefault(); } else { selA={r,c}; selB={r,c}; dragging='cell'; if(col && col.kind==='refcombo') pendingDrawer={kind:'ad', u:cell.dataset.u, f:cell.dataset.f}; else if(col && (col.kind==='tgpick'||col.kind==='refpick') && cell.dataset.gf) pendingDrawer={kind:'tg', gu:cell.dataset.gu, gf:cell.dataset.gf}; else if(col && col.kind==='optpick' && cell.dataset.f) pendingDrawer={kind:'opt', u:cell.dataset.u, f:cell.dataset.f}; }
+  if(e.shiftKey && selA){ selB={r,c}; e.preventDefault(); /* Shift+クリックの範囲選択でもドロワーを開く (開いていれば選択範囲に合わせて描き直す) */ if(col && col.kind==='refcombo' && selA.c===c) pendingDrawer={kind:'adRange', u:cell.dataset.u, f:cell.dataset.f}; /* 同じ列を縦に選んだときだけ (矩形選択は従来どおり開かない) */ } else { selA={r,c}; selB={r,c}; dragging='cell'; if(col && col.kind==='refcombo') pendingDrawer={kind:'ad', u:cell.dataset.u, f:cell.dataset.f}; else if(col && (col.kind==='tgpick'||col.kind==='refpick') && cell.dataset.gf) pendingDrawer={kind:'tg', gu:cell.dataset.gu, gf:cell.dataset.gf}; else if(col && col.kind==='optpick' && cell.dataset.f) pendingDrawer={kind:'opt', u:cell.dataset.u, f:cell.dataset.f}; }
   applySelection();
 });
 sheetHostEl.addEventListener('mouseover',e=>{
@@ -6698,7 +7317,7 @@ document.getElementById('drawerBackdrop').addEventListener('click',closeDrawer);
 document.getElementById('drawerSearch').addEventListener('input',renderDrawer);
 document.getElementById('drawerList').addEventListener('click',e=>{
   /* サムネのクリックは拡大。行の選択には落とさない (見たいだけで選ぶとは限らない) */
-  const th=e.target.closest('.ddthumb');
+  const th=e.target.closest('.ddthumb[data-zoom]'); // ローカル素材のサムネ (data-localthumb) は拡大しない
   if(th){ e.stopPropagation(); openThumbZoom(th.dataset.zoom); return; }
   const row=e.target.closest('.ddrow'); if(!row) return; if(!drawerTarget) return;
   if(drawerTarget.type==='tg'){ drawerTgToggle(row.dataset.tgval); }
@@ -6707,21 +7326,37 @@ document.getElementById('drawerList').addEventListener('click',e=>{
   else if(drawerTarget.type==='agref'){ if(row.dataset.agid) addExistingAdGroup(row.dataset.agid); }
   else if(drawerTarget.type==='cppick'){ if(row.dataset.cppick){ if(drawerTarget.mode==='addNew') addNewAdGroupToCampaign(row.dataset.cppick); else moveGroupToCampaign(drawerTarget.gUid, row.dataset.cppick); } }
   else if(drawerTarget.type==='agpick'){ if(row.dataset.agpick) moveAdToGroup(drawerTarget.adUid, row.dataset.agpick); }
+  /* 「＋ 新規登録」。保存フォルダ → 素材 の2ステップをモーダルで案内する */
+  else if(row.dataset.newmedia){ openNewMediaWizard(); }
+  else if(row.dataset.seq){ applySequentialParamCodes(); renderDrawer(); }
   else { drawerPick(row.dataset.no); }
 });
 /* 単体クリック/複数ドラッグ選択どちらでも開く(選択範囲全セルに一括適用) */
-document.addEventListener('mouseup',()=>{ if(pendingDrawer){ if(pendingDrawer.kind==='ad') openDrawerFor(pendingDrawer.u,pendingDrawer.f); else if(pendingDrawer.kind==='opt') openOptDrawer(pendingDrawer.u,pendingDrawer.f); else openTargetingDrawer(pendingDrawer.gu,pendingDrawer.gf); } pendingDrawer=null; deferredCollapse=null; if(dragging){ dragging=false; document.body.classList.remove('noselect'); } });
+document.addEventListener('mouseup',()=>{ if(pendingDrawer){ if(pendingDrawer.kind==='adRange'){ if(document.getElementById('refDrawer').classList.contains('open') && drawerTarget && drawerTarget.f===pendingDrawer.f) renderDrawer(); else openDrawerFor(pendingDrawer.u,pendingDrawer.f); } else if(pendingDrawer.kind==='ad') openDrawerFor(pendingDrawer.u,pendingDrawer.f); else if(pendingDrawer.kind==='opt') openOptDrawer(pendingDrawer.u,pendingDrawer.f); else openTargetingDrawer(pendingDrawer.gu,pendingDrawer.gf); } pendingDrawer=null; deferredCollapse=null; if(dragging){ dragging=false; document.body.classList.remove('noselect'); } });
 
 /* ---- コピー / 貼付 ---- */
+/* シートの自前コピペ (セル範囲 → TSV) を使う場面か。
+   モーダル・サイドバー・チップの入力欄や、シートの外の文字を選んでいるときはブラウザ標準に任せる。
+   以前はシート表示中なら常に横取りしていたため、モーダルのパスやエラー文をコピーできず、
+   モーダルの入力欄にも貼れなかった (セル範囲が選択されたままだと貼付がシートへ流れた)。 */
+function gridClipboardActive(){
+  if(activeView!=='sheet'||planMode!=='sheet') return false;
+  const mr=document.getElementById('modalRoot'); if(mr && mr.children.length) return false;
+  const ae=document.activeElement;
+  if(ae && ae.matches && ae.matches('input,textarea,select,[contenteditable="true"]') && !ae.classList.contains('cell-in')) return false;
+  const sel=window.getSelection && window.getSelection();
+  if(sel && !sel.isCollapsed && sel.anchorNode){ const host=document.getElementById('sheetHost'); if(!host || !host.contains(sel.anchorNode)) return false; }
+  return true;
+}
 document.addEventListener('copy',e=>{
-  if(activeView!=='sheet'||planMode!=='sheet') return;
+  if(!gridClipboardActive()) return;
   const rg=selRange();
   if(rg){ const t=copySelText(); if(t!=null){ e.clipboardData.setData('text/plain',t); e.preventDefault(); } return; } // セル選択→常に自前TSV（ラベル/ボタンのDOMテキスト混入を防ぐ）
   const ae=document.activeElement; // セル選択なし: 単一inputの部分テキスト選択のみnative許可
   if(ae&&ae.classList&&ae.classList.contains('cell-in')&&ae.selectionStart!=null&&ae.selectionStart!==ae.selectionEnd) return;
   e.preventDefault();
 });
-document.addEventListener('paste',e=>{ if(activeView!=='sheet'||planMode!=='sheet') return; if(!selRange()) return; const txt=(e.clipboardData||window.clipboardData).getData('text'); if(txt==null) return; e.preventDefault(); pasteGrid(txt); });
+document.addEventListener('paste',e=>{ if(!gridClipboardActive()) return; if(!selRange()) return; const txt=(e.clipboardData||window.clipboardData).getData('text'); if(txt==null) return; e.preventDefault(); pasteGrid(txt); });
 document.addEventListener('keydown',e=>{
   /* 自動で消えないトーストはどのビューからでも出る（書き出しボタンは常設ヘッダー）。
      ビューのガードより手前で閉じないと、title の「閉じる (Esc)」と食い違う */