ローカル制作版の復旧ガイド

更新日: 2026-09-09。現行の制作フォルダや元Drive版を上書きせず、Gitの基準bundleから別ディレクトリへ復元する手順です。

保存した基準点

項目	値
ローカル正本	`/Users/korizatou114/Projects/とりにく工房ゲーム制作部`
基準コミット	`423fd6dd2e75da926e38b35ac8c435e462b168d9`
コミット内容	`Preserve approved pixel tower prototype as development baseline`
制作ブランチ	`codex/first-operating-loop`
復旧bundle	`/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle`
bundle SHA-256	`6c33456fed426b5348f7f3a1b2ee5e0dfdf8f9d70bca9acc293ba62b7ae05cd0`

bundleはこの基準点までの完全なGit履歴を保持します。作成時の main、codex/first-operating-loop、HEAD は同じ基準コミットを指します。この後のP0資料更新とP1実装は、別途コミットして新しいbundleを作るまで、この基準bundleには含まれません。

含むものはGit管理されたソース、Godotプロジェクト、Definition、テスト、資料、元画像、Kenney原文ライセンス等です。.godot/ のインポートキャッシュ、build/ の配布物、artifacts/ のキャプチャ、ゲームの user:// 保存は含みません。Godot実行ファイルとWindows Export Templateも別途必要です。

元Drive版は内容照合が終わるまで復旧候補として残します。制作正本へ自動で同期したり、復旧のために元Drive版を削除したりしません。

1. bundleを確認する

現在の制作フォルダで実行します。いずれも読み取り専用です。

cd '/Users/korizatou114/Projects/とりにく工房ゲーム制作部'
git bundle verify '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'
git bundle list-heads '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'
shasum -a 256 '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'

verifyが成功し、完全履歴と表示され、SHA-256が上表と一致することを確認します。SHA-256が異なる場合は同じ基準bundleとして使わず、別の保存物か破損かを確認します。

2. 新しいフォルダへcloneする

復元先は例として TheTree-restored-2026-09-09 を使います。同名のフォルダがある場合は別名を選び、既存フォルダを消して空ける操作は行いません。

git clone --branch codex/first-operating-loop \
  '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle' \
  '/Users/korizatou114/Projects/TheTree-restored-2026-09-09'
cd '/Users/korizatou114/Projects/TheTree-restored-2026-09-09'
git rev-parse HEAD
git status --short

HEADが 423fd6dd2e75da926e38b35ac8c435e462b168d9 と一致し、作業ツリーが空の差分であることを確認します。そのコピーで制作を続ける場合だけ、復旧用のブランチを作ります。

git switch -c codex/recovered-pixel-baseline

この手順で現在の制作フォルダの履歴や未コミット変更は動きません。元フォルダに対する reset --hard、clean、上書きコピーは必要ありません。

3. キャッシュを再生成して確認する

復元先のフォルダで、Godot 4.7系を使って実行します。

godot --headless --editor --path . --quit
make test-pixel-ui

初回は元画像から .godot/ を再生成するため時間がかかります。godot がPATHになければ、実際のGodot実行ファイルを用い、Makeには GODOT='/実際のGodot実行ファイル' を渡します。

描画可能なデスクトップで保存なしの見学を開きます。

make preview-pixel

受付、食堂、客室、実際の客と従業員が表示され、ズーム・パン・停止・レイヤー切替が動けば、表示の復元を確認できます。見学は手動保存・読込・自動保存を無効にしており、通常ゲームのセーブを更新しません。

通常ゲームは make run、全Systemの検証は make test、Windows配布物の再生成は対応するExport Templateを用いて make export-windows です。基準版は通常3営業日運営や昇降機運行が完成した版ではないため、未実装の項目を復旧失敗と判定しません。

ゲームのセーブと復旧コードは別に扱う

コードを別フォルダへcloneしても、同じプロジェクト名の通常起動は同じ user:// 保存先を使います。ソースの復元だけでゲームのセーブ履歴は戻りません。通常の手動保存は user://saves/manual_ui、その他の世代保存とRecovery候補はSaveServiceが管理します。

プレイデータも保全する場合は、通常ゲームを閉じてからOS上の実際のユーザーデータディレクトリを別の場所へ丸ごとコピーします。復旧確認ではまず保存なし見学を使い、旧版から現行セーブへ上書き保存しないでください。通常ゲームへ戻すときは、読込可否と保存形式の移行を確認したうえで、Loadの正式・backup・autosave等の復旧候補を使用します。

検証記録

2026-09-09に次を確認しました。

git bundle verify 成功。基準bundleは完全履歴を保持し、SHA-256は上表と一致。
bundleから /tmp/the-tree-recovery-check.Ph7d3m/project へ別ディレクトリclone成功。HEAD一致、clone直後のGit差分なし。
project.godot、Makefile、Main、見学シナリオ、Kenney両パックの原文ライセンスが存在。
Godot 4.7.2.stable.official.ed1daf0bf で復元先のHeadless Editor読込・素材再インポート成功。
復元先の test_pixel_tower.gd が 238項目合格。カメラ、実施設クリック、停止、Simulation不変等の回帰。

この復旧確認では、全System試験、通常ゲームのセーブ上書き、Windows書き出し、復元先での目視見学は行っていません。/tmp の検証コピーは長期バックアップではなく、長期の復旧元は上表のbundleです。

6.3 KiB Raw Blame History