autowsgr 2.2.2__tar.gz → 2.3.1__tar.gz

autowsgr-2.3.1/.codegraph/.gitignore

@@ -0,0 +1,5 @@
+# CodeGraph data files — local to each machine, not for committing.
+# Ignore everything in .codegraph/ except this file itself, so transient
+# files (the database, daemon.pid, sockets, logs) never show up in git.
+*
+!.gitignore

autowsgr-2.3.1/.gitattributes

@@ -0,0 +1,8 @@
+# Force LF for all text files.
+* text=auto eol=lf
+
+# Binary files — do not touch.
+*.png binary
+*.PNG binary
+*.jpg binary
+*.onnx binary

autowsgr-2.3.1/.github/workflows/lint.yml

@@ -0,0 +1,25 @@
+# Pre-commit 代码检查 — push / PR 时自动运行
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: true
+      - uses: actions/cache@v6
+        with:
+          path: ~/.cache/pre-commit
+          key: pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
+      - name: Run pre-commit checks
+        run: uv run pre-commit run --all-files

autowsgr-2.3.1/.github/workflows/lunar.yml

@@ -0,0 +1,28 @@
+name: Lunar Code Review
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+
+jobs:
+  test:
+    if: github.repository == 'OpenWSGR/AutoWSGR'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: 0xWelt/Lunar@main
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # # Optional, change as you wish or comment out to use default
+          # LLM settings
+          OPENAI_BASE_URL: ${{ vars.LUNAR_BASE_URL }}
+          OPENAI_API_KEY: ${{ secrets.LUNAR_API_KEY }}
+          MODEL: ${{ vars.LUNAR_MODEL }}
+          TEMPERATURE: 1.0
+          MAX_TOKENS: 8192
+          # Lunar settings
+          LANGUAGE: Chinese
+          IGNORE_PATTERNS: autowsgr/data/**/* # glob pattern or regex pattern to ignore files, separated by comma

autowsgr-2.3.1/.github/workflows/pytest.yml

@@ -0,0 +1,33 @@
+# Pytest — 运行全部单元测试并生成覆盖率报告
+name: Pytest
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.0.1
+        with:
+          enable-cache: true
+      - name: Run tests with coverage
+        run: uv run pytest -n auto --cov=autowsgr --cov-report=xml --cov-report=term-missing --junitxml=junit.xml
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: OpenWSGR/AutoWSGR
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/codecov-action@v7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: OpenWSGR/AutoWSGR
+          report_type: test_results

autowsgr-2.3.1/.github/workflows/release.yml

@@ -0,0 +1,58 @@
+# Release & Publish — 版本号变更时自动触发，也可手动触发
+# 创建 GitHub Release + 发布到 PyPI，不依赖 lint
+name: Release & Publish
+
+on:
+  push:
+    branches: [main]
+    paths: [autowsgr/__init__.py]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    if: github.repository == 'OpenWSGR/AutoWSGR'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v10.0.1
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION=$(uv run python -c "exec(open('autowsgr/__init__.py').read()); print(__version__)")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag exists
+        id: check_tag
+        run: |
+          if git ls-remote --tags origin "refs/tags/${{ steps.version.outputs.tag }}" | grep -q .; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create tag and release
+        if: steps.check_tag.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          VERSION="${{ steps.version.outputs.version }}"
+          git tag "$TAG"
+          git push origin "$TAG"
+          gh release create "$TAG" \
+            --title "AutoWSGR $VERSION" \
+            --generate-notes \
+            --latest
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        if: steps.check_tag.outputs.exists == 'false'
+        run: uv publish --token '${{ secrets.PYPI_API_TOKEN }}'

autowsgr-2.3.1/.pre-commit-config.yaml

@@ -0,0 +1,30 @@
+default_stages: [pre-commit, pre-push, manual]
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-symlinks
+      - id: destroyed-symlinks
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-toml
+      - id: check-ast
+      - id: check-added-large-files
+        exclude: ^autowsgr/data/ocr/ppocr_v6_small/(det|rec)\.onnx$
+      - id: check-merge-conflict
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: detect-private-key
+      - id: debug-statements
+      - id: double-quote-string-fixer
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.12
+    hooks:
+      - id: ruff-check
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+      - id: codespell
+        additional_dependencies: [".[toml]"]

autowsgr-2.3.1/AGENTS.md

@@ -0,0 +1,105 @@
+# Agent Guidelines
+
+## 开发环境
+
+```bash
+git clone git@github.com:OpenWSGR/AutoWSGR.git
+cd AutoWSGR
+uv sync
+pre-commit install
+```
+
+激活虚拟环境后可直接运行命令（无需 `uv run` 前缀）：
+
+```bash
+source .venv/bin/activate   # Linux/macOS
+# .venv\Scripts\activate    # Windows
+pytest
+pre-commit run --all-files
+```
+
+## 代码风格
+
+- Python 版本：3.12+
+- 格式化与 lint：**Ruff**（已覆盖 isort / black 功能），配置见 `pyproject.toml`
+- 目标行宽 100，单引号字符串
+- 禁止相对导入（`ban-relative-imports = all`）
+- 英语拼写检查：**codespell**，忽略词表见 `docs/spelling_wordlist.txt`
+
+提交前务必运行：
+
+```bash
+pre-commit run --all-files
+```
+
+## 测试
+
+- 单元测试：`pytest`（测试目录 `testing/`）
+- 功能测试：运行 `examples/` 目录中的脚本进行端到端验证
+
+```bash
+pytest
+```
+
+## 约定式提交（Conventional Commits）
+
+提交信息格式：
+
+```
+<type>(<scope>): <简短描述>
+
+<正文>
+```
+
+常用类型：
+
+- `feat`：新功能
+- `fix`：修复
+- `build`：构建系统或依赖变更
+- `docs`：文档
+- `style`：不影响代码逻辑的格式调整
+- `refactor`：重构
+- `test`：测试
+
+示例：
+
+```
+build: migrate from setuptools to hatchling
+
+- Replace setuptools with hatchling as build backend
+- Remove obsolete MANIFEST.in
+```
+
+## 构建与打包
+
+- Build backend：**hatchling**
+- 包数据（图片、YAML、JAR 等）位于 `autowsgr/data/`，由 hatchling 自动包含，无需 `MANIFEST.in`
+
+```bash
+uv build
+```
+
+## 文档
+
+- 用户文档地址：https://docs-autowsgr.notion.site
+- 代码变更后同步更新文档，并鼓励在代码中编写注释和文档字符串。
+
+## ShiinaKuroko Fork 分支管理
+
+本仓库的个人 Fork 为 `https://github.com/ShiinaKuroko/AutoWSGR.git`。后续 Agent
+必须遵守以下分支职责，不得自行改变分支用途：
+
+- `main` 只用于同步 `OpenWSGR/AutoWSGR:main`，禁止在该分支直接开发、提交或推送功能代码。
+- `ShiinaKuroko` 是个人 Fork 的最新开发分支，经过验证的最新代码才允许推送到这里。
+- `backup/YYYYMMDD-<short-sha>` 是版本备份分支。每次更新 `ShiinaKuroko` 前，先创建一个指向更新前稳定提交的备份；完成更新后，再创建一个指向新稳定提交的备份，最多保留两个备份分支。
+- 备份分支一旦创建不得移动、覆盖或追加提交。超过两个备份时，只删除最旧的备份分支，不删除当前备份和上一个备份。
+- Agent 临时分支、worktree 分支和实验分支不得直接推送到 `main` 或冒充 `ShiinaKuroko`；任务完成后应删除不再需要的临时远程分支。
+- 推送前必须确认工作树、提交范围和目标分支：`git status --short --branch`、`git diff --check`、`git log --oneline -5`。
+- 推送最新代码前必须先创建备份，并使用 `git push --force-with-lease` 更新 `ShiinaKuroko`，禁止无条件 `--force`。
+- 任何删除远程分支的操作都必须先列出将被删除的分支、提交和原因；禁止删除 `main`、`ShiinaKuroko` 或未明确授权的分支。
+- 新功能必须在独立分支或 worktree 中开发，完成测试后才能合并或推送到 `ShiinaKuroko`。
+- 本地独立开发分支只能用于编码、测试和审查，禁止直接推送到 Fork 的任何发布分支。
+- 本地独立分支完成后，必须将已验证提交合并、cherry-pick 或 rebase 整理到本地 `ShiinaKuroko` 分支；只有本地 `ShiinaKuroko` 分支允许执行 `git push origin ShiinaKuroko`。
+- 不得执行 `git push origin <local-feature-branch>` 作为发布流程；远程临时分支如确有协作需要，必须获得明确授权，并不得替代 `ShiinaKuroko` 发布入口。
+- 推送前必须确认当前分支为本地 `ShiinaKuroko`，且 `git log origin/ShiinaKuroko..ShiinaKuroko` 只包含本次计划发布的提交。
+- 后端发布至少执行 `pytest -q` 和 `git diff --check`；无法执行的检查必须在交付说明中明确记录。

autowsgr-2.3.1/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.5
+Name: autowsgr
+Version: 2.3.1
+Summary: Auto Warship Girls Framework.
+Project-URL: Documentation, https://docs-autowsgr.notion.site
+Project-URL: Repository, https://github.com/OpenWSGR/AutoWSGR
+License: MIT
+License-File: LICENSE
+Classifier: Environment :: GPU :: NVIDIA CUDA
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: <3.14,>=3.12
+Requires-Dist: adbutils<3.0,>=2.0
+Requires-Dist: autowsgr-native==0.3.0
+Requires-Dist: av>=12.0
+Requires-Dist: easyocr>=1.7.1
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: keyboard
+Requires-Dist: loguru
+Requires-Dist: maafw<6.0,>=5.12.3
+Requires-Dist: opencv-python-headless
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: retry>=0.9.2
+Requires-Dist: rich
+Requires-Dist: uvicorn[standard]>=0.23.0
+Requires-Dist: websockets>=11.0
+Description-Content-Type: text/markdown
+
+<div align=center>
+<img src="https://raw.githubusercontent.com/OpenWSGR/AutoWSGR/main/docs/logo.png">
+</div>
+
+## 项目简介
+
+![Repo Size](https://img.shields.io/github/repo-size/OpenWSGR/AutoWSGR) ![Pypi Version](https://img.shields.io/pypi/v/autowsgr) ![Pypi Downloads](https://img.shields.io/pypi/dm/autowsgr) ![Github Issues](https://img.shields.io/github/issues/OpenWSGR/AutoWSGR) ![Github Last Commit](https://img.shields.io/github/last-commit/OpenWSGR/AutoWSGR) [![Codecov](https://codecov.io/gh/OpenWSGR/AutoWSGR/graph/badge.svg)](https://codecov.io/gh/OpenWSGR/AutoWSGR) [![License](https://img.shields.io/badge/license-OpenWSGR%20Strict%20NC-red.svg)](LICENSE)
+
+用 Python 与 C++ 实现的 战舰少女R 的自动化流水线 & 数据统计一体化脚本, 提供 `WSGR` 游戏级别接口以及部分图像和原子操作接口。
+
+**⚠️ 严正声明：本项目仅供学习交流使用，严禁任何形式的商业行为（包括但不限于代练、脚本售卖、变相收费等）。**
+
+## 用户社群
+
+- [QQ](https://qm.qq.com/q/PEcqOtqZSU)，入群口令本项目 **main 分支最新 [commit hash](https://github.com/OpenWSGR/AutoWSGR/commits/main/)** 前七位。
+- [Discord](https://discord.gg/jHMcD7Kh)。
+
+## 安装使用
+
+- 注意事项：本项目现在只支持 Python3.12 以上，如果要使用最新版请升级 Python 版本。
+- 不想碰代码可以直接用 GUI-->[传送门](https://github.com/yltx/AutoWSGR-GUI)
+
+## 参与开发
+
+欢迎有一定 Python 基础的同学加入开发，共同完善这个项目。
+
+您可以实现新的功能，也可以改进现有功能，或者修复 bug。
+
+如果您有好的想法，也可以提出 Issue 或加社群讨论。一些经过讨论确定需要实现的任务在 [Projects](https://github.com/orgs/OpenWSGR/projects/2) 中有列出，你可以从中选择能力之内的项目着手贡献。
+
+开发前请仔细阅读 [贡献指南](.github/CONTRIBUTING.md) 和 [用户文档](https://docs-autowsgr.notique.site)。特别注意： 开发者请**不要从 PyPI 安装 autowsgr**，改为 [本地模式](https://docs-autowsgr.notion.site/2-AutoWSGR-efeb69811b544604b944d5b5727317a4) 安装。
+
+本项目使用 [Lunar](https://github.com/0xWelt/Lunar) 进行代码自动审查，所有 PR 都有概率触发 AI 的评论。
+
+## 贡献者
+
+<a href="https://github.com/OpenWSGR/AutoWSGR/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=OpenWSGR/AutoWSGR" />
+</a>
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=OpenWSGR/AutoWSGR&type=Date)](https://star-history.com/#OpenWSGR/AutoWSGR&Date)
+
+---
+
+## 开源协议与商业化禁止声明 (License)
+
+本项目采用 [OpenWSGR Strict Non-Commercial License](LICENSE) 授权。
+
+**核心红线：**
+
+1. **绝对禁止商业化**：严禁将本项目及其衍生作品用于营利活动。禁止代练收费、脚本整合包售卖。
+2. **禁止变相收费**：严禁以“服务器费”、“捐赠”、“工本费”或“入群门槛费”等名义变相收取任何费用。
+3. **开源传染性**：基于本项目进行的任何二次开发、修改或再发布的产物，必须**继承本协议**，且**同样禁止任何形式的收费或商业化**。
+
+对于任何违反协议的行为，项目组保留采取包括但不限于公开通报、技术封锁及法律追诉在内的一切权利。

autowsgr-2.3.1/autowsgr/__init__.py

@@ -0,0 +1,3 @@
+"""AutoWSGR - 战舰少女R 自动化框架(v2)"""
+
+__version__ = '2.3.1'

autowsgr-2.3.1/autowsgr/combat/__init__.py

@@ -0,0 +1,56 @@
+"""战斗系统 — 独立于 UI 框架的战斗状态机引擎。"""
+
+from .engine import CombatEngine, run_combat
+from .fleet import (
+    ALLOWED_SHIP_TYPE_CODES,
+    FleetPreset,
+    FleetSelectionSource,
+    FleetSlotRule,
+    ResolvedFleetSelection,
+    ShipSelector,
+    fleet_slot_from_api,
+    resolve_fleet_selection,
+)
+from .history import CombatEvent, CombatHistory, CombatResult, FightResult, grade_condition_met
+from .node_tracker import MapNodeData, NodeTracker
+from .plan import CombatMode, CombatPlan, GradeCondition, NodeDecision
+from .recognition import (
+    SHIP_DROP_PAGE_SIGNATURE,
+    ShipDropResult,
+    recognize_enemy_formation,
+    recognize_ship_drop,
+)
+from .rules import RuleEngine, RuleResult
+from .state import CombatPhase
+
+
+__all__ = [
+    'ALLOWED_SHIP_TYPE_CODES',
+    'SHIP_DROP_PAGE_SIGNATURE',
+    'CombatEngine',
+    'CombatEvent',
+    'CombatHistory',
+    'CombatMode',
+    'CombatPhase',
+    'CombatPlan',
+    'CombatResult',
+    'FightResult',
+    'FleetPreset',
+    'FleetSelectionSource',
+    'FleetSlotRule',
+    'GradeCondition',
+    'MapNodeData',
+    'NodeDecision',
+    'NodeTracker',
+    'ResolvedFleetSelection',
+    'RuleEngine',
+    'RuleResult',
+    'ShipDropResult',
+    'ShipSelector',
+    'fleet_slot_from_api',
+    'grade_condition_met',
+    'recognize_enemy_formation',
+    'recognize_ship_drop',
+    'resolve_fleet_selection',
+    'run_combat',
+]