Files
Obsidian/MyArticles/jackwener 系列 CLI 工具分析(意义、原理、作用、用法).md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

10 KiB
Raw Blame History

Jackwener 系列 CLI 工具深度剖析

jackwener 开发的系列 CLI 工具(小红书、Discord、Twitter/X、Telegram、B站)遵循统一设计理念,为主流社交/内容平台提供终端级操作能力,无需依赖官方API或图形界面,兼顾实用性与扩展性。以下是各工具的详细分析:

一、通用特性与核心设计

1. 统一意义

  • 打破平台壁垒:将分散在不同App/网页的社交/内容操作集中到终端,支持批量处理、自动化脚本集成,提升效率。

  • AI Agent 友好:通过标准化输出(YAML/JSON)和 SKILL.md 配置,无缝对接AI工具,实现智能检索、自动互动等高级场景。

  • 隐私与控制:本地缓存数据(部分工具)、无第三方数据中转,避免隐私泄露;支持代理和反检测机制,降低账号风险。

  • 轻量化替代:无需安装臃肿App,适合服务器、远程终端等无GUI环境,或追求高效操作的技术用户。

2. 通用原理

  • 认证机制:优先提取浏览器Cookie(支持Chrome、Firefox等主流浏览器),辅以二维码登录或环境变量配置,模拟真实用户登录状态。

  • API 逆向:解析目标平台Web/APP的API接口,还原请求签名(如小红书的x-s签名、Twitter的TLS指纹伪装)和数据格式,实现无官方SDK的操作。

  • 反检测策略:通过高斯抖动延迟、固定浏览器指纹、会话级身份持久化等技术,模拟人类操作行为,规避平台风控。

  • 结构化输出:统一采用 ok/schema_version/data/error 信封格式,非交互模式默认输出YAML(更省Token),支持JSON格式适配脚本。

二、各工具具体分析

1. xiaohongshu-cli(小红书)

核心意义

填补小红书无官方CLI工具的空白,支持从内容消费(搜索、阅读)到创作(发笔记、互动)的全流程终端操作,适合内容创作者批量管理账号或研究者采集数据。

核心原理

  • 基于逆向工程还原小红书API,支持笔记、用户、话题等核心资源的CRUD操作。

  • 反风控机制:模拟macOS Chrome浏览器指纹、请求签名动态生成、验证码自动冷却,降低IP封禁风险。

  • 短索引缓存:将搜索/热门列表结果缓存至本地,支持通过序号快速操作(如 xhs read 1 读取第一条结果)。

核心作用

  • 内容消费:关键词/用户/话题搜索、分类热门浏览、评论/子评论查看。

  • 账号互动:点赞、收藏、评论、关注/取关,支持批量操作(通过短索引)。

  • 创作管理:发布图文笔记、查看/删除自有笔记、监控通知(点赞/关注/@)。

  • 数据导出:结构化输出笔记/评论数据,支持JSON/YAML格式用于分析。

基础用法


# 安装(推荐uv工具)
uv tool install xiaohongshu-cli

# 登录(自动提取浏览器Cookie)
xhs login
# 或二维码登录:xhs login --qrcode

# 搜索与阅读
xhs search "美食" --sort popular  # 搜索热门美食笔记
xhs read 1                       # 阅读第一条搜索结果
xhs comments 1 --all --json      # 导出所有评论(JSON格式)

# 互动操作
xhs like 1                       # 给第一条结果点赞
xhs comment 1 -c "好赞!"        # 发表评论

# 创作者操作
xhs post --title "旅行攻略" --body "正文" --images img1.jpg  # 发布图文笔记

2. discord-cli(Discord)

核心意义

专为Discord设计的本地优先工具,解决官方客户端检索不便、数据导出困难的问题,适合社区管理员批量管理消息或用户备份聊天记录。

核心原理

  • 基于Discord HTTP API,通过本地用户Token认证,将聊天记录同步至SQLite数据库。

  • 本地优先设计:查询操作优先读取本地缓存,支持增量同步和近实时监听(tg listen --persist),减少网络请求。

核心作用

  • 数据同步:批量同步指定频道/服务器的聊天记录,支持增量更新。

  • 本地检索:按关键词、时间、发送者筛选消息,支持正则搜索。

  • 数据导出:将聊天记录导出为文本/JSON/YAML格式,便于备份或分析。

  • 基础管理:查看服务器成员、频道信息,监控聊天活跃度(timeline/top命令)。

基础用法


# 安装
uv tool install kabi-discord-cli

# 认证(提取本地Token并保存)
discord auth --save

# 同步服务器消息(首次同步)
discord dc sync-all -n 500

# 本地查询
discord search "rust" -c general  # 搜索general频道的"rust"相关消息
discord today --json              # 查看今日消息(JSON格式)

# 导出数据
discord export "技术交流" -f yaml -o chat.yaml  # 导出频道消息至YAML文件

3. twitter-cli(Twitter/X)

核心意义

无需官方API密钥即可操作Twitter/X,支持推文读写、账号管理全流程,适合用户快速浏览 timeline 或开发者自动化发推。

核心原理

  • 基于Cookie认证(支持多浏览器提取)和TLS指纹伪装(curl_cffi),模拟浏览器请求行为。

  • 内置评分筛选:可通过配置文件设置点赞、转发、回复权重,自动筛选高价值推文。

核心作用

  • 内容消费:浏览For You/Following时间线、搜索推文(支持Top/Latest/图文筛选)、查看用户主页。

  • 内容创作:发布推文/回复/引用推文,支持最多4张图片附件。

  • 账号管理:点赞、转推、书签操作,批量管理关注列表。

  • 长文处理:提取Twitter Article并导出为Markdown格式。

基础用法


# 安装
uv tool install twitter-cli

# 浏览时间线
twitter feed -t following  # 查看关注对象的推文
twitter feed --filter      # 启用高价值推文筛选

# 搜索与查看
twitter search "AI agent" -t Latest --max 50  # 搜索最新相关推文
twitter show 2 --full-text                    # 查看第二条结果的完整内容

# 发布推文
twitter post "Hello from CLI!" --image photo.jpg  # 带图发推

4. tg-cli(Telegram)

核心意义

基于Telethon的本地优先工具,解决Telegram官方客户端搜索功能有限、数据备份不便的问题,适合重度用户管理聊天记录或自动化消息处理。

核心原理

  • 基于MTProto协议(非Bot API),使用个人账号认证,将对话框同步至本地SQLite数据库。

  • 支持定时同步(cron/systemd)和近实时监听,确保本地缓存与云端一致。

核心作用

  • 聊天同步:批量同步指定聊天/频道的消息,支持按聊天数量限制同步频率。

  • 高级检索:按关键词、正则、时间窗口筛选消息,支持多条件组合查询。

  • 数据导出:导出聊天记录为多种格式,支持按时间范围筛选。

  • 基础互动:发送消息至指定聊天,适合自动化通知场景。

基础用法


# 安装
uv tool install kabi-tg-cli

# 首次登录(默认使用Telegram Desktop凭证)
tg chats

# 刷新本地缓存
tg refresh

# 本地查询
tg search "Rust|Golang" --regex --hours 72  # 搜索72小时内相关消息
tg today --sync-first                       # 查看今日消息(先同步最新数据)

# 定时同步(systemd示例)
cp examples/systemd/tg-refresh.service ~/.config/systemd/user/
systemctl --user enable --now tg-refresh.timer

5. bilibili-cli(B站)

核心意义

B站全功能终端工具,覆盖视频消费、创作管理、互动操作,适合UP主批量管理作品或用户快速检索视频资源。

核心原理

  • 逆向B站API,支持视频、动态、收藏夹等核心资源的操作,认证方式包括Cookie提取和二维码登录。

  • 音频提取:基于av库解析视频音频,切分为ASR-ready的WAV片段,支持自定义片段时长。

核心作用

  • 视频消费:查看视频详情、字幕(支持SRT导出)、AI总结、热门评论。

  • 创作管理:发布文字动态、删除动态、查看作品数据(播放/点赞数)。

  • 互动操作:点赞、投币、一键三连,批量管理关注列表和收藏夹。

  • 音频提取:下载视频音频并切分片段,用于语音识别或二次创作。

基础用法


# 安装(含音频提取功能)
uv tool install "bilibili-cli[audio]"

# 登录(二维码登录)
bili login

# 视频操作
bili video BV1ABcsztEcY --subtitle  # 查看视频字幕
bili audio BV1ABcsztEcY --segment 60  # 提取音频(每段60秒)

# 互动操作
bili triple BV1ABcsztEcY  # 一键三连
bili favorite 123456      # 收藏视频

# 创作操作
bili dynamic-post "抽个奖,明天开奖"  # 发布文字动态

三、系列工具共性与差异

共性

  • 安装方式统一:均支持uv/pipx安装,部分支持源码编译,环境隔离性好。

  • 认证逻辑一致:优先提取浏览器Cookie,辅以二维码/Token认证,无需手动配置密钥。

  • 输出格式标准化:均支持JSON/YAML/rich格式,非交互模式默认YAML,适配AI Agent和脚本。

  • 反风控设计:均包含请求延迟、指纹伪装等机制,降低账号封禁风险。

差异

工具 核心定位 独特功能 数据存储方式
xiaohongshu-cli 内容创作与互动 短索引快速操作、分类热门浏览 本地缓存(索引/ Cookie)
discord-cli 聊天记录同步与导出 服务器成员管理、活跃度统计 SQLite数据库
twitter-cli 推文读写与筛选 高价值推文评分、长文导出 本地缓存(配置/ Cookie)
tg-cli 聊天记录本地管理 近实时监听、定时同步 SQLite数据库
bilibili-cli 视频消费与创作 音频提取、字幕导出、AI总结 本地缓存(Cookie)

四、使用建议

  1. 环境依赖:优先使用uv工具安装,避免依赖冲突;定期升级(uv tool upgrade <工具名>)以适配平台API变更。

  2. 账号安全:避免高频次批量操作,建议使用代理(部分工具支持XXX_PROXY环境变量);敏感账号优先使用二维码登录。

  3. 数据管理:本地缓存文件默认存储在~/.xxx-cli/目录,定期备份重要数据(如discord/tg的SQLite数据库)。

  4. AI集成:通过--yaml格式输出数据,配合SKILL.md配置,可快速对接Claude等AI Agent,实现智能检索或自动化操作。

是否需要针对某款工具的高级功能(如批量操作脚本、AI集成配置)提供更详细的教程?

(注:文档部分内容可能由 AI 生成)