# TongShiJi
> Cross-Civilization Historical Parallel Comparison

TongShiJi is an AI-powered platform for parallel historical comparison across civilizations.
Users pick two countries and explore politics, economy, culture, notable figures, events, and achievements across the same time periods.
Content is generated by DeepSeek AI, cached for fast retrieval, and supports public discussion comments.

## Core capabilities
- Side-by-side parallel history across 10-14 periods (ancient to modern)
- 200+ countries and civilizations with searchable picker
- AI-generated structured comparisons with smart caching
- User comments on each comparison page
- Bilingual UI: Chinese (zh-CN) and English (en)

## Primary pages
- [Home](http://gj.ymznkf.com/): start a new comparison
- [English Home](http://gj.ymznkf.com/?culture=en)
- [Example: China vs Japan](http://gj.ymznkf.com/Compare?countryA=%E4%B8%AD%E5%9B%BD&countryB=%E6%97%A5%E6%9C%AC)
- [Example Markdown export](http://gj.ymznkf.com/compare/markdown?countryA=%E4%B8%AD%E5%9B%BD&countryB=%E6%97%A5%E6%9C%AC)
- [Sitemap](http://gj.ymznkf.com/sitemap.xml)
- [Full LLM index](http://gj.ymznkf.com/llms-full.txt)

## Machine-readable formats
- `text/markdown` comparison export: `/compare/markdown?countryA=...&countryB=...&culture=zh-CN|en`
- Only cached comparisons are exported (no on-demand AI generation via this endpoint)
- HTML pages include JSON-LD (`Article`, `BreadcrumbList`, `ItemList`) and `link rel="alternate" type="text/markdown"`

## Content structure per comparison
Each comparison page contains:
- Multiple historical periods with parallel descriptions for both countries
- Notable figures, key events, and achievements per country per period
- An overall cross-civilization summary
- A public comment section keyed by comparison pair and language

## Optional
- [robots.txt](http://gj.ymznkf.com/robots.txt): allows major AI crawlers
- [llms-full.txt](http://gj.ymznkf.com/llms-full.txt): bilingual index with recent comparison URLs