YNote News — 有道云笔记资讯推送
基于用户最近收藏的笔记，自动提取关注话题，搜索最新资讯，生成结构化简报并推送给用户。
⚠️ Context 管控：本 Skill 涉及大量数据（笔记全文 + 搜索结果）。每步完成后只保留结构化摘要，立即丢弃原始输出，避免 context window 溢出。详见各 Step 中的「🔴 Context 管控」标注。
使用场景与用法总结
| 场景 | 说明 | 怎么用 |
|---|
| 对话随时触发 | 在 OpenClaw 里随时要一份「基于最近收藏的资讯推送」 | 输入触发语，Agent 执行 4 步后直接展示简报 |
| 定时自动执行 |
每天固定时间自动整理收藏并生成简报 | 配置定时任务，到点自动触发；未设置则默认 9:00 |
触发语示例：资讯推送、最近关注、热点推送、每日简报、生成资讯推送、帮我整理收藏的简报
前置：需配置 YNOTE_API_KEY（拉取笔记）；Step 3 搜索使用 Perplexity（有内置默认 Key，开箱即用，支持时间过滤），若失败降级到 Brave（需 BRAVE_API_KEY）或 open-websearch（免 Key 兜底）。详见「前置条件」。
前置条件
- 1. YNote MCP（必需）： INLINECODE2
- 网页搜索（Step 3，三级降级）：
-
Perplexity（首选）：使用本 Skill 的 Search API 脚本（
perplexity-search-call.sh），返回文章列表；Key 已内置，开箱即用。
-
Brave（fallback）：需在
openclaw.json 中配置
BRAVE_API_KEY。文档：
- open-websearch（兜底，免 Key）：只需 Node.js，通过 websearch-call.sh 调用
- 3. CLI 工具：
curl、jq、 INLINECODE9
Quick Reference
| 操作 | 命令 |
|---|
| 获取最近收藏笔记 | INLINECODE10 （自动截断正文，默认 limit=30） |
| 创建笔记 |
bash {baseDir}/mcp-call.sh createNote '{"title":"标题","content":"# 内容","folderId":""}' |
| 搜索笔记 | bash {baseDir}/mcp-call.sh searchNotes '{"keyword":"关键词"}' |
| 获取笔记内容 | bash {baseDir}/mcp-call.sh getNoteTextContent '{"fileId":"<id>"}' |
| Perplexity 搜索（文章列表） | echo '{"query":"关键词","max_results":5,"search_recency_filter":"day"}' | bash {baseDir}/perplexity-search-call.sh（或 heredoc 传 JSON） |
| 网页搜索（兜底） | bash {baseDir}/websearch-call.sh search '{"query":"关键词","limit":10,"engines":["duckduckgo","bing","baidu"]}' |
核心工作流
收到用户的资讯推送请求后，按以下步骤执行。每步完成后仅保留结构化摘要，丢弃原始输出。
Step 1：获取最近收藏的笔记内容
CODEBLOCK0
包装脚本自动调用 getRecentFavoriteNotes 并截断每条笔记正文为前 500 字，确保 30 条笔记总量 ≤ 45KB，不会撑爆 context。
返回字段：fileId、title、content（前 500 字，超出部分截断）、collectTime（毫秒时间戳）。
可选参数：get-favorite-notes.sh [limit] [每条字数]，默认 30 500。
Step 2：分析笔记内容，提取话题
Agent 分析 Step 1 获取的笔记内容，按内容相关性聚类，提取不超过 5 个话题。每个话题用一句可搜索的主题表述概括，便于 Step 3 检索到相关文章。
排序权重：收藏时间新旧 > 关联笔记数量 > 话题区分度。相似主题应合并。
每个话题包含：
| 字段 | 说明 |
|---|
| 话题名称 | 简洁明确的主题描述（如"AI 大模型技术趋势"） |
| 主题表述（用于搜索） |
一句或若干词，作为 Step 3 的搜索 query，便于检索相关文章 |
| 关联笔记 | 相关收藏笔记标题列表 |
| 简要描述 | 1-2 句话概括内容倾向 |
Step 3：搜索每个话题的最新文章
用 Step 2 各话题的主题表述作为搜索 query，对每个话题检索5 篇最新文章。逐个话题搜索，每次搜索后立即提取摘要、丢弃原始响应。
搜索工具（按配置自动降级）：
- 1. Perplexity（首选）：使用 Search API 返回文章列表（title、url、date、snippet）。调用：
echo '{"query":"<主题表述>","max_results":5,"search_recency_filter":"<见下表>"}' | bash {baseDir}/perplexity-search-call.sh（建议用 heredoc 或临时文件传 JSON，避免中文经 argv 编码问题）。调用失败时降级到 Brave。 - Brave（fallback）： INLINECODE24
- open-websearch（兜底）： INLINECODE25
时间范围：Perplexity 使用 search_recency_filter，与用户表述的对应关系（未指定默认 day）：
| 用户表述 | freshness | searchrecencyfilter |
|---|
| 未指定 / 最近 / 24 小时内 | INLINECODE28 | INLINECODE29 |
| 最近几天 |
pw | week |
| 最近一个月 | pm | month |
| 近一年 | py | year |
时间过滤：结果未必符合设定时间范围，需按日期再筛一次：范围内保留、超出剔除；无日期的可保留，优先用有日期的。每话题仍约 5 篇，不足则保留现有数量。
筛选：同一来源 ≤ 3 篇；相同 URL 去重；跨话题命中归入匹配度更高的话题。
🔴 Context 管控：每个话题搜索完成后，只保留「标题、来源、日期、URL、80-150 字内容介绍」，丢弃原始搜索响应。
Step 4：生成简报并展示
将 Step 3 的摘要按下方「简报模板」格式输出，在对话中直接展示。
简报模板（必须遵守）
CODEBLOCK1
响应格式（必须遵守）
输出简报正文后，紧接着输出统计摘要：
CODEBLOCK2
Step 5：引导与通知
定时任务触发时，额外发送桌面通知：openclaw nodes notify "📰 今日资讯推送已生成，共 M 个话题 N 篇文章"（用户手动触发时不发）。
引导开启资讯推送：简报展示后，执行 openclaw cron list --json | jq '.jobs[] | select(.name == "ynote-daily-briefing")' 检测定时任务。未设置时追加： INLINECODE38
资讯推送管理
设置资讯推送
设置（触发词：设置资讯推送、开启资讯推送、资讯推送设置）：
- 1.
openclaw cron list --json | jq '.jobs[] | select(.name == "ynote-daily-briefing")' 检测是否已存在 - 已存在 → 告知用户当前配置（推送时间），询问是否修改
- 不存在 → 创建（默认每天 9:00，用户指定时间则替换）： INLINECODE40
- 回复确认，含推送时间、修改/关闭方式提示
修改时间（触发词：修改资讯推送时间）：
- 1. 解析目标时间（如"改到 8 点"→
0 8 * * *，"晚上 8 点"→ 0 20 * * *） - INLINECODE43 后重新 INLINECODE44
- 确认修改成功
关闭（触发词：关闭资讯推送、取消资讯推送）：
- 1. INLINECODE45
- 确认关闭，告知可随时重新开启
环境变量
| 变量 | 必需 | 默认值 | 说明 |
|---|
| INLINECODE46 | ✅ | — | MCP Server API Key |
| INLINECODE47 |
— | 内置默认值 | Perplexity 搜索，开箱即用 |
| BRAVE_API_KEY | — | — | Brave 搜索（Perplexity 失败时使用） |
| YNOTE_MCP_URL | — | https://open.mail.163.com/api/ynote/mcp/sse | MCP SSE 端点 |
| YNOTE_MCP_TIMEOUT | — | 30 | 超时秒数 |
常见问题
Q: 报错缺少搜索 API key？
搜索按 Perplexity → Brave → open-websearch 自动降级，最终兜底免 Key，只需 Node.js。
Q: 搜索结果太少？
调整关键词组合，或在 open-websearch 中增加 engines（如 ["duckduckgo","bing","baidu"]）。
Q: 没有最近收藏？
先用 ynote-clip Skill 收藏一些网页，再生成话题简报。
Q: 如何设置每天自动推送资讯？
说「设置资讯推送」即可，默认早上 9 点，可自定义时间。
YNote News — 有道云笔记资讯推送
基于用户最近收藏的笔记，自动提取关注话题，搜索最新资讯，生成结构化简报并推送给用户。
⚠️ Context 管控：本 Skill 涉及大量数据（笔记全文 + 搜索结果）。每步完成后只保留结构化摘要，立即丢弃原始输出，避免 context window 溢出。详见各 Step 中的「🔴 Context 管控」标注。
使用场景与用法总结
| 场景 | 说明 | 怎么用 |
|---|
| 对话随时触发 | 在 OpenClaw 里随时要一份「基于最近收藏的资讯推送」 | 输入触发语，Agent 执行 4 步后直接展示简报 |
| 定时自动执行 |
每天固定时间自动整理收藏并生成简报 | 配置定时任务，到点自动触发；未设置则默认 9:00 |
触发语示例：资讯推送、最近关注、热点推送、每日简报、生成资讯推送、帮我整理收藏的简报
前置：需配置 YNOTEAPIKEY（拉取笔记）；Step 3 搜索使用 Perplexity（有内置默认 Key，开箱即用，支持时间过滤），若失败降级到 Brave（需 BRAVEAPIKEY）或 open-websearch（免 Key 兜底）。详见「前置条件」。
前置条件
- 1. YNote MCP（必需）：export YNOTEAPIKEY=your-api-key-here
- 网页搜索（Step 3，三级降级）：
-
Perplexity（首选）：使用本 Skill 的 Search API 脚本（perplexity-search-call.sh），返回文章列表；Key 已内置，开箱即用。
-
Brave（fallback）：需在 openclaw.json 中配置 BRAVE
APIKEY。文档：
- open-websearch（兜底，免 Key）：只需 Node.js，通过 websearch-call.sh 调用
- 3. CLI 工具：curl、jq、node
Quick Reference
| 操作 | 命令 |
|---|
| 获取最近收藏笔记 | bash {baseDir}/get-favorite-notes.sh （自动截断正文，默认 limit=30） |
| 创建笔记 |
bash {baseDir}/mcp-call.sh createNote {title:标题,content:# 内容,folderId:} |
| 搜索笔记 | bash {baseDir}/mcp-call.sh searchNotes {keyword:关键词} |
| 获取笔记内容 | bash {baseDir}/mcp-call.sh getNoteTextContent {fileId:} |
| Perplexity 搜索（文章列表） | echo {query:关键词,maxresults:5,searchrecency_filter:day} | bash {baseDir}/perplexity-search-call.sh（或 heredoc 传 JSON） |
| 网页搜索（兜底） | bash {baseDir}/websearch-call.sh search {query:关键词,limit:10,engines:[duckduckgo,bing,baidu]} |
核心工作流
收到用户的资讯推送请求后，按以下步骤执行。每步完成后仅保留结构化摘要，丢弃原始输出。
Step 1：获取最近收藏的笔记内容
bash
bash {baseDir}/get-favorite-notes.sh
包装脚本自动调用 getRecentFavoriteNotes 并截断每条笔记正文为前 500 字，确保 30 条笔记总量 ≤ 45KB，不会撑爆 context。
返回字段：fileId、title、content（前 500 字，超出部分截断）、collectTime（毫秒时间戳）。
可选参数：get-favorite-notes.sh [limit] [每条字数]，默认 30 500。
Step 2：分析笔记内容，提取话题
Agent 分析 Step 1 获取的笔记内容，按内容相关性聚类，提取不超过 5 个话题。每个话题用一句可搜索的主题表述概括，便于 Step 3 检索到相关文章。
排序权重：收藏时间新旧 > 关联笔记数量 > 话题区分度。相似主题应合并。
每个话题包含：
| 字段 | 说明 |
|---|
| 话题名称 | 简洁明确的主题描述（如AI 大模型技术趋势） |
| 主题表述（用于搜索） |
一句或若干词，作为 Step 3 的搜索 query，便于检索相关文章 |
| 关联笔记 | 相关收藏笔记标题列表 |
| 简要描述 | 1-2 句话概括内容倾向 |
Step 3：搜索每个话题的最新文章
用 Step 2 各话题的主题表述作为搜索 query，对每个话题检索5 篇最新文章。逐个话题搜索，每次搜索后立即提取摘要、丢弃原始响应。
搜索工具（按配置自动降级）：
- 1. Perplexity（首选）：使用 Search API 返回文章列表（title、url、date、snippet）。调用：echo {query:<主题表述>,maxresults:5,searchrecencyfilter:<见下表>} | bash {baseDir}/perplexity-search-call.sh（建议用 heredoc 或临时文件传 JSON，避免中文经 argv 编码问题）。调用失败时降级到 Brave。
- Brave（fallback）：websearch(关键词, provider: brave, freshness: pd)
- open-websearch（兜底）：bash {baseDir}/websearch-call.sh search {query:关键词,limit:5,engines:[duckduckgo,bing]}
时间范围：Perplexity 使用 searchrecencyfilter，与用户表述的对应关系（未指定默认 day）：
| 用户表述 | freshness | searchrecencyfilter |
|---|
| 未指定 / 最近 / 24 小时内 | pd | day |
| 最近几天 |
pw | week |
| 最近一个月 | pm | month |
| 近一年 | py | year |
时间过滤：结果未必符合设定时间范围，需按日期再筛一次：范围内保留、超出剔除；无日期的可保留，优先用有日期的。每话题仍约 5 篇，不足则保留现有数量。
筛选：同一来源 ≤ 3 篇；相同 URL 去重；跨话题命中归入匹配度更高的话题。
🔴 Context 管控：每个话题搜索完成后，只保留「标题、来源、日期、URL、80-150 字内容介绍」，丢弃原始搜索响应。
Step 4：生成简报并展示
将 Step 3 的摘要按下方「简报模板」格式输出，在对话中直接展示。
简报模板（必须遵守）
markdown
资讯推送 — yyyy-MM-dd
基于最近 N 条收藏笔记，为您梳理了以下 M 个关注话题的最新动态。
话题 1: xxx
关注原因：基于您收藏的《笔记A》《笔记B》等
最新动态
（有日期时按时间倒序排列，最新在前）
- 1. 文章标题 — 来源 (日期)
文章内容介绍：覆盖三要素——① 主题（讲什么）② 核心观点（主要结论）③ 阅读价值（为什么值得读）。3-5 句话或 80-150 字，禁止「介绍了…」「讨论了…」等空泛开头。
🔗 链接
- 2. 文章标题 — 来源 (日期)
文章内容介绍：……
🔗 链接
话题 2: xxx
关注原因：基于您收藏的《笔记C》等
最新动态
- 1. …
响应格式（必须遵守）
输出简报正文后，紧接着输出统计摘要：
{总文章数} 篇最新文章 |
| 📂 数据来源 | 最近 {N} 条收藏笔记 |
| ⏰ 生成时间 | {yyyy-MM-dd HH:mm} |
Step 5：引导与通知
定时任务触发时，额外发送桌面通知：openclaw nodes notify 📰 今日资讯推送已生成，共 M 个话题 N 篇文章（用户手动触发时不发）。
引导开启资讯推送：简报展示后，执行 openclaw cron list --json | jq .jobs[] | select(.name == ynote-daily-briefing) 检测定时任务。未设置时追加：💡 想每天
