Repository navigation
Expand file tree
/
Copy pathindex.html
More file actions
163 lines (155 loc) · 31.7 KB
/
Copy pathindex.html
File metadata and controls
163 lines (155 loc) · 31.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>中文 Codex 实战手册</title>
<!-- guide:theme-bootstrap:start -->
<script src="assets/theme.js"></script>
<!-- guide:theme-bootstrap:end -->
<link rel="stylesheet" href="assets/site.css">
<!-- guide:metadata:start -->
<meta name="description" content="从一个可验证的小任务开始,并区分 Codex 原生能力与本指南推荐实践。">
<meta name="guide-build" content="ee947e14a0a9">
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="canonical" href="https://whojay0609.github.io/codex-usage-guide/index.html">
<meta property="og:type" content="website">
<meta property="og:locale" content="zh_CN">
<meta property="og:site_name" content="Codex 使用指南">
<meta property="og:title" content="中文 Codex 实战手册">
<meta property="og:description" content="从一个可验证的小任务开始,并区分 Codex 原生能力与本指南推荐实践。">
<meta property="og:url" content="https://whojay0609.github.io/codex-usage-guide/index.html">
<meta property="og:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Codex 使用指南">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="中文 Codex 实战手册">
<meta name="twitter:description" content="从一个可验证的小任务开始,并区分 Codex 原生能力与本指南推荐实践。">
<meta name="twitter:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta name="twitter:image:alt" content="Codex 使用指南">
<!-- guide:metadata:end -->
</head>
<body>
<!-- guide:header:start -->
<script src="assets/site-data.js"></script><a class="skip-link" href="#main-content">跳到正文</a><header class="topbar"><div class="topbar-inner"><a class="brand" href="index.html"><span class="brand-mark" aria-hidden="true"></span><span>Codex 使用指南</span></a><div class="topbar-actions"><label class="theme-control"><span class="sr-only">主题</span><select class="theme-select" id="theme-select" name="theme" aria-label="主题"><option value="light" selected>浅色</option><option value="dark">深色</option></select></label><span class="theme-status sr-only" aria-live="polite"></span><button class="search-trigger" type="button" aria-haspopup="dialog" aria-controls="site-search-dialog">搜索</button><button class="menu-toggle" type="button" aria-controls="global-nav" aria-expanded="false">目录</button></div></div></header><dialog class="search-dialog" id="site-search-dialog" role="dialog" aria-modal="true" aria-labelledby="site-search-title"><div class="search-dialog-panel"><div class="search-dialog-head"><p class="search-title" id="site-search-title">搜索全站</p><button class="search-close" type="button" aria-label="关闭搜索">关闭</button></div><label class="search-label" for="site-search-input">搜索标题、正文和可复用 prompt</label><input class="search-input" id="site-search-input" type="search" role="combobox" autocomplete="off" aria-autocomplete="list" aria-controls="site-search-results" aria-describedby="site-search-status" aria-expanded="false"><p class="search-message" id="site-search-status" aria-live="polite">输入关键词开始搜索。</p><ul class="search-results" id="site-search-results" role="listbox" aria-label="搜索结果"></ul></div></dialog>
<!-- guide:header:end -->
<!-- guide:shell-open:start -->
<div class="toolbook-shell"><aside class="global-nav" id="global-nav" aria-label="全站导航"><section class="global-nav-group"><strong>开始</strong><a data-nav href="index.html" aria-current="page">首页</a><a data-nav href="install-desktop.html">安装</a><a data-nav href="desktop-cli.html">Desktop</a></section><section class="global-nav-group"><strong>基础概念</strong><a data-nav href="codex.html">Codex</a><a data-nav href="git.html">Git</a><a data-nav href="worktrees.html">Worktrees</a><a data-nav href="permissions.html">权限</a><a data-nav href="agents-md.html">AGENTS.md</a><a data-nav href="skills.html">Skills</a><a data-nav href="mcp.html">MCP</a><a data-nav href="subagents.html">Subagents</a><a data-nav href="goal.html">Goal</a></section><section class="global-nav-group"><strong>任务路径</strong><a data-nav href="workflows.html">任务</a><a data-nav href="daily-workflow.html">日常</a><a data-nav href="engineering.html">工程</a><a data-nav href="research.html">学术</a><a data-nav href="automation.html">定时任务</a></section><section class="global-nav-group"><strong>扩展与资料</strong><a data-nav href="compound-engineering.html">Compound</a><details class="global-nav-disclosure"><summary>Skills 仓库</summary><a data-nav href="skills-repositories.html">全部仓库</a><a href="skills-repositories.html#compound-engineering">Compound Engineering</a><a href="skills-repositories.html#mattpocock-skills">Matt Pocock skills</a><a href="skills-repositories.html#academic-research-skills-codex">ARS</a><a href="skills-repositories.html#aris-auto-claude-code-research-in-sleep">ARIS</a><a href="skills-repositories.html#refine-user-prompt">refine-user-prompt</a></details><a data-nav href="prompt-guidance.html">提示词</a><a data-nav href="resources.html">资料</a></section></aside><div class="toolbook-main"><nav class="breadcrumbs" aria-label="面包屑"><a href="index.html">首页</a><span aria-hidden="true">/</span><span>开始</span><span aria-hidden="true">/</span><span aria-current="page">首页</span></nav><div class="page-freshness"><span>页面更新:<time datetime="2026-08-11">2026-08-11</time></span><span>事实核验:<time datetime="2026-08-11">2026-08-11</time></span></div><aside class="page-sources" aria-label="本页资料依据"><strong>本页依据</strong><a class="page-source-link external-link" href="https://learn.chatgpt.com/guides/best-practices" target="_blank" rel="noopener noreferrer" referrerpolicy="no-referrer"><span class="external-link-indicator" data-search-exclude aria-hidden="true">↗</span><span class="sr-only" data-search-exclude>(外部链接)</span><span class="source-kind">OpenAI 官方</span>Codex best practices</a></aside><aside class="page-toc" aria-label="本页目录"><details><summary>本页目录</summary><nav><a class="toc-h2" href="#最近更新">最近更新</a><a class="toc-h2" href="#原生能力与本指南推荐实践">原生能力与本指南推荐实践</a><a class="toc-h3" href="#codex-原生能力">Codex 原生能力</a><a class="toc-h3" href="#本指南推荐实践">本指南推荐实践</a><a class="toc-h2" href="#选择你的路径">选择你的路径</a><a class="toc-h3" href="#零基础-安装到第一个任务">零基础:安装到第一个任务</a><a class="toc-h3" href="#日常协作-桌面版工作流">日常协作:桌面版工作流</a><a class="toc-h3" href="#进阶用户-任务升级路线">进阶用户:任务升级路线</a><a class="toc-h3" href="#skills-仓库怎么选">Skills 仓库怎么选</a><a class="toc-h3" href="#工程-学术场景">工程 / 学术场景</a><a class="toc-h3" href="#维护者-资料和发布边界">维护者:资料和发布边界</a><a class="toc-h2" href="#30-秒选择入口">30 秒选择入口</a><a class="toc-h2" href="#需要时再查概念">需要时再查概念</a><a class="toc-h3" href="#codex-是什么">Codex 是什么</a><a class="toc-h3" href="#权限与安全">权限与安全</a><a class="toc-h3" href="#agents.md">AGENTS.md</a><a class="toc-h3" href="#git-basics">Git 基础</a><a class="toc-h3" href="#worktrees">Worktrees</a><a class="toc-h3" href="#skills">Skills</a><a class="toc-h3" href="#mcp-plugins">MCP 与 Plugins</a><a class="toc-h3" href="#subagents">Subagents</a><a class="toc-h3" href="#goal">Goal</a><a class="toc-h2" href="#每页都有真实实例">每页都有真实实例</a><a class="toc-h3" href="#日常实例">日常实例</a><a class="toc-h3" href="#插件实例">插件实例</a><a class="toc-h3" href="#skills-仓库实例">Skills 仓库实例</a><a class="toc-h3" href="#权限实例">权限实例</a><a class="toc-h3" href="#自动化实例">自动化实例</a></nav></details></aside>
<!-- guide:shell-open:end -->
<main id="main-content">
<section class="hero home-hero">
<div class="hero-copy">
<p class="hero-kicker">中文 Codex 实战手册</p>
<h1>从一个可验证的小任务开始使用 Codex</h1>
<p class="lead">这不是官方文档镜像,而是一份中文 Codex Desktop 实战手册;“Codex Desktop”在本指南中指 ChatGPT desktop app 中的 Codex 工作面。先完成安装、打开仓库、跑通第一个只读任务,再进入日常协作、工程、学术、定时任务和 Goal。</p>
<div class="hero-actions">
<a class="button primary" href="install-desktop.html">第一次使用:安装和第一个任务</a>
<a class="button" href="desktop-cli.html">日常协作:Desktop 工作流</a>
<a class="button" href="workflows.html">进阶路线:Goal / Subagents / Skills</a>
</div>
</div>
<div class="hero-visual route-panel" aria-label="Codex 使用路径">
<a href="install-desktop.html"><span>01</span><strong>刚开始</strong><em>安装 Desktop,登录账号,完成第一个只读任务。</em></a>
<a href="desktop-cli.html"><span>02</span><strong>会打开 Desktop 了</strong><em>学习线程、浏览器反馈、审批、diff 和发布验证。</em></a>
<a href="daily-workflow.html"><span>03</span><strong>要处理真实任务</strong><em>读代码、改文档、修 bug、跑测试、审查 diff。</em></a>
<a href="workflows.html"><span>04</span><strong>任务变复杂</strong><em>进入 Goal、Subagents、Skills、MCP 和自动化。</em></a>
</div>
</section>
<!-- guide:changelog:start -->
<section class="section recent-updates" aria-labelledby="最近更新"><div class="section-head"><div class="section-title"><p class="section-kicker">持续维护</p><h2 id="最近更新">最近更新<a class="heading-permalink" data-heading-permalink data-search-exclude href="#最近更新" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div><p>更新记录由 <code>data/changelog.json</code> 生成;先看最近三项,需要时再展开完整记录。</p></div><ol class="update-grid"><li class="update-card"><a href="git.html#git-worktree-workflow"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>质量</span></span><strong>第三轮读者与专家复核无新增阻塞问题</strong><span>完成首页、Git 概念、CLI Worktree 及 Desktop Worktree/Hand off/清理路径复核,未发现新问题,保留既有 CLI/Desktop 分工与回归门禁。</span></a></li><li class="update-card"><a href="git.html#git-worktree-workflow"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>质量</span></span><strong>补齐 CLI Worktree 路径与 Local 术语</strong><span>解释 CLI 占位符与仓库根目录前置条件,增加创建后状态检查,并区分 Local environment 与 Local 主工作树。</span></a></li><li class="update-card"><a href="index.html#需要时再查概念"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>内容</span></span><strong>补齐 Git 与 Worktree 概念入口</strong><span>首页新增 Git 与 Worktrees 卡片,并说明 Local 前台工作区、Hand off 操作和依赖/缓存边界。</span></a></li></ol><details class="changelog-disclosure"><summary>查看完整更新记录(21)</summary><ol class="update-list"><li class="update-row"><a href="git.html#git-worktree-workflow"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>质量</span></span><strong>第三轮读者与专家复核无新增阻塞问题</strong><span>完成首页、Git 概念、CLI Worktree 及 Desktop Worktree/Hand off/清理路径复核,未发现新问题,保留既有 CLI/Desktop 分工与回归门禁。</span></a></li><li class="update-row"><a href="git.html#git-worktree-workflow"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>质量</span></span><strong>补齐 CLI Worktree 路径与 Local 术语</strong><span>解释 CLI 占位符与仓库根目录前置条件,增加创建后状态检查,并区分 Local environment 与 Local 主工作树。</span></a></li><li class="update-row"><a href="index.html#需要时再查概念"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>内容</span></span><strong>补齐 Git 与 Worktree 概念入口</strong><span>首页新增 Git 与 Worktrees 卡片,并说明 Local 前台工作区、Hand off 操作和依赖/缓存边界。</span></a></li><li class="update-row"><a href="git.html#git-worktree-model"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>内容</span></span><strong>把 Git 页重构为 Worktree 主线</strong><span>压缩分支与 PR 介绍,补充 Worktree 的共享/独立边界、保护 Local 的高频闭环、安全清理规则和两张生成式辅助插图。</span></a></li><li class="update-row"><a href="git.html"><span class="update-meta"><time datetime="2026-08-11">2026-08-11</time><span>内容</span></span><strong>新增 Git 基础与项目高频操作</strong><span>用中文解释 repository、working tree、暂存区、commit、分支、HEAD、remote、merge 和 PR,并以匿名只读历史会话整理 dev 集成、短分支、显式 staging、验证和 PR 的项目模式。</span></a></li><li class="update-row"><a href="index.html"><span class="update-meta"><time datetime="2026-08-06">2026-08-06</time><span>质量</span></span><strong>根据读者与专家反馈整理首轮指南</strong><span>把新手首条路径、$skill-name 与插件 slash 命令、项目验证命令和 Desktop 页面边界说清,并加入公开发布路径与搜索索引覆盖门禁。</span></a></li><li class="update-row"><a href="skills-repositories.html#mattpocock-skills"><span class="update-meta"><time datetime="2026-08-06">2026-08-06</time><span>内容</span></span><strong>同步 Matt Pocock skills v1.2.2 说明</strong><span>更新 user-invoked / model-invoked 分层、ask-matt 到 implement 的工程主线、skills.sh 的 Codex 安装边界,以及原生 Codex plugin 暂缓和近期技能改名。</span></a></li><li class="update-row"><a href="install-desktop.html#安装到第一个任务"><span class="update-meta"><time datetime="2026-07-23">2026-07-23</time><span>内容</span></span><strong>补齐 Desktop 界面证据与可迁移案例</strong><span>新增五张 Desktop 操作示意截图、screenshot registry、日常/工程/学术/权限/MCP 演示案例,以及 CLI 附录、404、robots 与 sitemap。</span></a></li><li class="update-row"><a href="skills-repositories.html#whojay-skill"><span class="update-meta"><time datetime="2026-07-22">2026-07-22</time><span>内容</span></span><strong>新增 whojay-skill 证据工作流说明</strong><span>补充 WhoJay0609/whojay-skill 的工程与学术双工作流、证据状态、授权边界与隐私去标识说明。</span></a></li><li class="update-row"><a href="skills-repositories.html#dot-skills"><span class="update-meta"><time datetime="2026-07-22">2026-07-22</time><span>内容</span></span><strong>新增 dot-skills 开放格式目录说明</strong><span>补充 pproenca/dot-skills 的 curated/experimental 分层、Codex 安装目录、按项审查与第三方权限边界。</span></a></li><li class="update-row"><a href="skills-repositories.html#opencodex"><span class="update-meta"><time datetime="2026-07-22">2026-07-22</time><span>内容</span></span><strong>新增 OpenCodex 第三方代理说明</strong><span>补充 lidge-jun/opencodex 的本地 provider proxy 定位、原生 Codex 恢复路径及网络、凭据、账户和服务条款边界。</span></a></li><li class="update-row"><a href="index.html"><span class="update-meta"><time datetime="2026-07-21">2026-07-21</time><span>质量</span></span><strong>统一 Apple 风格界面体验</strong><span>系统化调整排版、材质、色彩、响应式层级与即时交互反馈,并补齐减少动态效果、减少透明度和高对比度适配。</span></a></li><li class="update-row"><a href="install-desktop.html#安装到第一个任务"><span class="update-meta"><time datetime="2026-07-16">2026-07-16</time><span>质量</span></span><strong>调整流程图与正文配图</strong><span>Mermaid 流程图尺寸;权限、MCP、Subagents、提示词四页的小黑配图;配图图注与替代文本。</span></a></li><li class="update-row"><a href="index.html#最近更新"><span class="update-meta"><time datetime="2026-07-16">2026-07-16</time><span>质量</span></span><strong>补齐资料依据与页面信息</strong><span>逐页资料依据、首页更新日志、权限模式表述、Skill/Plugin/MCP 分层、页脚内容与全页面响应式适配。</span></a></li><li class="update-row"><a href="prompt-guidance.html"><span class="update-meta"><time datetime="2026-07-16">2026-07-16</time><span>内容</span></span><strong>新增 GPT-5.6 提示词指南</strong><span>GPT-5.6 prompting guidance 中文解读、refine-user-prompt skill 介绍;移除原 Goal Entry 专题。</span></a></li><li class="update-row"><a href="skills-repositories.html"><span class="update-meta"><time datetime="2026-07-12">2026-07-12</time><span>内容</span></span><strong>新增中文 Prompt 仓库条目</strong><span>awesome-chatgpt-prompts-zh 仓库说明、Codex 使用示例与提示词安全边界。</span></a></li><li class="update-row"><a href="skills-repositories.html"><span class="update-meta"><time datetime="2026-07-12">2026-07-12</time><span>内容</span></span><strong>新增视觉与中文配图 Skills</strong><span>taste-skill 与 Ian Xiaohei Illustrations 的仓库说明、使用示例和适用边界。</span></a></li><li class="update-row"><a href="skills-repositories.html"><span class="update-meta"><time datetime="2026-07-12">2026-07-12</time><span>内容</span></span><strong>新增 Codex 生态 Top 10</strong><span>Skills、MCP、辅助工具榜单与官方基础设施条目。</span></a></li><li class="update-row"><a href="index.html"><span class="update-meta"><time datetime="2026-07-11">2026-07-11</time><span>结构</span></span><strong>新增站点清单与更新日志</strong><span>统一站点清单、首页最近更新、完整更新日志与站点生成数据。</span></a></li><li class="update-row"><a href="skills-repositories.html"><span class="update-meta"><time datetime="2026-07-10">2026-07-10</time><span>内容</span></span><strong>新增 Skills 仓库选择指南</strong><span>第三方 Skills 仓库对比、任务选择表与安装入口。</span></a></li><li class="update-row"><a href="compound-engineering.html"><span class="update-meta"><time datetime="2026-07-07">2026-07-07</time><span>内容</span></span><strong>新增 Compound Engineering 指南</strong><span>插件安装、核心流程与真实实例。</span></a></li></ol></details></section>
<!-- guide:changelog:end -->
<section class="section">
<div class="section-head"><div class="section-title"><p class="section-kicker">先分清边界</p><h2 id="原生能力与本指南推荐实践">原生能力与本指南推荐实践<a class="heading-permalink" data-heading-permalink data-search-exclude href="#原生能力与本指南推荐实践" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2></div><p>两类内容都能使用,但产品 UI、命令和可迁移性不同;看到“本指南推荐”时,不要把它当成 Codex 内置机制。</p></div>
<div class="bento">
<article class="card span-6"><h3 id="codex-原生能力">Codex 原生能力<a class="heading-permalink" data-heading-permalink data-search-exclude href="#codex-原生能力" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p><strong>Goal、Subagent、Worktree、MCP、AGENTS.md、Skills、Scheduled tasks(定时任务)和 Browser</strong> 都有产品或官方文档入口;具体可用性以当前客户端、配置和账户为准。</p></article>
<article class="card span-6 dark-card"><h3 id="本指南推荐实践">本指南推荐实践<a class="heading-permalink" data-heading-permalink data-search-exclude href="#本指南推荐实践" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h3><p><strong>receipt(任务回执)、grant(提示词授权约定)、A2/A3/A4 教学框架、五阶段工作流、prompt ladder(提示词阶梯)、claim ledger(主张台账)和六字段 Goal 模板</strong> 是本指南为提高可验证性整理的方法,不是原生 UI 功能。</p></article>
</div>
</section>
<section class="section">
<div class="section-head">
<div class="section-title">
<p class="section-kicker">从这里开始</p>
<span class="fragment-alias" id="heading-index-1" data-canonical-fragment="选择你的路径" aria-hidden="true"></span><h2 id="选择你的路径">选择你的路径<a class="heading-permalink" data-heading-permalink data-search-exclude href="#选择你的路径" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
</div>
<p class="scrub-text">不用先把术语背下来。按你现在要做的事选路线:从零开始、处理日常任务、跑长任务、安排周期任务,或维护这份指南。</p>
</div>
<div class="bento">
<a class="source-card span-6 priority-card" href="install-desktop.html"><span class="fragment-alias" id="heading-index-2" data-canonical-fragment="零基础-安装到第一个任务" aria-hidden="true"></span><h3 id="零基础-安装到第一个任务">零基础:安装到第一个任务</h3><p>安装 Codex Desktop,打开仓库,先跑一个只读任务,学会看验证证据。</p></a>
<a class="source-card span-6 priority-card" href="desktop-cli.html"><span class="fragment-alias" id="heading-index-3" data-canonical-fragment="日常协作-桌面版工作流" aria-hidden="true"></span><h3 id="日常协作-桌面版工作流">日常协作:桌面版工作流</h3><p>线程、上下文、浏览器反馈、权限审批、diff、提交和公开页面验证。</p></a>
<a class="source-card span-4" href="workflows.html"><span class="fragment-alias" id="heading-index-4" data-canonical-fragment="进阶用户-任务升级路线" aria-hidden="true"></span><h3 id="进阶用户-任务升级路线">进阶用户:任务升级路线</h3><p>判断何时从日常任务升级到 Goal、subagent、skill 或自动化。</p></a>
<a class="source-card span-4" href="skills-repositories.html"><span class="fragment-alias" id="heading-index-5" data-canonical-fragment="skills-仓库怎么选" aria-hidden="true"></span><h3 id="skills-仓库怎么选">Skills 仓库怎么选</h3><p>先看 Codex CLI 生态 Top 10,再按任务选择 skills、MCP 或其他辅助工具。</p></a>
<a class="source-card span-4" href="engineering.html"><span class="fragment-alias" id="heading-index-6" data-canonical-fragment="工程-学术场景" aria-hidden="true"></span><h3 id="工程-学术场景">工程 / 学术场景</h3><p>从需求澄清到工程 flow,或从 research brief 到实验与写作边界。</p></a>
<a class="source-card span-4" href="resources.html"><span class="fragment-alias" id="heading-index-7" data-canonical-fragment="维护者-资料和发布边界" aria-hidden="true"></span><h3 id="维护者-资料和发布边界">维护者:资料和发布边界</h3><p>README、AGENTS.md、local adaptation、发布验证和资料来源。</p></a>
</div>
</section>
<section class="section">
<div class="section-head">
<div class="section-title">
<p class="section-kicker">决策表</p>
<span class="fragment-alias" id="heading-index-8" data-canonical-fragment="30-秒选择入口" aria-hidden="true"></span><h2 id="30-秒选择入口">30 秒选择入口<a class="heading-permalink" data-heading-permalink data-search-exclude href="#30-秒选择入口" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
</div>
<p>先选工作面,再看页面。读者不需要知道所有术语,只要知道当前任务最适合放在哪个入口,以及完成后拿什么证据验收。</p>
</div>
<div class="decision-table">
<div class="decision-row"><strong>改网页</strong><span>首选:Desktop + Browser(内置浏览器)</span><span>避免:只用口头描述问题</span><span>证据:页面预览、截图/评论、<code>make check</code></span></div>
<div class="decision-row"><strong>修测试</strong><span>首选:Desktop 任务 + Integrated terminal(集成终端)</span><span>避免:让模型凭猜测改代码</span><span>证据:失败日志、最窄测试、diff(差异)审查</span></div>
<div class="decision-row"><strong>长任务</strong><span>首选:Goal(目标)/ subagent(子代理)/ skills(技能)</span><span>避免:单轮聊天里混多个目标</span><span>证据:objective(目标)、validation(验证)、closeout(收口)</span></div>
<div class="decision-row"><strong>周期任务</strong><span>首选:Scheduled tasks(定时任务)</span><span>避免:手工重复提醒</span><span>证据:Scheduled 视图、运行记录、后台 worktree(工作树)</span></div>
</div>
<div class="tier-badges" aria-label="资料层级">
<span class="tier-badge">官方事实:OpenAI Codex docs</span>
<span class="tier-badge">插件扩展:Compound Engineering / local skills</span>
<span class="tier-badge">经验建议:本指南工作流沉淀</span>
</div>
</section>
<section class="section">
<div class="section-head">
<div class="section-title">
<p class="section-kicker">概念地图</p>
<span class="fragment-alias" id="heading-index-9" data-canonical-fragment="需要时再查概念" aria-hidden="true"></span><h2 id="需要时再查概念">需要时再查概念<a class="heading-permalink" data-heading-permalink data-search-exclude href="#需要时再查概念" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
</div>
<p>这些页面解释背后的原因。新手不用一次读完;遇到权限、项目规则、工具扩展或长任务时再回来查。</p>
<aside class="callout"><strong>新手顺序:</strong>先完成<a href="install-desktop.html">零基础:安装到第一个任务</a>里的安装、仓库选择和只读任务;<code>Goal</code>、<code>subagent</code>、Skills、MCP 等概念,遇到对应任务时再回来查。</aside>
</div>
<div class="bento">
<a class="source-card span-4" href="codex.html"><span class="fragment-alias" id="heading-index-10" data-canonical-fragment="codex-是什么" aria-hidden="true"></span><h3 id="codex-是什么">Codex 是什么</h3><p>以 Codex Desktop 为主:线程、Local/Worktree、浏览器、Git、终端和自动化。</p></a>
<a class="source-card span-4" href="permissions.html"><span class="fragment-alias" id="heading-index-11" data-canonical-fragment="权限与安全" aria-hidden="true"></span><h3 id="权限与安全">权限与安全</h3><p>sandbox、approval、network、auth 和 secret 边界。</p></a>
<a class="source-card span-4" href="agents-md.html"><span class="fragment-alias" id="heading-index-12" data-canonical-fragment="agents.md" aria-hidden="true"></span><h3 id="agents.md">AGENTS.md</h3><p>项目规则、层级、测试命令和完成证据。</p></a>
<a class="source-card span-3" href="git.html"><h3 id="git-basics">Git 基础</h3><p>用 status、diff 和 Worktree 命令先读现场,再进入隔离任务。</p></a>
<a class="source-card span-3" href="worktrees.html"><h3 id="worktrees">Worktrees</h3><p>在 Codex Desktop 中隔离任务,理解 Local、生命周期和 Hand off 边界。</p></a>
<a class="source-card span-3" href="skills.html"><span class="fragment-alias" id="heading-index-13" data-canonical-fragment="skills" aria-hidden="true"></span><h3 id="skills">Skills</h3><p>官方 skills 与本机扩展的边界。</p></a>
<a class="source-card span-3" href="mcp.html"><span class="fragment-alias" id="heading-index-14" data-canonical-fragment="mcp-plugins" aria-hidden="true"></span><h3 id="mcp-plugins">MCP 与 Plugins</h3><p>区分协议、外部服务与可安装能力包。</p></a>
<a class="source-card span-3" href="subagents.html"><span class="fragment-alias" id="heading-index-15" data-canonical-fragment="subagents" aria-hidden="true"></span><h3 id="subagents">Subagents</h3><p>何时拆分、如何约束、如何收口。</p></a>
<a class="source-card span-3" href="goal.html"><span class="fragment-alias" id="heading-index-16" data-canonical-fragment="goal" aria-hidden="true"></span><h3 id="goal">Goal</h3><p>目标、验收、验证、停止条件和 closeout。</p></a>
</div>
</section>
<section class="section">
<div class="section-head">
<div class="section-title">
<p class="section-kicker">真实实例</p>
<span class="fragment-alias" id="heading-index-17" data-canonical-fragment="每页都有真实实例" aria-hidden="true"></span><h2 id="每页都有真实实例">每页都有真实实例<a class="heading-permalink" data-heading-permalink data-search-exclude href="#每页都有真实实例" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2>
</div>
<p>这份指南以 <code>codex-usage-guide</code> 自身的 Desktop 维护过程为主线:从浏览器反馈、插件资料核对、页面编辑、本地验证,到 GitHub Pages 发布。</p>
</div>
<div class="bento">
<a class="source-card span-3" href="daily-workflow.html"><span class="fragment-alias" id="heading-index-18" data-canonical-fragment="日常实例" aria-hidden="true"></span><h3 id="日常实例">日常实例</h3><p>把短页面扩成日常任务手册。</p></a>
<a class="source-card span-3" href="compound-engineering.html"><span class="fragment-alias" id="heading-index-19" data-canonical-fragment="插件实例" aria-hidden="true"></span><h3 id="插件实例">插件实例</h3><p>介绍 Compound Engineering 在 Codex Desktop 里的安装和使用路径。</p></a>
<a class="source-card span-3" href="skills-repositories.html"><span class="fragment-alias" id="heading-index-20" data-canonical-fragment="skills-仓库实例" aria-hidden="true"></span><h3 id="skills-仓库实例">Skills 仓库实例</h3><p>把 Codex CLI 生态 Top 10 和可复制的仓库选择规则整理成一页。</p></a>
<a class="source-card span-3" href="permissions.html"><span class="fragment-alias" id="heading-index-21" data-canonical-fragment="权限实例" aria-hidden="true"></span><h3 id="权限实例">权限实例</h3><p>只读验证 GitHub Pages 发布状态。</p></a>
<a class="source-card span-3" href="automation.html"><span class="fragment-alias" id="heading-index-22" data-canonical-fragment="自动化实例" aria-hidden="true"></span><h3 id="自动化实例">自动化实例</h3><p>自动检查链接和公开页面关键标题。</p></a>
</div>
</section>
</main>
<!-- guide:shell-close:start -->
<nav class="page-sequence" aria-label="前后页"><a rel="next" href="install-desktop.html">安装 →</a></nav></div></div>
<!-- guide:shell-close:end -->
<footer class="footer">
<p><strong>Codex 使用指南</strong><br>多页面 GitHub Pages 文档站,官方资料优先,完成证据优先。</p>
<a class="button" href="resources.html">资料地图</a>
</footer>
<!-- guide:runtime:start -->
<script src="assets/site.js"></script>
<!-- guide:runtime:end -->
</body>
</html>