chattercatcher 0.1.0

package/AGENTS.md

@@ -0,0 +1,157 @@
+# ChatterCatcher 项目协作规范
+
+## 项目使命
+
+ChatterCatcher 是一个本地优先的家庭飞书/Lark 群知识机器人。它的职责是静默捕获日常聊天、文件、图片、链接和语音中的重要信息，在用户提问时用简短答案和可追溯引用回答。
+
+它不是自主 Agent。它不能代表用户执行任意外部操作。这个产品只做三件事：保存、检索、解释家庭知识。
+
+## 第一性原理
+
+任何产品和技术决策都必须回到这些基本事实：
+
+1. 家庭重要信息经常散落在闲聊里。
+2. 没有证据的回答不可信。
+3. 更新的信息通常更有用，但只有在明确是同一事实的更新时才应覆盖旧信息。
+4. 家庭聊天数据是隐私数据，默认必须本地掌控。
+5. 安装和维护必须足够简单，让家里一个懂技术的人能长期运行。
+6. 机器人应该减少打扰，而不是变成群里的噪音。
+
+取舍优先级：
+
+1. 正确性和来源可追溯。
+2. 隐私和本地数据控制。
+3. 端到端可用的 MVP。
+4. 运维简单。
+5. 长期可扩展。
+
+## RAG 强制原则
+
+ChatterCatcher 必须使用 RAG。禁止把大量历史聊天、文件全文或任意长上下文直接堆给 LLM。
+
+所有问答必须走这个路径：
+
+```text
+问题理解 -> 检索 -> 证据重排 -> 冲突处理 -> 基于证据生成答案 -> 输出引用
+```
+
+硬性要求：
+
+- LLM 回答只能基于检索出的证据块和必要系统提示。
+- 检索证据必须保留来源元数据。
+- 回答事实性问题时必须带引用。
+- 如果检索不到证据，必须说不知道。
+- 上下文窗口不是知识库，不能用“塞更多上下文”替代索引、检索和引用。
+
+## 开发流程
+
+- 每次只做一个清晰的逻辑单元。
+- 完成一个逻辑单元后必须自测。
+- 自测通过后必须创建一次 git commit。
+- 不要把无关改动混进同一个提交。
+- 不要留下未说明的半成品行为。
+
+固定循环：
+
+```text
+理解 -> 实现 -> 自测 -> 修复 -> 提交 -> 汇报
+```
+
+如果测试无法运行，必须在最终回复里说明原因；如果和提交相关，也要体现在提交信息或后续说明里。
+
+## Git 规则
+
+- 每完成一个任务或里程碑就提交一次。
+- 提交信息优先使用简洁的 conventional commit：
+  - `docs: 中文化项目文档`
+  - `feat: 添加飞书网关`
+  - `fix: 处理空检索结果`
+  - `test: 覆盖冲突处理`
+- 不得重写或丢弃用户已有改动，除非用户明确要求。
+- 提交前必须检查 `git status --short`。
+- 一个提交只包含当前任务相关文件。
+
+## 自测要求
+
+每次代码改动必须按风险选择合适的自测：
+
+- CLI 改动：本地运行命令，或添加/更新自动化测试。
+- Gateway 改动：验证启动、配置加载、优雅关闭。
+- 飞书集成改动：单测使用 mock；真实飞书验证要记录手工验证步骤。
+- RAG 改动：测试检索、引用、空结果行为，确保没有全量上下文堆叠。
+- 冲突处理改动：测试旧事实、新事实、讨论语气、明确更新语气。
+- 文件解析改动：至少为涉及格式准备一个代表性 fixture。
+- Web UI 改动：运行构建检查，并本地查看受影响页面。
+
+项目脚手架完成后，最低自测命令应包括：
+
+```bash
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+如果命令还不存在，要么补齐，要么明确说明项目尚未到该阶段。
+
+## 产品约束
+
+- 默认本地部署。
+- 默认 Web UI 只监听 `127.0.0.1`。
+- 所有事实性回答必须有引用；除非机器人明确说不知道。
+- 不得把闲聊建议当成确定事实。
+- 新事实覆盖旧事实时，必须保留历史证据。
+- 文件是一等知识源，和聊天消息同等重要。
+- MVP 只支持飞书/Lark。
+- MVP 的 LLM 和 embedding 提供商必须兼容 OpenAI API。
+
+## 架构约束
+
+- 运行时：Node.js 20+。
+- 语言：TypeScript。
+- 产品入口：CLI 优先。
+- 元数据存储：SQLite 起步。
+- 向量存储：本地、适合 RAG。
+- 关键词检索必须和向量检索并存。
+- 后台任务必须能从 CLI 和 Web UI 观察。
+- 核心本地运行不能依赖 SaaS-only 服务。
+
+## 文档规则
+
+- 以后所有项目文档默认使用中文。
+- 产品决策写入 `docs/PRD.md`。
+- 里程碑和实施顺序写入 `docs/DEVELOPMENT_PLAN.md`。
+- 架构和技术栈写入 `docs/TECHNICAL_ARCHITECTURE.md`。
+- 行为或范围变化时同步更新文档。
+- 优先写明确验收标准，不写空泛愿景。
+
+## 安全和隐私
+
+- 不记录 secrets。
+- 不打印完整 API Key、App Secret 或 token。
+- secrets 必须和普通配置分开保存。
+- 聊天历史、文件、OCR 结果、语音转写都视为隐私数据。
+- 本地 Web UI 默认不得暴露到公网。
+- 任何远程模型调用都必须能从配置中看出来。
+
+## 回答质量标准
+
+机器人回答应该：
+
+- 简短。
+- 直接。
+- 有证据。
+- 明确不确定性。
+- 在新信息覆盖旧信息时说清楚。
+
+差回答：
+
+```text
+活动应该是 6 月 30 日。
+```
+
+好回答：
+
+```text
+端午活动目前是 2026/6/30。来源：老妈在 2026-xx-xx 说“改成 2026/6/30”。此前 2026/5/30 是旧信息。
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlashingChen2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,331 @@
+<p align="center">
+  <a href="https://github.com/FlashingChen2024/chattercatcher">
+    <img src="./assets/chattercatcher-hero.svg" alt="ChatterCatcher" />
+  </a>
+</p>
+
+<h1 align="center">ChatterCatcher</h1>
+
+<p align="center">
+  <img src="./assets/chattercatcher-logo.png" alt="ChatterCatcher logo" width="128" />
+</p>
+
+<p align="center">
+  <strong>本地优先、证据驱动、面向飞书/Lark 家庭群的 RAG 记忆机器人。</strong>
+</p>
+
+<p align="center">
+  静默保存家庭群里的重要消息和文件，被 @ 时用可追溯引用回答。
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/chattercatcher"><img alt="npm" src="https://img.shields.io/npm/v/chattercatcher?style=for-the-badge&logo=npm" /></a>
+  <a href="https://github.com/FlashingChen2024/chattercatcher"><img alt="GitHub stars" src="https://img.shields.io/github/stars/FlashingChen2024/chattercatcher?style=for-the-badge&logo=github" /></a>
+  <a href="./LICENSE"><img alt="License" src="https://img.shields.io/github/license/FlashingChen2024/chattercatcher?style=for-the-badge" /></a>
+</p>
+
+<p align="center">
+  <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-6.x-3178c6?style=flat-square&logo=typescript&logoColor=white" />
+  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20+-339933?style=flat-square&logo=node.js&logoColor=white" />
+  <img alt="SQLite" src="https://img.shields.io/badge/SQLite-FTS5-003b57?style=flat-square&logo=sqlite&logoColor=white" />
+  <img alt="LanceDB" src="https://img.shields.io/badge/LanceDB-vector-2f8f83?style=flat-square" />
+  <img alt="Feishu" src="https://img.shields.io/badge/Feishu%20%2F%20Lark-MVP-3370ff?style=flat-square" />
+</p>
+
+---
+
+## 项目状态
+
+ChatterCatcher 是一个早期 MVP。它已经具备飞书长连接接入、本地消息存储、SQLite FTS、LanceDB 向量检索、OpenAI-compatible LLM/Embedding、CLI、本地 Web UI 和带引用回答。
+
+当前核心方向是：
+
+- 让家庭群信息自然沉淀为本地知识库，而不是靠手动整理。
+- 所有事实性回答必须先检索 RAG 证据，不能把大量历史聊天直接塞给 LLM。
+- `@` 机器人的提问不进入知识库，避免污染检索结果。
+- 回答必须能追溯到“谁在什么时候说了什么”。
+- 新信息覆盖旧信息时保留历史证据，并优先使用明确、更新的证据。
+- 默认本地部署，Web UI 默认只监听 `127.0.0.1`。
+
+---
+
+## 项目预览
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="./assets/readme/preview-chat.svg" alt="Feishu message capture preview" />
+      <br />
+      <strong>飞书群消息捕获</strong>
+      <br />
+      普通群消息静默入库，保留发送人、群名、时间、原始平台元数据和文本内容。
+    </td>
+    <td width="50%" valign="top">
+      <img src="./assets/readme/preview-rag.svg" alt="RAG retrieval preview" />
+      <br />
+      <strong>本地 RAG 检索</strong>
+      <br />
+      SQLite FTS 与 LanceDB 向量检索并存，回答前必须先召回证据。
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="./assets/readme/preview-answer.svg" alt="Cited answer preview" />
+      <br />
+      <strong>引用式回答</strong>
+      <br />
+      被 @ 后先即时反馈，再基于证据回复原消息，并输出可读来源。
+    </td>
+    <td width="50%" valign="top">
+      <img src="./assets/readme/preview-web.svg" alt="Local Web UI preview" />
+      <br />
+      <strong>本地 Web UI</strong>
+      <br />
+      查看 Gateway 状态、最近消息、群聊、文件库、解析任务和本地操作入口。
+    </td>
+  </tr>
+</table>
+
+---
+
+## 核心能力
+
+| 模块 | 能力 |
+| --- | --- |
+| 飞书 Gateway | 官方长连接、`im.message.receive_v1` 事件、重复投递保护、附件下载入口 |
+| 消息入库 | 普通文本消息写入 SQLite；`@` 提问直接回答并跳过入库 |
+| RAG 检索 | SQLite FTS 关键词检索、LanceDB 向量检索、混合重排、证据来源保留 |
+| 问答 | OpenAI-compatible chat completions、证据不足时说不知道、回答带引用 |
+| 引用格式 | 展示“谁在什么时候说了什么”，避免暴露 `ou_` / `oc_` 等 opaque id |
+| 文件知识源 | 支持 txt、md、json、csv、tsv、log、docx、pdf 导入和解析 |
+| CLI | setup、settings、doctor、gateway、process、index、files、export、restore |
+| Web UI | 本地状态看板、自动刷新、最近消息、群聊、文件库和解析任务 |
+| 隐私 | 配置与密钥分离；导出不包含 API Key、App Secret 或 token |
+| 数据管理 | 本地导出/恢复、按消息/文件/群删除本地知识库数据 |
+
+---
+
+## 架构概览
+
+```mermaid
+flowchart LR
+  Feishu["飞书/Lark 群"] --> Gateway["本地 Gateway"]
+  Gateway --> Router["消息路由"]
+
+  Router -->|"普通消息"| SQLite["SQLite messages"]
+  SQLite --> FTS["SQLite FTS5"]
+  SQLite --> Indexer["Embedding Indexer"]
+  Indexer --> LanceDB["LanceDB vectors"]
+
+  Router -->|"@ 提问"| QA["Question Handler"]
+  QA --> Hybrid["Hybrid Retriever"]
+  FTS --> Hybrid
+  LanceDB --> Hybrid
+  Hybrid --> LLM["OpenAI-compatible LLM"]
+  LLM --> Reply["带引用回复原消息"]
+  Reply --> Feishu
+
+  CLI["CLI"] --> SQLite
+  Web["Local Web UI"] --> SQLite
+```
+
+---
+
+## 从零开始搭建
+
+### 1. 环境要求
+
+- Node.js 20 或更高
+- npm 10 或更高
+- 一个飞书/Lark 自建应用
+- 一个 OpenAI-compatible LLM API Key
+- 一个 OpenAI-compatible Embedding API Key，或复用 LLM API Key
+
+### 2. 安装
+
+```bash
+npm install -g chattercatcher
+```
+
+检查 CLI：
+
+```bash
+chattercatcher --help
+```
+
+### 3. 创建飞书应用
+
+1. 打开 [飞书应用创建入口](https://open.feishu.cn/page/launcher)，创建一个自建应用。
+2. 在飞书开发者后台开通机器人能力。
+3. 把机器人加入目标家庭群。
+4. 在事件订阅里选择长连接模式。
+5. 订阅 `im.message.receive_v1`。
+6. 记录 App ID 和 App Secret。
+
+### 4. 配置 ChatterCatcher
+
+```bash
+chattercatcher setup
+```
+
+`setup` 会写入：
+
+| 配置项 | 说明 |
+| --- | --- |
+| 飞书 App ID | 普通配置 |
+| 飞书 App Secret | 写入 `secrets.json` |
+| LLM Base URL | OpenAI-compatible chat completions endpoint |
+| LLM API Key | 写入 `secrets.json` |
+| LLM Model | 用于答案生成 |
+| Embedding Base URL | 可复用 LLM Base URL |
+| Embedding API Key | 留空可复用 LLM API Key |
+| Embedding Model | 用于 LanceDB 语义检索 |
+| Web UI Host/Port | 默认 `127.0.0.1:3878` |
+
+### 5. 检查配置
+
+```bash
+chattercatcher doctor --online
+```
+
+### 6. 启动 Gateway 和 Web UI
+
+```bash
+chattercatcher gateway start
+```
+
+默认 Web UI：
+
+```text
+http://127.0.0.1:3878
+```
+
+---
+
+## 使用方式
+
+普通群消息会静默进入知识库：
+
+```text
+编程课的时间改成了后天13:40
+```
+
+提问时在群里 @ 机器人：
+
+```text
+@小陈 最近一次编程课是什么时候
+```
+
+机器人会先即时反馈，再基于本地证据回答。提问本身不会入库。
+
+期望回答类似：
+
+```text
+后天 13:40 [S1]。
+
+引用：
+[S1] 群成员在 2026-04-26 13:36 说：“编程课的时间改成了后天13:40”
+```
+
+---
+
+## 常用命令
+
+| 命令 | 说明 |
+| --- | --- |
+| `chattercatcher setup` | 交互式初始化配置 |
+| `chattercatcher settings show` | 查看脱敏配置 |
+| `chattercatcher doctor --online` | 检查本地配置、存储和在线连通性 |
+| `chattercatcher gateway start` | 启动飞书长连接 Gateway 和本地 Web UI |
+| `chattercatcher gateway status` | 查看 Gateway 状态 |
+| `chattercatcher gateway stop` | 停止 Gateway |
+| `chattercatcher process messages` | 立即处理消息索引任务 |
+| `chattercatcher index rebuild` | 重建 LanceDB 向量索引 |
+| `chattercatcher files add <path...>` | 导入本地文件知识源 |
+| `chattercatcher files jobs` | 查看文件解析任务 |
+| `chattercatcher export --out <file>` | 导出本地知识库数据，不含密钥 |
+| `chattercatcher restore <file>` | 从导出文件恢复 |
+
+---
+
+## 本地数据目录
+
+默认数据目录：
+
+```text
+~/.chattercatcher/
+|-- config.json
+|-- secrets.json
+`-- data/
+    |-- chattercatcher.db
+    |-- files/
+    |-- exports/
+    `-- vector/
+        `-- lancedb/
+```
+
+这些内容不应该提交到 GitHub：
+
+```text
+config/
+data/
+.env
+node_modules/
+dist/
+```
+
+---
+
+## 隐私与安全
+
+- 默认本地部署。
+- 默认 Web UI 只监听 `127.0.0.1`。
+- 聊天记录、文件内容、OCR 结果和语音转写都视为隐私数据。
+- App Secret、API Key 和 token 与普通配置分开保存。
+- 导出文件不包含密钥。
+- 事实性回答必须基于检索证据。
+- 检索不到证据时必须说不知道。
+
+---
+
+## 本地开发
+
+```bash
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+运行开发版 CLI：
+
+```bash
+npm run dev -- --help
+```
+
+---
+
+## 常见问题
+
+### `@` 机器人的问题会进知识库吗？
+
+不会。`@` 提问是查询意图，不是家庭事实。ChatterCatcher 会直接回答并跳过入库，避免污染 RAG。
+
+### 没有 embedding 能用吗？
+
+可以保留 SQLite FTS 关键词检索，但语义检索需要配置 embedding。建议运行 `chattercatcher doctor --online` 确认维度和连通性。
+
+### 为什么要用 RAG？
+
+家庭聊天是长期知识库，不应该靠把全部历史消息塞进上下文。RAG 可以控制证据范围、保留来源、降低幻觉，并让回答可追溯。
+
+### Web UI 可以暴露到公网吗？
+
+默认不建议。ChatterCatcher 面向家庭隐私数据，默认只监听 `127.0.0.1`。
+
+---
+
+## License
+
+This project is licensed under the [MIT License](./LICENSE).

package/assets/chattercatcher-hero.svg

@@ -0,0 +1,58 @@
+<svg width="1536" height="864" viewBox="0 0 1536 864" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+  <title id="title">ChatterCatcher hero illustration</title>
+  <desc id="desc">Local-first family chat knowledge bot with message capture, local storage, RAG retrieval, and cited answers.</desc>
+  <rect width="1536" height="864" fill="#F6F2EA"/>
+  <rect x="88" y="92" width="1360" height="680" rx="40" fill="#FFFDF8" stroke="#D8D1C5" stroke-width="2"/>
+  <circle cx="1280" cy="182" r="130" fill="#D9EEE8"/>
+  <circle cx="1254" cy="196" r="76" fill="#2F8F83" opacity="0.16"/>
+  <path d="M164 632C252 544 356 526 476 578C588 626 694 642 814 588C978 514 1104 534 1240 620C1304 660 1374 666 1448 636V772H164V632Z" fill="#EAE3D5"/>
+
+  <g transform="translate(164 154)">
+    <text x="0" y="0" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="78" font-weight="800">ChatterCatcher</text>
+    <text x="4" y="58" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="30" font-weight="500">Local-first RAG memory for Feishu family groups</text>
+    <text x="4" y="112" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="26">Capture family chat facts, retrieve evidence, answer with citations.</text>
+
+    <g transform="translate(0 170)">
+      <rect width="412" height="324" rx="24" fill="#17212D"/>
+      <rect x="26" y="28" width="172" height="30" rx="15" fill="#2F8F83"/>
+      <rect x="26" y="80" width="312" height="50" rx="18" fill="#263545"/>
+      <rect x="26" y="150" width="260" height="50" rx="18" fill="#263545"/>
+      <rect x="126" y="220" width="260" height="50" rx="18" fill="#2F6FED"/>
+      <text x="48" y="114" fill="#E9F0F2" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="21">编程课改到后天 13:40</text>
+      <text x="148" y="254" fill="#FFFFFF" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="21">@小陈 最近一次编程课?</text>
+      <circle cx="360" cy="54" r="18" fill="#F7C948"/>
+    </g>
+
+    <g transform="translate(468 192)">
+      <path d="M0 118H96" stroke="#2F8F83" stroke-width="8" stroke-linecap="round"/>
+      <path d="M68 88L104 118L68 148" stroke="#2F8F83" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
+    </g>
+
+    <g transform="translate(590 152)">
+      <rect width="268" height="240" rx="24" fill="#ECF7F4" stroke="#9CCFC5" stroke-width="2"/>
+      <rect x="42" y="48" width="184" height="52" rx="16" fill="#2F8F83"/>
+      <rect x="42" y="120" width="184" height="24" rx="12" fill="#B9DED6"/>
+      <rect x="42" y="160" width="140" height="24" rx="12" fill="#B9DED6"/>
+      <text x="54" y="82" fill="#FFFFFF" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="24" font-weight="700">SQLite</text>
+      <text x="54" y="205" fill="#2F5F59" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="24" font-weight="700">LanceDB</text>
+    </g>
+
+    <g transform="translate(908 192)">
+      <path d="M0 118H96" stroke="#2F8F83" stroke-width="8" stroke-linecap="round"/>
+      <path d="M68 88L104 118L68 148" stroke="#2F8F83" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
+    </g>
+
+    <g transform="translate(1030 132)">
+      <rect width="308" height="300" rx="28" fill="#FFFFFF" stroke="#D8D1C5" stroke-width="2"/>
+      <rect x="34" y="34" width="118" height="34" rx="17" fill="#14202B"/>
+      <text x="50" y="58" fill="#FFFFFF" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="18" font-weight="700">Answer</text>
+      <text x="34" y="112" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="25" font-weight="800">后天 13:40</text>
+      <rect x="34" y="146" width="236" height="44" rx="14" fill="#F2EEE5"/>
+      <rect x="34" y="206" width="210" height="44" rx="14" fill="#F2EEE5"/>
+      <text x="52" y="174" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="18">[S1] 群成员 13:36</text>
+      <text x="52" y="234" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui, sans-serif" font-size="18">可追溯引用</text>
+      <circle cx="250" cy="62" r="28" fill="#2F8F83"/>
+      <path d="M238 62L248 72L264 52" stroke="#FFFFFF" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
+    </g>
+  </g>
+</svg>

package/assets/readme/preview-answer.svg

@@ -0,0 +1,12 @@
+<svg width="720" height="420" viewBox="0 0 720 420" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="720" height="420" rx="24" fill="#FFFDF8"/>
+  <rect x="54" y="54" width="612" height="292" rx="28" fill="#FFFFFF" stroke="#D8D1C5" stroke-width="2"/>
+  <rect x="84" y="84" width="142" height="36" rx="18" fill="#14202B"/>
+  <text x="104" y="109" fill="#FFFFFF" font-family="Inter, ui-sans-serif, system-ui" font-size="18" font-weight="700">小陈</text>
+  <text x="84" y="164" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="32" font-weight="800">后天 13:40 [S1]</text>
+  <text x="84" y="218" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="22">引用：</text>
+  <rect x="84" y="240" width="502" height="62" rx="18" fill="#F2EEE5"/>
+  <text x="108" y="278" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="21">[S1] 群成员在 2026-04-26 13:36 说...</text>
+  <circle cx="606" cy="102" r="28" fill="#2F8F83"/>
+  <path d="M594 102L604 112L622 92" stroke="#FFFFFF" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/assets/readme/preview-chat.svg

@@ -0,0 +1,13 @@
+<svg width="720" height="420" viewBox="0 0 720 420" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="720" height="420" rx="24" fill="#17212D"/>
+  <rect x="36" y="34" width="210" height="34" rx="17" fill="#2F8F83"/>
+  <text x="56" y="58" fill="#fff" font-family="Inter, ui-sans-serif, system-ui" font-size="18" font-weight="700">Feishu group</text>
+  <rect x="54" y="104" width="394" height="54" rx="20" fill="#263545"/>
+  <rect x="54" y="184" width="326" height="54" rx="20" fill="#263545"/>
+  <rect x="258" y="264" width="386" height="54" rx="20" fill="#2F6FED"/>
+  <text x="78" y="138" fill="#E9F0F2" font-family="Inter, ui-sans-serif, system-ui" font-size="22">明天要上编程课，时间是13:20</text>
+  <text x="78" y="218" fill="#E9F0F2" font-family="Inter, ui-sans-serif, system-ui" font-size="22">编程课的时间改成了后天13:40</text>
+  <text x="282" y="298" fill="#FFFFFF" font-family="Inter, ui-sans-serif, system-ui" font-size="22">@小陈 最近一次编程课是什么时候</text>
+  <circle cx="606" cy="70" r="22" fill="#F7C948"/>
+  <text x="54" y="370" fill="#9FB2C7" font-family="Inter, ui-sans-serif, system-ui" font-size="20">普通消息入库；@ 提问跳过入库</text>
+</svg>

package/assets/readme/preview-rag.svg

@@ -0,0 +1,18 @@
+<svg width="720" height="420" viewBox="0 0 720 420" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="720" height="420" rx="24" fill="#F6F2EA"/>
+  <rect x="54" y="74" width="180" height="230" rx="24" fill="#FFFFFF" stroke="#D8D1C5" stroke-width="2"/>
+  <rect x="270" y="74" width="180" height="230" rx="24" fill="#ECF7F4" stroke="#9CCFC5" stroke-width="2"/>
+  <rect x="486" y="74" width="180" height="230" rx="24" fill="#FFFFFF" stroke="#D8D1C5" stroke-width="2"/>
+  <text x="94" y="126" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="28" font-weight="800">SQLite</text>
+  <text x="109" y="166" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="20">FTS5</text>
+  <text x="306" y="126" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="28" font-weight="800">LanceDB</text>
+  <text x="314" y="166" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="20">vectors</text>
+  <text x="526" y="126" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="28" font-weight="800">Hybrid</text>
+  <text x="526" y="166" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="20">rerank</text>
+  <path d="M234 190H270" stroke="#2F8F83" stroke-width="8" stroke-linecap="round"/>
+  <path d="M450 190H486" stroke="#2F8F83" stroke-width="8" stroke-linecap="round"/>
+  <rect x="90" y="220" width="108" height="20" rx="10" fill="#EAE3D5"/>
+  <rect x="306" y="220" width="108" height="20" rx="10" fill="#B9DED6"/>
+  <rect x="522" y="220" width="108" height="20" rx="10" fill="#EAE3D5"/>
+  <text x="54" y="360" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="22">关键词检索 + 语义检索，共同召回可引用证据</text>
+</svg>

package/assets/readme/preview-web.svg

@@ -0,0 +1,20 @@
+<svg width="720" height="420" viewBox="0 0 720 420" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="720" height="420" rx="24" fill="#F6F2EA"/>
+  <text x="48" y="64" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="34" font-weight="800">ChatterCatcher</text>
+  <rect x="48" y="96" width="140" height="96" rx="18" fill="#FFFFFF" stroke="#D8D1C5"/>
+  <rect x="208" y="96" width="140" height="96" rx="18" fill="#FFFFFF" stroke="#D8D1C5"/>
+  <rect x="368" y="96" width="140" height="96" rx="18" fill="#FFFFFF" stroke="#D8D1C5"/>
+  <rect x="528" y="96" width="140" height="96" rx="18" fill="#FFFFFF" stroke="#D8D1C5"/>
+  <text x="72" y="134" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="18">Gateway</text>
+  <text x="72" y="170" fill="#2F8F83" font-family="Inter, ui-sans-serif, system-ui" font-size="28" font-weight="800">运行中</text>
+  <text x="232" y="134" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="18">群聊</text>
+  <text x="232" y="170" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="32" font-weight="800">2</text>
+  <text x="392" y="134" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="18">消息</text>
+  <text x="392" y="170" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="32" font-weight="800">128</text>
+  <text x="552" y="134" fill="#56657A" font-family="Inter, ui-sans-serif, system-ui" font-size="18">文件</text>
+  <text x="552" y="170" fill="#14202B" font-family="Inter, ui-sans-serif, system-ui" font-size="32" font-weight="800">8</text>
+  <rect x="48" y="236" width="620" height="108" rx="20" fill="#FFFFFF"/>
+  <rect x="80" y="270" width="180" height="18" rx="9" fill="#EAE3D5"/>
+  <rect x="80" y="306" width="470" height="18" rx="9" fill="#EAE3D5"/>
+  <rect x="574" y="266" width="58" height="34" rx="17" fill="#2F8F83"/>
+</svg>

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node