问题 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-CN.md