Support

Arslan on your iPhone,
working on your Mac.

Set it up in a few minutes, fix the usual snags, or write to the developer directly.

01What you need

MacApple silicon, macOS 11 or laterwith Arslan for Mac (free) — 0.1.54 or later recommended
iPhoneiOS 17 or laterFace ID or Touch ID to approve
iCloudThe same Apple ID on bothwith iCloud turned on, both online

02Pair in three steps

  1. On your Mac, open Arslan › Settings › Connections › iPhone

    Turn on Use Arslan from your iPhone, then click Add iPhone. A code appears; it works once, for 10 minutes.

  2. On your iPhone, open Arslan and scan the code

    The app asks for the camera only to read this code.

  3. Back on the Mac, click Allow

    The phone shows each step. On the Mac it reads Connecting… until the first message arrives, then Connected.

Just looking? On the iPhone's first screen, tap Try the demo. It never connects to a real Mac.

03Common questions

The app says my Mac is offline

Check that the Mac is awake, Arslan is running, Use Arslan from your iPhone is on, both devices use the same Apple ID, and both are online. What you send while the Mac is offline waits and goes when it is back.

Pairing is stuck, or the code stopped working

The code lasts 10 minutes and works once. If it has expired, click Add iPhone again on the Mac and scan the new one. Keep both apps open for the first few seconds after you click Allow.

Pairing the same iPhone again replaces its old entry on the Mac instead of adding a second one.Mac 0.1.54+

How do approvals work?

When the agent on your Mac wants to do something that needs your OK, it asks first, on the Mac and on your phone. Approve with Face ID or Touch ID, or decline; the first answer counts. A card nobody answers stays open for 30 minutes, and running out is not a no: Arslan tells you what is waiting.Mac 0.1.61+ Earlier versions close it after five minutes. Voice can ask for things, but it can never approve.

It says to update Arslan on the Mac before I can approve with Touch ID

Touch ID approvals (for example on iPhone SE) need Arslan for Mac 0.1.54 or later. Open Arslan on the Mac and install the update it offers, or download the latest version from aralem.dev/arslan. Face ID approvals work with earlier versions too.

Voice input

Hold to talk, let go to check the text, then send. Each recording can be up to 60 seconds. Recognition runs on your iPhone in the app's language (English or Chinese); recordings are never saved or uploaded. The first time, iOS may need to download its speech resources, which can be large, so Wi-Fi is best.

Can I send photos or files from my iPhone?

Not in this version: files go from your Mac to your phone, where you can open them. Sending photos and files from the iPhone to the Mac is planned for a later version.

Notifications

Arslan tells you when the Mac needs an approval or has finished a task. Previews are decrypted on your iPhone. To keep message text off the lock screen, turn off Show content in notifications in the app's settings.

Which AI model does it use?

The one you set up in Arslan for Mac, with your own API key. The iPhone app never talks to an AI service; before your first message it asks you to agree to your Mac sending your requests to that service. You can withdraw that in the app's Settings › Privacy.

How do I unpair?

On the iPhone: Settings › Unpair clears the iPhone. On the Mac: Settings › Connections › iPhone › Remove removes the phone and deletes the messages waiting for it in your iCloud. Do both to remove a phone completely.

04Reporting a problem

Tell us the versions (iPhone app version, Arslan for Mac version from its About window, iOS and macOS), what you did, and what you expected. A screenshot helps. Please never send API keys, pairing codes or pairing links.

支持

在 iPhone 上交代,
在 Mac 上把活干完。

几分钟就能设置好;这里有常见问题的解法,也可以直接写信给开发者。

01需要什么

MacApple 芯片,macOS 11 或更高装好 Arslan Mac 版(免费),建议 0.1.54 或更高
iPhoneiOS 17 或更高用面容 ID 或触控 ID 批准
iCloud两台设备同一个 Apple ID打开 iCloud,并且都联网

02三步完成配对

  1. 在 Mac 上打开 Arslan › 设置 › 连接 › iPhone

    打开 在 iPhone 上使用 Arslan,再点 添加 iPhone。会出现一个配对码,只能用一次,10 分钟内有效。

  2. 在 iPhone 上打开 Arslan,扫这个码

    App 只为读这个码才使用相机。

  3. 回到 Mac,点“允许”

    手机上会显示每一步进度。Mac 上先显示连接中…,收到第一条消息后变成已连接。

只想先看看?在 iPhone 的第一个页面点 先看看演示,它不会连接任何真实的 Mac。

03常见问题

App 显示 Mac 离线

确认 Mac 没有睡眠、Arslan 正在运行、在 iPhone 上使用 Arslan 已打开、两台设备是同一个 Apple ID,并且都联网。Mac 离线时你发的内容会先排队,等它恢复后再送达。

配对卡住了,或者配对码失效了

配对码 10 分钟内有效,只能用一次。过期了就在 Mac 上再点一次 添加 iPhone,扫新的码。点“允许”之后的头几秒,两边的 App 都保持打开。

同一台 iPhone 再次配对,会替换 Mac 上的旧条目,而不是多出一条。Mac 0.1.54+

批准是怎么回事?

Mac 上的智能体要做需要你点头的事时,会先在 Mac 和手机上同时来问你。用面容 ID 或触控 ID 批准,或者拒绝,以先到的回答为准。没人回应的批准卡会保持开启 30 分钟,时间到了也不算拒绝:Arslan 会告诉你还有什么在等你。Mac 0.1.61+ 更早的版本会在五分钟后关闭它。语音可以提要求,但永远不能批准。

提示我先在 Mac 上更新 Arslan,才能用触控 ID 批准

用触控 ID 批准(比如 iPhone SE)需要 Arslan Mac 版 0.1.54 或更高版本。在 Mac 上打开 Arslan 安装它提示的更新,或者从 aralem.dev/arslan 下载最新版。面容 ID 批准在更早的版本上也能用。

语音输入

按住说话,松开后检查文字,再发送。每段最长 60 秒。识别在 iPhone 本机完成,语言跟随 App(中文或英文);录音从不保存、也不上传。第一次使用时,iOS 可能需要下载语音资源,体积可能较大,最好连着 Wi-Fi。

能从 iPhone 发照片或文件吗?

这个版本还不能:文件是从 Mac 发到手机,在手机上打开查看。从 iPhone 往 Mac 发照片和文件,计划在之后的版本加入。

通知

Mac 需要你批准、或任务做完时,Arslan 会提醒你。通知预览在 iPhone 上解密。不想让消息内容出现在锁屏上,可以在 App 设置里关闭 通知里显示内容。

用的是哪个 AI 模型?

你在 Arslan Mac 版里设置的那个,用你自己的 API key。iPhone 版本身从不连接 AI 服务;在你发第一条消息前,它会请你同意由 Mac 把请求发给那个服务。可以在 App 的 设置 › 隐私 里撤回。

怎么解除配对?

iPhone 上:设置 › 解除配对,清空这台 iPhone 上的数据。Mac 上:设置 › 连接 › iPhone › 移除,移除这台手机,并删除 iCloud 里等着发给它的消息。两边都做,才算彻底移除。

04报告问题

请告诉我们版本(iPhone App 版本、Mac 上“关于”窗口里的 Arslan 版本、iOS 和 macOS 版本)、你做了什么、期望看到什么;附一张截图更好。请不要发送 API key、配对码或配对链接。