From d438f829e5645e3d6759930fbaabb979ea306e36 Mon Sep 17 00:00:00 2001 From: PiEgg Date: Sun, 4 Sep 2022 15:31:16 +0800 Subject: [PATCH] :pencil: Docs: update readme & FAQ --- FAQ.md | 29 +++++++++++++++++++++++++++-- README.md | 32 +++++++++----------------------- 2 files changed, 36 insertions(+), 25 deletions(-) diff --git a/FAQ.md b/FAQ.md index b606ceae..3ffd9670 100644 --- a/FAQ.md +++ b/FAQ.md @@ -57,16 +57,41 @@ PicGo 在 Mac 上是一个顶部栏应用，在 dock 栏是不会有图标的。 1. 先自行搜索 error 里的报错信息，往往你能百度或者谷歌出问题原因，不必开 issue。 2. 如果有带有 `401` 、`403` 等 `40X` 状态码字样的，不用怀疑，就是你配置写错了，仔细检查配置，看看是否多了空格之类的。 3. 如果带有 `HttpError`、`RequestError` 、 `socket hang up` 等字样的说明这是网络问题，我无法帮你解决网络问题，请检查你自己的网络，是否有代理，DNS 设置是否正常等。 +3. 通常网络问题引起的上传失败都是因为代理设置不当导致的。如果开启了系统代理，建议同时也在 PicGo 的代理设置中设置对应的HTTP代理。参考 [#912](https://github.com/Molunerfinn/PicGo/issues/912) ## 10. macOS版本安装完之后没有主界面 请找到PicGo在顶部栏的图标，然后右键（触摸板双指点按，或者鼠标右键），即可找到「打开详细窗口」的菜单。 -## 11. 相册突然无法显示图片或者上传后相册不更新 +## 11. 相册突然无法显示图片 或者 上传后相册不更新 或者 使用Typora+PicGo上传图片成功但是没有写回Typora 这个原因可能是相册存储文件损坏导致的。可以找到 PicGo 配置文件所在路径下的 `picgo.db` ，将其删掉（删掉前建议备份一遍），再重启 PicGo 试试。 -注意同时看看日志文件里有没有什么error，必要时可以提issue。 +注意同时看看日志文件里有没有什么error，必要时可以提issue。2.3.0以上的版本已经解决因为 `picgo.db` 损坏导致的上述问题，建议更新版本。 ## 12. Gitee相关问题 如果在使用 Gitee 图床的时候遇到上传的问题，由于 PicGo 并没有官方提供 Gitee 上传服务，无法帮你解决，请去你所使用的 Gitee 插件仓库发相关的issue。 + +## 13. macOS系统安装完PicGo显示「文件已损坏」或者安装完打开没有反应 + +因为 PicGo 没有签名，所以会被 macOS 的安全检查所拦下。 + +1. 安装后打开遇到「文件已损坏」的情况，请按如下方式操作： + +信任开发者，会要求输入密码: + +``` +sudo spctl --master-disable +``` + +然后放行 PicGo : + +``` +xattr -cr /Applications/PicGo.app +``` + +然后就能正常打开。 + +2. 如果安装打开后没有反应，请按下方顺序排查： + 1. macOS安装好之后，PicGo 是不会弹出主窗口的，因为 PicGo 在 macOS 系统里设计是个顶部栏应用。注意看你顶部栏的图标，如果有 PicGo 的图标，说明安装成功了，点击图标即可打开顶部栏窗口。参考上述[第八点](#8-mac-上无法打开-picgo-的主窗口界面)。 + 2. 如果你是 M1 的系统，此前装过 PicGo 的 x64 版本，但是后来更新了 arm64 的版本发现打开后没反应，请重启电脑即可。 diff --git a/README.md b/README.md index 7c0eea36..52c9b2da 100644 --- a/README.md +++ b/README.md @@ -54,29 +54,15 @@ PicGo 本体支持如下图床： ## 下载安装 -点击此处下载 [应用](https://github.com/Molunerfinn/PicGo/releases)。从 2.3.1-beta.4 版本开始，在下载页提供 [腾讯云COS](https://cloud.tencent.com/product/cos) 下载链接，供国内用户快速下载使用。感谢 [腾讯云COS](https://cloud.tencent.com/product/cos) 提供的赞助支持！ - -还可以通过山东大学镜像站提供的镜像地址下载 [应用](https://mirrors.sdu.edu.cn/github-release/Molunerfinn_PicGo)。感谢山东大学镜像站提供的镜像服务！ - -### Windows - -Windows 用户请下载最新版本的 `exe` 文件。 - -**还可以使用 [Scoop](https://scoop.sh/) 来安装 PicGo: `scoop bucket add helbing https://github.com/helbing/scoop-bucket` & `scoop install picgo`。 感谢 @helbing 的贡献！** - -**还可以使用 [Chocolatey](https://chocolatey.org/) 来安装 PicGo: `choco install picgo`。 感谢 @iYato 的贡献！** - -### macOS - -macOS 用户请下载最新版本的 `dmg` 文件。 - -**还可以使用 [Homebrew](https://brew.sh/) 来安装 PicGo: `brew install picgo --cask`。感谢 @womeimingzi11 的贡献！** - -### Linux - -Linux 用户请下载 `AppImage` 文件。 - -**如果你是 Arch 类的 Linux 用户，可以直接通过 `yay -S picgo-appimage` 来安装 PicGo （若是没有则先安装 yay ，是 aur 仓库助手）。感谢 @houbaron 的贡献！** +| 下载源 | 地址/安装方式 | 平台 | 备注 | +|---|---|---|---| +| GitHub Release | https://github.com/Molunerfinn/PicGo/releases | All | 国内下载速度可能会慢 | +| [腾讯云COS](https://cloud.tencent.com/product/cos) | https://github.com/Molunerfinn/PicGo/releases 附在更新日志结尾 | All | 感谢 [腾讯云COS](https://cloud.tencent.com/product/cos) 提供的赞助支持 | +| [山东大学镜像站](https://mirrors.sdu.edu.cn/) | https://mirrors.sdu.edu.cn/github-release/Molunerfinn_PicGo | All | 感谢 [山东大学镜像站](https://mirrors.sdu.edu.cn/) 提供的镜像支持 | +| [Scoop](https://scoop.sh/) | `scoop bucket add helbing https://github.com/helbing/scoop-bucket` & `scoop install picgo` | Windows | 感谢 @helbing 的贡献 | +| [Chocolatey](https://chocolatey.org/) | `choco install picgo` | Windows | 感谢 @iYato 的贡献 | +| [Homebrew](https://brew.sh/) | `brew install picgo --cask` | macOS | 感谢 @womeimingzi11 的贡献 | +| [AUR](https://aur.archlinux.org/packages/yay) | `yay -S picgo-appimage` | Arch-Linux | 感谢 @houbaron 的贡献 | ## 应用截图