note-attach-pdf

記事へ印刷用 PDF を添付する。公開済み記事は --commit で再公開し、公開前の下書きは --draft-only でPDFカードを保存できる。note-publish（記事公開）がカバー/本文/価格/有料境界までは自動化したが、**PDF ファイル添付は markdown 不可の note プラットフォーム機能で従来「半手動」**だった領域を自動化する。note-edit-session のログイン済み永続プロファイルを再利用。

⚠️ 前提・背景

• 【最重要】note のファイルアップロードは 1日100件上限（2026-06-16 実証＝建設部門BK のPDF添453 を 18×5＋10 で100に達し、以降が全 ABORT「ファイルカード未検出」）。1マガジン=18 PDF なので 1日あたり最大5マガジン（余裕を見て4）まで。超過分は翌日に持ち越し（done-log＋per-article 冪等で自動再開、再公開は upload を消費しない）。失敗が「embedsBefore==embedsAfter・pdfVisible=false」で連続するときは上限到達を疑う（PDF破損やセレクタ不良ではない）。
• 記事本文に「印刷用PDF｜本記事の模範解答」節（説明文）があっても、PDF ファイル本体は別途 note エディタで添付しないと出ない（markdown では貼れない）。本スキルがその添付を自動化。
• PDF は既定で本文末尾（有料記事なら有料エリア内＝購入者のみ可）。--anchor "<段落テキスト>" で指定段落の直後に挿入でき、無料記事で各セクション内に PDF を配置する用途に使う（未指定＝末尾／未検出＝exit 7 ABORT で誤挿入防止・複数を順に積むときは --force 併用）。
• note の公開ボタン「更新する／投稿する」は公開設定ページに無く、有料エリア設定ビューに出現する。既存の有料線は「このラインより先を有料にする」バーで表示され、その位置には「ラインをこの場所に変更」ボタンが無い → 試験問題/予想問題直前の制御がバーなら触らない・変更ボタンなら寄せる（さもないと正しい線を動かす）。

使い方

# 1マガジン分を直列バッチ（frontmatter noteId ↔ 同dir PDF を突合・done-logで再開・1記事最大2回試行）
node scripts/note-attach-magazine-pdfs.mjs --dir <magazineDir>            # dry（対象一覧のみ）
node scripts/note-attach-magazine-pdfs.mjs --dir <magazineDir> --commit   # 実添付

# 1記事だけ（単体ツール）
node scripts/note-attach-file.mjs --note <noteKey> --file <pdf path>            # probe（挿入メニュー構造ダンプ）
node scripts/note-attach-file.mjs --note <noteKey> --file <pdf path> --draft-only # 下書きへ実添付して保存
node scripts/note-attach-file.mjs --note <noteKey> --file <pdf path> --commit   # 実添付（既定＝本文末尾へ）

# 各セクション内に配置（無料記事など）: 指定テキストを含む最小段落の直後へ挿入（未検出は exit 7 ABORT＝誤挿入防止）
node scripts/note-attach-file.mjs --note <noteKey> --file <pdf path> --anchor "<段落の一部>" --commit --force

• マッピング: <magazineDir>/<year>/article-<type>.md の frontmatter noteId と同 dir の PDF（II1→/-II-1-/ ・II2→/-II-2-/ ・III→/-III-/）を突合。noteId 無し（未公開）はスキップ。

フロー（実機確定・2026-06-16）

1. account=dobokunote ゲート（ページ描画遅延に強い polling・偽 ABORT 防止）
2. editor.note.com/notes/{key}/edit → 挿入位置へ caret 移動（既定＝本文末尾を JS で選択／--anchor 指定時は当該段落の直後・未検出は ABORT）→ Enter →「+」（aria-label「メニューを開く」）→「ファイル」→ native filechooser で PDF
3. アップロード成功検証（埋め込み数増、または出典URLを除いたPDFファイル名の件数増）
4. --draft-only: 「下書き保存」または「一時保存」→エディタを再読込し、要求したPDFファイル名の添付が残ることを検証して終了
5. --commit: 「公開に進む」→「有料エリア設定」→ 有料エリアビューの描画待ち→ 既存境界を非破壊検証（試験問題/予想問題直前=between0・崩れたら中断）→「更新する」
6. --commit の偽成功ガード: 公開ページを curl して有料維持（購入手続き 等）を実体確認

完了条件（添付は「実行した」では終わらない）

note-attach-file --draft-only は保存後にエディタを再読込し、要求したPDFファイル名の添付がなければ exit 9。--commit は再公開後にライブの添付リンク数を実測し、0 なら exit 9（「更新するを押せた＝添付できた」ではない）。両オプションは同時指定できない。横断確認は:

node scripts/check-note-attachments.mjs --live   # 期待本数 vs ライブ実測

ディスク上に PDF がある公開記事すべてについて、note ライブの添付リンク（api/v2/attachments/download）本数を著者ログインで実測し、不足を exit 1 で落とす。不足と出た記事は、スナップショットへ書く前に単独条件（再読み込み・段階スクロール・長い settle）で必ず測り直す（2026-09-05／09-06 に、--only なら充足なのに全件走査だけ live=0 と報告する取りこぼしが 2 件出たため・DN-0176）。出力の「暫定不足 → 再実測で解消 / 確定不足」は、確定不足だけが本物の欠落で、解消分は全件走査の偽陰性。待ちは NOTE_ATTACH_SETTLE_MS / NOTE_ATTACH_CONFIRM_SETTLE_MS / NOTE_ATTACH_CONFIRM_WAIT_MS で伸ばせる（プロキシ下で有効）。未ログインの HTML には有料エリアの添付カードが出ないため、この live 層は CI は login-collectors.yml（encrypted-state・canary卒業後）。ローカル実行はフォールバック（CI 側は npm run check-note-attachments が「約束した PDF がディスクに在るか」だけを見る）。

[!warning] 本文の全文置換は添付を消す note-update-body（Ctrl+A → Delete → paste）は本文内の PDF 添付カードごと消す。SoT の markdown に添付は無いので paste では戻らない。2026-07-28、建設部門の送客リンク是正で 196 本を全文置換し、6/16 に添付した PDF カードを失った。語句・段落・CTA・カード・節順だけを直す場合は npm run note-update-partial -- --spec <json> [--commit] を使う。複数記事は --list <spec一覧.txt> で同じ Chrome セッションから直列処理できる。この CLI は select-all を使わず、更新前後と公開後再読で PDF 添付 URL/ファイル名の完全一致を要求する。全文置換が不可避な場合だけ note-update-body --reattach-pdf、画像だけなら --images-only を使う。

冪等・安全弁

• 冪等: 出典URLを除いたPDFファイル名が既にあれば再添付しない。--draft-only は利用可能な保存ボタンで保存し、再読込して要求ファイル名を検証する。--commit は再公開のみ実行する。バッチは done-log でスキップ・失敗で停止→再実行で再開。
• --boundary-regex "<H2先頭一致>" で記事の paidBoundary に合わせる（既定は「試験問題|予想問題」）。口頭教材などは固有の見出しを指定する。
• 境界が崩れたら再公開しない（無料漏れ防止のゲート）。
• ユーザー起動限定（disable-model-invocation）＋サブエージェント化しない（決定的フロー＝原則5）。
• 実績: BK-02 河川砂防・BK-03 都市計画 各18記事を添付（公開ページで有料維持＋ダウンロードカード実在を全件実査）。

関連

• scripts/note-attach-file.mjs（1記事）／scripts/note-attach-magazine-pdfs.mjs（マガジン直列バッチ）
• 記事公開: note-publish ／ マガジンカバー: note-magazine-cover ／ 収録: note-magazine-add
• 印刷用 PDF 生成: note マガジンは scripts/magazine-to-pdf.mjs（magazine-pdf-builder）、択一演習は scripts/build-takuitsu-pdf.mjs --spec <json>。択一specは bookId / title / subtitle / sources が必須で、自作問題は任意の creditText に出典説明を書く。生成器はMDXコメントを除去し、Calloutを要点ボックスへ変換し、システムChromeで描画する。真実源 .claude/knowledge/reference/note-api-verification.md・[[project_note_write_automation]]