Social Archiver の変更点

CLI 0.2.0 のアップデートが Microsoft Store を通じて Windows にも届きます。Windows の `social-archiver executor` も、モバイルアプリからパソコンに任せた「この投稿をリサーチ」のジョブを受け取って処理します。

• macOS・Linux(Homebrew、npm、インストールスクリプト)では 0.2.0 から変わる点はありません。
• リサーチにはウェブ検索ができる AI CLI(Claude Code、Codex など)が必要です。

`social-archiver executor` が、モバイルアプリからパソコンに任せた「この投稿をリサーチ」のジョブを受け取り、このパソコンにインストールされた AI CLI(Claude Code、Codex など)で背景・主張の検証・出典をまとめたレポートを作成して保存します。

• リサーチはウェブ検索ができる AI CLI で実行します。Apple Intelligence のヘルパーしかないパソコンはリサーチのジョブを受け取りません。
• 自分の AI API キーはデスクトップアプリ・Obsidian プラグイン・モバイルアプリでのみ使います。CLI はキーを保管しないため、自分のキーで実行するジョブは受け取りません。
• デスクトップアプリに内蔵の実行機能も、デスクトップ 0.9.0 で同じアップデートを受けました。

タグの付いた動画を 1 つのコマンドで文字起こしし、動画の画面に表示された文字を読み取り、1 つのタグの投稿をタグ・文字起こし・画面の文字と一緒に書き出せます。Codex や Claude Code のようなエージェントが、動画の多い投稿もテキストとして分析できます。

• タグで書き出し: 書き出したファイルに投稿のタグが入り、--tag で 1 つのタグの投稿だけを書き出せます。ほかのデバイスで外したタグを push が付け直しません。
• タグで文字起こし: transcribe --tag <名前>（または複数のアーカイブ ID）は、音声・動画のない投稿と文字起こし済みの投稿をスキップします。--run を付けると、このコンピューターで 1 本ずつ文字起こしします。
• Instagram・Facebook・X の動画: --run がアーカイブに保存されたコピーをダウンロードして文字起こしします。yt-dlp が必要なのは YouTube と TikTok のリンクだけです。
• Mac では Whisper のインストール不要: デスクトップアプリが入っていれば、CLI はアプリの WhisperKit とアプリでダウンロードしたモデルをそのまま使います。Homebrew や npm でインストールした CLI も同じです。
• 画面の文字: 新しい screen-text コマンドが動画の画面に表示された字幕や文字を読み取り、ノートとして保存します。書き出しにも含まれます（macOS、デスクトップアプリ 0.8.19 以降）。
• executor: スマートフォンでリーダーの選択範囲に尋ねた Ask AI の質問にも答えます。
• whisper.cpp: WhisperKit の名前で選んだモデルを whisper.cpp のモデルとして見つけ、モデルがなければ WhisperKit に切り替えます。
• デスクトップアプリ 0.8.19 に同じバージョンが入っています。

executor で実行する文字起こしが 10 分を超えても最初からやり直さず、ほかのデバイスからのキャンセルに従い、デスクトップアプリが管理する yt-dlp を優先して使います。

• 長い文字起こし: 進行状況がしばらく変わらないと、サーバーが 10 分後にジョブを破棄して最初からやり直していた問題を直しました。CPU で時間のかかる Whisper の文字起こしも最後まで進みます。
• 進行状況: 映像と音声を別々にダウンロードする YouTube 動画で進行状況が 2 回満ちたり、ダウンロードから文字起こしに移るときに後戻りしたりしません。
• キャンセル: スマートフォンなどほかのデバイスで文字起こしをキャンセルすると、実行中のジョブが止まります。
• yt-dlp: デスクトップアプリが管理する yt-dlp がインストールされていれば、PATH 上の古い yt-dlp より優先して使います。
• デスクトップアプリ 0.8.7 に同じバージョンが入っています。

export がサーバーの Whisper の文字起こしも出力し、YouTube 字幕の時刻を正しく出力します。--help にはこの CLI で実行できるコマンドだけが表示されます。

• export: 文字起こししたTikTokやポッドキャストをエクスポートするとWhisperの文字起こしが抜ける問題と、YouTube字幕のすべての行が [00:00] になる問題を直しました。本文にすでに文字起こしがあれば重ねて追加しません。
• --help: profile-crawl、sync、jobs など、この CLI では SERVICE_NOT_READY しか返さないコマンドを一覧から外しました。
• デスクトップアプリ 0.8.6 に同じバージョンが入っています。

archive --collection で、投稿をアーカイブしながらコレクションに入れられます。コレクションは ID か正確な名前で指定し、複数はカンマで区切ります。アーカイブが終わるとサーバーが追加します。

• archive --url <url> --collection "台湾旅行,あとで読む": 最大 50 件。collections コマンドと同じ規則（ID、なければ正確な名前、重なれば自分のコレクションを優先）で探します。
• 一致するコレクションがない場合や閲覧者のコレクションの場合は、何も送らずに INVALID_ARGUMENT で止まります。
• 同じ URL を別のコレクションで送り直すと新しいリクエストとして扱い、前の応答をそのまま返しません。
• Obsidian CLI の archive コマンドも collection= で同じことができます（プラグイン 4.9.0）。

新しい collections コマンドは、アプリと同じコレクションを扱います。コレクションの一覧表示、1 つのコレクションに入っているすべてのメンバーの投稿の確認、コレクションの作成、エクスポートしたファイルやアーカイブ ID による投稿の追加と削除、共有リンクの表示と作成ができます。非公開のコレクションを共有するには --yes が必要です。

• collections: list（役割と自分が追加した投稿数）、show（すべてのメンバーの投稿を新しい順に）、create（同じ名前の自分のコレクションがあればそれを返す）、add/remove（エクスポートしたファイルまたは --archive ID）、link、share --yes。
• コレクションは ID か正確な名前で指定します。名前が重なると自分のコレクションが優先され、共有された同じ名前のコレクションが 2 つある場合は ID が必要です。
• 共有: share --yes（オーナーのみ）は非公開のコレクションをリンクを知っている人に公開し、公開には切り替えません。link はリンクを表示するだけで、共有後はメンバーも確認できます。

ライブラリにすでにある投稿を archive に送ると、新しく保存されずクレジットも使われませんが、結果は新しく保存したときとまったく同じに見えていました。そのため、プロフィールを順にたどるスクリプトやエージェントは、以前保存した投稿に達したことを判断できませんでした。結果に cached: true（--format text では cached=true）が表示されるようになりました。同時アーカイブの上限で Pro へのアップグレードを勧めていた文言も修正しました。

• 保存済みの投稿: archive が "cached": true を返し、jobId は既存のアーカイブ ID になります。これまでどおり新しく保存されず、クレジットも使われません。
• プロフィールを新しい順にたどるスクリプトやエージェントは、cached の結果が続き始めたところで止められます。以前保存した投稿を送り直す必要はありません。
• 同時アーカイブの上限: すでに 2 件のアーカイブが進行中のとき、Pro へのアップグレードではなく "Too many archives in progress. Try again when one finishes." と表示されます。この上限はすべてのプランで同じです。

social-archiver executor が Apple Intelligence で要約すると、要約ではなく「ファクトチェック結果・主張・判定・出典」の形式で答えが返ることがありました。すべての AI リクエストに付いていたファクトチェック用のラベル例を、オンデバイスモデルが出力形式として真似していたためで、この例はファクトチェックのリクエストにだけ含めるようにしました。モデルが文ごとに角括弧を付けた要約で、最初の 3 文が消えていた問題も修正しました。

• Apple Intelligence の要約: 「ファクトチェック結果 / 主張 / 判定 / 出典」の形式で返らなくなりました。同じ投稿でもう一度実行したところ、ファクトチェックの形式になった要約はありませんでした。
• 角括弧の要約: モデルが文ごとに [ ] を付けて答えても、最初の 3 文が消えなくなりました。
• すでに保存された要約は書き換わりません。ファクトチェックのように返った要約や、短く切れた要約は削除してもう一度実行してください。
• Obsidian プラグインが実行機を動かしている場合は、CLI を更新（brew upgrade social-archiver-cli または npm）してから Obsidian を再起動してください。

social-archiver executor --watch が、待っている AI 作業を次のポーリングですぐに受け取ります。既定の 15 秒間隔なら約 10 秒で始まり、以前は最大 2 分待つことがありました。また、6 時間ごとに自分にできることをサーバーへ伝え直します。サーバーは 1 日以上連絡のない実行機に作業を送らないため、1 日以上動かし続けた実行機（Obsidian プラグインがバックグラウンドで動かす実行機を含む）は、再起動するまで作業を受け取れませんでした。Mac のスリープ中の時間も数えるので、スリープから復帰した最初のポーリングで追いつきます。さらに social-archiver <コマンド> --help がコマンドを実行せずに使い方を表示します。以前は executor --help で実行機が実際に動いていました。

• executor --watch が待っている AI 作業を次のポーリングで受け取ります。既定の --poll 15 で約 10 秒（以前は最大 2 分）です。
• 1 日以上動かし続けた実行機も作業を受け取り続けます。6 時間ごと、そして Mac がスリープから復帰した最初のポーリングで状態を送り直します。
• social-archiver <コマンド> --help（-h）がコマンドを実行せずに使い方を表示します。
• Obsidian プラグインが実行機を動かしている場合は、CLI を更新（brew upgrade social-archiver-cli または npm）してから Obsidian を再起動してください。
• 文字起こしの作業はこれまでどおり約 2 分以内に受け取ります。

macOS 用の CLI アーカイブに Apple Intelligence ヘルパー（social-archiver-applefm）が同梱されます。macOS 26 以降で Apple Intelligence を有効にした Apple silicon Mac で social-archiver executor を動かすと provider に apple が現れ、要約・要点・用語集・整形・翻訳・タグ提案・場所抽出を Mac 内のモデルで処理します。アカウントもクレジットも不要で、テキストは Mac の外に出ません。ファクトチェックと字幕の翻訳は引き続きクラウドの provider が担当します。モデルのコンテキストは 4,096 トークンなので、長すぎる投稿は事前に断られます。Homebrew（brew upgrade social-archiver-cli）、npm、インストールスクリプトのいずれもヘルパーを CLI の隣に置きます。デスクトップアプリと同じヘルパーなので動作も同じです。

• social-archiver executor が Apple Intelligence を provider として使えます（macOS 26 以降、Apple silicon）。Mac の中で処理され、アカウントもクレジットも不要です。
• social-archiver executor --providers に apple が表示され、準備できていない理由（モデルのダウンロード中、Apple Intelligence がオフなど）も分かります。
• ファクトチェックと字幕の翻訳は対象外です。4,096 トークンを超える投稿は事前に断られます。
• ヘルパーは CLI の隣に置く必要があります。Homebrew・npm・インストールスクリプトはそうします。手動インストールでは 2 つのファイルを同じフォルダに置いてください。
• Windows・Linux のビルドに変更はありません。

CLI を実行機として使うとき Codex（ChatGPT）が要求を断ると、これまでは「AI action failed.」としか残りませんでした。Codex は理由をエラー出力ではなく JSON 出力に書くため、その理由が捨てられていたのです。CLI がその行を読み取りモデルの問題として報告するようになったので、アカウントで使えなくなったモデルを要求したときに何が起きたか分かります。9月8日ごろから ChatGPT アカウントの Codex が gpt-5.4-mini を提供しなくなり要約がすべて失敗していた問題自体は、サーバー側で既定モデルを gpt-5.5 に変えて解決済みなので、更新しなくても要約は再び動きます。

• Codex が断ったときは、Codex が出力した実際の理由が報告されます。
• 使えないモデルを要求した場合はモデルの問題として分類されます。
• 要約が失敗していた原因はサーバー側で解決済みです。

CLI を実行機として使うと、AI コメントはこのパソコン上で生成されます。しかし「sonnet」のように別名でモデルを選ぶと、その別名しか残らず、後からコメントを見ても実際にどのバージョンが答えを書いたのか分かりませんでした。今回から、CLI は実行中にプロバイダーが知らせる実際のモデル名を受け取り、コメントと一緒に記録します。「sonnet」で依頼しても結果には「Sonnet 4.5」という実際に動いたバージョンが残り、モバイル・デスクトップ・共有ページのどこで開いても同じ名前が表示されます。依頼時に選んだ別名もそのまま保管するので、何を依頼して何が実行されたかの両方が残ります。このバージョン以降に作成したコメントに適用されます。

• 別名で依頼しても、実際に実行されたモデル名がコメントに残ります。
• 依頼した別名と実行されたモデルの両方を保管します。
• モバイル・デスクトップ・共有ページのどこで開いても同じ名前が表示されます。

`social-archiver executor --watch` は待機中の作業があるかを確認するため、15秒ごとにサーバーへ3回別々に問い合わせていました。実行機はほとんどの時間を待機に費やすにもかかわらずです。今後、待機中は1回でまとめて確認し、実際に作業がある場合のみ従来の種類別確認を行います。作業の取得と実行の仕組みは変わらないため動作に違いはなく、確認リクエストだけが減ります。サーバーがまとめて応答できない場合や応答が不正な場合は静かに従来の確認を行うため、作業を取りこぼすことはありません。

• 待機中の確認が15秒ごとの3回から1回になりました。作業の実行方法は変わりません。
• 実際に作業がある場合は、従来どおり種類別に確認して実行します。
• まとめた確認ができない場合や応答が不正な場合は、自動的に従来の確認方式へ戻ります。

2 件の修正です。まず、Windows で executor --watch が CLI 検出直後にランタイムクラッシュで終了する問題 — ツールのバージョン確認サブプロセスの起動方法を変更して解決しました。次に、検出は正常なのに AI 要約ジョブだけが PROVIDER_MISSING で失敗する問題の真の原因を特定しました: 実行機がサーバーから取得するジョブ情報に、どの AI を使うか（プロバイダー）が欠けていました。サーバー側も同時に修正したため、インストール済みの 0.1.9・0.1.10 やデスクトップアプリも更新なしでそのまま正常動作します。

• Windows で executor --watch が検出直後にクラッシュする問題を修正しました。監視モードが最後まで動作します。
• AI ジョブがプロバイダー情報なしでサーバーから届いて失敗する問題をサーバー側と合わせて修正 — 既存インストールも即座に回復します。
• 実行機がジョブ詳細を取得する際にクライアント ID を送るようにし、常に完全なジョブ情報を受け取ります。

Claude・Gemini・Codex CLI が正しくインストールされているのに実行機が「未インストール」と報告し、AI 要約ジョブが PROVIDER_MISSING で失敗することがありました。原因は、実行機がよく知られたインストール先だけを確認していたことです — 公式インストーラーや nvm・volta・scoop は別の場所に置くため、特に Windows の Claude Code と Codex が該当しました。今後は、ターミナルでそのコマンドが動くなら実行機も同じように見つけます。あわせて、あるマシンで失敗した AI ジョブはそこで終わりにせず、同じアカウントの別の実行機（Obsidian プラグインやデスクトップアプリ）が引き継いで完了できるようになりました。

• AI CLI の検出がターミナルと同じ方法でコマンドを解決します — 公式インストーラー、npm、nvm・volta・fnm、scoop などインストール方法を問わず認識されます。
• Windows で Claude Code と Codex が検出されない問題を修正しました。従来は npm でのインストールのみ認識されていました。
• AI 要約・翻訳などのジョブが 1 台の実行機で失敗してもそこで終わらず、まもなく別の実行機が引き継いで完了します。
• 再試行の回数はサーバー側で制限されるため、どの実行機も処理できない場合は明確に失敗として表示されます。

これまで CLI は購読の作成しかできませんでした。一時停止も、一覧の確認も、新しい投稿が届かなくなった理由の調査も、アプリを開く必要がありました。今回からそのすべてがターミナルで行え、実行履歴には各回の保存件数・消費クレジット・失敗時の理由が表示されます。同じコマンドは Obsidian プラグイン CLI にも 4.6.6 で追加され、どちらでも同じように動作します。

• 購読の一覧表示、一時停止と再開、その場での実行、不要になったものの削除ができます。
• 実行履歴から自分で原因を確認できます — 各回の保存件数とクレジット、失敗時はその理由も表示されます。
• 一時停止しても進行位置は保持されるため、再開時に停止期間中の投稿を取りこぼしません。
• 削除は確認フラグを付けた場合のみ実行され、すでに保存されたアーカイブはそのまま残ります。
• Obsidian プラグイン CLI にも同じコマンドに加えて、場所候補のレビューと受信箱の一括整理が追加されました（プラグイン 4.6.6）。

ターミナルからアーカイブの作成・検索・整理ができる単独実行ツールです。Windows・macOS・Linux に対応し、デスクトップアプリも Node.js も必要ありません。0.1.5 では Microsoft Store での公開によりすべてのインストール経路が揃い、エクスポートにアーカイブの場所・商品情報も含まれるようになりました。全コマンドの使い方は CLI ガイドにまとめています。

• インストールはどこでも1行です。Windows は Microsoft Store または winget、macOS は Homebrew、macOS・Linux はチェックサム検証付きインストーラー、Node.js があれば npm でも導入できます。デスクトップアプリは不要です。
• アーカイブして探す: URL をアーカイブし、サーバー側でアーカイブ全体を検索し、投稿を Inbox と Archived の間で移動し、公開プロフィールを購読できます。
• ローカルで整理する: export でアーカイブを Markdown として取得し、grep で探し、タグやノートを付け、push でサーバーへ戻します。一度取得すれば、その後の検索にサーバー呼び出しはかかりません。
• 0.1.5 の新機能 — エクスポートした Markdown に場所（名称・住所・座標・カテゴリ）と商品情報（価格・通貨・在庫状況・ブランド・評価）が含まれます。新しい places コマンドで、抽出された候補を根拠とともに確認し、確定または解除できます。
• AI の作業もターミナルで: AI コメントを依頼し、executor でローカルの AI ツールを使って自分で実行し、動画・音声アーカイブを文字起こしできます。
• コーディングエージェントを前提に作られています。すべてのコマンドが同じ JSON 形式で応答し、スキルバンドルを導入すれば Claude Code・Codex・OpenCode が安全に操作できます。