← 插件

文件下载

在 Agent 回复下显示文件卡片,通过短时 HTTP 链接下载文件。

$ paseo plugin add ntr5uki/file-download
报告问题
ntr5uki工具26次安装a54670376343源代码
文件下载 截图 1文件下载 截图 2文件下载 截图 3文件下载 截图 4

在 Agent 回复下方显示文件卡片,直接下载安装包、压缩包、文档等文件。回复完成后,插件识别其中明确的 Markdown 文件链接并生成卡片。也可以通过 /download 命令指定文件,或提取最新回复中的链接。

适用于 Paseo 0.15.4 至 0.16.x。默认由每台设备自动寻找并验证本机、局域网或 Tailscale 下载地址,无需先填写地址。下载设置提供「测试连接」,高级设置中可以指定反向代理等场景使用的自定义地址。HTTP 服务默认监听所有网络接口的 6768 端口。该端口或代理地址仍需可达;HTTPS 网页受浏览器策略限制时,应使用自定义 HTTPS 地址。插件不修改 Paseo,也不创建中继隧道。

自动发现会先校验当前选中 daemon 的短时身份凭证,探测请求不包含下载凭证。地址缓存保存在各自客户端,手机和电脑可以使用不同的路径。点击下载时生成有效期五分钟、仅可使用一次的链接。文件从 daemon 主机通过 HTTP 流式传输到浏览器,不经过模型,也不通过插件 RPC 在前端组装整个文件。桌面和 Web 使用浏览器下载管理器,Linux 客户端下载已验证。手机原生客户端会在系统浏览器打开链接,已有 WireGuard/VPN 场景下下载停滞的反馈,尚未验证通用的手机端下载支持。

仅允许下载 Agent 所属工作区内的非隐藏普通文件。指向工作区之外的符号链接、隐藏目录、文件夹和外部网址会被排除。链接生成后文件发生变化,需要重新点击下载。插件读取回复和文件信息来生成卡片,仅在下载时读取文件内容,不会把下载凭证或文件内容存进卡片,也不会发送到外部服务。持有有效链接的人可以下载对应文件一次。同一个链接不支持断点续传。