learncodebygaming · khahv · Feb 27, 2026 · Feb 27, 2026 · Feb 27, 2026 · Feb 27, 2026
diff --git a/.cursor/rules/coding-standards.mdc b/.cursor/rules/coding-standards.mdc
@@ -0,0 +1,72 @@
+---
+description: Project-wide coding standards — English-only docs/comments, Python naming, reuse, and clean code
+alwaysApply: true
+---
+
+# Coding Standards
+
+All prompts and changes in this project must follow these rules.
+
+---
+
+## Language
+
+- **Comments and documentation must be in English** (including docstrings, README, DOCS.md, and inline comments).
+- User-facing strings (logs, UI) may stay in the project’s existing language if that is the current convention.
+
+---
+
+## Python Naming Conventions
+
+Follow PEP 8; use these consistently:
+
+| Kind | Convention | Example |
+|------|------------|--------|
+| **Modules / files** | `snake_case` | `bot_engine.py`, `window_capture.py` |
+| **Functions / methods** | `snake_case` | `get_screenshot()`, `find_template()` |
+| **Variables / parameters** | `snake_case` | `screenshot`, `threshold`, `max_tries` |
+| **Constants** | `UPPER_SNAKE_CASE` | `DEFAULT_THRESHOLD`, `MAX_RETRIES` |
+| **Classes** | `PascalCase` | `FunctionRunner`, `Vision` |
+| **Private** (module/class internal) | leading `_` | `_advance_step()`, `_roi_bounds` |
+| **“Protected” / internal** | leading `_` | `_base_zoomout_search_img()` |
+
+- Avoid single-letter names except for trivial loop indices (e.g. `i`, `j`).
+- Prefer descriptive names; avoid abbreviations unless very common (e.g. `img`, `rect`, `cfg`).
+
+---
+
+## Before Adding New Code
+
+- **Check if equivalent logic already exists** (same module, other modules, or helpers). Reuse or extend it instead of duplicating.
+- **Search the codebase** for similar behavior (e.g. “find template”, “click at position”) before implementing from scratch.
+- Prefer **small, focused functions** that can be reused; avoid long inline blocks that do multiple unrelated things.
+
+---
+
+## Clean & Reusable Code
+
+- **DRY**: Do not repeat yourself; extract shared logic into functions or helpers.
+- **Single responsibility**: Each function/class should do one clear thing.
+- **Reusability**: Prefer parameters and config over hardcoded values so behavior can be reused.
+- **Readability**: Prefer clear control flow and named variables over clever one-liners.
+- **No premature optimization**: Write simple, correct code first; optimize only when needed and with evidence.
+
+---
+
+## After Editing Python (agents)
+
+- **Always verify Python syntax** after finishing work on any `.py` files—do not treat the task as complete until syntax checks pass.
+- Run, for example:
+  - `python -m py_compile path/to/changed_file.py` for each modified file, or
+  - `python -m compileall -q path/to/touched_package` when many files under one directory changed.
+- Fix any `SyntaxError` or compile failures before concluding the task.
+
+---
+
+## Additional Rules
+
+- **Type hints**: Use type hints for function parameters and return values when they clarify intent or public APIs; not required for every trivial helper.
+- **Docstrings**: Add docstrings (in English) for public functions, classes, and non-obvious behavior.
+- **Error handling**: Prefer explicit handling and logging over bare `except`; avoid silencing errors without a clear reason.
+- **Imports**: Group and order imports (stdlib → third-party → local); avoid unused imports.
+- **Formatting**: Keep line length reasonable (e.g. ≤120 chars); break long lines for readability.
diff --git a/.cursorignore b/.cursorignore
@@ -0,0 +1,4 @@
+# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
+kha_lastz_auto/__pycache__/
+kha_lastz_auto/.venv312
+kha_lastz_auto/playwright_zalo_data/
diff --git a/.gitignore b/.gitignore
@@ -3,4 +3,13 @@
 __pycache__
 /pydirectinput.egg-info
 /build
-/dist
+/dist
+**/logs
+**/.env
+**/.env_config
+kha_lastz_auto/.env_config
+kha_lastz_auto/playwright_zalo_data/
+kha_lastz_auto/debug/
+kha_lastz_auto/debug_ocr/
+kha_lastz_auto/debug_close_ui/
+kha_lastz_auto/debug_exclude/
diff --git a/001_intro/albion_cabbage.jpg b/001_intro/albion_cabbage.jpg
diff --git a/001_intro/albion_farm.jpg b/001_intro/albion_farm.jpg
diff --git a/001_intro/main.py b/001_intro/main.py
diff --git a/001_intro/result.jpg b/001_intro/result.jpg
diff --git a/001_intro/result_CCOEFF_NORMED.jpg b/001_intro/result_CCOEFF_NORMED.jpg
diff --git a/002_match_multiple/albion_cabbage.jpg b/002_match_multiple/albion_cabbage.jpg
diff --git a/002_match_multiple/albion_copper.jpg b/002_match_multiple/albion_copper.jpg
diff --git a/002_match_multiple/albion_copper_needle.jpg b/002_match_multiple/albion_copper_needle.jpg
diff --git a/002_match_multiple/albion_farm.jpg b/002_match_multiple/albion_farm.jpg
diff --git a/002_match_multiple/main.py b/002_match_multiple/main.py
diff --git a/002_match_multiple/result.jpg b/002_match_multiple/result.jpg
diff --git a/003_group_rectangles/albion_cabbage.jpg b/003_group_rectangles/albion_cabbage.jpg
diff --git a/003_group_rectangles/albion_farm.jpg b/003_group_rectangles/albion_farm.jpg
diff --git a/003_group_rectangles/albion_turnip.jpg b/003_group_rectangles/albion_turnip.jpg
diff --git a/003_group_rectangles/main.py b/003_group_rectangles/main.py
diff --git a/003_group_rectangles/result_click_point.jpg b/003_group_rectangles/result_click_point.jpg
diff --git a/004_window_capture/main.py b/004_window_capture/main.py