メンテナンス

保守コマンドは1Profileの永続状態を操作します。先にバックアップし、非破壊形式やdry-runを優先します。

SQLiteの保存領域を保守するもので、会話要約やモデルコンテキストの変更はしません。その機能はコンテキスト圧縮を参照してください。

開始前

anyy backup create
anyy gateway status

オフラインで状態を書くコマンドにはProfileの排他的所有が必要です。使用中と表示されたらロックを回避せず、そのGatewayを停止して再試行します。

状態DBのチェックポイント

anyy maintenance checkpoint-state

SQLiteの先行書き込みログを主DBファイルに反映します。オフライン所有権が必要です。名前付きProfileにはanyy --profile work maintenance checkpoint-stateを使います。

対応バックアップが適さず生DBをコピーする前に限り使います。通常の保護方法はanyy backup createです。

圧縮コピーを作る

より安全な形式は元DBを置換せず新DBを書きます。

anyy maintenance compact-state --output /secure/path/state.compact.db

コピーを確認・保護してから、その場での置換を選びます。

anyy maintenance compact-state --replace

--replaceにはGateway停止と排他的所有が必要です。--outputと--replaceは併用できません。既定一時領域に容量がない場合だけ--temp-dirを使います。

検証完了までバックアップを保持する

置換後、バックアップや圧縮コピーを消す前にanyy statusとanyy doctorを実行します。

不足するトークン推定をキャッシュする

変更なしで予定を確認します。

anyy maintenance cache-token-estimates

正のトークン数がまだないメッセージだけに適用します。

anyy maintenance cache-token-estimates --execute

候補制限は--limit N、監査可能な出力は--jsonです。executeはオフライン所有権が必要です。dry-runは既存状態を読み取り専用で開き、不足DBを作成しません。

安全な順序

1. Profileバックアップを作ります。
2. オフライン所有権が必要なら正しいGatewayを止めます。
3. 非破壊／dry-run形式を実行します。
4. 出力のパスと件数を確認します。
5. 必要な場合だけ書き込み形式を実行します。
6. Gatewayを起動してstatusとdoctorを確認します。

トラブルシューティング

症状	対処
Profile所有権競合	正確なProfileのGatewayを止めて再試行
圧縮出力を作れない	宛先権限と空き容量
--replace拒否	--outputを外し、停止してバックアップありで再試行
推定dry-runで対象なし	保持メッセージに正の推定値の欠落がない