hushdrop

---

快速开始

使用 Hushdrop 的主要方式是通过你的 Agent——它会将创建的内容发布到你的自有域名。

Claude Code（推荐——通过插件市场自动更新）：

/plugin marketplace add maxtechera/hushdrop
/plugin install hushdrop

Cursor · Codex · Copilot · Gemini · 20 多个 Agent Skills 托管平台：

npx skills add maxtechera/hushdrop-skill

无需安装——打开 hushdrop.dev/try，上传 HTML 文件，即可获取链接。无需账户。

在终端中临时使用——无需安装、无需设置、无需账户：

npx hushdrop report.html       # → https://hushdrop.dev/u/xxxx (+ password, copied) — no setup, no account

免费托管账户——在你自己的账号名下创建持久链接（hushdrop.dev/you/<slug>）：

npx hushdrop login                       # passwordless: GitHub or magic link
npx hushdrop report.html                 # → https://hushdrop.dev/you/report-a1b2 (persistent)

使用你自己的域名——在自己的 Vercel Blob 上自托管（免费、MIT，永久使用你的网址和品牌）：

# one-click: the "Deploy with Vercel" button above auto-provisions a Blob store — then:
npx hushdrop-install                         # wire your agents + CLI
hush deploy --domain share.yoursite.com   # or do it from a local clone

无需控制面板。运行两条命令即可试用；再运行一条即可拥有。

为什么要做这个项目

Anthropic 推出了内容分享功能，让团队成员可以互相分享他们用 AI 创建的内容。这很棒——但功能仅限于 Anthropic 的平台、域名和账户。Stacktree 推出了面向 Agent 的版本，但它是封闭的 SaaS：你的内容存放在他们的服务器上，自定义域名和使用限额需要付费，而且你无法审计或自托管。

我每天都用 Agent 创作各种内容：报告、提案、指南、仪表板，甚至完整的小型网站。我希望能把链接分享给别人，而且这个链接属于我自己——使用我的域名、我的品牌、我的密钥；只需输入一条命令就能完成，也无需把客户工作上传到别人的服务器。因此，hush 恰好实现了这些：原生支持终端、零知识、使用你自己的域名，并可通过任何 Agent 使用。采用 MIT 许可证。

Hushdrop 与其他方案的对比

	Hushdrop	Stacktree	send.co	tiiny.host
使用你自己的域名	✅ 免费	❌	❌	付费
零知识 AES-256	✅	✅	仅限文件	❌
开源 / 自托管	✅ MIT	❌	❌	❌
CLI + MCP（原生支持 Agent）	✅	部分支持	❌	❌
匿名分享，无需账户	✅	❌	✅	✅
阅读后销毁 / 邮箱验证	✅	部分支持	部分支持	❌
价格	免费 / 自托管	付费	免费增值	免费增值

详细对比：与 Stacktree 对比 · 与 Send 对比 · 与 ShareDuo 对比

功能

• 🔒 零知识 — 品牌定制和 AES-256 加密均在客户端进行；服务器只存储密文。
• 🌐 使用你的域名和品牌 — 颜色、徽标和社交卡片会应用到解锁页和预览中。
• 🤖 原生支持 Agent — 只需一条 CLI 命令或调用 9 个 MCP 工具；任何能运行 shell 的 Agent 都可以发布。
• ⏱️ 自动过期和阅后即焚 — --expire 7d、--burn，并由服务器强制清理。
• 📧 邮箱验证和可撤销的分享链接 — 按域名限制访问，创建或撤销访客链接。
• 📦 支持任意静态文件 — HTML、Markdown（渲染后）、PDF、图片、多文件 zip → 网站。
• 🚀 一键自托管 — 部署到 Vercel 时会自动配置 Blob；无需运行数据库。

可以投放的内容

你运行的命令	你会得到
hush report.html	位于 yourdomain.com/<slug> 的品牌定制、AES-256 加密页面（+ 自动生成密码）
hush notes.md	Markdown → 渲染后的品牌定制 HTML 页面
hush report.html -p secret	你自己的密码
hush report.html --no-lock	品牌定制页面，无需密码——任何拥有链接的人都能查看
hush report.html --expire 7d	自动过期（7d/24h/2w/日期）；运行 hush gc 进行清理
hush report.html --burn	阅后即焚——首次查看后自动销毁
hush report.html --email-gate acme.com	只有邮箱域名符合要求的查看者才能打开
hush deck.pdf --page	包含该文件的品牌定制下载页面
hush site.zip	位于 yourdomain.com/<slug>/ 的多文件静态网站
hush -s q3 deck.html	强制指定 slug

CLI 参考

命令	功能
hush <file>	发布（自动检测托管类型：托管服务 / 自托管）
hush login / whoami / logout	无密码托管账户（通过 GitHub 或魔法链接）
hush list / rm <slug> / gc	列出、删除和清理投放内容
hush share <slug> [--revoke]	创建或撤销可撤销的访客链接
hush claim <url>	将匿名的 /u/ 投放内容转移到你的账户
hush set-expiry / set-email-gate / set-password / set-feedback	管理托管的投放内容
hush init / setup / deploy	配置并在自己的域名上自托管
hush migrate	将托管的投放内容迁移到自己的 Blob 上

在任何 AI Agent 中使用

npx hushdrop-install 会将 drops MCP 服务注册到检测到的 Agent（Claude Code、Codex、 Cursor、Windsurf、OpenCode、Amp），将 hush 添加到你的 PATH，并为图形界面客户端输出配置。

claude mcp add hushdrop -- npx -y hushdrop-mcp        # Claude Code
codex  mcp add hushdrop -- npx -y hushdrop-mcp         # Codex

{ "mcpServers": { "hushdrop": { "command": "npx", "args": ["-y", "hushdrop-mcp"] } } }

MCP 工具（9 个——Stacktree 有 7 个）

工具	用途
publish_html	发布原始 HTML → 品牌定制、受密码保护的链接
publish_file	发布本地文件（可选使用品牌定制下载页面）
update_site	原位替换投放内容（URL 不变）
list_sites / delete_site	列出 / 删除投放内容
set_password / set_expiry / set_email_gate / set_feedback	管理托管的投放内容

工作原理

1. 读取文件并检测其类型。
2. 品牌定制（HTML）——在 </body> 前注入网站图标、OG/Twitter 卡片和不显眼的角落徽标。
3. 加密（如果启用了锁定）——在品牌定制的解锁页后使用 StatiCrypt（AES-256，客户端加密）。徽标会在加密之前嵌入，因此加密后仍会保留。
4. 上传到 Vercel Blob，并使用简洁的键名。
5. 提供内容——yourdomain.com/<slug> 通过 middleware.js 代理 Blob，并重写标头，使加密的 HTML 能够解密并渲染（而非下载），且 CSP 不会阻止解锁脚本。投放内容会设置为 noindex, nofollow, noai。
6. 报告——输出 URL（+ 密码），并复制到剪贴板。

内容由简单透明的代理提供服务；所有品牌定制和加密均在上传时于客户端完成。服务器始终只存储密文。

自托管

部署按钮会克隆仓库，并自动配置 Blob 存储（它会注入 BLOB_READ_WRITE_TOKEN；应用会根据令牌获取存储，因此开箱即用）。然后运行 npx hushdrop-install + hush init --domain share.yoursite.com，将你的 CLI + Agent 指向自己的实例。自托管**仅需令牌，免费且不限量 ——无需账户。**完整操作指南见 skill/SETUP.md。

配置

文件	内容	是否提交？
skill/brand/brand.json	展示信息——名称、颜色、所有者、社交链接。编辑此文件即可更换品牌。	是
~/.hushdrop/config.json	基础设施——域名、Blob 主机、Vercel 项目。由 hush init 写入。	否
~/.hushdrop/.env	你的 BLOB_READ_WRITE_TOKEN。	否

常见问题

真的是零知识吗？ 是的——对于加锁的内容，上传前会在浏览器中运行 AES-256 加密；服务器只存储密文。 托管、托管服务和自托管有什么区别？ 托管服务 = 匿名、24 小时有效、无需账户。托管 = 免费账户，在 hushdrop.dev/you/… 上提供永久链接。自托管 = 使用你自己的域名 + Blob。 需要 Vercel 吗？ 仅自托管需要。托管服务和托管层级只需要 npx。 这和 Stacktree 有何不同？ 理念相同，都是原生支持 Agent，但它是开源的、可自托管的，可免费使用自己的域名，而且支持匿名使用（无需账户）。请参阅对比。 Agent 可以不使用 MCP 吗？ 可以——它是一个独立 CLI；任何能够运行 shell 命令的 Agent 都可以发布内容。 免费吗？ 是的。MIT。自托管只需支付你自己的 Vercel Blob 用量费用（通常只需几分钱）。

安全性

• 加锁的 HTML 会在浏览器中进行真正的 AES-256 加密——请使用长密码；它能有效防止一般访问，但不能替代保险库。
• 原始文件通过无法猜测的 slug 保护；使用 --page -p <password> 可开启受保护的下载。
• 密码仅存储在你自己设备上的 ~/.hushdrop/manifest.json 中，绝不会上传。

请参阅 SECURITY.md 报告漏洞。

贡献

欢迎提交 PR——请参阅 CONTRIBUTING.md。代码只有几百行，使用易读的 Node + HTML 编写，无需构建步骤。