From b01ea99d1a295ae992fd9a2f4104226fd12ffe4a Mon Sep 17 00:00:00 2001
From: wdvxdr <wdvxdr1123@gmail.com>
Date: Thu, 16 Sep 2021 16:41:11 +0800
Subject: [PATCH] docs: MINE scan

---
 coolq/bot.go   | 23 +++++++++++++++++++----
 docs/config.md |  9 ++++++++-
 docs/file.md   | 28 ++++++++++++++++++++++++++++
 3 files changed, 55 insertions(+), 5 deletions(-)

diff --git a/coolq/bot.go b/coolq/bot.go
index a311da7..5c7f926 100644
--- a/coolq/bot.go
+++ b/coolq/bot.go
@@ -79,12 +79,27 @@ var ForceFragmented = false
 // SkipMimeScan 是否跳过Mime扫描
 var SkipMimeScan bool
 
-var lawfulImageTypes = [...]string{"image/png", "image/jpeg", "image/gif", "image/bmp", "image/webp"}
+// keep sync with /docs/file.md#MINE
+var lawfulImageTypes = [...]string{
+	"image/bmp",
+	"image/gif",
+	"image/jpeg",
+	"image/png",
+	"image/webp",
+}
 
 var lawfulAudioTypes = [...]string{
-	"audio/mpeg", "audio/flac", "audio/midi", "audio/ogg",
-	"audio/ape", "audio/amr", "audio/wav", "audio/aiff",
-	"audio/mp4", "audio/aac", "audio/x-m4a",
+	"audio/aac",
+	"audio/aiff",
+	"audio/amr",
+	"audio/ape",
+	"audio/flac",
+	"audio/midi",
+	"audio/mp4",
+	"audio/mpeg",
+	"audio/ogg",
+	"audio/wav",
+	"audio/x-m4a",
 }
 
 // NewQQBot 初始化一个QQBot实例
diff --git a/docs/config.md b/docs/config.md
index ab396c8..4aa5052 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -32,7 +32,6 @@ heartbeat:
   # -1 为关闭心跳
   interval: 5
 
-message:
   # 上报数据类型
   # 可选: string,array
   post-format: string
@@ -48,6 +47,12 @@ message:
   proxy-rewrite: ''
   # 是否上报自身消息
   report-self-message: false
+  # 移除服务端的Reply附带的At
+  remove-reply-at: false
+  # 为Reply附加更多信息
+  extra-reply-data: false
+  # 跳过 Mime 扫描, 忽略错误数据
+  skip-mime-scan: false
 
 output:
   # 日志等级 trace,debug,info,warn,error
@@ -149,6 +154,8 @@ database: # 数据库相关设置
 
 > 注4：关闭心跳服务可能引起断线，请谨慎关闭
 
+> 注5：关于MINE扫描， 详见[MINE](file.md#MINE)
+
 ## 在线状态
 
 | 状态 | 值 |
diff --git a/docs/file.md b/docs/file.md
index 61a5d7e..b8a0fe6 100644
--- a/docs/file.md
+++ b/docs/file.md
@@ -38,3 +38,31 @@ go-cqhttp 默认生成的文件树如下所示:
 | 0x10            | uint32   | 图片源文件大小       |
 | 0x14            | string   | 图片原名(QQ内部ID) |
 | 0x14 + 原名长度 | string   | 图片下载链接         |
+
+# MINE
+
+启用MINE检查可以及时发现媒体资源格式错误引起的上传失败(通常表现为，请求网页图片，但服务端返回404.html)
+
+在配置文件中设置 `skip-mine-scan: false`后 ，go-cqhttp 会在上传媒体资源(视频暂不支持)前对MINE进行检查，
+详细允许类型如下所示:
+
+图片：
+> image/bmp 
+> image/gif
+> image/jpeg
+> image/png
+> image/webp
+
+语音:
+> audio/aac  
+> audio/aiff  
+> audio/amr  
+> audio/ape  
+> audio/flac  
+> audio/midi  
+> audio/mp4  
+> audio/mpeg
+> audio/ogg
+> audio/wav
+> audio/x-m4a  
+