双卡助手说明书


  • 首页

  • 归档

接口API

发表于 2019-11-16

前言

为了方便开发岗位的用户,助手支持了接口API,通过username(一般为手机号或者以5开头的设备号)和auth_key(接口api鉴权key)鉴权来调用部分开放接口。

1
注意:接口API目前为实验功能,单个IP限制为300次/天,恶意使用将被封禁IP。

使用方法

获取云端信息列表

offset和limit为可选参数,用于分页。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/msg?offset=1&limit=10

获取在线设备列表(cid)

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/cid

发送设备通知

cid为设备号,通过在线设备列表接口获取;titile和content为推送的标题和内容。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/notify?cid={{cid}}&title={{title}}&content={{content}}

发送短信

cid为设备号,通过在线设备列表接口获取;phone和content为对方手机号码和短信内容;slot(可选参数)为发短信的卡槽,值为0或1,代表卡槽一和卡槽二。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/send-sms?cid={{cid}}&phone={{phone}}&content={{content}}&slot={{slot}}

短信列表

cid为设备号,通过在线设备列表接口获取;size(可选参数,默认为3)获取短信的条数。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/recent-sms?cid={{cid}}&size={{size}}

未接来电列表

cid为设备号,通过在线设备列表接口获取;size(可选参数,默认为3)获取未接来电的条数。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/missed-call?cid={{cid}}&size={{size}}

查询号码联系人名称

cid为设备号,通过在线设备列表接口获取;phone要查询的电话号码。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/contact-name?cid={{cid}}&phone={{phone}}

获取联系人列表

cid为设备号,通过在线设备列表接口获取。

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/get-contact?cid={{cid}}

修改配置信息

cid为设备号,通过在线设备列表接口获取。支持修改的参数
【bool类型参数】
allow_sms:是否转发短信
allow_income_phone_send:是否转发未接来电
allow_notification_send:是否转发应用通知
allow_locate_send:是否转发定位信息
allow_battery_low_send:是否转发低电量消息
allow_battery_charge_send:是否转发充电提醒
allow_sms_send:开启或关闭短信转发
allow_email_send:开启或关闭邮箱转发
allow_web_send:开启或关闭邮箱转发
allow_wx_send:开启或关闭邮箱转发
allow_push_sms:开启或关闭通知转发
allow_script:开启或关闭脚本转发
allow_cheap_mode:开启或关闭省钱模式
allow_send_filter:开启或关闭过滤规则

1
2
POST:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/alter-config?cid={{cid}}
Body:{"allow_sms":true,"allow_income_phone_send":false}

重置auth_key

1
GET:https://api.smshelper.cozylife.tech/send/{{username}}/{{auth_key}}/reset

如何获取企业微信配置信息

发表于 2019-07-29

注册企业微信获取企业ID

1.点击这里注册:https://work.weixin.qq.com/wework_admin/register_wx?from=myhome
2.获取网页底部的企业ID:https://work.weixin.qq.com/wework_admin/frame#profile

微信扫码关注,同步消息到微信

1.打开微工作台:https://work.weixin.qq.com/wework_admin/frame#profile/wxPlugin
2.找到【邀请关注】二维码并微信扫码关注

创建应用并获取AgentId和Secret

1.点击这里创建 https://work.weixin.qq.com/wework_admin/frame#apps/createApiApp
2.获取AgentId和Secret:https://work.weixin.qq.com/wework_admin/frame#apps

启用脚本进行转发

发表于 2019-07-27

使用说明

1.脚本运行环境为nodejs,依赖的网络请求工具为request(查看request文档)和axios(查看axios文档);
2.运行脚本的功能目前处于测试期,因此并不能保证稳定性;
3.该功能是为了方便用户自定义转发场景,请勿执行耗时操作或者用于恶意攻击,否则将作封号处理。

使用方法

脚本功能可以灵活实现所有方式的网络转发,比如转发到企业微信,实现自定义消息过滤等。

支持的内置变量

参考【网络转发-支持的内置变量】。

GET请求示例

1
2
3
4
5
6
let url = 'http://localhost/test-get';
//如果url中包含中文等特殊字符,请使用encodeURI函数进行转码
url = encodeURI(url);
request(url, (error, response, body) => {
//你的业务代码
});

POST请求示例

1
2
3
4
5
6
7
const options = {
form: {"model":"{{model}}"},
url: "http://localhost/test-post"
};
request.post(options, (error, response, body) => {
//你的业务代码
});

企业微信示例

请修改脚本前三行变量【如何获取企业微信配置信息?】。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
//你的企业ID
const corpid = "wwfefea362ad89f874";
//创建应用后生成的Secret
const corpsecret = "WLviSlFLxbZA_X4qHhPuaxuyoWSDwYahyamEd-UhK6s";
//创建应用后生成的AgentId
const agentid = "1000002";
//要发送的内容
const content = "{{title}}\n{{content}}";

let url = `https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${corpid}&corpsecret=${corpsecret}`;
//如果url中包含中文等特殊字符,请使用encodeURI函数进行转码
url = encodeURI(url);
request(url, (error, response, body) => {
//你的业务代码
const { access_token } = JSON.parse(body);
const options = {
url: `https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${access_token}`,
form: JSON.stringify({
touser: "@all",
msgtype: "text",
agentid,
text: {
content
},
safe: 0
})
};
request.post(options, (error, response, body) => {
//你的业务代码
});
});

常见问题

发表于 2019-06-01

1.助手简介

“双卡助手”项目(原名短信转发助手),旨在为多卡用户提供一个稳定可靠的便捷服务。从2014年到2019年,已经无偿维护了5年,为了让项目能够持续稳定运行下去,应多数用户建议,于2019年4月6日开始施行捐赠措施。官网地址:https://smshelper.cozylife.tech,QQ群:809034221(防止骚扰和广告,设置了1元付费入群门槛)。

2.提示无权限?

由于加入了接口安全校验,如果遇到无权限的提示,请更新手机时间为最新的网络时间。

3.无法转发短信?

转发短信前,请开启必要的权限,参考【权限说明】。

4.无法转发包含验证码的短信?

参考【无法转发验证码短信】。

5.转发不稳定,开启软件才会转发,屏幕关闭就不行了?

参考【保证稳定运行的设置】,【后台运行的设置】。

6.网络转发方式和微信转发方式上使用wxpusher有什么区别?

两种方式都需要微信扫码关注,但扫的二维码是不一样的。网络转发访问二维码地址,微信转发在微信转发页面右上角获取二维码。

7.什么是无图标版本?如何获取?

无图标版本为部分强迫症用户设计,安装后没有桌面图标显示,没有通知栏图标显示。【下载无图标版本】。

8.没有界面的无图标版本如何打开?

方式一:手机拨号盘输入 *#*#1107#*#* 。
方式二:系统自带的浏览器打开网页地址:https://smshelper.cozylife.tech/launch.html。
方式三:覆盖安装正常版本。

9.不捐赠如何免费使用?

为了让项目能够持续稳定运行下去,施行捐赠措施,以达到风险防控和防滥用的效果。如果想免费使用助手,可以参考以下几点:
a.未捐赠用户每月有50条转发量;
b.邀请用户注册,您和新注册用户可以分别获得1个月使用时长,上不封顶;
c.2014年4月1日-2019年4月1日期间,捐赠金额在10元及以上获得永久使用权限;
d.在其他论坛博客对助手app的推广介绍,使用说明以及客观评价,热度较高者获得永久使用权限。

10.如何捐赠,同一账号可以登录几台设备?有转发条数限制吗?

捐赠请查看【捐赠支持】,为了方便大家使用,捐赠后没有转发数量的限制,也没有登录设备数量的限制。

11.捐赠后,为什么有效期没有变?

如果遇到捐赠后,App显示有效期没有改变,并不影响使用,也可以尝试重新启动App。

无法转发验证码短信

发表于 2019-05-12

前言

安卓系统短信是没有区分普通短信和通知类短信的。国内厂商为了方便用户以及保护用户隐私,对包含验证码的短信做了不同的限制处理。所以,如果您不能转发包含验证码的短信,请尝试以下设置(其他系统也做类似的设置)。

操作(使用短信识别模式三)

进入转发短信设置,修改短信识别模式为【模式三】

操作(使用短信识别模式一和二)

小米系统

打开系统设置->更多应用->双卡助手->勾选通知类短信的权限

华为系统

打开系统设置->信息->关闭验证码安全保护

vivo系统

打开系统设置->信息->关闭验证码安全保护

oppo系统

打开系统设置->信息->关闭验证码安全保护

短信软件

app首页左上角->转发设置->默认短信
华为系统可能需要替换默认短信应用为第三方短信应用方可正常转发,请先下载任意一款短信App【下载短信App】,然后点击设置默认应用。

保证稳定运行的设置

发表于 2019-05-11

前言

安卓app的保活一直都不是一件容易的事情,助手无法做到微信那样,无需任何设置即可稳定地后台运行(手机厂商系统会保护微信不被杀掉),也不想集成某类推送服务(比如极光推送),从而可以相互拉活也集成了这类服务的app。root方式也不是大部分用户的选择,安全性也可能遭到质疑。

助手始终认为,杀不死的app和病毒没什么区别。当然为了保证助手服务的稳定,也要尽可能不被系统杀掉,可以做以下措施。(注意:由于安卓系统的碎片化,之后的讲解都以小米机型作为代表,其他机型做类似设置)

1.关闭系统对双卡助手的电量优化

操作

打开系统设置->电量和性能->应用配置->找到双卡助手点击进入页面->选择无限制
(或者)
打开系统设置->更多应用->找到双卡助手点击进入页面->省电策略>选择无限制
省电策略

2.设置自启动

操作

打开系统设置->更多应用->找到双卡助手点击进入页面->勾选自启动
(或者)
打开双卡助手软件->点击手机菜单按钮打开最近任务->长按双卡助手任务->点击设置->勾选自启动
自启动

3.加入系统查杀白名单

操作

打开安全中心软件->右上角设置按钮->优化加速->锁定任务->找到双卡助手并勾选
(或者)
打开双卡助手软件->点击手机菜单按钮打开最近任务->长按双卡助手任务->加锁
白名单

权限说明

发表于 2019-05-01

前言

为了保障转发功能的正常使用,请开启相应的权限,不需要的功能权限可以自主关闭(比如定位,悬浮提示等)。

如何设置

方法一:在系统设置里面找到双卡助手
方法二:app首页左上角->转发设置->默认短信

权限说明

读取短信

短信转发功能需要开启读取短信的权限,这样才能在有新的短信时候,读取短信内容,实现转发。

写入短信

为了保证安全,助手每次转发会在手机发信箱留下转发记录,这需要写入短信的权限。

通知类短信(验证码短信)

安卓系统短信是没有区分普通短信和通知类短信的。国内厂商为了方便用户以及保护用户隐私,对包含验证码的短信做了不同的限制处理(比如小米系统)。所以,如果您不能转发包含验证码的短信,请尝试开启这个权限。

通话记录(来电状态)

要实现未接来电提醒,就需要开启这个权限,用于判断和读取未接来电。

联系人(通讯录)

为了方便使用,助手会读取联系人,匹配识别短信发件人和来电号码,在转发内容自动添加联系人名称。

联网

除了短信转发不需要网络,其他转发方式必须开启这个权限。

存储

用于保存软件运行的配置信息以及保存二维码图片到图库。

定位(位置信息)

助手并不使用定位功能,这个可以关闭。

获取一键配置参数

发表于 2018-11-13

一键配置

一键配置目前支持WXPusher/Server酱/bark「iOS」/钉钉机器人/企业微信群机器人,只需要将相应平台的KEY填入即可实现转发。

WXPusher:

1
访问地址:https://url.cn/5QVzwEa,微信扫描二维码,获取userId,将userId填入助手的一键配置输入框。

即时达:

1
访问地址:http://push.ijingniu.cn,获取Key后,将Key填入助手的一键配置输入框。

Server酱:

1
访问地址:http://sc.ftqq.com/3.version,获取SCKey后,将SCKey填入助手的一键配置输入框。

bark「iOS」:

1
在iOS手机的AppStore下载bark软件,获取推送地址,格式类似“https://api.day.app/KEY/标题/内容”,将KEY填入助手的一键配置输入框。

企业微信群机器人:

1
下载企业微信app,创建并加入群聊后,点击群聊页面右上角进入设置页面,选择群机器人并添加。获取推送地址,格式类似“https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=KEY”,将KEY填入助手的一键配置输入框。

钉钉机器人:

1
下载钉钉app,创建并加入群聊后,点击群聊页面右上角进入设置页面,选择群机器人类型为“自定义”并添加。创建成功后,根据页面说明,到钉钉电脑端获取推送KEY,将KEY填入助手的一键配置输入框。

Microsoft Teams:

1
参考博客:https://blog.csdn.net/xxjjxx/article/details/102171374,将获取到的http链接填入助手的一键配置输入框。

网络转发

发表于 2018-11-13

支持的内置变量

1
注意变量的使用方式,使用"{{ }}"来包裹变量,例如"{{content}}"。

title:引用标题变量
content:引用内容变量
nickname:引用号码联系人变量(仅在短信和未接来电时候有值)
model:引用手机型号变量
custom_model:引用自定义手机型号变量
card_name:引用双卡卡槽标识变量
app_name:引用软件名称变量
app_version:引用软件当前版本变量
timestamp:引用时间变量
udid:引用设备唯一识别号变量
cid:引用当前设备cid变量
msg_id:引用消息ID变量
extra:引用附加信息变量

使用方法

一键配置方式(推荐小白用户使用此方式)

一键配置目前支持WXPusher/Server酱/bark「iOS」/企业微信群机器人/钉钉机器人/即时达推送/Microsoft Teams,只需要将相应平台的KEY填入即可实现转发,获取KEY方式参考【获取一键配置参数】。

GET方式

以地址”http://www.baidu.com"作为示例,
将 title 和 content 发送给远程地址:

1
网络地址:http://www.baidu.com?title={{title}}&content={{content}}

第一个 title 是远程服务器接受参数的名字,可以根据需求随意修改。第二个 title 是助手内部变量的名字,不可修改。

POST方式

以地址”http://www.baidu.com"作为示例,
将 title 和 content 发送给远程地址:

1
2
网络地址:http://www.baidu.com
body:{"title":"{{title}}","content":"{{content}}"}

body 为 post 请求提交给服务器的数据,使用json字符串形式,可以参考http://www.bejson.com/。

示例代码

WXPusher示例如下:

1
网络地址:http://wxmsg.dingliqc.com/send?title={{title}}&msg={{content}}&userIds=你的ID

其中 title 和 msg 是 WXPusher 约定的参数名称,分别代表标题和内容,不可修改。但是我们可以自定义它们的值,例如我想在标题添加号码,内容添加来自哪个设备:

1
网络地址:http://wxmsg.dingliqc.com/send?title=来自{{phone}}的短信&msg={{content}}--这是来自{{model}}设备的信息&userIds=你的ID

Server酱示例如下:

1
网络地址:https://sc.ftqq.com/SCKey.send?text={{title}}&desp={{content}}

其中 text 和 desp 是 Server 酱约定的参数名称,分别代表标题和内容,不可修改。但是我们可以自定义它们的值,例如我想在标题添加号码,内容添加来自哪个设备:

1
网络地址:https://sc.ftqq.com/SCKey.send?text=来自{{phone}}的短信&desp={{content}}--这是来自{{model}}设备的信息

bark「iOS」示例如下:

1
网络地址:https://api.day.app/你的key/{{title}}/{{content}}

其中 text 和 content 是 bark「iOS」约定的参数名称,分别代表标题和内容,不可修改。但是我们可以自定义它们的值,例如我想在标题添加号码,内容添加来自哪个设备:

1
网络地址:https://api.day.app/你的key/{{title}}/{{content}}--这是来自{{model}}设备的信息

钉钉机器人示例如下:

1
Post网络地址:https://oapi.dingtalk.com/robot/send?access_token=你的key
1
Post的body:{"actionCard":{"title":"{{title}}","text":"### {{title}} \n{{content}}"},"msgtype":"actionCard"}

企业微信群机器人示例如下:

1
Post网络地址:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的key
1
Post的body:{"markdown":{"content":"### {{title}} \n{{content}}"},"msgtype":"markdown"}

双卡助手功能使用

发表于 2018-11-06

转发前配置

注意:由于安卓系统的碎片化,之后的讲解都以小米机型作为代表,其他机型做类似设置。
1.开启相应权限。短信转发:读取短信权限,发送短信权限,读取联系人权限(可选);转发未接来电:读取通话记录权限,获取电话状态的权限。
2.避免后台杀应用。关闭省电模式对后台应用的限制,或者将双卡助手加入电量管理白名单。
3.解除安全软件的限制。解除系统自带安全软件对助手权限和后台活动的限制。
4.设置开机自启动(可选)。

1.短信转发

操作

短信转发功能是不需要注册的。打开设置页面,直接填写转发到的手机号码,然后开启转发功能。如果要转发给多个手机号码,请在“追加转发号码”选项设置。以上步骤完成后,就可以拿起主力机给当前设备发送短信测试了,当然你也可以使用模拟测试的方法,是不是美滋滋😊。

注意事项

1.读取和发送短信的权限。
2.如果测试发现不能正常转发,可以尝试切换设置面板的短信识别模式。

2.转发未接来电和电量提醒

操作

在设置页面勾选转发未接来电和低电量提醒。

注意事项

必须开启读取电话状态相关权限。

3.转发到云端+云端信息加密

什么是云端转发

双卡助手可以使用短信的方式来转发未读短信和来电信息,但是考虑到并不是每个用户都有包月短信,由此增加此项功能。该功能的原理是:助手读取要转发的消息->上传该消息到助手服务器-> 用户从助手服务器读取最新的消息。由此避开了短信转发的费用。

什么是云端信息加密

助手在和服务器通讯的过程中,数据传输是经过严格加密的,如果用户仍觉得不安全,可以使用本地数据加密功能,即云端信息加密。此功能的原理是:用户在助手软件设置加密数据的秘钥,在数据上传服务器之前,使用秘钥对信息进行加密处理,用户从服务器拉取加密过的数据,经过本地解密呈现给用户。

操作

在设置面板开启转发到云端功能,点击设置按钮进入秘钥配置页面,可以随机生成也可以自己手动输入,添加秘钥后启用即可。

注意事项

1.转发到云端功能只有注册后的用户可以使用
2.秘钥只存在手机中,不会上传到服务器,请牢记秘钥,否则无法解密经过加密的信息。

4.网络转发功能

什么是网络转发

网络转发顾名思义,就是通过网络请求的方式发送消息到您指定的地址。目前仅支持GET和POST方式(请严格按照示例中的方式传参数),如果您是开发人员,可以将信息转发到您自己的服务器。为了让更多用户能简单实用网络转发功能,助手也支持WXPusher/Server酱一键配置。使用方法参考网络转发

操作

在设置面板开启网络转发,点击设置按钮进入配置页面,根据自己的需求配置相应的参数。

我是网络小白,如何使用网络转发功能?

助手支持WXPusher/Server酱来转发信息到微信。您只需在网络转发页面,选择WXPusher/Server酱方式,再填入Key就可以轻松使用了。关注WXPusher微信公众号后即可得到Key,Server酱的Key获取方式请参考 获取SCKEY 。

5.微信转发

操作

在微信转发配置页面右上角获取二维码,微信扫码后绑定微信到当前账号。

6.远程控制功能

使用场景

情形一:某些情况下,备用机不在身边,但此时又需要使用备用机发送短信验证。
情形二:主力机没有安装软件,但又需要获取备用机短信和来电信息。
情形三:多个人都在用备用机作为小号,只需要向备用机发送相应的指令就可以及时获取需要的信息。

操作

举个栗子:小亮身在外地,随身携带主力手机A,他现在要通过手机A控制家中的备用手机B给小凡同学的手机C发送短信“亲爱的,你真漂亮!”。(此处假设A手机号为110,B手机号为119,C手机号为120)

使用短信方式控制(手机B安装双卡助手):

手机A发送短信给手机B,短信内容为“120#亲爱的,你真漂亮!”。(更多操作指令,请参考软件内说明)

使用网络方式控制(手机A和B安装双卡助手且登录同一用户):

a.手机A在首页菜单打开远程短信
b.在短息内容处填写“亲爱的,你真漂亮!”
c.在手机号码处填写120
d.发送方式选择网络控制
e.在设备列表中选择手机B
f.完成以上步骤后点击发送

远程控制安全防护

1.安装双卡助手的备用机默认是不支持远程控制的,如若需要,请前往安全设置->远程防护开启远程短信控制或远程网络控制。
2.设置短信防护号码:设置后备用机只能接收防护号码发来的短信控制,其他号码发来的远程控制短信无效。
3.远程网络控制只接受登录同一用户的设备的控制指令。

12

刘豪亮

12 日志
© 2013 — 2021 Copyright © 2013-2021 cozylife.tech | 豫ICP备19046948号-1