核心用法
youdaonote-clip 是一款面向有道云笔记用户的网页剪藏工具，通过三级路由策略实现高成功率的网页保存。用户只需说「剪藏网页」「保存网页」或「收藏网页」并附带 URL，即可触发自动化流程。
路由优先级：
- 路径A（Twitter/X专用）：针对
x.com或twitter.com的推文页面，使用 Apify 服务提取结构化数据 - 路径B（国内站点快速通道）：服务端直接抓取知乎、公众号、掘金、CSDN 等站点的正文内容，无需浏览器渲染
- 路径C（通用浏览器提取）：默认路径，优先使用浏览器 evaluate 能力处理 SPA 动态渲染页面，失败时降级至
web_fetch的 Markdown 提取
关键特性：
- 明确不支持并发，多个 URL 强制串行处理
- 浏览器提取注入内联 SDK 脚本（inject-sdk.fn.js），仅读取 DOM、不修改页面、不访问存储
- 完整调试体系，支持按 key 串联全流程日志
显著优点
1. 成功率优先的设计理念：三级降级策略（B→C→C降级）确保复杂页面也能被保存
2. 动态内容友好：路径C专门处理 React/Vue 等 SPA 框架渲染的页面，优于普通爬虫工具
3. 站点精细化适配：Twitter 走独立 Apify 链路，国内主流内容平台走服务端快速通道
4. 安全可控：调试日志脱敏处理，不记录完整页面内容；浏览器注入脚本内联可审计
5. 运维透明：perf-test/run-clip.sh 支持性能测试，日志按 debugKey 串联整条链路
潜在缺点与局限性
1. 速度妥协：串行执行 + 浏览器渲染链路导致大批量剪藏较慢，未做并行优化
2. 外部依赖：Twitter 路径依赖 Apify API Token（可选），路径C依赖 OpenClaw browser 工具
3. 环境门槛：需配置 YOUDAONOTE_API_KEY，依赖 Node、mcporter、jq 等二进制工具
4. 站点白名单限制：路径B仅覆盖有限国内站点，新站点默认走较慢的路径C
5. 无文件夹选择：当前版本不支持指定保存位置，默认保存为普通笔记
适合人群
- 有道云笔记重度用户，需要跨设备同步网页资料
- 信息收集者，经常保存公众号、知乎、技术博客等内容
- 对剪藏成功率敏感、愿意牺牲速度换取稳定性的用户
- 具备一定技术背景、能配置环境变量和调试日志的进阶用户
常规风险
- API 密钥泄露：
YOUDAONOTE_API_KEY需妥善保管，避免提交至代码仓库 - Apify 费用：Twitter 高频使用可能产生第三方服务费用
- 隐私边界：浏览器提取虽仅读取 DOM，但仍会在目标页面执行脚本，敏感页面需谨慎
- 服务依赖：有道云服务可用性直接影响剪藏成功率
- 调试日志残留：开启
YOUDAONOTE_CLIP_DEBUG后需定期清理日志目录