Chatlog Alpha CLI 使用手册:http call 与 Action JSON Lines 命令速查

发布时间:2026/10/16 1:11:17

Chatlog Alpha CLI 使用手册:http call 与 Action JSON Lines 命令速查 后端CLIMCP 服务即时通讯RAG人工智能AI 技能【免费下载链接】chatlog_alpha原 [chatlog]项目一个微信数据库解密读取及提供mcp服务、http服务的开源软件现已支持通过微信clawbot接口推送消息可以实时转发全部或指定消息到clawbot项目地址https://gitcode.com/gh_mirrors/ch/chatlog_alpha点击查看免费下载Chatlog Alpha是一款面向微信 4.x 的开源聊天记录解密与读取工具内置 HTTP API 与 MCP 服务。它的命令行客户端CLI是最高效的使用方式之一通过chatlog http call可以直接在终端里查询会话历史、跨库搜索和执行 SQL通过chatlog action子命令面向前端和脚本的JSON Lines动作接口可以自动化地提取密钥、解密数据库并启动 HTTP 服务全程无需打开浏览器。本文是一份完整的命令速查手册带你快速上手。一、CLI 命令总览不带参数先认识命令家族不带任何子命令直接运行chatlog默认进入终端交互界面TUI。与日常使用相关的子命令共有 3 组子命令用途源码位置chatlog http在终端直接调用内置的 HTTP 接口cmd_http.gochatlog action面向脚本/前端的 JSON Lines 动作接口cmd_action.gochatlog key独立提取微信数据库密钥cmd_key.go所有命令都支持全局参数--debug见 root.go。准备工作先让 HTTP 服务跑起来http call调用的是 Chatlog 内置的 HTTP 服务默认地址127.0.0.1:5030。首次使用请按顺序完成运行 TUI选中你的微信账号重启并获取数据库密钥→获取图片密钥按需→解密数据启动 HTTP 服务。以上流程也可以用action命令在脚本中完成见下文第三节。二、http 子命令终端里的 HTTP 客户端http有两个子命令定义于 cmd/chatlog/cmd_http.gochatlog http list # 列出全部受支持的接口别名 chatlog http call # 调用任意一个接口用 http list 快速查接口执行chatlog http list会按名称排序打印「别名、方法、路径、说明」四列例如NAME METHOD PATH DESCRIPTION health GET /health Health check history GET /api/v1/history Chat history search GET /api/v1/search Message search db_query GET /api/v1/db/query Execute SQL image GET /image/{key} Get image media cache_clear POST /api/v1/cache/clear Clear cache完整的别名清单维护在 skills/chatlog-http-cli/SKILL.md常用分类速查分类常用别名健康检查health、ping会话与消息sessions、history、search、unread、new_messages、members、stats联系人与群聊contacts、chatrooms、favorites朋友圈sns_notifications、sns_feed、sns_search数据库db、db_tables、db_data、db_query媒体文件image、video、file、voiceMCPmcp、mcp_sse、mcp_messagehttp call 的参数速查表call的参数分为通用参数挂在http上与调用参数挂在call上通用参数参数说明默认值--addr/-a服务地址127.0.0.1:5030--timeout请求超时秒30--show-status在响应前打印 HTTP 状态行true调用参数参数说明--endpoint接口别名用http list查询推荐用法--path原始路径如/api/v1/history与--endpoint同时提供时覆盖其路径--method/-X覆盖 HTTP 方法如 POST 接口需要显式指定--querykeyvalue查询参数可重复使用--path-param路径模板参数替换路径中的{key}占位符--header请求头keyvalue可重复--body/--body-file请求体字符串 / 文件JSON 体会自动做合法性校验--output/-o将响应体保存到文件适合下载媒体 小提示大多数/api/v1/*接口默认返回 YAML加上--query formatjson即输出 JSON方便管道处理。5 个最常用的 http call 示例# 1️⃣ 查询某个会话的历史消息 chatlog http call --endpoint history \ --query chat华服饲料运输信息群 \ --query limit100 \ --query formatjson # 2️⃣ 全局搜索关键词 chatlog http call --endpoint search --query keyword图片 --query limit20 # 3️⃣ 直接执行只读 SQL chatlog http call --endpoint db_query \ --query groupmessage \ --query filemessage_0.db \ --query sqlselect local_id,create_time from MSG limit 5 # 4️⃣ 按媒体 key 下载图片并保存为文件 chatlog http call --endpoint image \ --path-param keyb309f8f81716aff9e1c9dded3bec74e7 \ -o pic.jpg # 5️⃣ 清空查询缓存POST 接口需显式 --method POST chatlog http call --endpoint cache_clear --method POST执行效果--show-status默认开启先打印200 OK状态行写到 stderr响应体输出到 stdout使用-o保存文件时会在 stderr 打印saved: pic.jpg。几个高频接口的常用 query 参数对应路由实现见 internal/chatlog/http/route.go别名常用--query参数historychat、limit、time/since/until、formatsearchkeyword、limitmemberschat群聊 IDnew_messageslimit、state增量游标 JSONstatschat、timefavoriteslimit、fav_type、querydb_querygroup、file、sqlsns_feed/sns_notificationslimit、since/until、include_read三、action 子命令JSON Lines 脚本化接口chatlog action是面向前端、脚本和调试面板的动作接口每条输出都是一行独立 JSONJSON Lines 格式方便用jq、Python 等工具逐行解析。JSON Lines 事件格式每个事件包含以下字段定义见 cmd/chatlog/cmd_action.go字段含义type事件类型action_started/state/success/erroraction动作名如get-image-keystage阶段starting/progress/completed/runningmessage人类可读的说明文字error_code出错时的错误码如decompress_faileddata成功时的业务数据状态快照、账号列表等timestampRFC3339 时间戳一次典型调用的输出长这样{type:action_started,action:decompress-data,stage:starting,message:开始解密数据,timestamp:2026-10-15T01:00:00Z} {type:success,action:decompress-data,stage:completed,message:数据解密完成,data:{...},timestamp:2026-10-15T01:00:05Z}8 个 action 命令速查表命令作用是否长驻action list-accounts列出运行中与历史账号否action status输出当前状态快照否action restart-and-get-key重启微信并获取数据库密钥否action get-image-key获取图片解密密钥否action decompress-data解密聊天数据库否action start-http启动 HTTP 服务并保持运行✅action start-auto-decompress启动自动解密并保持运行✅action set更新运行配置密钥、目录等否action switch-account切换当前账号必须带--pid或--history否多数命令支持两个目标参数见 cmd/chatlog/cmd_action.go# 用微信进程 PID 定位账号 chatlog action status --pid 12345 # 用历史账号名定位账号 chatlog action decompress-data --history 某个账号长驻命令start-http、start-auto-decompress会收到CtrlC或SIGTERM信号后自动停止服务。action set支持写入密钥等配置--data-key、--image-key、--http-addr、--work-dir、--data-dir、--wal-enabled等。脚本化示例一行命令跑完解密流程# 列出账号用 jq 逐行解析 JSON Lines chatlog action list-accounts | jq -c . # 获取密钥 → 解密 → 启动 HTTP 服务依次执行 chatlog action restart-and-get-key --history 某个账号 chatlog action decompress-data --history 某个账号 chatlog action start-http --history 某个账号 安全设计action status只返回data_key_present/image_key_present布尔值和脱敏占位符不回传密钥原文需要写入密钥时请使用action set --data-key/--image-key。四、key 子命令一键提取数据库密钥在 macOS 上可以跳过 TUI用独立命令提取微信 V4 数据库密钥实现见 cmd/chatlog/cmd_key.go# 自动探测账号目录macOS 仅支持 Frida 方式需先 pip3 install frida-tools chatlog key # 指定微信账号数据目录 chatlog key --data-dir $HOME/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/账号目录 # 只输出 data_key 十六进制值便于脚本捕获 chatlog key --json常用参数参数说明默认值--data-dir微信账号数据目录含db_storage可省略自动探测---timeout等待密钥的超时秒数180--json仅输出密钥十六进制便于脚本false捕获成功后密钥会打印data_key...并写入账号目录下的all_keys.json权限0600。五、常见问题排查现象处理方法http call连接失败先确认 TUI 中 HTTP 服务已启动或用--endpoint ping验证检查5030端口是否被占用返回 YAML 想要 JSON追加--query formatjsonkey命令长时间无输出确认微信能自动登录增加等待chatlog key --timeout 300Frida 无法附加macOS检查csrutil statusSIP 开启时需先关闭详见 README 常见问题请求超时用--timeout调整大查询建议--timeout 120六、小结chatlog http list—— 先查别名再写调用零记忆成本chatlog http call—— 终端即客户端--query可重复传参、-o直接落盘适合日常查询与数据导出chatlog action—— JSON Lines 输出让密钥提取、数据库解密、服务启动都能写进自动化脚本chatlog key—— 一条命令拿到数据库密钥配合--json无缝进入 CI/CD。更多接口细节可参考 skills/chatlog-http-cli/SKILL.md整体安装与平台兼容性说明见 README.md。掌握以上命令Chatlog Alpha 的 CLI 能力基本就覆盖全了。赞分享后端CLIMCP 服务即时通讯RAG人工智能AI 技能【免费下载链接】chatlog_alpha原 [chatlog]项目一个微信数据库解密读取及提供mcp服务、http服务的开源软件现已支持通过微信clawbot接口推送消息可以实时转发全部或指定消息到clawbot项目地址https://gitcode.com/gh_mirrors/ch/chatlog_alpha点击查看免费下载相关推荐human-review CLI命令速查手册open、poll、status、setup与JSON反馈格式详解human review CLI命令速查手册open、poll、status、setup与JSON反馈格式详解 human review 是一款在浏览器里可视Overstory CLI 命令速查手册38 个 ov 命令完整清单与实战用法Overstory CLI 命令速查手册38 个 ov 命令完整清单与实战用法 Overstory 是一款面向 AI 编程代理AI coding agentChatlog Alpha HTTP API 参考手册会话、搜索、朋友圈与数据库接口Chatlog Alpha HTTP API 参考手册会话、搜索、朋友圈与数据库接口 Chatlog Alphachatlog_alpha是一款微信数据库后端CLIMCP 服务即时通讯RAG人工智能AI 技能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/16 1:06:17

源码编译与定制实战:从环境配置到性能优化全解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/16 1:06:17

Jev模型全解析:从AI视频生成原理到10大实战玩法

最近这段时间,“Jev模型”这个名字真是刷屏级别的存在。我头一回注意到它,是在海外内容社区刷到一支短片,评论区清一色在问“这真的是AI生成的?”点进数据页一看,全球围观量已经超过3500万人次。紧接着就有不少人开始追…

2026/10/16 1:06:17

双节锂电池主动均衡设计:MP2642GR-Z与PIC18F46K42实战方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/16 2:41:25

静态页面仿写实战:从结构拆解到响应式还原的完整流程

1. 先搞清楚一件事:静态页面仿写到底在仿什么很多刚入行的同学一听到“静态页面仿写”这几个字,第一反应就是对着参考页面截图,然后在编辑器里一点一点抠代码。这个理解不算错,但格局小了。我做了这么多年前端,接过的仿…

2026/10/16 2:41:25

大文件分片上传实战:从分片原理到可复用组件全解

大文件分片上传这件事,我在不同的项目里前前后后做了快五年。每次做都觉得已经熟了,但每次都会被真实场景再上一课:要么是用户传一个 4K 视频直接白屏,要么是服务端把几十个分片合到一起时内存爆掉。最近正好把一个比较完整的上传…

2026/10/16 2:41:25

MFC扫雷源码实战:从消息映射到递归展开的完整拆解

简介:这是一份面向Windows程序设计初学者与MFC进阶开发者的扫雷游戏完整源码工程,基于Microsoft Foundation Classes框架实现,帮助读者理解如何用C类库封装Win32 API、构建图形界面并处理消息循环。压缩包共71个文件,约2.7MB&…

2026/10/16 2:41:25

Claude Code 接入 DeepSeek:协议转换代理实战指南

先说结论:把 DeepSeek 接进 Claude Code,不是简单地在环境变量里填一个 base_url 和一个 API key 就能完事的。我第一次这么干的时候,Claude Code 回了我一个干干净净的 404,当时我还以为是 key 填错了,翻来覆去排查了…

2026/10/14 11:31:03

Python调用Gemini Structured Outputs实现工单路由门禁

客服工单最怕的不是模型“答错一句话”,而是它给出一段看起来合理的说明,程序却从中猜错优先级。通俗做法是:要求模型只交 JSON(JavaScript Object Notation,轻量数据格式),再让代码验证它。Gem…

2026/10/14 17:41:07

Spring Boot超市进销存系统毕设实战:从需求拆解到答辩通关

最近带的一个学生项目组里,有A同学跑来问我:选什么毕设题目最稳妥,既能让评审老师觉得工作量够,又不会在答辩时被问到语无伦次。我第一反应就是推荐基于Spring Boot的超市仓库管理系统——也就是超市进销存系统。这个题目乍一看平…

2026/10/15 13:42:16

Flutter StatefulWidget 生命周期核心解析

很多刚开始接触 Flutter 的朋友,在看完一堆“Hello World”和基础组件之后,大概率都会撞上同一堵墙:StatefulWidget 里那堆 initState、build、dispose 方法,到底什么时候被调用?为什么顺序是那样?在里面到…

2026/10/16 0:01:11

Cephadm实战指南:Linux系统工程师的生产级Ceph集群部署与排障

简介:本资源是一份完整的Ceph分布式存储系统中文技术文档合集,面向Linux系统运维工程师、云平台架构师及存储方向开发者,帮助读者系统掌握Ceph集群的部署、配置与运维核心能力。文档覆盖对象存储(RGW)、块设备&#xf…

2026/10/16 0:01:11

ITK中SpatialObject几何体系解析:坐标系、变换与管道集成

1. 空间对象的定位:为什么 ITK 需要一套几何描述体系很多刚开始接触 ITK 的朋友,包括我自己,最初都是被它的图像滤波、配准、分割这些“正统”功能吸引进来的。等真正上手做点实际项目,比如把分割出来的器官边界做量化分析、给血管…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑