問題 CatQuest 指南

將專案的 giip 問題以可愛的貓咪角色進行視覺化，讓你一眼就能輕鬆掌握每個問題的進度。

🐾 前往 CatQuest 頁面 →

📋 概述

問題 CatQuest 將目前所選專案(csn)下的 giip 問題以 貓咪角色卡片 的形式呈現。每個問題顯示為一張卡片，貓咪的 行為（動畫） 會依問題狀態(status)而變化。它是一個用於輕鬆瀏覽進度的趣味檢視，而非枯燥的表格——底層資料與經典問題列表完全相同。

🐱 依狀態區分的貓咪行為

每張卡片的貓咪會依問題的狀態值做出不同的動作。

問題狀態	貓咪行為	意義
PENDING	玩耍中 (playing)	尚未開始、等待中的問題
READY	準備狩獵 (ready)	即將開始的問題
IN_PROGRESS	狩獵中 (hunting)	正在處理中的問題
REVIEW	叼著獵物等待 (delivering)	等待審核的問題
DONE	玩耍中 (playing)	已完成的問題

• 同一個問題始終分配同一隻貓咪（8 種：mochi、sherlock、nimbus、pixel、cocoa、midnight、luna、leo）。
• 場景背景色也依狀態以柔和色調區分。

🔍 介面構成

1. 頂部標題列

• 📋 經典列表：以表格形式的標準列表(giip-issues)檢視相同的問題。
• Refresh：重新載入問題列表。
• + New Issue：前往新建問題的註冊頁面。

2. 摘要徽章

顯示目前專案的 進行中(Active) 問題數與 已完成(Done) 問題數。進行中的問題排在前面，已完成的排在後面。

3. 貓咪卡片

每張卡片包含以下資訊：

• 問題標題（氣泡）、狀態徽章、問題編號(#isn)
• 等待徽章(⏳ #編號)：當該問題因其他問題而等待時顯示，點擊可跳轉到造成阻塞（佔用）問題的詳情。
• 註冊時間(🐣)、最後留言時間(💬)、摘要
• 點擊卡片可開啟該問題的詳情頁面。

4. 分頁

每頁顯示 30 筆；當問題較多時，使用底部的翻頁按鈕(« ‹ 1 2 3 › ")進行翻頁。

💡 注意事項

• 本頁面為 管理員介面。是否顯示取決於存取層級（tMenuConfig 中的最小層級）。
• 若未選擇專案，會顯示 "No Project Selected"。請從頂部導覽選擇一個專案。
• 載入問題列表需要登入（認證權杖 AK）。工作階段過期時請重新登入。
• 無障礙：若系統啟用了「減少動態效果(prefers-reduced-motion)」，猛撲等大幅度動作會被替換為柔和的呼吸動畫。

🔌 透過 API 處理資料

CatQuest 透過讀取 giip 問題列表 API(giipIssues)來繪製介面。關於如何以程式化方式查詢、建立與變更問題狀態，請參閱下面的文件。

📘 CatQuest 資料 API 參考 →

疑難排解

現象	原因	解決
僅顯示 "No Project Selected"	未選擇專案(csn)	從頂部選擇一個專案。
一隻貓都沒有(😿)	該專案沒有問題	新建一個問題或選擇其他專案。
"Unauthorized" / 401 錯誤	工作階段過期或未登入	重新登入後點擊 Refresh。
頂部指南按鈕(📖)不可見	指南對應缺失（舊版本）	部署本指南後即正常顯示。

---

版本: 1.0 最後更新: 2026-07-24 原始檔案: giipv3/public/help/catquest.zh-TW.md