快速开始：收到第一条通知，或回答第一个问题

只想收到通知时，不必先做 Agent 配对。选择一条路径，完成一次自己的消息接收；需要手机回答 Agent 时，再使用受保护 Topic。下方连接动画演示的是受保护 Topic 配对。

• 公开 Topic：第一条消息
• HTTPS 推送教程

有现成公开 Topic 时，先按公开指南核对名称、发送无敏感信息的消息，并在手机确认收到。手机必须拥有这个 Topic 或已确认订阅；只打开网页不是订阅。不想公开内容时，用手机 HTTPS Push 生成的完整私有链接，按对应教程发送 hello。HTTPS 输入对服务端可见，严格要求发送端加密的内容请走下方受保护 CLI 路径。

• 核对当前下载版本
• 手机发送 hello 的完整步骤

在 iPhone 或 Android 安装 Ntfyx，在 Windows、macOS 或 Linux 安装 CLI。Android 后台推送需要 Google Play 服务。先按安装页选择自己的系统，再检查 ntfyx version。以下终端步骤适用于已安装 CLI 的三个桌面平台；Windows 安装使用 PowerShell 说明。无需 Ntfyx 账号，但必须由手机授权这个发送端。

ntfyx version --json
ntfyx connect

• 按系统安装 CLI
• 手机 App 与版本要求

保持 ntfyx connect 运行，在手机选择连接私密 Topic，扫描可信电脑上刚显示的二维码。确认发送端并选择受保护 Topic；新建时按安装版本提供的连接流程命名。不要把公开链接粘贴到配对流程。连接完成后运行 topics，记下 CLI 本地别名。下面以 Work 为例；如果列表中别名不同，请替换。

ntfyx topics

• 创建和配对排障

发送这条无敏感信息的测试消息。在手机收件箱打开对应 Topic，确认看到 Build 42 passed。CLI 成功只表示服务端受理；手机前台同步、后台推送和系统显示横幅要分别核对。拒绝系统通知权限时，前台收件箱仍可收到消息。

ntfyx send "Build 42 passed" --topic Work --json

• 消息到了但没有提醒

保持此终端等待，在手机打开原问题，选择 Allow 或 Deny。此命令只是演示问答，没有连接部署、支付或其他外部操作。同步 ask 在原发送端验证答案，成功领取后才返回允许结果。Deny 是完整答案；超时不是同意，迟到答案不会启动已经结束的任务。

ntfyx ask "Continue this harmless demo?" --topic Work --allow-deny --wait 60s --expires 90s --json

• 接入自己的 Agent
• 签名答案与执行边界

打开 Web 收件箱，用主手机扫描并确认它的新二维码。浏览器获得独立接收密钥，只能读取授权后发送给它的消息，不能自动获得手机旧历史。网页保持打开时可查看更新。公开 Topic 网页不需要这个配对步骤，但其内容是公开的。

• 打开 Web 收件箱
• 未收到消息时逐步排查