# MaaOpenWeb
**Repository Path**: wei-mohe/maa-open-web
## Basic Information
- **Project Name**: MaaOpenWeb
- **Description**: 这是一个自动定时网址打开器
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# MaaPracticeBoilerplate
本仓库为 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 所提供的项目模板，开发者可基于此模板直接创建自己的 MaaXXX 项目。
> **MaaFramework** 是基于图像识别技术、运用 [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) 开发经验去芜存菁、完全重写的新一代自动化黑盒测试框架。
> 低代码的同时仍拥有高扩展性，旨在打造一款丰富、领先、且实用的开源库，助力开发者轻松编写出更好的黑盒测试程序，并推广普及。
## 即刻开始
- [📄 快速开始](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md)
- [🎞️ 视频教程](https://www.bilibili.com/video/BV1yr421E7MW)
## 如何开发
0. 使用右上角 `Use this template` - `Create a new repository` 来基于本模板创建您自己的项目。
1. 克隆本项目（地址请修改为您基于本模板创建的新项目地址）。
```bash
git clone https://github.com/MaaXYZ/MaaPracticeBoilerplate.git
```
2. 下载 MaaFramework 的 [Release 包](https://github.com/MaaXYZ/MaaFramework/releases)，解压到 `deps` 文件夹中。
3. 下载 OCR（文字识别）资源文件 [ppocr_v5.zip](https://download.maafw.xyz/MaaCommonAssets/OCR/ppocr_v5/ppocr_v5-zh_cn.zip) 解压到 `assets/resource/model/ocr/` 目录下，确保路径如下：
```tree
assets/resource/model/ocr/
├── det.onnx
├── keys.txt
└── rec.onnx
```
_请注意，您不需要将 OCR 资源文件上传到您的代码仓库中。`.gitignore` 已经忽略了 `assets/resource/model/ocr/` 目录，且 GitHub workflow 在发布版本时会自动配置这些资源文件。_
4. 进行开发工作，按您的业务需求修改 `assets` 中的资源文件，请参考 [MaaFramework 相关文档](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/zh_cn/1.1-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B.md#%E8%B5%84%E6%BA%90%E5%87%86%E5%A4%87)。
5. 完成开发后，上传您的代码并发布版本。
```bash
# 配置 git 信息（仅第一次需要，后续不用再配置）
git config user.name "您的 GitHub 昵称"
git config user.email "您的 GitHub 邮箱"
# 提交修改
git add .
git commit -m "XX 新功能"
git push origin HEAD -u
```
6. 发布您的版本
需要**先**修改仓库设置 `Settings` - `Actions` - `General` - `Read and write permissions` - `Save`
```bash
# CI 检测到 tag 会自动进行发版
git tag v1.0.0
git push origin v1.0.0
```
7. 更多操作，请参考 [个性化配置](./docs/zh_cn/个性化配置.md)（可选）
## 生态共建
MAA 正计划建设为一类项目，而非舟的单一软件。
若您的项目依赖于 MaaFramework，我们欢迎您将它命名为 MaaXXX, MXA, MAX 等等。当然，这是许可而不是限制，您也可以自由选择其他与 MAA 无关的名字，完全取决于您自己的想法！
同时，我们也非常欢迎您提出 PR，在 [社区项目列表](https://github.com/MaaXYZ/MaaFramework#%E7%A4%BE%E5%8C%BA%E9%A1%B9%E7%9B%AE) 中添加上您的项目！
## FAQ
### 0. 我是第一次使用 git，这是什么？视频演示中那个黑框框命令行哪来的？
黑框框是 git bash，几乎任何现代软件的开发都离不开 git，建议先参考 [菜鸟教程](https://www.runoob.com/git/git-install-setup.html) 或搜索一些视频，学习完 git 后再来进行后续开发工作。
### 1. 我是第一次使用 Python，在命令行输入 `python ./configure.py` 或 `python -m pip install MaaFW` 之后没有反应？没有报错，也没有提示成功，什么都没有
Win10 或者 Win11 系统自带了一份 "Python"，但它其实只是一个安装器，是没法用的。
你需要做的是关闭它或者删除它的环境变量，然后自己去 Python 官网下载并安装一份 Python。
[参考方法](https://www.bilibili.com/read/cv24692025/)
### 2. 使用 MaaDebugger 或 MaaPicli 时弹窗报错，应用程序错误：应用程序无法正常启动
一般是电脑缺少某些运行库，请安装一下 [vc_redist](https://aka.ms/vs/17/release/vc_redist.x64.exe) 。
### 3. 我在这个仓库里提了 Issue 很久没人回复
这里是《项目模板》仓库，它仅仅是一个模板，一般很少会修改，开发者也较少关注。
在此仓库请仅提问模板相关问题，其他问题最好前往对应的仓库提出，如果有 log，最好也带上它（`debug/maa.log` 文件）
- MaaFW 本身及 MaaPiCli 的问题：[MaaFramework/issues](https://github.com/MaaXYZ/MaaFramework/issues)
- MaaDebugger 的问题：[MaaDebugger/issues](https://github.com/MaaXYZ/MaaDebugger/issues)
- 不知道算是哪里的、其他疑问等：[讨论区](https://github.com/MaaXYZ/MaaFramework/discussions)
### 4. OCR 文字识别一直没有识别结果，报错 "Failed to load det or rec", "ocrer_ is null"
**请仔细阅读文档**，你无视了前面步骤的报错。我不想解释了，请再把本文档仔细阅读一遍！
## 鸣谢
本项目由 **[MaaFramework](https://github.com/MaaXYZ/MaaFramework)** 强力驱动！
感谢以下开发者对本项目作出的贡献（下面链接改成你自己的项目地址）:
[](https://github.com/MaaXYZ/MaaFramework/graphs/contributors)