使用说明

公开 Topic：用一个链接收发消息

新建 Topic 默认公开，知道标识或链接即可阅读和发送，无需账号、配对或密钥。公开消息可使用纯文本、Markdown 和轻量富内容，不提供应答、审批或 Call。名称及内容对服务端和持有链接的人可见。需要私密消息、验证发送者或应答时，创建受保护 Topic 并授权 Source；创建后不能切换模式。

更新于 2026年10月27日

版本要求

公开 Topic 可使用 CLI 0.6.0、iOS／Android 1.8.0 或新版 Web。Chrome 0.4.0 适配新版受保护消息协议；浏览器阅读公开 Topic 请使用 Web 页面。商店审核与公开可下载状态独立更新，请先查看下载页。

公开或受保护

能力	公开	受保护
发送	知道标识即可发送	已授权 Source 或仅发送密钥
阅读	知道标识即可阅读	已授权接收端
内容	文本、Markdown、富消息	文本、Markdown、富消息
应答与 Call	不支持	支持，受套餐与接收设置限制

直接使用 CLI，无需 MCP

用手机创建公开 Topic 后复制链接。首次公开发送须阅读并接受公开内容条款，使用 --accept-public-terms 记录当前版本；升级条款后需重新接受。以下命令不读取配对凭据，也不创建收件箱。读取默认返回最近 50 条；指定 --cursor 0 从云端尚未过期的最早记录开始。

ntfyx public info --topic TOPIC_ID --json
ntfyx public send "Build passed" --topic TOPIC_ID --title "Build" --accept-public-terms --json
ntfyx public send --topic TOPIC_ID --message-file message.json --json
ntfyx public read --topic TOPIC_ID --limit 20 --json

未知发送结果与重试

超时不代表未发送。自动化应为每条逻辑消息保存唯一 --operation-id，并在六天内用同一标识、完全相同的输入重试。不要因超时生成新标识。重复受理只扣一次额度；同一标识搭配不同内容会被拒绝。云端正文保留 24 小时，最小去重回执保留七天；超过安全重试期限须先人工核对。

ntfyx public send "Build passed" --topic TOPIC_ID --operation-id BUILD_RUN_00000000000001 --json

关注、历史与消息额度

在手机关注公开 Topic 可接收后台普通推送，与你的通知源订阅共享名额。拥有者自动接收自己 Topic 的提醒，无需占用自关注名额。每条公开消息扣拥有者一次消息额度，多个接收者不重复扣；关注者接收该消息不扣自己的消息数。服务端保留 24 小时，已下载的原生历史按设备本地规则保留。公开网页仅加载有限的近期记录。

Agent 与 MCP 的边界

本地 MCP 提供 ntfyx_public_send 与 ntfyx_public_read；首次 MCP 公开发送必须先取得用户明确同意，再传 accept_public_terms: true；已保存的同版本接受无需重复确认。无 MCP 时直接调用上面的 CLI。公开内容不能作为操作批准，不能用于恢复或领取应答。需要人确认时使用受保护 Topic 的 ntfyx ask，并验证签名和单次领取。已配对的 ntfyx usage 或 ntfyx_usage 可查看五项套餐用量。

举报与本机屏蔽

可在消息详情举报公开消息、来源或整个 Topic。CLI 提供 public report、public block 和 public unblock，MCP 提供对应工具。来源标签按 Topic 与网络地址生成，不代表已验证的个人；本机屏蔽隐藏相应消息，运营举报由服务方处理。举报超时保留同一 report-id 和原内容重试。

ntfyx public report --topic TOPIC_ID --report-id REPORT_OPERATION_00000001 --message-id MESSAGE_ID --reason spam --json
ntfyx public block --topic TOPIC_ID --json

套餐

免费版：每天 100 条消息，其中 Call 最多 10 条、应答请求最多 10 条；1 个监控、1 个订阅。 Plus：$1.99/月，每天 1,000 条消息，其中 Call 最多 100 条、应答请求最多 100 条；5 个监控、5 个订阅。 Pro：$9.90/月，每天 20,000 条消息，其中 Call 最多 200 条、应答请求最多 500 条；50 个监控、50 个订阅。 Call 与应答请求包含在消息总额内。公开 Topic 关注与通知源订阅共享订阅名额；暂停订阅或监控仍占名额，删除或退订才释放。Topic 数量不作为付费权益。每日 UTC 00:00 重置消息额度，升级不重置已用数量。额度用完或降级后，已受理的问题仍可回答。这些方案为下一版 App 准备；可购买状态、本地价格与税费以购买前的商店页面为准。

套餐与价格