1. 项目概述为你的智能家居装上“眼睛”和“大脑”如果你和我一样是个智能家居的深度折腾爱好者那么你一定遇到过这样的场景家里的摄像头捕捉到了动静手机收到一条推送——“前门检测到运动”。然后呢没了。你只知道“有东西在动”但完全不知道是快递员放下了包裹是邻居家的猫溜达了过来还是仅仅是一阵风吹动了树枝。这种“知其然不知其所以然”的体验总让人觉得离真正的智能还差那么一口气。今天要聊的这个项目LLM Vision就是为了解决这个痛点而生的。它不是一个简单的运动检测器而是一个为你的Home AssistantHA赋予视觉理解能力的“大脑”。简单来说它通过集成多模态大语言模型LLM让你的摄像头不仅能“看见”更能“看懂”画面里发生了什么并用人类的语言描述给你听。想象一下你的家庭助理不再只是冷冰冰地报告“检测到人”而是告诉你“下午3点15分一位穿着蓝色外套的快递员在门口放下了一个纸箱停留了约30秒后离开。” 或者当你的宠物在客厅捣乱时它能精准地告诉你“你的金毛犬正试图从茶几上叼走一包零食。” 这种级别的场景理解正是LLM Vision带来的核心价值。这个项目由开发者valentinfrlch开源维护并已上架HACS默认仓库安装非常方便。它支持市面上几乎所有主流的AI服务提供商从OpenAI、Google Gemini、Anthropic这样的云端巨头到Ollama、LocalAI这类可以本地部署的开源方案你总能找到适合自己隐私需求和预算的选项。它的工作流程也很清晰接入你的摄像头或Frigate NVR的事件流在触发时抓取快照发送给AI模型进行分析最后将结构化的结果比如人物、物体、动作描述写回Home Assistant供自动化、通知或仪表盘使用。接下来我将结合自己超过半年的实际部署和调优经验从设计思路、详细配置、实战案例到避坑指南为你完整拆解如何将LLM Vision打造成你家智能安防和场景感知的核心。1.1 核心需求与解决思路在深入配置之前我们先明确一下LLM Vision到底解决了哪些传统方案的不足以及它是如何思考的。传统方案的局限语义缺失传统的物体检测如YOLO或人脸识别只能输出标签“人”、“车”、“狗”缺乏上下文和关系描述。它知道有“人”和“包裹”但不知道“人正在递送包裹”。场景理解薄弱无法理解复杂场景。例如庭院里有人“站立”和“弯腰挖土”代表完全不同的意图访客 vs 园丁但传统检测难以区分。配置僵化规则依赖于固定的区域、时间或对象类型。要识别“陌生车辆停在车道上超过10分钟”这种复合条件需要编写复杂的自动化且容易误报。交互性差你无法向系统追问细节。收到一个“人”的警报后你无法再问“这个人戴着帽子吗”或“他手里拿着什么”LLM Vision的解决思路LLM Vision巧妙地利用了多模态大语言模型如GPT-4V, Claude 3, Gemini Pro Vision的“视觉-语言”联合理解能力。它的核心思路是将图像分析任务转化为一个“看图说话”的提示词工程问题。提示词驱动分析你不再需要训练复杂的视觉模型而是通过编写自然语言的“提示词”Prompt来告诉AI你需要关注什么。例如一个基础的提示词可以是“请描述图像中的场景重点关注前门区域的人物、车辆及其行为。如果看到快递包裹请特别指出。”结构化信息提取LLM Vision不仅获取一段文本描述更关键的是它能通过预设的“实体提取”功能从AI返回的描述中自动识别并提取出结构化的实体信息如人名若已知、物体、颜色、动作等并将其转换为Home Assistant的传感器状态或属性。这使得自动化规则可以基于“是否有delivery_package实体”或“person_action属性是否为delivering”来触发。记忆与时间线这是它的杀手级功能之一。通过“记忆”功能它可以学习识别常驻的人物或宠物需要额外配置和训练。更重要的是“时间线”功能会将每一次分析事件包括图像、AI描述、提取的实体按时间顺序保存下来形成一个可查询的视觉日志。你既可以在Lovelace仪表盘上通过专用卡片浏览也可以通过Home Assistant的语音助手Assist进行查询比如“昨天下午门口发生了什么”高度可扩展的提供商支持项目设计上抽象了AI服务接口只要服务提供者遵循OpenAI的API格式这已成为事实标准就能轻松接入。这为用户提供了从云端高性能到本地隐私优先的完整光谱选择。理解了这些你就会明白配置LLM Vision不仅仅是安装一个集成更是在为你的智能家居设计一套“视觉认知系统”。接下来的部分我们将进入实战环节。2. 环境准备与核心配置详解安装LLM Vision本身很简单但要让其稳定、高效、符合预期地工作前期的环境准备和核心配置至关重要。这里我会分享一些官方文档可能不会强调的细节和取舍。2.1 安装与初步设置首先通过HACS安装是首选方式便于后续更新。安装集成在Home Assistant的HACS商店中搜索“LLM Vision”并安装。完成后重启Home Assistant。这是必须的步骤以便加载新的集成文件。添加集成进入“设置” - “设备与服务” - “添加集成”搜索“LLM Vision”。点击后你会看到一个非常简洁的初始配置页面通常直接点击“提交”使用默认设置即可。这一步主要是在系统中注册该集成。关键步骤配置媒体文件夹这是第一个可能遇到的坑。LLM Vision需要存储它抓取的摄像头快照默认路径是Home Assistant的/media目录。对于Home Assistant OSHassOS或Supervised安装的用户通常/media目录已经存在并配置好无需额外操作。对于Docker容器Container安装的用户你必须在运行Home Assistant容器的命令或docker-compose.yml文件中将宿主机的一个目录挂载到容器内的/media路径。例如volumes: - /your/local/media/folder:/media如果不做这一步集成将无法保存图片导致分析失败。请确保你挂载的本地文件夹有正确的读写权限。对于其他安装方式请确认你的HA有可写的/media目录。注意强烈建议为LLM Vision在/media下创建一个子目录例如/media/llmvision_snapshots并在集成的“高级设置”中指定此路径。这有助于管理文件并避免与其他可能使用/media的集成如本地文件备份冲突。你可以在文件编辑器中手动创建这个文件夹。2.2 AI服务提供商选型与配置这是LLM Vision的核心引擎选择直接决定了分析能力、速度、成本和隐私性。点击集成选项页面上的“添加条目”即可开始配置。1. 云端方案高能力需付费依赖网络OpenAI (GPT-4V)目前视觉理解能力的标杆描述准确、细致上下文理解强。缺点是价格最贵每张图约$0.01-$0.03且API访问可能存在地域限制。适合追求最佳效果且预算充足的用户。Anthropic (Claude 3)能力与GPT-4V在伯仲之间在某些逻辑推理和遵循指令方面表现突出。价格与OpenAI相近。是顶级替代选择。Google Gemini Pro Vision性价比很高能力足够应对大多数家庭监控场景价格通常比前两者便宜。与Google生态结合好。个人经验对于“门口有人送货”、“车库门是否开启”、“房间灯是否亮着”这类场景Gemini Pro Vision完全够用是我目前的主力选择。OpenRouter / Azure OpenAI作为聚合平台或企业级接口可以作为访问GPT-4V的替代渠道。OpenRouter有时能提供更灵活的计费方式。Groq以极快的推理速度著称使用LPU硬件。如果你的需求是超低延迟分析例如实时视频流Groq是值得考虑的选项但其视觉模型能力需具体测试。AWS Bedrock适合已经在使用AWS云服务的用户可以方便地集成Claude 3或其它基础模型统一管理和计费。配置要点API密钥妥善保管不要在配置文件中明文提交到Git。模型选择确保选择的模型支持视觉输入如gpt-4-vision-preview,claude-3-opus-20240229,gemini-pro-vision。速率限制与成本控制在集成的“高级设置”中可以设置“每日最大图像数”和“每分钟最大请求数”。务必设置特别是对于门口高频区域避免因风吹草动触发过多分析导致意外高额账单。我建议从每天50-100张开始限制。2. 本地/自托管方案高隐私一次性投入依赖本地算力Ollama这是目前最推荐、最简单的本地运行LLM的方案。它类似于Docker for LLM一条命令就能拉取并运行模型。支持许多优秀的开源视觉模型如llava、bakllava、moondream等。优势部署极其简单社区活跃模型更新快。劣势视觉模型精度目前与顶级云端模型仍有差距对硬件有一定要求建议至少8GB显存的NVIDIA GPU或强大的Apple Silicon芯片。纯CPU运行速度会非常慢。LocalAI一个功能更强大的本地API服务器兼容OpenAI API格式可以加载GGUF格式的量化模型对CPU更友好。优势支持更多模型格式资源消耗控制更灵活适合在NAS或小型服务器上运行。劣势配置比Ollama稍复杂。Open WebUI这是一个提供了友好Web界面的Ollama前端同时它也自带后端可以类似地作为API服务被LLM Vision调用。配置要点以Ollama为例在你的服务器可以是HA同一主机也可以是局域网内另一台有GPU的机器上安装Ollama。拉取一个视觉模型ollama pull llava:7b7B参数版本对硬件要求较低。运行模型服务ollama run llava:7b。默认API服务在11434端口。在LLM Vision添加提供商时选择“Ollama”地址填写http://你的服务器IP:11434模型填写llava:7b。关键调整本地模型的响应格式可能不如云端模型规整。你需要在LLM Vision的提示词Prompt设置中更明确地要求输出简洁、结构化的描述以利于后续实体提取。例如在提示词末尾加上“请用简短的一句话描述并列出主要物体。”我的建议对于家庭安防核心区域前门、车库如果网络和预算允许优先使用Google Gemini Pro Vision它在精度、速度和成本上取得了很好的平衡。对于室内非敏感区域如宠物活动区、花园或者隐私要求极高的场景可以尝试部署Ollama Llava模型。可以先从云端开始熟悉整个工作流再逐步迁移部分场景到本地。2.3 摄像头与Frigate集成配置LLM Vision本身不负责抓取视频流或检测移动它需要与其他组件协作。方案A直接连接Home Assistant摄像头实体这是最简单的方式。如果你的摄像头已经通过ONVIF、RTSP或厂商集成如UniFi, Reolink接入HA并生成了camera.your_camera_name实体那么可以直接在LLM Vision的“实体”配置中选择它。优点配置简单。缺点每次分析都会触发摄像头抓拍可能增加摄像头负载。且无法利用Frigate的智能事件过滤如区域、对象过滤。方案B与Frigate NVR集成强烈推荐Frigate是一个专业的开源网络视频录像机它使用本地AI如YOLO进行实时对象检测人、车、狗等。LLM Vision与Frigate的集成是天作之合。分工Frigate负责“粗筛”——基于轻量级模型7x24小时检测特定对象如“人”并生成一个包含快照的事件。LLM Vision负责“精看”——只对Frigate筛选后的事件例如“前门检测到人”进行详细的多模态分析。配置流程确保Frigate已安装并正常运行且生成了binary_sensor.your_camera_person等实体。在LLM Vision配置中选择“Frigate”作为事件源并关联对应的Frigate事件实体。LLM Vision会自动监听该实体状态变化从off到on并从Frigate获取该事件对应的快照图像进行分析。巨大优势大幅节省成本只有真正有意义的事件如检测到人才会触发昂贵的LLM分析过滤掉了树叶晃动、光影变化等误报。性能更佳Frigate的快照已经是优化过的JPEG图像比直接从视频流抓取更快、更稳定。信息更丰富LLM Vision可以读取Frigate事件中的基础对象标签如“person”并将其作为上下文信息一同发送给大模型提升分析准确性。实操心得务必在Frigate中精细调整每个摄像头的检测区域Zones和对象过滤器Object Filters。例如只在前门人行道区域检测“人”并设置最小置信度和尺寸这样可以确保触发LLM分析的事件都是高质量、高相关性的将分析次数降到最低同时提升有用信息的比例。3. 提示词工程与自动化实战配置好引擎和输入源后LLM Vision的强大与否很大程度上取决于你如何“提问”也就是设计提示词Prompt。同时如何将分析结果用起来则依赖于自动化。3.1 编写高效的视觉提示词LLM Vision允许你为每个摄像头或事件源设置自定义提示词。一个好的提示词应该清晰、具体、有约束力。基础结构模板你是一个家庭安全监控系统。请分析以下图像并专注于[特定区域如前门、 driveway、客厅沙发区域]。 请描述场景中正在发生什么特别关注 1. 人物的出现、数量、大致年龄、衣着特征、以及他们在做什么。 2. 车辆的出现、颜色、型号如果可见、状态行驶中、停放。 3. 任何包裹、行李箱或其他被携带/遗留的物品。 4. 任何异常情况如门/窗未关、灯光异常、有陌生人徘徊。 请用简洁、客观的语言描述避免主观猜测。如果图像中没有任何上述值得关注的活动请回答“无异常活动”。针对不同场景的优化示例前门/包裹投递请分析前门图像。主要目标是识别快递员投递行为。请说明1. 是否有快递员或送货人员在场2. 是否有包裹被放置在地上3. 如果有包裹大约是什么大小和颜色的4. 人员是否正在离开请用“是/否”开头回答关键问题然后简要描述。车库门状态请判断车库门是处于完全开启、完全关闭还是半开状态。仅回答“开启”、“关闭”或“半开”。如果图像模糊无法判断回答“无法确定”。宠物监控请观察客厅图像中的宠物一只金毛犬名叫豆豆。请描述1. 豆豆在做什么例如睡觉、玩耍、啃咬物品2. 它是否在它应该待的区域例如不在狗窝里跑到了沙发上3. 它附近是否有不该接触的物品如零食、电线庭院安全请扫描后院图像。重点关注是否有非家庭成员的人类闯入。如果有请描述其位置、衣着和动作。如果没有请检查后门是否紧闭以及庭院家具是否完好。无异常则回答“后院安全”。高级技巧实体提取提示词LLM Vision的核心功能之一是能从AI回复中提取结构化实体。你需要在“实体提取”配置部分定义你希望提取的实体类型和格式。这通常需要一些实验来让AI输出稳定的格式。例如你可以要求AI在描述中包含特定格式的标签...你的主提示词... 请在描述末尾以JSON格式总结关键信息例如{person_count: 1, person_action: delivering_package, package_color: brown, vehicle_present: false}然后在LLM Vision的实体提取设置中配置JSON路径来创建对应的传感器。例如person_action这个JSON键对应的值会被提取成一个名为sensor.front_door_person_action的实体其状态就是delivering_package。这样你就可以创建自动化规则了当 sensor.front_door_person_action 状态变为 delivering_package 时发送通知。3.2 构建智能自动化与通知分析结果最终要服务于自动化。以下是我在用的几个经典自动化蓝图自动化1智能包裹送达通知触发条件binary_sensor.frigate_front_door_person状态变为on。由Frigate触发条件等待LLM Vision分析完成例如sensor.llmvision_front_door_last_result状态更新。动作调用llm_vision.analyze服务如果未通过Frigate自动触发或直接获取分析结果。数据模板处理在通知消息中嵌入AI的描述。service: notify.mobile_app data: message: - {{ states(sensor.llmvision_front_door_description) }} 触发时间{{ now().strftime(%H:%M) }} title: 前门有情况进阶添加条件判断只有当描述中包含“包裹”、“快递”、“箱子”等关键词时才发送高优先级通知否则只记录到时间线。自动化2基于时间线的每日摘要触发条件每天下午6点或你下班时。动作使用llm_vision.get_timeline服务获取当天指定摄像头的所有事件。数据处理将事件列表包含时间戳和描述整理成文本。调用AI总结将整理好的文本作为提示词发送给另一个文本AI如ChatGPT集成让它生成一段友好的每日简报“今天家门口共发生3次事件上午10点快递员投递包裹下午2点邻居经过下午4点有陌生人短暂停留后离开。”发送通知将简报发送到你的手机。自动化3异常行为警报触发条件LLM Vision分析结果实体如sensor.driveway_person_action状态变为loitering徘徊。条件时间为夜间例如晚10点至早6点。动作触发更强烈的警报如闪烁庭院灯光、播放警告音、并向手机发送紧急通知。避坑指南自动化中处理LLM Vision结果时务必考虑延迟和失败。AI API调用可能需要2-10秒有时甚至会超时失败。在你的自动化中应该使用wait_for_trigger或条件检查来等待分析结果传感器更新而不是立即行动。为服务调用llm_vision.analyze设置一个合理的超时时间如timeout: 15。考虑失败场景如果分析失败是降级为发送普通“检测到人”通知还是记录错误日志做好容错设计。4. 时间线功能与仪表盘展示LLM Vision的时间线功能是其数据价值的集中体现。它不仅仅是一个日志更是一个可交互的视觉记忆系统。4.1 时间线的配置与查询时间线功能默认启用它会为每个配置了LLM Vision的摄像头或事件源创建一个时间线实体如sensor.llmvision_front_door_timeline。这个传感器本身不直接显示内容但其属性中包含了完整的事件列表。你可以通过以下方式利用时间线服务调用获取使用llm_vision.get_timeline服务传入摄像头实体ID和时间范围可以获取结构化的事件列表用于自动化或自定义面板。辅助查询这是最酷的功能之一。在Home Assistant的语音助手Assist中你可以直接问“昨天下午前门发生了什么” Assist会调用LLM Vision的查询功能从时间线中检索、总结并回答你的问题。这需要你在Assist设置中启用LLM Vision的查询功能。第三方集成时间线数据可以通过Home Assistant的API导出连接到你的自定义应用或数据分析工具中。4.2 Lovelace时间线卡片LLM Vision提供了一个专属的Lovelace仪表盘卡片用于美观地展示时间线。安装卡片通常通过HACS安装“LLM Vision Timeline Card”。配置仪表盘在Lovelace面板编辑模式下添加卡片选择“LLM Vision Timeline”。关键配置参数entity: 填入你的时间线传感器实体如sensor.llmvision_front_door_timeline。title: 卡片的标题。max_items: 一次显示的最大事件数量。show_image: 是否显示事件快照缩略图强烈建议开启一目了然。image_click_action: 点击图片后的动作如放大预览或跳转到更多详情。仪表盘设计建议 不要将所有摄像头的时间线都堆在一个仪表盘上。可以创建一个名为“家庭活动日志”的独立面板将前门、车库、客厅等重要区域的时间线卡片并排陈列。这样回家后扫一眼这个面板就能快速了解今天家中各处的动态。你还可以结合“历史图表”卡片将“人员出现次数”等提取的实体数据可视化形成趋势分析。5. 性能调优、隐私安全与常见问题排查将LLM Vision投入7x24小时运行必须考虑性能、成本和隐私。5.1 成本控制与性能优化精细化触发这是省钱的第一要务。充分利用Frigate的区域和对象过滤确保只有关键事件才触发LLM分析。例如只在前门区域检测到“人”时才分析忽略后院检测到的“狗”。设置调用限制在LLM Vision集成的每个提供商配置中务必设置“每日最大图像数”和“重试间隔”。对于家庭场景每日100-200次分析通常绰绰有余。降低图像分辨率在摄像头或Frigate配置中为LLM分析提供的快照不需要4K高清。将快照分辨率调整为720p或480p可以显著减少传输数据量和AI处理负载且对分析精度影响甚微。在Frigate中可以为snapshot组件单独设置分辨率。选择合适的模型云端模型中Gemini Pro Vision通常比GPT-4V便宜。对于简单识别如“车库门开闭”甚至可以尝试更小、更快的模型如GPT-4o-mini。本地模型中较小的7B参数版本比13B或34B版本快得多。缓存与去重LLM Vision本身有一定的事件去重机制。你可以进一步在自动化中实现简单缓存例如如果AI描述与上一分钟的描述高度相似则跳过通知仅更新时间线。5.2 隐私与安全考量数据流向使用云端AI服务时你的家庭图像会被发送到第三方服务器。请仔细阅读所选提供商如OpenAI、Google的隐私政策了解其数据保留和使用条款。本地化方案如果对隐私极度敏感Ollama本地模型是唯一选择。确保运行Ollama的服务器处于安全的家庭网络内不与外网直接通信。图像存储LLM Vision抓取的快照存储在Home Assistant的/media目录。定期清理旧图片可通过自动化或Shell命令实现。如果使用Docker确保挂载的卷是加密的如果存储在NAS上。网络隔离可以考虑将运行Home Assistant和Frigate的设备放在一个独立的VLAN中限制其对外访问仅允许与必要的AI API端点如api.openai.com通信。5.3 常见问题与故障排查以下是我在长期使用中遇到的一些典型问题及解决方法问题1LLM Vision分析失败日志显示“无法获取图像”或“超时”。可能原因1媒体文件夹/media未正确挂载或没有写入权限。排查通过HA文件编辑器或SSH进入容器检查/media目录是否存在并尝试创建一个测试文件。解决修正Docker的volume挂载配置或手动创建目录并赋予正确权限通常chmod 777 /media在测试时可临时解决生产环境建议设置更精细的权限。可能原因2摄像头实体无法访问或RTSP流不稳定。排查在HA开发者工具中手动调用camera.snapshot服务为你配置的摄像头拍照看是否能成功。解决优化摄像头网络或考虑使用Frigate作为稳定的中间层Frigate对RTSP流的重连和处理更强健。问题2AI返回的描述过于笼统或不准确。可能原因1提示词不够具体。解决细化你的提示词。明确要求AI关注什么忽略什么以及你希望的输出格式。多迭代几次。可能原因2图像质量太差、光线太暗或目标太小。解决改善摄像头位置和补光。在Frigate中调高生成快照的质量和尺寸。确保AI分析的是事件发生时的最佳帧。可能原因3使用的AI模型能力不足特别是某些本地小模型。解决尝试更换更强大的模型如从llava:7b升级到llava:13b或者切换到云端模型进行对比测试。问题3时间线卡片不显示图片或加载缓慢。可能原因图片存储在HA内部通过内网地址访问但你的访问方式如Nginx反向代理可能导致了路径问题。排查检查浏览器开发者工具中网络请求查看图片URL是否返回404错误。解决确保HA的内外部URL配置正确。如果通过域名访问在HA配置configuration.yaml中正确设置internal_url和external_url。对于复杂网络环境可能需要调整代理设置。问题4自动化响应太慢从检测到人到收到详细通知间隔了十几秒。原因延迟是累积的Frigate检测延迟 抓拍快照延迟 图片上传到AI服务延迟 AI处理延迟 结果返回并更新传感器延迟。优化优化Frigate性能使用硬件加速如Coral TPU调整检测频率。降低分析图片的分辨率。选择低延迟的AI提供商如Groq或地理位置上更近的API端点。在自动化中不必等待完整的AI描述才发送通知。可以设计两级通知Frigate检测到人时立即发送一条快速通知如“前门检测到人”待AI分析完成后再发送一条包含详细描述的后继通知。问题5实体提取功能无法正确解析AI的回复。原因AI的回复是自由文本实体提取依赖于你定义的规则如正则表达式或JSON路径去匹配。如果AI的回复格式不稳定提取就会失败。解决强化提示词在提示词中严格要求AI以特定格式输出例如“请务必以以下JSON格式回答...”。用“必须”、“请严格按照”等词强调。使用更稳定的模型GPT-4、Claude 3在遵循指令方面通常比小模型或Gemini更稳定。简化提取目标初期不要试图提取太多、太复杂的实体。先从1-2个关键信息开始如has_package: yes/no。使用备用方案如果结构化提取不可靠可以退而求其次在自动化中使用模板传感器template来解析AI描述文本sensor.llmvision_xxx_description中的关键词。部署LLM Vision是一个持续调优的过程。从最初的基础配置到提示词的精心打磨再到自动化逻辑的层层优化每一步都能带来体验上的提升。它可能不会100%准确但即便是80%准确率的智能描述也远比100%的“检测到运动”要有价值得多。它真正让你的智能家居从“感知”走向了“认知”。