# 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 生成)