# ha

**Repository Path**: elfbobo_admin_admin/ha

## Basic Information

- **Project Name**: ha
- **Description**: Home Assistant Custom Integrations (HACS) — 小辉数字员工 V1.4: 15 sensor + 5 service, 复用 HA 已有语音集成 (小智/小米/天猫/Alexa/HomeKit 都能用)
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小辉数字员工 - Home Assistant 集成 (HACS)

> V1.4 — 海刚 19:06 拍板终极方案

把"小辉数字员工"做成 Home Assistant 自定义集成，**任何支持 HA 的智能音箱**（小智 / 小米 / 天猫 / Alexa / HomeKit）都能通过 HA 语音链路调用小辉后端的所有业务 API。

## ✨ 装好之后

- 1 个设备：**小辉数字员工**
- 15 个 sensor entity（每 60 秒刷新一次）
- 5 个 service action（查库存 / 发飞书 / 建审批 / 发站内信 / 打印）

## 📦 安装

### 路线 A：HACS（推荐，1 分钟）

1. HA UI → **HACS** → **集成** → 右上角 ⋮ → **添加自定义仓库**
2. 仓库地址：`https://gitee.com/khsm/ha`
3. 类别选 **Integration**
4. 搜索 `xiaohui_digital_employee` → **安装**
5. **重启 Home Assistant**
6. 设置 → 设备与服务 → **+ 添加集成** → 搜 "小辉数字员工"

### 路线 B：手工装（5 分钟）

参见 [MANUAL-INSTALL.md](MANUAL-INSTALL.md)。

## 🔑 配置

集成安装时填 3 个字段：

| 字段 | 示例 |
|------|------|
| 后端 URL | `http://xiaohui-2-backend:3001`（容器网络内）或 `https://gl.khsm.cloud` |
| Internal Secret | `6a38e02d7a4bf981890c6e9b73705fea91d01eb21c1a87686ee2a72988eac8ac` |
| 刷新间隔 | `60` 秒（默认） |

## 🧩 链路

```
小智/小米/天猫/Alexa/HomeKit 智能音箱
    ↓ HA 已有语音集成 (assist_satellite + xiaomi_home + ...)
Home Assistant (220.165.189.133:8123)
    ↓ xiaohui_digital_employee integration (本仓库)
    ↓ service-token 海刚 JWT 代理 (内部 secret 签发)
小辉后端 3001 (xiaohui-2-backend)
```

## 🔒 优势

- ✅ 复用 HA 已有语音集成（任何支持 HA 的智能音箱都行）
- ✅ 不需要小智后台/小智云配置
- ✅ 不需要 SSE/WS 公网域名
- ✅ 不暴露任何公网入口
- ✅ 永久受益（HA 生态不断扩展）

## 📚 关联仓库

- 主仓库: https://gitee.com/khsm/xiaohui-digital-employee
- commit: 232d6d9f V1.4 HA integration (8 文件)