wink-pings

面向 终端使用者（命令行 / npx）与 Agent（需理解本仓库如何拉取 Wink Pings 新闻）。英文见 README.en.md。

使用者：CLI

从 Wink Pings 免费获取最新新闻。

无需安装：

npx wink-pings --help
npx wink-pings
npx wink-pings --email [email protected] --freshness 4 --lang zh
npx wink-pings --lang en --json

全局安装（可选）： npm install -g wink-pings，之后直接运行 wink-pings。

常用参数： --email / -e，--lang（zh|en），--freshness（小时，1～48，默认 12），--limit（默认 10，非会员勿超过 10），--json 输出原始 JSON。

邮箱从哪读

在未传 --email 时，按顺序尝试：

1. 环境变量 WINK_PINGS_EMAIL
2. 当前目录下 skills/pings/pings-user-email（单行邮箱）
3. 用户目录 ~/.wink-pings-email

可将注册邮箱写入 skills/pings/pings-user-email 供本仓库与 CLI 复用（该文件已在 .gitignore 中，勿提交）。

Agent：技能与文档

本仓库 Skill 目录遵循常见约定：SKILL.md + reference.md + examples.md（见 skills/pings/README.md）。

| 资源 | 路径 | 说明 | |------|------|------| | Skill 正文 | skills/pings/SKILL.md | 触发词、请求参数、展示格式、底部文案等；以该文件为准 | | 接口契约 | skills/pings/reference.md | HTTP Query、响应字段、错误与业务行为 | | 调用示例 | skills/pings/examples.md | curl / CLI 示例 |

编辑器 / 工具发现（均指向同一套正文 skills/pings/，符号链接便于各工具扫描）：

| 工具 | 路径 | |------|------| | Cursor | .cursor/skills/pings | | Claude Code | .claude/skills/pings（项目级 skills） | | OpenClaw | 仓库根目录 skills/（工作区 skills）；另提供 .openclaw/skills/pings 与上表一致 |

若符号链接在你的系统上不可用，请直接以 skills/pings/ 为准，或把该目录复制到各工具文档要求的全局 skills 目录。

Agent 执行「拉 Pings 新闻」时：先读 SKILL.md，按需读 reference.md / examples.md；邮箱逻辑见上节。

仓库布局（概览）

pings-skills/
├── skills/
│   ├── README.md
│   └── pings/                    # 标准 Skill 目录
│       ├── README.md
│       ├── SKILL.md
│       ├── reference.md
│       ├── examples.md
│       └── scripts/             # 可选，辅助脚本
├── .cursor/skills/pings     # → ../../skills/pings
├── .claude/skills/pings     # → ../../skills/pings（Claude Code）
├── .openclaw/skills/pings   # → ../../skills/pings（OpenClaw）
├── bin/cli.js
├── package.json
├── README.md
└── README.en.md