qshare

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install qshare
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 qshare。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

qshare 是 Openclaw Skills 的命令行工作流，可分享明确选定的本地文件，而不会暴露目录或无关文件。默认模式通过临时 TryCloudflare 隧道在本地提供文件；文件不会存储在 qshare 的服务器上，链接会在存活时间结束或进程停止时失效。
对于明确选择持久化替代方案的用户，qshare 可以将文件上传到 CNB Release。由于文件会存储在 CNB 中且不会自动删除，因此必须清楚说明并获得确认。此技能强调谨慎选择路径、准确报告 URL，以及对敏感文件进行加密。

应用场景

通过临时公开下载链接分享一个本地压缩包、文档或其他文件。
收件人需要快速访问文件时，生成可分享的 URL 或 QR 码。
、 90s 2h 等 TTL 设置所需的链接有效期。
用户的环境有要求时，使用固定的本地端口。
只有在用户明确选择该渠道并确认上传后，才将文件上传到 CNB Release。
仅在分享或上传前加密敏感文件后，才使其可供访问。

工作原理

确认准确的本地文件路径。如果用户没有指定单个文件，请询问其路径，而不要猜测或分享整个目录。
说明 TryCloudflare URL 没有访问控制，并建议在分享前加密私人或敏感文件。
使用带引号的文件路径运行 qshare。可选择指定所需的 TTL 或固定端口；否则 qshare 会选择一个空闲端口。
对于前台分享，请让进程保持运行，以便本地服务器和隧道持续可用。TTL 到期或进程停止时，URL 将失效。
按照原样返回打印出的 PUBLIC FILE URL。QR 渲染失败不会使已成功打印的 URL 失效。
对于 CNB，先说明文件将上传到 CNB Release，并取得明确的“是/否”确认。只有用户选择加入后才使用 --cnb 运行，然后返回打印出的 URL，并说明 qshare 不会自动删除该 Release。

配置指南

使用 uv 和软件包提供的安装程序元数据从 PyPI 安装 qshare：
uv tool install qshare
qshare 可执行文件必须能通过系统路径访问。要通过临时 TryCloudflare 隧道分享文件，请为其准确路径加上引号：
qshare "/path/to/file.zip"
需要时可设置可选的有效期或本地端口：
qshare "/path/to/file.zip" --ttl 30m
qshare "/path/to/file.zip" --port 8080
要上传到 CNB Release，必须先说明存储相关影响并取得用户明确确认，然后才能使用 --cnb：
qshare "/path/to/file.zip" --cnb
qshare 会按照软件包文档安装或使用匹配的 cloudflared 二进制文件。不要用无关二进制文件替代，也不要为了绕过错误而削弱 URL 验证。

数据架构

qshare 仅处理一个明确选定的本地文件；它不会分享任意路径、目录列表或其他文件。
分享模式 文件处理方式 链接生命周期
TryCloudflare（默认） 从本地计算机提供文件；文件不会存储在 qshare 的服务器上。 临时 URL 会在选定的 TTL 到期或进程停止时失效。
CNB (--cnb) 在获得用户明确确认后，上传到 CNB Release。 qshare 不会自动删除该 Release。
命令会在 PUBLIC FILE URL 行报告生成的链接。qshare 也可能提供 QR 码。QR 渲染器报错不会使已成功打印的 URL 失效。此技能未规定单独的本地元数据或生成文件架构。

高级特性

、 90s 、 2h 等 TTL 或正整数秒数配置链接有效期。 --port PORT 选择固定的本地端口，或让 qshare 选择可用端口。
使用可选的 CNB Release 渠道 --cnb ；必须以用户明确选择和确认为前提。
在类 Unix 系统上，qshare 可能提供后台分离功能；只有用户要求后台运行时才使用。Windows 始终在前台运行。
维护安全性和操作完整性：发生错误后不要编造 URL，不要暴露其他本地文件，不要绕过 CNB 确认，也不要打印凭据和运行时令牌。

name: qshare description: Share one local file through a temporary TryCloudflare URL or, with explicit confirmation, upload it to the qshare CNB release.