核心用法
Linkding skill 提供了完整的 REST API 封装，用于管理自托管书签服务。核心功能覆盖：
- 书签生命周期：创建（支持自动抓取元数据）、更新、归档/解除归档、删除
- 检索与搜索：按关键词全文搜索、按日期过滤、列出归档/未读/共享状态的书签
- URL 存在性检查：快速验证链接是否已保存，返回完整书签数据
- 标签系统：创建标签、为书签打标签，支持批量更新
tag_names数组 - 智能捆绑（Bundles）：基于搜索词和标签规则创建动态书签集合
典型工作流：
1. 保存待读：create $URL --tags "toread" --unread
2. 快速检索：bookmarks --query "python" --limit 10 | jq 格式化输出
3. 批量管理：通过 update 命令批量修改标签或归档状态
显著优点
- 自托管隐私：Linkding 是开源自托管方案，数据完全用户掌控，无第三方依赖
- 元数据自动抓取：创建书签时自动提取标题、描述，减少手动输入
- 灵活的标签与筛选：支持多标签组合、排除标签、日期范围等高级过滤
- 轻量脚本封装：通过 shell 脚本调用，易于集成到现有 CLI 工作流
局限性与风险
- 自建服务依赖：需用户自行部署 Linkding 实例并维护，无托管服务兜底
- 认证配置门槛：需手动配置
config.json的 URL 和 API Token，配置错误会导致完全不可用 - 无冲突检测：更新标签时直接覆盖
tag_names数组，误操作可能丢失原有标签 - API 限制：未提及速率限制或并发控制，大规模批量操作需谨慎
适合人群
技术用户、隐私敏感者、已有 Linkding 实例的自托管爱好者，以及需要将书签管理集成到终端工作流的开发者。
常规风险
- 凭证泄露：
config.json存储明文 API Token，需确保文件权限（建议 600） - 数据一致性：直接 PATCH 更新可能覆盖并发修改，无乐观锁机制
- 实例可用性：自建服务若宕机，skill 完全失效，需自行监控服务状态