Purpose
This repository maintains the public bilingual documentation for The One Desktop on The Zeroth website.
It contains user-facing documentation, release notes, screenshots, and demo videos. It does not contain product source code, private infrastructure, internal implementation details, secrets, or deployment-only configuration.
Documentation Structure
The canonical documentation lives under content/docs/en and content/docs/zh. Both languages use the same slugs so the website can switch languages without route drift.
content/docs
+-- en/ English documentation
| +-- index.mdx Welcome
| +-- start/ Quick start, models and pricing, release notes
| | `-- release-notes/ One page per release line
| +-- the-one-app/ Using The One
| | +-- main-assistant.mdx … Main assistant, matters, working groups, Needs you,
| | | triggers, evolution, action log, phone channel
| | +-- capabilities/ Templates, roles, Skills and prompts, MCP, models,
| | | Plugins, Atlas, Definition Spaces, memory
| | `-- settings/ Settings, API configuration, All runs, Linux server
| `-- multi-agent-architecture/ Concepts
| +-- single-agent/ Model, tools, context, ReAct, action sequence
| +-- evolution/ From a single Agent to Multi-Agent
| +-- a-genetic-engineering/ Templates as genes
| +-- prolifera-engineering/ Growing the system at runtime
| `-- more-possibilities/ Communication, context editing, dynamic Graph, meditation
`-- zh/ Chinese documentation, same slugs
Drafts and Assets
docs_md: local source drafts for new documentation. This directory is ignored by Git.resources: earlier 0.1.0 demo videos kept for reference; no page uses them.public/docs-assets/images: screenshots used by documentation pages.public/docs-assets/videos: demo videos used by documentation pages.
Editing
Pages are written directly in content/docs/en and content/docs/zh; update both languages together. Screenshots of the current app live in public/docs-assets/images/<version>/<locale>/, captured from the app in that language. The website syncs content/docs and public/docs-assets from this repository.
scripts/migrate_docs_md.py, which generated the first version of these pages from docs_md, has been removed. It deleted content/docs before regenerating it and no longer matched the published pages. It remains in the Git history.
Maintenance Rules
- English and Chinese documents must keep matching slugs so language switching stays stable.
- User-facing content belongs in
content/docs; raw drafts belong in local docs_md.
- Screenshots and videos must be served from
public/docs-assets; pages should not reference local draft paths.
- Do not commit product source code, secrets, internal architecture details, or deployment-only configuration to this repository.
Scope
The One is a desktop app in which one main assistant takes every request and hands the work to working groups of AI agents running on the user's own computer.
This repository is only responsible for public documentation. The desktop implementation, backend services, account system, model-call implementation, and internal orchestration logic are outside this repository.
