# meow-push-skill

**Repository Path**: szpatrick/meow-push-skill

## Basic Information

- **Project Name**: meow-push-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MeoW 消息推送 Skill

一个面向大模型和 Codex 的 MeoW 消息推送 Skill，用于生成、发送及排查 `api.chuckfang.com` 推送请求。

## 能力

- 向指定 MeoW 昵称发送文本或 HTML 消息
- 生成可复制的 GET、POST JSON、表单或纯文本请求
- 解析 JSON 业务状态码并说明失败原因
- 处理非会员发送频率限制
- 避免不安全的自动重试和共享公共出口 IP

## 安装

将仓库克隆到个人 Codex Skills 目录：

```bash
git clone https://github.com/fkccoding/meow-push-skill.git ~/.codex/skills/meow-push
```

## 使用

在 Codex 中显式调用：

```text
使用 $meow-push 给 Chuck 发送一条消息：服务部署完成
```

也可以要求它只生成请求而不实际发送：

```text
使用 $meow-push 生成一个向 Chuck 推送纯文本消息的 POST JSON 示例，不要发送
```

## 重要说明

- 只有用户明确要求实际发送时，Skill 才会调用推送接口。
- 使用 HTTPS，普通消息优先采用 POST JSON。
- 支持 `text` 和 `html`，不支持 Markdown。
- 推送请求不具备幂等性。超时、连接中断或 `500` 等结果不确定的情况不会自动重试。
- 尽量不要通过多人共享的公共出口 IP 调用接口。同一 IP 向多个昵称推送可能被 MeoW 判定为攻击行为；可信 IP 可联系开发者申请加入白名单。

非会员用户发送限制：

- 每 3 秒最多 1 条
- 每分钟最多 15 条
- 每小时最多 60 条
- 每天最多 1,000 条

超过发送或 IP 频率限制时，API 返回 JSON 业务状态码 `429`。

## 文档

- [Skill 指令](SKILL.md)
- [API 参考](references/api.md)
- [MeoW 在线 API 文档](https://www.chuckfang.com/MeoW/api_doc.html)

## 目录结构

```text
.
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    └── api.md
```