@@ -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