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

283 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 生成)