AZ TUTORIALS · 接口参考

AWZ · API 文档

AWZ（爱伪装）通过 HTTP 指令调用，格式为 /cmd?fun=指令名&参数。

AZ 教程汇总站内阅读更新于 2026-11-01

项目	值
手机脚本	`http://127.0.0.1:1688/cmd?`
电脑调用	`http://设备局域网IP:1688/cmd?`
请求方式	`GET`
结果文件	`/var/mobile/iggresult.txt`
参数文件	`/var/mobile/iggparams.txt`
记录名列表	`/var/mobile/iggrecords.txt`

调用前准备

在 AWZ 设置 → 脚本中，打开 「启用 HTTP 脚本指令」。
每次调用任何指令前，都必须先把 AWZ 启动到前台：

lua

runApp("AWZ")
mSleep(3 * 1000)  -- 第一次启动需要联网验证，建议等 3 秒

返回值

指令调用后直接返回 JSON：

json

{"result": 1}

同时也会把结果写入 /var/mobile/iggresult.txt。两者取值相同：

值	含义
`1`	执行完成
`2`	正在执行，还未完成
`3`	一键新机成功，但 IP 地址重复（仅 `newrecord`）
`4`	已到最后一条（仅 `nextrecord`）
`0`	执行出错
`10`	运行环境异常
`100`	产品未激活或已过期

接口一览

功能	指令
一键新机	`newrecord`
下一条记录	`nextrecord`
生效指定记录	`activerecord`
生效第一条 / 最后一条	`activefirstrecord` · `activelastrecord`
禁用 / 取消禁用记录	`disablerecord` · `enablerecord`
删除指定记录	`deleterecord`
清除所有记录	`deleteallrecords`
瘦身指定记录	`thinrecord`
导出指定记录	`exportrecord`
导出所有记录	`exportallrecords`
直接导入记录	`importdirect`
兼容性导入记录	`importcompatible`
导入 NZT 记录	`importnzt`
重命名当前记录	`renamecurrentrecord`
设置 / 清除当前记录坐标	`setcurrentrecordlocation` · `clearcurrentrecordlocation`
获取 / 设置当前记录参数	`getcurrentrecordparam` · `setcurrentrecordparam`
获取所有记录名	`getallrecordnames`
清理 AppStore	`cleanappstore`
卸载选中的应用	`uninstallselectedapp`
按时间排序	`orderbytime` · `orderbytimedesc`

接口详情

以下地址均以手机本机 127.0.0.1 为例，电脑调用请换成设备局域网 IP。

一键新机

GET http://127.0.0.1:1688/cmd?fun=newrecord

生成新机并新建一条记录。返回 3 表示新机成功但 IP 与已有记录重复，可在脚本里决定是否换 IP 后重来。

下一条记录

GET http://127.0.0.1:1688/cmd?fun=nextrecord

切换到下一条记录。返回 4 表示已经是最后一条。

生效指定记录

GET http://127.0.0.1:1688/cmd?fun=activerecord&record=记录ID

参数	必填	说明
`record`	是	记录 ID

生效第一条 / 最后一条

GET http://127.0.0.1:1688/cmd?fun=activefirstrecord
GET http://127.0.0.1:1688/cmd?fun=activelastrecord

禁用 / 取消禁用记录

GET http://127.0.0.1:1688/cmd?fun=disablerecord&record=记录ID
GET http://127.0.0.1:1688/cmd?fun=enablerecord&record=记录ID

参数	必填	说明
`record`	是	记录 ID

删除指定记录

GET http://127.0.0.1:1688/cmd?fun=deleterecord&record=记录ID

清除所有记录

GET http://127.0.0.1:1688/cmd?fun=deleteallrecords

清空全部记录，不可恢复。

瘦身指定记录

GET http://127.0.0.1:1688/cmd?fun=thinrecord&record=记录ID

对指定记录做瘦身处理，减小占用空间。

导出指定记录

GET http://127.0.0.1:1688/cmd?fun=exportrecord&record=记录ID

导出到 /var/mobile/exportdata/。

导出所有记录

GET http://127.0.0.1:1688/cmd?fun=exportallrecords&zip=文件名

参数	必填	说明
`zip`	是	导出的压缩包文件名

导出到 /var/mobile/exportdata/。

直接导入记录

GET http://127.0.0.1:1688/cmd?fun=importdirect

把要导入的记录放在 /var/mobile/importdata/，可以是导出的目录，也可以是导出的 zip 包。

兼容性导入记录

GET http://127.0.0.1:1688/cmd?fun=importcompatible

以兼容模式从 /var/mobile/importdata/ 导入，支持目录或 zip 包。直接导入不成功时可以尝试。

导入 NZT 记录

GET http://127.0.0.1:1688/cmd?fun=importnzt

把 NZT 记录放在 /var/mobile/nztdata/。必须是解开的目录或不加密的 zip 包。

重命名当前记录

GET http://127.0.0.1:1688/cmd?fun=renamecurrentrecord&name=新名称

参数	必填	说明
`name`	是	新名称。中文建议 URL 编码

TIP

重命名后，新名称就成为该记录的 ID，之后 activerecord 等指令要用新名称。

设置 / 清除当前记录坐标

GET http://127.0.0.1:1688/cmd?fun=setcurrentrecordlocation&location=经度_纬度_地名
GET http://127.0.0.1:1688/cmd?fun=clearcurrentrecordlocation

参数	必填	说明
`location`	是	格式 `经度_纬度_地名`，地名可省略，例如 `116.7361382365_39.8887921413_北京老胡同`

获取 / 设置当前记录参数

GET http://127.0.0.1:1688/cmd?fun=getcurrentrecordparam
GET http://127.0.0.1:1688/cmd?fun=setcurrentrecordparam

getcurrentrecordparam：把当前记录参数写入 /var/mobile/iggparams.txt
setcurrentrecordparam：读取 /var/mobile/iggparams.txt 中的参数并应用到当前记录

正确流程：先获取 → 修改文件中的字段 → 再设置。格式见参数文件。

获取所有记录名

GET http://127.0.0.1:1688/cmd?fun=getallrecordnames

记录名列表写入 /var/mobile/iggrecords.txt。

清理 AppStore

GET http://127.0.0.1:1688/cmd?fun=cleanappstore

如果 App 设置里已经打开「清理 AppStore」选项，一键新机后会自动执行，不需要再调用。

卸载选中的应用

GET http://127.0.0.1:1688/cmd?fun=uninstallselectedapp

如果 App 设置里已经打开「卸载应用」选项，一键新机后会自动执行，不需要再调用。

按时间排序

GET http://127.0.0.1:1688/cmd?fun=orderbytime
GET http://127.0.0.1:1688/cmd?fun=orderbytimedesc

orderbytime 按时间正序排列记录列表，orderbytimedesc 按时间倒序排列。

参数文件

路径：/var/mobile/iggparams.txt

每行一个参数，换行符为 chr(10)
参数名和参数值之间用冒号 : 分隔
调用 getcurrentrecordparam 后打开该文件即可看到实际格式

参数名	说明
`RecordID`	记录 ID，如「微信001」
`DeviceName`	设备名称，如「xxxx iPhone」
`SystemVersion`	系统版本号，如「10.3.1」
`IDFA`	IDFA
`IDFV`	IDFV
`62short`	32 位 62 短码
`62long`	344 位 62 全码。设置参数时 `62short` 和 `62long` 填一个即可
`UDID`	设备 UDID
`IMEI`	设备 IMEI
`SerialNum`	设备序列号
`MAC`	MAC 地址
`SSID`	Wi-Fi 名称
`BSSID`	Wi-Fi BSSID
`OpenUDID`	OpenUDID

Lua 示例（触动精灵）

lua

local sz = require("sz")
local http = require("szocket.http")

local BASE = "http://127.0.0.1:1688/cmd?fun="

-- URL 编码（中文名称、地名需要）
function urlEncode(s)
    s = string.gsub(s, "([^%w%.%- ])", function(c)
        return string.format("%%%02X", string.byte(c))
    end)
    return string.gsub(s, " ", "+")
end

-- 调用指令，返回 result 数值；2 = 执行中时自动等待
function AWZ(query)
    local res, code = http.request(BASE .. query)
    if code ~= 200 then return nil end
    local result = sz.json.decode(res).result
    while result == 2 do
        mSleep(1000)
        result = tonumber(readFileString("/var/mobile/iggresult.txt"))
    end
    return result
end

-- 1. 启动 AWZ（所有指令之前必须执行）
runApp("AWZ")
mSleep(3 * 1000)

-- 2. 一键新机，IP 重复时重试
local r = AWZ("newrecord")
if r == 3 then
    toast("IP 重复，请更换 IP 后重试", 2)
elseif r == 100 then
    toast("未激活或已过期", 2)
elseif r ~= 1 then
    toast("新机失败：" .. tostring(r), 2)
end

-- 3. 重命名当前记录（新名称会成为记录 ID）
AWZ("renamecurrentrecord&name=" .. urlEncode("139xxxxxxx吴有财"))

-- 4. 设置坐标
AWZ("setcurrentrecordlocation&location=" .. urlEncode("116.7361382365_39.8887921413_北京老胡同"))

-- 5. 生效指定记录
AWZ("activerecord&record=" .. urlEncode("Wechat001"))

-- 6. 遍历所有记录
AWZ("activefirstrecord")
while true do
    -- ……执行业务……
    if AWZ("nextrecord") == 4 then break end
end

使用教程见 AWZ 使用教程。

提示