> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/rissu/changelog.md). # 変更履歴 公開バージョンごとのユーザー向け変更点 [`@getsquish/squish`](https://www.npmjs.com/package/@getsquish/squish)、新しい順です。日付は npm の公開日です。リリースノートは次の場所にもあります: [GitHub Releases](https://github.com/getsquish/squish/releases). ## 0.3.1 — 2026-07-18 Audio アクティビティは、低レートのタイムラインを生成する際に高周波エネルギーを保持するようになりました。 * 0.3.0 にあったリサンプリングの不具合を修正しました。これにより、500 Hz 超の連続音がほぼ無音に見えることがありました。Squish はシートや JSON で使うコンパクトな 1 kHz 表現に落とす前に、まずフルバンドのアクティビティ包絡を生成するようになりました。 * 契約やコマンドの変更はありません: `audio.samples[]`, `clip_peak`、CLI、およびローカル MCP は 0.3.0 の形状を維持します。音声のない動画と、無音トラックを含む動画は、それぞれ異なる結果のままです。 {% hint style="success" %} **よく知っている動画で 0.3.1 を試してください:** ```bash npx -y @getsquish/squish@0.3.1 clip.mov --json ``` JPEG のコンタクトシートには、フレーム、絶対タイムコード、そして audio-activity バンドが含まれます。AI に特定の瞬間を 1 つ見つけさせ、その範囲で Squish をもう一度実行してください。たとえば、 `--start 12 --end 18`— そうすると、より詳しく確認できます。CLI には Node.js 20 以上と ffmpeg が必要です。動画処理は引き続きお使いのマシン上で行われます。 {% endhint %} ## 0.3.0 — 2026-07-18 Audio アクティビティがローカルの mouths におけるナビゲーションチャネルになります。 * CLI/local MCP の各シートには、薄い **audio-activity バンド** が視覚グリッドの上部に表示され、同じ絶対的な元タイムラインに揃えられています。高エネルギーのピークはマーキングされるため、隣接フレームが似ていても、エージェントは確認したい範囲を選べます。 * JSON に次の `audio` object を追加しますが、v0 のフィールドは削除も改名もしていません: `present`, `normalization`、絶対 `ウィンドウ`、および `samples[]` (`time`, `level`）。ローカル MCP は同じ object を次とともに返します: `timecodes[][]`. * レベルには `正規化: clip_peak` がソースクリップ全体に対して適用されます。ウィンドウ指定の呼び出しも含みます。そのため、静かなズームは個別に正規化されて、すべての区間が大きく見えるようになるのではなく、オーバービューに対して静かなままです。 * アクティビティ包絡は、オーバービューのダウンサンプリング時に短い過渡成分を保持します。無音トラックのある動画はレベル 0 を返し、音声トラックのない動画でもシートを生成し、次を報告します `present: false`. * スコープの境界: アクティビティが答えるのは *音声エネルギーがいつ変化したか*であって、何が話されたか、あるいは何が音を出したかではありません。文字起こし、話者分離、音声イベント分類、感情推定は行いません。Web アプリ、ホスト型 API、およびリモート MCP は、別途リリースされるまでは引き続き視覚情報のみです。 * README と `video-navigation` スキルに 5 分のテスト手順が追加されました。答えを知っている動画を用意し、特定の瞬間を 1 つ尋ね、オーバービュー → ズーム と辿り、引用された時刻を元のソースと照合して確認します。 ## 0.2.3 — 2026-07-14 発見可能なリリースです。エージェントが自力で Squish を見つけられるようになりました。 * 公式の **MCP Registry** として [`io.github.getsquish/squish`](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.getsquish/squish): `package.json` には `mcpName` （レジストリの npm 所有マーカー） `server.json` では、両方の接続方法（この npm パッケージを stdio で使う方法 + ホスト型エンドポイント）を説明しており、タグ起動の OIDC ワークフローがリリースごとに一覧を公開します。 * **`video-navigation` エージェントスキル** リポジトリの `skills/` ディレクトリ — `npx skills add getsquish/squish` エージェントに、コンタクトシートを使うタイミング、ズームのループ、引用の作法を教えます。skills.sh に掲載されています。 * stdio MCP の正確性: `serverInfo` が実際のパッケージバージョンを報告するようになりました（以前はハードコードされた `0.2.0` が 2 リリースにわたって固定されていました）、そして `squish_video` には動作注釈が付与されています。シートはディスクに書き出され、マシンから外には何も出ません（クローズドワールド）。再実行すると同じ出力が上書きされます（冪等）。 * 新しいドキュメント: [AI エージェント向け](/squish/ja/hajimeni/for-ai-agents.md) （対象面を選ぶための判断表 + 動作ルール）と [サポート](/squish/ja/rissu/support.md). * ホスト型エンドポイント（同じエンジン、 **このパッケージには含まれません**）：Apps SDK のスキャンメタデータ（`outputSchema` + `structuredContent`、attachment `fileParams`）、subject キー付きの無料レーン、そして ChatGPT トラフィック向けの商用利用なしのクォータ経路です。ChatGPT アプリは 2026-07-12 にレビューへ提出されました。 * エンジンは変更ありません: `squish-cli-v0` と `squish-mcp-v0` の契約は 0.2.0 と同一です。 ## 0.2.2 — 2026-07-10 レンズ README とリモート mouth に認証が追加されました。 * README をレンズの原則を中心に再構成しました — *AI は答えではなくレンズを通して見ます。Squish がレンズを調整し、モデルが解釈します* — 新しい表紙（"Random access to video"）と公式アプリの導線（次を追加）を備えています `https://api.getsquish.app/mcp` をコネクタとして追加します。インストール不要です）。 * `squish_video` 現場の知見に基づいてツール説明を調整しました。1 回の呼び出しで済む経済性の説明（「1 回の呼び出しで、ダウンロード → ffmpeg → 抽出 → モンタージュ の一連のパイプライン全体を置き換えられる」）、密度とウィンドウの使い分けガイダンス、そして `timecodes[][]` ミラー注記 — プロンプトを変えなくても、エージェントがツールを選び、ループをよりうまく回せます。 * ホスト型エンドポイント（同じエンジン、 **このパッケージには含まれません**): `api.getsquish.app/mcp` にオプションの `Authorization: Bearer` API キーが追加されました（ホスト型 API と同じクレジットで、抽出前に差し引き、失敗時は自動返金）に加え、小さな匿名の無料レーンもあります。クォータ超過時は、エージェントが伝えられる構造化エラーで応答します。 **このパッケージ内のローカル CLI と MCP サーバーは、今後も常に無制限で利用できます。** * エンジンは変更ありません: `squish-cli-v0` と `squish-mcp-v0` の契約は 0.2.0 と同一です。 ## 0.2.1 — 2026-07-08 最初のオープンソースリリースです。次の背後にあるエンジンが `@getsquish/squish` が公開されました: [github.com/getsquish/squish](https://github.com/getsquish/squish) （Apache-2.0、創設時のモノレポを厳選してミラーしたものです。歴史はそこから始まります）。 * README をプリミティブを中心に再構成しました。動画をアドレス可能な表現として扱い、ナビゲーションループ（overview → zoom → cite）、そしてメタデモ — 76 秒の説明動画を同じ動画のコンタクトシートとして並べて表示します。 * `package.json` `リポジトリ` が公開リポジトリを指すようになったため、npm の「Repository」リンクが機能します。 * 追加しました `SECURITY.md` （GitHub Security Advisory を使った非公開の脆弱性報告）と、npm / CI / ライセンスのバッジを追加しました。 * エンジンは変更ありません: `squish-cli-v0` と `squish-mcp-v0` の契約は 0.2.0 と同一です。 ## 0.2.0 — 2026-07-07 ウィンドウ指定のシート — シートをナビゲート可能なアドレス空間に変えるリリースです。 * `--start` / `--end` CLI では `start` / `end` MCP の `squish_video` ツールウィンドウでは、実行範囲を指定できます。どちらも秒数（`90`）またはシートに記録されたものとまったく同じタイムコード（`1:30`, `1:07.3`). * タイムコードは **どのズーム深度でも元の動画に対して絶対的です** — ウィンドウ指定の実行でも基準を再設定しないため、オーバービュー → 範囲 → 瞬間 と繰り返し掘り下げられます。 * 適応的なタイムコード精度: 短いウィンドウではサブ秒のタイムコード（`1:07.3`）が付与されるため、隣接セルを区別できます。 * アドレス可能な下限: 1 セルあたり 2 ms 未満のウィンドウは、不明瞭なセルを生成する代わりに、学習用エラー（ズームアウトするか密度を下げてください）で拒否されます。 * ウィンドウ指定の `--json` 実行では、解決後の境界を次のように返します `"window": { "start": …, "end": … }`. ## 0.1.1 — 2026-07-06 npm パッケージページ向けに README を書き直しました。エンジンや契約の変更はありません。 ## 0.1.0 — 2026-07-06 次の初回公開です: `@getsquish/squish`：CLI と MCP サーバーを 1 つのパッケージにまとめました。 * CLI: `squish