HideMyAndroid Headless API

系统要求

Headless API 让您无需任何应用界面，即可通过 ADB 或任意自动化工具完全控制 HideMyAndroid。此为 高级版 专属功能。

• 高级账户 — Headless API 仅限高级版使用。
• 应用版本 1.2.8 或更高。 此后新增的内容都是额外字段或方法，因此 1.2.8 仍可正常使用 — 但较新的部分需要较新的版本：hook_spoof_uptime 需要 1.3.4+，geo 与 profile.duplicate 需要 1.4.5+，整个备份/恢复方法组需要 1.5.3+，SIM & 设备生成器（simCountries、deviceTemplate、sim.countries、device.templates）需要 1.5.9+，hook_sensor_gyroscope 需要 1.6.3+，而 hook_sensor_light 需要 1.6.4+。旧版本会忽略它无法识别的字段，并且依然返回 ok=true — 但无法识别的方法动静更大：在 1.5.3 之前的版本上调用备份/恢复方法组，或在 1.5.9 之前的版本上调用 sim.countries / device.templates，都会返回 BAD_REQUEST，且 error_message 为 “Unknown method: …”。如果某项设置似乎毫无作用，请通过 status 查看当前运行的 version — 正式打包的发行版会如实上报版本号，而在版本号提升之前自行编译的构建可能已包含某项功能，却仍报告旧版本号。
• Root + LSPosed — 与 HideMyAndroid 所需的配置相同。请参阅 安装指南。
• ADB 已连接至设备（adb devices 可列出已连接设备）。
• 设备已联网 — 仅在启用代理时需要（会进行实时检测）。

⚠️ 只有使用代理的配置文件才需要 VPN 权限。无界面模式无法弹出系统的 VPN 授权对话框，因此请先在应用的 Headless API 界面授权一次。若未授权，激活带代理的配置文件仍会激活该配置文件，但代理不会连接，调用会返回 INTERNAL 并说明此情况。

身份认证

在应用中打开 设置 → 开发者 → Headless API，然后开启 启用。系统会自动生成一个密钥 — 点击 复制。每个请求都需要将此密钥作为 token 参数传入。

请妥善保管密钥 — 任何拥有该密钥且能访问 ADB 的人都可以控制您的配置文件。重新生成 将生成新密钥（旧密钥立即失效）；退出登录将清除密钥。

在本文档中，请将 <your_access_token> 替换为您的密钥，将 <profile_id> 替换为 profile.create 返回的 id。

发起请求

共有两种传输方式，根据值中是否包含冒号 : 来选择

content call 会在冒号处分割每个 --extra 参数，因此无法传递 JSON — 这也是 JSON 值需要通过广播发送的原因。

只有三个方法提供 broadcast 形式：HEADLESS_UPDATE（profile.update）、HEADLESS_SET_ACTIVE 和 HEADLESS_DEACTIVATE。其余十七个 — status、所有读取操作（包括 sim.countries 与 device.templates）、profile.create、profile.duplicate、profile.delete、目标应用相关调用以及整个备份/恢复方法组 — 仅支持 content call。不存在 HEADLESS_CREATE，也不存在 HEADLESS_BACKUP，无需去找。

broadcast 并非只能传 JSON。HEADLESS_UPDATE 恰好转发九个 extra 参数 — name、hookFlags、proxy、geo、deviceMock、sim、gmails，以及自 1.5.9 起的 simCountries 与 deviceTemplate — 因此 name、gmails 与 simCountries 通过两种传输方式都可以发送。上方表格说明的是哪种方式更方便，而非哪种方式可行。凡是不在这九个之列的 extra 参数，都会被直接丢弃且不报错。

响应说明。 成功时返回 ok=true（content call）或 result=0（广播）；失败时会附加 error_code 和 error_message。请参阅 错误代码。每个方法都需要传入 token。点击下方任意操作可展开其参数、请求与响应详情。

状态

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>

Bundle[{data={"premium":true,"featureEnabled":true,"freshnessOk":true,"activeProfileId":"a1b2c3d4-...","version":"1.5.9"}, ok=true}]

💡 status 是许可证过期或过时后唯一仍会响应的方法 — 其余所有调用都只会返回 LICENSE_EXPIRED 或 LICENSE_STALE。因此当请求被拒绝时，正是通过它来区分这两种情况：查看 premium 判断高级版是否真的到期，查看 freshnessOk 判断是否只需打开一次应用即可。status 仍然受 FEATURE_DISABLED 与 UNAUTHORIZED 限制，因此功能未启用或令牌错误在这里的表现与别处一致。

配置文件

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.list --extra token:s:<your_access_token>

Bundle[{data=[{"id":"a1b2...","name":"Demo","isActive":true,"createdAt":1717000000000,"updatedAt":1717000500000}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"id":"a1b2...","name":"Demo","isActive":false,"hookFlags":{"hook_wifi":true,...},"proxy":{"enabled":false,...},"geo":{"source":"PROXY",...},"deviceMock":{"enabled":false,...},"sim":{"enabled":false,"simCards":[]},"gmails":[],"targetApps":["com.whatsapp"]}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

Bundle[{data={"id":"a1b2c3d4-..."}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"id":"e5f6a7b8-...","name":"Brave Falcon 42"}, ok=true}]

副本会保留哪些内容

以与应用内「复制」菜单相同的方式克隆配置文件 — 需要应用 1.4.5+。各项设置会被保留，但每一个身份标识值都会重新生成，因此副本拥有自己的指纹，而不是原配置文件的孪生体。本方法没有 broadcast 形式：发送后不管的广播无法把新 id 交还给您，而这正是该调用的意义所在。

若想使用自定义名称，请先复制，再通过第二次调用重命名：

# 1. duplicate — the new id and its generated name come back together
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<source_profile_id>

# 2. rename the copy — profile.duplicate never takes a name of your own
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<new_profile_id> --extra name:s:"My Profile"

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra name:s:"My Profile"

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e hookFlags '{"hook_wifi":false,"hook_nearby_bluetooth":false}'

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.delete --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={}, ok=true}]

激活

配置文件只有在激活状态下才会执行伪装，并且同一时间只会有一个配置文件处于激活状态。profile.setActive 会直接切换当前激活的配置文件 — 之前处于激活状态的那个会被自动停用，因此无需事先调用 profile.deactivate。

⚠️ 激活会清除目标应用的数据。 profile.setActive 不只是重启它们：它会强制停止每个目标应用并清除其数据，使其以全新状态启动，从而真正应用新的身份。这是有意为之 — 但这也意味着这些应用内的一切都会消失，包括已登录的会话，在应用内，同样的操作会先请求确认并提示您使用备份功能；而无界面调用不会弹出任何对话框，命令会直接执行 — 因此本提示就是您能得到的唯一警告。在无界面模式下，切换前的安全网是先调用 backup.start（1.5.3+）。另外自 1.5.3 起，当备份/恢复任务仍占用着执行槽位时，profile.setActive 与 profile.deactivate 会返回 BUSY — 即便是已取消的任务也一样；请持续重试，直到不再返回 BUSY。

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_SET_ACTIVE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id>

Bundle[{data={"id":"a1b2...","isActive":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.deactivate --extra token:s:<your_access_token>

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_DEACTIVATE -p com.wowsoftware.hidemyandroid -e token <your_access_token>

Bundle[{data={}, ok=true}]

content call 是推荐使用的方式：它是同步的，并会打印返回的 Bundle。HEADLESS_SET_ACTIVE 和 HEADLESS_DEACTIVATE 广播可在 Tasker 等自动化工具中完成同样的工作。它们以 ordered broadcast 方式响应，始终会回传数据：成功时 am broadcast 打印 result=0，并在 data="…" 中带回结果 JSON；失败时打印 result=1 与 data="{"error_code":…,"error_message":…}"。因此它们并非严格意义上的「发送后不管」 — 只要解析 data=，就能得到与 content call 相同的返回结果。HEADLESS_SET_ACTIVE 接受 -e id 或 -e profile_id 两种形式传入配置文件 id；HEADLESS_DEACTIVATE 则完全不需要 id。与往常一样，请务必加上 -p com.wowsoftware.hidemyandroid。

目标应用

目标应用是配置文件将要伪装的应用程序。

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.getApps --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data=[{"packageName":"com.whatsapp"}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

Bundle[{data=[{"packageName":"com.whatsapp"}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.removeApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

Bundle[{data=[], ok=true}]

备份与恢复

1.5.3 新增。这组方法可将配置文件中的应用数据复制为设备上的归档文件，并在日后恢复回去 — 与应用内 Manage Backups 的功能相同，只是没有界面。全部六个方法都仅支持 content call（没有 broadcast 形式），并且两个 *.start 调用是异步的：它们会立即返回一个 jobId，然后在后台继续工作 — 请轮询 backup.job 跟踪进度。备份单个应用就可能需要数分钟。

⚠️ 同一时间只能运行一个任务。在任务运行期间再次调用 *.start 会返回 BUSY，并在 error_message 中给出正在运行的 jobId。此外，两个 *.start 调用要求目标配置文件处于激活状态 — 否则返回 REQUIRES_ACTIVE_PROFILE，且没有任何绕过开关。其余四个方法对任意配置文件均可使用。并且与 Headless API 的其他地方一样，任何调用都不会请求确认 — 命令会直接执行。

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<profile_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packages:s:com.twitter.android,com.facebook.katana

Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","total":2,"packages":["com.twitter.android","com.facebook.katana"],"foregroundHeld":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method restore.start --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"jobId":"09a8b7c6-...","type":"restore","total":1,"packages":["com.twitter.android"],"foregroundHeld":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token> --extra jobId:s:<job_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token>

# while it runs
Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","profileId":"a1b2...","state":"RUNNING","total":2,"done":0,"ok":0,"failed":0,"currentPackage":"com.twitter.android","currentComponent":"Internal Data","progress":0.31,"results":[],"error":null,"foregroundHeld":true,"startedAt":1712345678901,"finishedAt":null}, ok=true}]

# when it finishes — note: DONE even though one app failed
Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","profileId":"a1b2...","state":"DONE","total":2,"done":2,"ok":1,"failed":1,"currentPackage":null,"currentComponent":null,"progress":1.0,"results":[{"packageName":"com.twitter.android","ok":true,"error":null},{"packageName":"com.facebook.katana","ok":false,"error":"tar exited 2"}],"error":null,"foregroundHeld":true,"startedAt":1712345678901,"finishedAt":1712345699999}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.cancel --extra token:s:<your_access_token> --extra jobId:s:<job_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.list --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data=[{"packageName":"com.twitter.android","appName":"X","timestamp":1712345678901,"totalSize":12345678,"components":["INTERNAL_DATA","EXTERNAL_DATA","OBB"]}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.delete --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.twitter.android

Bundle[{data={}, ok=true}]

任务的运行机制

• DONE 并不代表每个应用都成功。它只表示任务执行到了最后。即便某个应用失败，任务仍可能以 DONE 结束 — 请务必读取 failed 和 results[]。
• 激活现在会等待任务。当任务占用着执行槽位时，profile.setActive、profile.deactivate 和 profile.delete 都会返回 BUSY — 即便是您已经取消的任务也一样，因为底层的 root tar 无法在文件中途被停止，而且快照中没有任何字段会报告槽位状态。以 DONE 或 FAILED 自然结束的任务几乎会立即释放槽位；取消之后，请勿把 CANCELLED 当作「槽位已空」— 只需重试该调用，直到不再返回 BUSY。
• foregroundHeld 是一项观测值，而非承诺。它报告的是是否有前台服务在保护任务不被系统杀死。在 API 36 上实测为 true，但即便是 true 也只说明服务启动请求被接受了 — 后续将其提升为前台的步骤在某些设备上仍可能静默失败。对于耗时较长的任务，请保持设备唤醒，而不要依赖此字段。
• 备份的存储位置。/sdcard/HideMyAndroid_Backups/<packageName>-<profileId>/ — 每个应用在每个配置文件下各有一个文件夹，其中存放 .tar.gz 归档（data.tar.gz、data_ext.tar.gz、media.tar.gz 等）以及 metadata.json，均由 root tar 写入。正是 {package}-{profileId} 这一键值使得恢复只能在同一配置文件内进行。通过无界面方式创建的备份同样会出现在应用的 Manage Backups 界面中。

从内置数据库生成 SIM 与设备

1.5.9 新增。下方的配置章节说明了如何逐字段手写 sim 或 deviceMock 块。这组方法让您可以省去这一步：profile.update 新增的两个键 — simCountries 与 deviceTemplate — 会让应用从其自身界面所使用的同一套运营商与设备数据库中生成整个块，另有两个读取方法可列出它能据以生成的内容。结果会以已设置 enabled:true 的状态保存到配置文件中，因此无需再发送任何其他内容 — 通过 profile.get 即可读回。

⚠️ 每项设置在每次调用中只能使用一种方式。在同一请求中同时发送 sim 与 simCountries 会返回 BAD_REQUEST，deviceMock 与 deviceTemplate 同时发送也是如此。跨设置混用则没有问题 — 例如 simCountries 搭配手写的 deviceMock，或像下方第一个示例那样同时使用两个生成器。该调用是原子的：所有内容都会先经过校验再保存，因此一个错误的模板 id 会让整个请求失败，随之发送的 simCountries 也不会被应用。

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method sim.countries --extra token:s:<your_access_token>

Bundle[{data=[{"code":"AF","country":"Afghanistan"},{"code":"AL","country":"Albania"},...,{"code":"GB","country":"United Kingdom"},...,{"code":"US","country":"United States"},...], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method device.templates --extra token:s:<your_access_token>

Bundle[{data=[{"id":"asus|ASUS_AI2401|AI2401_A","manufacturer":"asus","label":"ROG Phone 8","isCustom":false},...,{"id":"custom:samsung|e3qxeea|SM-S928B","manufacturer":"samsung","label":"Galaxy S24 Ultra","isCustom":true}], ok=true}]

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US"]'

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'deviceTemplate:s:asus|ASUS_AI2401|AI2401_A'

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceTemplate 'custom:samsung|e3qxeea|SM-S928B'

simCountries

• 格式。由 ISO 3166-1 alpha-2 代码组成的 JSON 数组 — ["US","GB"]，不区分大小写。位置即卡槽：第一个代码填入卡槽 0，第二个填入卡槽 1。凡是不是 JSON 数组、空数组、含空白条目、超过两个条目，或包含 sim.countries 未列出的代码，都会返回 BAD_REQUEST — 第三个代码会被拒绝，绝不会像第三张 sim 卡那样被静默丢弃。
• 您会得到什么。应用会为每个卡槽从数据库中挑选该国家的一家运营商，并填满手写 sim 块的每一个字段：carrierName、countryIso、mcc、mnc、operatorCode、一个带该国拨号前缀的有效 E.164 手机 phoneNumber（US 为 +1…）、以该运营商 MCC+MNC 为前缀的 iccid 与 imsi，以及从 LTE、NR 5G、WCDMA 和 GSM 中随机选取的 networkType。随后它会将 sim.enabled 设为 true 并保存。
• 它会替换整个 SIM 块。与 sim 一样，结果会被规范化为两张卡：["US"] 填入卡槽 0，并让卡槽 1 留空 — 无论此前里面是什么。

deviceTemplate

• random（或空字符串）— 应用会从它所知的全部模板中随机选取一个，内置与已导入的一视同仁。请注意「空」与「缺失」的区别：-e deviceTemplate "" 表示随机，而完全不带该键则不会改动设备。
• 模板 id，取自 device.templates — 每次都是同一台设备。内置 id 的格式为 brand|product|model，如 asus|ASUS_AI2401|AI2401_A；您在应用中导入的模板具有相同的形式，只是前面加上 custom:，如 custom:samsung|e3qxeea|SM-S928B。不在列表中的 id 会返回 BAD_REQUEST。
• 您会得到什么。deviceMock 的每个字段都会根据模板填充，deviceMock.enabled 被设为 true，并保存配置文件。

使用哪种传输方式

通常的冒号规则同样适用。sim.countries、device.templates、simCountries 与内置模板 id 都不含 :，因此可以通过 content call 传递。只要值中包含 |、[、] 或 "，就必须用单引号括起来 — 也就是每一个 simCountries 数组和每一个模板 id。不加引号时，设备 shell 会把 | 当作管道符，在 content 尚未运行前就已失败（sh: e3qxeea: not found，exit 127）。custom id 以 custom: 开头，这个额外的冒号会破坏 --extra 的 key:type:value 形式：content 工具本身会以 [ERROR] Binding not well formed 拒绝它，请求根本到不了应用 — 也就没有 BAD_REQUEST 可捕获。请通过 HEADLESS_UPDATE 广播发送 custom id；调用的其他部分无需任何改动。

配置

以下是通过 profile.update 发送的配置值。创建配置文件时的默认值：

⚠️ 包含 enabled:false 的配置将被 保存但不生效 — 值会被保存以便日后启用，但在 enabled:true 之前不会执行任何伪装。geo 是个例外：它没有 enabled 开关。只要 geo 能解析出可用的位置，hook_geo_* 标志就会生效 — 来源可以是 source: CUSTOM，也可以是已设置 enabled:true 且通过实时检测的代理。

hookFlags

默认：除 hook_spoof_uptime 为关闭外，其余标志全部开启。 格式为 "flag": true|false 的映射表。一次更新会 替换整个映射表，但仅限于您实际发送的那份映射表：完全不带 hookFlags 参数的更新不会改动任何标志。在您发送的映射表内，每个未填写的标志都会恢复为各自的默认值，因此其余 22 个会恢复为开启，而 hook_spoof_uptime 即便您之前已将其开启，也会恢复为关闭。若只想修改部分标志并保留其余设置，请先执行 profile.get 获取完整映射，编辑后再整体发送。

proxy

默认：关闭。 启用 enabled:true 后，应用将通过代理建立真实连接，读取其位置信息，并填充 countryCode/lat/lon/timezone。实时检测最长耗时约 8 秒；检测失败的代理将返回 PROXY_INVALID 且不会被保存。这四个字段是 输出字段 — 由应用写入，因此您在其中发送的任何内容都会被覆盖。若要手动设置位置，请改用 geo 的 source: CUSTOM；该方式完全不需要代理。profile.get 会返回包含这四个字段的代理配置，但绝不会回显 username 或 password。

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'

geo

默认值：{"source":"PROXY"}。需要应用 1.4.5+。 配置文件的位置信息由此而来，共有两个来源 — 通过 source 选择其一。PROXY 使用代理实时检测时读取到的位置。CUSTOM 允许您自行设置坐标、时区和地区，完全不需要代理 — 因此您可以把配置文件放在东京，而流量走向任意位置，或者根本不走代理。随后三个 hook_geo_* 标志会分别独立控制各个部分：GPS、地区 + 语言、时区。

⚠️ 请注意字段名称的差异：geo 中使用 latitude/longitude，而上方 proxy 中使用简写的 lat/lon。这是两个彼此独立的对象，并非同义别名 — 在 geo 数据中使用简写名称会被直接忽略。

⚠️ source: CUSTOM 必须完整提供：一组不为 0/0 且在有效范围内的坐标、两位字母的 countryCode，以及 timezone。缺少任意一项都会返回 BAD_REQUEST — 它不会回退到代理。应用绝不会进行地理编码，也不会联网替您填充这些字段。若两个来源最终都不可用，则不会加载任何地理位置 Hook，真实位置将会暴露。

🛑 timezone 是唯一没有被真正校验的字段。 它只检查是否为空，从不与 IANA 数据库比对。像 Asia/Tokyoo 这样的拼写错误会被接受、返回 ok=true、并由 profile.get 原样回显，然后在设备上悄悄变成 GMT。整个链路中没有任何地方会报错，因此请精确复制名称。坐标则恰恰相反 — 它们确实会做范围校验，取值错误会立刻以 BAD_REQUEST 失败。

CUSTOM — 手动设置位置，无需代理

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

PROXY — 使用代理提供的位置（默认）

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"PROXY"}'

deviceMock

默认：关闭。 模拟设备为其他型号。设置 "enabled":true 并填写以下任意字段 — 所有字段均为可选字符串（默认为空），每个字段对应一个 Android Build 属性。在 1.5.9+ 上，您可以完全跳过此块，改为发送 deviceTemplate — random 会从应用自带的数据库中随机抽取一台设备，而来自 device.templates 的 id 则指定某一台 — 应用会填充每一个字段并替您启用。

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

或者，在 1.5.9+ 上，让应用从其数据库中随机抽取一台设备 — 完全不需要 JSON（random 会同时从内置模板和导入的模板中抽取；把它换成来自 device.templates 的 id 即可指定某一台设备）：

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

sim

默认：关闭。 伪装 SIM 卡/运营商信息。设置 "enabled":true 并在 simCards 中提供最多两张 SIM 卡信息。该列表始终会被规范化为恰好两张：第三张会被静默丢弃 — 请求仍会返回 ok=true — 而只提供一张时会补上一张空白卡，因此 profile.get 始终返回两张。在 1.5.9+ 上，您可以完全跳过此块，改为发送 simCountries — 应用会为每个卡槽生成真实的运营商数据并替您启用。每张 SIM 卡包含以下字段：

networkType 会先去除首尾空格再进行不区分大小写的匹配，并且每个网络世代都接受多种写法：

⚠️ 凡是不在此表中的值都会静默关闭该卡的网络类型伪装 — 没有错误，也没有 BAD_REQUEST，该值只会被保存却从不使用。请注意 NR 5G 中间有一个空格：NR5G 无法被识别，正好会掉进这个静默的坑里。

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G"}]}'

或者，在 1.5.9+ 上，让应用根据国家代码生成两张卡 — 完全不需要 JSON（卡槽 0 取第一个代码，卡槽 1 取第二个；只给一个代码则只填充卡槽 0）：

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US","GB"]'

gmails

默认：空。 虚拟 Google 账号列表 — 仅接受 @gmail.com 地址。新列表将覆盖旧列表；[] 可清空列表。由于不含 :，可直接使用 content call：

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

完整示例

从零开始到激活，一步一步地建立一个配置文件。第 5、6、7 步各自提供了几种殊途同归的做法 — 每一步只需选一种；通过标签页在它们之间切换。每条命令都以 adb shell 形式给出。最后，两份配方把整个流程浓缩成一个可直接复制运行的代码块，而常见问题中还有同样内容的设备端脚本版本。

流程一览

1. 01 检查 API 是否就绪
2. 02 创建配置文件
3. 03 添加目标应用
4. 04 添加虚拟 Gmail 账号
5. 05 选择设备身份
6. 06 选择 SIM 卡
7. 07 网络与位置
8. 08 调整 hook 标志
9. 09 备份即将被替换的配置文件
10. 10 激活
11. 11 验证
12. 12 之后：克隆、停止、删除

下文使用的占位符

• <your_access_token> — 来自 设置 → 开发者 → Headless API 的密钥
• <profile_id> — 第 2 步返回的 id
• <active_profile_id> / <job_id> — 仅用于第 9 步，分别来自 status 与 backup.start

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# expect  "premium":true, "featureEnabled":true, "freshnessOk":true
# anything else: fix that first — see Status and Error codes above

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo
# → Bundle[{data={"id":"a1b2c3d4-..."}, ok=true}]
# copy that id — it is <profile_id> in every command below

# one call per app — the package name, not the display name
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.instagram.android

# check the list (adding the same package twice returns BAD_REQUEST)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.getApps --extra token:s:<your_access_token> --extra id:s:<profile_id>

# @gmail.com only; the list replaces the previous one, [] clears it
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

# 1.5.9+ — one call, no JSON: the app rolls a device from its database
# (built-in and imported templates alike) and switches deviceMock on for you
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

# 1.5.9+ — first see what is available; "id" is what you send back
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method device.templates --extra token:s:<your_access_token>
# → [{"id":"asus|ASUS_AI2401|AI2401_A","manufacturer":"asus","label":"ROG Phone 8","isCustom":false}, ...]

# built-in id → content call works — single quotes are REQUIRED, | is a shell pipe
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'deviceTemplate:s:asus|ASUS_AI2401|AI2401_A'

# imported (custom:) id → broadcast ONLY; the extra colon breaks content call
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceTemplate 'custom:samsung|e3qxeea|SM-S928B'

# any version — write every Build field yourself; "enabled":true is the switch
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

# 1.5.9+ — see which countries the generator knows ("code" is what you send)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method sim.countries --extra token:s:<your_access_token>
# → [{"code":"AF","country":"Afghanistan"}, ..., {"code":"GB","country":"United Kingdom"}, ..., {"code":"US","country":"United States"}, ...]

# two cards: slot 0 = US, slot 1 = GB — carrier, number, ICCID, IMSI all generated
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US","GB"]'

# or a single card — slot 1 is left empty
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US"]'

# any version — two cards, every field yourself; a third card is dropped silently
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'

# 1.5.9+ — device (step 5) and SIM (step 6) in ONE broadcast: validated together, saved together
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

# the proxy is tested live (device needs internet, up to ~8s);
# one that fails returns PROXY_INVALID and is not saved
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
# with auth: add "username":"…","password":"…" — never echoed back by profile.get

# location follows the proxy by default; this line only matters if geo was CUSTOM before
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"PROXY"}'

# no proxy at all — the location is yours; coordinates, countryCode and timezone are all required
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'
# timezone is NOT validated: a typo silently becomes GMT — copy the IANA name exactly

# traffic through the proxy, GPS / timezone / locale from your own values —
# a deliberate mismatch (IP in one country, GPS in another); geo.source decides what the hooks use
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

# every flag is already ON (except hook_spoof_uptime), so most profiles skip this step.
# an update REPLACES the whole map — read it first, then send it back complete:
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

# example: Wi-Fi + Bluetooth spoofing off, uptime spoofing on, everything else at its default
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e hookFlags '{"hook_hide_dev_opts":true,"hook_hide_vpn":true,"hook_hide_airplane_mode":true,"hook_hide_proxy":true,"hook_hide_root":true,"hook_hide_lsposed":true,"hook_spoof_installer":true,"hook_package_info":true,"hook_lan_scan_block":true,"hook_identifiers_partly":true,"hook_identifiers_fully":true,"hook_wifi":false,"hook_nearby_wifi":true,"hook_nearby_bluetooth":false,"hook_realistic_sensor":true,"hook_sensor_accelerometer":true,"hook_sensor_gyroscope":true,"hook_sensor_light":true,"hook_spoof_uptime":true,"hook_virtual_accounts":true,"hook_geo_gps":true,"hook_geo_locale":true,"hook_geo_timezone":true}'

# activating wipes the target apps' data — if the CURRENTLY active profile has anything worth keeping, save it first
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# → "activeProfileId" is the profile to back up

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<active_profile_id>
# → {"jobId":"f0e1d2c3-...", "type":"backup", ...} — poll until "state" is DONE (or FAILED):
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token> --extra jobId:s:<job_id>

# later, once that profile is active again, pour it back:
# adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method restore.start --extra token:s:<your_access_token> --extra id:s:<active_profile_id>

# force-stops every target app, CLEARS ITS DATA, and brings it back with the new identity.
# no confirmation dialog — this comment is the only warning you get
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>
# → Bundle[{data={"id":"a1b2...","isActive":true}, ok=true}]
# BUSY? a backup / restore job still holds the slot — retry until it stops

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>
# → "isActive":true, "deviceMock":{"enabled":true,...}, "sim":{"enabled":true,"simCards":[...]}, "proxy":{...}, "geo":{...}

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# → "activeProfileId":"<profile_id>"

# a second identity with the same settings — device re-rolled, SIM numbers regenerated, name generated
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<profile_id>

# stop spoofing (no id needed — it deactivates whichever profile is active)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.deactivate --extra token:s:<your_access_token>

# delete the profile — its backups under /sdcard/HideMyAndroid_Backups/ go with it
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.delete --extra token:s:<your_access_token> --extra id:s:<profile_id>

两份完整配方

上述各步骤各自浓缩为一个可直接复制运行的代码块。A 是 1.5.9+ 上的最短路径；B 完全不用生成器和代理，在 1.4.5+ 上即可运行。无论哪份，都请在第一条命令之后替换 <profile_id>。

# Recipe A — everything generated (app 1.5.9+). The shortest path to a working profile.

# 1. create — copy the returned id into <profile_id> below
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

# 2. target app
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

# 3. virtual Gmail account
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]"]'

# 4. device + SIM in one call — a random device, slot 0 US, slot 1 GB (both enabled and saved)
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

# 5. proxy — tested live (~8s); the location follows it
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'

# 6. activate — clears the target app's data
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

# 7. verify
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

# Recipe B — everything by hand (app 1.4.5+). No generator, no proxy: you control every value.

# 1. create — copy the returned id into <profile_id> below
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

# 2. target app
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

# 3. virtual Gmail accounts
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

# 4. device — every Build field yourself
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

# 5. SIM — two cards, every field yourself
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'

# 6. location — custom, no proxy (all four fields required; timezone is not validated)
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

# 7. activate — clears the target app's data
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

# 8. verify
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

错误代码

请求失败时返回 ok=false 并附带以下 error_code 值（广播返回 result=1）：

提示与常见问题

• 广播命令没有任何效果？ 请确认命令中包含了 -p com.wowsoftware.hidemyandroid — Android 会拦截不带此参数的广播。
• 值在 : 后被截断？ 该值包含冒号，content call 会在冒号处截断。请改用 HEADLESS_UPDATE 广播发送该值。
• JSON 广播未生效（Windows 上常见）？ 在桌面 Shell 与设备 Shell 之间传递时，am broadcast 命令中的 JSON 引号（hookFlags、proxy、deviceMock、sim）很容易被转义处理，导致 am 解析出错（值可能被识别为 dat=… 数据 URI）从而不生效。可靠的解决方法是避免在命令行中直接传入 JSON — 将整个工作流放入一个 .sh 文件（单引号可保留所有 JSON 内容完整），然后推送到设备上运行。脚本在 设备上 运行，因此还可以捕获新建的配置文件 id 并在后续步骤中复用：
  bash Copy

  # setup.sh — Recipe A from the full example as one runnable script (runs on the device)
  URI=content://com.wowsoftware.hidemyandroid.headless
  PKG=com.wowsoftware.hidemyandroid
  K=<your_access_token>
  
  # 1. create a profile and capture its id
  ID=$(content call --uri $URI --method profile.create --extra token:s:$K --extra name:s:Demo | grep -o '"id":"[^"]*"' | head -n1 | sed 's/.*"id":"//;s/"//')
  echo "profile id: $ID"
  
  # 2. add a target app
  content call --uri $URI --method profile.addApp --extra token:s:$K --extra id:s:$ID --extra packageName:s:com.facebook.katana
  
  # 3. add the virtual Gmail accounts
  content call --uri $URI --method profile.update --extra token:s:$K --extra id:s:$ID --extra 'gmails:s:["[email protected]","[email protected]"]'
  
  # 4. device + SIM generated from the database (1.5.9+): random device, slot 0 US, slot 1 GB
  am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e simCountries '["US","GB"]' -e deviceTemplate random
  #    Recipe B alternative (any version) — write both blocks yourself instead:
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'
  
  # 5. enable + set the proxy (tested live, ~8s) — the location follows it
  am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
  #    Or skip the proxy and set the location yourself (use INSTEAD of the proxy line, not after it):
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'
  
  # 6. activate (restarts the target app and clears its data)
  content call --uri $URI --method profile.setActive --extra token:s:$K --extra id:s:$ID
  
  # 7. verify
  content call --uri $URI --method profile.get --extra token:s:$K --extra id:s:$ID

  然后将文件推送到设备并运行：
  bash Copy

  adb push setup.sh /data/local/tmp/setup.sh
  adb shell sh /data/local/tmp/setup.sh

  不含 JSON 的普通 content call 命令可直接在命令行输入，无需脚本。在 Git Bash 中，请在 adb 命令前加上 MSYS_NO_PATHCONV=1，以防止设备路径被重写。
• 修改未生效？ 目标应用必须重启 — 激活配置文件时会自动完成此操作，并在同一步骤中清除该应用的数据，因此它会以全新身份启动，不保留此前的任何内容。
• 信任的代理仍返回 PROXY_INVALID？ 设备需要联网才能完成检测，超时上限约为 8 秒，响应较慢的代理可能会超时。
• 已取消的任务仍返回 BUSY？ backup.cancel 会立即将任务置为 CANCELLED（并设置 finishedAt），但它启动的 tar 无法被打断，会继续运行，因此槽位仍被占用。backup.job 在槽位仍然繁忙时就已显示 CANCELLED，且没有任何字段会报告槽位状态 — 请勿把 CANCELLED 当作「槽位已空」；只需重试 profile.setActive / deactivate / delete，直到它们不再返回 BUSY。（以 DONE 或 FAILED 自然结束的任务几乎会立即释放槽位。）
• 直接从 device.templates 复制的模板 id 却返回 Binding not well formed？ 已导入模板的 id 以 custom: 开头，这个冒号会破坏 --extra 的 key:type:value 形式 — content 工具会打印 [ERROR] Binding not well formed 及其用法说明，请求根本到不了应用。请改用 HEADLESS_UPDATE 广播发送（-e deviceTemplate 'custom:…'）。内置 id（brand|product|model）不含冒号，两种传输方式都可以使用 — 但请用单引号括起来，否则 shell 会把 | 当作管道符（sh: e3qxeea: not found），什么都不会发送。