《软考人必看！告别手动F5，我用Python写了个“成绩解放器”，支持NAS部署秒推微信》
大家好，我是这个小工具的开发者。
作为一名经历过软考（计算机技术与软件专业技术资格考试）折磨的考生，我深知“查成绩”这个环节有多反人类：官网从来不准时，只能蹲在电脑前疯狂刷新，或者眼巴巴盯着群里别人的消息。
为了彻底解决这个痛点，我开发了ruankao-monitor—— 一个轻量级的软考成绩监控助手。
简单来说，它能帮你：
- 24小时自动监控软考官网（ruankao.org.cn）。
- 一旦出成绩，立即通过微信、邮件、钉钉等渠道通知你。
- 部署极简，不需要昂贵的服务器，家里的 NAS（群晖/威联通/飞牛等）就能跑，且内存占用极低（<50MB）。
不用再焦虑地刷新网页了，出分那一刻，它会像闹钟一样叫醒你。
🛠️ 一、核心功能特性
- 多平台推送：支持 Server酱（微信推送）、企业微信、钉钉、Bark（iOS）、SMTP邮件。
- NAS友好：基于 Docker 打包，x86/ARM 架构通吃，非常适合挂机运行。
- 防误报：内置多种 HTML 解析策略，即使官网微调也能稳定运行。
- 去重机制：状态持久化，重启容器不会导致微信消息刷屏。
🚀 二、手把手部署教程 (Docker版)
如果你有一台 7x24 小时开机的 NAS 或服务器，请按照以下步骤操作，一分钟即可上线。
第一步：准备配置文件
你需要先创建一个配置文件config.yaml。你可以直接在服务器上创建，或者下载模板修改。
# 1. 创建项目目录并进入 mkdir -p ruankao-monitor && cd ruankao-monitor # 2. 下载配置文件模板 wget https://raw.githubusercontent.com/jason-PLA/ruankao-monitor/main/config.yaml.example -O config.yaml第二步：配置通知渠道（关键步骤）
使用编辑器（如nano或vim）打开config.yaml，填入你的通知信息。
- 微信推送（推荐 Server酱）：
去 Server酱官网获取SendKey，填入server_chan_skey字段。 - 邮件推送：
填入你的 SMTP 服务器地址、端口、发件箱账号和授权码。 - 其他（钉钉/企业微信）：
填入对应的 Webhook 地址即可。
第三步：启动容器
项目根目录下有一个docker-compose.yml文件，或者你可以直接使用以下命令运行：
# 使用 Docker Compose (推荐) docker-compose up -d # 或者使用纯 Docker 命令 docker run -d \ --name ruankao-monitor \ -v $(pwd)/config.yaml:/app/config.yaml \ jason-pla/ruankao-monitor:latest第四步：坐等出分
启动后，容器会自动开始轮询软考官网。当检测到成绩查询入口出现时，你会立刻收到推送！
💡 三、给非技术用户的建议
如果你不太熟悉 Docker 命令，但使用的是群晖（Synology）或飞牛NAS（fnOS）：
- 在套件中心安装Docker。
- 打开 Docker 图形界面，注册表搜索
jason-pla/ruankao-monitor。 - 挂载路径：将本地的
config.yaml映射到容器内的/app/config.yaml。 - 启动即可。
📦 开源与反馈
这个项目是MIT 开源协议的，代码托管在 GitHub：
GitHub 仓库地址：https://github.com/jason-PLA/ruankao-monitor
如果你在部署过程中遇到问题，或者有新的功能建议（比如支持 Telegram），欢迎去 Issues 区提，或者直接在本帖回复。希望能帮到正在焦虑等成绩的你，祝大家逢考必过！🎉