WeLink 技术文档
本目录是 welink.click 官网文档的源文件（VitePress 构建）。下面按类别列出全部文档，完整导航见官网侧边栏。
上手与安装
| 文件 | 内容 |
|---|---|
| install.md | 安装总览（macOS App / Windows App / Docker 三种方式选择） |
| install-macos.md | macOS App 安装与配置（路径 / 端口 / 升级 / 多 profile / FAQ） |
| install-windows.md | Windows App 安装与配置 |
| docker.md | Docker Compose 部署指南 |
| faq.md | 常见问题 |
| ux.md | 使用技巧与快捷键 |
功能说明
| 文件 | 内容 |
|---|---|
| features.md | 功能总览 |
| labs.md | 创意实验室（21 个 Lab）逐个说明 |
| ai-clone.md | AI 分身学习与对话 |
| ai-analysis.md | AI 分析：LLM/Embedding 配置、全量分析、混合检索（FTS5 + 向量 + 记忆提炼）、Gemini OAuth |
| ai-group-sim.md | AI 群聊模拟 |
| cross-contact-qa.md | 跨联系人 AI 问答 |
| podcast.md | 播客与 TTS |
| skill-forge.md | Skill 炼化格式与实现 |
技术细节
| 文件 | 内容 |
|---|---|
| architecture.md | 整体架构与分层职责 |
| api.md | 后端 REST API 接口文档，端点参数 / 响应格式 / 字段说明 |
| database.md | 数据库结构（contact.db / message_N.db 表结构、消息类型、发送者识别） |
| indexing.md | 索引与初始化流程（SQLite 索引策略、并发模型、时间过滤） |
| message-types.md | 微信消息类型详解 |
| sentiment.md | 情感分析算法（词典 / 评分流程 / 月度聚合） |
| wordcloud.md | 词云生成（分词 / 停用词 / 字号映射 / 渲染参数） |
AI 接入与集成
| 文件 | 内容 |
|---|---|
| ollama-setup.md | Ollama 本地 AI 配置（安装 / 拉模型 / 接入 / Docker 网络） |
| chatgpt-gpt.md | ChatGPT Custom GPT 配置 |
| mcp-server.md | MCP Server（Claude Code 等集成） |
| mcp-clients.md | MCP 客户端接入 |
贡献
| 文件 | 内容 |
|---|---|
| contribute.md | 贡献指南 |
| development.md | 本地开发环境 |
快速参考
常用 API
POST /api/init 触发重新索引（传入时间范围）
GET /api/status 查询索引进度
GET /api/contacts/stats 获取全部联系人统计（缓存）
GET /api/contacts/detail?username=xxx 联系人深度分析
GET /api/contacts/messages?username=xxx&date=2024-03-15 某天聊天记录
GET /api/contacts/wordcloud?username=xxx 词云数据（Top 120）
GET /api/contacts/sentiment?username=xxx 情感分析（按月）
GET /api/contacts/common-groups?username=xxx 与联系人的共同群聊
GET /api/groups 群聊列表消息表名计算
python
import hashlib
table = "Msg_" + hashlib.md5(username.encode()).hexdigest()发送者识别
私聊消息中，每个 message_N.db 的 Name2Id 表独立记录各自的 rowid 映射，同一联系人在不同 DB 中的 rowid 不同，必须在每个 DB 内单独查询：
sql
SELECT rowid FROM Name2Id WHERE user_name = '<username>'
-- real_sender_id == 上述 rowid → 对方发的
-- real_sender_id != 上述 rowid → 我发的技术栈
| 层次 | 技术 |
|---|---|
| 后端 | Go + Gin |
| 前端 | React 18 + TypeScript + Tailwind CSS |
| 数据库 | SQLite（modernc，纯 Go，无 CGO） |
| 全文检索 | SQLite FTS5 |
| 向量检索 | 余弦相似度（纯 Go，无外部依赖） |
| AI / LLM | OpenAI / Ollama / Gemini / 自定义（兼容 OpenAI 接口） |
| 中文分词 | go-ego/gse |
| 部署 | Docker Compose |