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），仅供参考

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

相关推荐

双串联锂电池主动均衡设计与工程落地要点

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

单台云服务器搭建高性价比CI/CD自动化部署方案

更多资讯

屏译「自动适配画面」如何实现？漫画气泡检测、原文擦除与背景修复原理全解析

Rust RFC 3983 深度解析：为什么 Rust 需要 `f16b`——16 位 Brain 浮点类型的设计与落地

MooTool Next Compose Vault MCP 授权路径 `realpath` 对齐 Electron 解析：从符号链接误授权到 canonical 路径强制校验

10分钟跑通第一条查询：internship-warehouse数据集快速上手教程（HF datasets流式+DuckDB双方案实战）

老 Mac 装新 macOS：用 OpenCore Legacy Patcher 四步完成系统升级与显卡补丁

PEEK与PEKK选型指南：从分子结构到工艺窗口的工程实践

今日更新

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

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

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

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？