mcpField
C
cleanup-deleted

cleanup-deleted

github.com/terrylica生产力170 次安装今天更新
代码仓库

关于 cleanup-deleted

用于清理 Telegram 对话列表和联系人中已注销或被封禁账号的技能。它会扫描普通与归档对话，并通过逐步加强的删除方式处理顽固残留；支持仅扫描而不删除。

主要功能

  1. 01扫描普通及归档对话
  2. 02清理已删除账号和联系人
  3. 03使用三种递进方式删除残留
  4. 04支持 dry-run 仅扫描
  5. 05按配置文件选择清理范围

适用场景

  1. 01清除对话列表中的 Deleted Account 项
  2. 02移除已删除账号留下的联系人
  3. 03执行清理前先检查匹配条目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/terrylica/cc-skills --skill cleanup-deleted

安装后在 Claude Code 中输入/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 的接口发生变化，请相应更新用法示例和参数表。
  3. 是否需要变通方案？ — 如果你需要临时调整（使用不同标志、增加额外步骤），请更新此 SKILL.md，避免下次调用时再次遇到同样的问题。

仅当问题真实且可复现时才进行更新，不要臆测。

评论

支持 Markdown