常见问题

目录

扩展会保存哪些内容?

MaoXian 的裁剪过程,裁剪的是当前状态下的网页。主要的裁剪内容为文本信息和图片,具体的存储内容会因存储格式的不同而不同,并且有些内容需要在设置页面勾选才会保存。如下:

若存储格式为 HTML

会保存的内容

不会保存的内容

若存储格式为 Markdown

会保存的内容

不会保存的内容和 HTML 一样,外加上不会保存网页样式。

为什么需要那么多权限

在详细解释各权限在 MaoXian 这个扩展中的用途之前,有必要先解释一下: 这些权限的说明文字是站在用户的角度来表述的,当你在浏览器上看到这些说明文字时,其潜台词为:这个扩展拥有了这个权限之后,它最大限度可以做到这个 (而不是,这个扩展拥有了这个权限后,就一定会做这个)

下方是本扩展 manifest.json 文件里面的权限信息,由于这些权限很难用简练的文字表述出来,所以通过引用 manifest.json 文件里面的权限名来进行说明。

{
  "permissions": [
    "<all_urls>",
    "webNavigation",
    "webRequest",
    "webRequestBlocking",
    "storage",
    "unlimitedStorage",
    "tabs",
    "downloads",
    "downloads.open",
    "nativeMessaging"
  ]
}

下面我们详细说明这些权限在 MaoXian 中的用途:

权限:<all_urls>

权限:webNavigation

权限:webRequest 和 webRequestBlocking

权限:storage

权限:unlimitedStorage

权限:tabs

权限:downloads 和 downloads.open

权限:nativeMessaging

点击了裁剪,没有反应

请依次检查以下情况:

  1. 如果你刚安装完扩展,那些在安装前就已经打开的网页得刷新后才能裁剪。
  2. 如果不是第一种情况,也请尝试刷新网页,再试一下(有时候浏览器会抽风,导致某些资源无法正常加载)。
  3. 目前 MaoXian 只兼容 ChromiumFirefox, 其他浏览器不保证能正常工作。有的用户可能会使用基于 Chromium 开发的浏览器(如:vivaldi),该类浏览器很可能可以正常工作,但我们无法作出保证。

卡在了「裁剪中…」

一种情况是网络很不好,MaoXian 卡在某个请求了,可能这个请求根本就没有可能成功。比如万恶的墙对某些请求进行干扰,导致数据一直下载不下来。

你可以到 设置页面 > 高级 页面,调整请求的「超时时长」为 15 秒,设置「重试次数」为 1。再刷新网页,重新进行裁剪,如果你等了一分钟以内,整个流程可以走下去,就说明是网络的问题了。那么没别的较好的办法,你只能去行正义之事了(搭梯子科学上网)。

目前还发现裁剪 wikipedia 网页时候,当网页上有很多个用图片表示的公式时,MaoXian 的裁剪过程很慢,也会呈现出卡住了这种状态。这种就只能等了。

卡在了「保存中…」

情况一: 网络环境不好

MaoXian 在保存图片的时候,如果遇到网络环境太差,一个图片下了好久都没有下载下来,会发生请求超时的情况,MaoXian 会进行重试,而导致整个保存过程变得很长,保存进度长期没有更新,就会感觉到卡住了。

如果你被墙干扰了,那么没别的较好的办法,你只能去行正义之事了(搭梯子科学上网)。如果你的网络环境太差与墙无关,只是速度不太快, 你可以到 设置页面 > 高级 页面,把「请求时长」设置为更大的值,以减少超时重置的情况,然后在裁剪网页的时候,不要着急,起来喝杯茶水。

情况二: 与其他扩展发生冲突了

请尝试暂时停用其他有下载功能的扩展(比如 chrono), 如果你无法确定哪些扩展是有下载功能的,那么可暂时只启用 MaoXian 并停用其他扩展,再次尝试下,以判断是否是冲突的情况。

发现有的朋友在其他浏览器上使用本扩展(比如: vivaldi), 有些浏览器会开发自己的下载管理功能,也会与 MaoXian 产生冲突

我们开发了一个本地程序来解决这个问题。

详情见: Native App

改变默认的下载路径

如果你采用「本地程序」的方式保存信息的话,直接修改配置文件,再重启一下浏览器就可以了。

如果你采用的是 「浏览器下载功能」来保存信息的话,由于安全问题,浏览器扩展无法修改浏览器的下载路径。但是你可以通过创建软链接(符号链接),来达到你的目地。方法如下:

Linux/Mac

假设:

运行命令:

ln -s /home/jack/Dropbox/clips /home/jack/Downloads/mx-wc

Windows

假设:

把下面的命令保存成 mklink.bat 文件,再右击该文件,以管理员方式运行。

命令:

mklink /D C:\Users\jack\Downloads\mx-wc C:\Users\jack\OneDrive\clips

我不想保存元信息文件

元信息文件是 MaoXian 对裁剪下来的文件的一个识别入口,是许多功能的依赖文件(如:裁剪历史,重置历史等..),如非特别需要,还是建议保存此类文件。

警告:当你取消了元信息文件的保存后,表示你期望通过其他软件来查看和管理你裁剪下来的文件。那些依赖元信息文件的功能将无法识别你裁剪下来的文件(如:裁剪历史,重置历史等..)。

修改方式如下:

进入扩展的 设置页面 > 重置与备份 ,确保 ”设置页面的配置信息“ 这一项有勾选后,点击 ”备份设置到文件“ 后得到一个 JSON 文件。使用文本编辑器打开它,使用 saveInfoFile 这个关键字查找,把查找到那一行冒号后面的值修改掉(true 为保存,false 为不保存)。修改完成后,再点击 ”从文件中恢复“ ,选择刚才导出的文件,导入成功后,修改即生效。

无法打开以前裁剪的内容

有的朋友可能发现,我刚裁剪下来的文件可以打开,可过几天就打不开了。

这个是因为扩展在无法访问你本地网址的时候,会尝试通过下载历史打开文件,当浏览器的下载历史被清空(可能是你主动清空的,也可能是浏览器重启后清空的)时,扩展找不到办法打开你的文件了。

可以通过允许扩展访问本地网址, 来避免这个问题。

允许访问本地网址

浏览器默认不允许扩展访问本地网址,这会导致本扩展无法直接打开裁剪下来的文件,不能让用户直接点击裁剪历史里面的链接就能查看。

我们建议你允许本扩展访问本地网址,这样你在裁剪历史页面就能更方便地查看裁剪下来的内容,使用起来会方便许多。

本节介绍了如何让浏览器允许 MaoXian 访问本地网址(file://打头的网址)

1. 获取 “扩展标识”

从 MaoXian 的设置页面,在“本地网址” 一节中找到扩展标识 信息。

不同的浏览器拿到的 扩展标识不同,如下:

2. 更改浏览器设置

这一步,不同的浏览器设置方式不一样。

Chrome/Chromium

以上面的扩展标识为例子,只要在地址栏输入chrome://extensions/?id=612ab18c-c29e-4211-bd50-3f208d227db7, 回车。

找到 允许访问本地文件/网址 这一选项, 启用它就可以了。

Firefox

FireFox 默认没有提供一个页面可以设置这个选项,但可以通过修改浏览器的配置项,来达到目地。

具体方法如下:

I: 在地址栏输入 about:config 并回车, 进入配置项页面 (可能会有一个警告页面,直接点击按钮进入就好了)。

II: 配置以下三项

条目名称 提醒
capability.policy.policynames localfilelinks -
capability.policy.localfilelinks.sites moz-extension://612ab18c-c29e-4211-bd50-3f208d227db7 这个值,你应该使用自己拿到的 扩展标识, 如果你允许多个扩展的话,这里用空格隔开
capability.policy.localfilelinks.checkloaduri.enabled allAccess -

这样操作:

复制条目名称,粘帖到搜索栏进行搜索, 如果搜索到,就双击修改它的值就行了。

如果没有搜索到,就鼠标右键 > 新建 > 字符串(String), 把条目名称依次粘帖进去即可。

3. 更改本扩展中的设置

回到 MaoXian 的设置页面,把“本地网址” 一节中的复选框打上勾。

浏览器弹出提示框提示:脚本无反应,询问是否中止

目前在一些大的网页(网页上可能有成千上万个元素),会偶尔发生此种情况。若遇到此种情况,请选择「继续等待」就行了(可能需要多确认几次)。

能把网页裁剪成单个文件?比如:裁剪成 mhtml、zip 或者 存成图片

MaoXian 无法把网页裁剪成单个文件,也不打算支持该功能。

MaoXian 支持的两种格式 HTML 和 Markdown,都是简单的文本文件。文本文件格式简单,没有特殊的编码,这使其容易修改,且可搜索性强。这是那些特殊编码的单个文件所无法比拟的,比如图片,你要搜索其内容中的文字,几乎不可能。zip 也是如此,查看不方便,搜索也是极难。对于 mhtml 来说,并非所有浏览器都支持这种格式。再者,文本文件的简单性使你可以很容易地对其进行解析,转换。比如导入到其他软件中,或者把其转换成更复杂的格式,比如把你裁剪下来的所有网页转换成电子书(epub,pdf 等)。种种的灵活性,使其非常适合作为一种独立于软件的存储格式。

当然,你很可能还是偏好于单文件格式,那么可以尝试下这些优秀的浏览器扩展,它们是: webscrapbook ,savepageWe, singleFile。

反馈新问题或建议

如果上诉常见问题的解决方案都无法解决你的问题,把你遇到的问题反映到项目issue里,开发人员会进行跟进。

反馈 Bug 注意事项

在描述你遇到的问题时候,请尽可能详细地提供信息。我们期望你能提供以下信息,以便开发者追踪问题。

PS: 如果你没用过 github, 并且不想注册帐号的话,可以发邮件我(i.mika【AT】tutanota.com]。我可以帮你建 issue ,但此种情况下我可能无法及时看到(或回复)你的邮件。


首页