JSF 导航模式

SIGAA 使用 JavaServer Faces (JSF) 和 jsCookMenu。所有菜单操作都需要使用最新的 ViewState 和 jscook_action 进行 POST 请求：

bash
VS=$(curl -s -b $SIGAACOOKIEFILE -c $SIGAACOOKIEFILE \
${SIGAA_URL}/sigaa/portais/discente/discente.jsf | \
grep -oP name=javax\.faces\.ViewState[^>]*value=\K[^]+ | head -1)

curl -s -L -b $SIGAACOOKIEFILE -c $SIGAACOOKIEFILE \
-X POST ${SIGAA_URL}/sigaa/portais/discente/discente.jsf \
-d menu%3Aformmenudiscente=menu%3Aformmenudiscente \
-d id=${SIGAAUSERID} \
--data-urlencode jscookaction=menuformmenudiscentediscentemenu:A]#{BEAN.method} \
--data-urlencode javax.faces.ViewState=${VS}

完整操作参考 → references/student-guide.md 和 references/professor-guide.md

解析响应

python
import re, html as h

def clean_html(content):
content = re.sub(r]>.?, , content, flags=re.DOTALL)
content = re.sub(r]>.?, , content, flags=re.DOTALL)
text = re.sub(r<[^>]+>, , content)
return h.unescape(re.sub(r[ \t]+, , text))

def extracttablerows(html_content):
content = re.sub(r]>.?, , html_content, flags=re.DOTALL)
rows = re.findall(r]>(.?), content, re.DOTALL)
result = []
for row in rows:
cells = re.findall(r]>(.?), row, re.DOTALL)
clean = [h.unescape(re.sub(r<[^>]+>|\s+, , c)).strip() for c in cells if c.strip()]
if clean:
result.append(clean)
return result

安全说明

• - 凭据仅通过环境变量传递 — 切勿作为 CLI 参数传递（防止 shell 历史记录泄露）
• Cookie 文件：自动创建并设置 chmod 600，通过 trap 在 shell 退出时自动删除
• 速率限制：请求间延迟 0.5 秒（内置于脚本中）
• 会话范围：SIGAA 会话在约 20 分钟无活动后过期 — 如果被重定向到登录页面，请重新加载登录
• 网络目标：脚本仅联系 $SIGAA_URL 和从登录重定向派生的 CAS SSO 主机 — 运行前请确认这些与您的机构匹配

常见问题

参考

• - references/institutions.md — 支持的机构、登录 URL、用户名格式
• references/student-guide.md — 完整的学生门户指南、所有 JSF 操作、解析技巧
• references/professor-guide.md — 教师门户、成绩/考勤工作流程