iPhone 与 iPad
在 iOS 版 MadoHub 中创建 Agent、继续开发任务、管理购买，并按需连接 Mac。
MadoHub iOS 版是面向开发者的 AI 工作台。你可以创建 Agent 来分析问题、制定修复方案或审查代码，在画布上组织对话和任务交接。手机可以独立使用；需要查看桌面 Agent 或发送操作时，也可以连接兼容的 Mac。
应用要求 iOS 或 iPadOS 18 及以上版本。登录、权益检查和 AI 任务需要联网。以下说明以 1.1 版本为准；购买价格和可用优惠以应用内显示为准。
登录并进入工作台
- 打开 MadoHub，使用 Apple、Google 或通过邮箱继续。注册邮箱账号时，按应用提示完成验证。
- 等待应用核对账号权益和购买状态。如果核对失败，检查网络后点重试或恢复购买。
- 账号有有效的 Pro 订阅、可用 Agent 额度或 Credits 余额时，即可进入工作台。没有可用权益时，在访问页面选择订阅或购买 Credits；两者都可以作为开始使用的方式，无需同时购买。
新工作台会显示创建你的第一个 Agent。Agent 和对话历史保存在当前设备上，并按 MadoHub 账号分开管理。换一台设备登录同一账号，不会自动复制这份本地工作台。
创建第一个 Agent
- 点创建 Agent，或在画布上打开 + → Agent。
- 选择“快速上手”中的调试等选项，或填写能说明任务的名称，再点创建。应用会生成可编辑的指令，之后可以按需要调整。
- 首次触发 AI 操作时，阅读数据共享说明，确认同意后继续。之后可在设置 → 关于与隐私 → AI 数据共享中查看和管理。
- 打开 Agent 对话，提供相关代码、报错或背景。例如：“解释为什么
return items[0].name在空数组时会报错，并给出安全的修复方法。简短回答。” - 阅读回复，继续补充信息或追问。需要取消正在运行的任务时，点停止按钮。
请把任务所需的代码或日志放入对话，并在应用到项目之前检查建议。对话中的修复方案本身不代表文件已修改或测试已执行。
组织任务并继续工作
- 在画布上安排 Agent，用 Agent 列表查看状态或返回某个对话。
- 连接 Agent，将已完成的输出交给下一项任务。+ → 画布 Flow提供审查、流水线和监控等模板。
- 在对话中打开关联任务，阅读相连 Agent 的输出，再返回当前草稿。
- 阅读历史消息时保留当前阅读位置，需要时使用回到最新消息的按钮。
- 收起 Agent 会停止其任务，并把图块移出当前画布。可以在已收起中查看和恢复；永久删除是另一项操作。
1.1 版本支持 iPhone Duo 的内外屏布局。切换屏幕或调整窗口时，可以继续当前对话，保留未发送草稿；iPad 的面板也会随可用空间调整。
语音输入
在对话输入栏点麦克风，将语音转成草稿，检查文本后再发送。长按悬浮的 MadoHub Agent 按钮可说出助手请求，松开后提交最终识别文本。
使用时应用会请求麦克风和语音识别权限。识别在设备上完成，音频不会上传；最终文本会在获得 AI 数据共享同意后作为任务内容处理。可在设置 → 语音输入选择语言，具体可用性取决于设备端语音识别支持。
Credits、Pro 与购买
打开设置 → 账号，进入 MadoHub Pro 页面，查看余额、额度和购买选项。iOS 内的购买通过 App Store 完成；确认购买前，请查看应用显示的当地价格和 Apple 确认页面。
| 选项 | 包含用量 | 续费与到期规则 |
|---|---|---|
| 1,000 Credits | 一次性加入 Credits 钱包 | 不订阅、不续费；已发放的 Credits 不过期 |
| MadoHub Pro | 每个已付费账期 2,500 Agent Credits 和 100 Cloud 小时 | 按月自动续订，直至取消；额度按账期重置，不结转 |
| 符合条件的 Pro 首次试用 | 显示该优惠时，3 天内可用 250 Agent Credits 和 10 Cloud 小时 | 试用结束后按显示的月费续订，除非取消 |
试用资格由 App Store 决定，符合条件时才会显示。Credit 是用量单位，不等于一条消息；消耗取决于任务和模型。对应套餐额度用完后，额外用量可从 Credits 钱包扣除。
桌面端买断和官网购买方式另见账号与 Credits。在 iOS 应用内购买时，请使用 App Store 入口。iOS 的 AI 任务通过 MadoHub Cloud 处理，不提供填写服务商 API Key 的入口。
恢复或管理购买
在访问页面或购买页面点恢复购买，使用原购买的 Apple 账号，并登录购买所关联的 MadoHub 账号。两者的邮箱可以不同。恢复会核对已验证购买和账号权益，不会重复发放已经到账的消耗型 Credits。
如果 Apple 已确认购买，但应用仍在核对，请先重开应用，使用重试或恢复入口，再决定是否重新购买。App Store 订阅可以通过应用内的管理链接或 Apple 订阅设置管理；在其他平台购买的现有订阅，应在原购买平台管理。
按需连接 Mac
打开设置 → Mac 连接，主动启用自动连接同账号 Mac，或使用本地二维码配对。Companion 文档说明了两种连接方式和排查步骤。
从 1.1 开始，未保存偏好的用户默认不自动发现 Mac；已有选择会保留。仅使用手机工作台时，可以保持关闭。旧版如果仍显示找不到 Mac 的提示，可关闭自动连接后重新打开应用。
隐私与删除账号
在设置 → 关于与隐私查看 AI 数据共享说明。关闭共享后会阻止新的 AI 任务，已经运行的任务可能仍会完成。账号数据、任务处理、保留时间和远程 Mac 连接说明见隐私政策。
删除账号时，打开设置 → 账号，选择删除入口，并使用已关联的登录方式确认身份。删除会移除账号云端数据及其本地工作台；请先完成正在核对的购买或恢复操作。删除 MadoHub 账号不会取消 App Store 订阅续费，订阅需要另行管理。
获取帮助
连接或购买报错时，先检查网络，再使用应用提供的重试入口。Mac 相关问题可参考 Companion 排查步骤。仍无法解决时，联系 [email protected]，提供应用版本、设备和系统版本、错误提示及操作步骤。截图请隐藏私人项目和账号信息，不要发送密码或配对链接。