fix：优化整体内容说明和标准化

Author: spiritLHLS

README.md

@@ -10,13 +10,11 @@
 
 [https://www.spiritlhl.net/en/](https://www.spiritlhl.net/en/)
 
-一键虚拟化项目(One click virtualization) 
+一键虚拟化项目文档站点（OneClickVirt documentation site）
 
-Documentation for one-click virtualization
+提供 Proxmox VE、Incus、LXD、Docker 等虚拟化项目的一键安装与使用说明，同时收录相关工具与扩展项目文档。
 
-一键安装与使用 Proxmox-VE、incus、LXD、Docker 的说明文档，同时包含其他项目指南
-
-Documentation for one-click installation and use of Proxmox-VE, incus, LXD, Docker, and other project guides
+Documentation for one-click installation and usage of Proxmox VE, Incus, LXD, Docker, and related tools in the OneClickVirt ecosystem.
 
 ```
 webvirtcloud
@@ -30,9 +28,9 @@ bashvm
 webvirtmgr
 ```
 
-支持中英双语
+支持中英双语。
 
-Supports both Chinese and English
+Chinese and English are both supported.
 
 ## OneClickVirt
 

docs/.vitepress/config.mts

@@ -1,36 +1,69 @@
-import { createWriteStream } from 'node:fs';
-import { resolve } from 'node:path';
-import { SitemapStream } from 'sitemap';
 import { defineConfig } from 'vitepress';
 
-const links: { url: string; lastmod: number }[] = [];
+const SITE_URL = 'https://www.spiritlhl.net';
+
+function toSitePath(relativePath: string) {
+  return `/${relativePath}`
+    .replace(/\/index\.md$/, '/')
+    .replace(/\.md$/, '.html');
+}
+
+function toCanonicalUrl(relativePath: string) {
+  return new URL(toSitePath(relativePath), `${SITE_URL}/`).toString();
+}
+
+function getDefaultTitle(relativePath: string) {
+  return relativePath.startsWith('en/')
+    ? 'OneClickVirt'
+    : '一键虚拟化项目';
+}
+
+function getLocaleCode(relativePath: string) {
+  return relativePath.startsWith('en/') ? 'en_US' : 'zh_CN';
+}
 
 export default defineConfig({
   lastUpdated: true,
   lang: 'zh-CN',
+  sitemap: {
+    hostname: SITE_URL,
+    transformItems(items) {
+      return items.filter((item) => !/\/404(?:\.html)?$/.test(item.url));
+    },
+  },
   markdown: {
     lineNumbers: true,
     image: {
       lazyLoading: true,
     },
   },
-  transformHtml: (_, id, { pageData }) => {
-    if (!/[\\/]404\.html$/.test(id)) {
-      links.push({
-        url: pageData.relativePath.replace(/\/index\.md$/, '/').replace(/\.md$/, '.html'),
-        lastmod: pageData.lastUpdated ?? Date.now(),
-      });
+  transformPageData(pageData) {
+    if (pageData.relativePath === '404.md') {
+      return;
+    }
+
+    const canonicalUrl = toCanonicalUrl(pageData.relativePath);
+    const title = pageData.title || getDefaultTitle(pageData.relativePath);
+    const description = pageData.description || '';
+
+    pageData.frontmatter.head ??= [];
+    pageData.frontmatter.head.push(
+      ['link', { rel: 'canonical', href: canonicalUrl }],
+      ['meta', { property: 'og:type', content: 'article' }],
+      ['meta', { property: 'og:site_name', content: getDefaultTitle(pageData.relativePath) }],
+      ['meta', { property: 'og:locale', content: getLocaleCode(pageData.relativePath) }],
+      ['meta', { property: 'og:title', content: title }],
+      ['meta', { property: 'og:url', content: canonicalUrl }],
+      ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
+      ['meta', { name: 'twitter:title', content: title }],
+    );
+
+    if (description) {
+      pageData.frontmatter.head.push(
+        ['meta', { property: 'og:description', content: description }],
+        ['meta', { name: 'twitter:description', content: description }],
+      );
     }
-  },
-  buildEnd: async ({ outDir }) => {
-    const sitemap = new SitemapStream({
-      hostname: 'https://www.spiritlhl.net/'
-    });
-    const writeStream = createWriteStream(resolve(outDir, 'sitemap.xml'));
-    sitemap.pipe(writeStream);
-    links.forEach((link) => sitemap.write(link));
-    sitemap.end();
-    await new Promise((r) => writeStream.on('finish', r));
   },
   head: [
     ['link', { rel: 'icon', href: 'https://cdn.spiritlhl.net/https://raw.githubusercontent.com/spiritlhls/pages/main/logo.png' }],
@@ -125,7 +158,7 @@ export default defineConfig({
     en: {
       lang: 'en-US',
       label: 'English',
-      title: 'One Click Virtualization',
+      title: 'OneClickVirt',
       description: 'Open source, easy to use server virtualization project',
       link: '/en/',
       themeConfig: {
@@ -142,7 +175,7 @@ export default defineConfig({
         externalLinkIcon: true,
         nav: [
           {
-            text: 'Virtualization Platforms',
+            text: 'Platforms',
             activeMatch: '^/en/guide/',
             items: [
               { text: 'OneClickVirt', link: '/en/guide/oneclickvirt/oneclickvirt_precheck.html' },
@@ -158,7 +191,7 @@ export default defineConfig({
             ]
           },
           {
-            text: 'Other Virtualization Projects',
+            text: 'Other Projects',
             activeMatch: '^/en/incomplete/',
             items: [
               { text: 'webvirtcloud', link: '/en/incomplete/webvirtcloud.html' },
@@ -173,7 +206,7 @@ export default defineConfig({
             ]
           },
           {
-            text: 'Utility Projects',
+            text: 'Utilities',
             activeMatch: '^/en/case/',
             items: [
               { text: '1. ECS benchmark script for VPS', link: '/en/case/case1.html' },
@@ -207,14 +240,17 @@ export default defineConfig({
   },
   themeConfig: {
     outline: 'deep',
+    search: {
+      provider: 'algolia',
+      options: {
+        appId: 'K1R85MDU0C',
+        apiKey: '9375787ec1c00e2b813683fbbde25ae2',
+        indexName: 'virt-spiritlhl'
+      }
+    },
     socialLinks: [
       { icon: 'github', link: 'https://github.com/oneclickvirt' }
     ],
-    algolia: {
-      appId: 'K1R85MDU0C',
-      apiKey: '9375787ec1c00e2b813683fbbde25ae2',
-      indexName: 'virt-spiritlhl'
-    },
     footer: {
       message: 'Under <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">(CC BY-NC-SA 4.0) License.</a><br>Also thanks to <a href="https://www.cloudflare.com/">Cloudflare</a> and <a href="https://blog.tanglu.me/">tanglu.me</a> for the CDN.',
       copyright: 'Copyright © 2022-present oneclickvirt'
@@ -282,7 +318,7 @@ function getGuideSidebarZhCN() {
         { text: 'Docker主体安装', link: '/guide/docker/docker_install.html' },
         { text: 'Linux容器(LXC)', link: '/guide/docker/docker_build.html' },
         { text: 'Windows虚拟机(KVM/QEMU)', link: '/guide/docker/docker_windows.html' },
-        { text: 'Macos虚拟机(KVM)', link: '/guide/docker/docker_macos.html' },
+              { text: 'macOS虚拟机(KVM)', link: '/guide/docker/docker_macos.html' },
         { text: 'Android虚拟机(KVM/QEMU)', link: '/guide/docker/docker_android.html' },
         { text: '自定义', link: '/guide/docker/docker_custom.html' },
         { text: '致谢', link: '/guide/docker/docker_thanks.html' },
@@ -479,7 +515,7 @@ function getGuideSidebarEnUS() {
         { text: 'Docker main installation', link: '/en/guide/docker/docker_install.html' },
         { text: 'Linux Container(LXC)', link: '/en/guide/docker/docker_build.html' },
         { text: 'Windows Virtual Machine(KVM/QEMU)', link: '/en/guide/docker/docker_windows.html' },
-        { text: 'Macos Virtual Machine(KVM)', link: '/en/guide/docker/docker_macos.html' },
+        { text: 'macOS Virtual Machine(KVM)', link: '/en/guide/docker/docker_macos.html' },
         { text: 'Android Virtual Machine(KVM/QEMU)', link: '/en/guide/docker/docker_android.html' },
         { text: 'Custom', link: '/en/guide/docker/docker_custom.html' },
         { text: 'Acknowledgements', link: '/en/guide/docker/docker_thanks.html' },
@@ -551,9 +587,9 @@ function getGuideSidebarEnUS() {
       items: [
         { text: 'via iptables', link: '/en/guide/block/block_iptables.html' },
         { text: 'In PVE', link: '/en/guide/block/block_pve.html' },
-        { text: 'In INCUS', link: '/en/guide/block/block_incus.html' },
+        { text: 'In Incus', link: '/en/guide/block/block_incus.html' },
         { text: 'In LXD', link: '/en/guide/block/block_lxd.html' },
-        { text: 'In DOCKER', link: '/en/guide/block/block_docker.html' },
+        { text: 'In Docker', link: '/en/guide/block/block_docker.html' },
       ]
     },
     {

docs/.vitepress/theme/index.ts

@@ -1,6 +1,7 @@
 import DefaultTheme from 'vitepress/theme'
 import { h } from 'vue'
 import ComponentInHeader from '../../components/ComponentInHeader.vue'
+import './style.css'
 
 export default {
   extends: DefaultTheme,

docs/.vitepress/theme/style.css

@@ -0,0 +1,37 @@
+@media (min-width: 768px) {
+  html[lang^='en'] .VPNavBar .content,
+  html[lang^='en'] .VPNavBar .menu,
+  html[lang^='en'] .VPNavBar .menu > * {
+    min-width: 0;
+  }
+
+  html[lang^='en'] .VPNavBar .content-body,
+  html[lang^='en'] .VPNavBar .menu {
+    overflow: hidden;
+  }
+
+  html[lang^='en'] .VPNavBar .menu {
+    flex: 1 1 auto;
+    justify-content: flex-end;
+  }
+
+  html[lang^='en'] .VPNavBar .translations,
+  html[lang^='en'] .VPNavBar .appearance,
+  html[lang^='en'] .VPNavBar .social-links,
+  html[lang^='en'] .VPNavBar .extra {
+    flex-shrink: 0;
+  }
+
+  html[lang^='en'] .VPNavBar .VPNavBarMenuLink,
+  html[lang^='en'] .VPNavBar .VPNavBarMenuGroup .button {
+    min-width: 0;
+    max-width: clamp(96px, 11vw, 168px);
+    overflow: hidden;
+  }
+
+  html[lang^='en'] .VPNavBar .VPNavBarMenuLink > span,
+  html[lang^='en'] .VPNavBar .VPNavBarMenuGroup .button .text {
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+}

docs/case/case1.md

@@ -10,9 +10,9 @@ outline: deep
 
 [![Hits](https://hits.spiritlhl.net/goecs.svg?action=hit&title=Hits&title_bg=%23555555&count_bg=%230eecf8&edge_flat=false)](https://hits.spiritlhl.net) [![Downloads](https://ghdownload.spiritlhl.net/oneclickvirt/ecs?color=36c600)](https://github.com/oneclickvirt/ecs/releases)
 
-融合怪测评项目 - GO版本
+融合怪测评项目 - Go 版本
 
-(仅环境安装[非必须]使用shell外无额外shell文件依赖，环境安装只是为了测的更准，极端情况下无环境依赖安装也可全测项目)
+除可选的环境安装步骤仍会调用 shell 外，项目本体不依赖额外 shell 文件。环境安装只是为了提升测试准确度，极端情况下即使不安装这些依赖，也依然可以完成大部分测试。
 
 如有问题请 [issues](https://github.com/oneclickvirt/ecs/issues) 反馈。
 
@@ -43,7 +43,7 @@ Shell 版本：[https://github.com/spiritLHLS/ecs](https://github.com/spiritLHLS
 
 | 系统           | 说明                       |
 |----------------|---------------------------|
-| OpenBSD/NetBSD | 部分Goalng的官方库未支持本系统(尤其是net相关项目)  |
+| OpenBSD/NetBSD | 部分Golang的官方库暂未支持本系统(尤其是 net 相关项目) |
 
 ---
 
@@ -58,7 +58,7 @@ Shell 版本：[https://github.com/spiritLHLS/ecs](https://github.com/spiritLHLS
 - 邮件端口测试：[portchecker](https://github.com/oneclickvirt/portchecker)
 - 上游及回程路由线路检测：借鉴 [zhanghanyun/backtrace](https://github.com/zhanghanyun/backtrace)，二次开发至 [oneclickvirt/backtrace](https://github.com/oneclickvirt/backtrace)
 - 三网路由测试：基于 [NTrace-core](https://github.com/nxtrace/NTrace-core)，二次开发至 [nt3](https://github.com/oneclickvirt/nt3)
-- 网速测试：基于 [speedtest.net](https://github.com/spiritLHLS/speedtest.net-CN-ID) 和 [speedtest.cn](https://github.com/spiritLHLS/speedtest.cn-CN-ID) 数据，开发至 [oneclickvirt/speedtest](https://github.com/oneclickvirt/speedtest)
+- 网速测试：基于 [speedtest.net](https://github.com/spiritLHLS/speedtest.net-CN-ID) 和 [speedtest.cn](https://github.com/spiritLHLS/speedtest.cn-CN-ID) 数据，开发至 [oneclickvirt/speedtest](https://github.com/oneclickvirt/speedtest)，同时融合私有国内测速节点
 - 三网 Ping 值测试：借鉴 [ecsspeed](https://github.com/spiritLHLS/ecsspeed)，二次开发至 [pingtest](https://github.com/oneclickvirt/pingtest)
 - 支持root或admin环境下测试，支持非root或非admin环境下测试，支持离线环境下进行测试，**暂未**支持无DNS的在线环境下进行测试
 
@@ -89,7 +89,7 @@ Shell 版本：[https://github.com/spiritLHLS/ecs](https://github.com/spiritLHLS
 - **国内用户使用 CNB 加速：**
 
   ```bash
-  export noninteractive=true && curl -L https://cnb.cool/oneclickvirt/ecs/-/git/raw/main/goecs.sh -o goecs.sh && chmod +x goecs.sh && ./goecs.sh install && goecs
+      export noninteractive=true && export CN=true && curl -L https://cnb.cool/oneclickvirt/ecs/-/git/raw/main/goecs.sh -o goecs.sh && chmod +x goecs.sh && ./goecs.sh install && goecs
   ```
 
 - **短链接：**
@@ -130,7 +130,7 @@ Shell 版本：[https://github.com/spiritLHLS/ecs](https://github.com/spiritLHLS
    **国内用户使用 CNB 加速：**
 
    ```bash
-   curl -L https://cnb.cool/oneclickvirt/ecs/-/git/raw/main/goecs.sh -o goecs.sh && chmod +x goecs.sh
+      export CN=true && curl -L https://cnb.cool/oneclickvirt/ecs/-/git/raw/main/goecs.sh -o goecs.sh && chmod +x goecs.sh
    ```
 
 2. **更新包管理器（可选择）并安装环境**
@@ -268,8 +268,8 @@ Usage: goecs [options]
 1. 下载带 exe 文件的压缩包：[Releases](https://github.com/oneclickvirt/ecs/releases)
 2. 解压后，右键以管理员模式运行。
 
-PS：如果是虚拟机环境，不以管理员模式运行也行，因为虚拟机无原生的测试工具，将自动启用替代方法测试。
-PPS: 暂时不要下载带GUI标签的exe文件，未完整适配，CI版本的压缩包是没问题的。
+PS：如果是在虚拟机环境中运行，不以管理员模式启动通常也可以，因为虚拟机缺少部分原生测试工具时会自动启用替代方案。
+PPS：暂时不要下载带 GUI 标签的 exe 文件，相关适配还不完整，优先使用常规 CI 产物压缩包。
 
 ---
 
@@ -312,7 +312,7 @@ docker run --rm --privileged --network host crpi-8tmognxgyb86bm61.cn-guangzhou.p
 docker run --rm crpi-8tmognxgyb86bm61.cn-guangzhou.personal.cr.aliyuncs.com/oneclickvirt/ecs:latest -menu=false -l zh
 ```
 
-实际上还有CNB镜像地址 https://cnb.cool/oneclickvirt/ecs/-/packages/docker/ecs 但很可惜组织空间不足无法推送了，更推荐使用阿里云镜像加速
+实际上还有 CNB 镜像地址 https://cnb.cool/oneclickvirt/ecs/-/packages/docker/ecs ，但由于组织空间不足，目前无法继续推送，因此更推荐直接使用阿里云镜像加速。
 
 </details>
 
@@ -331,7 +331,7 @@ cd ecs
 
 2. 安装 Go 环境（如已安装可跳过）
 
-选择 go 1.25.3 的版本进行安装
+选择 Go 1.25.4 版本进行安装
 
 ```bash
 curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/spiritLHLS/one-click-installation-script/main/install_scripts/go.sh -o go.sh && chmod +x go.sh && bash go.sh 
@@ -394,11 +394,11 @@ GOOS=darwin GOARCH=amd64 go build -o goecs_darwin
 
 #### Q: 测试进行到一半如何手动终止？
 
-#### A: 按ctrl键和c键终止程序，终止后依然会在当前目录下生成goecs.txt文件和分享链接，里面是已经测试到的信息。
+#### A: 按 `Ctrl+C` 终止程序。终止后依然会在当前目录下生成 `goecs.txt` 文件和分享链接，里面会保留已经完成的测试结果。
 
 #### Q: 非Root环境如何进行测试？
 
-#### A: 手动执行安装命令，实在装不上也没问题，直接在release中下载对应架构的压缩包解压后执行即可，只要你能执行的了文件。或者你能使用docker的话用docker执行。
+#### A: 可以先尝试手动执行安装命令。若确实无法安装依赖，也没关系，直接去 release 页面下载对应架构的压缩包，解压后执行即可，只要当前环境允许运行该文件。若可用 Docker，也可以直接通过 Docker 运行。
 
 ## 致谢