oneClickHub 一点仓库
2 |一点仓库是在Android系统上运行，基于Auto.js无障碍服务的脚本仓库
3 |用户能使用开发者上传的脚本完成双十一任务、打卡等各种操作
4 |脚本基于仓库自动更新，免去频繁更新app的烦恼
5 | 6 | 7 | # oneClickHub 8 | 一点仓库 9 | 10 | # 导航 11 | - **[关于本项目](#about)** 12 | - **[如何使用](#howtouse)** 13 | - **[如何开发你的脚本](#develop)** 14 | - **[如何上传你的脚本](#jump)** 15 | - **[如何查看其它脚本](#jump2)** 16 | - **[脚本安全](#jump3)** 17 | - **[Api](#api)** 18 | - **[搭建自己的仓库](#myHub)** 19 | - **[免责声明](#free)** 20 | 21 | 22 | # 关于本项目： 23 | 本项目致力于开发`Autojs`脚本仓库 24 | 用户无需频繁更新app可使用到最新发布的脚本 25 | 本软件完全开源共享 26 | 本项目源码在https://github.com/chrrg/chrrg.github.io/ 27 | 本项目将长期维护 28 | 29 | # 如何使用： 30 | 硬件要求： 31 | Android设备（需带有无障碍服务功能） 32 | 若涉及到触摸点击功能需使用`Android7.0`以上设备 33 | 软件要求： 34 | 本App可以在本项目的`release`中下载 35 | 安装并运行即可 36 | 37 | # 如何开发你的脚本： 38 | 准备环境： 39 | NodeJS 40 | Win/Linux/Mac 均可 41 | 42 | clone以下项目： 43 | https://github.com/chrrg/autojs_extension 44 | 修改/out/vscode.js里的21行的路径为你fork的chhub文件夹 45 | 如以下修改： 46 | ```js 47 | exports.workspace={ 48 | workspaceFolders:'D:/文档/GitHub/chrrg.github.io/chhub'//工作目录需要在这里修改 49 | }; 50 | ``` 51 | 52 | 打开命令行控制台切换目录到/out/ 53 | 运行node run即可运行 54 | 55 | 手机安装AutoJs 4.1.1 56 | 打开后侧边栏连接电脑 57 | 输入电脑的IP 58 | 59 | 在控制台键入r回车即可运行项目q结束运行 60 | 61 | 调试方法： 62 | 修改main.js 63 | 在第一行输入 64 | ```js 65 | runTest(1);//1改为自己的脚本文件名 66 | exit(); 67 | ``` 68 | 电脑上键入r并回车可以立即在手机上运行/files/1.js脚本 69 | 支持console.log显示到电脑端 70 | 开发细节或api请仔细阅读AutoJS开发文档：https://hyb1996.github.io/AutoJs-Docs/ 71 | 72 | # 如何上传你的脚本： 73 | 上传脚本到默认仓库： 74 | ## 注意： 75 | 请勿在本页面提交PR！ 76 | 默认仓库使用 `github.io` 来获取仓库数据 77 | 上传脚本请提交到以下地址： 78 | `https://github.com/chrrg/chrrg.github.io` 79 | ### 文件列表： 80 | - /chhub/files/ 存放所有的脚本 81 | - /chhub/hub.json 仓库索引 82 | ## fork上述项目 83 | fork并按照格式修改hub.json 84 | 并将你的脚本添加到/chhub/files/目录下 85 | 每次修改代码hub.json版本号需要变动，否则用户不会收到更新 86 | 提交 `Pull Request` 87 | 等待合并即可 88 | 89 | ## 哪些情况的PR会被拒绝 90 | 未按照规定的格式修改`hub.json` 91 | 包含无用的文件或文件夹 92 | 恶意行为的脚本 93 | 其它违规行为 94 | 95 | ## 关于脚本 96 | 每一个脚本仅对应一个js文件 97 | 暂不支持引入其它文件 98 | 99 | # 如何查看其它脚本： 100 | 所有脚本均保存到 `https://github.com/chrrg/chrrg.github.io/` 中 101 | 可以去上述链接找到脚本源文件 102 | 应用启动时会首先获取 `https://chrrg.github.io/chhub/hub.json` 的数据 103 | 104 | # 脚本安全： 105 | 每一个脚本运行在独立的线程中 106 | 并且有一定的数据隔离，不会相互修改数据 107 | 108 | # Api： 109 | ## Api的作用 110 | 本软件会为每一个脚本封装一个独立的api对象 111 | 在你的脚本中可直接使用api对象进行各种函数的调用 112 | 113 | ## Api列表： 114 | ### api.ui() 115 | 116 | 非ui线程下使用： 117 | api.ui() 118 | 可在控制台查看当前界面的所有控件的基本属性 119 | **此函数在调试时非常有帮助** 120 | 121 | 参数：(selector,offset,size) 122 | selector为选择器 123 | offset为起始索引，size为从起始值查询多少个元素 124 | 最简单的调用方法为`api.ui()` 125 | 126 | ```js 127 | api.ui(packageName(currentPackage()),0,500); 128 | ``` 129 | 130 | 如果是UI线程需要创建线程才能运行阻塞函数，如： 131 | ```js 132 | threads.start(function () { 133 | api.ui() 134 | }); 135 | ``` 136 | 137 | ### api.getId() 138 | 获取应用名 139 | 140 | ### api.getExtras() 141 | 获取启动时传入的参数 142 | 143 | 144 | # 搭建自己的仓库： 145 | 官方仓库地址：`https://chrrg.github.io/chhub/hub.json` 146 | 搭建自己的仓库能够让用户只显示自己仓库中的脚本，和自己编写的用户界面 147 | ## hub.json文件格式 148 | ```json 149 | { 150 | "code": 200,//必须200，否则会弹出text消息 151 | "text": "", 152 | "data": { 153 | "HubRoot":"https://chrrg.github.io/chhub/hub.json",//当前地址 154 | "ui":["files/ui.js",9],//数组第一个元素为用户界面ui.js的相对路径，第二个元素是版本号，若界面发生变化修改版本号，用户会自动更新ui.js 155 | "list": [{ 156 | "id":1, 157 | "name": "应用标题", 158 | "file": "files/1.js",//脚本的相对路径 159 | "version": "1.8.9",//脚本的版本 160 | "desc": "一键完成淘宝喵币任务"//描述 161 | }]//这里格式可以自定义 162 | } 163 | } 164 | ``` 165 | 166 | ## 创建自己的仓库 167 | 仓库地址可以是github.io的静态，也可以是任何返回后端制作的json的地址 168 | 且api返回格式尽量与官方仓库返回格式保持一致 169 | 需自行实现ui.js，让用户打开后看到自己仓库的用户界面 170 | ui.js中可扩展api提供给脚本使用 171 | 172 | ## 引导用户使用自己的仓库 173 | 用户第一次打开软件默认使用官方仓库地址 174 | 创建引导脚本，脚本中调用设置仓库地址的Api 175 | ```js 176 | api.setHubPath("http://127.0.0.1/myhub.asp")//设置成功将重启软件 177 | toast("设置失败！")//否则说明设置失败 178 | ``` 179 | 上传自己的引导应用到官方仓库 180 | 用户打开此仓库完成确认后即可完成仓库地址的切换 181 | 182 | 183 | # 免责声明： 184 | 由于所有人可上传自己的脚本 185 | 并且脚本具有动态可变性 186 | 不能保证脚本100%安全 187 | 若出现任何损失，本人概不负责 188 | 189 | --------------------------------------------------------------------------------