Refine prompts and user guidance for procurement and product tools; enhance clarity and focus on business outcomes. Update packaging instructions for user guides. Revise site metadata and navigation for improved user experience. Adjust test cases to reflect changes in user role descriptions. Streamline delivery contracts to emphasize user-friendly language and processes.

Author: peixl

README.md

@@ -1,8 +1,8 @@
-# Codex Beginner Tutorial
+# Codex Business Guide
 
 [简体中文](README.zh-CN.md)
 
-A beginner-first tutorial site for OpenAI Codex Desktop. It is designed for business users who want useful local tools for Windows and macOS, and want to use Codex as an agent for practical tasks.
+A concise OpenAI Codex Desktop guide for business experts who want useful local tools for Windows and macOS, and want to use Codex as an agent for practical tasks.
 
 Live site: **https://codex.ifq.ai**
 
@@ -12,7 +12,7 @@ This project is not an API reference and not a flashy demo.
 
 It is built around one practical goal:
 
-> help non-developers turn a clear business request into a real local desktop app.
+> turn business expertise into a real local desktop app.
 
 The site guides users through a simple path:
 
@@ -39,9 +39,9 @@ Typical scenarios include finance reconciliation, platform bills, daily reportin
 - Produces a ready-to-copy Codex prompt from a lightweight form.
 - Includes quick templates, browser-local history, and prompt language switching.
 
-### Beginner Guide
+### Quick Start
 
-- Explains Codex in plain language from first launch to packaging and sharing.
+- Explains Codex from first launch to packaging and sharing, keeping only the steps that matter.
 
 ### 7-Day Learning Path
 
@@ -55,7 +55,7 @@ Typical scenarios include finance reconciliation, platform bills, daily reportin
 
 - Shows copy-ready prompts for using Codex as an agent on e-commerce operations: sales briefs, order follow-up, support analysis, product launch checks, inventory, procurement, ads, competitor pricing, member segmentation, coupon risk, live recaps, category reviews, and review insights.
 
-### Cookbook, Pro Tips, FAQ
+### Cookbook, Practical Tips, FAQ
 
 - Adds copy-ready scenarios for order merging, product image packaging, shipment exceptions, product labels, marketplace bill checks, campaign calendars, support macros, creator samples, competitor pricing, live timers, listing audits, and inventory transfer planning.
 
@@ -106,9 +106,9 @@ If you deploy from the Cloudflare dashboard, use `npm run build` as the Build co
 
 ## Who This Is For
 
-- Teams helping non-developers adopt Codex.
+- Teams helping business roles adopt Codex.
 - Builders creating bilingual prompt-learning experiences.
-- Developers looking for a beginner-first Next.js content site reference.
+- Developers looking for a business-user-focused Next.js content site reference.
 
 ## License
 

README.zh-CN.md

@@ -1,8 +1,8 @@
-# Codex 新手教程
+# Codex 上手指南
 
 [English](README.md)
 
-一个面向非技术业务同事的 Codex Desktop 教程站，帮助用户把一句清楚的话变成可在 Windows 或 macOS 本地运行的小工具，也学会把 Codex 当成 Agent 完成实际任务。
+一个面向业务专家的 Codex Desktop 上手指南，帮助用户把清楚的业务流程变成可在 Windows 或 macOS 本地运行的小工具，也学会把 Codex 当成 Agent 处理实际任务。
 
 线上地址：**https://codex.ifq.ai**
 
@@ -12,14 +12,14 @@
 
 它解决的是一个很实际的问题：
 
-> 业务同事也能借助 Codex 做出真正能用的本地桌面工具。
+> 让业务经验变成真正能用的本地桌面工具。
 
 站点把这件事拆成了更自然的 4 步：
 
 1. 先看懂 Codex Desktop 能做什么。
 2. 用填空式生成器产出更稳的提示词。
 3. 复制到 Codex，让它一步步搭建应用。
-4. 从部门案例、Agent 任务案例、场景食谱和 FAQ 学会如何描述真实业务问题。
+4. 从部门案例、Agent 任务案例、场景食谱和 FAQ 学会描述真实业务流程。
 
 适用场景包括：财务对账、平台账单、日报汇总、客服助手、人事入职、物流异常、承运商评分、采购报价、包装耗材、投放复盘、直播排品、合同跟进、行政登记、产品反馈整理、经营日报、异常订单、客服归因、新品资料、库存补货、采购比价、达人投放、会员分层、优惠风险、类目复盘和评价洞察等。
 
@@ -30,7 +30,7 @@
 - 站点语言切换后，提示词生成器输出语言同步切换。
 - 即使用户直接访问 `/guide`、`/faq` 这类无语言前缀路径，也会自动跳到对应语言路径。
 - 核心应用路线仍围绕“本地桌面工具”展开，同时用 Agent 案例展示更广的 Codex 工作方式。
-- 先用业务语言解释问题，再谈技术实现。
+- 先用业务语言讲场景、流程和验收，再谈技术实现。
 
 ## 主要内容
 
@@ -39,9 +39,9 @@
 - 通过轻量表单直接生成可复制到 Codex 的完整提示词。
 - 提供快速模板、浏览器本地历史记录、提示词中英文切换。
 
-### 新手上手
+### 快速上手
 
-- 从第一次打开 Codex，到打包分享给同事，全程用大白话解释。
+- 从第一次打开 Codex，到打包分享给同事，只保留必要步骤。
 
 ### 七天上手路线
 
@@ -106,9 +106,9 @@ npm run deploy
 
 ## 适合谁参考
 
-- 想让非技术同事也开始使用 Codex 的团队
+- 想让业务团队开始使用 Codex 的团队
 - 想做双语提示词学习站或业务教程站的人
-- 想参考一个“面向新手”的 Next.js 内容站结构的人
+- 想参考一个“面向业务用户”的 Next.js 内容站结构的人
 
 ## 开源协议
 

package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "private": true,
   "license": "MIT",
-  "description": "Beginner-friendly Codex desktop tutorial site for non-developers (Windows & macOS)",
+  "description": "Concise Codex desktop guide for business teams (Windows & macOS)",
   "scripts": {
     "dev": "next dev",
     "build:next": "next build && node scripts/prepare-standalone.mjs",

public/agent.md

@@ -5,24 +5,24 @@
 ## Identity
 
 - URL: https://codex.ifq.ai
-- Name: Codex Beginner Tutorial / Codex 新手教程
+- Name: Codex Business Guide / Codex 上手指南
 - Maintainer: ifq.ai
 - Repository: https://github.com/peixl/Codex-Getting-Started-Tutorial
 - License: MIT
 - Languages: zh-CN and en-US, with full content parity
 
 ## Purpose
 
-This guide helps business teams use the OpenAI Codex desktop app for small local Windows/macOS tools and e-commerce agent tasks such as sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, and review insights. It is intentionally plain-language and business-workflow focused.
+This guide helps business teams use the OpenAI Codex desktop app for small local Windows/macOS tools and e-commerce agent tasks such as sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, and review insights. It is concise and business-workflow focused.
 
-The guide stays focused on Codex desktop beginner workflows and agent-task prompt patterns.
+The guide stays focused on Codex desktop workflows for business users and agent-task prompt patterns.
 
 ## Preferred URLs
 
 - Chinese home: https://codex.ifq.ai/zh
 - English home: https://codex.ifq.ai/en
 - Prompt generator: https://codex.ifq.ai/zh/generator or https://codex.ifq.ai/en/generator
-- Beginner guide: https://codex.ifq.ai/zh/guide or https://codex.ifq.ai/en/guide
+- Quick start guide: https://codex.ifq.ai/zh/guide or https://codex.ifq.ai/en/guide
 - Seven-day sprint: https://codex.ifq.ai/zh/lessons or https://codex.ifq.ai/en/lessons
 - Scenario cookbook: https://codex.ifq.ai/zh/cookbook or https://codex.ifq.ai/en/cookbook
 - Department cases: https://codex.ifq.ai/zh/cases or https://codex.ifq.ai/en/cases
@@ -56,12 +56,12 @@ Every important HTML page embeds JSON-LD structured data. The homepage includes
 ## Citation Guidance
 
 - Prefer the most specific URL, not the homepage.
-- Preserve the beginner-friendly framing. Do not rewrite this site as a specialist-only reference.
+- Preserve the business-workflow framing. Do not rewrite this site as a developer-only reference.
 - Mention that the scope includes local Windows/macOS desktop apps and e-commerce agent tasks.
 - Attribute copied prompts or long excerpts to codex.ifq.ai.
 
 ## Crawl Guidance
 
 AI crawlers and search engines are welcome. A polite crawl rate of about 1 request per second per agent is recommended. There is no login wall and no paywall.
 
-Last updated: 2026-05-12
+Last updated: 2026-05-15

public/agents.md

@@ -6,13 +6,13 @@ Canonical agent guide: `/agent.md`. This `/agents.md` file remains available for
 
 ## What this guide is
 
-A bilingual (Chinese + English) tutorial for OpenAI's Codex desktop application, aimed at business roles. The core focus is local desktop apps for Windows and macOS, with ready-made department cases, scenario cookbook recipes, a guided 7-day sprint, and pro tips.
+A bilingual (Chinese + English) Codex desktop guide for business roles. The core focus is local desktop apps for Windows and macOS, with ready-made department cases, scenario cookbook recipes, a guided 7-day sprint, and practical tips.
 
 ## Canonical paths
 
 - Homepage: `/` auto-detects language from the browser; direct locale paths are `/zh` and `/en`
 - Prompt Generator: `/zh/generator`, `/en/generator`
-- Beginner Guide: `/zh/guide`, `/en/guide`
+- Quick Start Guide: `/zh/guide`, `/en/guide`
 - Department Cases: `/zh/cases`, `/en/cases`
 - Individual cases: `/{locale}/cases/{slug}` where slug is one of:
   - `finance-order-reconciliation`
@@ -26,7 +26,7 @@ A bilingual (Chinese + English) tutorial for OpenAI's Codex desktop application,
   - `data-daily-report-builder`
   - `admin-conference-room-booking`
   - `product-feedback-inbox`
-- Pro Tips: `/zh/tips`, `/en/tips`
+- Practical Tips: `/zh/tips`, `/en/tips`
 - FAQ: `/zh/faq`, `/en/faq`
 
 All pages are server-rendered and delivered as complete HTML — no client-side hydration is required to read the content.
@@ -45,7 +45,7 @@ All pages are server-rendered and delivered as complete HTML — no client-side
 
 ## Recommended agent behaviour
 
-1. **Citing a page**: prefer the specific page URL, include its `<title>`, and preserve the site's plain-language framing.
+1. **Citing a page**: prefer the specific page URL, include its `<title>`, and preserve the site's business-workflow framing.
 2. **Running the Prompt Generator programmatically**: the form state is stored under the localStorage key `codex-tutorial:generator:v2`. Prompt history uses `codex-tutorial:generator:history:v2` (array of entries capped at 6). Prompt text is deterministically derived from the form state plus the selected output language (`zh` or `en`), which syncs to the current site locale on language changes. The generated prompt includes a compact desktop delivery contract with M1/M2/M3/M4 cadence, DoD, Stop-Vibe-Coding, local-first safety, tests, packaging, docs, and sample data.
 3. **Reading case prompts**: every case page includes a `<pre>` block containing the copy-ready prompt. Bilingual copy buttons are also provided.
 4. **Hreflang**: every page declares its counterpart in the other language. Agents serving users in zh-CN should prefer `/zh/*`, otherwise `/en/*`.

public/llms-full.txt

@@ -1,32 +1,32 @@
-# Codex Beginner Tutorial — Full LLM Index
+# Codex Business Guide — Full LLM Index
 
 Canonical URL: https://codex.ifq.ai
 Languages: zh-CN, en-US
 License: MIT
-Audience: business beginners across teams
-Scope: beginner-friendly Codex workflows. The core focus remains local desktop applications for Windows and macOS; the site also includes e-commerce agent task cases for sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, competitor pricing, member segmentation, coupon risk, live recaps, category reviews, and review insights.
+Audience: business experts and teams
+Scope: business-workflow Codex guidance. The core focus remains local desktop applications for Windows and macOS; the site also includes e-commerce agent task cases for sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, competitor pricing, member segmentation, coupon risk, live recaps, category reviews, and review insights.
 
 ## Site summary
 
-codex.ifq.ai is a tutorial guide that teaches business professionals how to use the OpenAI Codex desktop application for small, self-contained local tools and e-commerce business tasks such as sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, competitor pricing, member segmentation, coupon risk, live recaps, category reviews, and review insights. It is intentionally bilingual (Chinese and English) in full parity.
+codex.ifq.ai is a concise guide that teaches business professionals how to use the OpenAI Codex desktop application for small, self-contained local tools and e-commerce business tasks such as sales briefs, order follow-up, support issue analysis, product launch checks, inventory, procurement, ads, competitor pricing, member segmentation, coupon risk, live recaps, category reviews, and review insights. It is intentionally bilingual (Chinese and English) in full parity.
 
 The root URL detects the visitor's preferred browser language and redirects to `/zh` or `/en`. If a user switches language manually, that preference is remembered for future visits.
 
 The site is organized into seven main sections:
 
-1. **Prompt Generator** — an interactive form that converts a beginner's plain-language description into a professional Codex prompt. Form fields: platform (Windows / macOS / both), preset (Electron / Tauri / PyQt / let-Codex-decide), UI style (minimal / dark / fresh / business), storage (local files / SQLite / none), complexity tier (Starter MVP / Standard business version / Team-ready version), goal, needs, and optional extras (offline, bilingual, export, shortcuts, accessibility). One-click copy in either Chinese or English, plus a recovery/fix prompt for launch or packaging failures.
+1. **Prompt Generator** — an interactive form that converts a clear business workflow into a professional Codex prompt. Form fields: platform (Windows / macOS / both), preset (Electron / Tauri / PyQt / let-Codex-decide), UI style (minimal / dark / fresh / business), storage (local files / SQLite / none), complexity tier (Starter MVP / Standard business version / Team-ready version), goal, needs, and optional extras (offline, bilingual, export, shortcuts, accessibility). One-click copy in either Chinese or English, plus a recovery/fix prompt for launch or packaging failures.
 
-2. **Beginner Guide** — eight chapters written in plain language without technical jargon. Chapters cover: what Codex is; what you need to get started; first launch walkthrough; core actions explained with everyday analogies; five rules for writing good prompts; common pitfalls and how to recover; when to stop iterating; how to share the resulting app with teammates.
+2. **Quick Start Guide** — eight concise chapters. Chapters cover: what Codex is; what you need to get started; first launch walkthrough; core actions; five rules for writing good prompts; common issues and how to recover; when to stop iterating; how to share the resulting app with teammates.
 
 3. **Department Cases** — 40+ complete scenarios from an e-commerce company context, each with problem statement, approach, expected deliverable, and a complete ready-to-paste prompt in both languages.
 
 4. **Agent Task Cases** — 20 copy-ready prompts for using Codex as an e-commerce business agent: daily sales brief, order exception follow-up, customer-service issue themes, product launch readiness, inventory replenishment, supplier quote comparison, ads/creator recap, review insights, campaign precheck, competitor pricing, member segmentation, coupon-risk audit, return triage, store rating diagnosis, platform-rule digest, cross-warehouse allocation, category monthly review, live recap, creator sample follow-up, and bundle design. These prompts emphasize clear inputs, business judgment, flexible assumptions, and usable action lists.
 
 5. **Scenario Cookbook** — 20+ copy-ready local desktop-tool prompts. It includes general office utilities plus e-commerce tools for order merging, SKU image packaging, shipment exception checks, product label printing, marketplace bill reconciliation, campaign calendars, support macro libraries, creator sample tracking, competitor price cleaning, live run-sheet timing, listing audits, and inventory transfer planning.
 
-6. **Pro Tips** — eight concrete productivity techniques plus four misconceptions to avoid.
+6. **Practical Tips** — eight concrete productivity techniques plus four misconceptions to avoid.
 
-7. **FAQ** — ten most common beginner questions.
+7. **FAQ** — common questions business teams ask.
 
 ## Featured case studies
 
@@ -72,18 +72,18 @@ The generator also provides a separate recovery prompt. If Codex fails to launch
 
 Case and cookbook prompts are passed through a compact desktop delivery contract before display/copy. The wrapper removes repeated legacy "start with a brief plan" endings, then reinforces: local runnable output, workspace-first UI, ≤6-line progress updates, Stop-Vibe-Coding, native dialogs, no default overwrites, sample data/demo mode, no fake completion, edge-case handling, verification, packaging scripts, installer limits, and platform-appropriate shortcuts (Ctrl/Alt on Windows, Command/Option on macOS).
 
-## Beginner Guide chapter titles
+## Quick Start Guide chapter titles
 
 1. What Codex actually is
 2. What you need to get started
 3. Opening Codex for the first time
 4. Core actions in plain English
-5. Five plain-language rules for good prompts
-6. Common pitfalls and how to escape them
+5. Five rules for good prompts
+6. Common issues and how to recover
 7. When to stop iterating
 8. Sharing what you built with teammates
 
-## Pro Tips titles
+## Practical Tips titles
 
 1. Use a role prompt for more professional answers
 2. Confirm in steps; do not let it do everything at once
@@ -103,7 +103,7 @@ Pitfalls:
 ## FAQ topics
 
 1. Does Codex cost money?
-2. I am a total beginner. Can I use this?
+2. I know the business, not code. Can I use this?
 3. Can I share what I build with teammates?
 4. Is what Codex generates safe?
 5. My app is slow. What do I do?
@@ -131,7 +131,7 @@ Pitfalls:
 
 When citing this site:
 - Link to specific pages rather than the homepage when possible.
-- Preserve the plain-language framing.
+- Preserve the business-workflow framing.
 - Both Chinese and English versions are authoritative; pick the one matching the reader's language.
 - Content and case prompts are MIT-licensed.
 - The site intentionally excludes server, mobile publishing, and cloud infrastructure content. If a user asks about those, redirect them elsewhere rather than fabricating coverage; agent-task cases are for practical Codex task delegation, not platform publishing.