Skip to content

[codex] add Chinese beginner tutorial#376

Draft
kaixuan147123 wants to merge 1 commit into
shareAI-lab:mainfrom
kaixuan147123:codex/zh-beginner-tutorial
Draft

[codex] add Chinese beginner tutorial#376
kaixuan147123 wants to merge 1 commit into
shareAI-lab:mainfrom
kaixuan147123:codex/zh-beginner-tutorial

Conversation

@kaixuan147123

Copy link
Copy Markdown

What changed

  • add a Chinese beginner roadmap that explains Loop, Prompt, Context, and Harness Engineering in plain language
  • add per-session beginner cards with a single learning goal, an everyday analogy, a minimum learning target, and a guided click path
  • add expandable line-by-line Chinese explanations below tutorial code blocks
  • add beginner guidance to the full source viewer
  • add Windows one-click start, installation-test, and safe stop helpers
  • keep the new learning layer scoped to the zh locale; existing English and Japanese content remains unchanged

Why

The current course is comprehensive, but readers with no Python or agent-engineering background can struggle to connect the code examples to the underlying ideas or to run the project locally. This contribution adds a gradual bridge from concepts to simulation, source reading, and real execution.

User impact

Chinese beginners can follow a repeatable learning sequence:

  1. understand the chapter in plain language
  2. use the no-key simulator
  3. expand line-by-line code explanations
  4. inspect only the relevant source keywords
  5. run the chapter after configuring an API key

The English and Japanese experiences are not modified by the locale-specific beginner components.

Safety

  • API keys, .env, virtual environments, dependencies, and runtime PID files are excluded from Git
  • the stop helper only terminates a PID recorded by the start helper and verifies that its command line is the tutorial's npm run dev process
  • no credentials or local secrets are included in the commit

Validation

  • npm.cmd run build
  • tutorial-tools/test-installation.ps1
  • PowerShell parser checks for all helper scripts
  • manual browser verification of the Chinese roadmap, session guide, simulator step flow, and expandable code explanations

@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

@kaixuan147123 is attempting to deploy a commit to the crazyboym's projects Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant