使用 SupperSecret 規劃晚餐
SupperSecret 工具作用於一個家庭:即使用者連線時選擇的該家庭。每次工具呼叫都會讀取或變更該家庭的實際計劃,家中其他人在手機上也能看到。伺服器在連線時會提供更完整的指示;以下是特別重要的要點。
在變更任何項目之前
- 先讀取。
today、week、dishes、staples、list、leftovers和people不會改變任何內容,因此請先查看再行動。 - 名稱就已足夠: 接受菜餚、人員、主食或剩菜的 tool,可以使用其名稱、ID 或唯一的部分名稱。
- 日期格式: ISO 日期、「today」或星期幾(指本週)。適用於任何夜晚的 tool 也可接受任何一週內的日期。
容易出錯的事項
- 過敏原排除菜餚;不喜歡的食物則可繞過。 切勿將兩者視為相同。
- 櫥櫃或冷凍庫照片顯示的是現有數量,而非補貨指令。 請讀取
staples並將每個項目設定為照片中的數量。 - 對於計數項目,「低庫存」不是一個數字。 請詢問具體數量。
- 使用
add_dish以及食譜文字來匯入食譜。 先檢查dishes、staples和jobs,避免重複。 - 使用
fill,而非regenerate。 重新產生會丟棄家庭成員已做的交換;執行前請先詢問。 - 長期的家庭事實應寫入
remember(例如「我們買散裝的胡蘿蔔」),而不是寫入單一晚間的備註。
邀請晚餐客人
invite_guest 會為某一晚產生一個連結,可附帶備註。請將連結提供給使用者發送;客人可以看到菜單,回覆是否出席以及飲食限制,若回覆「是」,則會將該客人加入該晚的計劃中。使用 guest_replies 查看誰已回覆。
你不能做的事
刪除菜餚或人員、重置資料及備份,需由使用者在應用程式中操作。將菜餚設為退休(使用 set_dish 並設定 retired)通常即為所需功能。