Updates and Backups ja JP - on22s/Side-Story GitHub Wiki

English · 简体中文 · 日本語

更新とバックアップ

更新、リセット、移設、大きな学習／ライブラリー操作の前に保存とバックアップを行います。Gitが追跡するのはコードであり、生成したプロジェクトをバックアップするものではありません。

ホーム · 関連：インストール、スクリプト、問題の切り分け

更新前

  1. 生成、レビュー、音声生成、準備、学習、書き出しを完了させるかUIでキャンセルし、停止を待ちます。
  2. Scriptライブラリーに保存し、必要なスナップショット／チェックポイントを保持します。保存済みスクリプトには音声、原文アップロード、全設定／ライブラリーは含まれません。
  3. アプリと、そのデータを書き込む別プロセスを止めます。
  4. 実際のデータ・設定場所を別の保存先へ、付随ファイルとサブフォルダーごとコピーします。
  5. チェックアウトのリビジョンとローカルコード／環境変更を記録します。

書き込みを止めることで異なる時点のJSON、チェックポイント、音声の混在を減らせます。原本と代替できない録音も独立して保持してください。

通常のPinokio／チェックアウトで保存するもの

パス指定がなければ変更可能データはチェックアウト直下、設定とアップロードは従来の app/ にあります。

対象 既定の保存場所
設定 app/config.json
作業中の本と声 annotated_script.json、chunks.json、state.json、voices.json、voice_config.json、character_aliases.json と付随／journalファイル
生成・レビュー進捗 チェックポイントのヘッダーと対応partsフォルダー、スナップショット、品質manifest、review receipt
原文 app/uploads/
保存済みスクリプト 声・メタデータも含む scripts/ 全体
生成・出力音声 voicelines/、cloned_audiobook.mp3、audiobook.m4b、章、別保存／取得した出力ZIP
再利用する声・配役 voice_library.json、designed_voices/、clone_voices/
学習・データセット manifest／メタデータを含む lora_models/、lora_datasets/、dataset_builder/、preparer_output/、外部データフォルダー
高度な設定・記録 voicelab_config.json、reports/、run_history/、evaluation_reviews/、保持したいログ
別途用意した素材 GGUF、モデル／Python設定、取得済みプリセットアダプター、上記外の参照音声

最も確実な全体スナップショットは停止したチェックアウトと外部データ／素材をまとめたコピーです。環境や再取得可能キャッシュは再作成方法が分かる場合だけ除外します。他OSのPython環境を復元したりGPU環境の移植性を仮定したりしないでください。

チェックポイントのJSONは *.parts-<id> のような隣接フォルダーを参照します。ヘッダーだけでは復元できない場合があります。chunksの状態journalも同じ時点の chunks.json と保持します。

独自パス

  • ALEXANDRIA_DATA_DIR は変更可能データルートを移します。既定以外ならアップロードはその uploads/、設定既定はその config.json。
  • ALEXANDRIA_CONFIG_PATH は設定だけを独立して指定します。
  • Voice Lab、Preparer、クローン参照、外部ツールの追加場所も別途保存します。
  • プリセットアダプターはチェックアウトの builtin_lora/ に関連し、独自データルートだけで全部保護されるわけではありません。

パスと環境変数名を記録します。設定にはAPIキー、本文・録音・ログには非公開情報が含まれ得ます。env:NAME 参照は秘密値を含まないので移行先に安全に復元してください。

PinokioのUpdate

  1. バックアップ。
  2. Update を選択。
  3. ターミナルを確認。起動ツールが把握する書き込み処理を止め、git pull と基本インストールを実行します。
  4. ローカル変更／競合は保持して解決し、更新のためだけに破棄しないでください。
  5. 起動後、Setup、保存スクリプト、声ライブラリー、短い音声を確認。
  6. 任意のネイティブ依存関係が変わった場合は停止して Install Voice Tools (Optional) を再実行。

中断タスクの回復や古いチェックポイント互換性は保証されません。重要作業と短い試験を確認するまでバックアップを保持します。Reinstall は基本依存関係の再導入で、Resetと異なり、単独では新コードを取得しません。

Dockerの更新

  1. 実行タスク停止後に docker compose stop。
  2. data/runtime/ だけでなく data/ 全体 を保存。
  3. 重みの再取得を避けたいなら既存の名前付きHugging Faceキャッシュを維持。通常更新でボリューム削除をしません。
  4. 同じプロジェクトでコードを更新し docker compose up --build。
  5. 設定、ライブラリー、短い処理を確認してからバックアップを整理。

付属構成は ALEXANDRIA_DATA_DIR=/alexandria/runtime を data/runtime、ALEXANDRIA_CONFIG_PATH=/alexandria/config/config.json を data/config に対応させます。各ライブラリー／音声は別マウントで従来のホスト配置を保持し、移動は不要です。旧 /alexandria/scripts、/alexandria/voicelines、/alexandria/app/uploads はruntimeへのシンボリックリンクです。独自配置でもruntimeとconfigの両方を永続化します。

Resetは作業中データを削除します

Pinokio Resetは破壊的です。一般的な修復として使わないでください。 管理対象の書き込みを止め、既定の次を削除します：

annotated_script.json
voices.json
voice_config.json
character_aliases.json
state.json
app/config.json
chunks.json
cloned_audiobook.mp3
voicelines/

作業中スクリプト、声設定／状態、行音声、結合MP3、既定設定が失われます。保存済みスクリプト、デザイン／クローン声、学習ライブラリーは保持します。

この明示リストは既定パス用で完全なデータ消去ではありません。全レポート／チェックポイント／出力は網羅せず、独自データ／設定ルートの消去とも限りません。ライブラリー保持は上記の作業保持を意味しません。先にバックアップし、違う構成なら reset.js を確認します。

復元と確認

停止中に、本のスナップショット、付随ファイル、声設定、音声を同じ組として復元します。ライブラリーはmanifestとメタデータも戻し、正しい設定先と環境変数を復元します。

  • 原文とスクリプトが正しく読み込まれるか。
  • クローン参照とアダプターが実在するか。
  • 既存音声の試聴と短い1行の生成。
  • 入力／モデル／設定変更後もチェックポイントが有効とは仮定せず再開操作を確認。
  • 確認成功までバックアップを変更しない。

出力は音声生成と書き出しを参照してください。

参照元

英語版の確認元（元の確認リビジョンを保持）： 8c7a33cb310ab9264594a09ca27e48271585094f: update, reset, runtime paths, path overrides, saved-script companions, checkpoint storage, Docker persistence.