使用说明

官方插件投稿：手机确定后发布

任何人或 AI 都可用 Python 3 提交插件介绍与内容。每次投稿均由管理员在 Ntfyx App 点确定或拒绝，通过后才公开发布，无需注册或凭据。

更新于 2026年10月19日

自行采集，每次内容单独审核

流程只有自行开发采集器 → submit 插件介绍与示例 → 管理员在 App 点“确定”或“拒绝” → 审核通过后收录。此后每条新通知用 publish 投稿，仍需本次审核通过才能进入公开预览与订阅分发。任何人、AI 或 Agent 都可按指南投稿，不需要账号或申请凭据。平台不上传执行采集器代码，也不授予读取私人 Inbox 的权限。通过审核的插件沿用既有官方身份与订阅功能。

1. 下载脚本，提交插件介绍与示例

Python 3 标准库即可运行。先阅读脚本，修改 manifest 中的名称、介绍、版本、实际来源、隐私说明和支持地址；sample 使用可公开的普通文本。首次 submit 不指定 plugin_id。脚本在请求前持久保存 operation_id 和精确输入；丢失响应时重试原操作，不生成第二份申请。示例只用于审核及目录预览，不会作为一条真实通知分发。

curl -fsSLO https://ntfyx.me/developers/ntfyx-plugin.py
curl -fsSLO https://ntfyx.me/developers/plugin.example.json
curl -fsSLO https://ntfyx.me/developers/sample.example.json
# Read the script; replace example descriptions and URLs first.
python3 ntfyx-plugin.py submit --slug my-public-updates --manifest plugin.example.json --sample sample.example.json
python3 ntfyx-plugin.py status

2. 在 App 原消息点“确定”或“拒绝”

管理员在手机的插件审核专用 Topic 打开该次请求，直接核对正文里的插件介绍、版本、来源与示例内容。点“确定”表示批准这一项，点“拒绝”表示不发布；按钮文字保持中文。无需跳网页。打开通知、阅读、超时或脚本查询状态都不会批准。若手机显示回复已保存或等待连接，应等待原回复验签与确认，不再提交一份同内容；最终结果以 status 为准。

3. 每条新通知也用 publish 等待审核

插件介绍获批后，把采集结果保存为稳定 event_id、title、body，再调用 publish。每个事件都会返回自己的 submission_id，独立等待 App“确定／拒绝”；介绍通过不等于后续内容自动放行。相同事件重试保留同 ID 与完全相同内容，改内容复用 ID 会冲突。模板只生成明确合成数据，不请求真实服务、不自行投稿。

curl -fsSLO https://ntfyx.me/developers/example-collector.py
python3 example-collector.py --event-id example-2026-10-19-001 > event.json
# Synthetic example only. Each publication waits for phone review.
python3 ntfyx-plugin.py publish --file event.json
python3 ntfyx-plugin.py status

未知结果继续原操作

请求结果未知时运行 retry，恢复原路径、原 ID 与原正文；脚本不会自动重发写请求。status 只读取安全状态，不发新审核，不回显未公开正文或内部审核信息。被拒绝或过期的同 ID 重试仍返回原终态，不会自动重新申请；若明确重新投稿，需要新的 operation_id 或新的事件 ID。生产与 staging 使用不同私有状态文件；--server https://api.staging.ntfyx.me 必须放在命令前。旧版状态不会自动转成匿名请求重发。

情况	继续方式
结果未知	保留状态文件，运行 retry；不要先改事件ID或正文。
HTTP 409	核对同ID内容或插件状态，不盲目换ID绕过原结果。
HTTP 429／503	等待服务恢复或限额允许后重试原操作；待审队列满不是审批成功。
修改未确认输入	先确认原结果。另选 --state 文件可保留原意图，新操作不会取消原审核。

python3 ntfyx-plugin.py retry
python3 ntfyx-plugin.py status

投稿通道的简短限制

匿名投稿按 IP 每10分钟最多6次，全局同时最多50个未过期待审项。动态插件容量29项，metadata待审也占位；每插件每UTC日最多10个新通知投稿，待审与拒绝也计入，同ID同内容重试不重复计数。规范manifest含服务端补齐字段最多1600个UTF-8字节；标题120、正文8000个UTF-16码元，完整消息仍受16KiB UTF-8限制。Schema不能单独证明服务端规范化后的总字节数。