本文档描述如何在群晖docker上运行智汀家庭云（以下简称SA），并使用浏览器体验SA。

1. 环境准备#

• linux主机
• docker
• docker-compose

2. 运行SA#

0

自行创建docker-compose文件运行#

选择一个目录存放SA所需文件，执行以下命令：

wget -O smartassistant.zip https://github.com/zhiting-tech/smartassistant/releases/download/v2.0.2/smartassistant.2.0.2.zip && unzip smartassistant.zip cd zt-smartassistant docker-compose up

备注：

您可以通过最新版本的发布地址：
https://github.com/zhiting-tech/smartassistant/releases,获取最新版本zip文件

3. 测试运行情况#

服务启动后可以通过以下命令检查SA的状态：

curl http://localhost:9020/api/check

如果返回以下内容则说明服务已运行起来并且未被绑定

{"status":0,"reason":"成功","data":{"is_bind":false,"revision":""}}

4. 使用智汀App进行体验#

SA体验演示#

• 点击添加智能设备发现SA

• 选中SA,点击添加

点击添加设备

正在添加设备

设置是否允许找回用户凭证

添加设备成功

• 点击支持品牌，界面中会列出SA内置的一些插件

查询支持品牌

• 点击其中的一个插件，点击添加对插件进行安装

添加插件

添加插件成功

• 插件添加成功后，返回到首页家居，点击右上角+按钮就可以添加插件支持的设备

• 选中其中的一个设备点击添加,添加完成后返回到首页的家居即可对设备进行操控

添加设备

添加设备成功

5. 使用专业版进行体验#

5.1 账号和密码设置#

SA服务启动后，如果未绑定，需要发送以下请求对SA进行绑定：

curl -X POST -d '{"device": {"model": "smart_assistant"}}' http://localhost:37965/api/devices

绑定成功后返回以下内容：

{ "status": 0, "reason": "成功", "data": { "device_id": 1, "plugin_url": "", "user_info": { "user_id": 1, "role_infos": null, "account_name": "", "nickname": "wyqicai", "token": "MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3", "phone": "", "is_set_password": false }, "area_info": { "id": "20763937284831135" } } }

SA绑定成功后设置用户名和密码：

curl -X PUT -d '{"account_name": "admin","password": "123456"}' --header 'smart-assistant-token:MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3' http://localhost:37965/api/users/1 其中header参数smart-assistant-token值为绑定成功后的token, 请求url path（/api/users/:id）中的路径参数id为绑定成功后返回的用户id。 

设置成功后返回：

{"status":0,"reason":"成功"}

当用户账号和密码设置成功后打开浏览器，访问 http://localhost:9020 即可体验SA了。

5.2 SA体验演示#

• 使用账号密码登录

• 登录成功后，切换到我的

• 点击支持品牌，界面中会列出SA内置的一些插件

• 点击其中的一个插件对插件进行安装

添加插件

成功添加插件

• 插件添加成功后，返回到首页家居，点击右上角+按钮就可以添加插件支持的设备

• 选中其中的一个设备点击添加,添加完成后返回到首页的家居即可对设备进行操控

设备添加成功

控制设备

6. 进一步了解#

如果您手上有智汀家庭云支持的硬件设备，可以安装第三方插件，然后通过智汀APP接入您的设备。

智汀家庭云是一个开源项目，如果如果您熟悉 go 编程语言，想进一步了解我们的项目，可以访问开发环境搭建

智汀家庭云提供插件系统支持第三方设备接入，如果您的设备不在我们的支持列表，可以参考 开发您的第一个插件了解插件开发的相关内容。

原文链接：https://blog.csdn.net/m0_65904381/article/details/124591378