# 保存と復元

同梱リポジトリ版: (ZIP配布物ではここにバージョンが記載されます)

このソフトでは、元の PDF やノートを守るため、編集途中の保護と原本への保存を分けています。ここでいう「統合」は、保護されていた変更を元のファイルへ安全に反映することです。

## 保存の流れ

このソフトは、編集内容をすぐに原本へ書き込むのではなく、次の順で扱います。

1. 編集内容を stage に保護する
2. 利用者が `Ctrl+S` または保存メニューを選ぶ
3. バックアップを作成する
4. 安全な書込みを完了してから原本へ統合する

このため、編集途中のノートや PDF 注釈を守りつつ、原本の途中書込みを避けます。

`Ctrl+S` を押しても、ただちに危険な上書きをするわけではありません。安全な書込みとバックアップ作成が完了したときだけ、原本を更新します。

## 使い分け

- 編集を続ける: 通常どおり編集します。自動 stage 保護が途中状態を保持します。
- 区切りよく確定する: `Ctrl+S` または保存メニューで統合します。
- 未統合の変更を確認する: 「操作 > 差分管理...」または「保存 > 差分管理...」を開きます。
- 保存済みの状態へ戻す: 「保存 > 復元/バックアップ...」を開きます。

## 保存前に確認すると安心なこと

- 作業フォルダに十分な空き容量があること
- 保存先のファイルを、他のソフトで開いたままにしていないこと
- 差分管理に、意図しない未統合の変更が残っていないこと

大きな編集の前や、外部へ渡す前には、`Ctrl+S` で一度統合してからワークスペースを丸ごとコピーしておくと、元に戻す判断がしやすくなります。

## 復元前の注意

未統合のノートや注釈がある状態で原本だけを復元すると、原本と stage の状態が異なることがあります。復元前に、差分管理で内容を確認するか、意図に応じて先に `Ctrl+S` で統合してください。

復元する理由が「直前の編集を取り消したい」だけなのか、「保存済みの以前の状態へ戻したい」のかを分けて考えてください。前者は編集画面の undo/redo、後者は復元/バックアップを使います。保存後の undo/redo 履歴は保持されないため、保存後に戻す場合はバックアップを使います。

## 主な保存先

- stage: `__resource__/__tmp__/__stage__/`
- バックアップ: `__resource__/__escape__/backup/`
- ノート保存失敗時の退避: `__resource__/__escape__/note_recovery/`

これらのフォルダを、問題の確認前に削除しないでください。

## 保存に失敗したとき

エラーが出た場合は、アプリをすぐに何度も再起動したり、stage やバックアップを削除したりしないでください。エラー表示、対象ファイル名、操作時刻を控え、[How_to_Troubleshoot.md](How_to_Troubleshoot.md) の手順に従ってください。