# Quickstart ## Open the system ```sh python3 -m http.server 8000 --bind 127.0.0.1 ``` Then open for the hub. Every page also opens directly from disk; nothing is fetched from the network. ## Build a page on the foundation ```html 页面标题 · 侍天 TIANSIGHT 跳到正文

Caption · 题注

标题

副题。

``` Run `python3 scripts/sync_icons.py` to fill the icon markers, then use icons as ``. ## Consume the system from another site ```html ``` One file carries the font faces, tokens, element defaults and every component. Link `tiansight.css` to follow every push, or `tiansight-v0.6.css` to pin. `dist/example.html` is a working page to copy. Details and the jsDelivr alternative are in [dist/README.md](../dist/README.md). ## Use the tokens elsewhere `brand/tokens.json` is the same token set in Design Tokens Community Group format, with the mobile overrides under `$extensions.tiansight.modes`. It is generated; edit `brand/tokens.css` and run `python3 scripts/export_tokens.py`. ## Produce a report or deck from data ```sh python3 html-system/build_deck.py html-system/sample # manifest + CSV → slides python3 html-system/check_report.py html-system/sample # provenance, grades, headline numbers ``` Copy `html-system/sample/manifest.json` as the starting point. The skills in `skills/` describe every chart family, data role and quality check an agent must follow. ## Verify before committing ```sh python3 scripts/check.py # guide conformance, build freshness, tokens.json, a11y lint python3 scripts/check.py --render # plus headless layout regression against snapshots/layout.json ``` If a layout change is intended, refresh the baseline with `node scripts/snapshot.mjs --update` and commit `snapshots/layout.json`.