add latest config file format to quickstart-robot guide

After the v1.0.0-beta2 update of go-cqhttp, the config file format has been converted from `hjson` to `yaml`. Update the guide. See https://github.com/Mrs4s/go-cqhttp/releases/tag/v1.0.0-beta2
2026-03-18 05:04:51 +08:00 · 2021-06-15 17:46:00 +08:00 · 2021-06-15 17:46:00 +08:00 · f91c8b6205
commit f91c8b6205
parent 8f73a99ff7
1 changed files with 97 additions and 1 deletions
--- a/docs/guide/quickstart-robot.md
+++ b/docs/guide/quickstart-robot.md
@ -30,7 +30,103 @@ OneBot 机器人部分的选择详情见 [OneBot 实例](/guide/OneBot实例/)

    由于 go-cqhttp 项目还处于开发期，而且配置文件格式也发生了多次变化，但大体内容没有变（比如编写此文档时发布的版本中配置文件格式变成了 `hjson` 取代了原来的 `json`。

-=== "config.hjson（新格式）"
+=== "config.yml（最新格式）"
+
+    ```yaml
+    account: # 账号相关
+      uin: 1233456 # QQ账号
+      password: '' # 密码为空时使用扫码登录
+      encrypt: false  # 是否开启密码加密
+      status: 0      # 在线状态 请参考 https://github.com/Mrs4s/go-cqhttp/blob/dev/docs/config.md#在线状态
+      relogin: # 重连设置
+        delay: 3   # 首次重连延迟, 单位秒
+        interval: 3   # 重连间隔
+        max-times: 0  # 最大重连次数, 0为无限制
+
+      # 是否使用服务器下发的新地址进行重连
+      # 注意, 此设置可能导致在海外服务器上连接情况更差
+      use-sso-address: true
+
+    heartbeat:
+    # 心跳频率, 单位秒
+    # -1 为关闭心跳
+    interval: 5
+
+    message:
+      # 上报数据类型
+      # 可选: string,array
+      post-format: string
+      # 是否忽略无效的CQ码, 如果为假将原样发送
+      ignore-invalid-cqcode: false
+      # 是否强制分片发送消息
+      # 分片发送将会带来更快的速度
+      # 但是兼容性会有些问题
+      force-fragment: false
+      # 是否将url分片发送
+      fix-url: false
+      # 下载图片等请求网络代理
+      proxy-rewrite: ''
+      # 是否上报自身消息
+      report-self-message: false
+      # 移除服务端的Reply附带的At
+      remove-reply-at: false
+      # 为Reply附加更多信息
+      extra-reply-data: false
+
+    output:
+      # 日志等级 trace,debug,info,warn,error
+      log-level: warn
+      # 是否启用 DEBUG
+      debug: false # 开启调试模式
+
+    # 默认中间件锚点
+    default-middlewares: &default
+      # 访问密钥, 强烈推荐在公网的服务器设置
+      access-token: ''
+      # 事件过滤器文件目录
+      filter: ''
+      # API限速设置
+      # 该设置为全局生效
+      # 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
+      # 目前该限速设置为令牌桶算法, 请参考:
+      # https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
+      rate-limit:
+        enabled: false # 是否启用限速
+        frequency: 1  # 令牌回复频率, 单位秒
+        bucket: 1     # 令牌桶大小
+
+    database: # 数据库相关设置
+      leveldb:
+        # 是否启用内置leveldb数据库
+        # 启用将会增加10-20MB的内存占用和一定的磁盘空间
+        # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
+        enable: true
+
+    # 连接服务列表
+    servers:
+      # 添加方式，同一连接方式可添加多个，具体配置说明请查看文档
+      #- http: # http 通信
+      #- ws:   # 正向 Websocket
+      #- ws-reverse: # 反向 Websocket
+      #- pprof: #性能分析服务器
+      # Zhamao Framework 所需要的服务器配置
+      - ws-reverse:
+        # 是否禁用当前反向WS服务
+        disabled: false
+        # 反向WS Universal 地址
+        # 注意 设置了此项地址后下面两项将会被忽略
+        universal: ws://127.0.0.1:20001/
+        # 反向WS API 地址
+        api: ws://your_websocket_api.server
+        # 反向WS Event 地址
+        event: ws://your_websocket_event.server
+        # 重连间隔 单位毫秒
+        reconnect-interval: 3000
+        middlewares:
+          <<: *default # 引用默认中间件
+    ```
+
+=== "config.hjson（v1.0.0-beta2或更早版本所用格式）"

    ``` json hl_lines="3 5 81 84"
    {