kiri icon

kiri

kiri 是一款以 Go 開發的終端機植物照護追蹤工具,使用本機 SQLite 管理資料,可記錄澆水排程、查看照護歷史,並可從命令列輸出植物狀態。

kiri

概覽

kiri 是一款以 Go 為基礎的終端機使用者介面植物照護追蹤工具。它會將植物資料保存在輕量級的 SQLite 資料庫中,並結合澆水提醒、照護歷史,以及針對戶外植物的天氣感知調整。

這個應用程式同時適合互動式操作與可被腳本化的使用方式。在終端機中,它提供分頁導覽、行事曆任務檢視,以及滑鼠/鍵盤支援;在 TUI 之外,則可輸出植物狀態或 JSON,供系統狀態列與自訂腳本使用。

核心功能

互動式 TUI 儀表板

在終端機介面中透過分頁導覽、卡片格狀檢視、每月行事曆任務檢視,以及滑鼠/鍵盤控制來追蹤澆水需求。

動態含水模型

以時間推估濕度下降,而不是使用固定的每日下降值,因此植物狀態會在照護事件之間平順更新。

考量天氣的澆水計算

對戶外植物而言,kiri 會在可取得天氣資料時納入季節變化、即時氣溫,以及來自 Open-Meteo 的降水資訊來計算澆水需求。

行事曆與歷史紀錄

在同一個應用程式中規劃即將到來的澆水任務,並按時間順序檢視先前動作的照護紀錄。

可供腳本使用的命令列輸出

使用內建旗標,例如 --status、--summary 和 --json,為腳本、終端機狀態列及其他非互動式工作流程輸出植物資訊。

透明終端機模式

以透明模式執行應用程式,避免背景終端機底色填滿,方便與自訂終端機主題或平鋪式視窗管理器融合。

常見使用情境

  • 本機植物追蹤

    適合想用終端機方式追蹤澆水排程、歷史與即將到來任務,且不想把資料移到獨立網路服務的植物主人。

  • 考量天氣的照護規劃

    適合管理戶外植物、希望澆水計算能依據氣溫與降水變化,而不是固定提醒排程的人。

  • 終端機自動化與儀表板

    適合偏好 shell 工作流程的使用者,因為 kiri 可以輸出狀態、摘要行或 JSON,供腳本與終端機狀態列使用。

  • 快速試用與介面檢視

    適合想快速評估介面的人,因為第一次執行時可將示範植物填入資料庫,並立即顯示行事曆與圖表。

  • 主題化終端機設定

    適合重視終端機主題或平鋪式視窗管理器設定,並希望應用程式以透明模式融入自訂版面配置的使用者。

Pros and Cons

Pros

  • 將植物資料保存在本機 SQLite 中,而不是依賴遠端帳號或雲端資料庫。
  • 同時支援視覺化 TUI 工作流程與供腳本及狀態列使用的非互動式命令列輸出。
  • 針對戶外植物提供考量天氣的邏輯,同時也支援室內植物與備援計算。
  • 內建行事曆與歷史紀錄,方便使用者規劃未來澆水並回顧過去照護。

Cons

  • README 指出若從原始碼執行,需要 Go 1.22 或更高版本。
  • 以天氣為基礎的計算取決於可用的 Open-Meteo 資料;當天氣資料不可用時,kiri 會回退到可設定的溫度值。
  • 部分安裝方式仍在進行中,包括 README 路線圖/備註中提到的 Homebrew 支援與官方 AUR 套件。

FAQ

我可以在不先加入植物的情況下試用 kiri 嗎?

是。README 將 kiri 描述為一款本機的植物照護 TUI 夥伴,第一次執行時可自動將示範植物加入資料庫,讓你不必手動設定就能試用介面。

執行 kiri 需要什麼?

README 說 kiri 以 Go 開發,使用本機 SQLite 資料庫,且從原始碼執行時需要 Go 1.22 或以上。它也提到此應用程式以現代終端機模擬器為目標。

kiri 能在互動式 TUI 之外使用嗎?

可以。kiri 支援內建輸出旗標,例如 --status、--summary 和 --json,適合用於腳本與系統狀態列,例如 Waybar、Polybar、i3blocks 和 tmux。

kiri 的資料和設定存放在哪裡?

可以。專案會將植物資料本機儲存在 ~/.config/kiri/data.db,並將設定存放在 ~/.config/kiri/settings.toml,備份則位於相同的 XDG 設定位置。

kiri 可以如何安裝?

儲存庫說明可從 Releases 頁面取得獨立二進位檔與 .deb 套件,也提供原始碼建置、Nix、Go install 與基於 Makefile 的安裝方式。

Quick Facts

類別
開發者工具
主要介面
終端機使用者介面(TUI)
資料儲存
本機 SQLite 資料庫
天氣來源
Open-Meteo API
定價形式
託管於 GitHub 的開源專案;GitHub 為公開儲存庫提供免費方案,並為團隊與企業提供付費方案
儲存庫網域
github.com