Skip to content

Commit 08f9c6a

Browse files
committed
feat(导航): 添加上游改造总览导航项并更新指南页面
重构指南页面的说明部分,明确指南覆盖范围并添加相关资源链接 简化命名说明的展示方式
1 parent 7dcedf3 commit 08f9c6a

2 files changed

Lines changed: 68 additions & 11 deletions

File tree

src/nav.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,6 +202,7 @@ export const navGroups: NavGroup[] = [
202202
icon: '📚',
203203
defaultOpen: false,
204204
items: [
205+
{ id: 'upstream-diff', label: '上游改造总览', highlight: true },
205206
{ id: 'config', label: '配置系统' },
206207
{ id: 'auth', label: '认证流程' },
207208
{ id: 'startup', label: '启动流程' },

src/pages/StartHere.tsx

Lines changed: 67 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -99,17 +99,73 @@ export function StartHere({ onNavigate }: StartHereProps) {
9999
</div>
100100
</section>
101101

102-
{/* Background Note */}
103-
<section className="bg-[var(--bg-panel)]/50 rounded-lg p-4 border border-[var(--border-subtle)] text-sm">
104-
<div className="flex items-start gap-3">
105-
<span className="text-[var(--amber)] text-lg">💡</span>
106-
<div>
107-
<h3 className="font-semibold text-[var(--text-primary)] mb-1">关于命名</h3>
108-
<p className="text-[var(--text-secondary)]">
109-
Qwen CLI 基于 <span className="text-[var(--cyber-blue)]">Google Gemini CLI</span> 改造而来。
110-
因此源码中会看到 <code className="text-[var(--amber)] bg-[var(--amber)]/10 px-1 rounded">GeminiChat</code>
111-
<code className="text-[var(--amber)] bg-[var(--amber)]/10 px-1 rounded">geminiChat.ts</code> 等命名,
112-
以及 <code className="text-[var(--amber)] bg-[var(--amber)]/10 px-1 rounded">Gemini 格式</code> 的消息结构 —— 这些都是历史遗留的内部命名,不影响理解。
102+
{/* Scope Declaration */}
103+
<section className="bg-[var(--bg-panel)]/50 rounded-lg p-5 border border-[var(--border-subtle)]">
104+
<h3 className="font-bold text-[var(--text-primary)] mb-4 flex items-center gap-2">
105+
<span className="text-[var(--terminal-green)]">📖</span>
106+
这份指南是什么
107+
</h3>
108+
109+
<div className="grid grid-cols-1 md:grid-cols-2 gap-4 mb-4">
110+
{/* What this IS */}
111+
<div className="bg-[var(--terminal-green)]/5 rounded-lg p-4 border border-[var(--terminal-green)]/20">
112+
<h4 className="text-[var(--terminal-green)] font-semibold mb-2 text-sm flex items-center gap-2">
113+
<span></span> 本指南覆盖
114+
</h4>
115+
<ul className="text-sm text-[var(--text-secondary)] space-y-1">
116+
<li><strong>架构设计</strong> — 系统如何分层、模块如何协作</li>
117+
<li><strong>源码导读</strong> — 关键代码的实现细节与行级引用</li>
118+
<li><strong>设计决策</strong> — 为什么这样设计、有哪些权衡</li>
119+
<li><strong>内部机制</strong> — 状态机、调度器、格式转换等</li>
120+
</ul>
121+
</div>
122+
123+
{/* What this is NOT */}
124+
<div className="bg-[var(--red)]/5 rounded-lg p-4 border border-[var(--red)]/20">
125+
<h4 className="text-[var(--red)] font-semibold mb-2 text-sm flex items-center gap-2">
126+
<span></span> 本指南不覆盖
127+
</h4>
128+
<ul className="text-sm text-[var(--text-secondary)] space-y-1">
129+
<li><strong>使用教程</strong> — 如何安装、配置、日常使用</li>
130+
<li><strong>命令手册</strong> — 完整的命令行参数说明</li>
131+
<li><strong>API 文档</strong> — 公开接口的调用方式</li>
132+
<li><strong>故障排除</strong> — 常见问题与解决方案</li>
133+
</ul>
134+
</div>
135+
</div>
136+
137+
{/* Where to go */}
138+
<div className="bg-[var(--bg-void)] rounded-lg p-4 border border-[var(--border-subtle)]">
139+
<h4 className="text-[var(--text-primary)] font-semibold mb-3 text-sm">🔗 相关资源</h4>
140+
<div className="grid grid-cols-1 md:grid-cols-3 gap-3 text-xs">
141+
<div className="flex items-center gap-2 text-[var(--text-secondary)]">
142+
<span className="text-[var(--cyber-blue)]">📘</span>
143+
<span><strong>用户文档</strong><code className="text-[var(--cyber-blue)]">/docs</code> 目录</span>
144+
</div>
145+
<button
146+
onClick={() => onNavigate?.('upstream-diff')}
147+
className="flex items-center gap-2 text-[var(--text-secondary)] hover:text-[var(--amber)] transition-colors text-left"
148+
>
149+
<span className="text-[var(--amber)]">🔀</span>
150+
<span><strong>上游改造</strong><code className="text-[var(--amber)] hover:underline">查看详情</code></span>
151+
</button>
152+
<div className="flex items-center gap-2 text-[var(--text-secondary)]">
153+
<span className="text-[var(--purple)]">🏢</span>
154+
<span><strong>版本记录</strong><code className="text-[var(--purple)]">CHANGELOG.md</code></span>
155+
</div>
156+
</div>
157+
</div>
158+
159+
{/* Naming note - simplified */}
160+
<div className="mt-4 pt-4 border-t border-[var(--border-subtle)] text-sm">
161+
<div className="flex items-start gap-2">
162+
<span className="text-[var(--amber)]">💡</span>
163+
<p className="text-[var(--text-muted)]">
164+
<strong className="text-[var(--text-secondary)]">关于命名:</strong>
165+
Qwen CLI 基于 Google Gemini CLI 改造,源码中的
166+
<code className="text-[var(--amber)] bg-[var(--amber)]/10 px-1 rounded mx-1">GeminiChat</code>
167+
<code className="text-[var(--amber)] bg-[var(--amber)]/10 px-1 rounded mx-1">Gemini 格式</code>
168+
等是历史遗留命名。
113169
</p>
114170
</div>
115171
</div>

0 commit comments

Comments
 (0)