283 lines
10 KiB
Markdown
283 lines
10 KiB
Markdown
# Jackwener 系列 CLI 工具深度剖析
|
||
|
||
|
||
|
||
jackwener 开发的系列 CLI 工具(小红书、Discord、Twitter/X、Telegram、B站)遵循统一设计理念,为主流社交/内容平台提供终端级操作能力,无需依赖官方API或图形界面,兼顾实用性与扩展性。以下是各工具的详细分析:
|
||
|
||
## 一、通用特性与核心设计
|
||
|
||
### 1. 统一意义
|
||
|
||
- **打破平台壁垒**:将分散在不同App/网页的社交/内容操作集中到终端,支持批量处理、自动化脚本集成,提升效率。
|
||
|
||
- **AI Agent 友好**:通过标准化输出(YAML/JSON)和 [SKILL.md](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格式用于分析。
|
||
|
||
#### 基础用法
|
||
|
||
```Bash
|
||
|
||
# 安装(推荐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命令)。
|
||
|
||
#### 基础用法
|
||
|
||
```Bash
|
||
|
||
# 安装
|
||
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格式。
|
||
|
||
#### 基础用法
|
||
|
||
```Bash
|
||
|
||
# 安装
|
||
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)和近实时监听,确保本地缓存与云端一致。
|
||
|
||
#### 核心作用
|
||
|
||
- 聊天同步:批量同步指定聊天/频道的消息,支持按聊天数量限制同步频率。
|
||
|
||
- 高级检索:按关键词、正则、时间窗口筛选消息,支持多条件组合查询。
|
||
|
||
- 数据导出:导出聊天记录为多种格式,支持按时间范围筛选。
|
||
|
||
- 基础互动:发送消息至指定聊天,适合自动化通知场景。
|
||
|
||
#### 基础用法
|
||
|
||
```Bash
|
||
|
||
# 安装
|
||
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总结、热门评论。
|
||
|
||
- 创作管理:发布文字动态、删除动态、查看作品数据(播放/点赞数)。
|
||
|
||
- 互动操作:点赞、投币、一键三连,批量管理关注列表和收藏夹。
|
||
|
||
- 音频提取:下载视频音频并切分片段,用于语音识别或二次创作。
|
||
|
||
#### 基础用法
|
||
|
||
```Bash
|
||
|
||
# 安装(含音频提取功能)
|
||
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 生成) |