plugin: clip-attachments-export — クリップ収録ノートの添付を一括保存

[hitalin]

概要

クリップを指定して、収録ノートの添付ファイルをまとめてローカル保存するプラグイン。read 系 capability (clips.list / clips.notes) と write 系 (files.export) を合成するモデルケース — 「本体は汎用の土台、個別ニーズはプラグイン」の分担 (notedeck#92 の再スコープ方針) を実証する。

動作

1. コマンドパレット (Nd:register_command) から起動
2. Nd:call('clips.list') でクリップ一覧を出し、ユーザーに選ばせる
3. Nd:call('clips.notes', { clipId }) で収録ノートの id を列挙
4. Nd:call('files.export', { noteIds, subdir: <クリップ名> }) で保存。100 件/回の上限があるためチャンク分割して逐次呼ぶ (冪等スキップがあるので途中失敗しても再実行するだけでよい)

要点

• 追加権限: clips.read + files.export
• subdir にクリップ名を渡すことで Downloads/notedeck/ 配下がクリップ単位に整理される (パス表現は capability 側 preflight が拒否するため、名前はそのまま渡してよい — サニタイズは本体側)
• 「お気に入りの添付を保存」も同型で作れる (favorites 系 capability に置き換えるだけ)。まずクリップ版で型を作る

関連

• notedeck#813 (files.export capability) / notedeck#92 (保存下回り)