SuperAPI AI 工具集

supsub-sub

办公与效率

查看项目

更新于 10-16 06:19

技能介绍

用途:管理 SupSub 中的订阅源及其文章。源类型有 MP(微信公众号)、WEBSITE(网站)、X(推特平台账号)。注意:--type X 专指推特;用户口语中的「X」多为账号占位符,只有明确提到推特/Twitter/X 平台时才用 --type X。

安装:curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash,或 npm i -g @supsub/cli、pnpm add -g @supsub/cli。需先登录,supsub auth status 显示 Authenticated;未授权时运行 supsub auth login。

主要能力:

  1. 列出订阅:supsub sub list [--type MP|WEBSITE|X],每行含 sourceId、sourceType、name、unreadCount。
  2. 添加订阅有两条互斥入口:supsub sub add --source-id <id> --type <MP|WEBSITE|X> [--group <gid>],或 supsub sub add --mp-id <mpId> [--type MP]。sourceId 为正整数,mpId 为 mp search 得到的 base64 字符串,二者不可混用。
  3. 删除订阅:supsub sub remove --source-id <id> --type <MP|WEBSITE|X>。为破坏性操作,需向用户二次确认后再执行;退订会连带移出全部分组,重订不自动恢复分组归属。
  4. 浏览文章:supsub sub contents --source-id <id> --type <MP|WEBSITE|X> [--unread|--all] [--brief] [--page <n>] [--page-size <n>]。--unread 与 --all 互斥,默认等价 --unread;按时间浏览应加 --all。批量枚举建议加 --brief 以减小输出。
  5. 整源标记已读:supsub sub mark-read --source-id <id> --type <MP|WEBSITE|X> --all。仅支持整源已读,不可逆,执行前需二次确认;不支持单篇已读。

使用限制:解析数据用 -o json;--type 仅接受 MP/WEBSITE/X(大小写不敏感),写成 TWITTER 等会报 INVALID_ARGS;重复订阅幂等返回成功,重复退订报错。退出码:0 成功,2 未授权,64 参数错误,1 业务错误,10 网络错误,11 服务端错误。分组管理见 supsub-group,跨源未读概览见 supsub-unread。