1
1
# Telegram Search 入门指南
2
2
3
- 欢迎使用 Telegram Search !这个工具可以帮助你更智能地搜索和检索 Telegram 聊天记录。本指南将帮助你快速上手并开始使用。
3
+ 欢迎使用 Telegram Search!这个工具可以帮助你更智能地搜索和检索 Telegram 聊天记录。本指南将帮助你快速上手并开始使用。
4
4
5
5
## 功能概述
6
6
7
- Telegram Search提供以下核心功能 :
7
+ Telegram Search 提供以下核心功能 :
8
8
9
9
- ** 语义搜索** :不仅可以搜索关键词,还能理解消息的上下文和含义
10
- - ** 向量匹配** :基于OpenAI的嵌入向量技术 ,实现相似度搜索
11
- - ** 高效检索** :比Telegram原生搜索更精准 、更智能的检索体验
12
- - ** 多平台支持** :提供Web界面和桌面应用程序
10
+ - ** 向量匹配** :基于 OpenAI 的嵌入向量技术 ,实现相似度搜索
11
+ - ** 高效检索** :比 Telegram 原生搜索更精准 、更智能的检索体验
12
+ - ** 多平台支持** :提供 Web 界面和桌面应用程序
13
13
14
14
## 系统要求
15
15
16
16
- ** 操作系统** :Windows、macOS 或 Linux
17
17
- ** Node.js** :20.0 或更高版本
18
- - ** Docker** :用于运行数据库( 可选,也可使用本地数据库)
18
+ - ** Docker** :用于运行数据库( 可选,也可使用本地数据库)
19
19
20
20
## 快速入门流程
21
21
22
- 使用Telegram Search的基本流程如下 :
22
+ 使用 Telegram Search 的基本流程如下 :
23
23
24
- 1 . ** 安装与配置** :安装应用程序并配置必要的API
25
- 2 . ** 连接Telegram账号 ** :登录你的Telegram账号
24
+ 1 . ** 安装与配置** :安装应用程序并配置必要的 API
25
+ 2 . ** 连接 Telegram 账号 ** :登录你的 Telegram 账号
26
26
3 . ** 同步聊天记录** :选择需要搜索的聊天记录进行同步
27
27
4 . ** 开始搜索** :使用语义搜索功能查找消息
28
28
29
29
## 下一步
30
30
31
- - 查看[ 安装指南] ( #安装指南 ) 了解详细的安装步骤
32
- - 参考[ 配置指南] ( #配置指南 ) 了解如何配置API密钥
33
- - 阅读[ 使用指南] ( #使用指南 ) 学习如何使用各项功能
31
+ - 查看 [ 安装指南] ( #安装指南 ) 了解详细的安装步骤
32
+ - 参考 [ 配置指南] ( #配置指南 ) 了解如何配置 API 密钥
33
+ - 阅读 [ 使用指南] ( #使用指南 ) 学习如何使用各项功能
34
34
35
- 如果你在使用过程中遇到任何问题,请查看[ 故障排除] ( #故障排除 ) 章节。
35
+ 如果你在使用过程中遇到任何问题,请查看 [ 故障排除] ( #故障排除 ) 章节。
36
36
37
37
## 安装指南
38
38
39
- 本文档提供了在不同操作系统上安装Telegram Search的详细步骤 。
39
+ 本文档提供了在不同操作系统上安装 Telegram Search 的详细步骤 。
40
40
41
41
### 安装步骤
42
42
@@ -49,7 +49,7 @@ Telegram Search提供以下核心功能:
49
49
50
50
#### Windows
51
51
52
- 访问 [ Node.js官网 ] ( https://nodejs.org/ ) 下载并安装最新的LTS版本
52
+ 访问 [ Node.js 官网 ] ( https://nodejs.org/ ) 下载并安装最新的 LTS 版本
53
53
54
54
#### macOS
55
55
@@ -67,7 +67,7 @@ Telegram Search提供以下核心功能:
67
67
corepack enable
68
68
```
69
69
70
- 3 . 安装Docker
70
+ 3 . 安装 Docker
71
71
[ Docker Desktop] ( https://www.docker.com/products/docker-desktop )
72
72
73
73
</details >
@@ -123,52 +123,52 @@ Telegram Search提供以下核心功能:
123
123
124
124
## 配置指南
125
125
126
- ### Telegram API配置
126
+ ### Telegram API 配置
127
127
128
- 要使用Telegram Search,你需要获取Telegram API凭证 :
128
+ 要使用 Telegram Search,你需要获取 Telegram API 凭证 :
129
129
130
130
1 . 访问 [ https://my.telegram.org/apps ] ( https://my.telegram.org/apps )
131
- 2 . 登录你的Telegram账号
131
+ 2 . 登录你的 Telegram 账号
132
132
3 . 点击"API development tools"
133
133
4 . 填写应用信息(应用标题和简短名称可以自定义)
134
134
5 . 创建应用后,你将获得` api_id ` 和` api_hash `
135
135
136
- 将获取的API ID和哈希填入配置文件 :
136
+ 将获取的 API ID 和哈希填入配置文件 :
137
137
138
138
``` yaml
139
139
api :
140
140
telegram :
141
- apiId : 你的API ID
142
- apiHash : 你的API Hash
141
+ apiId : 你的 API ID
142
+ apiHash : 你的 API Hash
143
143
` ` `
144
144
145
- ### OpenAI API配置
145
+ ### OpenAI API 配置
146
146
147
- 语义搜索功能需要使用OpenAI API:
147
+ 语义搜索功能需要使用 OpenAI API:
148
148
149
- 1. 访问 [OpenAI平台 ](https://platform.openai.com/)
149
+ 1. 访问 [OpenAI 平台 ](https://platform.openai.com/)
150
150
2. 注册或登录账号
151
- 3. 进入API Keys页面: [https://platform.openai.com/account/api-keys](https://platform.openai.com/account/api-keys)
152
- 4. 创建新的API密钥
151
+ 3. 进入 API Keys 页面: [https://platform.openai.com/account/api-keys](https://platform.openai.com/account/api-keys)
152
+ 4. 创建新的 API 密钥
153
153
154
- 将OpenAI API密钥填入配置文件 :
154
+ 将 OpenAI API 密钥填入配置文件 :
155
155
156
156
` ` ` yaml
157
157
api :
158
158
embedding :
159
159
provider : openai
160
160
model : text-embedding-3-small
161
- apiKey : 你的OpenAI API密钥
161
+ apiKey : 你的 OpenAI API 密钥
162
162
dimension : 1536
163
163
` ` `
164
164
165
- ### 使用Ollama作为替代
165
+ ### 使用 Ollama 作为替代
166
166
167
- 如果你不想使用OpenAI API,也可以使用Ollama作为替代 :
167
+ 如果你不想使用 OpenAI API,也可以使用 Ollama 作为替代 :
168
168
169
- 1. 安装Ollama : [https://ollama.ai/download](https://ollama.ai/download)
170
- 2. 启动Ollama服务
171
- 3. 配置Telegram Search使用Ollama :
169
+ 1. 安装 Ollama : [https://ollama.ai/download](https://ollama.ai/download)
170
+ 2. 启动 Ollama 服务
171
+ 3. 配置 Telegram Search 使用 Ollama :
172
172
173
173
` ` ` yaml
174
174
api :
@@ -180,12 +180,12 @@ api:
180
180
181
181
### 数据库配置
182
182
183
- Telegram Search支持PostgreSQL和PGLite作为数据库 :
183
+ Telegram Search 支持 PostgreSQL 和 PGLite 作为数据库 :
184
184
185
185
` ` ` yaml
186
186
database :
187
187
type : postgres
188
- # 使用URL
188
+ # 使用 URL
189
189
url : postgres://username:password@localhost:5432/database_name
190
190
191
191
# 或者使用分离字段配置
@@ -198,7 +198,7 @@ database:
198
198
199
199
### 存储路径配置
200
200
201
- 你可以自定义Telegram Search的存储路径 :
201
+ 你可以自定义 Telegram Search 的存储路径 :
202
202
203
203
` ` ` yaml
204
204
path :
@@ -245,15 +245,15 @@ message:
245
245
path :
246
246
storage : ~/.telegram-search
247
247
248
- # API设置
248
+ # API 设置
249
249
api :
250
250
telegram :
251
- apiId : 你的API ID
252
- apiHash : 你的API哈希
251
+ apiId : 你的 API ID
252
+ apiHash : 你的 API 哈希
253
253
embedding :
254
254
provider : openai
255
255
model : text-embedding-3-small
256
- apiKey : 你的OpenAI API密钥
256
+ apiKey : 你的 OpenAI API 密钥
257
257
dimension : 1536
258
258
` ` `
259
259
289
289
290
290
# ### 数据库连接失败
291
291
292
- - 确保Docker服务正在运行
292
+ - 确保 Docker 服务正在运行
293
293
- 检查数据库配置是否正确
294
294
295
295
# ### 搜索结果太少
331
331
├── drizzle/ # 数据库迁移和管理
332
332
├── packages/ # 共享包和模块
333
333
├── scripts/ # 脚本工具
334
- └── sql/ # SQL相关文件
334
+ └── sql/ # SQL 相关文件
335
335
```
336
336
337
337
### 开发环境设置
@@ -349,12 +349,12 @@ pnpm run dev:frontend
349
349
350
350
### 代码风格
351
351
352
- 项目使用ESLint和Prettier来保持代码风格一致 。在提交代码前,请确保运行:
352
+ 项目使用 ESLint 和 Prettier 来保持代码风格一致 。在提交代码前,请确保运行:
353
353
354
354
``` bash
355
355
pnpm run lint
356
356
```
357
357
358
358
## 结语
359
359
360
- 恭喜!你现在已经了解了如何安装、配置和使用Telegram Search。如果你有任何问题或建议,欢迎在 [ Telegram Search GitHub] ( https://github.com/GramSearch/telegram-search ) 上提交 Issue 或 Pull Request。
360
+ 恭喜!你现在已经了解了如何安装、配置和使用 Telegram Search。如果你有任何问题或建议,欢迎在 [ Telegram Search GitHub] ( https://github.com/GramSearch/telegram-search ) 上提交 Issue 或 Pull Request。
0 commit comments