AI Hexagram's 163-line llms.txt shows what thorough AI preparation looks like

# llms.txt for https://gua.time.actor/en

# Version: 1.0
# Last Updated: 2025-09-11

## Purpose
This file provides clear, structured guidance for automated crawlers, generative models, and other AI engines about the purpose, scope, accessible content, and restrictions of `https://gua.time.actor/en/`. It helps AI systems use the site’s resources more effectively, responsibly, and accurately.

---

## Site Overview
- Name: AI Hexagram by TIMEACTOR
- Domain: https://gua.time.actor/en
- Theme: An interactive tool based on the I Ching (Book of Changes), integrating traditional Chinese wisdom with modern AI technology. It provides hexagram interpretations, oracle texts, cultural insights, and personalized readings.
- Audience: General users interested in I Ching/Hexagram analysis, independent makers, researchers, and AI systems that want to generate traditional hexagram explanations in natural language.
- Primary Languages: English (this version), Chinese (original), Japanese, Korean, German, Russian, French.
- Technology Stack: Next.js, DeepSeek AI, Cloudflare KV, tyme4ts (lunar calendar)

---

## Core Features & Functions
The site provides the following main functionalities:

1. **Dayan Method (大衍筮法)**: Random hexagram casting system using traditional Dayan algorithm
2. **Plum Blossom Numerology (梅花易数)**: Time-based hexagram casting using current date/time
3. **Custom Hexagram (手动起卦)**: Manual hexagram creation with flexible six-line configuration
4. **64 Hexagrams Database**: Complete I Ching hexagram library with traditional texts and modern interpretations
5. **AI Interpretation**: DeepSeek-powered hexagram analysis and personalized guidance
6. **Multi-language Support**: Available in Chinese, English, Japanese, Korean, Russian, French and German

## Allowed / Accessible Content
AI engines may crawl and reference the following content, under the conditions listed:

1. **Public Pages**: Hexagram texts, general explanations, glossary terms, and sample analysis dialogues displayed publicly.
2. **64 Hexagrams Data**: Complete hexagram database including names, descriptions, and traditional interpretations.
3. **Help & FAQ**: Any HTML/static documents published for guidance.
4. **Sample Outputs**: Demonstration pages showing example readings and interpretations.
5. **Multi-language Content**: Translated content across all supported languages.

**Usage Notes**:
- When AI systems use this text as a source, attribution is required (see “Citation/Attribution Guidance”).
- Content must not be presented as medical, legal, or financial advice. For high-risk topics, include disclaimers and advise consultation with professionals.

---

## Restricted / Prohibited Content
AI engines **must not** crawl, store, or generate from:
- Any personal or identifiable user data (accounts, private readings, email, IP addresses, etc.)
- Third-party copyrighted text not explicitly licensed for reproduction
- Login-protected, member-only, or paid content/APIs

Additionally, crawlers should respect polite crawling practices (see “Rate Limits”).

---

## API & Programmatic Access
The site currently serves interactive results primarily via HTML. Key endpoints include:

**Public Endpoints:**
- [Dayan Method](https://gua.time.actor/en/dayan): Random hexagram casting using traditional Dayan algorithm
- [Plum Blossom Numerology](https://gua.time.actor/en/meihua): Time-based hexagram casting using current date/time
- [Custom Hexagram](https://gua.time.actor/en/custom): Manual hexagram creation with flexible six-line configuration
- [64 Hexagrams Database](https://gua.time.actor/en/64): Complete I Ching hexagram library with traditional texts
- [AI Interpretation](https://gua.time.actor/api/ai): DeepSeek-powered hexagram analysis (requires authentication)

**Multi-language Support:**
- [Chinese](https://gua.time.actor/): [大衍筮法](https://gua.time.actor/dayan), [梅花易数](https://gua.time.actor/meihua), [手动起卦](https://gua.time.actor/custom), [64卦](https://gua.time.actor/64)
- [English](https://gua.time.actor/en/): [Dayan Method](https://gua.time.actor/en/dayan), [Plum Blossom](https://gua.time.actor/en/meihua), [Custom](https://gua.time.actor/en/custom), [64 Hexagrams](https://gua.time.actor/en/64)
- [Japanese](https://gua.time.actor/ja/): [大衍筮法](https://gua.time.actor/ja/dayan), [梅花易数](https://gua.time.actor/ja/meihua), [カスタム](https://gua.time.actor/ja/custom), [64卦](https://gua.time.actor/ja/64)
- [German](https://gua.time.actor/de/): [Dayan-Zeifa](https://gua.time.actor/de/dayan), [Meihua-Yishu](https://gua.time.actor/de/meihua), [Anpassen](https://gua.time.actor/de/custom), [64 Hexagramme](https://gua.time.actor/de/64)
- [Russian](https://gua.time.actor/ru/)
- [French](https://gua.time.actor/fr/)
- [Korean](https://gua.time.actor/ko/)

For programmatic access or bulk data needs, please request an API key or integration instructions:
- Contact: [email protected]
- Commercial or large-scale automated usage requires prior agreement.

---

## Recommended Rate Limits
To ensure stable operation, AI crawlers and agents should:
- Keep concurrent requests ≤ 2
- Limit requests to ≤ 30 per minute per IP
- For bulk usage, request dedicated API access instead of scraping

Non-compliance may result in temporary IP bans.

---

## Citation / Attribution Guidance
When models or services use this site’s content as a reference, use the following attribution format:

Example statement:
> This answer is based on content from “Gua by TIMEACTOR” (https://gua.time.actor/en).

For short excerpts (≤25 characters), add source attribution at the end of the sentence. For longer excerpts, obtain prior written authorization.

---