用途:在远程 VPS 上使用 tgcli,而不是在本地执行 Telegram 相关任务。主机从环境变量 TGCLI_SERVER 读取,以用户 danil 通过 SSH 连接,远端是 Telegram 会话存储的唯一位置。
主要能力:远程消息搜索、发送、同步、媒体下载和诊断。读取消息时建议显式指定 --source archive|live|both;机器化流程保持 --json;此处不使用 MCP,仅限 CLI。
使用方式:单条命令优先用 ssh danil@"$TGCLI_SERVER" tgcli ...;需要 shell 展开或多条命令时用 ssh danil@"$TGCLI_SERVER" 'bash -lc "..."'。检查命令包括 command -v tgcli && tgcli --version、tgcli config list、tgcli doctor --connect、tgcli auth status。常用命令示例:messages list --chat @channel --limit 20 --source archive --json;messages search "invoice" --chat @channel --source archive --json;send text --to @username --message "hello" --json;send file --to @channel --file ./report.pdf --caption "report" --json;sync --once;media download --chat @channel --id 123 --json。
适用场景:需要在远端边界内完成 Telegram 消息检索、发送文件、同步或媒体下载时。
限制与故障处理:TGCLI_SERVER 未设置时应停止并询问或从 .env.local 读取;SSH 主机密钥变化时用 ssh-keygen -R "$TGCLI_SERVER" 删除旧条目并核对新指纹;远端缺少 tgcli 时先检查远端登录 shell 的 PATH;缺少认证时在远端以 danil 运行 tgcli auth,除非明确要求,否则不要把密钥复制回本地。远端存储预期位于 ~/.local/share/tgcli。命令应保持窄而明确,远端主机即为执行边界。