基于 cxOrz/chaoxing-signin 的增强版本
相比原项目，本 Fork 新增以下功能：
- 🖥️ 多平台支持 - Windows、macOS (Intel + Apple Silicon)、Android 全平台覆盖
- 📦 便携版本 - 独立可执行文件，无需安装依赖
- 🎨 黑白极简 UI - 重新设计的现代化界面，简洁优雅
- 🚀 快速启动 - 优化启动流程，首次初始化后秒开
- 🔧 一键部署 - 提供自动化脚本，简化安装过程
- ✅ 普通签到、拍照签到、手势签到
- ✅ 位置签到、签到码签到、二维码签到
- ✅ 多用户凭据储存
- ✅ IM 协议自动签到（监听模式）
- ✅ QQ机器人 / 邮件 / pushplus 推送
前往 Releases 页面下载对应平台的版本。
方式一：使用 EXE（推荐）
- 下载
Chaoxing.exe - 右键选择"以管理员身份运行"
- 浏览器自动打开 http://localhost:5000
方式二：使用批处理脚本
START.bat- 普通启动START-ADMIN.bat- 管理员权限启动（推荐）
方式一：使用 DMG（推荐）
- 下载
超星学习通签到.dmg（Universal Binary，支持 Intel 和 Apple Silicon） - 双击打开，拖动到"应用程序"文件夹
- 右键点击应用选择"打开"（首次运行必须）
- 在对话框中再次点击"打开"
方式二：使用命令行版本
- 下载
Chaoxing-macos（shell 脚本，会自动调用对应的二进制文件） - 右键点击文件，选择"打开"（首次运行必须）
- 在对话框中点击"打开"
- 之后可以在终端运行：
./Chaoxing-macos
版本选择：
Chaoxing-macos- Universal Binary 包装脚本（推荐，支持所有Mac）Chaoxing-macos-arm64- Apple Silicon 包装脚本 (M1/M2/M3)Chaoxing-macos-x64- Intel 包装脚本
- 首次运行必须右键选择"打开"，这是 macOS 安全机制
- 文件是 shell 脚本包装器，会自动调用对应的二进制文件
- 不能直接双击运行未签名的应用
- 详细说明：macOS安全警告解决方案.md
- 下载
chaoxing-signin.apk - 允许安装未知来源应用
- 安装并打开应用
# 克隆仓库
git clone https://github.com/ymylive/chaoxing-signin.git
cd chaoxing-signin
# 安装依赖
pnpm install
# 开发模式运行
pnpm dev| 平台 | 架构 | 文件 | 状态 |
|---|---|---|---|
| Windows | x64 | Chaoxing.exe | ✅ 支持 |
| macOS | Universal | 超星学习通签到.dmg | ✅ 支持 |
| macOS | Universal | Chaoxing-macos | ✅ 支持 |
| macOS | Apple Silicon | Chaoxing-macos-arm64 | ✅ 支持 |
| macOS | Intel | Chaoxing-macos-x64 | ✅ 支持 |
| Android | ARM/x86 | chaoxing-signin.apk | ✅ 支持 |
根目录下：
pnpm dev- 运行Web开发服务器、后端接口pnpm build- 构建前端页面、转译后端代码pnpm start- 运行手动签到pnpm serve- 启动后端接口pnpm monitor- 启动监听模式，自动签到
apps/server 目录下：
pnpm build- 转译代码pnpm start- 运行手动签到功能pnpm serve- 启动接口pnpm monitor- 启动监听模式
apps/web 目录下：
pnpm dev- 运行 Web 开发服务器pnpm build- 构建静态页面
拍摄二维码照片，识别后复制 enc 参数值（例如 1D0A628CK317F44CCC378M5KD92），在询问时填入。
参考：#178
使用 百度拾取坐标系统 获取经纬度，并提供详细地址。
示例：河南省郑州市中原区华中师范大学附属郑州万科城小学
访问 超星云盘，在根目录上传照片，命名为 0.jpg 或 0.png。
无需准备，直接运行即可。
支持以下推送方式：
- QQ机器人 - 配合 go-cqhttp 使用
- 邮件推送
- pushplus推送
注意： 监听模式建议每次启用 2-4 小时，不要长时间挂载。
可以部署到服务器使用网页版本：
- 前端界面：查看 apps/web 的详细说明
- 后端服务：查看 apps/server 的详细说明
docker pull ghcr.io/cxorz/chaoxing-signin:latest
docker run -d -p 80:80 -p 5000:5000 ghcr.io/cxorz/chaoxing-signin# 1. 构建项目
pnpm run prepack:build
# 2. 打包 Windows EXE
pnpm run win:build-exe
# 3. 运行制作脚本
# Windows: 双击运行 制作便携版.bat详细说明：便携版完整说明.md
- 多平台支持说明.md - 所有平台的使用说明
- macOS安装指南.md - macOS 详细安装步骤
- macOS安全警告解决方案.md - 解决 Gatekeeper 警告
- macOS代码签名配置.md - 配置 Apple 证书
- 便携版完整说明.md - Windows 便携版说明
- Windows使用说明.md - Windows 使用指南
- DockerGuide.md - Docker 部署指南
chaoxing-signin/
├── apps/
│ ├── server/ # 后端服务 (Koa + TypeScript)
│ └── web/ # 前端界面 (React + Material UI)
├── packages/ # 共享包
├── launcher/ # Windows 启动器
├── scripts/ # 构建和工具脚本
│ ├── build-macos-app.sh # macOS 应用打包
│ └── fix-macos-security.sh # macOS 安全修复
├── .github/workflows/ # GitHub Actions 自动化构建
├── START.bat # Windows 启动脚本
├── START-ADMIN.bat # 管理员启动脚本
└── 制作便携版.bat # 便携版制作脚本
点击"更多信息"，然后选择"仍要运行"。应用未签名是正常的。
查看 macOS安全警告解决方案.md 获取详细解决方法。
前往"设置" > "安全"，允许"未知来源"或"安装未知应用"。
uname -m
# arm64 = Apple Silicon (M1/M2/M3)
# x86_64 = Intel欢迎提交 Issue 和 Pull Request！
本项目基于 cxOrz/chaoxing-signin 开发，感谢原作者的开源贡献！
本项目仅作为交流学习使用，通过本项目加深网络通信、接口编写、交互设计等方面知识的理解，请勿用作商业用途，任何人或组织使用项目中代码进行的任何违法行为与本人无关。