docs: refine documentation, correct refs

Author: Wesley-Young

saltify-docs/.vitepress/config.mts

@@ -12,14 +12,11 @@ export default defineConfig({
     ],
 
     sidebar: [
-      {
-        text: '快速上手',
-        items: [ { text: 'API 概览', link: '/quick-tour' } ]
-      },
+      { text: '快速上手', link: '/quick-tour' },
       {
         text: '开发指南',
         items: [
-          { text: '核心配置与异常处理', link: '/guide/application' },
+          { text: '核心配置', link: '/guide/application' },
           { text: '插件开发', link: '/guide/plugin' },
           { text: '指令系统', link: '/guide/command' }
         ]

saltify-docs/content/guide/application.md

@@ -1,6 +1,6 @@
-# 核心配置与异常处理
+# 核心配置
 
-## 应用实例化与基础配置
+## 初始化 `SaltifyApplication`
 
 可以通过以下方式快速配置一个 Saltify 实例。这里仅展示了核心配置。
 
@@ -36,17 +36,11 @@ suspend fun main() {
 
 另外，应用和插件都有生命周期管理。在程序退出时，务必调用 `close()` 方法释放资源，这会触发所有已加载插件的 `onStop` 钩子并关闭 HTTP 客户端。
 
-## 全局异常处理与事件服务状态
+## 全局异常处理
 
-Saltify 提供了用于监控连接状态和异常的 Flow，一般必须收集以实现自定义逻辑，否则**全部异常都会被无视**。
+Saltify 提供了用于监控未显式捕获的异常的 Flow，一般必须收集以实现自定义逻辑，否则**全部异常都会被无视**。
 
 ```kotlin
-launch {
-    client.eventConnectionStateFlow.collect { state ->
-        println("连接状态变更: $state")
-    }
-}
-
 launch {
     client.exceptionFlow.collect { (context, exception) ->
         val component = context.saltifyComponent!!
@@ -61,3 +55,15 @@ launch {
     }
 }
 ```
+
+## 事件服务状态监听
+
+Saltify 还提供了一个 Flow 用于监控事件服务连接状态的变更：
+
+```kotlin
+launch {
+    client.eventConnectionStateFlow.collect { state ->
+        println("连接状态变更: $state")
+    }
+}
+```

saltify-docs/content/quick-tour.md

@@ -22,7 +22,7 @@ dependencies {
 > [!warning]
 > 本项目仍处于开发阶段，**强烈建议自行构建项目并依赖你的本地构建**，目前本文档将基于最新提交而不是最新发行版。待项目稳定会区分稳定文档与开发文档。
 
-## 配置应用
+## 初始化 `SaltifyApplication`
 
 ```kotlin
 val client = SaltifyApplication {
@@ -39,7 +39,7 @@ val client = SaltifyApplication {
 }
 ```
 
-更多内容请参见 [应用配置](guide/application.md)。请在浏览完本页后**一定仔细阅读**这一页。
+更多内容请参见[核心配置](guide/application.md)。请在浏览完本页后**一定仔细阅读**这一页。
 
 ## 调用 API
 
@@ -54,7 +54,7 @@ client.sendGroupMessage(123456789L) {
 }
 ```
 
-更多 API 请参见项目源码与 IDE 补全。
+更多 API 请参见项目源码与 [Milky 文档](https://milky.ntqqrev.org/)。
 
 ## 定义插件
 
@@ -84,7 +84,7 @@ val client = SaltifyApplication {
 }
 ```
 
-更多内容请参见 [插件开发](guide/plugin.md)。
+更多内容请参见[插件开发](guide/plugin.md)。
 
 ## 定义指令
 
@@ -100,4 +100,4 @@ client.command("say") {
 }
 ```
 
-更多内容请参见 [指令开发](guide/command.md)。
+更多内容请参见[指令系统](guide/command.md)。