docs: update README and documentation to clarify model configuration and restart requirements

- Enhanced instructions for restarting Cursor after upgrades or initial model configuration to ensure proper functionality.
- Updated references from "Troubleshooting" to "Frequently Asked Questions" for better alignment with user needs.
- Improved clarity in the installation and usage steps across multiple language versions.

apps/docs/app/[lang]/(home)/blog/page.tsx

@@ -5,16 +5,18 @@ import { ArrowRight } from 'lucide-react';
 import { blogSource, formatBlogDate, sortBlogPages } from '@/lib/blog';
 import { isLanguage, type Language } from '@/lib/i18n';
 
-const copy: Record<Language, { title: string; description: string; intro: string }> = {
+const copy: Record<Language, { title: string; description: string; intro: string; empty: string }> = {
   zh: {
     title: '开发者博客',
     description: 'Cursor Byok 的架构决策、协议实现与开发进展。',
     intro: '记录 Cursor Byok 的架构决策、协议实现和开发进展。',
+    empty: '文章正在准备中。',
   },
   en: {
     title: 'Developer Blog',
     description: 'Architecture decisions, protocol work, and development progress of Cursor Byok.',
     intro: 'Notes on architecture decisions, protocol work, and development progress of Cursor Byok.',
+    empty: 'Articles are being prepared.',
   },
 };
 
@@ -43,26 +45,30 @@ export default async function BlogPage(props: PageProps<'/[lang]/blog'>) {
         <p className="mt-4 text-lg leading-8 text-fd-muted-foreground">{t.intro}</p>
       </div>
 
-      <div className="mt-12 divide-y border-y">
-        {posts.map((post) => (
-          <Link
-            key={post.url}
-            href={post.url}
-            className="group grid gap-3 py-7 transition-colors hover:text-fd-primary sm:grid-cols-[10rem_1fr_auto] sm:items-center"
-          >
-            <time className="text-sm text-fd-muted-foreground">
-              {formatBlogDate(post.path, lang)}
-            </time>
-            <div>
-              <h2 className="font-semibold">{post.data.title}</h2>
-              <p className="mt-1 text-sm leading-6 text-fd-muted-foreground">
-                {post.data.description}
-              </p>
-            </div>
-            <ArrowRight className="hidden size-4 transition-transform group-hover:translate-x-1 sm:block" />
-          </Link>
-        ))}
-      </div>
+      {posts.length > 0 ? (
+        <div className="mt-12 divide-y border-y">
+          {posts.map((post) => (
+            <Link
+              key={post.url}
+              href={post.url}
+              className="group grid gap-3 py-7 transition-colors hover:text-fd-primary sm:grid-cols-[10rem_1fr_auto] sm:items-center"
+            >
+              <time className="text-sm text-fd-muted-foreground">
+                {formatBlogDate(post.path, lang)}
+              </time>
+              <div>
+                <h2 className="font-semibold">{post.data.title}</h2>
+                <p className="mt-1 text-sm leading-6 text-fd-muted-foreground">
+                  {post.data.description}
+                </p>
+              </div>
+              <ArrowRight className="hidden size-4 transition-transform group-hover:translate-x-1 sm:block" />
+            </Link>
+          ))}
+        </div>
+      ) : (
+        <p className="mt-12 border-y py-8 text-fd-muted-foreground">{t.empty}</p>
+      )}
     </main>
   );
 }

apps/docs/app/[lang]/(home)/page.tsx

@@ -57,9 +57,9 @@ const copy: Record<
       },
       {
         icon: Wrench,
-        title: '故障排查',
-        description: '解决证书、连接和模型测试问题。',
-        href: '/docs/troubleshooting',
+        title: '常见问题',
+        description: '回答常见问题。',
+        href: '/docs/faq',
       },
     ],
     blogEyebrow: 'DEVELOPER BLOG',
@@ -91,9 +91,9 @@ const copy: Record<
       },
       {
         icon: Wrench,
-        title: 'Troubleshooting',
-        description: 'Resolve certificate, connection, and model test issues.',
-        href: '/docs/troubleshooting',
+        title: 'Frequently Asked Questions',
+        description: 'Answer common questions.',
+        href: '/docs/faq',
       },
     ],
     blogEyebrow: 'DEVELOPER BLOG',
@@ -206,39 +206,43 @@ export default async function HomePage(props: PageProps<'/[lang]'>) {
         </div>
       </section>
 
-      <section className="px-6 py-16 sm:py-20">
-        <div className="mx-auto max-w-5xl">
-          <div className="flex items-end justify-between gap-6">
-            <div>
-              <p className="font-mono text-sm font-medium text-fd-primary">{t.blogEyebrow}</p>
-              <h2 className="mt-3 text-3xl font-bold tracking-tight">{t.blogTitle}</h2>
-            </div>
-            <Link href={`${prefix}/blog`} className="flex items-center gap-2 text-sm font-medium">
-              {t.viewAll}
-              <ArrowRight className="size-4" />
-            </Link>
-          </div>
-
-          <div className="mt-10 divide-y border-y">
-            {posts.map((post) => (
-              <Link
-                key={post.url}
-                href={post.url}
-                className="group grid gap-3 py-6 transition-colors hover:text-fd-primary sm:grid-cols-[10rem_1fr_auto] sm:items-center"
-              >
-                <time className="text-sm text-fd-muted-foreground">
-                  {formatBlogDate(post.path, lang)}
-                </time>
-                <div>
-                  <h3 className="font-semibold">{post.data.title}</h3>
-                  <p className="mt-1 text-sm text-fd-muted-foreground">{post.data.description}</p>
-                </div>
-                <ArrowRight className="hidden size-4 transition-transform group-hover:translate-x-1 sm:block" />
+      {posts.length > 0 ? (
+        <section className="px-6 py-16 sm:py-20">
+          <div className="mx-auto max-w-5xl">
+            <div className="flex items-end justify-between gap-6">
+              <div>
+                <p className="font-mono text-sm font-medium text-fd-primary">{t.blogEyebrow}</p>
+                <h2 className="mt-3 text-3xl font-bold tracking-tight">{t.blogTitle}</h2>
+              </div>
+              <Link href={`${prefix}/blog`} className="flex items-center gap-2 text-sm font-medium">
+                {t.viewAll}
+                <ArrowRight className="size-4" />
               </Link>
-            ))}
+            </div>
+
+            <div className="mt-10 divide-y border-y">
+              {posts.map((post) => (
+                <Link
+                  key={post.url}
+                  href={post.url}
+                  className="group grid gap-3 py-6 transition-colors hover:text-fd-primary sm:grid-cols-[10rem_1fr_auto] sm:items-center"
+                >
+                  <time className="text-sm text-fd-muted-foreground">
+                    {formatBlogDate(post.path, lang)}
+                  </time>
+                  <div>
+                    <h3 className="font-semibold">{post.data.title}</h3>
+                    <p className="mt-1 text-sm text-fd-muted-foreground">
+                      {post.data.description}
+                    </p>
+                  </div>
+                  <ArrowRight className="hidden size-4 transition-transform group-hover:translate-x-1 sm:block" />
+                </Link>
+              ))}
+            </div>
           </div>
-        </div>
-      </section>
+        </section>
+      ) : null}
     </main>
   );
 }

apps/docs/app/[lang]/layout.tsx

@@ -18,7 +18,7 @@ export async function generateMetadata(props: LayoutProps<'/[lang]'>): Promise<M
         default: 'Cursor Byok Docs',
         template: '%s | Cursor Byok',
       },
-      description: 'Installation, model configuration, and troubleshooting guide for Cursor Byok.',
+      description: 'Installation, model configuration, and frequently asked questions for Cursor Byok.',
     };
   }
 
@@ -28,7 +28,7 @@ export async function generateMetadata(props: LayoutProps<'/[lang]'>): Promise<M
       default: 'Cursor Byok 文档',
       template: '%s | Cursor Byok',
     },
-    description: 'Cursor Byok 的安装、模型配置与故障排查指南。',
+    description: '安装、模型配置与常见问题指南。',
   };
 }