Obituary の仕組み
ファイルの寿命
- 登録:ファイルやフォルダーに寿命を設定します。エージェントは
obit add debug.log 2h、ユーザーはエクスプローラーのコンテキストメニューにある「Add to Obituary」を使います。登録の対象を参照してください。 - 期限切れ:
obit listで残り時間を確認できます。期限前ならobit extendで延長するか、obit spareで追跡を終了してファイルを残せます。 - 埋葬:期限が来ると墓地へ移り、既定で 7 日間保管されます。
obit graveyardで確認できます。 - 復活または永久削除:保持期間中は
obit resurrect <id>で元の場所に戻せます。既存のファイルは上書きしません。期間が過ぎた後に初めて永久削除(obit purge)されます。
まだ必要か判断できないものは、obit bury で先に埋葬できます。そのままの状態で 7 日間は復活できます。
墓地の場所
墓地はファイルと同じドライブにあります。データディレクトリのあるドライブではその配下の墓地を、それ以外のドライブではルートにある隠しディレクトリ .obituary を使います。埋葬は名前変更だけで済むため速く、移動が途中までしか終わらないこともありません。
保持期間は設定で変更できます。埋葬先をシステムのごみ箱にすることもできます。その場合はごみ箱から復元してください。obit resurrect は使えません。
[graveyard]
mode = "graveyard" # or "recycle": straight to the system Recycle Bin
retention_days = 7 # days the graveyard keeps things設定ファイルは %APPDATA%\obituary\config.toml です。obit config で現在の内容を表示し、obit config --create でコメント付きの既定ファイルを作成できます。
他のファイルを誤って削除しない仕組み
- 永久削除するのは墓地の項目を消去するときだけです。 埋葬のたびに専用の墓フォルダーを作り、そのファイル ID を記録します。永久削除や復活の前に、フォルダー自体が当初のものか、中身がちょうど 1 件か、それが埋葬した対象かを確認します。台帳が破損したり墓地がリンクに置き換わったりしても、墓地の外を削除することはありません。
- 復活先は元の場所だけです。 同じ名前が使用中なら
name (resurrected).extのように別名で隣に戻します。両方が残り、実際のパスは結果に表示されます。削除された親フォルダーは作り直します。親がジャンクションやシンボリックリンクに変わった、既存のジャンクションの参照先が変わった、ドライブ文字が別のボリュームを指すようになった場合は、復活せず墓をそのまま残します。 - 名前ではなくファイルを識別します。 各記録はボリュームのシリアル番号と 128 ビットのファイル ID を持ちます。名前や場所が変わっても元のファイルを見つけ、古いパスに別のファイルがあっても触れません。削除直前にも同一性を確認します。ハードリンクが複数あるファイルは対象外です。
- 保護対象のパスがあります。 ドライブのルート、
C:\Windows、Program Files、ProgramData、ユーザープロファイル、デスクトップ、ドキュメント、ダウンロードなどのフォルダー自体とその親は対象外です。リダイレクトされたものも含みます。中の項目には寿命を設定できます。 - Git リポジトリを保護します。 階層の深さに関係なく
.gitを含むフォルダーでobit addまたはobit buryを実行するには--forceが必要です。期限切れ時にも再確認し、確認が終わらなければ埋葬しません。 - 確かめられなければ削除しません。 記録を破棄するのはファイルの消失を確認できたときだけです。アクセス拒否やボリュームの取り外しなどは後で再試行します。間隔は 1 分から徐々に長くなり、最長 1 日です。12 回連続で失敗すると処理を止め、判断を待ちます。理由は
obit listと For you の「Burials that failed」に表示します。obit extend <id> 1m(Retry)で再試行し、obit spare <id>(Stop tracking)ならその場に残します。大きなフォルダーは埋葬前に最大 30 秒間 Git リポジトリを探します。確認が終わらなければ後でやり直し、リポジトリがあれば埋葬しません。 - 操作を記録します。 登録、延長、取り消し、削除をすべて監査ログ(
obit log)に記録します。
バックグラウンド処理
既定では obitd.exe はログイン時に起動してトレイに常駐し、秒単位で期限どおりに埋葬します。インターフェースはトレイアイコンだけです。予備として Windows のスケジュールされたタスクも 5 分ごととログイン時に obitd --once を実行します。トレイを閉じた場合や一度も起動していない場合でも、期限切れの項目は埋葬し、保持期間が過ぎた墓は永久削除します。セッションの開始時と終了時にもエージェントのフックが処理を一巡させます。今すぐ行うには obit reap を実行します。
obit daemon enable # tray at login plus the fallback scheduled task (--dry-run lists what would be installed)
obit daemon status # current mode and the next expiry (--json)
obit daemon disable # remove the scheduled task and login start, and stop the running daemon (--dry-run previews)list、graveyard、stats、log などの照会は読み取り専用で、埋葬を実行することはありません。
データの保存場所
%LOCALAPPDATA%\obituary に store.json(台帳)、audit.jsonl(監査ログ)、obitd.log(デーモンのログ)、graveyard\(このドライブの墓地)があります。
保存先は OBIT_HOME(データ)、OBIT_CONFIG_DIR(設定)、OBIT_USER_HOME(ユーザーのホーム)で変更できます。