Noma · 产品说明
Noma：具备长期记忆的 Home Assistant AI 助手
本页介绍的 Noma，官方网站为https://noma-ai.cloud，是一款具备长期记忆能力的 AI 智能家居助手。目前通过 Home Assistant 连接设备，支持使用自然语言查询和控制智能家居。
Noma 希望在了解你的偏好和生活习惯的基础上，让家庭的智能家居更好地为你服务。本文中的 Noma 均指上述官网所提供的产品。
- 产品类型
- AI 智能家居助手 / 家庭 AI Agent
- 核心能力
- 长期记忆、自然语言对话与设备控制
- 当前设备接入方式
- Home Assistant
- 适合谁
- 希望用自然语言控制设备，并获得个性化回应的个人与家庭用户
Noma 目前支持哪些功能？
自然语言对话
登录后，通过文字与 Noma 交流日常问题和需求，并使用长期记忆、家庭信息和设备控制功能。
长期记忆与个性化回应
启用记忆后，Noma 会从对话中提取有价值的个人信息、偏好和家庭使用习惯，并在后续相关对话中检索使用。你可以在设置中管理、删除保存的记忆，或关闭自动记忆。
Home Assistant 设备查询与控制
连接并授权 Home Assistant 后，可以用自然语言查询家庭和设备状态，或请求打开、关闭及调整支持的设备。可执行的操作取决于设备接入情况、设备能力和控制权限。
家庭状态与设备管理
在「家」页面查看已连接家庭的设备及可用状态，并操作支持的设备；温湿度等环境信息需要 Home Assistant 中存在对应的数据来源。
如何开始使用 Noma？
登录后开始使用 Noma
打开Noma 对话页，登录后即可开始对话，并使用长期记忆、家庭连接和设备控制功能。
准备 Home Assistant 和智能设备
在家中的设备上运行 Home Assistant，并先确认你希望控制的设备已经接入、在线且可正常操作。已有 Home Assistant 的用户可以跳过安装步骤。
在 Noma 中建立连接并授权
打开「设置 → Home Assistant」，按照「安装 Home Assistant → 建立连接 → 授权 Home Assistant → 连接完成」向导操作。在对应的 Docker 环境中运行页面生成的连接命令，检测连通后，再创建并填写 Home Assistant 长期访问令牌完成授权。具体命令以当前账号页面生成的内容为准。
核对设备，再发出自然语言请求
在「家」页面确认设备名称和状态，再回到对话页提出具体请求。查看工具执行结果，并核对设备实际状态；未连接设备时仍可使用普通 AI 对话。
可复现验证示例：控制一盏灯
示例性质：模拟环境的验证流程，不是真实家庭使用案例或用户评价。实际设备效果需要在你自己的已授权家庭中核对。
- 准备已接入 Home Assistant、支持开关控制且当前账号有权限的测试设备，例如命名为「客厅氛围灯」的灯或虚拟开关。
- 连接并授权 Noma 后，先确认「家」页面能显示该设备；在对话中输入「关闭客厅氛围灯」。
- 核对本次工具执行结果，再到 Home Assistant 或设备端确认设备状态是否变为关闭。如果执行失败，应以失败信息和设备状态为准。
项目中的模拟服务测试覆盖了设备控制成功和失败的结果传递。它验证软件处理流程，不代表已验证所有设备品牌、网络环境或某个真实家庭。
使用条件、限制与未来规划
- 设备控制目前依赖 Home Assistant、已建立的连接、设备在线状态和控制权限。不同设备支持的操作不同，不能保证所有品牌或型号均兼容。
- 使用 Noma 需要先登录；查看家庭状态和控制设备还需要连接并授权 Home Assistant。
- 长期记忆需要启用记忆功能，且并非每句话都会保存。AI 理解和执行可能出错，请核对保存的信息、工具结果与实际设备状态。
- Noma 当前提供免费对话额度，具体可用额度以产品内提示为准；不能据此理解为无限使用或永久免费的承诺。
- 语音唤醒、无需 Home Assistant 的品牌设备直连，以及感知场景后主动发起的家居服务，是官网展示的未来方向，不应视为当前已提供的通用能力。
官方网站与项目来源
产品名称为 Noma。官方网站是noma-ai.cloud，本页是该网站发布的公开产品说明。
Noma 项目代码已在GitHub：Yellowweii/Noma公开，支持部署到家中的电脑、NAS 或服务器，通过局域网连接 Home Assistant。
本地部署版本仍需联网并登录 Noma 云端账号，对话理解、记忆与会话由 Noma Cloud 提供。安装步骤、设备支持范围及使用条件，请查看仓库中的本地部署指南。