Merge pull request #425 from Yumiue/fix/www-content-sync-main

fix(www): 修正首页安装区块布局、补充缺失文档内容并隐藏全局滚动条

Author: pionxe

www/.vitepress/theme/components/QuickStartCards.vue

@@ -5,87 +5,101 @@ const props = defineProps<{
 	locale?: 'zh' | 'en'
 }>()
 
-const isEnglish = computed(() => props.locale === 'en')
-
 const installUnix = 'curl -fsSL https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts/install.sh | bash'
 const installWindows = 'irm https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts/install.ps1 | iex'
 const fromSource = `git clone https://github.com/1024XEngineer/neo-code.git
 cd neo-code
 go run ./cmd/neocode`
-const envUnix = `export OPENAI_API_KEY="your_key_here"
-export GEMINI_API_KEY="your_key_here"
-export AI_API_KEY="your_key_here"
-export QINIU_API_KEY="your_key_here"`
-const envWindows = `$env:OPENAI_API_KEY = "your_key_here"
-$env:GEMINI_API_KEY = "your_key_here"
-$env:AI_API_KEY = "your_key_here"
-$env:QINIU_API_KEY = "your_key_here"`
-</script>
-
-<template>
-  <div class="quickstart-grid" v-if="isEnglish">
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">Try Now</p>
-      <h3>Install with one command</h3>
-      <p>Use the same install scripts maintained in the repository README.</p>
-      <CodePanel language="bash" label="macOS / Linux" :code="installUnix" />
-      <CodePanel language="powershell" label="Windows PowerShell" :code="installWindows" />
-    </article>
 
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">From Source</p>
-      <h3>Run the current codebase</h3>
-      <p>Best when you want to inspect behavior, debug issues, or contribute changes.</p>
-      <CodePanel language="bash" label="Clone and run" :code="fromSource" />
-    </article>
+type QuickStartCard = {
+	key: string
+	kicker: string
+	title: string
+	description: string
+	panels: Array<{
+		language: 'bash' | 'powershell'
+		label: string
+		code: string
+	}>
+	links: Array<{
+		text: string
+		code: string
+	}>
+}
 
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">First Run</p>
-      <h3>Set provider credentials</h3>
-      <p>NeoCode reads API keys from environment variables instead of storing them in config files.</p>
-      <CodePanel language="bash" label="Shell" :code="envUnix" />
-      <CodePanel language="powershell" label="PowerShell" :code="envWindows" />
-      <div class="quickstart-links">
-        <p>Workspace isolation: <code>--workdir</code></p>
-        <p>Gateway command: <code>neocode gateway</code></p>
-        <p><a href="/neo-code/guide/quick-start">Chinese quick start</a></p>
-        <p><a href="/neo-code/en/docs/">English docs index</a></p>
-      </div>
-    </article>
-  </div>
+const quickStartCards: Record<'zh' | 'en', QuickStartCard[]> = {
+	zh: [
+		{
+			key: 'install',
+			kicker: '安装脚本',
+			title: '安装 NeoCode',
+			description: '直接使用仓库里维护的安装脚本，适合先把本地环境跑起来。',
+			panels: [
+				{ language: 'bash', label: 'macOS / Linux', code: installUnix },
+				{ language: 'powershell', label: 'Windows PowerShell', code: installWindows },
+			],
+			links: [{ text: '安装完成后运行：', code: 'neocode' }],
+		},
+		{
+			key: 'source',
+			kicker: '源码运行',
+			title: '从源码运行',
+			description: '准备调试、看源码或参与开发时，直接运行当前仓库即可。',
+			panels: [{ language: 'bash', label: 'Clone and run', code: fromSource }],
+			links: [
+				{ text: '网关进程：', code: 'go run ./cmd/neocode gateway' },
+				{ text: '会话工作区：', code: '--workdir /path/to/workspace' },
+			],
+		},
+	],
+	en: [
+		{
+			key: 'install',
+			kicker: 'Install',
+			title: 'Install with one command',
+			description: 'Use the same install scripts maintained in the repository README.',
+			panels: [
+				{ language: 'bash', label: 'macOS / Linux', code: installUnix },
+				{ language: 'powershell', label: 'Windows PowerShell', code: installWindows },
+			],
+			links: [{ text: 'Then run: ', code: 'neocode' }],
+		},
+		{
+			key: 'source',
+			kicker: 'Source',
+			title: 'Run the current codebase',
+			description: 'Best when you want to inspect behavior, debug issues, or contribute changes.',
+			panels: [{ language: 'bash', label: 'Clone and run', code: fromSource }],
+			links: [
+				{ text: 'Gateway command: ', code: 'go run ./cmd/neocode gateway' },
+				{ text: 'Workspace isolation: ', code: '--workdir /path/to/workspace' },
+			],
+		},
+	],
+}
 
-  <div class="quickstart-grid" v-else>
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">Step 1</p>
-      <h3>安装 NeoCode</h3>
-      <p>直接使用仓库里维护的安装脚本，适合先把本地环境跑起来。</p>
-      <CodePanel language="bash" label="macOS / Linux" :code="installUnix" />
-      <CodePanel language="powershell" label="Windows PowerShell" :code="installWindows" />
-    </article>
-
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">Step 2</p>
-      <h3>从源码运行</h3>
-      <p>准备调试、看源码或参与开发时，直接运行当前仓库即可。</p>
-      <CodePanel language="bash" label="Clone and run" :code="fromSource" />
-      <div class="quickstart-links">
-        <p>会话工作区：<code>--workdir /path/to/workspace</code></p>
-        <p>网关进程：<code>go run ./cmd/neocode gateway</code></p>
-      </div>
-    </article>
+const currentLocale = computed<'zh' | 'en'>(() => (props.locale === 'en' ? 'en' : 'zh'))
+const currentCards = computed(() => quickStartCards[currentLocale.value])
+</script>
 
-    <article class="quickstart-card">
-      <p class="quickstart-kicker">Step 3</p>
-      <h3>配置 API Key</h3>
-      <p>当前内置 provider 包括 <code>openai</code>、<code>gemini</code>、<code>openll</code> 和 <code>qiniu</code>。</p>
-      <CodePanel language="bash" label="Shell" :code="envUnix" />
-      <CodePanel language="powershell" label="PowerShell" :code="envWindows" />
-      <div class="quickstart-links">
-        <p>工作区隔离：<code>--workdir</code></p>
-        <p>网关命令：<code>neocode gateway</code></p>
-        <p><a href="/neo-code/guide/quick-start">继续看首次上手</a></p>
-        <p><a href="/neo-code/guide/gateway">查看 Gateway 用法</a></p>
-      </div>
-    </article>
-  </div>
+<template>
+	<div class="quickstart-grid">
+		<article v-for="card in currentCards" :key="card.key" class="quickstart-card">
+			<p class="quickstart-kicker">{{ card.kicker }}</p>
+			<h3>{{ card.title }}</h3>
+			<p>{{ card.description }}</p>
+			<CodePanel
+				v-for="panel in card.panels"
+				:key="`${card.key}-${panel.label}`"
+				:language="panel.language"
+				:label="panel.label"
+				:code="panel.code"
+			/>
+			<div class="quickstart-links">
+				<p v-for="link in card.links" :key="`${card.key}-${link.code}`">
+					{{ link.text }}<code>{{ link.code }}</code>
+				</p>
+			</div>
+		</article>
+	</div>
 </template>

www/.vitepress/theme/custom.css

@@ -235,27 +235,23 @@ body {
   text-underline-offset: 0.14em;
 }
 
-.VPDoc div[class*='language-'],
-.vp-code-group {
+:is(.VPDoc div[class*='language-'], .vp-code-group) {
   border: 1px solid rgba(253, 165, 128, 0.16);
   box-shadow: 0 16px 36px rgba(9, 11, 26, 0.1);
 }
 
-.VPDoc div[class*='language-'] .vp-copy-code-button,
-.vp-code-group .vp-copy-code-button {
+:is(.VPDoc div[class*='language-'], .vp-code-group) .vp-copy-code-button {
   border: none;
   border-radius: 999px;
   background-color: rgba(253, 165, 128, 0.9);
 }
 
-.dark .VPDoc div[class*='language-'],
-.dark .vp-code-group {
+.dark :is(.VPDoc div[class*='language-'], .vp-code-group) {
   border-color: rgba(253, 165, 128, 0.16);
   box-shadow: 0 18px 38px rgba(0, 0, 0, 0.28);
 }
 
-.dark .VPDoc div[class*='language-'] .vp-copy-code-button,
-.dark .vp-code-group .vp-copy-code-button {
+.dark :is(.VPDoc div[class*='language-'], .vp-code-group) .vp-copy-code-button {
   background-color: rgba(253, 165, 128, 0.24);
 }
 
@@ -321,13 +317,11 @@ body {
 }
 
 .quickstart-grid {
-  grid-template-columns: repeat(3, minmax(0, 1fr));
+  grid-template-columns: repeat(2, minmax(0, 1fr));
   align-items: stretch;
 }
 
-.info-grid > *,
-.doc-grid > *,
-.quickstart-grid > * {
+:is(.info-grid, .doc-grid, .quickstart-grid) > * {
   min-width: 0;
 }
 
@@ -342,8 +336,7 @@ body {
   box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 16px 38px rgba(0, 0, 0, 0.2);
 }
 
-.info-card h3,
-.quickstart-card h3 {
+:is(.info-card, .quickstart-card) h3 {
   margin-top: 0;
   margin-bottom: 10px;
   color: #fff4ea;
@@ -402,9 +395,7 @@ body {
   font-size: 17px;
 }
 
-.doc-card code,
-.quickstart-card code,
-.info-card code {
+:is(.doc-card, .quickstart-card, .info-card) code {
   color: #ffd0ba;
   background: rgba(253, 165, 128, 0.12);
 }
@@ -503,7 +494,6 @@ body {
     grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
-  .quickstart-grid .quickstart-card:last-child,
   .doc-grid .doc-card:last-child {
     grid-column: 1 / -1;
   }
@@ -529,7 +519,6 @@ body {
     grid-template-columns: 1fr;
   }
 
-  .quickstart-grid .quickstart-card:last-child,
   .doc-grid .doc-card:last-child {
     grid-column: auto;
   }

www/en/docs/index.md

@@ -5,17 +5,30 @@ description: A compact English entrypoint that links to the primary Chinese guid
 
 # Docs Index
 
-The Chinese guide is the primary documentation set for NeoCode right now. This page stays short on purpose and only links to the most useful entry points.
+The Chinese guide is the primary documentation set for NeoCode right now. This page links to the most useful entry points.
 
 ## Start Here
 
+If you are new to NeoCode, read in this order:
+
+1. [What is NeoCode](/guide/getting-started) (Chinese)
+2. [Install and run](/guide/install) (Chinese)
+3. [Quick start](/guide/quick-start) (Chinese)
+4. [Configuration](/guide/configuration) (Chinese)
+5. [Gateway and URL dispatch](/guide/gateway) (Chinese)
+
+## Direct Links
+
 - [Chinese guide overview](/guide/)
 - [Install and run](/guide/install)
 - [Quick start](/guide/quick-start)
 - [Configuration](/guide/configuration)
+- [Workspace and sessions](/guide/workspace-session)
+- [Memory and Skills](/guide/memo-skills)
 - [Gateway and URL dispatch](/guide/gateway)
+- [Update and version check](/guide/update)
 
-## Repository Docs
+## Reference
 
 - [Reference index](/reference/)
 - [README](https://github.com/1024XEngineer/neo-code/blob/main/README.md)

www/en/index.md

@@ -25,7 +25,7 @@ features:
   - title: Terminal-native
     details: TUI interface. No browser needed. Works directly inside your shell workflow.
   - title: Multi-model support
-    details: One config file manages OpenAI, Gemini, Ollama, and more. Switch between models without changing code.
+    details: Built-in support for OpenAI, Gemini, OpenLL, Qiniu and more. Switch between models without changing code.
 ---
 
 <section class="home-section compact">
@@ -42,6 +42,10 @@ features:
       <strong>English docs index</strong>
       <span>A short overview with links into the Chinese guide and repository docs.</span>
     </a>
+    <a class="doc-card" href="/neo-code/guide/install">
+      <strong>Set credentials</strong>
+      <span>Configure <code>OPENAI_API_KEY</code>, <code>GEMINI_API_KEY</code>, and other provider API keys.</span>
+    </a>
     <a class="doc-card" href="/neo-code/guide/">
       <strong>Chinese guide</strong>
       <span>The primary user guide covering install, quick start, configuration, sessions, memo, skills, and Gateway usage.</span>

www/guide/install.md

@@ -24,6 +24,17 @@ curl -fsSL https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts
 irm https://raw.githubusercontent.com/1024XEngineer/neo-code/main/scripts/install.ps1 | iex
 ```
 
+安装脚本会自动从 GitHub Releases 下载最新稳定版二进制文件：
+
+- macOS / Linux：下载并解压到 `/usr/local/bin/`（可能需要 `sudo` 权限）
+- Windows：下载并解压到 `%LOCALAPPDATA%\NeoCode`，同时更新用户 `PATH`
+
+安装完成后，在终端直接运行：
+
+```bash
+neocode
+```
+
 ## 从源码运行
 
 ```bash

www/guide/memo-skills.md

@@ -50,6 +50,41 @@ Skills 不会改变：
 - 每个 Skill 目录要求存在 `SKILL.md`
 - 也支持 root 目录直接放一个 `SKILL.md`
 
+### 仓库内置 Skills
+
+NeoCode 仓库本身也维护了一套 Skills，位于：
+
+```text
+.agents/skills/
+```
+
+包含三类：
+
+- `issue-rfc-proposal` — 提案类 Issue（RFC 风格）
+- `issue-rfc-architecture` — 架构类 Issue（RFC 风格）
+- `issue-rfc-implementation` — 实现类 Issue（执行单风格）
+
+可以通过 `make` 一键安装到常用 AI 工具目录：
+
+```bash
+make install-skills
+```
+
+默认会安装到以下位置：
+
+```text
+.codex/skills
+.claude/skills
+.cursor/skills
+.windsurf/skills
+```
+
+如果需要自定义目标，设置 `SKILL_INSTALL_TARGETS`：
+
+```bash
+SKILL_INSTALL_TARGETS=".codex/skills:.claude/skills" make install-skills
+```
+
 ## 会话内 Skills 命令
 
 ```text

www/guide/quick-start.md

@@ -75,3 +75,4 @@ go run ./cmd/neocode
 - 想了解配置文件和自定义 Provider：看 [配置入口](./configuration)
 - 想理解工作区、会话切换和压缩：看 [工作区与会话](./workspace-session)
 - 想启用记忆和 Skills：看 [记忆与 Skills](./memo-skills)
+- 想手动升级或了解静默版本检测：看 [升级与版本检查](./update)

www/index.md

@@ -25,7 +25,7 @@ features:
   - title: 终端原生
     details: TUI 界面，无需浏览器，和你的 shell 工作流无缝集成，直接在终端中对话和操作。
   - title: 多模型支持
-    details: 一份配置管理 OpenAI、Gemini、Ollama 等多个模型服务，随时切换，无需改代码。
+    details: 内置 OpenAI、Gemini、OpenLL、Qiniu 等多个模型服务，通过配置随时切换，无需改代码。
 ---
 
 <section class="home-section compact">
@@ -46,6 +46,10 @@ features:
       <strong>首次上手</strong>
       <span>第一次提问、常用 Slash 命令和 Provider / Model 切换。</span>
     </a>
+    <a class="doc-card" href="/neo-code/guide/install">
+      <strong>配置环境变量</strong>
+      <span>设置 <code>OPENAI_API_KEY</code>、<code>GEMINI_API_KEY</code> 等 API Key 环境变量。</span>
+    </a>
     <a class="doc-card" href="/neo-code/guide/configuration">
       <strong>配置</strong>
       <span><code>config.yaml</code>、custom provider 和环境变量。</span>