关于 download-media
用于从 Telegram 消息下载照片、视频、文档等媒体的技能。它指导用户查找含媒体的消息，并通过 Telegram CLI 保存文件。
主要功能
- 01浏览消息以查找媒体
- 02按消息 ID 下载媒体
- 03指定输出目录
- 04排查消息或媒体缺失问题
- 05根据可复现问题更新指引
适用场景
- 01保存 Telegram 聊天中的照片
- 02按消息 ID 下载文档
- 03在近期消息中查找媒体
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/download-media确认已加载。
详细介绍
下载 Telegram 媒体
下载 Telegram 消息中的照片、视频、文档和其他媒体。
自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生偏差，或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。
预检
- 会话必须存在：
~/.local/share/gramjs/<profile>.session- 如果不存在，请先运行
/tlg:setup
- 如果不存在，请先运行
用法
/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"
# Step 1: Find message ID with media
bun "$SCRIPT" read <chat> -n 10
# Step 2: Download by message ID
bun "$SCRIPT" download <chat> <message_id>
# Download to specific directory
bun "$SCRIPT" download 2124832490 471931 -o ./downloads
EOF
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| chat | string/int | 包含该消息的聊天 |
| message_id | int | 包含媒体的消息 ID |
-o/--output | path | 输出目录（默认：当前目录） |
工作流
- 使用
read <chat> -n N浏览消息并查找 ID - 含媒体的消息会在文本中显示
[media/service] - 使用
download <chat> <id>保存文件
错误处理
| 错误 | 原因 | 修复 |
|---|---|---|
message not found | 消息 ID 无效 | 先使用 read 检查 |
has no media | 纯文本消息 | 选择一条含媒体的消息 |
执行后复盘
此技能运行完成后，请在结束前检查：
- 命令是否成功？ — 如果没有，请修复导致失败的说明或错误表。
- 参数或输出是否发生变化？ — 如果 tg-cli.ts 的接口发生变化，请更新用法示例和参数表，使其保持一致。
- 是否需要采用变通方法？ — 如果你不得不临时调整（使用不同的标志、增加步骤），请更新此 SKILL.md，以便下次调用时无需重复采用相同的变通方法。
仅当问题真实且可复现时才进行更新，不要针对猜测的问题进行更新。
评论
支持 Markdown