NAS 部署AI 家庭资产管理，HomeBox 的神级插件来了

记得刚开始做自媒体的时候，我就分享了 Homebox 这款家庭物资和设备管理工具。而且当时那篇文章一发布就在值得买平台爆了，可以说是让我有信心一直创作的助推器之一。

虽然 Homebox 在当时看起来很不错，但它有一个很大的劣势：不支持中文。

当时除了我，国内主流平台几乎还没人推荐它，所以大部分人的想法就是先加入收藏，而不是真正的使用。

它曾经归档过，但很快就被人接手并且适配了中文。所以最近我又回头，去研究了一下这个项目，竟然意外的发现了还有人开源了一个它的适配插件 —— HomeBox-Companion

HomeBox-Companion 支持通过拍照自动识别、分类、打标签并且入库你的家庭物资设备，而且支持中文语言输出。两个应用结合起来，完全可以实现资产的快速入库和整理。

HomeBox 大家应该都很熟悉了，这里我就不多介绍了。我后面的方案会把 HomeBox 和 HomeBox-Companion 一起部署。

首先是账号体系，两者共用了一套账号配置。当 HomeBox-Companion 启动后，它会自动查找和同步 HomeBox 的数据库和 API 信息。

我们需要现在 HomeBox 里创建一个 Item 的实体类型。这是 HomeBox v0.26 版本后的一个变动，而目前的 HomeBox-Companion 还不支持这个变动，所以需要我们手动添加这个实体类型。

接着来到 HomeBox-Companion 页面，登录账号后选择右上角的 Settings 页面配置模型、参数。

由于 HomeBox-Companion 除了御三家外，仅提供了 LiteLLM 的支持，所以我们使用国内视觉模型的时候，必须在模型前增加 openai/实际模型名称，这样才能读取下面的 API Base URL。

我这里使用的模型是 Qwen/Qwen3.5-35B-A3B，很多平台都免费，而且识别准确度也还可以。比较新的模式，比如 Kimi-K2.6、MiniMax-M3 在 LiteLLM 里还不被识别为视觉模型，所以暂时无法使用。

配置完模型后，继续下拉选择 General Settings，在第一个 Output Language 下把 english 修改为 Chinese 以便让模型输出中文总结。

当然，还有更多的默认配置和优先配置关系，比如名字、描述等等，这个就是大家需要做的精细化管理功能了，可以让 LLMs 快速匹配。

接下来我们到手机侧来操作。HomeBox-Companion 本身是一个为了适配移动端而成的产品，所以它的移动端适配也很棒。

我们登录 HomeBox-Companion 后，直接输入 HomeBox 的账号密码登录。它这里会直接把我们在 HomeBox 配置的地点获取过来，选择任意地点，进入配置，然后选择拍照或者上传图片识别。

一次性支持上传多个图片，但是注意默认的 LLMs timeout 超时会失败，稳定性不是很好，所以建议一张张图片来。

识别出来的内容，描述部分还是非常完整的。然后 AI 也会根据描述自动选择 HomeBox 里配置的标签，比如我拍了一台小主机，就默认帮我选择了 电子产品、服务器、IOT 的标签，准确率非常高。

下面还有一些具体的价格、购买地点、序号等等手动维护的配置信息，等全部维护好了以后就可以一次性上传到 HomeBox 里。

再回到 HomeBox 页面，我们刚才拍照的东西就会自动存储过来。至此，这套通过 AI 识别物品图片，自动完成家庭物资、设备入库管理的流程就走完了。

下面，我们再来说说如何部署这一套服务。

我这里把 HomeBox 和 HomeBox-Companion 放到一起说。如果你之前部署过 HomeBox 的那么就把上面的那一段都删掉。

services:
#### 这里是 Homebox ######
homebox:
image: ghcr.io/sysadminsmedia/homebox:main
container_name: homebox
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- HBOX_OPTIONS_ALLOW_REGISTRATION=true
- HBOX_AUTH_API_KEY_PEPPER=随意替换成你想要的英文作为 API 隐私密钥
volumes:
- ./homebox-data:/data
ports:
- "17745:7745" # 左边的 17745 可以更改你自己想要的端口
#### 这里是 homebox-companion ######
homebox-companion:
image: ghcr.io/duelion/homebox-companion:latest
container_name: homebox-companion
restart: unless-stopped
environment:
- HBC_HOMEBOX_URL=http://homebox:7745
- HBC_LLM_ALLOW_UNSAFE_MODELS=true
- HBC_LLM_TIMEOUT=300
- HBC_LLM_STREAM_TIMEOUT=600
- HBC_IMAGE_QUALITY=low
- HBC_CAPTURE_MAX_IMAGES=5
volumes:
- homebox-companion-data:/app/data
ports:
- "18000:8000" # 左边的 18000 可以更改你自己想要的端口
volumes:
homebox-companion-data: