From 40adb31a2a70ff340d01270adca854ddfe38830a Mon Sep 17 00:00:00 2001
From: butaixianran <butaixianran@qq.com>
Date: Wed, 15 Mar 2023 23:19:59 +0800
Subject: [PATCH] add common issue section to doc

---
 README.cn.md | 26 ++++++++++++++++++++++++++
 README.md    | 28 ++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)

diff --git a/README.cn.md b/README.cn.md
index ceca412..0129515 100644
--- a/README.cn.md
+++ b/README.cn.md
@@ -166,9 +166,35 @@ civitai不是每个图片都有关键词，一个模型中，也不是所有预
 
 从v1.5开始。v1.x进入维护阶段。  
 
+
 Enjoy!
 
 
+## 常见问题
+### 4个卡片按钮不显示
+这个问题的唯一原因，是你没有使用最新版SD webui。  
+
+如果你修改过SD webui的文件， 你的更新操作可能会失败。你需要检查git命令行的输出信息，来确定你更新成功了。   
+
+git在很多时候，会拒绝升级，并告诉你有些冲突需要你手动先解决。如果你不看命令行输出，你就会以为你已经更新成功了，但其实并没有。   
+
+### 扫描或获取模型信息失败
+这个插件现在很稳定，所以，这个问题的原因，基本是是因为Civitai拒绝了你的连接请求。  
+
+Civitai不像那些大网站那么稳定。他网站会挂，还会把API请求转到真人验证页面，来拒绝请求。(这个规则暂时关闭了，但他们随时能打开)    
+
+对于国内用户，还有代理问题。  
+
+所以，这种时候你只能等一下再试。  
+
+### 使用colab时扫描失败
+首先，在google中搜索你看到的错误信息。更有可能是，你碰到的是个colab的问题。  
+
+如果你确定，你碰到的是扫描模型的时候，出现了内存不足的错误，并且，你已经在用这个扩展的最新版本，那我们也无能为力了。   
+
+自从v1.5.5，我们已经把扫描模型时的SHA256方法优化到顶了。所以，你只剩下2个选择:  
+* 再次尝试  
+* 或者购买colab的pro帐号  
 
 
 
diff --git a/README.md b/README.md
index 9adfb2a..9dcd8f7 100644
--- a/README.md
+++ b/README.md
@@ -172,6 +172,34 @@ From v1.5, v1.x goes into maintenance phase.
 
 Enjoy!
 
+## Common Issue
+### 4 Button on card didn't show
+The only reason for this issue, is you are not using the latest SD webui. So, Make sure you updated it.  
+
+Your update could be failed if you have modified SD webui's file. You need to check git command's console log to make sure it is updated. 
+
+In many cases, git will just refuse to update and tell you there are some conflicts need you to handle manually. If you don't check the consloe log, you will think your SD webui is updated, but it is not.  
+
+### Scan or Get model info failed
+This extension now is stable. So, the reason for this most likely is your request has been refused by Civitai.  
+
+Civitai is not that stable as those rich websites, it can be down, or re-direct API request to a real human checking page.(This rule is disabled for now, but can be enabled at anytime they want)  
+
+So, the only thing you can do is just wait a while then try again.  
+
+### Scanning fail when using colab
+First of, search your error message with google. Most likely, it will be a colab issue.    
+
+If you are sure it is a out of memory issue when scanning models, and you are using this extension's latest version, then there is nothing we can do.   
+
+Since v1.5.5, we've already optimized the SHA256 function to the top. So the only 2 choices for you are:  
+* try again  
+* or use a pro account of colab.  
+
+
+
+
+
 # Change Log
 ## v1.5.5
 * update SHA256 function, now it just use the code from pip