babybitter
6191956338
补充抖音导出表情代码识别表，让文本分析把 [微笑]、[星星眼]、[666]、[V5]、[kisskiss] 等带方括号的抖音表情代码当作表情，而不是普通文本词汇。
新增平台表情代码数据模块 bracket-emoji，集中管理微信经典表情映射与从抖音导出中收集到的表情代码名（含此前的 [躺平]、[强壮]）；cleanText 按 [代码]/【代码】 形式识别已知平台表情代码并在清洗时剥离。此前非中文名的抖音表情代码（如 [V5]、[ok]、[kisskiss]）会被当作普通词汇进入词频统计；语言偏好分析的分词清洗也改用与词频一致的 cleanText，表情代码不再混入高频词，而口头禅与短语统计仍保留 [表情] 原始形式。
补充脱敏合成数据回归测试，覆盖括号格式文本清洗、Node 与 Browser 词频统计以及语言偏好分析；新测试在识别逻辑缺失时会失败。
(cherry picked from commit c80885e0e3)
Your chat history, finally yours.
English | 简体中文
Official Website · Docs · Quick Start · Roadmap · Releases
ChatLab is an open-source desktop app for understanding your social conversations. It combines a flexible SQL engine with AI agents so you can explore patterns, ask better questions, and extract insights from chat data, all on your own machine.
Currently supported: WhatsApp, LINE, QQ, Discord, Instagram, Telegram, iMessage, and Google Chat. Coming next: Messenger and KakaoTalk.
New install? Start here: Getting started
Core Features
- 🚀 Built for large histories: Stream parsing and multi-worker processing keep imports and analysis responsive, even at million-message scale.
- 🔒 Private by default: Your chat data and settings stay local. No mandatory cloud upload of raw conversations.
- 🤖 AI that can actually operate on data: Agent + Function Calling workflows (24+ tools) can search, summarize, and analyze chat records with context.
- 📊 Insight-rich visual views: See trends, time patterns, interaction frequency, rankings, and more in one place.
- 🧩 Cross-platform normalization: Different export formats are mapped into a unified model so you can analyze them consistently.
Installation
Desktop App
Download the installer for your OS from the official website or GitHub Releases, then double-click to install.
CLI
Requires Node.js ≥ 20.
npm i chatlab-cli -g
Start ChatLab:
clb web # Start API + Web UI, auto-open in browser
clb web --no-open # Start API + Web UI, skip auto-open
clb web --headless # API only, no Web UI (for scripts / AI Agents)
Common options: --port <port> (default 3110), --host <address>, --token <token>.
To run as a persistent background service (auto-start on login + auto-restart on crash):
clb web --daemon # Install as system service (macOS / Linux)
clb status # Check service status
clb stop # Stop and uninstall service
For a full walkthrough, see the Quick Start guide.
Usage Guides
Preview
For more previews, please visit the official website: chatlab.fun
Architecture Overview
ChatLab is a pnpm monorepo built on Electron + Vue 3 + Nuxt UI + Tailwind CSS. Core business logic lives in shared packages (@openchatlab/core, @openchatlab/node-runtime, @openchatlab/tools), consumed by both the desktop app and the CLI service — so they stay in sync.
Data flows in five stages: format detection → stream parsing → local persistence → SQL + AI query → visualization.
For a deep dive, see the architecture documentation.
Architecture Principles
- Local-first by default: Raw chat data, indexes, and settings remain on-device unless you explicitly choose otherwise.
- Streaming over buffering: Stream-first parsing and incremental processing keep large imports stable and memory-efficient.
- Composable intelligence: AI features are assembled through Agent + Tool Calling, not hard-coded into one model path.
- Schema-first evolution: Import, query, analysis, and visualization share a consistent data model that scales with new features.
Local Development
For complete contributor instructions, see the Development Guide.
Requirements
- Node.js >= 24 < 25
- pnpm >= 11 < 12
Setup
# Install dependencies
pnpm install
# Start dev mode — prompts you to choose which app to launch
pnpm dev
Or launch a specific target directly:
pnpm dev:desktop # Electron desktop app
pnpm dev:cli-web # CLI Web frontend + local server
pnpm dev:web-wasm # Browser-only Web WASM
pnpm dev:serve # CLI server only
pnpm docs:dev # Docs site
If Electron encounters exceptions during startup, you can try using electron-fix:
npm install electron-fix -g
electron-fix start
Privacy Policy & User Agreement
Before using this software, please read the Privacy Policy & User Agreement.
Community
Please follow these principles before submitting a Pull Request:
- Obvious bug fixes can be submitted directly.
- For new features, please submit an Issue for discussion first; PRs submitted without prior discussion will be closed.
- Keep one PR focused on one task; if changes are extensive, consider splitting them into multiple independent PRs.
- For local setup, repository structure, checks, and AI collaboration notes, see the Development Guide.
Thanks to all contributors:
License
AGPL-3.0 License