addashboard-cli 0.12.0 → 0.14.0

package/skills/ad-ops/scripts/adops.sh

@@ -13,8 +13,16 @@
 #
 # 覚えるコマンドを1本に畳むためのラッパー。個別の python3 -c / curl / ls -t を書かない。
 set -uo pipefail
+# Windows の既定コンソール (cp932) だと Python の ✓ や日本語の出力で UnicodeEncodeError になる
+export PYTHONUTF8=1 PYTHONIOENCODING=utf-8
+# Windows の Python (subprocess) は npx を見つけられない (実体が npx.cmd で WinError 2 になる)。
+# refs_import.py / thumbs_download.py は ADOPS_CLI で CLI を呼ぶので、既定をここで合わせる
+case "${OSTYPE:-}" in
+  msys*|cygwin*) export ADOPS_CLI="${ADOPS_CLI:-npx.cmd -y addashboard-cli@latest}" ;;
+esac
 
-SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# Windows ではネイティブ形式のパスで持つ (Python に渡すため)。pwd -W が無い Mac は pwd
+SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && { pwd -W 2>/dev/null || pwd; })"
 # 配信ポート。既定 8799 は cli/playwright.config.ts の webServer と共用する。
 # **worktree を分けて並行作業していると別 worktree のサーバを再利用してしまう**
 # (curl が応答すれば「起動済み」と判断するので、別ブランチのプランナーが開く)。
@@ -29,6 +37,20 @@ CLI="${WEBGRAM_CLI:-npx -y addashboard-cli@latest}"
 
 die() { echo "✗ $*" >&2; exit 1; }
 
+# URL をブラウザで開く。Mac は従来どおり open に渡す (`open -a ...` の引数もそのまま通す)。
+# Git Bash (Windows) には open が無いので Chrome を直接起動し、無ければ既定ブラウザで開く。
+# rundll32 は shell を経由しないので、& を含む URL (Google 管理画面など) でも欠けない。
+open_url() {
+  if command -v open >/dev/null 2>&1; then open "$@"; return; fi
+  local url="${!#}" c
+  for c in "/c/Program Files/Google/Chrome/Application/chrome.exe" \
+           "/c/Program Files (x86)/Google/Chrome/Application/chrome.exe" \
+           "${LOCALAPPDATA:-}/Google/Chrome/Application/chrome.exe"; do
+    [ -x "$c" ] && { "$c" "$url" >/dev/null 2>&1 & return; }
+  done
+  rundll32 url.dll,FileProtocolHandler "$url"
+}
+
 # ------------------------------------------------------------- ensure_login
 # 未ログインなら auth login を起動して完了まで待ち、そのまま処理を続ける。
 # 以前は「ターミナルで auth login を実行してください」と案内して止めていたため、
@@ -132,6 +154,35 @@ print(f"✓ 作業中プランを設定: {os.environ['ACC']} / {os.environ['PF']
 PY
 }
 
+# ------------------------------------------------------------ planner env
+# ブラウザはフォルダの絶対パスを知る手段が無いので、プランナーが「保存フォルダ（入稿計画/）」の
+# 場所を案内できるように、配信元のスキルから絶対パスを渡す (.planner-env.json)。
+# あわせて 入稿計画/ と目印ファイルを用意する (プランナーは目印の有無で入稿計画フォルダかを判定する)。
+# 各自の環境のパスなので git では追跡せず、npm にも載せない。
+write_planner_env() {
+  local plans="${SKILL_DIR}/入稿計画"
+  mkdir -p "$plans"
+  [ -f "${plans}/.ad-planner-plans" ] \
+    || printf 'ad-planner の入稿計画フォルダの目印です。消さないでください。\n' > "${plans}/.ad-planner-plans"
+  PLANS_DIR="$plans" OUT="${SKILL_DIR}/.planner-env.json" python3 - <<'PY'
+import json, os
+with open(os.environ["OUT"], "w", encoding="utf-8") as f:
+    json.dump({"plansDir": os.environ["PLANS_DIR"]}, f, ensure_ascii=False)
+    f.write("\n")
+PY
+}
+
+# 配信サーバーを止める。Mac は従来どおり pkill。
+# Git Bash (Windows) には pkill が無いので、ポートを LISTEN している python だけを taskkill で止める
+# (/PID 形式は Git Bash がパスに変換してしまうので - 形式で渡す)。
+stop_server() {
+  if command -v pkill >/dev/null 2>&1; then pkill -f "http.server ${PORT}"; return; fi
+  local pid
+  pid="$(netstat -ano | awk -v p=":${PORT}" '$1 == "TCP" && $2 ~ p"$" && $4 == "LISTENING" { print $5; exit }')"
+  [ -n "$pid" ] && tasklist -FI "PID eq ${pid}" -NH | grep -qi python \
+    && taskkill -PID "$pid" -F >/dev/null 2>&1
+}
+
 # file:// で開くと fetch('サンプルプラン.json') がブロックされ、
 # エラーも出ないまま空のプランナーが表示される。必ずHTTPで開く。
 cmd_planner() {
@@ -139,7 +190,7 @@ cmd_planner() {
   while [ $# -gt 0 ]; do
     case "$1" in
       --stop)
-        pkill -f "http.server ${PORT}" && echo "✓ プランナーの配信を停止しました" \
+        stop_server && echo "✓ プランナーの配信を停止しました" \
           || echo "（起動中のサーバーはありませんでした）"
         return 0 ;;
       --platform) platform="${2:-}"; shift 2 ;;
@@ -153,8 +204,9 @@ cmd_planner() {
       || die "--platform と --account は両方指定してください"
     write_active_plan "$platform" "$account"
   fi
+  write_planner_env
 
-  if curl -sf -o /dev/null "$URL"; then
+  if curl -sf "$URL" >/dev/null; then
     echo "✓ 配信は起動済み（再利用）"
     echo "  ⚠ 別の作業ディレクトリ (worktree) が起動したサーバの可能性があります。" >&2
     echo "    プランナーの内容が想定と違うときは ADOPS_PORT=8801 adops.sh planner ... で専用ポートに切り替えてください。" >&2
@@ -164,14 +216,24 @@ cmd_planner() {
     nohup python3 -m http.server "$PORT" --directory "$SKILL_DIR" \
       >/tmp/adops-planner.log 2>&1 &
     for _ in $(seq 1 20); do
-      curl -sf -o /dev/null "$URL" && break
+      curl -sf "$URL" >/dev/null && break
       sleep 0.3
     done
-    curl -sf -o /dev/null "$URL" || die "配信を起動できませんでした（/tmp/adops-planner.log を確認）"
+    curl -sf "$URL" >/dev/null || die "配信を起動できませんでした（/tmp/adops-planner.log を確認）"
     echo "✓ 起動しました"
   fi
 
-  open "$URL"
+  # 素材の新規登録・入稿計画の保存は File System Access API (フォルダの読み書き) を使うので Chrome で開く。
+  # 素の `open` は BizAgent / VS Code のターミナルだと内蔵ブラウザに渡され、
+  # 内蔵ブラウザはフォルダの読み書きを許可しない (許可の確認も出ずに黙って拒否される)。
+  if [ -d "/Applications/Google Chrome.app" ] || [ -d "$HOME/Applications/Google Chrome.app" ]; then
+    open -a "Google Chrome" "$URL"
+  else
+    open_url "$URL"
+    # Windows は open_url が Chrome を直接探して起動するので、Mac (open がある) のときだけ警告する
+    command -v open >/dev/null 2>&1 \
+      && echo "  ⚠ Google Chrome が見つかりません。素材の登録と入稿計画の保存は Chrome 系ブラウザでしか動きません" >&2
+  fi
   echo "  $URL"
   echo "  停止: adops.sh planner --stop"
 }
@@ -285,7 +347,7 @@ PY
   esac
 
   echo "$url"
-  [ -n "$dry" ] || open "$url"
+  [ -n "$dry" ] || open_url "$url"
 }
 
 # --------------------------------------------------------------- refs-import

package/skills/ad-ops/scripts/plan_lint.py

@@ -432,6 +432,7 @@ def summarize(plan: dict) -> None:
                     or a.get("videoId")
                     or a.get("imageHash")
                     or a.get("youtubeVideoId")
+                    or ",".join(v.get("youtubeVideoId") or v.get("videoPath") or "?" for v in a.get("videos") or [])
                     or ",".join((a.get("marketingImages") or []) + (a.get("squareMarketingImages") or []))
                     or "-"
                 )
@@ -530,7 +531,7 @@ def lint(plan: dict, plan_path: str = "") -> None:
                 # クリエイティブの持ち方は媒体で違う。
                 #   yda    : mediaIds / videoMediaId
                 #   meta   : imageHash / videoId
-                #   google : youtubeVideoId / marketingImages / squareMarketingImages
+                #   google : youtubeVideoId / videos[] / marketingImages / squareMarketingImages
                 #   bytedance : videoId + imageIds (カバー画像) / アップロード前は videoPath
                 has_creative = bool(
                     media
@@ -539,6 +540,7 @@ def lint(plan: dict, plan_path: str = "") -> None:
                     or a.get("imageHash")
                     or a.get("imageIds")
                     or a.get("youtubeVideoId")
+                    or a.get("videos")
                     or a.get("marketingImages")
                     or a.get("squareMarketingImages")
                 )
@@ -569,6 +571,7 @@ def lint(plan: dict, plan_path: str = "") -> None:
                 if a.get("coverImagePath"):
                     local_paths.append(a["coverImagePath"])
                 local_paths.extend(a.get("coverImagePaths") or [])
+                local_paths.extend(v["videoPath"] for v in a.get("videos") or [] if v.get("videoPath"))
                 for raw in local_paths:
                     resolved = resolve_media_path(raw, base_dir)
                     if not os.path.isfile(resolved):
@@ -580,15 +583,37 @@ def lint(plan: dict, plan_path: str = "") -> None:
                 # 両方あると CLI が余計にアップロードし、使われない動画が YouTube に残る。
                 # backend も superRefine で 400 にするが、CLI はその手前でアップロードを
                 # 済ませてしまうので lint でも止める（Google の安全弁は二重が原則）。
+                # 複数本（縦・横など・#347）は videos[]。1 本だけなら旧形式でもよい。
                 if platform == "google" and a.get("type") == "DEMAND_GEN_VIDEO_RESPONSIVE_AD":
-                    if a.get("youtubeVideoId") and a.get("videoPath"):
-                        err(f"CP「{name}」の広告に youtubeVideoId と videoPath が両方あります"
-                            f"（{a.get('adName') or ''}）\n"
-                            f"        → アップロードした動画は使われません。差し替えたいなら "
-                            f"youtubeVideoId を、既存動画のままでよいなら videoPath を消してください")
-                    if not a.get("youtubeVideoId") and not a.get("videoPath"):
-                        err(f"CP「{name}」の動画広告に動画がありません（{a.get('adName') or ''}）\n"
-                            f"        → youtubeVideoId か、アップロード前なら videoPath が必要")
+                    label = a.get("adName") or ""
+                    legacy = a.get("youtubeVideoId") or a.get("videoPath")
+                    videos = a.get("videos")
+                    if videos is not None and legacy:
+                        err(f"CP「{name}」の動画広告に videos と youtubeVideoId / videoPath が両方あります"
+                            f"（{label}）\n        → どちらか一方の形式で書いてください")
+                        videos = []
+                    else:
+                        if videos is None:
+                            videos = [a] if legacy else []
+                        if not videos:
+                            err(f"CP「{name}」の動画広告に動画がありません（{label}）\n"
+                                f"        → videos、または youtubeVideoId / アップロード前なら videoPath が必要")
+                    if len(videos) > 5:
+                        err(f"CP「{name}」の動画広告の動画が {len(videos)} 本あります（{label}）"
+                            f"\n        → 1 広告 5 本までです")
+                    seen_v = set()
+                    for k, v in enumerate(videos, 1):
+                        if v.get("youtubeVideoId") and v.get("videoPath"):
+                            err(f"CP「{name}」の動画{k}本目に youtubeVideoId と videoPath が両方あります"
+                                f"（{label}）\n"
+                                f"        → アップロードした動画は使われません。差し替えたいなら "
+                                f"youtubeVideoId を、既存動画のままでよいなら videoPath を消してください")
+                        key = v.get("youtubeVideoId") or v.get("videoPath")
+                        if not key:
+                            err(f"CP「{name}」の動画{k}本目が空です（{label}）")
+                        elif key in seen_v:
+                            err(f"CP「{name}」の動画{k}本目が他の動画と重複しています: {key}（{label}）")
+                        seen_v.add(key)
 
                 # TikTok の SINGLE_VIDEO は **動画とカバー画像の両方**が必要。
                 # 片方だけだと lint を通り、live で動画だけアップロードされた後に

package/skills/ad-ops//345/205/245/347/250/277/350/250/210/347/224/273/.ad-planner-plans

@@ -0,0 +1 @@
+ad-planner の入稿計画フォルダの目印です。消さないでください。