jike-skill:即刻社交网络的开源 AI 客户端

项目地址:github.com/MidnightDarling/jike-skill | MIT 开源

项目是什么

jike-skill 是一个”给人用,也给 AI agent 用”的即刻(Jike)社交网络客户端。它让 AI 助手能扫码登录即刻,然后刷关注流、发帖、评论、搜索、查看用户资料、导出全部历史——就像给 AI 装上了”即刻的手和眼睛”。

官方描述:Jike (即刻) client for humans and AI agents. QR login (browser HTML or terminal ASCII), full feed/post/comment/search API, and one-command export of your entire Jike history to Markdown.

核心功能

功能说明
扫码登录浏览器 HTML 二维码 + 终端 ASCII 双通道,无需密码
刷关注流拉取你关注的人的动态
发帖/删帖发布和删除原创帖子
评论/删评论评论和删除评论
搜索搜索内容、用户
用户资料查看用户信息和帖子列表
通知查看未读通知
全量导出一行命令把全部帖子导出为 Markdown(含图片)

项目状态

  • 版本:v0.4.1(2026 年)
  • 测试:141 个自动化测试(auth/client/main/types 全覆盖)
  • 迭代:CHANGELOG 记录 5 次版本迭代
  • 作者记录:由 Claude Opus / GPT-5 等多模型协作开发,MIT 许可

架构与设计

jike-skill/
├── SKILL.md                   # Skill 定义(Codex/Claude 用)
├── scripts/                   # 独立脚本(agent 直接运行)
│   ├── auth.py                # 扫码认证
│   ├── client.py              # API 客户端 CLI
│   └── export.py              # 全量历史导出
├── references/api.md          # API 端点参考
├── src/jike/                  # Python 包(pip 用)
├── .codex-plugin/             # Codex 插件清单
├── .claude-plugin/            # Claude 插件清单
└── tests/                     # 自动化测试

设计亮点:

  • 双模式:既是 pip 包,也是 AI agent 插件
  • 类型安全:冻结 dataclass(TokenPair 不可变),token 刷新返回新实例
  • 自动重试:401 时透明地刷新 token 重试
  • 渐进式披露:SKILL.md 精简,API 细节在 references/api.md
  • 零配置:无密码、无 API key,扫码即用

安装方式

作为 Python 包

pip install jike-skill[qr]

作为 Codex 插件

codex plugin marketplace add MidnightDarling/jike-skill

重启 Codex 后,在 /plugins 里启用 Jike。

作为 Claude Code 插件

/plugin marketplace add MidnightDarling/jike-skill
/plugin install jike@jike-skill

安全设计

  • 无密码认证,仅扫码(和即刻网页版一致)
  • 所有请求要求 Origin: https://web.okjike.com
  • token 自动刷新,只需持久化 refresh_token
  • 二维码 HTML 写入不可预测路径的临时文件(0600 权限),自动删除,HTML 转义防注入

认证原理

即刻用的是 QR 扫码认证(同网页版):

  1. 在即刻服务器创建 session → 得到 uuid
  2. 把 uuid 编码成 jike:// 深链二维码
  3. 用户用即刻 App 扫码确认
  4. 服务器返回 access_token + refresh_token
  5. refresh_token 长期有效,保存后无需重复扫码

相关链接

风险提示

该工具通过逆向即刻 Web API 实现,非即刻官方出品。API 端点可能随即刻更新而变化(如 userPost/listMore 已失效)。使用个人账号操作前请知悉风险,建议只读操作先行验证。