soulsign-chrome魂签,一款用于自动签到的chrome插件
soulsign-chrome
功能
自动签到,每天只要打开浏览器就可以自动签到,不用填写账号密码,不用手动抓取cookie,只需要 添加脚本+登录账号
使用方法
- 手动安装: 下载build.zip并解压,选项->更多工具->扩展程序->开发者模式->加载已解压的扩展程序
-
chrome网上应用店安装(由于不能通过审核,没有更新了)
firefox 安装
安装脚本
- 最简单的方法,点击插件图标->任务管理->脚本推荐->挑选安装
- 第三方或者自用脚本安装方法, 点击插件图标->任务管理->添加脚本->上传脚本文件/粘贴脚本代码/拖拽脚本文件/粘贴脚本链接
更新:
20181207: 支持用户填写参数,用于用户填写账号密码进行自动登录的场景。使用方法参考 public/demos/m.jd.js
, 需要版本1.0.4+ 20190326: 支持引用外部js,支持获取指定网页的cookie 示例/public/demo/xiami.js 20190428: 支持域名模糊匹配, *.baidu.com 将匹配 xxoo.baidu.com 或 www.baidu.com 但不能匹配 baidu.com 20191205: 代码重构,清理了一些逻辑,将任务管理等操作统一到了后端,保证数据一至性;增加导入导出功能;增强脚本安全性,新增@grant用于权限申请 20191208: 增加了返利捐赠开关, 访问https://www.jd.com/
时将跳转到作者的返利链接 20191218: 优化代码结构,支持脚本导出/导入,增加脚本网站 20200827: 支持 查看日志
页面
20200831: 支持类似puppeteer模拟点击等功能, 使用说明
计划:
-
低版本支持(自带babel)无明显需求,所以放弃 - 脚本更新(手动/自动)
✅ - 脚本发布站点
✅
脚本开发
示例:
// ==UserScript==
// @name v2ex签到
// @namespace https://github.com/inu1255/soulsign-chrome
// @version 1.0.0
// @author inu1255
// @loginURL https://www.v2ex.com/signin
// @expire 900e3
// @domain www.v2ex.com
// ==/UserScript==
/**
* 签到接口,可以使用axios库发起请求,请求url域名必须通过@domain声明
* throw 签到失败并抛出失败原因
* return 签到成功并返回成功信息
*/
exports.run = async function() {
var ret = await axios.get('https://www.v2ex.com/mission/daily');
if (ret.status != 200) throw '需要登录';
if (/每日登录奖励已领取/.test(ret.data)) return '已领取';
let m = /redeem\?once=(.*?)'/.exec(ret.data);
if (!m) throw '失败1';
await axios.get('https://www.v2ex.com/mission/daily/redeem?once=' + m[1]);
var ret = await axios.get('https://www.v2ex.com/mission/daily');
if (/每日登录奖励已领取/.test(ret.data)) return '成功';
throw '失败2';
};
/**
* 检查是否在线接口,可以使用axios库发起请求,请求url域名必须通过@domain声明
* return true 代表在线
*/
exports.check = async function() {
var ret = await axios.get('https://www.v2ex.com/mission/daily');
return ret.status == 200;
};
说明:
- 前面的 ==UserScript== 不可少
- @name 脚本名称
- @namespace 脚本官方网址
- @version 脚本版本
- @author 脚本作者
- @loginURL 登录链接(帮助用户通过这个链接去登录)
- @expire 会话过期时间(毫秒),系统会隔一段时间调用一次check接口检查在线状态并保持会话活跃
- @domain 请求域名(向用户申明该脚本会访问的域名)
- @domain 另一个请求域名(@domain支持多个)
- @param 参数键 [参数类型,选填,默认text] 参数说明
- (@author,@name)唯一确定一个脚本,重复会被当成一个脚本
- 后面的 ==/UserScript== 不可少
更多demos ps: 作者自己写的脚本用到了async/await不支持低版本浏览器
日志配置
预览:
示例:
输出
指export.run()
的返回值
-
标准输出格式object
{ summary: "签到成功", // `执行结果`,可渲染 `html` detail: [ { domain: "www.example.com", // `细节/日志` 中的 `域名` url: "https://www.example.com", // `细节/日志` 中的 `域名` 的跳转链接 message: "获得 1 积分", // `细节/日志` 中的 `消息`,格式同 `执行结果` errno: false, // 成功,errno = (false || 0);失败,errno = (true || !0) log: { data: "some_data", param: { param1: 1, param2: "some_string", }, }, // 或任何其他的额外属性,类型和数量不限,其将会在 `表单展开项` 中出现 }, ], }
-
兼容输出格式string
"签到成功" // 将默认转化为 `标准输出格式`,如下所示 // // { // summary: "签到成功", // detail: [ // { // domain: @domain[0], // url: @loginUrl, // message: "签到成功", // errno: throw ? true : false, // }, // ], // }
说明:
- 如果你利用
标准输出格式
开发,请尽量使用tools.version
{ inputLower: 1, inputEqual: 0, inputHigher: -1 } = function (string) 对输出格式做兼容处理,object
在旧版本插件中会以JSON
形式展示在执行结果
处,观感可能会很差。 -
.log | 额外的其他属性
的内容完全由脚本内部定义,初衷是更好地开发和请求用户反馈信息,为非必要选项,所以默认不可复制。 -
细节/日志
页面可以复选
分域名复制
,默认可复制的信息中有domain
,url
,message
,errno
,其他信息需要用户自行开启选项,添加后复制。 -
细节/日志
中的域名
不仅拥有执行结果
的两种颜色,还支持errno = 2 : orange
、errno = 3 : orchid
、errno = 4 : pink
、errno = 5 : brown
。 -
表单展开项
中的JSON
树默认仅展开一层。
模拟点击
思路
作者以前用puppeteer做过一套签到工具,用nodejs做过签到站点,不过两者都有一个短板--拿cookie不方便。做成插件的好处就是不用管理cookie,插件不用记录cookie信息,用户不用抓取cookie只需要在浏览器登录账号就行了。
评论