Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

添加基础使用说明 #108

Closed
Silvigarabis opened this issue Oct 20, 2023 · 4 comments
Closed

添加基础使用说明 #108

Silvigarabis opened this issue Oct 20, 2023 · 4 comments

Comments

@Silvigarabis
Copy link

看了文档之后,我还是没明白这个东西应该怎么用,只知道了可以直接下载一个程序然后运行,在研究一会后发现运行之后好像会开一个40666的端口

有计划在这里(指文档)添加基本的使用说明吗?类似这样的语句:

  • 程序在启动后会启动一个Web服务,可以直接访问它
  • 程序在桌面环境启动后会用浏览器打开管理面板
@shigma
Copy link
Member

shigma commented Oct 20, 2023

可以加。

不过你看到的这个端口号应该是错误的。Koishi 模板项目的默认端口号为 5140。

@shigma
Copy link
Member

shigma commented Nov 2, 2023

我看了目前的文档,模板项目已经明确说明了会弹出窗口。其他启动器也是运行会直接弹出窗口。你使用的可能不是 Koishi。

@shigma shigma added the invalid This doesn't seem right label Nov 2, 2023
@Silvigarabis
Copy link
Author

我看了目前的文档,模板项目已经明确说明了会弹出窗口。其他启动器也是运行会直接弹出窗口。你使用的可能不是 Koishi。

我是从“起步”界面通过选择“用于搭建机器人服务”,并选择环境为“Linux”后跳转到“为Linux安装”页面,最后选择“下载AppImage”得到了一个可以直接执行的二进制文件,除此之外没有看到任何其他说明。

通过查阅其他页面(包括“为 Windows 安装”、在 Docker 中使用),我的确找到了一些有关的说明,但是这貌似有些散乱?

所以,有必要添加一个介绍了运行 Koishi 后应该如何使用的文段,而不是分散在不同的页面里。以下是一个示例(但不是一个很好的示例):

在不管你使用什么方式运行了 Koishi 服务后(安装到 Windows 后点击启动图标、下载了为 Linux 设计的 AppImage 后直接执行或是直接通过 Docker 容器运行),你都可以尝试进入http://localhost:5140/ 来访问控制台,在自动安装的情况下(指 Windows 安装),这应该会在安装后自动打开。

类似的段落也许应该添加到“起步”当中?

另外,我在“安装和配置插件”看到:Koishi 的一个核心特性是强大的控制台。控制台是一个对用户友好的图形界面。最初看到这段话的时候我以为这是一个需要桌面环境的 GUI 程序,但实际上它指的是网页控制台,这也是让我最开始的时候摸不着头脑的原因。

不过现在,在明白了我实际上应该通过访问http://localhost:5140/来使用 Koishi 后,我便开始享受 Koishi 带来的一切。(虽然我也不知道当初我是怎么认为40666端口是Koishi开放的端口)

@shigma
Copy link
Member

shigma commented Nov 2, 2023

原来是这样,我现在明白了。

@shigma shigma removed the invalid This doesn't seem right label Nov 7, 2023
@shigma shigma closed this as completed in 05b27f3 Nov 21, 2023
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

No branches or pull requests

2 participants