ChatLab CLI命令大全：用终端高效管理和查询聊天记录

ChatLab CLI命令大全：用终端高效管理和查询聊天记录

【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址: https://gitcode.com/ChatLab/ChatLab

ChatLab是一款本地优先的AI聊天记录分析工具，通过强大的CLI命令集，用户可以在终端中高效管理、查询和分析聊天记录。本文将详细介绍ChatLab的核心命令，帮助你快速掌握终端操作技巧，提升聊天记录处理效率。

基础命令：快速入门

查看版本信息

通过version命令可以快速了解当前安装的ChatLab版本：

chatlab -v # 或 chatlab --version

检查更新

保持工具最新是获取最佳体验的关键：

chatlab update

执行后会自动检查并更新到最新版本，更新完成后需要重启ChatLab生效。

启动服务

ChatLab提供HTTP API和Web UI界面，通过start命令启动服务：

chatlab start

默认情况下会启动Web UI并自动打开浏览器，如需仅启动API服务可使用--headless参数：

chatlab start --headless --port 8080

会话管理：掌控你的聊天数据

列出所有会话

查看已导入的聊天会话列表：

chatlab sessions list

可通过--query参数筛选会话名称，--platform参数按平台过滤：

chatlab sessions list --query "工作群" --platform wechat

查看会话详情

获取特定会话的详细信息，包括消息数量、成员数和时间范围：

chatlab sessions show --session <session-id>

其中<session-id>是会话的唯一标识符，可以从sessions list命令的输出中获取。

成员管理：了解聊天参与者

列出会话成员

查看特定会话中的所有成员及其消息数量：

chatlab members list --session <session-id>

使用--sort参数按消息数或名称排序，--query参数搜索成员：

chatlab members list --session <session-id> --sort messages --query "张"

查看成员名称历史

追踪成员的名称变更记录：

chatlab members history --session <session-id> --member <member-id>

<member-id>可以是成员ID或成员名称，使用me可以查看当前用户的名称历史。

消息查询：精准定位内容

搜索消息

按关键词搜索会话中的消息：

chatlab messages search <keyword> --session <session-id>

可通过--start和--end参数限定时间范围，--sender指定发送者：

chatlab messages search "项目计划" --session <session-id> --start "2023-01-01" --sender "张三"

导出消息

将消息导出为JSON或CSV格式：

chatlab messages export --session <session-id> --format json --output messages.json

AI交互：智能分析聊天记录

聊天AI查询

通过AI分析聊天记录并获取 insights：

chatlab chat --session <session-id> --question "总结上周的项目讨论"

使用--json参数获取结构化输出，--no-stream参数禁用流式输出：

chatlab chat --session <session-id> --question "谁是最活跃的成员" --json

高级功能：定制与扩展

执行SQL查询

对聊天记录执行自定义SQL查询（默认禁用，需先启用）：

# 启用SQL查询功能 chatlab config set cli.allow_sql true # 执行查询 chatlab sql "SELECT senderName, COUNT(*) as count FROM messages GROUP BY senderName ORDER BY count DESC" --session <session-id>

配置管理

查看和修改配置：

# 显示配置文件路径 chatlab config path # 查看当前配置 chatlab config show # 设置配置项 chatlab config set cli.allow_raw true

服务管理

将ChatLab安装为系统服务，实现开机自启：

# 安装服务 chatlab start --daemon # 查看服务状态 chatlab status # 停止服务 chatlab stop

导入数据：开始你的分析之旅

导入聊天记录

支持多种格式的聊天记录导入：

chatlab import <file-path>

查看所有支持的格式：

chatlab formats

通过这些命令，你可以在终端中完全掌控ChatLab的所有功能。无论是简单的消息查询，还是复杂的AI分析，ChatLab CLI都能提供高效、灵活的操作体验。开始探索你的聊天数据，发现隐藏在对话中的有价值信息吧！

【免费下载链接】ChatLabLocal-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具项目地址: https://gitcode.com/ChatLab/ChatLab