JUNLI · MANUAL · v0.1

小龜旬曆
操作手冊

這份手冊帶你走一遍小龜旬曆的完整用法 —— 從第一次打開、新增一事,到三十六旬節律、晨暮之儀、共享誌與 iCloud 同步。
預計閱讀時間 12 分鐘。

首次打開

下載並登入 iCloud 後第一次打開 App,你看到的是「今日視圖」。上方三個小圖示 —— 從左到右分別是 + 新事、⌕ 搜尋、⚙ 設定。下方 TabBar 五個切換:今日 / 旬曆 / # 道 / @ 誌 / 習慣

今日視圖

頂部三顆圓 · 底部五個 tab

三顆頂部 icon 掌管所有 App 全局操作 —— 新增、搜尋、設定。下方 TabBar 是「我要做什麼」:看今天、看全年、按道、按誌、看習慣。

品牌原則 — 左上角沒有漢堡選單,也沒有頭像。所有設定都進 ⚙ 的 bottom sheet,動線乾淨。

三語彙 · 道 / 誌 / 事

小龜旬曆的分類系統是三層的,三層各司其職:

語彙 符號 性質 舉例
# 橫向分類 · 一事可掛多道 #健康 · #閱讀 · #運動 · #冥想
@ 縱向主體 · 一事只屬一誌 @家計簿 · @讀書筆記 · @旅行日誌
具體待辦 · 有日期、象限、子事 去圖書館還書、早起慢跑 30 分
關鍵規則 — 一件「事」只能屬於一個「誌」(你只能記在一本冊子裡),但可以掛多條「道」(它橫跨了哪幾條你生命的軌跡)。

新增第一事

  1. 點右上角 + 圓形小按鈕。彈出新事窗。
  2. 寫標題,例如「週末慢跑 5 公里」。
  3. 選歸屬的 @ 誌(例如 @健身誌)。
  4. 掛上相關的 # 道(例如 #運動、#健康),可掛多條。
  5. 日期 / 時段(今日 / 本旬 / 下旬 / 特定日期)。
  6. 四方象限(Q1 重要緊急 / Q2 重要不緊急 / Q3 不重要緊急 / Q4 不重要不緊急)。
  7. 確認 → 這件事同時出現在今日列表、該誌、該道、該旬。

今日視圖

「今日」是日常使用頻率最高的頁面。由上而下依序是:

  1. 日期列:2026 · 第十二旬 · DAY 3 / 10 + 節氣「穀雨 · 萬物始長」
  2. h1 日期:四月廿二 · 週三 + 列表 / 四方圖切換
  3. 時段性儀式卡:早上出現「晨起之儀」,傍晚換成「日暮之儀」,中間時段是「靜室」
  4. 本旬進度條:10 個圓點顯示本旬第幾日,配百分比與 streak
  5. 今日 / 本旬 / 下旬 三段折疊列表

左滑 / 右滑 / 長按

事列的三種手勢:勾完後 左滑 封存;未勾 右滑 刪除;長按 改名或拖曳到其他旬。

今日視圖手勢

36 旬節律

一年分作 36 旬,每旬 10 日。TabBar 中間的「旬曆」tab 進入整年視圖,有兩種風格:

B 變體 · 方陣

36 格 6×6 方陣,每格是一旬。深色 = 達成率高、rust 框 = 當前旬。點任一格進入「旬詳情」:該旬十日、習慣達成、該旬的事。

C 變體 · 日晷

36 旬圍成圓,像年輪 / 曆書。春 1 月在上、秋 7 月在下。可在 Tweaks 或內部切換。

旬詳情 × 回味連動 — 點 B / C 旬進去後,「習慣達成」那一列的「晨起之儀 9/10」「日暮之儀 7/10」可點,直接跳到該類型的回味紀錄。

四方定序

艾森豪矩陣:重要 × 緊急。在今日頂部點「四方圖」切換。事可以 拖曳 在四個象限之間移動(HTML5 原生拖放)。

四方圖

專注未竟之事

勾完的事不顯示在格子裡,但標頭仍計入「· 已成 N」,讓你看得到進度也不分心。

Q1 立即做;Q2 規劃做(主力);Q3 委派批次;Q4 考慮刪。

習慣與龜息

TabBar 最右邊「習慣」。每個習慣是一張 360 日熱圖,對應 36 旬 × 10 日。拖曳可排序,置頂功能放在長按選單。特殊的「晨起之儀」「日暮之儀」點了不是進熱圖,而是直接開儀式答題。

晨起之儀

時段 05:00–10:59 打開 App,今日頂部自動出現「早安 · 晨起之儀」邀請卡。點「入儀」進入全屏儀式。

  1. 一息:深色圓圈呼吸動畫,四秒吸四秒吐。可打勾「一息已成」。
  2. 三事:寫下今日最想做的三件事。
  3. 一語:用一句話寫下今日意圖,例如「今日穩,不急」。
  4. 點「啟程」完成。本日晨儀卡自動變成「晨儀已成 · 連 N 日」。

日暮之儀

時段 17:00–23:59。同樣的入口、不同的問題:

回味模式

寫過的儀式不會消失,全部存在「回味」裡。三個入口:

  1. 儀式卡右側「回味」pill(任何時段都在)
  2. 設定頁 → 儀式 → 回味 · 儀式紀錄
  3. B/C 旬詳情點習慣列的「回味 →」徽章

公曆 / 旬曆雙視圖

回味裡可切換 公曆(一月 30 日長條)或 旬曆(十日一旬大格)。點任一日濾到那一日的紀錄。

日暮紀錄用文氣排版 —— 三好大字 SERIF,三省小字節制,明日一定以 rust 引語框特寫。

回味旬曆視圖

共享誌

誌可以邀請家人 / 同事共編。進入任一 @ 誌的詳情頁 → 點「+ 邀請」。

  1. 填對方 email(需有 iCloud 帳號)
  2. 選權限:共編 / 唯讀 / 僅看 assigned
  3. 送出 → 系統產生 iCloud 邀請連結(CKShare 格式)
  4. 對方點連結 → 自動加入該誌
  5. 之後雙方任一人改事,幾秒內同步給彼此
識別 — 共享過的誌封面右上角會多一枚紅色「共」印,總覽頁也會標出來。獨書的誌沒有這枚印。

iCloud 同步

小龜旬曆完全走 Apple CloudKit:

額度 — CloudKit 每用戶 100 MB 資料庫 + 10 GB Assets,個人用完全用不完。

設定頁

點右上 ⚙ 打開,6 個區塊:

Apple ID · 頭像 · 名字 · iCloud 帳號
外觀夜色模式 · 事標籤(Q 象限 / 第 N 旬)· # 道關聯提示
儀式晨暮時段 · 通知時間 · 週末跳過 · 立即儀式 / 本旬回顧 / 回味入口
同步iCloud 狀態 · 3 台裝置 · 共享誌管理 · 立即同步 / 登出
付費當前方案 · 升級到小龜會員 / 家庭會員 · 恢復購買
關於版本 · 隱私 · 條款 · 開源授權

點右上 ⌕ 打開。單一輸入框可同時搜:

每條結果點了直接跳到對應頁 —— 道 / 誌 / 事編輯 / 回味特定日。

常見問題

為什麼不叫「日曆」或「週曆」?

西曆 365 日太散、農曆繁、週曆太切。三十六旬介於其中:10 日一段給節奏,36 段蓋滿一年給視野。每旬有節氣、有達成、有儀式 —— 它是節律裝置,不是時間表。

資料會不會被我們看到?

不會。所有資料走 CloudKit 存在你自己的 iCloud,我們沒有伺服器也沒有後端。連你的 email 都在你自己的 Apple ID 裡。

沒用 iPhone / 沒 iCloud 可以用嗎?

目前不行。v0.1 是 Apple 生態專屬(iPhone / iPad / Mac)。Android 版 待 v2.0 才會開工,屆時會用 Supabase 做獨立後端。

為什麼是一次買斷不訂閱?

因為用 iCloud 同步,我們沒有雲端成本。沒有成本就不用月月收錢。龜系哲學對抗的就是「月月被扣款」的焦躁感 —— 所以一次付,永久用。

如果 App 停止更新我的資料會怎樣?

資料在你自己的 iCloud 裡,即使我們消失了你的紀錄還在。設定 → 同步與共享可匯出 JSON。

晨儀 / 暮儀時段可以調嗎?

可以。設定 → 儀式 → 時段,預設是 05:00–11:00 晨、17:00–24:00 暮,可自行改。也能關週末提醒。

── 手冊終 ──
JUNLI · v0.1 · 2026