{"id":50590462,"url":"https://github.com/ok-oldking/ok-script-app","last_synced_at":"2026-06-05T10:01:11.692Z","repository":{"id":304846536,"uuid":"1020192359","full_name":"ok-oldking/ok-script-app","owner":"ok-oldking","description":"Python版按键精灵基于ok-script开发","archived":false,"fork":false,"pushed_at":"2026-06-02T15:07:31.000Z","size":9974,"stargazers_count":110,"open_issues_count":0,"forks_count":202,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-02T15:12:09.533Z","etag":null,"topics":["ai","automation","ok-script","okscript","okww","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ok-oldking.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-15T13:35:33.000Z","updated_at":"2026-06-02T14:59:33.000Z","dependencies_parsed_at":"2025-07-16T13:23:50.318Z","dependency_job_id":"3a00f061-eda5-4578-b639-bbea1dfd6bc8","html_url":"https://github.com/ok-oldking/ok-script-app","commit_stats":null,"previous_names":["ok-oldking/ok-script-boilerplate","ok-oldking/ok-py","ok-oldking/ok-script-app"],"tags_count":25,"template":true,"template_full_name":null,"purl":"pkg:github/ok-oldking/ok-script-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ok-oldking%2Fok-script-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ok-oldking%2Fok-script-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ok-oldking%2Fok-script-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ok-oldking%2Fok-script-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ok-oldking","download_url":"https://codeload.github.com/ok-oldking/ok-script-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ok-oldking%2Fok-script-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33939226,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","ok-script","okscript","okww","python"],"created_at":"2026-06-05T10:01:10.806Z","updated_at":"2026-06-05T10:01:11.682Z","avatar_url":"https://github.com/ok-oldking.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ok-py\n\n[English](README_en.md) | 中文\n\nok-py 是一个基于 [ok-script](https://github.com/ok-oldking/ok-script) 的 Python 自动化项目模板。它提供了可直接运行的 GUI、任务示例、配置控件示例、OCR 示例、模板匹配示例、测试用例和打包配置，适合用来快速创建自己的 Windows 自动化脚本项目。\n\n这个仓库不是某个具体游戏的自动化成品，而是 ok-script 应用的起步工程和功能演示。\n\n### 功能演示\n\n**API 列表与脚本录制**\n\n![image_scripting](docs/images/image_scripting.png)\n\n**多种截图与交互方式**\n\n![image_screenshot](docs/images/image_capture.png)\n\n**标注管理与模板匹配**\n\n![image_template](docs/images/image_template.png)\n![image_markup](docs/images/image_markup.png)\n\n## 主要内容\n\n- 可直接启动的 ok-script GUI 应用入口。\n- `MyOneTimeTask` 示例任务，演示常用任务 API 和配置控件。\n- 配置控件示例：下拉框、布尔值、整数、浮点数、字符串、多行文本、列表、多选、文件选择、文件夹选择、全局配置和按钮组。\n- OCR、相对区域识别和模板匹配示例。\n- `ConfigOption` 全局配置示例。\n- `TaskTestCase` 自动化测试示例。\n- i18n 翻译文件和 `.mo` 编译产物。\n- `pyappify.yml` 和 GitHub Actions 打包发布配置。\n\n## 快速开始\n\n本项目建议使用 Python 3.12。Windows 自动化通常需要管理员权限运行终端、PyCharm 或 VS Code。\n\n```bash\npip install -r requirements.txt --upgrade\npython main_debug.py\n```\n\n运行普通模式：\n\n```bash\npython main.py\n```\n\n运行测试：\n\n```bash\npython -m unittest tests.TestMain\n```\n\n## 项目结构\n\n```text\nsrc/tasks              任务类示例\nsrc/config.py          ok-script 应用配置\nsrc/ui                 自定义 UI Tab 示例\ntests                  自动化测试用例\nassets                 模板匹配资源和 COCO 标注\ndocs/images            README 使用的演示图片\ni18n                   翻译文件\nicons                  应用图标\nmain.py                普通入口\nmain_debug.py          Debug 入口\npyappify.yml           打包配置\ndeploy.txt             发布时同步到更新仓库的文件列表\n.github/workflows      自动化构建与发布流程\n```\n\n## 开发任务\n\n主要示例任务位于 `src/tasks/MyOneTimeTask.py`。你可以从这里开始：\n\n- 修改 `default_config` 增加任务配置默认值。\n- 修改 `config_type` 选择配置控件类型。\n- 在 `run()` 中编写自动化逻辑。\n- 使用 `self.ocr()` 做文字识别。\n- 使用 `self.find_one()` 或 `self.find_feature()` 做模板匹配。\n- 使用 `self.info_set()` 在 UI 中展示任务状态。\n- 使用 `self.log_info(..., notify=True)` 发送通知。\n\n启用自定义任务后，也可以在 GUI 中创建和编辑任务脚本。\n\n## 打包与发布\n\n仓库包含 GitHub Actions 配置。推送符合规则的 tag 后会触发构建：\n\n```text\nv*.*.*\n```\n\n构建流程会根据 `pyappify.yml` 打包应用，并按 `deploy.txt` 同步更新仓库需要的文件。\n\n## ok-script 文档\n\n- [游戏自动化入门](https://github.com/ok-oldking/ok-script/blob/master/docs/intro_to_automation/README.md)\n- [快速开始](https://github.com/ok-oldking/ok-script/blob/master/docs/quick_start/README.md)\n- [进阶使用](https://github.com/ok-oldking/ok-script/blob/master/docs/after_quick_start/README.md)\n- [API 文档](https://github.com/ok-oldking/ok-script/blob/master/docs/api_doc/README.md)\n\n## 社区\n\n- 用户群：`1097603920`\n- 开发者群：`938132715`\n- Discord：https://discord.gg/vVyCatEBgA\n\n## 致谢\n\n- [ok-script](https://github.com/ok-oldking/ok-script)\n- [OnnxOCR](https://github.com/ok-oldking/OnnxOCR)\n- [PyQt-Fluent-Widgets](https://github.com/zhiyiYo/PyQt-Fluent-Widgets)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fok-oldking%2Fok-script-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fok-oldking%2Fok-script-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fok-oldking%2Fok-script-app/lists"}