核心用法
Wallabag 技能通过标准 OAuth2 流程连接用户自托管的 Wallabag 实例，提供完整的 REST API 封装。用户通过环境变量配置认证信息后，可执行书签的创建、读取、更新、删除（CRUD）操作，支持按关键词搜索、标签过滤、归档状态与星标状态筛选。标签管理支持批量添加与单条移除，满足精细化分类需求。
显著优点
1. 隐私优先：完全基于用户自托管实例，数据不经过第三方；支持 HTTPS 端到端加密。
2. 确定性操作：所有功能通过可审计的 shell 脚本实现，无黑盒行为，便于 CI/CD 集成。
3. 灵活的元数据管理：支持自定义标题、批量标签操作，适应个人知识管理（PKM）工作流。
4. 无状态设计：Access Token 仅存于进程内存，不持久化到磁盘，降低凭证泄露面。
潜在缺点与局限性
- 配置门槛：需手动在 Wallabag 后台创建 OAuth 应用并获取 Client ID/Secret，对非技术用户不友好。
- 依赖外部工具：标签操作依赖
jq，部分精简环境可能缺失。 - 无内置重试机制：网络波动可能导致 API 调用失败，需调用方自行处理。
- Token 生命周期管理：未实现自动刷新逻辑，需关注 Wallabag 端的 Token 有效期配置。
适合人群
- 自建 Wallabag 服务的技术用户与隐私倡导者
- 希望将书签管理自动化集成到脚本或 AI 工作流中的开发者
- 需要批量归档、标签整理的重度阅读稍后（Read-it-later）用户
常规风险
- 凭证泄露风险：Client Secret 与密码若通过不安全渠道传输或误提交至版本控制，可导致实例被接管。务必使用专用环境变量或密钥管理服务。
- 实例可用性依赖：技能本身无健康检查，若 Wallabag 实例不可达，操作将失败。
- 数据丢失风险：
delete操作不可逆，建议结合list与get确认目标条目后再执行。