diff --git a/docs/content/en/more/troubleshooting.md b/docs/content/en/more/troubleshooting.md index b46235316c..8736f32d89 100644 --- a/docs/content/en/more/troubleshooting.md +++ b/docs/content/en/more/troubleshooting.md @@ -28,13 +28,13 @@ If that doesn't work, run again with `--debug` flag. Then file a new issue and p **A:** If your desktop client can't receive messages, load chats, or send messages, you may encounter session conflicts. -You can try re-login with desktop client and **select YES for logout**, which will delete the session files to separate +You can try re-login with `tdl login` and **select YES for logout**, which will delete the session files to separate sessions. #### Q: How to migrate session to another device? **A:** You can use the `tdl backup` and `tdl recover` commands to export and import sessions. -See [Migration](#migration) for more details. +See [Migration](/guide/migration) for more details. #### Q: Is this a form of abuse? diff --git a/docs/content/zh/more/_index.md b/docs/content/zh/more/_index.md new file mode 100644 index 0000000000..bf5d009995 --- /dev/null +++ b/docs/content/zh/more/_index.md @@ -0,0 +1,5 @@ +--- +title: "更多" +bookFlatSection: true +weight: 30 +--- diff --git a/docs/content/zh/more/cli/_index.md b/docs/content/zh/more/cli/_index.md index be3d47af3f..7c09fc95dc 100644 --- a/docs/content/zh/more/cli/_index.md +++ b/docs/content/zh/more/cli/_index.md @@ -1,5 +1,5 @@ --- title: "命令行" weight: 10 -bookHref: "/zh/more/cli/tdl" +bookHref: "/more/cli/tdl" --- diff --git a/docs/content/zh/more/data.md b/docs/content/zh/more/data.md new file mode 100644 index 0000000000..35ddae3be0 --- /dev/null +++ b/docs/content/zh/more/data.md @@ -0,0 +1,10 @@ +--- +title: "数据" +weight: 30 +--- + +# 数据 + +您的帐户信息将存储在 `~/.tdl` 目录中。 + +日志文件将存储在 `~/.tdl/log` 目录中。 diff --git a/docs/content/zh/more/env.md b/docs/content/zh/more/env.md new file mode 100644 index 0000000000..4a0cb30789 --- /dev/null +++ b/docs/content/zh/more/env.md @@ -0,0 +1,25 @@ +--- +title: "环境变量" +weight: 20 +--- + +# 环境变量 + +{{< hint info >}} +所有环境变量的值优先级低于命令行选项。 +{{< /hint >}} + +通过设置环境变量,避免在每次重复输入相同的命令行选项。 + +| 环境变量 | 对应选项 | +|:-----------------------:|:---------------------:| +| `TDL_NS` | `-n/--ns` | +| `TDL_PROXY` | `--proxy` | +| `TDL_DEBUG` | `--debug` | +| `TDL_SIZE` | `-s/--size` | +| `TDL_THREADS` | `-t/--threads` | +| `TDL_LIMIT` | `-l/--limit` | +| `TDL_POOL` | `--pool` | +| `TDL_NTP` | `--ntp` | +| `TDL_RECONNECT_TIMEOUT` | `--reconnect-timeout` | +| `TDL_TEMPLATE` | dl `--template` | diff --git a/docs/content/zh/more/troubleshooting.md b/docs/content/zh/more/troubleshooting.md new file mode 100644 index 0000000000..733388e360 --- /dev/null +++ b/docs/content/zh/more/troubleshooting.md @@ -0,0 +1,42 @@ +--- +title: "疑难解答" +weight: 40 +--- + +# 疑难解答 + +## 最佳实践 + +如何减小封号的风险? + +- 使用官方客户端会话登录。 +- 尽可能使用默认的下载和上传选项。不要设置过大的 `threads` 和 `size`。 +- 不要同时在多台设备上使用相同的帐户登录。 +- 不要同时下载或上传太多文件。 +- 成为 Telegram 大会员。😅 + +## 常见问题 + +#### Q: 输入命令后为什么没有响应?日志中为什么出现 `msg_id too high`? + +**A:** 检查是否需要使用代理(使用 `--proxy` 选项);检查您系统的本地时间是否正确(使用 `--ntp` 选项或校准系统时间) + +如果仍然无法解决问题,请使用 `--debug` 标志重新运行。然后创建一个新的 ISSUE 并将日志粘贴到问题中。 + +#### Q: 使用 tdl 后,桌面客户端停止工作怎么办? + +**A:** 如果您的桌面客户端无法接收消息、加载聊天或发送消息,可能遇到了会话冲突。 + +您可以尝试使用 `tdl login` 重新登录,并**选择 YES 以退出桌面客户端登录**,这将删除客户端会话文件以分离会话。 + +#### Q: 如何将会话迁移到另一台设备? + +**A:** 您可以使用 `tdl backup` 和 `tdl recover` 命令导出和导入会话。详细信息请参见 [迁移](/zh/guide/migration)。 + +#### Q: 这算滥用吗? + +**A:** 不是。下载和上传速度受服务器端限制。由于官方客户端的速度通常不会达到帐户限制,因此开发了此工具,以尽可能高的速度下载文件。 + +#### Q: 这会导致封禁吗? + +**A:** 我不确定。所有操作都不涉及向其他人主动发送消息等高风险行为。