故障排查
确认 Astral Overlay 正在运行并已启用 Notification API。WebSocket 使用 42070，UDP 使用 42069。API 仅监听本机。
如果 XSOverlay 或其他进程占用端口，请停止该监听程序并重启通知 API 或 Astral Overlay。
WebSocket 连接不稳定或被拒绝
Section titled “WebSocket 连接不稳定或被拒绝”包含非空的 client 查询参数。使用 ws://127.0.0.1:42070/?client=YourApp，而非文档网站地址。
已连接，但没有通知
Section titled “已连接，但没有通知”- 使用准确的命令
SendNotification。 - 将
jsonData编码为包含 JSON 的字符串。 - 提供非空标题或正文。
- 检查通知可见性与静默设置。
- 确认不透明度大于零。
- 考虑是否有大量消息正在队列中等待。
Python 示例无法导入 websocket
Section titled “Python 示例无法导入 websocket”在运行示例的同一个 Python 环境中安装 websocket-client。导入名为 websocket。
加载布局后屏幕关闭了
Section titled “加载布局后屏幕关闭了”加载会替换当前屏幕和聊天面板。空槽位会用空工作空间替换它们。