图片说明更改与图标引入

Author: hungryM0

.vitepress/config.mts

@@ -5,20 +5,24 @@ export default defineConfig({
   base: '/',
   title: "SurveyController",
   description: "基于 VitePress 的文档站点",
+  head: [
+    ['link', { rel: 'icon', href: '/assets/icon.ico' }]
+  ],
   themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
     nav: [
       { text: '首页', link: '/' },
-      { text: '示例', link: '/markdown-examples' }
+      { text: '状态监测', link: 'https://status.hungrym0.top/status/surveycontroller' }
     ],
 
     sidebar: [
       {
         text: '示例',
         items: [
           { text: '下载与安装', link: '/download-install' },
+          { text: '如何提问', link: '/how-to-ask' },
           { text: '使用说明', link: '/usage-guide' },
-          { text: 'API Key配置', link: '/api-key-configuration' }
+          { text: 'API Key 配置', link: '/api-key-configuration' }
         ]
       }
     ],

.vitepress/theme/custom.css

@@ -0,0 +1,67 @@
+:root {
+  --vp-home-hero-name-color: var(--vp-c-brand-1);
+}
+
+.VPHero.has-image .container {
+  text-align: left !important;
+}
+
+.VPHero.has-image .name,
+.VPHero.has-image .text,
+.VPHero.has-image .tagline {
+  margin: 0 !important;
+}
+
+.VPHero.has-image .actions {
+  justify-content: flex-start !important;
+}
+
+@media (min-width: 960px) {
+  .VPHero .container {
+    justify-content: flex-start !important;
+  }
+
+  .VPHero .main {
+    order: 2 !important;
+    flex-grow: 0 !important;
+  }
+
+  .VPHero .image {
+    order: 1 !important;
+    flex-grow: 0 !important;
+    margin: 0 48px 0 0 !important;
+  }
+
+  .VPHero .image-container {
+    width: 220px !important;
+    height: 220px !important;
+    transform: none !important;
+  }
+
+  .VPHero .image-bg {
+    width: 160px !important;
+    height: 160px !important;
+  }
+
+  .VPHero .image-src {
+    max-width: 160px !important;
+    max-height: 160px !important;
+  }
+}
+
+@media (max-width: 959px) {
+  .VPHero .image-container {
+    width: 180px !important;
+    height: 180px !important;
+  }
+
+  .VPHero .image-bg {
+    width: 132px !important;
+    height: 132px !important;
+  }
+
+  .VPHero .image-src {
+    max-width: 132px !important;
+    max-height: 132px !important;
+  }
+}

.vitepress/theme/index.js

@@ -0,0 +1,4 @@
+import DefaultTheme from 'vitepress/theme'
+import './custom.css'
+
+export default DefaultTheme

api-key-configuration.md

@@ -1,3 +1,7 @@
+---
+outline: deep
+---
+
 # API Key 配置
 
 ## 以 DeepSeek 为例，拿 Key 的流程：

assets/icon.ico

@@ -10,9 +10,9 @@
 
 双击下载到的安装包（此处以v3.0.4版本的为例），按提示安装。
 
-![安装](assets/install_1.png)
+![安装包界面](assets/install_1.png)
 
-如果没有什么特别要求，大多数人保持默认一路下一步就行。
+如果没有什么特别要求，大多数人保持默认一路`下一步`就行。
 
 **没有必要听信什么“安装到 D 盘”之类的营销号，除非你真的有这个刚需。**
 
@@ -24,4 +24,9 @@
 
 其实安装完成后桌面一般都会自动创建快捷方式。要是没看到，估计你是那种把桌面当作默认下载路径的用户，你可能有必要仔细在灾后废墟一样乱的桌面上找一找了。实在不行，在开始菜单或许也能找到。
 
-如果程序打不开，**请提供完整报错截图和文字信息**，再去群里或 GitHub 反馈。什么都不提供就只知到说一句“打不开”，那我能做的只有给你算一卦。
+如果程序打不开，**请提供完整报错截图和文字信息**，再去群里或 GitHub 反馈！
+
+什么都不提供就只知道说一句：
+`“打不开”` `“请问这个是什么原因呢”` `“实在是没招了呀”`
+
+那我能做的只有给你算一卦。

assets/icon.png

@@ -0,0 +1,9 @@
+---
+outline: deep
+---
+
+# 如何提问
+
+我们鼓励用户在遇到问题时积极提问，这被视为是一种社区的贡献。
+
+但是绝大多数人的提问完全没有任何价值，提问的结果永远都是浪费大家的时间。

download-install.md

@@ -3,9 +3,12 @@
 layout: home
 
 hero:
-  name: "SurveyController"
+  name: SurveyController
   text: ""
-  tagline: '一站式问卷自动化处理程序，适配问卷星、腾讯问卷、Credamo见数平台'
+  tagline: 一站式问卷自动化处理程序，适配问卷星、腾讯问卷、Credamo见数平台
+  image:
+    src: /assets/icon.png
+    alt: SurveyController 图标
   actions:
     - theme: brand
       text: 查看文档

how-to-ask.md

@@ -10,38 +10,31 @@ outline: deep
 
 ## 导入问卷
 
-打开程序后，你可以直接粘贴问卷链接，或者拖拽二维码图片到对话框中，也可以点击左侧图标手动选择问卷二维码图片。
+打开程序后，你可以直接粘贴问卷链接，或者拖拽二维码图片到对话框中，也可以点击`左侧图标`手动选择问卷二维码图片。
 
 :::warning 注意
 只接受标准的二维码！
 
 **不接受**那种微信小程序码，还有那种封面花里胡哨绣了几朵花之后塞个小二维码的抽象艺术！
 :::
 
-![安装](assets/gui_1.png)
-
-随后，点击`自动配置问卷`，会有友好的图形化界面引导你完成每个题目的配置。不要嫌麻烦，几个汉字有什么看不懂的。
-
-一般来说，见数平台的问卷解析需要较长时间，甚至偶尔会失败。这是正常现象，重试几次就行了。如果还是不行，你可能要在自己浏览器里面亲自粘贴一遍问卷链接，看看是不是被要求登录拦截、或者是不是根本就没开放问卷
-
 :::danger 警告
 不接受考试、投票等不正当的问卷类型！
 :::
 
-## 进入配置向导
+![导入问卷](assets/gui_1.png)
 
-图片识别成功后，程序会自动跳到配置向导。
+随后，点击`自动配置问卷`，会有友好的图形化界面引导你完成每个题目的配置。不要嫌麻烦，几个汉字有什么看不懂的。
 
-![安装](assets/gui_2.png)
+一般来说，见数平台的问卷解析需要较长时间，甚至偶尔会失败。这是正常现象，重试几次就行了。如果还是不行，你可能要在自己浏览器里面亲自粘贴一遍问卷链接，看看是不是被要求登录拦截、或者是不是根本就没开放问卷
 
-### 问题检查
+图片识别成功后，程序会自动跳到配置向导。
 
-如果识别没反应，先检查你传的是不是问卷二维码，而不是投票、考试，或者封面花里胡哨绣了几朵花之后塞个小二维码的抽象艺术。
+![配置向导](assets/gui_2.png)
 
-右上角的“配置列表 / 载入配置 / 保存配置”是给你存档和复用配置用的。配置列表里暂时空白很正
-常，说明你还没保存过。
+右上角的“配置列表 / 载入配置 / 保存配置”是给你存档和复用配置用的。
 
-![安装](assets/gui_3.png)
+![配置列表与保存](assets/gui_3.png)
 
 ## 配置向导怎么用
 
@@ -50,11 +43,11 @@ outline: deep
 
 - 单选题、量表题、评价题：滑块表示各选项大概命中的比例，每题下方也有数据比例显示。
 
-![安装](assets/config_1.png)
+![单选题与量表题配置](assets/config_1.png)
 
 - 多选题：每个选项的概率是独立计算的，不需要你把总和硬凑到 100%。（ 例如，明天会下雨的概率是 60%，气温超过三十度的概率是 70%，而 60%+70%≠100% ）
 
-![安装](assets/config_2.png)
+![多选题配置](assets/config_2.png)
 
 - 排序题：不需要手动配比例，程序会自动随机排序；如果问卷只要求排几项，也会尽量识别。
 
@@ -67,11 +60,11 @@ outline: deep
 
   随机姓名、随机手机号：适合这种一眼就知道该填实名信息的题。
 
-  ![安装](assets/config_3.png)
+  ![随机姓名和随机手机号配置](assets/config_3.png)
 
   多项填空题：按“一整组答案”来配置，同一行里的几个空会一起使用，别拆着理解。
 
-  ![安装](assets/config_4.png)
+  ![多项填空配置](assets/config_4.png)
 
   AI 填空不是必选项。你要是只想快点跑通流程凑够份数，能手填就先手填，别上来就想着跟 AI 死磕。具体怎么配置 AI 填空，仔细看文档，后面会说。
 
@@ -95,7 +88,7 @@ outline: deep
 
 - 无头模式：浏览器在后台跑，不弹窗，看起来清净一些，但要排查问题时不如可见模式直观。
 
-![安装](assets/runtime_1.png)
+![运行参数设置](assets/runtime_1.png)
 
 **温馨提示：失败5次会自动停止和触发智能验证会自动暂停**（建议遇到阿里云智能验证先停下，默认建议开着，最好配合随机 IP 一起用。）
 
@@ -112,7 +105,7 @@ outline: deep
 
 - 如果你还开着代理，时间拉得越长，通常也越烧随机 ip 额度，所以别为了“像真人”就瞎拉到离谱。
 
-![安装](assets/time_1.png)
+![时间控制设置](assets/time_1.png)
 
 ## 随机Ip和随机UA（能用默认就别瞎折腾）
 
@@ -125,7 +118,7 @@ outline: deep
 
 - 如果你只是普通跑问卷，或者说无人在意你的问卷是哪来的，关了随机 UA 都行。
 
-![安装](assets/random_1.png)
+![随机IP和随机UA设置](assets/random_1.png)
 
 ## AI填空助手（能用，但别把它当魔法）
 
@@ -139,5 +132,5 @@ outline: deep
 
 - AI 适合开放式填空题，不适合拿来解决所有问题。你问卷里如果只是几道简单填空，手动配置个“无”会更省心。或者，你干脆在后台把这题删了得了（
 
-![安装](assets/AIFill_1.png)
+![AI填空助手设置](assets/AIFill_1.png)