Merge pull request #13 from SongshGeo/dev

Adds i18n support to project configuration script and platform-specific config docs.

Author: SongshGeo

.cursor/cache/architecture.md

@@ -0,0 +1,12 @@
+<!--
+Purpose:
+- Record the project's high-level architecture (modules, boundaries, and key flows) as a quick reference.
+
+Audience:
+- Contributors and reviewers who need context before making changes.
+
+Usage:
+- Update this file when architectural decisions or major module interactions change.
+-->
+
+# Architecture

.cursor/cache/model-design.md

@@ -0,0 +1,11 @@
+<!--
+Purpose:
+- Describe the project's domain/data model design (core entities, relationships, and invariants).
+
+Audience:
+- Developers implementing features that touch data shapes, validation, or persistence.
+
+Usage:
+- Keep this aligned with code changes; prefer concise diagrams/examples and links to source-of-truth.
+-->
+# Project design

.cursor/cache/progress.md

@@ -0,0 +1,11 @@
+<!--
+Purpose:
+- Track current implementation progress, open questions, and next steps during active development.
+
+Audience:
+- Any contributor (or coding agent) coordinating ongoing work.
+
+Usage:
+- Keep entries brief and actionable; remove outdated notes once resolved.
+-->
+# progress

cache/tech-stack.md .cursor/cache/tech-stack.mdcache/tech-stack.md renamed to .cursor/cache/tech-stack.md

@@ -1,9 +1,19 @@
-# Tech Stack
+<!--
+Purpose:
+- Summarize the chosen tech stack (libraries/tools) and the rationale for key selections.
+
+Audience:
+- Contributors onboarding or evaluating dependency/stack changes.
+
+Usage:
+- Update when adding/removing major dependencies or changing runtime/build tooling.
+-->
+# Tech-stack documentation
 
 ## Develop Env Stack
 
 - Python 3.10–3.13 (PEP 563 via `future-annotations`, typing support via `typing-extensions`).
-- Poetry build (PEP 621) with runtime deps only `typing-extensions`, `future-annotations`.
+- `uv` build (PEP 621) with runtime deps only `typing-extensions`, `future-annotations`.
 - Tooling via pre-commit: Black (code + Jupyter), Isort (`--profile=black`), Ruff lint/format, Flake8 (custom ignores/line length), nbstripout (keep outputs), check-ast/EOL/trailing-space.
 - Quality gates: Mypy (`--ignore-missing-imports`), Interrogate (docstring coverage fail-under 80), docstrings follow Google style.
 - Testing harness: Pytest; task orchestration: Tox; notebooks: ipykernel/ipywidgets.

.cursor/rules/cursorrules.mdc

@@ -26,4 +26,5 @@ 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/
+Before you begin, carefully read all documents in .cursor/cache/
+Avoid using "try...except" syntax to prevent exceptions from being silenced.

.github/workflows/docs.yml

@@ -33,10 +33,11 @@ jobs:
           source $HOME/.cargo/env
           uv sync --all-extras
 
-      - name: Build documentation
+      - name: Build documentation (en + zh)
         run: |
           source $HOME/.cargo/env
-          uv run mkdocs build
+          uv run mkdocs build -f mkdocs.en.yml
+          uv run mkdocs build -f mkdocs.zh.yml
 
       - name: Setup Pages
         uses: actions/configure-pages@v4

.github/workflows/release-please.yml

@@ -11,7 +11,7 @@ permissions:
   id-token: write
 
 jobs:
-  # 创建 release
+  # Create release
   release-please:
     runs-on: ubuntu-latest
     outputs:
@@ -24,7 +24,7 @@ jobs:
           release-type: python
           package-name: ${project_name}
 
-  # 发布到 pypi
+  # Publish to PyPI
   publish-pypi:
     needs: release-please
     runs-on: ubuntu-latest
@@ -49,17 +49,15 @@ jobs:
           uv build
           uv publish
 
-  # 打包源码, 上传到 release 中
+  # Package source and upload to release (optional)
   # build-and-attach-assets:
   #   needs: release-please
   #   runs-on: ubuntu-latest
   #   if: ${{ needs.release-please.outputs.release_created }}
   #   steps:
   #     - uses: actions/checkout@v3
-
   #     - name: Zip src folder
   #       run: zip -r src.zip src/
-
   #     - name: Upload Release Asset
   #       env:
   #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}