Home Assistant

Tích hợp Kept cho Home Assistant cho thấy những gì cần bạn ở mỗi địa điểm và gửi các chỉ số ngược lại, chẳng hạn như số km mà tích hợp xe đã biết. Nó đọc Kept bằng token cá nhân.

Tích hợp: keptinventory/kept-homeassistant, cài đặt với HACS dưới dạng kho tùy chỉnh.

Tùy chọn: chỉ khi bạn đã chạy Home Assistant. Kept hoạt động y hệt khi không có nó.

Ứng dụng và tích hợp

• Ứng dụng chạy Kept trên Home Assistant OS (cài đặt nó). Kept trên máy chủ của bạn hoạt động y hệt.
• Tích hợp đưa Kept vào Home Assistant: các cảm biến, lịch và hành động. Chỉ tích hợp mới thêm được thực thể, nên ứng dụng không thể.
• Với ứng dụng, không có gì để sao chép: Home Assistant tự tìm thấy ứng dụng Kept và xin kết nối; bạn cho phép trong Kept. Không cần token, không cần https.

Trước khi bắt đầu

Bạn cần	Tại sao
Home Assistant 2026.10 hoặc mới hơn	Tích hợp được xây dựng và kiểm thử dựa trên nó
HACS trong Home Assistant	Nó cài đặt tích hợp. Tải HACS (nó cần gì)
Kept 1.8.0 hoặc mới hơn	Nó thêm bản tóm tắt mà các cảm biến đọc
Một token cá nhân	Ứng dụng chỉ tạo token qua HTTPS (HTTPS); trên mạng gia đình qua http, tạo token trên máy chủ
Home Assistant truy cập được Kept	Cùng mạng, VPN như Tailscale, hoặc địa chỉ công cộng. Thử: mở địa chỉ Kept từ máy chạy Home Assistant

Những gì bạn nhận được

Mỗi địa điểm là một thiết bị trong Home Assistant:

Thực thể	Nội dung hiển thị
Quá hạn, Đến hạn, Sắp hết hạn	Số lượng trên Trang chủ của Kept. Thuộc tính items liệt kê 10 mục đầu, gấp gáp nhất trước
Đã cho mượn, Mượn về	Các khoản cho mượn đang mở. Chỉ ở nơi Cho mượn đang bật
Không chắc chắn, Lâu không thấy	Đồ vật có vị trí đáng ngờ, hoặc chưa thấy trong số tháng của địa điểm
Tồn kho thấp	Đồ vật dưới mức tối thiểu. Chỉ ở nơi Tiêu hao đang bật
Chưa có vị trí, Đồ vật	Tắt ban đầu; bật chúng trong Home Assistant
Ngày đến hạn (lịch)	Mọi đồ vật có ngày đến hạn, là sự kiện cả ngày

Mỗi phương tiện (một đồ vật có chỉ số, dưới Phương tiện) là một thiết bị trong địa điểm của nó:

Thực thể	Nội dung hiển thị
Chỉ số	Chỉ số mới nhất, tính bằng km, dặm hoặc giờ
Bảo dưỡng tiếp theo	Ngày đến hạn, hoặc ước lượng của Kept từ các chỉ số của bạn
Bảo dưỡng tiếp theo ở	Chỉ số đến hạn

Một địa điểm hoặc phương tiện thêm sau trong Kept sẽ hiện ra sau khi bạn tải lại tích hợp.

Thiết lập từ ứng dụng

Với ứng dụng Kept trong cùng Home Assistant, không cần tạo hay sao chép token, và không cần https.

1. Cài đặt tích hợp bằng HACS (bước 2 của Thiết lập) rồi khởi động lại Home Assistant.
2. Thêm tích hợp. Cài đặt → Thiết bị & dịch vụ hiện Kept là đã phát hiện. Thêm nó và xác nhận.
3. Cho phép trong Kept. Home Assistant hiện một mã và chờ. Mở Kept (thanh bên cũng được) tại Cài đặt → Kết nối: Home Assistant xin kết nối hiện cùng mã đó. Bấm Cho phép, chọn các địa điểm và chọn những gì nó được làm, như với một token.
4. Xong. Home Assistant tự hoàn tất và cho biết phiên bản Kept cùng các địa điểm của bạn.

Home Assistant nhận được gì: một token cá nhân bình thường tên Home Assistant, do bạn tạo và hành động thay bạn, cho các địa điểm bạn đã chọn. Nó đi từ Kept sang Home Assistant qua mạng nội bộ của Home Assistant và không bao giờ hiện trên trang nào. Thu hồi nó tại Cài đặt → Kết nối. Yêu cầu không ai cho phép trong 10 phút sẽ kết thúc: hãy bắt đầu lại từ Home Assistant. Kept chỉ tạo token khi Home Assistant nhận nó: nếu Home Assistant ngừng chờ trước đó, hoặc Kept khởi động lại, sẽ không có token nào được tạo.

Thiết lập

1. Tạo token. Trong Kept, Cài đặt → Kết nối → Token mới. Chọn các địa điểm Home Assistant cần thấy. Chỉ đọc đủ cho cảm biến và lịch; Đọc và thay đổi cũng cho phép các hành động dưới gửi chỉ số và đánh dấu lịch đã xong. Ứng dụng chỉ tạo token khi Kept phục vụ qua https (HTTPS); qua http, người quản trị máy chủ tạo bằng kept admin token create.
2. Cài đặt. Trong HACS, ⋮ → Kho tùy chỉnh (cách làm): thêm https://github.com/keptinventory/kept-homeassistant, loại Integration. Cài đặt Kept, và khởi động lại Home Assistant.
3. Thêm tích hợp. Cài đặt → Thiết bị & dịch vụ → Thêm tích hợp → Kept. Nhập địa chỉ Kept (https://kept.example.org) và token. Tắt Kiểm tra chứng chỉ HTTPS chỉ cho chứng chỉ tự ký trên mạng của bạn.
4. Kiểm tra. Bước tiếp theo nêu tên phiên bản Kept của bạn và các địa điểm token chạm tới. Gửi thêm chúng.

Thiết lập báo gì khi có lỗi:

Thông báo	Điều cần làm
Không truy cập được Kept	Kiểm tra địa chỉ và Home Assistant truy cập được máy chủ đó
Đó không phải Kept	Địa chỉ trả lời, nhưng bằng thứ khác: trang proxy, ứng dụng khác
Địa chỉ đó chuyển hướng sang HTTPS	Dùng địa chỉ https:// mà nó nêu
Chứng chỉ HTTPS không được tin cậy	Dùng chứng chỉ tin cậy, hoặc tắt kiểm tra cho chứng chỉ tự ký
HTTPS thất bại	Kept phục vụ http thuần túy trên cổng đó: dùng http://
Kept từ chối token	Token bị thu hồi, hết hạn hoặc gõ sai: tạo token mới
Kept này không cung cấp bản tóm tắt	Cập nhật Kept

Cấu hình trên tích hợp chọn những địa điểm nào của token sẽ hiện và tần suất đọc Kept (mỗi 5 phút; 1 đến 60). Khi token bị thu hồi hoặc hết hạn, Home Assistant yêu cầu token mới.

Trên bảng điều khiển

ID thực thể xuất phát từ tên trong Kept. Với địa điểm gọi là Home và xe gọi là Corolla: sensor.home_overdue, sensor.home_due, sensor.home_expiring, sensor.home_lent_out, sensor.home_low_stock, calendar.home_due_dates, sensor.corolla_reading, sensor.corolla_next_service. Xem của bạn tại Cài đặt → Thiết bị & dịch vụ → Kept.

Một thẻ tile cho mỗi số lượng, hoặc một thẻ entities:

type: entities
title: Kept, Home
entities:
  - sensor.home_overdue
  - sensor.home_due
  - sensor.home_expiring
  - sensor.home_lent_out
  - sensor.home_low_stock
  - sensor.corolla_next_service

Lịch Ngày đến hạn hiển thị trong bảng Lịch của Home Assistant.

Hành động

Kept: Ghi chỉ số (kept.log_reading) gửi chỉ số cho một phương tiện (hoặc chỉ số, bằng id của nó: meter_id của cảm biến Chỉ số). Nó hiện trong Kept như chỉ số từ Home Assistant. Kept từ chối chỉ số thấp hơn chỉ số trước, và hành động thất bại với lý do của Kept; một nhảy Kept cho là không chắc chắn chờ duyệt trong Hộp thư đến.

Kept: Đánh dấu lịch đã xong (kept.complete_schedule) đánh dấu lịch xong vào một ngày (hôm nay, theo múi giờ của địa điểm) và ghi nhận bảo dưỡng, kèm chỉ số cho lịch theo chỉ số. Lịch một lần sau đó xong và rời khỏi số lượng; đánh dấu xong lại sẽ thất bại.

Cả hai cần token Đọc và thay đổi.

Số km xe, gửi đến Kept

Khi số km xe đã ổn định 10 phút (xe đã đỗ):

alias: Odometer to Kept
triggers:
  - trigger: state
    entity_id: sensor.my_car_odometer
    for: "00:10:00"
conditions:
  - condition: template
    value_template: "{{ trigger.to_state.state | is_number }}"
actions:
  - action: kept.log_reading
    data:
      device_id: YOUR_KEPT_VEHICLE_DEVICE_ID
      value: "{{ trigger.to_state.state | float }}"
mode: queued

sensor.my_car_odometer là cảm biến của tích hợp xe của bạn. Trong trình soạn tự động hóa, chọn phương tiện Kept trong trường Phương tiện của hành động để điền device_id. Gửi chỉ số theo đơn vị của chỉ số phương tiện trong Kept.

Cập nhật hoặc xóa

• Cập nhật: bản phát hành mới hiện dưới Cài đặt → Cập nhật (HACS thêm nó vào đó). Cài đặt nó và khởi động lại Home Assistant.
• Xóa: Cài đặt → Thiết bị & dịch vụ → Kept → ⋮ → Xóa, sau đó xóa Kept trong HACS và khởi động lại. Thu hồi token trong Kept: Cài đặt → Kết nối.

Nó đọc gì

Mỗi vài phút, với token: GET /api/v1/summary (số lượng theo địa điểm), GET /api/v1/vehicles và trang đầu của GET /api/v1/agenda. Lịch đọc GET /api/v1/agenda cho các ngày nó hiển thị. Hành động dùng POST /api/v1/meters/{id}/readings và POST /api/v1/schedules/{id}/complete. Token chỉ thấy địa điểm của nó, và không bao giờ nhiều hơn những gì bạn thấy. Cùng bản tóm tắt cấp cho tiện ích bảng điều khiển.