让AI Agent替你管理书签库Siftly命令行工具siftly完全实战【免费下载链接】SiftlyLocal Twitter/X bookmark organizer with AI categorization and mindmap visualization项目地址: https://gitcode.com/gh_mirrors/si/SiftlySiftly 是一款自托管的本地书签管理工具专为 Twitter/X 书签设计导入书签后它用一条 4 阶段 AI 流水线实体提取 → 图像视觉分析 → 语义打标 → 自动分类把杂乱收藏变成可搜索、可脑图浏览的知识库。除 Web 界面外Siftly 内置了命令行工具siftly能让 AI Agent 或终端爱好者不开 Web 服务就直接查询、筛选和管理整个书签库。本文带你完整实战 siftly 命令的 5 个子命令并演示如何把它交给 AI Agent 干活。为什么书签管理需要命令行入口浏览器界面适合逛但面对这类需求时就很笨拙让 AI Agent 直接操作Claude Code 等助手无法点击页面却能执行 shell 命令批量统计分析想知道我收藏了多少条视频书签、分布在哪些分类命令行一条命令出结果管道组合JSON 输出可以直接接jq、grep等工具做自动化报表Siftly 的 CLI 设计正是为此而生cli/siftly.ts绕过 Next.js 服务直接读取本地 SQLite 数据库全部命令输出标准 JSON——在终端里自动美化缩进被管道接管时自动输出紧凑格式天然对 AI Agent 和脚本友好。快速上手3步装好Siftly书签库1. 安装前置依赖只需 Node.js 18自带 npm。如果你已安装并登录 Claude Code CLIAI 功能会自动复用你的订阅无需额外配置 API Key。2. 克隆项目一键启动git clone https://gitcode.com/gh_mirrors/si/Siftly cd Siftly ./start.shstart.sh 会自动安装依赖、初始化数据库、检测 AI 认证并打开 http://localhost:3000。3. 验证 siftly 命令可用Web 服务不必运行。只要项目依赖装好在项目根目录执行npx tsx cli/siftly.ts --help看到 5 个子命令列表即表示就绪search、list、show、categories、stats。siftly 命令速查表5个子命令全解命令作用常用参数stats书签库总体统计无categories分类列表 各分类书签数无search queryFTS5 全文关键词搜索--limitlist多条件过滤书签列表--source--category--author--media--sort--limit--pageshow id\|tweetId查看单条书签完整详情无siftly stats3秒掌握书签库现状npx tsx cli/siftly.ts stats一次性返回总书签数、已完成 AI 增强的数量、分类数、媒体文件数以及按来源书签/点赞的分组统计——这是让 AI Agent 先了解全局的第一步。siftly categories看清分类分布npx tsx cli/siftly.ts categories列出每个分类的名称、slug、配色和书签数量。AI 分类阶段由 lib/categorizer.ts 驱动这里能直接验证分类结果是否合理。siftly searchFTS5全文搜索比界面更快一步npx tsx cli/siftly.ts search AI agents --limit 10搜索链路是lib/search-utils.ts 先从查询中提取关键词保留 AI、KYC 这类短词过滤停用词再由 lib/fts.ts 的 FTS5 虚拟表做全文检索按相关度排序返回索引未命中时自动回退到LIKE模糊匹配保证总能出结果。注意--limit上限为 100。siftly list按分类、作者、媒体类型过滤# 只看点赞来源、ai-resources 分类里最旧的 5 条 npx tsx cli/siftly.ts list --source like --category ai-resources --sort oldest --limit 5 # 只要带视频的书签按最新排序 npx tsx cli/siftly.ts list --media video --limit 20list的输出还附带total/pages字段配合--page可以稳定分页——脚本遍历全库时非常好用。siftly show查看单条书签全貌npx tsx cli/siftly.ts show 12 # 也可以用原始推文 ID npx tsx cli/siftly.ts show 1812345678901234567返回完整详情推文文本、作者、AI 生成的语义标签、提取的实体、每个媒体的图片标签以及带置信度的分类归属。数据模型定义可参考 prisma/schema.prisma。实战场景让AI Agent替你管理书签库场景一把整理工作交给AI助手在 Siftly 项目目录下打开 Claude Code它会读取 CLAUDE.md 里的项目说明直接说帮我统计书签库概况找出 AI Resources 分类里最新 10 条书签并告诉我每条的 AI 置信度Agent 会自主组合出stats→categories→list --category ai-resources --limit 10这条链路并解读 JSON 结果——这正是 JSON 输出设计的意义AI 不用解析 HTML读 JSON 即可。场景二JSON 输出接 jq 做批量报表管道模式下 siftly 自动输出紧凑 JSON可以直接喂给jq# 统计每个分类的书签总数 npx tsx cli/siftly.ts categories | jq .categories | length # 列出所有带视频书签的作者去重 npx tsx cli/siftly.ts list --media video --limit 100 | jq -r .bookmarks[].authorHandle | sort -u场景三用 npm script 简化调用package.json 已注册siftly脚本省去npx tsx cli/siftly.ts的冗长前缀npm run siftly -- stats npm run siftly -- search crypto --limit 5命令行与Web界面如何配合siftly 是只读眼睛 统计仪表不启动任何服务写入和 AI 流水线仍交给 Web 界面完成导入Import 页的书签条/控制台脚本导出书签 JSON 后上传去重自动处理AI 分类导入后自动触发 4 阶段流水线Categorize 页可实时看进度命令行验证用stats确认enrichedBookmarks是否追平总数检索浏览search/list做机器化查询ai-search 页面 做自然语言语义搜索mindmap 页面 可视化浏览两者共用同一个本地 SQLite 库prisma/dev.db所以命令行看到的永远是最新数据。常见问题速查Q报no such table错误说明 Prisma 客户端或数据库未初始化执行npx prisma generate npx prisma db push即可CLI 的错误提示里也写了这句话见 cli/siftly.ts。Q为什么命令必须在项目根目录运行CLI 通过相对路径读取prisma/dev.db数据库文件换目录会找不到数据。Q搜索不到结果search依赖 FTS5 索引索引在 AI 增强完成后重建未增强的书签会走模糊匹配兜底可尝试用list--author等条件替代。Q想改默认分类编辑 lib/categorizer.ts 中的DEFAULT_CATEGORIES分类的 description 会原样传给 AI写具体一点分类更准。小结siftly 命令用 5 个只读子命令 纯 JSON 输出把 Siftly 的本地书签库变成了 AI Agent 和脚本都能操作的数据源stats看全局、categories看分布、search做全文检索、list灵活过滤、show深挖单条。把它交给 Claude Code 这类 AI Agent帮我整理书签就从一句人话变成一段可执行的自动化流程——数据全程留在你的机器上只有你配置的 AI 接口会发生外部调用。【免费下载链接】SiftlyLocal Twitter/X bookmark organizer with AI categorization and mindmap visualization项目地址: https://gitcode.com/gh_mirrors/si/Siftly创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考