# バージョン履歴
> 過去のバージョンを確認し、変更箇所を調べ、共有ドキュメントを復元します。
- Human documentation: [https://docs.univer.ai/ja-JP/overview/features/shared/history](https://docs.univer.ai/ja-JP/overview/features/shared/history)
- Agent Markdown: [https://docs.univer.ai/ja-JP/overview/features/shared/history.md](https://docs.univer.ai/ja-JP/overview/features/shared/history.md)
- Requested language: `ja-JP`
- Content language: `ja-JP`
- Documentation version: `1.3.0`
- Source: [features/shared/history.ja-JP.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/history.ja-JP.mdx)
---
バージョン履歴は、共同編集で確定した変更を閲覧可能なバージョンにまとめます。作成者、時刻、操作と過去の内容を確認し、権限があれば復元できます。ページを再読み込みしても履歴を参照できます。
## バージョン履歴の仕組み
- **Mutation**: セルの設定や段落の挿入など、再生可能な内容変更です。
- **Changeset**: 順序付きの Mutation をまとめた共同編集の送信単位です。
### 1. 変更を記録する
**編集内容を送信したときに実行されます。** ユーザーや Agent の変更は Mutation として Changeset にまとめられ、共同編集サービスへ送信されて確定・保存されます。
```mermaid
flowchart LR
A["内容を編集"]
B["Mutation"]
C["Changeset"]
D["確定して保存
revision を記録"]
A --> B
B --> C
C --> D
```
**Revision** は、確定済み送信のドキュメント履歴上の位置を表します。History は確定した Changeset のインデックスを作成し、時間と操作でグループ化してタイムラインに表示します。
### 2. 過去の内容を再構築する
**過去のバージョンを選択したときに実行されます。** Snapshot は特定の revision の完全な内容状態です。基準の Snapshot と目標 revision までの後続 Changeset を読み込み、Mutation を順番に再生して読み取り専用の履歴ビューを作成します。
```mermaid
flowchart LR
A["バージョンを選択
revision N"]
B["Snapshot と
後続 Changeset を取得"]
C["Mutation を
順番に再生"]
D["過去の内容を表示
読み取り専用"]
A --> B
B --> C
C --> D
```
例：**revision 10 の Snapshot + revision 11〜15 の Changeset = revision 15 の内容。**
### 3. 現在のドキュメントを復元する
**「このバージョンを復元」を選択したときに実行されます。**
> 対象バージョンを選択 → 復元 Mutation を送信 → 共同編集で確定 → 現在の内容を更新し、新しい revision を作成
復元操作も新しい履歴として記録され、以前のバージョンは引き続き保持されます。
## バージョンと変更を確認する
1. エディターからバージョン履歴を開き、バージョンを選択します。
2. グループを展開して個々の revision を表示し、読み取り専用ビューアーで内容と差分を確認します。
3. 「このバージョンを復元」を選ぶと、共同編集を通じて現在の共有内容が更新され、他の参加者にも反映されます。
一定時間内の編集はグループ化されることがあります。履歴項目は、必ずしも一回のキー入力や Snapshot の生成に対応しません。
### 変更の色
| 表示 | 意味 |
| --- | --- |
| 🟦 **青：更新** | 既存の内容、書式、オブジェクト属性の変更。 |
| 🟩 **緑：追加** | 新しい行、段落、レコード、ボードのオブジェクト。 |
| 🟥 **赤：削除** | 削除された内容を履歴ビューにマークして表示。 |
色は変更の種類を示します。テキストの置換では追加と削除が同時に表示される場合があります。強調表示の範囲は製品ごとに異なります。
## 5 製品の履歴ビュー
以下は英語の Northstar プロジェクトの例です。展開したタイムラインと内容を並べて確認できます。
### Sheets
Launch Budget で予算、予測値、行の追加と削除を確認します。
[Sheets — 導入ガイド](https://docs.univer.ai/ja-JP/guides/sheets/features/edit-history.md)
### Docs
Product Launch Brief で公開日、段落書式、顧客向け準備事項を確認します。削除されたテキストには赤い取り消し線が付きます。
[Docs — 導入ガイド](https://docs.univer.ai/ja-JP/guides/docs/features/edit-history.md)
### Slides
Launch Review で目標値とスライド上のオブジェクトの変化を追跡します。
[Slides — 導入ガイド](https://docs.univer.ai/ja-JP/guides/slides/features/edit-history.md)
### Relational Table
Launch Tracker でタスク、担当者、ステータス、レコードとフィールドの変更を確認します。
[Relational Table — 導入ガイド](https://docs.univer.ai/ja-JP/guides/bases/features/edit-history.md)
### Canvases
Release Workspace で計画カードとオブジェクト属性の変更を、ボード上の位置関係とともに確認します。
[Canvases — 導入ガイド](https://docs.univer.ai/ja-JP/guides/boards/features/edit-history.md)
### PDF
**Coming soon**: PDF のバージョン履歴はまだ提供されていません。
## アプリケーションへの導入
- **サーバー**：Core Collaboration に History Service、Endpoint、永続化用 Database Adapter を追加します。Unit 作成と changeset 確定イベントから履歴インデックスを構築し、バージョンと変更を照会します。
- **ブラウザー**：共通の履歴機能と製品の History / History UI プラグインを登録し、履歴 API に接続します。ビューアーは選択した revision と差分を読み込みます。独自コンテンツには対応するビューアープラグインが必要です。
- **権限**：アプリケーションが認証と認可を提供し、サーバーが履歴の読み取りと復元の権限を確認します。履歴には現在削除済みのデータも含まれます。
[共同編集の拡張](https://docs.univer.ai/ja-JP/server/collaboration/extensions.md)と [History の例](https://docs.univer.ai/ja-JP/server/collaboration/examples.md#history)を参照し、製品ガイドに従って UI を接続してください。
履歴インデックスは再構築可能な派生データです。確定した changeset が正本です。永続化と保持方針はアプリケーションが管理し、履歴パネルはバックアップの代わりにはなりません。
## 関連機能との違い
- **元に戻す / やり直す**：編集操作を取り消し、再適用します。履歴サービスは不要です。
- **バージョン履歴**：セッションをまたいで確定済みバージョンを追跡し、共有内容を復元します。
- [内容の比較](https://docs.univer.ai/ja-JP/overview/features/shared/compare.md)：2 つの状態を読み取り専用で比較します。復元は行いません。
- [Worktree](https://docs.univer.ai/ja-JP/overview/features/shared/worktree.md)：下書きの変更を分離し、レビュー後にマージを判断します。
Facade API による Agent の変更も、共同編集で確定すると同じ履歴に記録できます。内容比較と組み合わせて自動レビューを構築できます。
[機能一覧に戻る](https://docs.univer.ai/ja-JP/overview/features.md)