寵物飲食紀錄使用指南

本指南提供有關如何使用寵物飲食紀錄主要功能的詳細說明。

使用者帳戶

您的使用者帳戶是管理您的寵物和追蹤其飲食的中心樞紐。

建立帳戶

  1. 註冊：導覽至「開始使用」頁面。
  2. 有四種方式可以建立帳戶：
    輸入您的詳細資料（應用程式的表單）：提供您的電子郵件地址和安全的密碼。
    Google/GitHub：使用 Google 或 GitHub 建立帳戶。
    Line：使用 Line 建立帳戶。
    使用 Line 註冊，頁面將重新導向至填寫電子郵件和密碼的表單。
  3. 註冊：按一下「註冊」按鈕以建立您的帳戶。

登入

  1. 登入：前往「登入」頁面。
  2. 輸入您的憑證：輸入您的電子郵件和密碼。
  3. 存取您的帳戶：按一下「登入」按鈕以存取您的儀表板。

第三方登入

您也可以使用第三方提供者登入，以獲得更流暢的體驗。

時區

應用程式會在您的帳戶設定期間自動設定您的當地時區，以確保所有飲食紀錄都是準確的。

寵物管理

「寵物」區段可讓您為每隻寵物建立和管理個人資料。

新增寵物

  1. 前往寵物：從主選單導覽至「使用者的貓」區段。
  2. 新增寵物：按一下「新增寵物」按鈕。
  3. 輸入寵物詳細資料：填寫您寵物的姓名、物種和其他相關資訊。
  4. 儲存：按一下「新增貓」以儲存個人資料。

顯示和編輯寵物"

從主選單導覽至「使用者的貓」區段。下拉式選單會顯示所有寵物的姓名。按一下寵物的姓名以查看其詳細的個人資料。

  • 編輯：從寵物的個人資料頁面，按一下「編輯寵物姓名個人資料」以更新其資訊。
  • 刪除：在寵物的個人資料頁面按下刪除按鈕並確認，寵物的紀錄也會一起刪除。

乾糧儲存

「乾糧儲存」功能可協助您追蹤寵物的乾糧庫存。

新增乾糧

  1. 前往乾糧：導覽至「乾糧儲存」區段。
  2. 新乾糧：按一下下拉式選單中的「新增乾糧」。
  3. 輸入食物詳細資料：提供乾糧的品牌、食物類型、說明/品牌和數量。
  4. 儲存：按一下「新增乾糧」以將其新增至您的庫存。

管理庫存

  • 顯示：顯示所有乾糧及其目前數量的清單。
  • 刪除：從您的庫存中移除乾糧項目。
  • 補貨：開新的一包時，按「補貨」並輸入份量，剩餘量會從新的一包重新計算。
  • 吃完日期：每筆乾糧紀錄都會從這包扣除，App 會顯示剩下多少，並預測什麼時候會吃完。

飲食紀錄

飲食紀錄用於記錄您寵物的每日飲食，例如餵食時間、份量和健康觀察。

建立飲食紀錄

  1. 前往飲食紀錄：導覽至「飲食紀錄」區段。
  2. 新增飲食紀錄：在寵物姓名的飲食紀錄頁面，按一下「為寵物姓名新增飲食紀錄」按鈕。
  3. 選取寵物：在下拉式選單中選擇「寵物姓名的飲食紀錄」。
  4. 輸入詳細資料：填寫飲食詳細資料，例如食物類型、餵食時間和任何注意事項。
  5. 儲存：按一下「為寵物姓名新增記錄」以記錄您要建立的飲食資訊。

從 CSV 上傳飲食紀錄

對於大量資料輸入，您可以從 CSV 檔案上傳飲食紀錄。

  1. 前往飲食紀錄：導覽至「飲食紀錄」部分。
  2. 上傳 CSV：按一下「選擇檔案」按鈕。
  3. 選擇檔案：選取您要上傳的 CSV 檔案。
  4. 上傳：按一下「上傳」以上傳及處理檔案。

📋 上傳指南摘要

要成功上傳寵物的飲食記錄，請確保CSV文件包含以下項目並確定這些項目需有數據：

檔案必須以分號（;）分隔，格式與在紀錄表頁面下載的 CSV 相同，所以最簡單的方式是先匯出，再編輯那個檔案。儲存前會檢查每一列：日期必須正確且不早於寵物的生日，份量與體重必須是數字。只要有任何一列有問題，就不會匯入任何資料，並會告訴您要修正哪幾列。

欄位名稱 說明 範例
日期 餵食日期 2026-01-14
餵食時間 提供食物的時間 19:50
食物類型 食物類型（濕/乾） 濕食
品牌 品牌名稱 ciao
說明 產品名稱或口味 IMC-222 果凍杯
份量 提供的總份量（克） 105
飢餓程度 貓的食慾狀況 見下文

🥣 “飢餓”列選項

請選擇以下飢餓程度（包括符號）：

  • 💖 是，很餓，馬上吃
  • ❌ 不太餓，沒興趣
  • 🔺 不太餓。只吃了一點

💡 CSV 範例

您需使用此格式的文件上傳：

日期 2026-01-14
餵食時間 19:50, 21:46,
食物類型 Wet
品牌 ciao
說明 IMC-222 果凍杯 鮪魚+雞肉+干貝 x3
份量 105
飢餓程度 💖 Yes, eat right away

最愛食物與圖表

您的紀錄會變成寵物最愛食物的排行，以及進食量和體重的圖表。

最愛食物

  1. 打開清單：在選單中打開「紀錄表」→「寵物名 的最愛清單」。
  2. 看分數：每一餐都會依寵物有多餓、有多喜歡、剩下多少，以及多常回來吃，得到一個最愛分數。每種食物會列出它最好的五天。
  3. 依食物種類篩選，例如只看乾糧。
  4. 看價格：用上方的「飼料價格」連結，看寵物最愛的飼料在哪裡買最便宜。

圖表

  • 紀錄表頁面會依您選的日期範圍，畫出每天吃的乾糧、濕食與體重。
  • 紀錄表中的體重和今天頁面上 ⚖️ 體重的紀錄會一起顯示。
  • 在紀錄的備註寫上 hotel、boarding 或 旅館，那些餐會分開畫出，住宿期間就不會影響在家的趨勢。
  • 可以把圖表下載成圖片，或分享出去。

家庭：照顧者與觀看者

您的貓、飼料、貓砂盆和喝水地點組成您的家庭。您是擁有者，可以管理一切；家人和保母也可以幫忙。從選單（🏠 我的家庭成員）或帳號頁面打開。

誰可以做什麼

  • 照顧者（家人、保母）可以記錄餵食、貓砂、喝水和用藥，也能看您的紀錄表和圖表。他們需要帳號。
  • 觀看者（例如阿嬤）只能看今天的狀態、時間軸和圖表。他們使用個人連結，不需要帳號。

邀請照顧者

  1. 在「邀請照顧者」輸入對方的 email 並寄出邀請。
  2. 對方打開信中的連結，建立帳號（或用同一個 email 以 Google 或 LINE 登入）後加入。連結只能用一次，7 天內有效，且只限該 email。
  3. 對方會來到今天頁面，看到您貓咪的按鈕。

觀看連結

  1. 在「觀看連結」建立連結，取個名字（例如：阿嬤），也可以設定到期日。
  2. 複製連結，用 LINE 或 email 傳出去。每位觀看者都有自己的連結。
  3. 隨時可以關閉，連結會立刻失效。

貓砂盆與喝水地點

  • 新增、改名、選擇碗或飲水機、上下移動，以及移除每個貓砂盆和喝水地點。
  • 每個地點的每項工作都有一行提醒設定：關閉、每隔幾小時或幾天，或固定時間。用該地點的「儲存」按鈕儲存。

成員、離開與移交

  • 在家庭頁面移除照顧者或觀看者；他們也可以在自己的帳號頁面按「離開」。
  • 把家庭移交給成員：對方接受後就成為擁有者，您則留下來當照顧者。
  • 只是來幫忙的人，也可以在帳號頁面新增自己的貓（「新增我自己的貓」），這會建立他自己的家庭。

今天頁面

今天頁面顯示您所在的每個家庭：每個貓砂盆和喝水地點一行、每隻貓一張卡片，以及過去 24 小時的時間軸。每個人的變更都會即時出現，不用重新整理。

記錄照顧

  • 按一下就記錄您剛做的事：🍽 餵食、⚖️ 體重（輸入公斤）、💊 用藥、🚽 清貓砂 / ♻️ 全部更換 / 🧽 洗貓砂盆、💧 加水 / 🧽 清洗 / 🔄 換濾心。
  • 會出現提示，可以「復原」（10 秒內）、用「5 · 10 · 15 分鐘前」改時間，以及「加入細節」。
  • 如果 30 分鐘內已經有人記錄過同樣的照顧，會問「要再記錄一次嗎？」。
  • 餵食細節會建議家裡的飼料和貓咪的最愛。擁有者可以用「加入紀錄表」把一次餵食變成完整的紀錄。

修正紀錄

  • 按下後 10 秒內可以復原。
  • 在時間軸上修改紀錄：時間（最多 7 天前）、工作項目、細節或備註。
  • 確認後刪除記錯的紀錄；它會從今天頁面、圖表、CSV 和提醒中移除。
  • 擁有者可以修改和刪除任何紀錄；照顧者可以在 24 小時內修改自己的紀錄。

貓砂觀察

  • 在貓砂紀錄的「加入細節」：哪隻貓（如果知道）、尿塊、便便數量、便便狀態，以及任何異常（血、特別大的尿塊、其他）。
  • 拉肚子和異常會以紅色顯示。選了貓咪的話，也會在那隻貓的紀錄表頁面顯示 30 天。

用藥

不管是誰餵藥，每一劑都記得清清楚楚。

餵藥

  1. 新增藥物：擁有者為每隻貓新增（貓咪檔案 → 用藥）：名稱、劑量、一天最多 4 次（或不設時間代表「需要時」），以及日期。
  2. 記錄一劑：今天頁面上的 💊 用藥會列出今天還沒記錄的劑量：「已給藥」，或「沒給成」並寫下原因。
  3. 看狀態：每一劑會顯示該給、已給（綠色）、沒給成（橘色）或逾時（紅色，超過時間一小時後）。記錄已經給過的劑量前會先詢問。

提醒

貓砂盆、飲水機或該餵藥的時候到了，就會提醒您。

設定提醒

  1. 選擇頻率（擁有者）：在家庭頁面，為每個貓砂盆和喝水地點的工作選擇一天 3 次、一天 2 次、每天、一週 2 次、每週、每 2 週、一個月 2 次、每月或自訂（小時或天），從上次完成的時間起算；或固定時間（最多 6 個，例如 08:00 和 20:00）。
  2. 開啟提醒：在今天頁面您家庭名稱下方，按 🔔 提醒旁的「開啟」。每位擁有者和照顧者各自選擇；觀看者不會收到提醒。
  3. 在今天頁面查看：例如「🧽 飲水機清洗 4 天後到期」或「🚽 清貓砂 20:00 到期」。

何時、如何收到

  • 某天到期的工作會在您時區的早上 9 點送出；較短的間隔會在到期時送出（早上 9 點到晚上 9 點之間）；固定時間則在那個時間送出。如果還沒做，會再提醒一次。逾時的用藥會提醒一次。
  • 有用 Android App 就在 App 收到，否則用 LINE 登入的會在 LINE 收到，其他則用 email。
  • 體重提醒會用 LINE 或 email 寄送。

飼料價格

Pet Tracker 會查詢寵物最愛的飼料在台灣網路商店的價格，讓您用最好的價格買到牠喜歡的那一款。

會查哪些飼料

  • 最愛清單上最愛分數 30 分以上、最近 4 個月有吃的乾糧（最多 5 款）。
  • 價格來自 BigGo（涵蓋蝦皮、momo、Yahoo、Coupang、樂天等商店的比價網站）以及 PChome 24h。
  • 照商品販售的名稱來記錄：品牌加上產品名稱，包含口味（鴨肉、雞肉…）和產品代碼（IN27…）。App 會用這些來分辨正確的商品。

看價格頁面

  1. 打開：到寵物的檔案頁按「飼料價格」，或用最愛清單上的連結。
  2. 比較：每款飼料一張卡片，依最愛順序排列。價格依每公斤價格排序，最便宜的在前面，不同包裝大小也能公平比較。
  3. 購買：按商品會打開商店頁面。每個價格會顯示在哪裡找到、什麼時候找到。
  4. 「目前在商店找不到這款飼料。」表示 BigGo 和 PChome 目前都沒有販售。請檢查紀錄中品牌和描述的拼寫。

更新與每月 email

  • 每月 1 號會自動查詢價格並寄 email 給您，依您的時區使用繁體中文、日本語或 English。
  • 按「立即更新」可以今天查詢，每隻寵物一天一次。大約一分鐘後會有結果，請重新整理頁面。
  • 價格僅供參考，商店經常調整，購買前請先到商店確認。

健康檢查

把寵物的健檢和驗血結果放在同一個地方，看看它們怎麼變化。

新增健康檢查

  1. 打開：從寵物的檔案頁進入「健康檢查」，新增一筆。
  2. 輸入結果：檢查日期和報告上的數值：血球、腎臟、肝臟、胰臟、心臟，以及 FIV、FeLV 等其他結果。
  3. 儲存：結果會依日期列出，也可以一次刪除多筆。

用 AI 讀報告

  1. 加入 Gemini API 金鑰：在帳號設定貼上您自己的 Google Gemini API 金鑰（頁面上有取得方式的說明）。
  2. 上傳照片：在健康檢查表單上傳報告的照片（最多 5 張，每張 10 MB）。
  3. 確認結果：Gemini 會填入它讀到的數值。儲存前請對照報告確認。

看診

看醫生前先準備問題，看完後記下醫生的回答。

看診前後

  1. 寫下問題：從寵物的檔案頁進入「看診」，加入問題和看診日期。
  2. 邀請幫手：用 email 加入其他成員，讓他們也能看到問題並幫忙回答。
  3. 記錄回答：看完後寫下醫生的回答，也可以一次填好幾題。
  4. 加入細節：醫生姓名、看診目的（疫苗、健檢、洗牙、手術、美容、急診、回診或其他），以及等待和看診各花了多久。

分享、匯出與備份

您的紀錄屬於您：可以分享、下載，也可以從別處匯入。

分享寵物的紀錄

  • 擁有者可以在紀錄表頁面建立唯讀連結，讓獸醫或保母看寵物的餵食紀錄和圖表。
  • 選擇有效期間：1 天、7 天、30 天或不過期。隨時可以停止分享，連結會立刻失效。

下載與備份

  • 在紀錄表頁面將紀錄匯出為 CSV，也可以勾選多筆一次刪除。
  • 擁有者可以在家庭頁面下載所有照顧紀錄（餵食、體重、貓砂、喝水、用藥），以家庭的時區顯示。
  • 每天只要有修改紀錄，就會用 email 寄給您一份 CSV 備份。

您的帳號

  • 如果手機遺失或用過公用電腦，可以在帳號頁面「登出其他裝置」。

Android App 與 PWA

在手機上使用 Pet Tracker：Android App，或從瀏覽器安裝。

Android App

  • 用 email 登入，或用 Google、LINE、GitHub 登入：App 上會開啟一個 Chrome 分頁，完成後回到 App 並已登入。
  • 在今天頁面開啟 🔔 提醒時，會詢問是否允許通知。之後提醒會以通知送達，點一下就會打開今天頁面。
  • 在 App 登出後，那支手機就不會再收到通知。

漸進式網頁應用程式（PWA）

  1. 在手機上用支援的瀏覽器打開 App。
  2. 在瀏覽器選單選擇「加入主畫面」或「安裝」。
  3. 像原生 App 一樣從主畫面開啟。