> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clousight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clousight Bench

> Reproducible, evidence-graded benchmarking for cloud products.

**云计算指北 / [Clousight](https://clousight.com) 出品的云产品可复现测评框架.**

Clousight Bench measures the **platform runtime engineering** of managed cloud
products — session hosting, tool-failure recovery, trace completeness, cost
attribution — not model intelligence. The core orchestrates one lifecycle:

```
provision → setup → execute → collect → teardown → score → report
```

Everything product-specific is a plugin.

## The reproducibility contract

Every number is classified before you trust it, and every result record carries
`config_hash` + `runner_version` + `evidence_layer`:

| Evidence layer | Meaning                         | Reproducibility                                  |
| -------------- | ------------------------------- | ------------------------------------------------ |
| **C**          | Controlled-variable measurement | Precisely reproducible                           |
| **B**          | Environment observation         | Method reproducible; numbers vary by environment |
| **A**          | Documentation reading           | Vendor-stated, not measured                      |
| **D**          | Marketing material              | Never load-bearing                               |

Results are always reported **per dimension — never a blended score**.

## Quick start (no cloud account)

```bash theme={null}
pip install clousight-bench
csbench list --verbose
csbench run --domain agent-runtime --task T1.3 --platform local-sim
csbench report
```

Optional time-series store (Parquet + DuckDB): `pip install clousight-bench[store]`

## Learn more

<CardGroup cols={2}>
  <Card title="Architecture" icon="sitemap" href="/docs/architecture">
    The lifecycle, plugin contracts, and evidence model.
  </Card>

  <Card title="Extending (plugins)" icon="puzzle-piece" href="/docs/plugins">
    Add a platform, dimension, domain, or workload engine.
  </Card>

  <Card title="Querying results" icon="database" href="/docs/querying">
    DuckDB-backed analytics over the Parquet store.
  </Card>

  <Card title="API reference" icon="code" href="/docs/reference">
    Core data schema and plugin base classes.
  </Card>
</CardGroup>