P03-每日英语单词记忆卡片工具

# -*- coding: utf-8 -*-
# @Time    : 2025/6/6 21:00
# @Author  : AI悦创
# @FileName: main.py
# @Software: PyCharm
# @Blog    ：https://bornforthis.cn/
# code is far away from bugs with the god animal protecting
#    I love animals. They taste delicious.
import random  # 导入 random 模块，用于随机抽取单词

# 函数：从词库文件中读取单词，返回一个字典 {英文: 中文}
def load_words(file_path):
    word_dict = {}  # 创建一个空字典，用来保存单词和释义
    with open(file_path, "r", encoding="utf-8") as f:  # 打开文件，确保使用 utf-8 编码
        for line in f:
            if ':' in line:  # 每行必须包含冒号，作为英文:中文的分隔
                eng, chi = line.strip().split(':', 1)  # 分割英文和中文部分
                word_dict[eng] = chi  # 添加到字典中
    return word_dict  # 返回完整词典

# 函数：学习环节，每次随机抽取 count 个单词进行记忆
def study_session(words, count=5):
    to_review = []  # 创建一个列表，用来保存没记住的单词
    # 从全部单词中随机抽取 count 个，如果词典不足则取全部
    todays_words = random.sample(list(words.items()), min(count, len(words)))

    print("\n📚 今天的单词：")
    # 遍历抽取的单词列表
    for eng, chi in todays_words:
        print(f"\n英文：{eng}")  # 显示英文单词
        input("按 Enter 查看中文意思...")  # 等待用户确认
        print(f"中文：{chi}")  # 显示中文释义

        # 询问用户是否掌握
        remember = input("是否记住了？(y/n): ").strip().lower()
        if remember != 'y':
            # 如果没记住，就添加到待复习列表
            to_review.append((eng, chi))

    return to_review  # 返回未掌握的单词列表

# 函数：将未记住的单词保存到复习文件中
def save_to_review(words, file_path):
    with open(file_path, "a", encoding="utf-8") as f:  # 以追加模式打开复习文件
        for eng, chi in words:
            f.write(f"{eng}:{chi}\n")  # 每行写入一个单词

# 主函数：整个程序的入口
def main():
    words = load_words("word_list.txt")  # 从文件中加载词典
    to_review = study_session(words, count=5)  # 启动学习模式，返回未掌握单词列表

    # 如果有未掌握单词，就保存到复习列表
    if to_review:
        print("\n💾 将未掌握的单词保存到 review_list.txt 中...")
        save_to_review(to_review, "review_list.txt")
    else:
        # 如果全记住了，给出鼓励
        print("\n🎉 恭喜你！今天的单词全部掌握了！")

# 如果当前脚本是主程序，则执行 main()
if __name__ == "__main__":
    main()

import random      # 用于随机抽取单词
import json        # 用于保存学习记录为 JSON 格式
import os          # 用于判断文件是否存在
from datetime import datetime  # 获取当前日期时间

# 函数：从文件加载单词，返回字典 {英文: 中文}
def load_words(file_path):
    word_dict = {}
    if not os.path.exists(file_path):  # 文件不存在时返回空字典
        return word_dict
    with open(file_path, "r", encoding="utf-8") as f:
        for line in f:
            if ':' in line:
                eng, chi = line.strip().split(':', 1)
                word_dict[eng] = chi
    return word_dict

# 函数：学习一个词典列表（支持新词或复习词），返回未记住的单词
def study_session(words, count=None, title="今日学习"):
    to_review = []  # 未记住单词列表
    remembered_count = 0  # 记住数量计数器

    # 获取指定数量的单词（或全部）
    if count:
        todays_words = random.sample(list(words.items()), min(count, len(words)))
    else:
        todays_words = list(words.items())

    print(f"\n📚 {title}：共 {len(todays_words)} 个单词")

    for eng, chi in todays_words:
        print(f"\n英文：{eng}")
        input("按 Enter 查看中文意思...")
        print(f"中文：{chi}")
        remember = input("是否记住了？(y/n): ").strip().lower()
        if remember == 'y':
            remembered_count += 1
        else:
            to_review.append((eng, chi))

    # 显示学习进度
    print(f"\n✅ 学习完成！记住了 {remembered_count} / {len(todays_words)} 个单词")

    return to_review, remembered_count, len(todays_words)

# 函数：将单词追加保存到指定文件中（如 review_list.txt）
def save_to_file(words, file_path):
    with open(file_path, "a", encoding="utf-8") as f:
        for eng, chi in words:
            f.write(f"{eng}:{chi}\n")

# 函数：保存学习记录为 JSON 文件，包含日期、记住数量等信息
def save_study_log(date_str, remembered, total):
    log = {
        "date": date_str,
        "remembered": remembered,
        "total": total
    }
    log_file = "study_log.json"

    # 如果已有日志，先加载
    if os.path.exists(log_file):
        with open(log_file, "r", encoding="utf-8") as f:
            logs = json.load(f)
    else:
        logs = []

    logs.append(log)  # 添加今天的记录

    # 覆盖写入
    with open(log_file, "w", encoding="utf-8") as f:
        json.dump(logs, f, ensure_ascii=False, indent=2)

# 主函数：整合流程
def main():
    print("🔔 欢迎使用每日英语记忆卡片工具")

    # 是否先复习之前未掌握的单词
    review_choice = input("是否要复习上次未掌握的单词？(y/n): ").strip().lower()
    if review_choice == 'y':
        review_words = load_words("review_list.txt")
        if review_words:
            to_review, remembered, total = study_session(review_words, title="🔁 复习环节")
            save_study_log(datetime.today().strftime("%Y-%m-%d"), remembered, total)
        else:
            print("📂 当前没有需要复习的单词。")

    # 主学习环节
    all_words = load_words("word_list.txt")
    to_review, remembered, total = study_session(all_words, count=5, title="📖 今日新词")
    if to_review:
        print("\n💾 保存未掌握单词到 review_list.txt...")
        save_to_file(to_review, "review_list.txt")

    # 保存学习日志
    date_str = datetime.today().strftime("%Y-%m-%d")
    save_study_log(date_str, remembered, total)

    print("📌 今日学习已完成，日志已记录。")

# 如果是主文件，启动程序
if __name__ == "__main__":
    main()

import random
import json
import os
from datetime import datetime

# 加载单词：从文件读取 {英文: 中文}
def load_words(file_path):
    word_dict = {}
    if not os.path.exists(file_path):
        return word_dict
    with open(file_path, "r", encoding="utf-8") as f:
        for line in f:
            if ':' in line:
                eng, chi = line.strip().split(':', 1)
                word_dict[eng] = chi
    return word_dict

# 学习环节：英文 -> 中文
def study_session(words, count=5, title="📖 新词学习"):
    to_review = []  # 未掌握
    remembered = 0  # 已掌握数量

    todays_words = random.sample(list(words.items()), min(count, len(words)))
    print(f"\n{title}（共 {len(todays_words)} 个单词）")

    for eng, chi in todays_words:
        print(f"\n英文：{eng}")
        input("按 Enter 查看中文意思...")
        print(f"中文：{chi}")
        remember = input("是否记住了？(y/n): ").strip().lower()
        if remember == 'y':
            remembered += 1
        else:
            to_review.append((eng, chi))

    print(f"✅ 学习完成：记住 {remembered}/{len(todays_words)}")
    return to_review, remembered, len(todays_words)

# 复习错题本：中文猜英文
def test_chi_to_eng(words, count=5):
    mistakes = []  # 错题本
    correct = 0    # 正确计数

    todays_words = random.sample(list(words.items()), min(count, len(words)))
    print(f"\n🧩 中文猜英文测试（共 {len(todays_words)} 个）")

    for eng, chi in todays_words:
        print(f"\n中文意思：{chi}")
        answer = input("请输入对应英文单词：").strip().lower()
        if answer == eng.lower():
            print("✅ 正确！")
            correct += 1
        else:
            print(f"❌ 错误，正确答案是：{eng}")
            mistakes.append((eng, chi))

    print(f"📊 测试完成：正确 {correct}/{len(todays_words)}")
    return mistakes, correct, len(todays_words)

# 保存未掌握或错题到指定文件
def save_to_file(words, file_path):
    with open(file_path, "a", encoding="utf-8") as f:
        for eng, chi in words:
            f.write(f"{eng}:{chi}\n")

# 保存学习或测试日志到 JSON
def save_log(date_str, remembered, total, log_file):
    log = {
        "date": date_str,
        "remembered": remembered,
        "total": total
    }
    if os.path.exists(log_file):
        with open(log_file, "r", encoding="utf-8") as f:
            logs = json.load(f)
    else:
        logs = []
    logs.append(log)
    with open(log_file, "w", encoding="utf-8") as f:
        json.dump(logs, f, ensure_ascii=False, indent=2)

# 主程序入口
def main():
    print("🔔 欢迎使用每日英语记忆卡片工具（进阶版）")

    # 1️⃣ 是否复习未掌握单词
    if input("是否先复习未掌握单词？(y/n): ").strip().lower() == 'y':
        review_words = load_words("review_list.txt")
        if review_words:
            to_review, remembered, total = study_session(review_words, title="🔁 复习未掌握单词")
            save_log(datetime.today().strftime("%Y-%m-%d"), remembered, total, "study_log.json")
        else:
            print("📂 没有需要复习的单词。")

    # 2️⃣ 今日新词学习
    all_words = load_words("word_list.txt")
    to_review, remembered, total = study_session(all_words, count=5, title="📖 今日新词")
    if to_review:
        print("💾 保存未掌握单词到 review_list.txt...")
        save_to_file(to_review, "review_list.txt")
    save_log(datetime.today().strftime("%Y-%m-%d"), remembered, total, "study_log.json")

    # 3️⃣ 是否进行 中文猜英文 测试
    if input("是否开始中文猜英文测试？(y/n): ").strip().lower() == 'y':
        test_words = load_words("word_list.txt")
        mistakes, correct, total_test = test_chi_to_eng(test_words, count=5)
        if mistakes:
            print("💾 保存拼写错误的单词到 mistake_list.txt...")
            save_to_file(mistakes, "mistake_list.txt")
        save_log(datetime.today().strftime("%Y-%m-%d"), correct, total_test, "test_log.json")

    print("🎉 今日任务全部完成，Good job!")

# 启动
if __name__ == "__main__":
    main()