家长接口 (Parent API)

ParentAccount 类继承自 StudentAccount，提供了家长端的操作接口。

功能限制

家长账号继承自学生账号，但部分功能不可用。家长账号可以查看孩子的考试成绩、作业等信息，但无法获取班级同学列表等涉及其他学生隐私的信息。

初始化

通常通过登录函数获取 ParentAccount 实例：

from zhixuewang import login_playwright
parent = login_playwright("username", "password").to_parent()

可用功能

家长账号支持以下功能（与学生账号相同）：

考试相关

• 获取最新考试 - 获取孩子最近一次的考试信息
• 获取考试 - 根据 ID 或名称获取考试信息
• 获取所有考试 - 获取孩子的所有历史考试

成绩与详情

• 获取某次考试成绩 - 获取指定考试的详细成绩
• 获取某次考试的所有学科 - 获取某次考试中包含的所有学科信息
• 获取原卷图片 - 获取指定考试指定学科的原卷图片
• 获取答题详情 - 获取指定考试指定学科的详细答题情况
• 获取错题本 - 获取指定考试指定学科的错题本信息

作业相关

• 获取作业列表 - 获取孩子的作业列表
• 获取作业答案 - 获取指定作业的答案
• 获取作业资源 - 获取自由出题作业的资源

不可用功能

以下功能在家长账号中不可用，调用时会抛出 NotImplementedError 异常：

• ❌ set_base_info() - 家长账户无法获取基本信息
• ❌ get_classmates() - 家长账户无法获取同班同学列表
• ❌ get_clazzs() - 家长账户无法获取班级列表
• ❌ get_clazz() - 家长账户无法获取班级信息

使用示例

查看孩子的最新成绩

# 获取最新考试成绩
mark = parent.get_self_mark()

print("孩子的考试成绩：")
for subject_score in mark:
    print(f"{subject_score.subject.name}: {subject_score.score}分")
    print(f"班级排名: {subject_score.class_rank}")
    print(f"年级排名: {subject_score.grade_rank}")
    print("---")

查看所有考试

exams = parent.get_exams()

print(f"共有 {len(exams)} 场考试")
for exam in exams:
    print(f"- {exam.name}")

查看作业完成情况

# 获取未完成的作业
homeworks = parent.get_homeworks(is_complete=False)

print(f"待完成作业: {len(homeworks)} 项")
for hw in homeworks:
    print(f"作业: {hw.title}")
    print(f"学科: {hw.type.name}")
    print(f"截止时间: {hw.end_time}")
    print("---")

# 获取已完成的作业
completed = parent.get_homeworks(is_complete=True, size=10)
print(f"已完成作业: {len(completed)} 项")

与学生账号的区别

功能类别	家长账号	学生账号
查看考试成绩	✅	✅
查看作业	✅	✅
查看原卷图片	✅	✅
查看答题详情	✅	✅
查看错题本	✅	✅
获取班级列表	❌	✅
获取同学列表	❌	✅
获取基本信息	❌	✅