Meow 推送渠道配置指南
本教程将指导你如何在 MagicPush（魔法推送）中配置 Meow 推送渠道，实现向鸿蒙设备推送消息通知。
概述
什么是 Meow？
Meow 是一款专为**鸿蒙系统（HarmonyOS）**开发的推送通知应用，可以将消息推送到鸿蒙设备。
- 官网：api.chuckfang.com
- App 获取：在鸿蒙应用市场搜索「Meow」
| 特点 | 说明 |
|---|---|
| 推送目标 | 鸿蒙设备（需安装 Meow App） |
| 鉴权方式 | 用户昵称（无需 Token） |
| 配置复杂度 | 低，仅需用户昵称 |
| 消息格式 | text（纯文本）、html（HTML 渲染） |
| 系统要求 | HarmonyOS 2.0+ |
前置条件
- 拥有鸿蒙系统设备（华为手机/平板）
- 已安装 Meow App
- 已部署并登录 MagicPush 管理后台
第一步：在 Meow App 中设置昵称
1.1 安装并打开 Meow
- 在鸿蒙应用市场搜索 「Meow」 并安装
- 打开 Meow App
- 首次打开会要求设置用户昵称
1.2 设置并记住昵称
- 在 App 设置页面，找到 「用户昵称」
- 设置一个易记且不易被猜到的昵称（这相当于你的推送凭证）
- 点击 「保存」
📌 关键信息：
配置项 示例值 来源 用户昵称 my_alert_botMeow App 设置页面 💡 提示：昵称相当于密码，不要使用常见单词，建议使用下划线连接随机词。
⚠️ 注意：昵称不能包含斜杠（
/）。
第二步：在 MagicPush 中添加渠道
2.1 进入渠道管理#
- 登录 MagicPush 管理后台（默认地址
http://<服务器IP>:3000） - 点击左侧导航 「渠道管理」
- 点击右上角 「+ 绑定渠道」 按钮
2.2 选择渠道类型#
在弹出的对话框中，从渠道类型下拉列表中选择 「Meow」。
2.3 填写配置信息#
根据第一步获取的信息，填写以下配置字段：
| 字段 | 说明 | 示例 |
|---|---|---|
| 用户昵称 | 在 Meow App 中设置的昵称 | my_alert_bot |
| 消息类型 | text=纯文本（默认），html=渲染 HTML | text 或 html |
💡 消息类型说明：
text：纯文本显示，所有格式标记以文本形式展示html：在 App 中渲染 HTML 格式（支持更多样式）
填写完成后，给渠道起一个易于辨识的名称（如「Meow 鸿蒙推送」），点击 「保存」。
2.4 测试连通性#
渠道创建成功后，在渠道卡片右侧的下拉菜单中，点击 「测试」 按钮。
- ✅ 如果 Meow App 收到「这是一条来自魔法推送的测试消息」，说明配置成功
- ❌ 如果测试失败，请参考下方常见问题排查
第三步：使用推送#
3.1 通过 API 推送#
创建渠道后，可以通过 MagicPush 的标准 API 进行推送：
bash
curl -X POST http://<服务器IP>:3000/api/push/<渠道ID> \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你的API Token>" \
-d '{
"title": "系统告警",
"content": "服务器 CPU 使用率超过 90%，请及时处理",
"type": "text"
}'支持的消息类型（type 参数）：
| type 值 | 说明 |
|---|---|
text | 纯文本消息（默认） |
markdown | Markdown 格式（会自动转为纯文本） |
html | HTML 格式（需在配置中选择 html 消息类型） |
3.2 HTML 消息示例#
当配置中选择 html 消息类型时，可以在 content 中使用 HTML 标签：
html
<h2>🚨 服务器告警通知</h2>
<p><strong>告警级别：</strong><span style="color:red;">高</span></p>
<p><strong>服务器：</strong>192.168.1.100</p>
<p><strong>时间：</strong>2024-06-01 14:00:00</p>
<hr>
<p><a href="https://monitor.example.com/alert/12345">查看详情</a></p>💡 提示：HTML 消息在 Meow App 中会进行渲染，支持更多样式。
技术细节#
消息长度限制#
- 消息内容：建议不超过 1000 字符
HTML 渲染#
- 当选择
html消息类型时，Meow App 会渲染 HTML 内容 - 支持常见 HTML 标签：
<h1>~<h6>、<p>、<strong>、<em>、<a>、<span>等 - 不支持 JavaScript 和 CSS 外部引用
Markdown 自动转换#
- 如果发送
markdown类型消息，MagicPush 会自动将 Markdown 转换为纯文本 - 转换规则：去除 Markdown 标记，保留纯文本内容
常见问题#
Q: 发送消息返回「用户昵称不能为空」错误？
原因：昵称字段未填写。
解决：
- 在 Meow App 中设置用户昵称
- 将昵称填写到 MagicPush 渠道配置中
- 确保昵称不包含斜杠（
/）
Q: 鸿蒙设备没有收到推送消息？
原因：可能有多种情况。
解决：
- 确认 Meow App 在后台运行（鸿蒙可能被杀后台）
- 检查鸿蒙通知权限是否开启（设置 → 应用 → Meow → 通知）
- 确认昵称拼写正确
- 测试消息可能有短暂延迟，请耐心等待
Q: 如何推送到多个设备？
解决：
- 在每个鸿蒙设备上安装 Meow App
- 每个设备设置不同的昵称
- 在 MagicPush 中创建多个 Meow 渠道，每个对应一个昵称
Q: HTML 消息没有正确渲染？
原因：可能未选择 html 消息类型。
解决：
- 在 MagicPush 渠道配置中，将「消息类型」选择为
HTML - 确认 HTML 标签是标准格式
- 不支持的标签会被忽略或显示为文本
Q: 昵称可以修改吗？
回答：可以。在 Meow App 中修改昵称后，同步修改 MagicPush 渠道配置中的昵称即可。
Q: 消息类型应该选哪个？#
| 场景 | 推荐类型 |
|---|---|
| 简单文本通知 | text |
| 需要丰富样式（颜色、链接等） | html |