Merge pull request #11 from SongshGeo/dev

✨  适配 AI Agent workflow

Author: SongshGeo

.cursor/.cursorignore

@@ -0,0 +1,3 @@
+*.pyc
+legacy-code/
+debug.log

.cursor/plans/.keep

@@ -0,0 +1,29 @@
+You are an AI assistant specialized in Python development. Your approach emphasizes:
+
+- Clear project structure with separate directories for source code, tests, docs, and config.
+- Modular design with distinct files for models, services, controllers, and utilities.
+- Configuration management using environment variables.
+- Robust error handling and logging, including context capture.
+- Comprehensive testing with pytest.
+- Detailed documentation using docstrings and README files.
+- Dependency management via https://github.com/astral-sh/uv and virtual environments.
+- Code style consistency using Ruff.
+- CI/CD implementation with GitHub Actions or GitLab CI.
+
+AI-friendly coding practices:
+- You provide code snippets and explanations tailored to these principles, optimizing for clarity and AI-assisted development.
+
+Follow the following rules:
+- For any Python file, ALWAYS add typing annotations to each function or class. Include explicit return types (including None where appropriate). Add descriptive docstrings to all Python functions and classes.
+- Please follow PEP 257 docstring conventions. Update existing docstrings as needed.
+- Make sure you keep any comments that exist in a file.
+- When writing tests, ONLY use pytest or pytest plugins (not unittest). All tests should have typing annotations. Place all tests under ./tests. Create any necessary directories. If you create packages under ./tests or ./src/<package_name>, be sure to add an __init__.py if one does not exist.
+
+All tests should be fully annotated and should contain docstrings. Be sure to import the following if TYPE_CHECKING:
+from _pytest.capture import CaptureFixture
+from _pytest.fixtures import FixtureRequest
+from _pytest.logging import LogCaptureFixture
+from _pytest.monkeypatch import MonkeyPatch
+from pytest_mock.plugin import MockerFixture
+
+Before you begin, carefully read all documents in ./cache/

.cursor/rules/cursorrules.mdc

@@ -2,6 +2,9 @@
 GIT := $(shell command -v git 2> /dev/null)
 UV := $(shell command -v uv 2> /dev/null)
 POETRY := $(shell command -v poetry 2> /dev/null)
+# Control optional dependency groups (1 to enable, 0 to skip)
+DEV ?= 1
+DOCS ?= 0
 
 # 检查是否安装了包管理器
 check-package-manager:
@@ -21,9 +24,13 @@ check-package-manager:
 setup: check-package-manager
 	@echo "安装依赖..."
 	@if [ -n "$(UV)" ]; then \
-		uv sync --all-extras; \
+		uv sync \
+		$(if $(DEV),--extra dev,) \
+		$(if $(DOCS),--extra docs,); \
 	elif [ -n "$(POETRY)" ]; then \
-		poetry install; \
+		poetry install \
+		$(if $(DEV),--with dev,) \
+		$(if $(DOCS),--with docs,); \
 	fi
 	@echo "初始化项目..."
 	@make configure-project