cleanup-deleted

削除済み Telegram アカウントのクリーンアップ

Telegram のダイアログリストと連絡先をスキャンし、削除済みアカウントやゴーストアカウントを消去します。これらは、所有者によって削除されたアカウントや Telegram によって禁止されたアカウントですが、チャットリストには「Deleted Account」として表示され続けます。

Telegram のダイアログキャッシュは頑固なことがあるため、このスクリプトでは段階的に強力になる 3 つの削除方法を使用します。

1. delete_dialog — 標準的な削除
2. DeleteHistoryRequest — 会話履歴を強制的に消去
3. Block + Unblock + delete — Telegram のピア状態キャッシュをリセットしてから削除

最初の処理後、残っているアカウントを再スキャンし、方法 3 で再試行します。

自己改善型スキル：このスキルは使用するたびに改善されます。手順に誤りがある、パラメーターがずれている、または回避策が必要だった場合は、後回しにせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合のみ更新してください。

事前確認

1. セッションが存在する必要があります：~/.local/share/gramjs/<profile>.session
   • 見つからない場合は、先に /tlg:setup を実行してください

使用方法

/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/cleanup_deleted.ts"

# Scan only (no deletions)
bun "$SCRIPT" --dry-run

# Clean all profiles
bun "$SCRIPT"

# Clean specific profile
bun "$SCRIPT" -p work

# Clean multiple specific profiles
bun "$SCRIPT" -p work personal
EOF

パラメーター

パラメーター	型	説明
-p/--profile	リスト	クリーンアップするプロファイル（デフォルト：すべて）
--dry-run	フラグ	削除せずにスキャンして結果を報告

クリーンアップ対象

対象	処理
通常のダイアログ	削除済みユーザーのチャットを削除
アーカイブ済みダイアログ（folder=1）	削除済みユーザーのチャットを削除
連絡先リスト	削除済みの連絡先を削除
しつこく残るゴースト	ブロックとブロック解除でキャッシュを強制リセットしてから削除

推奨頻度

毎月、またはチャットリストに「Deleted Account」が表示されていることに気付いたときに実行してください。メッセージを送ってきた後、Telegram によって禁止されるスパムアカウントが主な原因です。

実行後の振り返り

このスキルの実行後、終了する前に以下を確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラー表を修正してください。
2. パラメーターや出力に変更はありましたか？ — tg-cli.ts のインターフェースに差異が生じていた場合は、Usage の例と Parameters の表を合わせて更新してください。
3. 回避策が必要でしたか？ — 別のフラグや追加手順など、その場で工夫する必要があった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

問題が実際に再現できる場合のみ更新してください。推測で更新しないでください。