触动小精灵开发者平台使用手册

已不更新，最新版请查看：http://www.touchsprite.com/docs/4971
触动小精灵

简介

触动小精灵是触动提供的在线脚本加密打包服务，可以把脚本打包成一个可单独执行的 apk/deb 程序。目的是为了满足广大开发者的定制需求，把脚本包装成个人品牌，同时也使脚本分发更加方便快捷。
触动小精灵支持自定义软件名称、logo、启动图片、Bundle ID（包名）、文件目录等，提供了配套的授权服务和脚本更新服务。
触动小精灵 = 触动精灵 + 脚本，使用触动小精灵无需再安装触动。

触动产品功能对比

• 安卓小精灵有免费版，但不能使用网络模块和高级函数库
  安卓企业版测试期收费：0.1 元/台/年

注意事项

1. 小精灵开发者平台仅适合具备脚本开发能力的开发者使用。如果您打算学习脚本开发，请使用触动精灵，相关学习文档见开发者指南：https://www.zybuluo.com/miniknife/note/509515
2. tsp/p4u 是触动/帮你玩开发者平台在开发者上传脚本压缩包时将脚本在线加密生成的脚本格式。
3. 帮你玩平台脚本上传成功后需要通过官方审核才能在客户端展示供用户搜索下载，必须提供至少 1 个小时的试用时间；用户试用满意后可直接在客户端内购买授权，平台每个月对开发者收入进行结算。

小精灵相关信息

• 触动小精灵开发者平台：http://app.touchsprite.com/
• 触动小精灵问题和意见反馈请加群：298722759
• 小精灵使用说明文档下载 http://pan.baidu.com/s/1kVdFP6R
• TS Remote API 购买地址：http://dev.touchsprite.com/openapi/index
• 小精灵点数充值卡购买地址：http://shop.touchsprite.com/shop/item?id=4

整体使用流程说明

创建小精灵

升级小精灵

收费说明

关于收费

1. 小精灵开发者平台在线加密打包服务完全免费，并允许开发者设置0~8小时的试用时间，当小精灵过期后，需要使用授权码激活，触动仅在生成授权码时收取费用。
2. 触动针对安卓小精灵推出了免费版，无需授权，不限试用时间，提供 3 年使用权限，但在启动页会展示广告。

收费标准

基础版的小精灵月卡授权码单价为 110 点，年卡授权码单价为 500 点，永久卡授权码单价为 990 点。如果您在创建小精灵时勾选了其他增值服务，授权码的价格会随之上涨，具体价格参考“创建小精灵 - 小精灵类型” 相关说明。
备注：由于不同时间小精灵充值点数优惠差异，授权码实际生成价格会低于文中价格。

点数价格

无打折优惠活动的情况下，1 点小精灵为 0.05 元。

创建小精灵

普通版小精灵

进入小精灵开发者平台首页，点击导航栏中的小精灵按钮，进入我的小精灵页面。

在我的小精灵页面，根据需要选择创建iOS或者安卓小精灵。目前，iOS和安卓小精灵仅在小精灵类型上有所不同，其他上传小精灵的步骤基本相同。
下面以创建iOS小精灵为例进行说明，点击创建iOS小精灵，进入填写小精灵详情页面。

在填写小精灵详情页面，依次填写应用桌面名称、程序唯一标识、联系方式、小精灵类型、试用时间、功能介绍。

应用桌面名称

• 小精灵安装到设备后在桌面上显示的名字。
• 仅支持中文、英文和数字，长度限制为最短 2 个字符，最长 13 个字符，一个中文为 2 个字符。
• 一旦创建成功后不可更改。

程序唯一标识

• 小精灵 BundleID/包名为：com.随机字符串.程序唯一标识。
• 必须以英文字母开头，仅支持英文和数字，长度限制为最短 5 个字符，最长 44 个字符。
• 一旦创建成功后不可更改。

联系方式

填写正确的联系方式，方便用户联系您购买授权。

小精灵类型

目前 iOS 小精灵在基础版的基础上还提供了7种增值服务，安卓小精灵在基础版的基础上提供了3种增值服务，而且还特别提供了免费版，无需授权即可使用。

注意事项

• 基础版小精灵月卡授权码单价为 110 点（5.5 元），年卡 500 点（25 元），永久卡为 990 点（49.5 元）
• 当您选择了云打码插件时，当前生成的小精灵月卡授权码单价则为 120 点（6 元），年卡 540 点（27 元），永久卡为 1080 点（54 元）
• 当您选择了云打码+网络插件时，当前生成的小精灵月卡授权码单价则为 150 点（7.5 元），年卡 660 点（33 元），永久卡为 1350 点（67.5 元）
• 当您选择了自定义扩展库类型时，已经包含云打码和网络插件功能，无需勾选前面两种类型
• 小精灵增值插件如需使用 cloudOcr、官方扩展库或任何第三方插件，需将该插件同脚本一同打包上传。
• TSLib 是触动精灵官方提供的函数扩展库，您只需选择小精灵基础版即可正常使用
• 如果您使用了打码库则需要勾选网络插件类型，因为打码是需要联网的哦，调用 TSLib、ts.so、sz 库需要勾选网络插件，TSLib、sz.so 及 ts.so 库已内置无需上传。
• iOS 2.4.5 版本小精灵已支持 webUI 但需勾选网络插件。
• 小精灵类型一旦创建成功后不可更改。

试用时间

必须为 0~8 之间的整数，小精灵试用时间到期后将不能再继续使用，需要通过作者购买授权才能继续使用。

填写完毕后，点击下一步，进入上传小精灵图标页面，按照要求上传应用图标（必填）、启动图像（选填）。

自定义应用图标

• 必须上传符合尺寸和格式要求的图片
• 一旦创建成功后不可更改

启动图像

• 可以不上传或只上传一种尺寸的图片
• 生成小精灵时将缺少的启动图像默认设置为空白图片
• 一旦创建成功后不可更改

上传完图标和启动图后，点击下一步，进入上传小精灵代码页面，填写版本号信息，上传脚本文件，点击提交打包，等待打包完成。

上传脚本压缩包

• 必须包含一个名为 main.lua 的脚本主文件。
• 脚本工程所需的资源文件（包括图片、文本、音频、插件、扩展库文件等）。
• 压缩包必须为 zip 格式。
• 压缩包大小不能超过 10 M。

免费版小精灵

目前仅有安卓系统支持免费小精灵。在我的小精灵页面，点击创建安卓小精灵，进入安卓小精灵详情填写页面，勾选免费版小精灵类型，勾选后不可再勾选其他类型，且不可再输入试用时间，其他步骤说明可参考普通版小精灵。

安装使用小精灵

触动小精灵同触动其他产品一样，都需要越狱/root权限才能使用，安卓小精灵还需要开启系统悬浮窗权限。

下载安装

deb 格式的小精灵有以下几种安装方法：

• 将 deb 安装包放到 Cydia 安装目录（/var/root/Media/Cydia/AutoInstall），将手机重启两次
• 将 deb 安装包放到任意文件目录，在手机上安装 iFile，点击进行安装
  视频教程：
  https://zybuluo.com/lisaisacat/note/585252#用-ifile-安装-deb-插件
  图文教程：
  https://www.zybuluo.com/lisaisacat/note/324664#越狱设备安装deb格式文件的方法
• 将 deb 安装包上传到源（如威锋源），添加源在线安装。

apk 格式的小精灵和其他安卓程序一样直接安装即可。

资源、日志路径

在小精灵程序的授权页面底部可以查看小精灵的资源和日志路径（免费小精灵的路径信息在更多页面）

• iOS小精灵的路径是 /private/var/mobile/Media/程序唯一标识/
• 安卓小精灵的路径是 /mnt/sdcard/程序唯一标识/

程序安装路径

• iOS 小精灵路径：/Applications/小精灵唯一标识.app
• 安卓路径与设备系统有关，一般是在 data 目录下

启动脚本

运行脚本有三种方式：

1. 按音量“-”键。
2. 点击悬浮窗的运行按钮。
3. 在小精灵详情页面底部点击启动应用按钮。

常见问题

iOS运行脚本没效果/不点击/没有图标

• iOS 小精灵的此类问题解决办法与触动精灵 iOS 完全一致。
• 如果您是使用 AutoInstall 的安装方式安装 iOS 小精灵，请确保您重启设备 2 次以上。由于 AutoInstall 这种安装方式会导致很多问题，比如点击失效、没有图标等，强烈建议您将 iOS 小精灵上传到第三方源使用 Cydia 在线安装。
• 查看您的 Cydia变更界面是否有必备插件需要升级，如果有，请升级后重启设备或重新安装小精灵再试。
• 查看您的 Cydia 已安装列表，是否存在和触动精灵 iOS 冲突的插件（参考附录），如果有，请卸载后重启设备或重新安装小精灵再试。

安卓运行脚本不弹出showUI/dialog

• 安卓小精灵的此类问题解决办法与触动精灵安卓版完全一致。
• 部分安卓系统需要打开系统悬浮窗权限才能显示 showUI/dialog。

安卓小精灵开启系统悬浮窗权限

安装多个小精灵

• 同时安装多个小精灵不会互相冲突
• 默认音量键和悬浮窗运行的是最后安装或打开的那一个

小精灵管理

登录触动小精灵开发者平台，点击导航栏的小精灵按钮，进入我的小精灵页面，可查看到您已创建的小精灵列表，在小精灵对应的操作列可以对小精灵进行管理。

小精灵版本升级

未更新打包服务或引擎版本

1. 可直接点击升级按钮，进入升级版本页面，填写版本号、更新日志，上传升级的脚本文件，点击提交打包。
2. 等待打包成功后，已安装了该小精灵的用户再次打开应用时会看到升级日志和通知。
3. 如果用户不小心关掉了提示，也可以在设置页面点击检测更新检查是否有新版本进行更新。

打包服务或引擎版本已更新

仍然可以直接点击升级按钮上传新版本，但用户不可立即在小精灵客户端直接检测更新，需要您将安装包下载到本地，并更新到您的源，用户即可直接更新。

版本列表

小精灵版本列表可查看对应小精灵的所有版本，并可设置某一版本为缺省版本，且可删除非缺省版本。

下载

下载小精灵到本地，进行安装。

详细信息

点击详细信息按钮，进入小精灵详情页面，可查看小精灵的详细信息（包名、类型、试用时间等），并可修改小精灵或者删除小精灵.

Bundle ID/package name

删除小精灵

小精灵一旦删除，所有的授权和设备记录都会被清空，已经生成尚未激活的授权码会自动回收到开发者账户余额。

查看设备

查看下载过该小精灵的设备信息，具体操作见“设备管理”。

查看授权码

查看该小精灵的授权码，具体操作见“授权管理”。

授权管理

小精灵客户端就相当于定制版触动精灵客户端，其中的脚本相当于 TSP 脚本，小精灵授权与触动精灵 TSP 授权机制相同，不同设备需要分别授权（安卓免费小精灵除外），在试用时间到期后需要用户输入授权码进行激活。

生成授权码

进入授权管理页面后，点击生成授权码，进入授权码生成页面，选择要生成授权码的小精灵、依次输入要生成授权码的类型以及张数，目前有三种授权码类型：月卡、年卡和终生卡。

生成授权码需要开发者支付一定费用，开发者可在淘宝店购买充值卡增加开发者账户内的点数，具体充值方法请看“充值卡充值”。
生成授权码是 0.0.5 元/点（基础版月卡是 5.5 元，年卡是 25 元，永久卡是 49.5 元），在触动商城购买点数更是有半价优惠的呦！

激活授权

激活小精灵授权有两种方式：

1.把生成的授权码直接发送给用户，用户直接在小精灵内激活授权即可。
2. 鼠标悬停在授权码上，可查看授权码的二维码，直接用小精灵扫描二维码即可授权。

批量回收

选择要回收的授权码，点击批量回收，即可回收授权码。

注意事项

• 如果是月卡或年卡授权码，在授权码激活的 48 小时内，您可以在开发者平台的授权管理页面回收授权码。
• 授权码的剩余点数会自动加入您的余额并且在下次生成授权码时优先扣除余额点数。
• 未使用的永久卡卡可以进行回收。

48小时内回收扣点计算公式

以基础版月卡为例
激活 24 小时内：回收点数 = 110 - 110点/30*1
激活时间超过 24 小时，不超过48小时：回收点数 = 110 - 110/30*2

查询结果导出

将查询结果导出为 excel 文件。

设备管理

关于设备号

iOS 小精灵的设备号没有计算电池序列号，与触动精灵/企业版设备号不一致的情况是正常的。

设备列表

查看下载过小精灵的所有设备信息，鼠标悬停在设备信息上方，可进行加入黑名单、更换绑定操作。

加入黑名单

将指定设备加入黑名单，黑名单中的设备将不能再使用该开发者账号下的任何小精灵。

更换绑定

点击更换绑定按钮，在弹出框输入用户的新设备号，将授权码与新设备绑定，旧设备的授权码失效，不能再继续运行小精灵。

注意事项

• 所有类型的授权都支持换绑。
• 每个授权码 30 天内仅可进行一次换绑操作。

黑名单列表

查看已加入黑名单的设备列表，并可把设备移出黑名单。

订单管理

查看生成授权码的订单列表，可复制订单号、导出授权码、查看授权码详细信息等。

充值卡充值

1. 在触动商城购买充值卡，收到充值卡号
2. 打开小精灵开发者平台，进入充值页面
3. 在页面内粘贴输入从旺旺复制的充值卡号，确认无误后确定即可
   在触动商城购买可以半价优惠！

其他问题

为什么我修改了小精灵描述，小精灵客户端没有更新？

由于服务刷新机制问题，客户端上的小精灵详情不会立即刷新，请耐心等待半个小时左右再试。

打包时显示的触动精灵引擎版本是什么？和小精灵的版本一样吗？

不一样。引擎版本是指小精灵打包时使用的触动精灵服务版本号，即使用 getTSVersion 函数获取到的版本号。
而小精灵版本号是您创建或升级小精灵脚本时设置的版本号。

打包页面报错“打包失败”，怎么办？

首先，请检查您的开发者名字中是否包含空格，如果包含空格，请在小精灵反馈群中联系管理员为您修改用户名。
如果您的开发者名字中不包含空格，请在 触动小精灵用户群 内留言反馈。

小精灵和触动精灵、触动企业版、帮你玩可以同时安装吗？

可以。如果您觉得音量键弹出多个窗口不太方便，可以在使用其中一个软件时将其他软件的服务关掉。

运行 iOS 小精灵提示 TSP 脚本验证失败(0)!

出现这样问题的解决方案如下
- 网络问题。请确保设备处于联网状态, 查看 /Applications/小精灵名.app/ 路径下是否存在文件 desc2_bk.png，如果不存在，说明与脚本验证服务器通讯失败。
1. 请尝试更换网络。
2. 请尝试修改 DNS 为 223.5.5.5 和 223.6.6.6
3. 请尝试重启服务（音量+）
- 时间设置问题。可能是由于时间与当前不匹配，请尝试设置-通用-日期与时间-将自动设置时间打开。

小精灵内容包含违法内容，该如何举报？

对于包含赌博等违法内容的脚本，触动一旦核实，会对开发者账号进行封禁处理。请将涉嫌违规的小精灵截图（包含运行界面、设置界面开发者名字和联系方式）、小精灵安装包，发送到 support@touchsprite.com。

附录

已知与触动精灵/帮你玩/小精灵/企业版 iOS 冲突的插件列表

如果您安装了以下插件导致服务使用异常，请在Cydia 中卸载该插件后重新安装客户端。

Stashing/内存修正插件

会导致帮你玩无法注册和登录账号，提示文件获取失败

StatusHUD2 插件

会导致触动精灵脚本 showUI 无法弹出。

FakeGPS Pro

会导致触动精灵点击失效或服务无法启动

CCSettings

会导致触动精灵脚本 showUI 无法弹出

协奏助手

会导致触动精灵点击失效

按键精灵iOS

会导致 showUI 弹出后点击【取消】【确定】按钮无反应

xxplugin - coc/cok等

会导致触动精灵点击失效或服务无法启动

XY苹果助手

会导致触动精灵点击失效或服务无法启动