Skip to content

Commit 440a47a

Browse files
committed
docs: pangu format
1 parent ccbcb5e commit 440a47a

File tree

4 files changed

+49
-49
lines changed

4 files changed

+49
-49
lines changed

README.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,8 @@
1111

1212
- 欢迎 PR 贡献!
1313
- 由于项目处于快速迭代阶段,可能会出现数据库不兼容的情况,建议定期备份数据。
14-
- 获取 API key: [#111](https://github.com/GramSearch/telegram-search/issues/111)
1514

16-
![image](https://github.com/user-attachments/assets/0fa3ba2f-9a3d-4530-9ecd-3336a0f952ad)
15+
![preview](./docs/assets/preview.png)
1716

1817
## 💖 赞助者
1918

@@ -42,7 +41,7 @@ pnpm install
4241
cp config/config.example.yaml config/config.yaml
4342
```
4443

45-
4. 启动数据库容器:
44+
4. 启动数据库容器
4645

4746
```bash
4847
docker compose up -d

README_EN.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ A powerful Telegram chat history search tool that supports vector search and sem
1111

1212
- PR are welcome!
1313
- Due to the project being in a rapid iteration phase, database incompatibility may occur. It's recommended to back up your data regularly.
14-
- Get the API key: [#111](https://github.com/GramSearch/telegram-search/issues/111)
14+
15+
![preview](./docs/assets/preview.png)
1516

1617
## 💖 Sponsors
1718

docs/assets/preview.png

211 KB
Loading

getting-started.md

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,42 @@
11
# Telegram Search 入门指南
22

3-
欢迎使用 Telegram Search !这个工具可以帮助你更智能地搜索和检索 Telegram 聊天记录。本指南将帮助你快速上手并开始使用。
3+
欢迎使用 Telegram Search!这个工具可以帮助你更智能地搜索和检索 Telegram 聊天记录。本指南将帮助你快速上手并开始使用。
44

55
## 功能概述
66

7-
Telegram Search提供以下核心功能
7+
Telegram Search 提供以下核心功能
88

99
- **语义搜索**:不仅可以搜索关键词,还能理解消息的上下文和含义
10-
- **向量匹配**基于OpenAI的嵌入向量技术,实现相似度搜索
11-
- **高效检索**比Telegram原生搜索更精准、更智能的检索体验
12-
- **多平台支持**提供Web界面和桌面应用程序
10+
- **向量匹配**基于 OpenAI 的嵌入向量技术,实现相似度搜索
11+
- **高效检索**比 Telegram 原生搜索更精准、更智能的检索体验
12+
- **多平台支持**提供 Web 界面和桌面应用程序
1313

1414
## 系统要求
1515

1616
- **操作系统**:Windows、macOS 或 Linux
1717
- **Node.js**:20.0 或更高版本
18-
- **Docker**:用于运行数据库(可选,也可使用本地数据库)
18+
- **Docker**:用于运行数据库可选,也可使用本地数据库
1919

2020
## 快速入门流程
2121

22-
使用Telegram Search的基本流程如下
22+
使用 Telegram Search 的基本流程如下
2323

24-
1. **安装与配置**安装应用程序并配置必要的API
25-
2. **连接Telegram账号**登录你的Telegram账号
24+
1. **安装与配置**安装应用程序并配置必要的 API
25+
2. **连接 Telegram 账号**登录你的 Telegram 账号
2626
3. **同步聊天记录**:选择需要搜索的聊天记录进行同步
2727
4. **开始搜索**:使用语义搜索功能查找消息
2828

2929
## 下一步
3030

31-
- 查看[安装指南](#安装指南)了解详细的安装步骤
32-
- 参考[配置指南](#配置指南)了解如何配置API密钥
33-
- 阅读[使用指南](#使用指南)学习如何使用各项功能
31+
- 查看 [安装指南](#安装指南)了解详细的安装步骤
32+
- 参考 [配置指南](#配置指南)了解如何配置 API 密钥
33+
- 阅读 [使用指南](#使用指南)学习如何使用各项功能
3434

35-
如果你在使用过程中遇到任何问题,请查看[故障排除](#故障排除)章节。
35+
如果你在使用过程中遇到任何问题,请查看 [故障排除](#故障排除)章节。
3636

3737
## 安装指南
3838

39-
本文档提供了在不同操作系统上安装Telegram Search的详细步骤
39+
本文档提供了在不同操作系统上安装 Telegram Search 的详细步骤
4040

4141
### 安装步骤
4242

@@ -49,7 +49,7 @@ Telegram Search提供以下核心功能:
4949

5050
#### Windows
5151

52-
访问 [Node.js官网](https://nodejs.org/) 下载并安装最新的LTS版本
52+
访问 [Node.js 官网](https://nodejs.org/) 下载并安装最新的 LTS 版本
5353

5454
#### macOS
5555

@@ -67,7 +67,7 @@ Telegram Search提供以下核心功能:
6767
corepack enable
6868
```
6969

70-
3. 安装Docker
70+
3. 安装 Docker
7171
[Docker Desktop](https://www.docker.com/products/docker-desktop)
7272

7373
</details>
@@ -123,52 +123,52 @@ Telegram Search提供以下核心功能:
123123

124124
## 配置指南
125125

126-
### Telegram API配置
126+
### Telegram API 配置
127127

128-
要使用Telegram Search,你需要获取Telegram API凭证
128+
要使用 Telegram Search,你需要获取 Telegram API 凭证
129129

130130
1. 访问 [https://my.telegram.org/apps](https://my.telegram.org/apps)
131-
2. 登录你的Telegram账号
131+
2. 登录你的 Telegram 账号
132132
3. 点击"API development tools"
133133
4. 填写应用信息(应用标题和简短名称可以自定义)
134134
5. 创建应用后,你将获得`api_id``api_hash`
135135

136-
将获取的API ID和哈希填入配置文件
136+
将获取的 API ID 和哈希填入配置文件
137137

138138
```yaml
139139
api:
140140
telegram:
141-
apiId: 你的API ID
142-
apiHash: 你的API Hash
141+
apiId: 你的 API ID
142+
apiHash: 你的 API Hash
143143
```
144144
145-
### OpenAI API配置
145+
### OpenAI API 配置
146146
147-
语义搜索功能需要使用OpenAI API:
147+
语义搜索功能需要使用 OpenAI API:
148148
149-
1. 访问 [OpenAI平台](https://platform.openai.com/)
149+
1. 访问 [OpenAI 平台](https://platform.openai.com/)
150150
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 密钥
153153
154-
将OpenAI API密钥填入配置文件
154+
将 OpenAI API 密钥填入配置文件
155155
156156
```yaml
157157
api:
158158
embedding:
159159
provider: openai
160160
model: text-embedding-3-small
161-
apiKey: 你的OpenAI API密钥
161+
apiKey: 你的 OpenAI API 密钥
162162
dimension: 1536
163163
```
164164
165-
### 使用Ollama作为替代
165+
### 使用 Ollama 作为替代
166166
167-
如果你不想使用OpenAI API,也可以使用Ollama作为替代
167+
如果你不想使用 OpenAI API,也可以使用 Ollama 作为替代
168168
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
172172
173173
```yaml
174174
api:
@@ -180,12 +180,12 @@ api:
180180
181181
### 数据库配置
182182
183-
Telegram Search支持PostgreSQL和PGLite作为数据库
183+
Telegram Search 支持 PostgreSQL 和 PGLite 作为数据库
184184
185185
```yaml
186186
database:
187187
type: postgres
188-
# 使用URL
188+
# 使用 URL
189189
url: postgres://username:password@localhost:5432/database_name
190190

191191
# 或者使用分离字段配置
@@ -198,7 +198,7 @@ database:
198198
199199
### 存储路径配置
200200
201-
你可以自定义Telegram Search的存储路径
201+
你可以自定义 Telegram Search 的存储路径
202202
203203
```yaml
204204
path:
@@ -245,15 +245,15 @@ message:
245245
path:
246246
storage: ~/.telegram-search
247247

248-
# API设置
248+
# API 设置
249249
api:
250250
telegram:
251-
apiId: 你的API ID
252-
apiHash: 你的API哈希
251+
apiId: 你的 API ID
252+
apiHash: 你的 API 哈希
253253
embedding:
254254
provider: openai
255255
model: text-embedding-3-small
256-
apiKey: 你的OpenAI API密钥
256+
apiKey: 你的 OpenAI API 密钥
257257
dimension: 1536
258258
```
259259
@@ -289,7 +289,7 @@ api:
289289

290290
#### 数据库连接失败
291291

292-
- 确保Docker服务正在运行
292+
- 确保 Docker 服务正在运行
293293
- 检查数据库配置是否正确
294294

295295
#### 搜索结果太少
@@ -331,7 +331,7 @@ api:
331331
├── drizzle/ # 数据库迁移和管理
332332
├── packages/ # 共享包和模块
333333
├── scripts/ # 脚本工具
334-
└── sql/ # SQL相关文件
334+
└── sql/ # SQL 相关文件
335335
```
336336
337337
### 开发环境设置
@@ -349,12 +349,12 @@ pnpm run dev:frontend
349349

350350
### 代码风格
351351

352-
项目使用ESLint和Prettier来保持代码风格一致。在提交代码前,请确保运行:
352+
项目使用 ESLint 和 Prettier 来保持代码风格一致。在提交代码前,请确保运行:
353353

354354
```bash
355355
pnpm run lint
356356
```
357357

358358
## 结语
359359

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

Comments
 (0)