feat(docs): add Docusaurus Pages site

[kongche-jbw]

Description

Replace the hand-maintained Pages source with a Docusaurus 3 site isolated
under website/. The site consumes the existing bilingual Markdown and
Changelog files through build-time generation, preserving them as the
canonical content sources. It also generates machine-readable Agent endpoints
from repository metadata, manifests, README files, and Clap definitions.
GitHub Pages is built and deployed through Actions without committing generated
output.

Canonical content sources and maintenance

The website does not maintain private copies of the project documentation.
Content must be updated through the following canonical sources:

• Documentation:
  • docs/QUICKSTART.md and docs/QUICKSTART_zh.md
  • docs/BUILDING.md and docs/BUILDING_zh.md
  • docs/user-guide/{en,zh}/**
  • docs/developer-guide/{en,zh}/**
• Changelog:
  • root CHANGELOG.md and CHANGELOG_zh.md
  • component-level src/<component>/CHANGELOG*.md
• Agent endpoints:
  • generated from AGENTS.md, component manifests, README files,
    Changelog files, and Clap command definitions
• Website presentation:
  • the homepage and product pages are maintained under website/src/pages/
  • shared product facts and platform support are maintained in
    website/content.config.ts
  • navigation and Footer are maintained in website/docusaurus.config.ts

English and Chinese documentation must use matching relative paths. New or
renamed documents must be added to both locales so that locale validation and
stable URL mapping continue to work.

Build-time scripts transform these sources into Docusaurus-compatible files
under website/.generated/. Maintainers must never edit or commit
website/.generated/, website/build/, or website/node_modules/.

When commands, installation behavior, component support, or platform
compatibility changes, update the underlying code and canonical documentation
first, then verify that the homepage and product pages still describe the
implemented behavior accurately.

Related Issue

closes #

Type of Change

• New feature (non-breaking change that adds functionality)
• Documentation update
• CI/CD or build changes

Scope

• Multiple / Project-wide

Checklist

• My code follows the project's code style
• I have updated the documentation accordingly
• Lock files are up to date (package-lock.json / Cargo.lock)

Testing

npm ci --prefix website
npm run validate:locales --prefix website
npm run build --prefix website
npm run check:links --prefix website
npm run typecheck --prefix website
git diff --check
Verified:
54 English and 54 Chinese documents are generated from canonical sources
project-level and component-level Changelogs are generated automatically
Agent index schema validation passes for 10 components
static link and duplicate DOM ID validation passes for 122 HTML files
English and Chinese locale switching works
desktop and 390 px mobile layouts work
Tokenless and Copilot Shell product pages render correctly
/install.sh, /agents/**, and /llms.txt remain available
fork Pages builds correctly under the /anolisa/ base path
Additional Notes
Preview: https://kongche-jbw.github.io/anolisa/
Generated files under website/.generated/ and website/build/ are ignored
and must not be committed. The first phase intentionally excludes Docusaurus
versioning, blogs, CMS integration, and external search.
After merging, a maintainer must:
Open repository Settings → Pages.
Set Build and deployment → Source to GitHub Actions.
Ensure the github-pages environment permits deployments from main.
Confirm the custom domain remains agentic-os.sh and enable HTTPS.
Verify /, /install.sh, and /agents/ before retiring the legacy
branch-based Pages deployment.

[kongche-jbw]

preview
https://kongche-jbw.github.io/anolisa/