├── README.md ├── backup ├── bt │ ├── index.md │ ├── uTools_1669562107315.png │ ├── uTools_1669599679942.png │ └── uTools_1669600745568.png ├── ipfs │ ├── image-20221126203107908.png │ ├── image-20221126203250225.png │ ├── image-20221126203419990.png │ ├── image-20221126203519545.png │ ├── image-20221126203729620.png │ ├── image-20221126203918783.png │ ├── image-20221126204451814.png │ ├── image-20221126204532396.png │ ├── image-20221126204734950.png │ ├── image-20221126204809639.png │ ├── image-20221126204902371.png │ ├── image-20221126204946278.png │ ├── image-20221126205558333.png │ ├── image-20221126210229156.png │ ├── image-20221126210443598.png │ ├── image-20221126210635284.png │ ├── image-20221126211047730.png │ ├── image-20221126211338511.png │ ├── index.md │ └── uTools_1669600642149.png ├── mc │ ├── image-20221126203107908.png │ ├── image-20221126203250225.png │ ├── image-20221126203419990.png │ ├── image-20221126203519545.png │ ├── image-20221126203729620.png │ ├── image-20221126203918783.png │ ├── image-20221126204451814.png │ ├── image-20221126204532396.png │ ├── image-20221126204734950.png │ ├── image-20221126204809639.png │ ├── image-20221126204902371.png │ ├── image-20221126204946278.png │ ├── image-20221126205558333.png │ ├── image-20221126210229156.png │ ├── image-20221126210443598.png │ ├── image-20221126210635284.png │ ├── image-20221126211047730.png │ ├── image-20221126211338511.png │ ├── index.md │ ├── uTools_1669600820130.png │ ├── uTools_1669602102303.png │ ├── uTools_1669602274462.png │ └── uTools_1669602477706.png ├── notice │ └── index.md ├── s ├── v4 │ └── index.md └── v5 │ ├── index.md │ ├── uTools_1669602653400.png │ ├── uTools_1669602778564.png │ ├── uTools_1669603388597.png │ └── uTools_1669603787587.png ├── docs ├── api │ └── index.md ├── index.md ├── search-dev │ └── index.md └── search │ ├── index.md │ ├── uTools_1671797022286.png │ ├── uTools_1671798071245.png │ ├── uTools_1671798699908.png │ ├── uTools_1671798794315.png │ └── uTools_1671798814508.png ├── mkdocs.yml ├── netlify.toml ├── overrides └── base.html ├── package.json ├── requirements.txt └── runtime.txt /README.md: -------------------------------------------------------------------------------- 1 | # docs 2 | zhelper 帮助文档 3 | -------------------------------------------------------------------------------- /backup/bt/index.md: -------------------------------------------------------------------------------- 1 | 2 | ## 从 zhelper V5 中获取信息 3 | 4 | 如图所示,请在搜索结果界面,复制保存文件名、“本书ID”,下载种子文件备用。 5 | 6 |  7 | 8 | 9 | ## BT 简明教程 10 | 11 | 12 | 以 qbittorrent 为例介绍 BT 下载方法。 13 | 14 | 首先在[官网](https://www.qbittorrent.org/)下载 BT 软件。安装。 15 | 16 | 将下载好的种子文件直接拖入 qbittorrent 软件界面,将会弹出以下窗口: 17 | 18 |  19 | 20 |  21 | 22 | 下载过程可能需要比较长一段时间。在下载完成之后,需要手动更改文件名。然后直接打开即可。 23 | 24 | 25 | -------------------------------------------------------------------------------- /backup/bt/uTools_1669562107315.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/bt/uTools_1669562107315.png -------------------------------------------------------------------------------- /backup/bt/uTools_1669599679942.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/bt/uTools_1669599679942.png -------------------------------------------------------------------------------- /backup/bt/uTools_1669600745568.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/bt/uTools_1669600745568.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203107908.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203107908.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203250225.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203250225.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203419990.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203419990.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203519545.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203519545.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203729620.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203729620.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126203918783.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126203918783.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204451814.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204451814.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204532396.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204532396.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204734950.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204734950.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204809639.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204809639.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204902371.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204902371.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126204946278.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126204946278.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126205558333.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126205558333.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126210229156.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126210229156.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126210443598.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126210443598.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126210635284.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126210635284.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126211047730.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126211047730.png -------------------------------------------------------------------------------- /backup/ipfs/image-20221126211338511.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/image-20221126211338511.png -------------------------------------------------------------------------------- /backup/ipfs/index.md: -------------------------------------------------------------------------------- 1 | 2 | !!! tip "说明" 3 | 4 | 本文将介绍关于 IPFS 下载方式的进阶内容。**如果您只是想简单体验 IPFS 下载,请直接在 V5 中选择“使用公共网关”** 5 | 6 | 7 | ## 从 zhelper V5 中获取信息 8 | 9 | 如图所示,请在搜索结果界面,复制保存文件名和 IPFS CID 备用。 10 | 11 |  12 | 13 | ## 手动选择公共网关 14 | 15 | 去这里[Public Gateway Checker | IPFS](https://ipfs.github.io/public-gateway-checker/) 找到可用网关,可用网关即如下标出的域名地址 16 | 17 |  18 | 19 | 随便找一个地址,我这里找的是`https://4everland.io/` 20 | 21 | 然后在该地址后面追加`ipfs/bafykbzacebrvcxi5m5lay5euu6m2tvrybgvkdzukw2lyqkah2r3nmu3wwtvvy` 22 | 23 | 这里的`bafykbzacebrvcxi5m5lay5euu6m2tvrybgvkdzukw2lyqkah2r3nmu3wwtvvy`就是之前复制的图书IPFS CID码 24 | 25 | 拼接后的地址如下所示 26 | 27 | ``` 28 | https://4everland.io/ipfs/bafykbzacebrvcxi5m5lay5euu6m2tvrybgvkdzukw2lyqkah2r3nmu3wwtvvy 29 | ``` 30 | 31 | 将地址复制到浏览器地址栏中访问,即可下载图书,此时的图书文件是个IDVCQ1SQ文件 32 | 33 |  34 | 35 | 下载完成后将下载的IDVCQ1SQ文件改名为如下图所示即可打开(文件名可以参考 V5 界面给出的文件名) 36 | 37 |  38 | 39 | 40 | 44 | 45 | -------------------------------------------------------------------------------- /backup/ipfs/uTools_1669600642149.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/ipfs/uTools_1669600642149.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203107908.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203107908.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203250225.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203250225.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203419990.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203419990.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203519545.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203519545.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203729620.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203729620.png -------------------------------------------------------------------------------- /backup/mc/image-20221126203918783.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126203918783.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204451814.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204451814.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204532396.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204532396.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204734950.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204734950.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204809639.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204809639.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204902371.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204902371.png -------------------------------------------------------------------------------- /backup/mc/image-20221126204946278.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126204946278.png -------------------------------------------------------------------------------- /backup/mc/image-20221126205558333.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126205558333.png -------------------------------------------------------------------------------- /backup/mc/image-20221126210229156.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126210229156.png -------------------------------------------------------------------------------- /backup/mc/image-20221126210443598.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126210443598.png -------------------------------------------------------------------------------- /backup/mc/image-20221126210635284.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126210635284.png -------------------------------------------------------------------------------- /backup/mc/image-20221126211047730.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126211047730.png -------------------------------------------------------------------------------- /backup/mc/image-20221126211338511.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/image-20221126211338511.png -------------------------------------------------------------------------------- /backup/mc/index.md: -------------------------------------------------------------------------------- 1 | !!! tip "说明" 2 | 3 | 本文将介绍关于秒传下载的使用教程。秒传工具分为网页版和插件版。后者成功率较高,但是目前**大部分电脑浏览器和小部分安卓浏览器**支持秒传插件,**苹果浏览器不支持**。下面将对二者进行介绍。 4 | 5 | ## 从 zhelper V5 中获取信息 6 | 7 | 如图所示,请在搜索结果界面,复制保存秒传码备用。 8 | 9 |  10 | 11 | 12 | ## 使用网页下载 13 | 14 | **首先登录百度网盘**:https://pan.baidu.com/ 15 | 16 | 17 | 秒传网站链接:https://mengzonefire.github.io/baidupan-rapidupload/ 18 | 19 | 打开之后,粘贴链接,上面两个都可以留空。 20 | 21 |  22 | 23 | 点击之后会弹出一个页面,里面有一串代码,我们只要看到有`"errno":0`这个符号就说明秒传成功了。如果`"errno"`后面不是0,请按照秒传网站上的教程来排查错误。 24 | 25 |  26 | 27 | 文件一般是直接存在度盘首页。 28 | 29 |  30 | 31 | 如果转存失败,请尝试使用其他秒传码。 32 | 33 | 1. 几种弹窗提示代码 "errno" (错误码) 及解决方法: 34 | ``` 35 | {"errno":0} - 转存成功,文件已存到网盘根目录,请刷新网盘查看(点击查看成功示例) 36 | {"errno":2} - 转存失败,请重新打开或刷新度盘页面后重试(若未登陆请登陆) 37 | {"errno":-6} - 转存失败,请重新打开或刷新度盘页面后重试(若未登陆请登陆) 38 | {"errno":-7} - 转存路径含有非法字符 " : * ? < > | 39 | {"errno":-8} - 网盘里已存在同名文件/文件夹,请打开网盘查找 40 | {"errno":-10} - 网盘容量已满 41 | ``` 42 | 2. 如需要下载,目标文件应存在于百度网盘,若百度网盘官方服务器内无此文件,将转存失败。 43 | 3. **也有可能是网页版不好用,请使用插件下载** 44 | 45 | ## 使用插件下载 46 | 47 | 这里以Windows端的火狐浏览器为例,Edge、Kiwi 版参考 [ssdown](https://ssdown.org/blog/miaochuan/); 48 | 49 | 打开[秒传链接提取脚本文档](https://mengzonefire.code.misakanet.cn/rapid-upload-userscript-doc/document/Install/Windows.html#%E5%AE%89%E8%A3%85%E6%B5%8F%E8%A7%88%E5%99%A8),我已经提前安装好了火狐浏览器,如何安装火狐浏览器请百度这里不在叙述,这里点击左边侧边栏的Windows端,然后点击右边的火狐商店。 50 | 51 |  52 | 53 | 点击添加到Firefox 54 | 55 |  56 | 57 | 这时会询问是否添加,选择添加 58 | 59 |  60 | 61 | 回到刚才的页面,选择安装秒传链接提取 62 | 63 |  64 | 65 | 点击安装 66 | 67 |  68 | 69 | 这时脚本已经安装好了。 70 | 71 | 使用浏览器打开百度网盘页面,点击秒传 72 | 73 |  74 | 75 | 将我们复制的秒传码粘贴进去,点击确定(下面使用的是另外一个秒传码 🤣,不影响): 76 | 77 |  78 | 79 | 提示转存成功,点击确定 80 | 81 |  82 | 83 | 此时书已经在网盘里了 84 | 85 |  86 | 87 | 如果转存失败,请尝试使用其他秒传码。 88 | 89 | -------------------------------------------------------------------------------- /backup/mc/uTools_1669600820130.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/uTools_1669600820130.png -------------------------------------------------------------------------------- /backup/mc/uTools_1669602102303.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/uTools_1669602102303.png -------------------------------------------------------------------------------- /backup/mc/uTools_1669602274462.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/uTools_1669602274462.png -------------------------------------------------------------------------------- /backup/mc/uTools_1669602477706.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/mc/uTools_1669602477706.png -------------------------------------------------------------------------------- /backup/notice/index.md: -------------------------------------------------------------------------------- 1 | # 关于 zhelper 业务调整的说明 2 | 3 | 基于安全、用户体验、维护成本等多方面的考虑,**我们决定停止对旧版网站 zhelper V4、V5 的维护,请您迁移到新版 zhelper search。** 4 | 5 | [您可以在这里读到更多 zhelper search 相关信息](/search) 6 | 7 | ## zhelper search 与 zhelper V4、V5 的区别 8 | 9 | - zhelper search 是**一个“没有任何功能的网站”**:如果您直接打开 zhelper search,会发现什么都做不了。不能搜索、更不能下载。 10 | - zhelper search 是**一个“全能的网站”**:zhelper search 兼容多个搜索接口,包括之前的 V4、V5 搜索接口,也包括更多其他(符合API规范的)搜索接口。 11 | - zhelper search **必须要配置才能使用**:您**必须**告诉 zhelper search 用哪个搜索接口,zhelper search 才能工作。 12 | - zhelper search 是一个**很简单的网站**:它所做的唯一的事情就是——把您的搜索的关键词发给搜索接口,然后把搜索接口返回的结果整理成人类可以阅读的形式展现出来。 13 | 14 | [关于 zhelper search 的具体使用请参考本文](/search) 15 | 16 | ## 之后 zhelper V4、V5 还会维护吗? 17 | 18 | zhelper V4、V5 搜索界面将不在维护,我们也没有时间精力进一步维护了。但是 zhelper V4、V5 后端(API 接口)相关代码已经开源,欢迎各位开发、部署。 19 | 20 | 按我们的计划,在您看到本页面的时候,zhelper V4、V5 搜索页面应该已经打不开了,zhelper V4 API 接口应该也不能使用了(下载已经找到 zlib.download 部署,搜索找了 mibooks.tk 部署),zhelper V5 接口应该还能用(还没有找到下家。。。),之后这些项目都将转为由网友自行部署。实属无奈之举,请谅解。 -------------------------------------------------------------------------------- /backup/s: -------------------------------------------------------------------------------- 1 | 2 | ## zhelper search 与 zhelper V4、V5 的区别 3 | 4 | - zhelper search 是**一个“没有任何功能的网站”**:如果您直接打开 zhelper search,会发现什么都做不了。不能搜索、更不能下载。 5 | - zhelper search 是**一个“全能的网站”**:zhelper search 兼容多个搜索接口,包括之前的 V4、V5 搜索接口,也包括更多其他(符合API规范的)搜索接口。 6 | - zhelper search **必须要配置才能使用**:您**必须**告诉 zhelper search 用哪个搜索接口,zhelper search 才能工作。 7 | - zhelper search 是一个**很简单的网站**:它所做的唯一的事情就是——把您的搜索的关键词发给搜索接口,然后把搜索接口返回的结果整理成人类可以阅读的形式展现出来。 8 | 9 | ## 之后 zhelper V4、V5 还会维护吗? 10 | 11 | zhelper V4、V5 搜索界面将不在维护,我们也没有时间精力进一步维护了。但是 zhelper V4、V5 后端(API 接口)相关代码已经开源,欢迎各位开发、部署。 12 | 13 | 按我们的计划,在您看到本页面的时候,zhelper V4、V5 搜索页面应该已经打不开了,zhelper V4 API 接口应该也不能使用了(下载已经找到 zlib.download 部署,搜索找了 mibooks.tk 部署),zhelper V5 接口应该还能用(还没有找到下家。。。),之后这些项目都将转为由网友自行部署。实属无奈之举,请谅解。 14 | 15 | 16 | 17 | 18 | 32 | 33 | ## 手动配置接口(进阶) 34 | 35 | 已移除,自行研究 36 | 37 | 50 | -------------------------------------------------------------------------------- /backup/v4/index.md: -------------------------------------------------------------------------------- 1 | 4 | 5 | It's still under construction 6 | -------------------------------------------------------------------------------- /backup/v5/index.md: -------------------------------------------------------------------------------- 1 | [zhelper V5 网页直达](https://node1.v5.zhelper.net/) 2 | 3 | ## 搜索 4 | 5 | 输入关键词,点击搜索。关键词支持:ISBN(不一定能搜到)、作者、出版社、书名。 6 | 7 |  8 | 9 | 10 | 搜索结果展示界面,每一页展示 20 条结果,拉到最下面可以往后翻页。每个搜素结果都可以直接点击。 11 | 12 |  13 | 14 | ## 下载 15 | 16 | !!! tip "说明" 17 | 18 | zhelper 不存储任何书籍,zhelper 只是一个搜索工具,数据来自于互联网公开信息,zhelper仅仅只是提供索引。以下教程将帮助您从**去中心化文件分享网络**中获取资源 19 | 20 | 21 | 下载详情界面有两种不同版本 22 | 23 | ### 第一种版本 24 | 25 | 第一种版本有三种下载方式。 26 | 27 | - 使用秒传下载,[详细教程](/mc) 28 | - 使用BT下载,[详细教程](/bt) 29 | - 使用IPFS下载,[详细教程](/ipfs) 30 | 31 |  32 | 33 | ### 第二种版本 34 | 35 | 第二种版本有两种下载方式。 36 | 37 | - 使用秒传下载,[详细教程](/mc) 38 | - 使用 Libgen 下载,[详细教程](https://bbs.yibook.org/d/391-hui-fu-xia-zai-fang-shi-9-jie-zhu-libgen-ti-dai-xia-zai) 39 | 40 |  -------------------------------------------------------------------------------- /backup/v5/uTools_1669602653400.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/v5/uTools_1669602653400.png -------------------------------------------------------------------------------- /backup/v5/uTools_1669602778564.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/v5/uTools_1669602778564.png -------------------------------------------------------------------------------- /backup/v5/uTools_1669603388597.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/v5/uTools_1669603388597.png -------------------------------------------------------------------------------- /backup/v5/uTools_1669603787587.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/backup/v5/uTools_1669603787587.png -------------------------------------------------------------------------------- /docs/api/index.md: -------------------------------------------------------------------------------- 1 | 虽然 zhelper search 以及 zhelper TGBot 原则上可以对接任何后端进行检索,但由于精力有限,目前仍然主要是对书籍类数据进行适配。如有其他类型数据需求可以向我们提交。 2 | 3 | 约定: 4 | - API 后端地址统一记为`https://api.exmaple.com`。 5 | - 按照传统,所有示例代码使用 python 展示。 6 | - 数据应当使用 Json 进行传递。 7 | 8 | ## 书籍类规范 9 | 10 | ### Full API 11 | 12 | 最主要的 API 类型。 13 | 14 | #### search 15 | 16 | 请求代码 17 | 18 | ```python 19 | json_data = { 20 | # 关键词,应当可以用空格分隔,建议使用 meilisearch 或者 elasticsearch 作为后端 21 | 'keyword': '三体', 22 | # 页码,一般来说每页应当设置 20 条结果 23 | 'page': 1, 24 | # 是否开启敏感词模式,如果接口对国内开放,建议提供此选项 25 | 'sensitive': False, 26 | } 27 | 28 | # api 地址为 /api/search 29 | response = requests.post('https://api.exmaple.com/api/search/', json=json_data) 30 | ``` 31 | 32 | 返回值示例。 33 | 34 | 数据以列表形式存储在 `data` 中,书源`source`和 ID `id` 构成唯一标记值,在进一步的请求中作为获取依据。需要返回 `hits` 作为前端翻页参考。 35 | 36 | 如某一字段缺失,则返回`null`。 37 | 38 | ```json 39 | { 40 | "data": [ 41 | { 42 | "title": "三体", 43 | "author": "刘慈欣", 44 | "publisher": "", 45 | "isbn": "9787536692930", 46 | "extension": "pdf", 47 | "filesize": 4706425, 48 | "year": "", 49 | "id": 2817721, 50 | "source": "zlibrary" 51 | }, 52 | { 53 | "title": "三体", 54 | "author": "刘慈欣", 55 | "publisher": "", 56 | "isbn": null, 57 | "extension": "txt", 58 | "filesize": 399897, 59 | "year": "", 60 | "id": 3483639, 61 | "source": "zlibrary" 62 | }, 63 | { 64 | "title": "三体", 65 | "author": "刘慈欣", 66 | "publisher": "重庆出版社", 67 | "isbn": "9787536692930", 68 | "extension": "pdf", 69 | "filesize": 165383382, 70 | "year": "2008", 71 | "id": 5241719, 72 | "source": "zlibrary" 73 | }, 74 | { 75 | "title": "三体", 76 | "author": "刘慈欣", 77 | "publisher": "", 78 | "isbn": null, 79 | "extension": "epub", 80 | "filesize": 2134513, 81 | "year": "2011", 82 | "id": 5552637, 83 | "source": "zlibrary" 84 | }, 85 | { 86 | "title": "三体", 87 | "author": "刘慈欣", 88 | "publisher": "", 89 | "isbn": null, 90 | "extension": "azw3", 91 | "filesize": 386569, 92 | "year": "2011", 93 | "id": 5732339, 94 | "source": "zlibrary" 95 | }, 96 | { 97 | "title": "三体", 98 | "author": "刘慈欣", 99 | "publisher": "重庆出版社", 100 | "isbn": null, 101 | "extension": "pdf", 102 | "filesize": 13713550, 103 | "year": "2012", 104 | "id": 5814476, 105 | "source": "zlibrary" 106 | }, 107 | { 108 | "title": "三体", 109 | "author": "刘慈欣", 110 | "publisher": "epub掌上书苑", 111 | "isbn": null, 112 | "extension": "epub", 113 | "filesize": 2135075, 114 | "year": "2011", 115 | "id": 6165958, 116 | "source": "zlibrary" 117 | }, 118 | { 119 | "title": "三体", 120 | "author": "刘慈欣", 121 | "publisher": "epub掌上书苑", 122 | "isbn": null, 123 | "extension": "mobi", 124 | "filesize": 4632483, 125 | "year": "2011", 126 | "id": 6196050, 127 | "source": "zlibrary" 128 | }, 129 | { 130 | "title": "三体", 131 | "author": "刘慈欣", 132 | "publisher": "epub掌上书苑", 133 | "isbn": null, 134 | "extension": "mobi", 135 | "filesize": 3336354, 136 | "year": "2011", 137 | "id": 11552744, 138 | "source": "zlibrary" 139 | }, 140 | { 141 | "title": "三体", 142 | "author": "刘慈欣 & chenjin5.com", 143 | "publisher": "chenjin5.com 海量电子书免费下载", 144 | "isbn": null, 145 | "extension": "azw3", 146 | "filesize": 611342, 147 | "year": "2011", 148 | "id": 11896657, 149 | "source": "zlibrary" 150 | }, 151 | { 152 | "title": "三体", 153 | "author": "刘慈欣 & chenjin5.com [刘慈欣 & chenjin5.com]", 154 | "publisher": "chenjin5.com 海量电子书免费下载", 155 | "isbn": null, 156 | "extension": "epub", 157 | "filesize": 331077, 158 | "year": "2011", 159 | "id": 11903485, 160 | "source": "zlibrary" 161 | }, 162 | { 163 | "title": "三体", 164 | "author": "刘慈欣 & chenjin5.com", 165 | "publisher": "chenjin5.com 海量电子书免费下载", 166 | "isbn": null, 167 | "extension": "mobi", 168 | "filesize": 589795, 169 | "year": "2011", 170 | "id": 11913070, 171 | "source": "zlibrary" 172 | }, 173 | { 174 | "title": "三体", 175 | "author": "刘慈欣", 176 | "publisher": "epub掌上书苑", 177 | "isbn": null, 178 | "extension": "mobi", 179 | "filesize": 3333653, 180 | "year": "2011", 181 | "id": 11993964, 182 | "source": "zlibrary" 183 | }, 184 | { 185 | "title": "三体", 186 | "author": "刘慈欣", 187 | "publisher": "epub掌上书苑", 188 | "isbn": null, 189 | "extension": "azw3", 190 | "filesize": 3417755, 191 | "year": "2011", 192 | "id": 15425721, 193 | "source": "zlibrary" 194 | }, 195 | { 196 | "title": "三体", 197 | "author": "刘慈欣", 198 | "publisher": "", 199 | "isbn": "9787229042066", 200 | "extension": "azw3", 201 | "filesize": 386573, 202 | "year": "2011", 203 | "id": 15959349, 204 | "source": "zlibrary" 205 | }, 206 | { 207 | "title": "三体", 208 | "author": "劉慈欣", 209 | "publisher": "早川書房", 210 | "isbn": null, 211 | "extension": "txt", 212 | "filesize": 989016, 213 | "year": "", 214 | "id": 16310451, 215 | "source": "zlibrary" 216 | }, 217 | { 218 | "title": "三体", 219 | "author": "刘慈欣", 220 | "publisher": "", 221 | "isbn": "9787229042066", 222 | "extension": "mobi", 223 | "filesize": 602933, 224 | "year": "2011", 225 | "id": 16337681, 226 | "source": "zlibrary" 227 | }, 228 | { 229 | "title": "三体", 230 | "author": "刘慈欣", 231 | "publisher": "", 232 | "isbn": "9787229042066", 233 | "extension": "mobi", 234 | "filesize": 602601, 235 | "year": "2011", 236 | "id": 16530802, 237 | "source": "zlibrary" 238 | }, 239 | { 240 | "title": "三体", 241 | "author": "原著:刘慈欣", 242 | "publisher": "", 243 | "isbn": null, 244 | "extension": "pdf", 245 | "filesize": 1242036, 246 | "year": "", 247 | "id": 16566326, 248 | "source": "zlibrary" 249 | }, 250 | { 251 | "title": "三体", 252 | "author": "刘慈欣", 253 | "publisher": "epub掌上书苑", 254 | "isbn": null, 255 | "extension": "epub", 256 | "filesize": 2135060, 257 | "year": "2011", 258 | "id": 16566339, 259 | "source": "zlibrary" 260 | } 261 | ], 262 | "hits": 900 263 | } 264 | ``` 265 | 266 | #### detail(可选) -------------------------------------------------------------------------------- /docs/index.md: -------------------------------------------------------------------------------- 1 | # 欢迎使用 zhelper 2 | 3 | !!! warning "说明" 4 | 5 | 基于安全、用户体验、维护成本等多方面的考虑,我们决定,**所有 2022 年 12 月 20 日之前上线的网站统一关闭处理,且不再进行维护,包括 V1-V5 全系列等。** 6 | 7 | 我们已经将相关代码开源在我们的 [Github](https://github.com/zhelper-org) 上,如对其比较感兴趣,可以自行研究。 8 | 9 | 之后 zhelper 相关域名将主要托管我们开发的前端界面 [zhelper search](https://github.com/zhelper-org/search-page) 以及相关的 TGbot 等。 10 | 11 | **请注意:我们不再提供搜索后端服务。** 12 | 13 | [新版本使用教程](/search) 14 | 15 | ## 目录 16 | 17 | ### 使用 18 | 19 | - [zhelper search 简明教程](/search) 20 | 21 | 22 | ### 开发 23 | 24 | - [zhelper API 规范](/api) 25 | - [zhelper search 开发说明](/search-dev) 26 | 27 | -------------------------------------------------------------------------------- /docs/search-dev/index.md: -------------------------------------------------------------------------------- 1 | 项目地址 2 | 3 | 4 | ## 多语言支持 5 | 6 | 通过 `language` 提供支持。目前已经有中文和 English 两个选项,欢迎贡献其他语言! 7 | 8 | ## 传入 API 9 | 10 | 目前 zhelper search 支持以 `location.search` 形式传入 API 信息,之后 TGBot 也会跟进相关功能。传入 API 示例: 11 | 12 | ``` 13 | https://search.zhelper.net/?[{"name":"exmaple","url":"https://api.exmaple.com","type":"full","sensitive":false,"detail":true}] 14 | ``` 15 | 16 | - 至少应当有以上 5 个字段。 17 | - `name`:在前端展示的 API 名称 18 | - `url`:API 请求的 `baseurl` 19 | - `type`:API 类型,有 `full` 和 `light` 可选,详见 API 规范 20 | - `sensitive`:是否开启敏感词模式,建议默认开启 21 | - `detail`:API 是否有 `detail` 接口(是否需要请求此接口),详见 API 规范 22 | - 多个 API 可以以列表的形式传入 23 | - 使用 JSON 格式解析,请保证符合规范。 -------------------------------------------------------------------------------- /docs/search/index.md: -------------------------------------------------------------------------------- 1 | 2 | zhelper search 需要搭配搜索接口食用。目前收集到的接口包括: 3 | 4 | - [zlib.app](https://zlib.app/):zlibrary 的在线接口。 5 | - [bookpan.net](https://bookpan.net/):布克盘,聚合搜书接口。 6 | - [ylibrary.org](https://ylibrary.org/):Ylibrary 去中心化图书馆接口,整合了 zlib 和 superlib 的资源。 7 | 8 | 9 | ## 关于无可用接口的说明 10 | 11 | zhelper search 的地址是:https://search.zhelper.net/ 12 | 13 | **直接打开会显示无可用接口**,这属于正常现象,不是 BUG。是由于你没有设置搜索接口。 14 | 15 |  16 | 17 | ## 如何寻找更多接口 18 | 19 | 目前我们所收集的接口数据肯定不是非常全面。关于其他接口,请您自行在网上搜索相关内容。如果您有好的接口,也欢迎在 TG 中向我们提出。 20 | 21 | [在 Bing 中搜索](https://cn.bing.com/search?q=zhelper+search+%E9%85%8D%E7%BD%AE) 22 | 23 | 24 | ## 在搜索时切换接口 25 | 26 | 电脑端: 27 | 28 |  29 | 30 | 手机端: 31 | 32 |  33 | 34 | 通过切换接口,可以实现快速搜索多个书库,这也是我们设计 zhelper search 的一个主要的想法。 -------------------------------------------------------------------------------- /docs/search/uTools_1671797022286.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/docs/search/uTools_1671797022286.png -------------------------------------------------------------------------------- /docs/search/uTools_1671798071245.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/docs/search/uTools_1671798071245.png -------------------------------------------------------------------------------- /docs/search/uTools_1671798699908.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/docs/search/uTools_1671798699908.png -------------------------------------------------------------------------------- /docs/search/uTools_1671798794315.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/docs/search/uTools_1671798794315.png -------------------------------------------------------------------------------- /docs/search/uTools_1671798814508.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/zhelper-org/docs/0ff8db8f3eb269130401226d2f8129c97732cf6d/docs/search/uTools_1671798814508.png -------------------------------------------------------------------------------- /mkdocs.yml: -------------------------------------------------------------------------------- 1 | site_name: zhelper 帮助文档 2 | theme: 3 | name: material 4 | custom_dir: overrides 5 | language: zh 6 | features: 7 | - toc.integrate 8 | palette: 9 | primary: red 10 | 11 | extra_javascript: 12 | - javascript/extra.js 13 | 14 | markdown_extensions: 15 | - admonition 16 | - pymdownx.details 17 | - pymdownx.superfences 18 | 19 | nav: 20 | - zhelper search 简明教程: search/index.md 21 | - zhelper Search 开发说明: search-dev/index.md 22 | - zhelper API 规范: api/index.md 23 | # - zhelper V5 使用教程: v5/index.md 24 | # - 秒传图文教程: mc/index.md 25 | # - IPFS 图文教程: ipfs/index.md 26 | # - BT 图文教程: bt/index.md -------------------------------------------------------------------------------- /netlify.toml: -------------------------------------------------------------------------------- 1 | [build] 2 | command = "mkdocs build" 3 | publish = "site" -------------------------------------------------------------------------------- /overrides/base.html: -------------------------------------------------------------------------------- 1 | {#- 2 | This file was automatically generated - do not edit 3 | -#} 4 | {% import "partials/language.html" as lang with context %} 5 | 6 | 7 |
8 | {% block site_meta %} 9 | 10 | 11 | {% if page and page.meta and page.meta.description %} 12 | 13 | {% elif config.site_description %} 14 | 15 | {% endif %} 16 | {% if page and page.meta and page.meta.author %} 17 | 18 | {% elif config.site_author %} 19 | 20 | {% endif %} 21 | {% if page.canonical_url %} 22 | 23 | {% endif %} 24 | 25 | 26 | {% endblock %} 27 | {% block htmltitle %} 28 | {% if page and page.meta and page.meta.title %} 29 |