Skip to content

Conversation

@nuomicici
Copy link

@nuomicici nuomicici commented Dec 26, 2025

Summary by Sourcery

扩展中文常见问题解答(FAQ),增加针对安装失败和 NapCat 连接问题的额外指导。

文档更新:

  • 在中文 FAQ 中添加 Windows 和 Linux 安装故障排查提示。
  • 记录常见的 NapCat-Astrbot 连接场景,以及相应的 WebUI WebSocket 配置修复方法,包括 Docker 和非 Docker 部署。
Original summary in English

Summary by Sourcery

Expand the Chinese FAQ with additional guidance for installation failures and NapCat connection issues.

Documentation:

  • Add Windows and Linux installation troubleshooting tips to the Chinese FAQ.
  • Document common NapCat-Astrbot connection scenarios and corresponding WebUI WebSocket configuration fixes, including Docker and non-Docker setups.

Copy link
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - 我发现了 1 个问题,并留下了一些整体反馈:

  • 在 Docker 网络配置示例代码中,建议说明 astrbotnapcat 是示例容器名称,需要和用户实际的容器名称保持一致,以避免混淆。
  • 在 NapCat 小节中的 shell 命令代码块,可以为围栏代码块标注语言(例如 ```bash),以提升在文档渲染时的可读性和语法高亮效果。
提供给 AI Agent 的提示词
Please address the comments from this code review:

## Overall Comments
- 在 Docker 网络配置示例代码中,建议说明 `astrbot``napcat` 是示例容器名称,需要和用户实际的容器名称保持一致,以避免混淆。
- 在 NapCat 小节中的 shell 命令代码块,可以为围栏代码块标注语言(例如 ```bash),以提升在文档渲染时的可读性和语法高亮效果。

## Individual Comments

### Comment 1
<location> `zh/faq.md:21` </location>
<code_context>
+运行无报错则回到NapCat的Webui,网络配置中,将你之前填写的`ws://127.0.0.1:6199/ws`修改为`ws://astrbot:6199/ws`
+
+2. 如果只有NapCat是docker部署,请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://宿主机IP:6199/ws`(宿主机IP请自行搜索如何查看)
+3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
 ## 管理面板相关

</code_context>

<issue_to_address>
**issue (typo):** 这里的端口号“6099”看起来像是“6199”的笔误。

前文示例 WebSocket 地址端口都是 6199,但此处第一个 URL 写成了 `ws://127.0.0.1:6099/ws`,同一行后面两个仍是 6199。建议核对后将端口号统一,避免用户配置错误。

```suggestion
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://localhost:6199/ws`或`ws://127.0.0.1:6199/ws`
```
</issue_to_address>

Sourcery 对开源项目免费——如果你觉得我们的代码审查有帮助,欢迎分享 ✨
帮我变得更有用!请对每条评论点选 👍 或 👎,我会根据你的反馈改进以后的代码审查。
Original comment in English

Hey - I've found 1 issue, and left some high level feedback:

  • In the Docker networking snippet, consider clarifying that astrbot and napcat are example container names and should match the user’s actual container names to avoid confusion.
  • For the shell commands under the NapCat section, you could annotate the fenced code block with a language (e.g., ```bash) to improve readability and syntax highlighting in rendered docs.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- In the Docker networking snippet, consider clarifying that `astrbot` and `napcat` are example container names and should match the user’s actual container names to avoid confusion.
- For the shell commands under the NapCat section, you could annotate the fenced code block with a language (e.g., ```bash) to improve readability and syntax highlighting in rendered docs.

## Individual Comments

### Comment 1
<location> `zh/faq.md:21` </location>
<code_context>
+运行无报错则回到NapCat的Webui,网络配置中,将你之前填写的`ws://127.0.0.1:6199/ws`修改为`ws://astrbot:6199/ws`
+
+2. 如果只有NapCat是docker部署,请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://宿主机IP:6199/ws`(宿主机IP请自行搜索如何查看)
+3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
 ## 管理面板相关

</code_context>

<issue_to_address>
**issue (typo):** 这里的端口号“6099”看起来像是“6199”的笔误。

前文示例 WebSocket 地址端口都是 6199,但此处第一个 URL 写成了 `ws://127.0.0.1:6099/ws`,同一行后面两个仍是 6199。建议核对后将端口号统一,避免用户配置错误。

```suggestion
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://localhost:6199/ws`或`ws://127.0.0.1:6199/ws`
```
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

运行无报错则回到NapCat的Webui,网络配置中,将你之前填写的`ws://127.0.0.1:6199/ws`修改为`ws://astrbot:6199/ws`

2. 如果只有NapCat是docker部署,请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://宿主机IP:6199/ws`(宿主机IP请自行搜索如何查看)
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (typo,笔误): 这里的端口号“6099”看起来像是“6199”的笔误。

前文示例 WebSocket 地址端口都是 6199,但此处第一个 URL 写成了 ws://127.0.0.1:6099/ws,同一行后面两个仍是 6199。建议核对后将端口号统一,避免用户配置错误。

Suggested change
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
Original comment in English

issue (typo): 这里的端口号“6099”看起来像是“6199”的笔误。

前文示例 WebSocket 地址端口都是 6199,但此处第一个 URL 写成了 ws://127.0.0.1:6099/ws,同一行后面两个仍是 6199。建议核对后将端口号统一,避免用户配置错误。

Suggested change
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6099/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`
3. 如果都不是docker部署,则请将NapCat的Webui网络配置中的`ws://127.0.0.1:6199/ws`修改为`ws://localhost:6199/ws``ws://127.0.0.1:6199/ws`

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant