简介

『毛线助手』允许你做如下事情：

• 在裁剪之前对网页的状态进行一些修改，以实现一个更好的裁剪结果
• 重写一些配置信息，是一次性配置，即网页级别的配置
• 预先填写表单，可对某些网页的标题、分类和标签进行预填写
• 选中某一区域，这样就不需要每次都进行点选
• 选中某一区域，并进行确认，直接到填写表单那一步
• 选中某一区域，并立即自动进行裁剪，即当你点击裁剪之后，整个裁剪动作自动开始

为什么需要修改网页的状态？

由于 MaoXian Web Clipper 裁剪网页的时候，裁剪的是当前状态下的网页，并且不会保存任何脚本文件（即 javascript）。 这意味着在一些情况下，我们需要对网页进行一些操作后，才能获得一个较好的裁剪结果。

比如：

• 一篇文章里的图片显示的都是缩略图，而你想保存的是原图
• 或者是你不想保存选区内的按钮、评论等无关内容
• 又或者是网页上的某些区域是可折叠的，需要在裁剪前把它们都展开。

如何利用预填表单？

• 设置正确的标题，在内容标题和整个网页的标题不一致时使用。
• 设置分类，比如新闻网页，都预先保存在 新闻 分类下。
• 设置标签，预先为这些网页打上可预知的标签。

一旦网页的表单都预先填写了，那么就可利用『选中区域』动作，实现一键裁剪。

如何利用网页级别的配置？

网页级别的配置，一般用于一些例外的情况。如：

• 你默认的保存格式为 Markdown，但是某些网页更适合保存成 HTML。你就可以利用网页级别配置，把这些网页的存储格式设置成 HTML。
• 你默认是不保存音频的，而对于一个显示铃声的网页，你想把这些小音频保存下来，你就可以利用网页级别配置完成。
• 等等。。

三种不同的 Plan

全局 Plan

「全局 Plan」 是由你自己编写的。它会应用到所有的网页上，如果某个操作具备普遍性，则可以加入到「全局 Plan」里。

自定义 Plan

「自定义 Plan」也是由你自己编写的，它会应用到某一类网页上。此种为最常见的，一般都会对某个网站的某类网页进行裁剪。比如对某个博客的文章进行裁剪，因为同类网页的结构一般都相同，需要对其的操作也相同，所以可以通过编写此种 Plan 对其进行统一处理。

公开的 Plan

为了减少用户重复编写「自定义 Plan」的工作。MaoXian 支持你将自己编写的 「自定义 Plan」分享出来，成为 「公开的 Plan」。这样所有用户都会受益。 此种 Plan，可以通过下方的订阅地址获取到。

订阅「公开的 Plan」

将下方的订阅地址复制到：MaoXian 扩展 > 设置页面 > 助手 页面的订阅框中。

订阅地址

# 默认网站列表（全球性）
https://mika-cn.github.io/maoxian-web-clipper/assistant/plans/default/index.json

# 华人网站列表
https://mika-cn.github.io/maoxian-web-clipper/assistant/plans/zh/index.json

参与进来

『毛线助手』的工作方式有点像「广告屏蔽扩展」，需要针对不同的网站，编写不同的 Plan。这也意味着它解决问题的多少，取决于我们适配的网站的多少。这需要的不仅仅是开发者，更是每一个使用者的无私分享精神，于此，我们欢迎各位用户参与进来，只有这般，该助手才能发挥其真正的能力。

如果你不会编程，你可以在项目 issue 页面 提交适配请求(提供需要适配的网址)，或者回馈某个网站适配不正确的信息，以便其他人进行跟进。

如果你会编程（只需要懂一点 CSS，了解 JSON 格式就行），那么恭喜你，你完全有能力编写 Plan，并分享给其他人，具体查看下一节。

如何编写 Plan

请查看这里

项目地址

传送门

• 该项目用于收集和分享各个用户编写的 “Plan”。
• 你也可自部署该项目生成的共有 Plan，来减少外部依赖。

贡献 Plan

所有的 Plan 都存储在 plans 的子目录下，不同的子目录代表不同频道，每个频道最终都将生成一个订阅地址。请将你写的 Plan 以数组的形式单独存为一个文件，如： plans/zh/zhihu.json。每个网站建一个文件。

最终所有的 Plan 会在 build.rb 这个脚本的渲染下，变成可订阅的形式。

你可以通过下方几种方式把 plan 分享出来：

• 通过 Github 建 Pull Request 的形式。
• 通过 Github 建 issue。（把 plan 贴上即可）
• 通过发邮件给开发者（i.mika[AT]tutanota.com），直接发送内容或者发送 patch。

最后

如果你对「毛线助手」有什么看法或建议，请告诉我们。