バージョン管理ガイド

大切な変更をいつでも復元可能に

Koinote が履歴を保持し、ブラウザと Agent の同時編集を調整し、誤操作から内容を復元する仕組みを説明します。

履歴の仕組み

ブラウザ編集と MCP 書き込みは同じ revision と履歴ポリシーを使います。履歴は確認と復元に使われ、revision 検証は古い内容による静かな上書きを防ぎます。

会員資格と保持上限

バージョン履歴は永久会員向けです。文書ごとに 1〜100 件、アカウント全体で合計 100 件まで保持し、上限を超えると古い履歴から削除します。

主な機能

  • 間隔をまとめて保存 — 通常の Web 編集は自動保存のたびではなく、一定間隔でスナップショットを作ります。
  • 柔軟な上限 — 履歴の有効・無効と、文書ごとの 1〜100 件の保持数を設定できます。
  • 安全スナップショット — MCP 完全履歴を無効にしても、Agent の置換前に直近の復元可能な状態を残します。
  • 競合検出 — 更新には最新 revision が必要で、古い書き込みは新しい内容を上書きせず失敗します。
  • 取り消せる復元 — 古い版を復元する前に現在の状態を保存するため、復元自体も元に戻せます。

Web で確認・復元する

  1. エディターのツールバーからバージョン履歴を開き、現在の文書に残る履歴を確認します。
  2. 各履歴には時刻と、Web エディター・MCP Agent・復元のいずれかの出所が表示されます。
  3. 復元すると選んだ版が現在の内容になり、復元前の状態も回復ポイントとして保持されます。

MCP 書き込みの履歴設定

  • Agent の書き込みで完全な履歴を残すかを個別に選択できます。
  • 完全履歴を無効にしても、文書全体を置換する前の安全スナップショットは残ります。
  • 書き込み権限のある MCP クライアントは設定を確認・変更でき、読み取り専用トークンは確認だけできます。

おすすめ設定

重要な文書では履歴と MCP 完全履歴を有効にしてください。アカウント全体の 100 件上限を考慮して文書ごとの保持数を決め、Agent が全文を置換する前に最新 revision を読むよう指示します。