即刻 App 的 AI 自动化操作经验
本文记录用 MidnightDarling/jike-skill 对即刻（Jike）App 做自动化操作的实战经验，包括扫码登录、拉取完整时间线、统计圈子分布，以及过程中踩过的坑。数据日期：2026-08-12。
一、选型：为什么选 MidnightDarling/jike-skill
对比过多个即刻相关 skill 后选定这个，理由：
- 成熟度：v0.4.1，有 CHANGELOG，141 个自动化测试，5 次迭代
- 可审查：MIT 开源，代码干净，只请求即刻官方 API（api.ruguoapp.com），无第三方地址
- 多通道：pip 包 + Codex 插件 + Claude 插件三通道
- 全量导出：可把个人全部帖子导出为 Markdown + 图片
⚠️ 注意：这是第三方逆向即刻 Web API 的项目（非官方），扫码登录用的是个人账号，建议先只读试用。
二、安装与登录
安装
# 方式一：pip 安装
pip install jike-skill[qr]
# 方式二：Codex 插件
codex plugin marketplace add MidnightDarling/jike-skill扫码登录
python3 scripts/auth.py- 脚本会生成二维码：浏览器 HTML 页面 + 终端 ASCII 双通道
- 用即刻 App →「发现」→ 扫码登录
- 成功后在 stdout 输出 JSON：
access_token+refresh_token
Token 保存
# 保存到配置文件（权限 600）
mkdir -p ~/.config/jike-skill
cp tokens.json ~/.config/jike-skill/tokens.json
chmod 600 ~/.config/jike-skill/tokens.json
# 写入 shell 配置自动加载
export JIKE_ACCESS_TOKEN="..."
export JIKE_REFRESH_TOKEN="..."token 过期时客户端会自动 refresh（401 自动重试）；refresh 失败需重新扫码。
三、核心操作
拉取关注流
python3 scripts/client.py feed --limit 20获取当前登录用户信息（关键技巧）
# 不带参数调用 profile 接口，返回当前登录用户
GET /1.0/users/profile返回结构里 user.username 是 UUID 格式的唯一标识，user.screenName 是昵称。
拉取完整时间线（关键接口）
# 用 UUID 作为 username，翻页拉取个人全部动态
POST /1.0/personalUpdate/single
body: {"limit": 20, "username": "你的UUID", "loadMoreKey": "上一页返回的key"}要点：
- username 必须用 UUID（profile 返回的
user.username），用中文昵称会报”找不到用户” - 用
loadMoreKey翻页直到返回空，即可拉全时间线 - 返回的每条动态带
topic字段（圈子信息）、actionTime（时间）、likeCount/commentCount（互动数据）
圈子统计
每条动态的 topic.content 就是圈子名，聚合计数即可得到常发圈子分布。
四、踩坑记录（重要）
坑 1：后台进程被杀导致 token 丢失
- 现象：用
(cmd &)方式后台跑 auth.py，进程在命令退出时被连带杀掉，轮询中断、token 丢失 - 解法：改用稳定的后台任务方式启动（如工具的 run_in_background），进程存活直到扫码完成
坑 2：用搜索接口当时间线用（错误方法）
- 现象：用
search/integrate搜自己昵称，只返回 5 条帖子，且不是按时间排序 - 原因：搜索接口是”按相关性排序的搜索结果”，有翻页上限，不是完整时间线
- 正确做法：用
personalUpdate/single+ UUID + loadMoreKey 翻页，才能拿到完整时间线（实测 217 条）
坑 3：圈子字段名搞错
- 现象：读
topics（复数数组）字段全空，误判”没发圈子” - 原因：即刻 API 用的是
topic（单数对象），每条帖子只属于一个圈子 - 教训：拿到接口数据先打印完整结构确认字段名，不要凭猜测
坑 4：skill 里的 userPost/listMore 端点已失效
- 该端点已 404（即刻 API 更新过），skill 里部分命令会失败
- 用
personalUpdate/single替代可正常工作
五、参考链接
隐私提示
操作即刻个人账号时注意：token、UUID、帖子原文属于个人数据，公开分享前需脱敏。本文所有示例已去除真实 token 与 UUID。
🔐 GitHub 评论（Giscus）
正在连接 GitHub 评论…