英文 | <a href="docs/pt/README.pt-BR.md">葡萄牙语（巴西）</a>

Image Max URL 是一个程序，它会尝试查找图像和视频的更大/原始版本，通常是通过替换 URL 模式来实现。

目前它支持超过9000个硬编码网站（完整列表见 sites.txt），但它也支持一些通用引擎（如 Wordpress 和 MediaWiki），这意味着它也可以适用于许多其他网站。

目前发布的版本包括：

用户脚本：（适用于大多数浏览器）
- 稳定版：userscript_smaller.user.js 或 OpenUserJS
- 开发版：userscript.user.js（推荐）
- 它是以下所有版本的基础。它还可以作为 node 模块（用于 Reddit 机器人），并可以嵌入网站。
浏览器扩展：Firefox
- 支持 WebExtensions 的其他浏览器可以通过此 Git 仓库侧载扩展。
- 由于插件比用户脚本拥有更多权限，它比用户脚本有一些额外功能。
- 源代码在 manifest.json 和 extension 文件夹中。
网站
- 由于浏览器安全限制，某些 URL（需要跨域请求）可能无法被网站版本支持。
- 源代码在 gh-pages 分支中。
Reddit 机器人（/u/MaxImageBot）
- 源代码在 reddit-bot/comment-bot.js 和 reddit-bot/dourl.js 中。

社区：

Discord 服务器
Matrix（#image-max-url:tedomum.net）
Subreddit

侧载扩展

该扩展目前在其他浏览器的插件商店（如 Chrome 和 Microsoft Edge）中不可用，但如果你希望使用扩展版本而不是用户脚本，可以侧载此仓库。

仓库：
- 以任何方式下载仓库（我建议通过 git 克隆，因为这样可以更轻松地更新）
- Chromium：
  - 转到 chrome://extensions，确保启用了"开发者模式"，点击"加载已解压的扩展程序"，然后导航到 maxurl 仓库
- Firefox：
  - 转到 about:debugging-->此 Firefox，选择"临时载入附加组件..."，然后导航到 maxurl 仓库中的"manifest.json"
  - 请注意，一旦关闭 Firefox，该插件就会被删除。很遗憾，我对此无能为力。
CRX（基于 Chromium 的浏览器）：
- 从 https://github.com/qsniyg/maxurl/blob/master/build/ImageMaxURL_crx3.crx 下载 CRX 构建
- 转到 chrome://extensions，确保启用了"开发者模式"，然后将下载的 CRX 文件拖放到页面上。
XPI（基于 Firefox 的浏览器）：
- 从 https://github.com/qsniyg/maxurl/blob/master/build/ImageMaxURL_signed.xpi 下载 XPI 构建
- 转到 about:addons，点击齿轮图标，然后选择"从文件安装附加组件..."，导航到下载的 XPI 文件。

贡献

非常感谢任何贡献！如果你有任何错误报告、功能请求或想要支持新网站，请在这里提交问题。

如果你没有 Github 账户，可以使用上面的社区链接之一或直接联系我。

如果你希望为仓库本身做出贡献（代码贡献、翻译等），请查看 CONTRIBUTING.md 以获取更多信息。

在你的程序中集成 IMU

如上所述，userscript.user.js 也可以作为 node 模块使用。

var maximage = require('./userscript.user.js');

maximage(smallimage, {
  // 如果设置为 false，当没有特殊属性时，它将只返回 URL
  // 建议保持为 true。
  //
  // 这个选项存在的唯一原因是作为一个小技巧，用于一个帮助用户脚本来查找新规则，
  // 以检查 IMU 是否已经支持某个规则。
  fill_object: true,

  // 应该运行的最大次数。
  // 建议至少为 5。
  iterations: 200,

  // 是否存储到内部 URL 缓存并使用它。
  // 如果你想使用缓存但不向其存储结果，请将其设置为 "read"。
  use_cache: true,

  // URL 缓存中缓存条目的超时时间（以秒为单位）
  urlcache_time: 60*60,

  // 要排除的"问题"列表（如水印或可能损坏的图像）。
  //
  // 默认情况下，所有问题都被排除。
  // 你可以通过 maximage.default_options.exclude_problems 访问被排除的问题
  // 将其设置为 [] 则不会排除任何问题。
  //exclude_problems: [],

  // 是否排除视频
  exclude_videos: false,

  // 这将包含通过迭代找到的对象的"历史记录"。
  // 禁用此选项将只保留通过最后一次成功迭代找到的对象。
  include_pastobjs: true,

  // 这将尝试找到图像的原始页面，即使需要额外的请求。
  force_page: false,

  // 这允许使用第三方网站来查找更大图像的规则
  allow_thirdparty: false,

  // 这对于实现黑名单或白名单很有用。
  // 如果未指定，它接受所有 URL。
  filter: function(url) {
    return true;
  },

  // 执行 HTTP 请求的辅助函数，用于像 Flickr 这样的网站
  // API 预期与 GM_xmlHTTPRequest 的 API 类似。
  // 使用 node 的 request 模块的实现可以在 reddit-bot/dourl.js 中找到
  do_request: function(options) {
    // options = {
    //   url: "",
    //   method: "GET",
    //   data: "", // 用于 method: "POST"
    //   overrideMimeType: "", // 用于解码替代字符集
    //   headers: {}, // 如果某个头部为 null 或 ""，不包含该头部
    //   onload: function(resp) {
    //     // resp 预期是一个类似 XMLHttpRequest 的对象，实现这些字段：
    //     //   finalUrl
    //     //   readyState
    //     //   responseText
    //     //   status
    //   }
    // }
  },

  // 回调
  cb: function(result) {
    if (!result)
      return;
if (result.length === 1 && result[0].url === smallimage) {
    // 未找到更大的图片
    return;
}

for (var i = 0; i < result.length; i++) {
    // 对对象执行某些操作
}

结果是一个对象列表，包含可能在使用返回的图片时有用的属性：

[{
    // 图片的URL
    url: null,

    // 此URL是否为视频
    video: false,

    // 是否预期它总是会正常工作
    // 如果不是必须，请不要依赖此值
    always_ok: false,

    // URL是否可能无法正常工作
    likely_broken: false,

    // 服务器是否支持HEAD请求
    can_head: true,

    // 可以忽略的HEAD错误
    head_ok_errors: [],

    // 服务器在HEAD请求中可能返回错误的Content-Type头部
    head_wrong_contenttype: false,

    // 服务器在HEAD请求中可能返回错误的Content-Length头部
    head_wrong_contentlength: false,

    // 这用于导出函数的返回值
    // 如果你使用回调（如上面的代码示例所示），此值始终为false
    waiting: false,

    // 返回的URL是否预期会重定向到另一个URL
    redirects: false,

    // URL是否为临时的/仅在当前IP上有效（例如生成的下载链接）
    is_private: false,

    // URL是否预期为存储在网站服务器上的原始图片
    is_original: false,

    // 如果为true，你不应再将此URL输入IMU
    norecurse: false,

    // 是否应使用此URL
    // 如果为true，将其视为404
    // 如果为"mask"，此图片是一个叠加的遮罩
    bad: false,

    // 与上面相同，但包含对象列表，例如：
    // [{
    //    headers: {"Content-Length": "1000"},
    //    status: 301
    // }]
    // 如果响应匹配其中一个对象，则为坏图片
    // 你可以使用maximage.check_bad_if(bad_if, resp)进行检查
    // （resp预期为类XHR对象）
    bad_if: [],

    // 此URL是否为内部使用的"假"URL（如果为true，请勿使用）
    fake: false,

    // 查看返回URL所需的头部
    // 如果头部为null，不包括该头部
    headers: {},

    // 可能有用的其他属性
    extra: {
        // 托管此图片的原始页面
        page: null,

        // 附加到图片的标题/说明
        caption: null
    },

    // 如果设置，这是图片的更具描述性的文件名
    filename: "",

    // 此图片的问题列表。使用exclude_problems排除具有特定问题的图片
    problems: {
        // 如果为true，图片可能比输入的大，但也有水印（而输入的没有）
        watermark: false,

        // 如果为true，图片可能比输入的小，但没有水印
        smaller: false,

        // 如果为true，图片可能与输入的完全不同
        possibly_different: false,

        // 如果为true，图片可能损坏（如Tumblr上的GIF）
        possibly_broken: false
    }
}]