用途:面向 Pinboard(pinboard.in)书签的交互式管理技能,覆盖标签审计、死链检测和内容时效性检查三类任务。
主要能力:标签审计按标签规范检查书签并分批呈现问题、确认后修复;死链检测通过 HTTP HEAD/GET 检查所有书签 URL 并报告结果;时效性检查用启发式预筛选加 Jina Reader 的 AI 内容分析识别过时技术书签,不自动删除,所有操作需用户确认。
使用方式:前置条件为 Pinboard 账号、PINBOARD_AUTH_TOKEN 环境变量和 curl。首次使用若 ~/.config/nini-skill/pinboard-manager/tag-convention.md 不存在,需先运行标签规范生成器:通过 API 获取全部书签,分析标签频率、模式、语言和疑似拼写错误,向用户展示结果并询问偏好分类,生成规范文件后经确认保存。按用户意图选择模式,如「pinboard 整理 tag」进入标签审计,「pinboard 检查死链」进入死链检测,「pinboard 检查时效」进入时效性检查。API 调用示例:curl -s "https://api.pinboard.in/v1/posts/all?auth_token=$PINBOARD_AUTH_TOKEN&format=json"。更新书签时 /posts/add 会整体覆盖,必须传入全部字段(url、description、extended、tags、shared、toread)并设 replace=yes,否则会丢失数据。
限制:Pinboard 建议每 3 秒最多一次 API 调用,批量操作需加 sleep 3;posts/all 限每 5 分钟一次,结果应缓存到 /tmp/pinboard_all.json 复用。常见错误包括 token 未设置、403 令牌无效、429 超限、部分更新丢数据、Jina Reader 空响应或超时。技能加载时不主动验证工具,命令失败时再逐步引导配置。具体工作流细节见 references 下对应文档。