Support
Last updated: July 23, 2026
App Overview
膳环 (MacroHalo) is a local-first food and nutrition logging app for iPhone, with widgets, Live Activities, Dynamic Island support, and an Apple Watch today’s nutrition overview.
The app helps you estimate and record calories, protein, carbohydrates, fat, and optional nutrients from food photos or structured JSON. Nutrition numbers are AI-generated estimates and are not medical test results, medical advice, or a substitute for food labels, doctors, registered dietitians, or other qualified health professionals. 膳环 is not intended to diagnose, treat, prevent, or monitor any disease.
Supported systems:
- iOS 17 or later
- watchOS 10 or later for the Apple Watch companion app
- Current app version: 1.0
- Bundle ID:
com.renchiliu.MacroHalo
Contact Support
Email support@renchiliu.com.
When contacting support, please include:
- App version
- iOS version and, if relevant, watchOS version
- Device model
- A clear description of the issue
- Screenshots, if they help explain the problem and do not contain sensitive information
Please do not send your OpenAI API Key, Authorization header, complete food photos, or CSV files containing sensitive health information by email.
Privacy
Read the 膳环 (MacroHalo) Privacy Policy.
OpenAI
OpenAI is an independent third-party service. If you use direct estimation in 膳环, the app connects from your device to OpenAI using your own OpenAI API Key. OpenAI API costs, quotas, billing, usage limits, and account issues should be handled through your own OpenAI account.
Frequently Asked Questions
1. Why do I need to provide my own OpenAI API Key?
The current version does not include a developer server and does not resell or pay for OpenAI API usage. Direct in-app estimation uses your own OpenAI API account, so you need to provide your own API Key if you want the app to call OpenAI directly.
2. Will the OpenAI API cost money?
Yes, it may. OpenAI API usage is billed by OpenAI to your own OpenAI API account according to OpenAI’s pricing and account terms. 膳环 does not collect, subsidize, or control those charges.
3. How do I delete or replace my API Key?
Open 膳环 Settings and use the API Key controls to delete the saved key or enter a replacement key. The key is stored in Apple Keychain and is not included in meal records, CSV exports, or local API history.
4. Why might an estimate be inaccurate?
Food photos can be incomplete, portion sizes can be hard to infer, packaging text may be unclear, and AI output can be wrong. Always review and adjust estimates before saving them. Use food labels, a scale, and professional advice when accuracy matters.
5. Can I use the app without an API Key?
Yes, but direct in-app OpenAI estimation will not be available. You can still work with local records and use manual JSON import if you generate structured JSON outside the app.
6. How do I use manual JSON import?
Copy the prompt provided by 膳环, submit your food information or photos yourself to ChatGPT or another external AI service, then paste the returned structured JSON into 膳环. In this mode, 膳环 itself does not make the network request to that external service.
7. How do I export a CSV backup?
Open the app’s export or backup area and choose CSV export. The exported file contains your meal records and should be stored or shared carefully.
8. How do I clear API call history?
Open Settings and use the LLM API usage-history controls. You can delete individual history items or clear all local API usage history.
9. How do I enable camera permission?
The app requests camera permission only when you choose to take a food photo. If permission was denied, open iPhone Settings, find 膳环, and enable Camera access. Photo selection uses Apple’s Photos Picker and does not require full photo-library access.
10. Why are my widget or Apple Watch numbers not updating?
Confirm that today’s meal records and goals are saved in the iPhone app. Then try opening the iPhone app once to refresh shared summaries. For widgets, make sure the widget is still added and that Low Power Mode or system refresh behavior is not delaying updates. For Apple Watch, make sure the watch app is installed and the devices are connected.
11. Does 膳环 read HealthKit?
No. The current version does not use HealthKit and does not read or write Apple Health data.
12. How do I report a bug or suggest a feature?
Email support@renchiliu.com with the app version, iOS or watchOS version, device model, what you expected to happen, and what actually happened. Please avoid sending sensitive health information or API credentials.
技术支持
最后更新日期：2026 年 7 月 23 日
App 简介
膳环（MacroHalo）是一款本地优先的 iPhone 饮食与营养记录 App，支持 Widget、Live Activity、Dynamic Island，以及配套 Apple Watch 今日营养概览。
App 可以帮助你根据食物照片或结构化 JSON 估算并记录热量、蛋白质、碳水化合物、脂肪和可选营养元素。所有营养数字都是 AI 生成的估算值，不是医学检测结果、医疗建议，也不能代替食品标签、医生、注册营养师或其他合格医疗专业人士。膳环不用于诊断、治疗、预防或监测任何疾病。
支持系统：
- iOS 17 或更高版本
- Apple Watch 配套 App 需要 watchOS 10 或更高版本
- 当前 App 版本：1.0
- Bundle ID：
com.renchiliu.MacroHalo
联系技术支持
请发送邮件至 support@renchiliu.com。
联系时建议提供：
- App 版本
- iOS 版本；如果问题与 Apple Watch 有关，也请提供 watchOS 版本
- 设备型号
- 清楚的问题描述
- 截图，如果截图有助于说明问题且不包含敏感信息
请不要通过邮件发送 OpenAI API Key、Authorization header、完整食物照片，或包含敏感健康信息的 CSV 文件。
隐私政策
OpenAI
OpenAI 是独立第三方服务。如果你在膳环中使用直接估算，App 会使用你自己的 OpenAI API Key 从你的设备连接 OpenAI。OpenAI API 费用、额度、账单、使用限制和账号问题应通过你自己的 OpenAI 账号处理。
常见问题
1. 为什么必须提供自己的 OpenAI API Key？
当前版本没有开发者服务器，也不会转售或代付 OpenAI API 用量。App 内直接估算使用你自己的 OpenAI API 账号，因此如果你希望 App 直接调用 OpenAI，需要提供自己的 API Key。
2. OpenAI API 会产生费用吗？
可能会。OpenAI API 用量由 OpenAI 按其价格和账号条款向你自己的 OpenAI API 账号计费。膳环不收取、补贴或控制这些费用。
3. 如何删除或替换 API Key？
打开膳环的设置，使用 API Key 相关控制删除已保存的 Key，或输入新的 Key。API Key 保存在 Apple Keychain 中，不会包含在餐食记录、CSV 导出或本地 API 历史里。
4. 为什么估算结果可能不准确？
食物照片可能不完整，份量可能难以判断，包装文字可能不清楚，AI 输出也可能出错。保存前请务必检查并调整估算结果。在需要准确性的场景中，请以食品标签、食物秤和专业建议为准。
5. 没有 API Key 是否还能使用？
可以，但无法使用 App 内直接 OpenAI 估算。你仍然可以管理本地记录，也可以在 App 外生成结构化 JSON 后使用手动 JSON 导入。
6. 如何使用手动 JSON 导入？
复制膳环提供的提示词，自行在 ChatGPT 或其他外部 AI 服务中提交食物信息或照片，然后将返回的结构化 JSON 粘贴到膳环。在这种模式下，膳环本身不会向该外部服务发起网络请求。
7. 如何导出 CSV 备份？
打开 App 中的导出或备份入口，选择 CSV 导出。导出的文件包含你的餐食记录，请谨慎保存或分享。
8. 如何清除 API 调用历史？
打开设置，使用 LLM API 使用历史相关控制。你可以逐条删除历史记录，也可以一次清空全部本地 API 使用历史。
9. 如何启用相机权限？
App 仅在你选择拍摄食物照片时请求相机权限。如果你曾拒绝权限，请打开 iPhone“设置”，找到膳环并启用相机权限。从相册选择照片使用 Apple 的 Photos Picker，不需要完整照片图库访问权限。
10. Widget 或 Apple Watch 为什么没有更新？
请先确认当天餐食记录和目标已经保存在 iPhone App 中，然后打开一次 iPhone App 以刷新共享汇总。Widget 方面，请确认 Widget 仍在桌面或锁屏上，并留意低电量模式或系统刷新机制可能造成延迟。Apple Watch 方面，请确认手表 App 已安装且设备已连接。
11. 膳环是否读取 HealthKit？
不读取。当前版本不使用 HealthKit，也不会读取或写入 Apple Health 数据。
12. 如何报告 Bug 或提出功能建议？
请发送邮件至 support@renchiliu.com，并提供 App 版本、iOS 或 watchOS 版本、设备型号、你预期发生什么、实际发生了什么。请避免发送敏感健康信息或 API 凭证。