下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-phpp5ihd--filego-send.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-phpp5ihd/filego-send。- 把本地文件一句话传上「文传客」快传并拿到可分享的下载链接与提取码
- 也能一句话把链接发送到指定邮箱(单个或从文件批量导入收件人),并查询邮件发送结果
- 还能反查“我传过的文件”(链接、提取码、实时状态、下载次数)。当用户说“把这个文件发给/传给某人”“生成下载链接”“分享这个文件给客户”“发到我的邮箱 xx@xx”“把链接发给这些客户”,或问“我刚发的链接是多少”“邮件发出去了吗”“我传过哪些文件”“那个文件还有效吗/被下载几次”时使用。单文件最大 40GB(分片直传、断点续传、秒传复用),上传默认在后台进…
阅读全文 (展开查看完整说明)
概述
文传客一句话传文件
用途
把本地文件传上「文传客」快传,拿到可分享的下载链接 + 提取码 + 有效期;也能随时查回自己传过的文件。上传免注册,脚本会自动维护设备标识。
- 站点:
https://filego.cn - 分享链接域名:
https://down.filego.cn/s/<短码>
使用方式
python "<skill_dir>/scripts/send_file.py" "<文件或文件夹绝对路径>"- 上传默认在后台进行:命令约 0.2 秒返回「已开始后台上传」,本轮就结束,不要原地等;之后用户问起(或你收到新消息)时用
upload_status.py查一次,done就把链接、提取码、有效期一起给出。 - 需要一条命令直接拿到链接(几 MB 的小文件、或要一次串行传多个文件)时加
--foreground,命令会等到传完再输出结果。 - 路径为文件夹时自动压缩为 zip(
<文件夹名>.zip,保留目录结构与空文件夹,排除 Thumbs.db / desktop.ini / .DS_Store 与符号链接)后上传压缩包;临时压缩包在上传结束(无论成败)后自动删除。 - 上传过程自动完成分片(大文件同样支持)、云端去重(相同内容秒传)与提取码生成。
- 上传前会计算文件 MD5(默认全量、无大小上限,服务端安全审核与违规拉黑依赖,与网页端同口径):超大文件此阶段约需 1-2 分钟,前台模式每秒在 stderr 打印百分比,后台模式
upload_status.py显示「计算校验 MD5 N%」。站点后台把「快传分片」关出 MD5 校验范围时自动跳过(不查配置时仍默认照算,fail-safe)。
可选参数(默认值适用于大多数场景):
| 参数 | 默认 | 说明 |
|---|---|---|
--expire-hours N | 12 | 分享有效期(小时),服务端按档位归一;需要更长时间可设 72 或 168 |
--max-downloads N | 0(不限) | 限制下载次数时设置 |
--region 大陆|东南亚|欧洲|北美洲 | 大陆 | 默认存储节点:大陆 |
--password 密码 | 无 | 设置提取密码(敏感文件建议设置) |
--email 邮箱 | 无 | 上传完成后把链接发到该邮箱;可重复传多个 --email,单值内也可逗号分隔 |
--email-file 文件 | 无 | 批量收件人文件:每行一个邮箱(行内逗号分隔也认,# 为注释),与 --email 叠加;最多 20 个 |
--json | 关 | 以 JSON 输出结果(供程序消费) |
--foreground | 关 | 前台上传:命令等到传完并直接输出链接(小文件、或连续传多个文件时用) |
--background | 开 | 后台模式已是默认,无需指定;仅为兼容保留 |
--speed N | 0(不限速) | 仅后台模式:限速上限,单位 Mbps(运营商口径,如 20 ≈ 2.5 MB/s);0 = 跑满上行带宽 |
输出示例:
上传完成(已真实上传)
文件名:方案v3.zip
大小: 412.36 MB
下载地址:https://down.filego.cn/s/AbCd
提取码: 7x2K
有效期至:2026-11-06 09:00断点续传(网络波动保护)
单文件上传全程有续传保护,VPN 掉线、进程被杀、断网退出都不用从头再来:
- 会话登记:上传会话一建立就写入
~/.filego_resume.json(按「文件路径 + 大小 + 修改时间 + 上传参数」识别); - 自动续传:重跑同一条命令时检测到未完成会话,以云端已传分片为准(ListParts)只补缺失部分,并提示
检测到上次未完成的上传(云端已有 N/M 分片),自动续传剩余部分...; - 接口重试:prepare / 签发 / complete 等请求遇到连接失败、超时、5xx 网关错误自动退避重试 2 次(4xx 业务错误不重试);
- 分片重试:单个分片 PUT 失败自动重新签名重试 2 次;
- complete 兜底:合并前发现分片不全时,自动核对云端、补传缺失分片后再合并一次。
限制:续传登记 12 小时内有效;文件夹上传因每次重新压缩(临时包不保留)暂不支持跨运行续传;修改区域 / 密码 / 有效期等参数会视为新上传。
后台模式(默认)与进度查询
上传默认在独立后台进程中执行:命令立即返回「已开始后台上传」,对话不被上传时长阻塞,进度与结果随时可查。
python "<skill_dir>/scripts/send_file.py" "<文件绝对路径>" # 默认:后台,立即返回
python "<skill_dir>/scripts/send_file.py" "<文件绝对路径>" --foreground # 前台:等到传完,直接输出链接- 发起后立刻收工,不要原地等:拿到「已开始后台上传」就把结果回给用户、结束本轮。禁止在同一轮里用
sleep/Start-Sleep/ 循环查upload_status.py等它跑完 —— 1.4 GB 约 10 分钟、40 GB 更久,会把对话卡死,还可能被宿主超时打断。进度只在两种时机查一次:用户问「进度到哪了 / 好了吗」,或用户明确要「传完把链接给我」之后的下一次交互。查到done就一次性给出链接、提取码、有效期。仅当用户明说「就等它传完再回我」且文件很小(几 MB)时,才可以阻塞等待。 - Windows 上后台进程由系统服务(WMI/CIM)派生,对话结束、停止生成、关闭终端都不影响它;
--json输出里的spawn_via标注实际派生方式,仅供排查。 - 传输默认不限速(跑满本机上行带宽),2 线程并发;需要边传边用网时用
--speed N设上限(单位 Mbps,运营商口径,例如--speed 20≈ 2.5 MB/s)。前台模式恒不限速。 - 查询进度与结果:
python "<skill_dir>/scripts/upload_status.py" # 文本输出:百分比 + 速率 + 预计剩余
python "<skill_dir>/scripts/upload_status.py" --json # JSON 输出(供程序消费)- 状态 done:包含下载地址、提取码与有效期,拿到后要告诉用户;状态 failed:包含失败原因。
- 状态文件缺失(被清理 / 进程刚死)但续传登记还在时,
upload_status.py会提示「有一个 N 分钟前登记的未完成上传会话」——此时不要判定"没传过",先重跑同一条命令让续传接管(云端分片还在,重传就浪费了)。 - 无窗口、无需照看:Windows 上 worker 用
pythonw.exe启动(GUI 子系统,不分配控制台),不会弹黑窗口、不占任务栏;传完或失败后自行退出,进度与结果只看upload_status.py。 - 同一时间只能有一个后台上传:上一个没传完就再发起会被拒绝(提示里带进度)。要一次连续传多个文件,用
--foreground逐个传,或等上一个done后再发下一个。 - 上传若被环境中断或机器休眠,续传登记 12h 内有效,重跑同一条命令即可接着传。
分享与安全建议
- 下载地址与提取码需完整传递,不要改写或截断链接。
- 告知接收方有效期,过期后链接失效需重新上传。
- 敏感文件(合同、报价、身份材料)建议链接与提取码分两个渠道发送(例如链接走聊天、提取码走短信)。
- 输出「云端已有同内容」表示命中秒传,本次未重复传输。
发送到邮箱
上传完成后服务端会把「下载地址 + 提取码 + 有效期」发到指定邮箱,支持单地址与批量:
# 单个邮箱
python "<skill_dir>/scripts/send_file.py" "<文件路径>" --email client@qq.com
# 多个邮箱(--email 可重复,单值内也接受逗号分隔)
python "<skill_dir>/scripts/send_file.py" "<文件路径>" --email a@qq.com --email b@163.com
python "<skill_dir>/scripts/send_file.py" "<文件路径>" --email "a@qq.com,b@163.com"
# 批量:从文件读收件人(每行一个邮箱,# 为注释),可与 --email 叠加
python "<skill_dir>/scripts/send_file.py" "<文件路径>" --email-file clients.txt要点:
- 发送邮件要求登录(访问令牌,见下「配置访问令牌」);未配置令牌时邮箱参数会被忽略并提示。
- 收件人最多 20 个(超出截断);服务端逐地址发送并记录结果。
- 上传完成的输出里带「邮件通知」一行与查询命令;发送是异步的,完成几秒后结果才可查。
查询发送结果(每地址:发送中 / 已发送 / 失败 + 原因,结果保存 30 天):
python "<skill_dir>/scripts/email_status.py" <短码或file_id>
python "<skill_dir>/scripts/email_status.py" 12345 --json入参用 send_file.py 输出的 file_id(数字)或链接短码;短码解析优先读本机发送记录。用户问「邮件发出去了吗」「发到 xx 邮箱了吗」时用本脚本回答。
查看传过的文件
python "<skill_dir>/scripts/list_history.py" [--limit 20] [--all] [--prune] [--key fgk_xxx] [--json]
python "<skill_dir>/scripts/list_history.py" --delete <链接短码>- 每条记录实时查询当前状态:有效 / 有效(需密码) / 已过期 / 已失效 / 次数用尽 / 下载已关闭 / 流量不足 / 无法确认,并显示已下载次数。
- 未配置令牌时查询本机保存的发送记录;配置令牌后一并展示账号下的全部文件。
--prune只清理本机已失效的记录,不影响云端文件。--delete删除账号内一条分享(需配置令牌):存储空间立即释放,删除后链接受访即失效、不可恢复,执行前须与用户确认目标;删除对象为「快盘资产」时服务端只关闭分享链接、空间仍占用在快盘,此类文件需在网页端快盘中删除。--json输出的每条记录含code(链接短码)与is_user_file(是否快盘资产);--delete以短码为入参。
输出示例:
[1] 有效 方案v3.zip 412.4 MB · 已下载 2 次
链接:https://down.filego.cn/s/AbCd 提取码:7x2K
发送于 11-05 15:40 · 有效期至 11-06 09:00配置访问令牌(可选)
站点用户多为微信登录、无账号密码,脚本使用网页端生成的「访问令牌」鉴权:
- 登录
https://filego.cn→ 个人中心 → 访问令牌 → 生成(可填用途备注、选有效期) - 复制生成的令牌(
fgk_开头,仅显示一次) - 在本机保存:
python "<skill_dir>/scripts/key.py" --key fgk_xxxxxxxx
python "<skill_dir>/scripts/key.py" --status # 检查令牌是否有效
python "<skill_dir>/scripts/key.py" --clear # 清除本机令牌- 配置后上传的文件归属该账号,网页端「传输历史」可见,查询时一并合并账号记录。
- 令牌保存在本机
~/.filego_token.json(仅本人可读),按所选有效期生效,可在个人中心随时删除。 - ⚠️ 令牌等同账号密码:请勿告知他人或在公开场合粘贴;一旦泄露,立即到个人中心删除并重新生成。
- 不配置令牌也能正常上传,但文件不归属账号,查询仅显示本机记录。
失败处理
| 现象 | 含义 | 处理 |
|---|---|---|
| 提示“服务端拒绝”+ 原因 | 文件被安全审核拦截(违规类型、伪装文件等) | 按返回原因调整(更换文件等),不要重试同一文件 |
| 提示“无法连接服务端” | 网络不通或站点暂时不可用 | 稍后重试;确认本机能访问 https://filego.cn |
| 分片上传失败 | 网络抖动(脚本已自动重试 2 次) | 重新执行一次;连续失败再确认站点状态 |
| 提示“文件过大(>=40GB)” | 超过单次上传上限 | 分卷压缩后分别上传 |
| 提示“今日上传次数已达上限” | 未登录设备每日上传次数限制 | 配置访问令牌后按账号额度计算 |
| 提示“存储空间不足(已用 X / 共 Y)” | 账号存储配额已满 | 用 list_history.py 列出账号内有效文件,与用户确认后用 list_history.py --delete <链接短码> 删除不需要的分享释放空间,再重新上传 |
使用须知
- 文件只会发往文传客官网
https://filego.cn,脚本不支持其它地址。 - 本机保存的发送记录(
~/.filego_sent.jsonl)包含链接与提取码,公用电脑请留意,可用--prune或手动清理。 - 请从官方渠道获取本 skill,不要使用他人转发的“增强版”。
- 一次调用传一个文件;多个文件时逐个调用,或先打包再传。