{"data":{"kind":"file","path":"README.md","version_id":"g7wytmss5b1crn0s3oxld8kc","entry":{"name":"README.md","path":"README.md","is_directory":false,"size":1967,"modified_at":"2026-08-14T14:07:12.151000","content_hash":"49a58741584dbbb7ff2edeff713b28d8e439040d948de781e8f17325246ae23d"},"entries":[],"content":"# Co Tuong (Xiangqi / Chinese Chess) Environment\n\nA knowledge evaluation environment for testing LLM understanding of Chinese Chess (Xiangqi / Co Tuong).\n\n## Overview\n\nThis environment evaluates a model's knowledge of Chinese Chess across multiple dimensions:\n\n- **Rules & Piece Movement**: How each piece moves, captures, and is restricted\n- **Tactics & Checkmate Patterns**: Classic mating patterns, tactical combinations\n- **Opening Theory**: Standard openings (Central Cannon, Screen Horse, etc.)\n- **Positional Strategy**: Tempo, river control, piece coordination\n- **Notation Systems**: ICCS, WXF, and algebraic notation\n- **Board Analysis**: Position evaluation and strategic planning\n\n## Evaluation Dimensions\n\n| Metric | Weight | Description |\n|--------|--------|-------------|\n| Xiangqi Knowledge | 0.30 | Domain-specific terminology and concepts |\n| Accuracy | 0.35 | Keyword overlap with reference answers |\n| Completeness | 0.15 | Answer depth and structure |\n| Reasoning | 0.20 | Logical chains and explanations |\n\n## Dataset\n\n21 questions covering:\n- 6 rules questions (piece movement, capture, special rules)\n- 5 tactical puzzles (checkmate patterns, endgame technique)\n- 5 opening theory questions (standard openings and defenses)\n- 3 positional/strategic questions\n- 2 notation questions\n\n## Usage\n\n```python\nimport verifiers as vf\n\nenv = vf.load_environment(\"co-tuong-xiangqi\")\n# or\nfrom co_tuong_xiangqi import load_environment\nenv = load_environment()\n```\n\n## Key Concepts Tested\n\n- **Flying General Rule** (Chieu Doi Tuong): Kings cannot face each other on the same column\n- **Horse Blocking** (Biet Mat): Horse can be blocked at its orthogonal step\n- **Cannon Screen** (Phao Co): Cannon needs exactly one piece to jump over for capture\n- **Elephant Restriction**: Cannot cross the river\n- **Soldier Promotion**: Gains sideways movement after crossing the river\n- **Palace Confines**: King and Advisors restricted to 3x3 palace\n\n## License\n\nMIT\n","encoding":"utf-8","truncated":false,"total_bytes":1967},"status":null}