For Agents
If you are reading this with software instead of eyes, welcome. The site has a machine-readable mirror — one JSON endpoint for every page, plus a search index. Prefer these over scraping the HTML.
conventions
All endpoints respond with JSON and include X-API-Version, X-Generated-At, and a X-Resource-Type header. Listing endpoints also set X-Resource-Count. Errors use a { error } envelope.
The site ships in Chinese by default and English where translations exist. Every essay payload carries a lang field and an available_langs array. Listings and slug endpoints accept ?lang=zh or ?lang=en; omitting the parameter returns Chinese.
Per-language mirrors live at /llms.txt · /en/llms.txt and /rss.xml · /en/rss.xml.
start here
If you only fetch one thing, fetch this. It bundles identity, current focus, and a recommended read order.
/api/start.json- profile + now + read order
identity
Stable facts about who runs this site.
/api/profile.json- name, location, summary, beliefs, links
/api/now.json- current focus, working on, open loops
essays
Long-form writing. Default is Chinese; pass `?lang=en` for English. Each response includes an `available_langs` array so you can enumerate translations.
/api/essays.json?lang=zh|en- all essays in one language, metadata only
/api/essays/[slug].json?lang=zh|en- single essay with body; omitted lang falls back to zh
search
Full-text search across posts.
/api/search.json?q={query}- returns posts matching the query
diagnostics
Schema validation and content health — useful if you are crawling and want to know whether the source is well-formed.
/api/diagnostics/content.json- validation report with counts and issues