A bilingual, evidence-led research archive by Theodore Ouyang.
围绕人工智能、机器人与技术路径，把复杂问题整理成可审阅、可引用、可复核的判断。
Every work is preserved as a complete Chinese edition and a complete English edition, with its evidence boundary and audit trail kept close to the writing.
中文阅读 · Read in English · Research · Articles · Reflections
Astro 7 TypeScript Bilingual Evidence-led GitHub Pages disabled
- Three published works: two research dossiers and one technical essay.
- Complete bilingual editions: language switching preserves the reader's position instead of replacing full works with summaries.
- Reviewable provenance: manifests, source ledgers, audit notes, and preserved research archives travel with the relevant work.
- Independent reading surface: the static Astro site is hosted separately from
theodoreoy.comand from GitHub Pages.
2026-08-02 · Research
中文全文 · English version · Read on web
2026-07-29 · Article
中文全文 · English version · Read on web
2026-07-14 · Research
中文全文 · English version · Read on web
| Layer | What is shown |
|---|---|
| Research | Source-led analysis with explicit separation between evidence, claims, explanation, and interpretation |
| Editorial | Complete Chinese and English editions with stable metadata and collection indexes |
| Product | A responsive reading interface with persistent language choice, accessible navigation, and compact-screen outlines |
| Engineering | Schema validation, deterministic index generation, static-site auditing, and a version-locked Astro build |
Each work lives in its own folder. The report, sources, audit trail, figures, and any preserved research archive travel together instead of being scattered across the repository.
portfolio/
├─ research/
│ └─ YYYY-MM-DD-project/
│ ├─ README.zh-CN.md
│ ├─ README.en.md
│ ├─ post.json
│ ├─ SOURCES.yaml
│ └─ source-snapshot/ # when a project includes a full archive
├─ articles/
├─ reflections/
└─ src/ # shared reading interface
Markdown inside each project folder is the canonical editable source. A
post.json manifest drives the website and indexes; SOURCES.yaml, AUDIT.md,
MIGRATION.md, and source-snapshot/ preserve the available evidence and
provenance for projects that need them. Generated HTML under _site/ is
disposable.
npm ci
npm run check
npm run buildnpm run check validates content manifests, generated indexes, and Astro types. The build then copies public source artifacts and audits the generated site.
The repository uses a version-locked Astro static build. Operational details live in the Publishing Standard; architectural decisions live in ADR-001.
GitHub Actions validates the archive, but GitHub Pages remains disabled. The public reading site is hosted independently so this project cannot inherit or alter the custom-domain behavior of the separate personal-site repository.
No blanket license is granted. Unless a file says otherwise, reuse permission is not implied; third-party materials remain subject to their original rights.