docs: 格式化+小问题修复

buf.yaml

@@ -0,0 +1,14 @@
+version: v2
+modules:
+  - path: .  # 表示当前目录（项目根目录）就是一个模块
+lint:
+  use:
+    - STANDARD
+  except:
+    - PACKAGE_DIRECTORY_MATCH
+    # 关闭"枚举值必须加前缀"的检查
+    - ENUM_VALUE_PREFIX
+    # 关闭"枚举值必须全大写下划线"的检查
+    - ENUM_VALUE_UPPER_SNAKE_CASE
+    # 关闭"枚举零值必须加 _UNSPECIFIED 后缀"的检查
+    - ENUM_ZERO_VALUE_SUFFIX

src/.vuepress/theme.ts

@@ -2,6 +2,9 @@ import { hopeTheme } from "vuepress-theme-hope";
 
 import navbar from "./navbar.js";
 import sidebar from "./sidebar.js";
+import { getDirname, path } from "vuepress/utils";
+
+const __dirname = getDirname(import.meta.url);
 
 export default hopeTheme({
   hostname: "https://yh-api.yyyyt.top",
@@ -56,7 +59,14 @@ export default hopeTheme({
     gfm: true,
     imgLazyload: true,
     imgSize: true,
-    include: true,
+    include: {
+      resolvePath: (file) => {
+        if (file.startsWith("@src"))
+          return file.replace("@src", path.resolve(__dirname, ".."));
+
+        return file;
+      },
+    },
     mark: true,
     plantuml: true,
     spoiler: true,

src/api/README.md

@@ -5,17 +5,20 @@ title: API
 
 ::: warning
 
-- 音频路由:
+音频路由:
 - `https://chat-audio1.jwznb.com/`
-- 文件路由:
+
+文件路由:
 - `https://chat-file.jwznb.com/`
 - `https://chat-storage1.jwznb.com/`(有签名校验,无 referer 限制)
 - `https://chat-file-oss.jwznb.com/`(无 referer 限制,一般 chat-file 的大文件会被重定向到这里)
-- 图片路由:
+
+图片路由:
 - `https://chat-img.jwznb.com/`
 - `https://chat-img2.jwznb.com/`
 - `https://chat-img3.jwznb.com/`
-- 视频路由:
+
+视频路由:
 - `https://chat-video1.jwznb.com/`
 
 云湖数据床地址需要请求头加上 `Referer: http://myapp.jwznb.com` 才可正常获取内容，否则会403.