用途:htmldrop 用于把任意 HTML 文件发布为可分享的托管链接,适合分享报告、规格文档或静态页面,并支持协作评审。
主要能力:提供两种模式。简单分享基于 Surge.sh 托管,可生成公开链接或 AES-256 加密的密码保护链接,并可选 --noindex 阻止搜索引擎与 AI 爬虫索引。协作反馈模式通过 --feedback 在页面嵌入批注组件,评审者无需账号即可高亮文字或框选区域留言;同一 /doc/<uuid> 链接对评审者和作者通用,重复推送同一文件会复用 docId,链接稳定、评论保留。还可拉取反馈、以程序方式添加带锚点的评论、回复评论,并用 converge 调用 LLM 生成改进版文档。
使用方式:需 Node.js >= 18,安装命令为 npm install -g @yeefeiooi/htmldrop@latest(二进制名仍为 htmldrop)。简单分享先运行 htmldrop init;反馈模式先运行 htmldrop auth setup。常用命令包括 htmldrop push <file>(可加 --password、--noindex、--open)、htmldrop list、htmldrop delete、htmldrop feedback pull/read/add/clear、htmldrop fetch、htmldrop converge、htmldrop studio。调用 push 时使用绝对路径。converge 需要环境中的 LLM API 密钥(ANTHROPIC_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY 或 LLM_API_KEY),可用 --provider/--model 覆盖。
适用场景:生成 HTML 报告、规格或文档后需要分享链接,或需要多人匿名批注、作者汇总反馈并迭代文档。
限制:凭据不存储于技能内,Surge 认证在 ~/.netrc,作者密钥在 ~~/.htmldrop/config.json;密码保护文件需同时告知 URL 和密码;converge 与 feedback clear 仅限发布者本人;反馈链接意外变化通常因使用了 --new-doc。其余细节暂未提供。