SuperAPI AI 工具集

bestblogs-capture

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:在阅读 BestBlogs 内容时保存和回顾个人标注。主要能力包括书签的增删改查(幂等、分页)、对原文划线(highlight)、划线时附加笔记(note),以及阅读历史的查看、删除单条与清空。笔记与划线共用同一底层实体 UserHighlightEntity,靠 entryType 区分:entryType=highlight 时 note 为空,entryType=note 时 note 非空;列表接口可用 entryType 做服务端过滤。

用法示例:收藏用 bestblogs capture bookmark add RAW_xxx --note "值得反复读" --json;划线用 bestblogs capture highlight add -r RAW_xxx -t "精彩段落原文" --json,若加 -n 则成为笔记;查看划线用 bestblogs capture highlights --resource RAW_xxx --json,查看笔记用 bestblogs capture notes --limit 20 --json;历史方面有 history list、history remove RAW_xxx 和需要确认的 history clear --yes。

限制与错误处理:highlight 重复创建会返回 409/CONFLICT,应告知用户该段已划线;删除时 404/NOT_FOUND 可按幂等处理,提示已不存在;401 表示未登录,需执行 bestblogs auth login。清空历史属危险操作,需确认。价格、平台与效果等资料暂未提供。