feat: 完成新功能 F5+F6+F8+F9+F10+F11+F12 及 DevOps 流水线

F5: 新增 FAQ 常见问题页面 F6: 新增 Git 命令速查表 F8: 页内目录导航增强 (TOC 配置 + 样式) F9: 搜索快捷键提示（搜索框 placeholder） F10: 新增贡献指南页面 F11: 启用国际化英文支持（localeDropdown + 英文首页） F12: PWA 离线阅读支持（plugin-pwa + manifest.json） DevOps: 更新 wyx_helpcenter.yml 增加 nginx 重启步骤修复: 补充缺失的 ReadingProgress 组件 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-13 22:37:52 +08:00 · 2026-05-13 22:37:52 +08:00 · 2b1fa0a531
parent 42015bf56d
commit 2b1fa0a531
13 changed files with 2740 additions and 24 deletions
--- a/.devops/wyx_helpcenter.yml
+++ b/.devops/wyx_helpcenter.yml
@ -23,7 +23,7 @@ workflow:
    needs:
      - start
  - ref: ssh_cmd_0
-    name: 部署到服务器
+    name: 构建并部署
    task: ssh_cmd@1.1.1
    input:
      ssh_pass: ((wyx_helpcenter.ssh_pass))
@ -33,6 +33,17 @@ workflow:
      ssh_cmd: '"cd /root && rm -rf gitlink_help_center && git clone --depth=1 https://gitlink.org.cn/wyxttn/gitlink_help_center.git && cd gitlink_help_center && docker build --no-cache -t help_center . && docker stop help_center || true && docker rm help_center || true && docker run -d -p 3000:3000 --name help_center help_center"'
    needs:
      - git_clone_0
+  - ref: ssh_cmd_1
+    name: 重启nginx
+    task: ssh_cmd@1.1.1
+    input:
+      ssh_pass: ((wyx_helpcenter.ssh_pass))
+      ssh_ip: '"121.41.212.97"'
+      ssh_port: '"22"'
+      ssh_user: '"root"'
+      ssh_cmd: '"service nginx restart"'
+    needs:
+      - ssh_cmd_0
  - ref: end
    name: 结束
    task: end
--- a/docs/常见问题/常见问题.md
+++ b/docs/常见问题/常见问题.md
@ -0,0 +1,68 @@
+---
+sidebar_label: 常见问题
+sidebar_position: 1
+---
+
+# 常见问题（FAQ）
+
+本页汇总了 GitLink 平台使用中最常见的问题及解决方案。
+
+## 注册与登录
+
+### Q1：如何注册 GitLink 账号？
+
+访问 [GitLink 官网](https://www.gitlink.org.cn)，点击右上角"注册"按钮，支持手机号注册和第三方登录（Gitee、GitHub）。
+
+### Q2：忘记密码怎么办？
+
+在登录页面点击"忘记密码"，通过注册手机号接收验证码，验证后即可重置密码。
+
+## 代码库管理
+
+### Q3：如何将 GitHub 项目导入 GitLink？
+
+进入"项目"模块，点击"新建项目"，选择"导入已有项目"，输入 GitHub 仓库 URL 和 Access Token 即可导入。详见 [导入 GitHub 等第三方 Git 项目](/快速开始/导入GitHub等第三方Git项目)。
+
+### Q4：仓库容量有限制吗？
+
+GitLink 单个仓库建议不超过 1GB，如有更大需求可联系官方邮箱 gitlink@ccf.org.cn。
+
+### Q5：如何配置 SSH 公钥？
+
+在本地生成 SSH 密钥对后，进入 GitLink **设置 → SSH公钥** 页面，将公钥内容粘贴提交即可。命令：
+```bash
+ssh-keygen -t ed25519 -C "your_email@example.com"
+cat ~/.ssh/id_ed25519.pub
+```
+
+## 合并请求
+
+### Q6：合并请求和疑修有什么区别？
+
+**疑修（Issue）** 用于跟踪 Bug、功能需求和任务；**合并请求（Merge Request）** 用于代码审查和合并。可以将疑修与合并请求关联，实现问题追踪与代码变更的对应。
+
+### Q7：如何解决合并冲突？
+
+当合并请求出现冲突时，在本地拉取目标分支，合并源分支后手动解决冲突文件，然后提交并推送即可。详见 [合并模式简介](/合并请求/合并模式简介)。
+
+## DevOps 引擎
+
+### Q8：DevOps 引擎支持哪些语言？
+
+DevOps 引擎基于建木（JianMu）构建，支持 Shell 脚本、Node.js、Python、Java、Docker 等多种构建环境，可灵活编排流水线节点。
+
+### Q9：流水线构建失败怎么排查？
+
+进入 DevOps 引擎 → 执行记录查询，找到失败的执行记录，点击查看每个节点的详细日志，根据错误信息定位问题。
+
+## 其他
+
+### Q10：如何联系 GitLink 官方？
+
+- 官方邮箱：gitlink@ccf.org.cn
+- QQ 群：见网站底部二维码
+- 公众号：关注"GitLink"微信公众号
+
+---
+
+> 没有找到您的问题？请在 [GitLink 帮助中心项目](https://gitlink.org.cn/Gitlink/gitlink_help_center/issues) 提交疑修反馈。
--- a/docs/快速开始/Git命令速查.md
+++ b/docs/快速开始/Git命令速查.md
@ -0,0 +1,63 @@
+---
+sidebar_label: Git 命令速查
+sidebar_position: 6
+---
+
+# Git 命令速查表
+
+本文汇总 Git 日常使用中最常用的命令，帮助您快速上手。
+
+## 初始配置
+
+| 命令 | 说明 |
+|------|------|
+| `git config --global user.name "姓名"` | 设置全局用户名 |
+| `git config --global user.email "邮箱"` | 设置全局邮箱 |
+| `git config --list` | 查看当前配置 |
+
+## 仓库操作
+
+| 命令 | 说明 |
+|------|------|
+| `git init` | 初始化新仓库 |
+| `git clone <url>` | 克隆远程仓库 |
+| `git status` | 查看工作区状态 |
+| `git add <file>` | 添加文件到暂存区 |
+| `git add .` | 添加所有修改到暂存区 |
+| `git commit -m "消息"` | 提交暂存区修改 |
+| `git log` | 查看提交历史 |
+| `git log --oneline` | 简洁查看提交历史 |
+
+## 分支操作
+
+| 命令 | 说明 |
+|------|------|
+| `git branch` | 查看本地分支 |
+| `git branch <name>` | 创建新分支 |
+| `git checkout <name>` | 切换分支 |
+| `git checkout -b <name>` | 创建并切换分支 |
+| `git merge <name>` | 合并指定分支到当前分支 |
+| `git branch -d <name>` | 删除分支 |
+| `git stash` | 暂存当前修改 |
+| `git stash pop` | 恢复暂存修改 |
+
+## 远程操作
+
+| 命令 | 说明 |
+|------|------|
+| `git remote -v` | 查看远程仓库 |
+| `git remote add origin <url>` | 添加远程仓库 |
+| `git push origin <branch>` | 推送到远程 |
+| `git pull origin <branch>` | 拉取远程更新 |
+| `git fetch` | 获取远程更新（不合并） |
+
+## 撤销与回退
+
+| 命令 | 说明 |
+|------|------|
+| `git checkout -- <file>` | 撤销工作区修改 |
+| `git reset HEAD <file>` | 取消暂存 |
+| `git reset --soft HEAD~1` | 回退提交（保留修改） |
+| `git reset --hard HEAD~1` | 回退提交（丢弃修改） |
+
+> **提示**：更多 Git 操作详见 [提交第一行代码](/快速开始/提交第一行代码) 和 [分支管理](/代码库管理/分支管理)。
--- a/docs/快速开始/贡献指南.md
+++ b/docs/快速开始/贡献指南.md
@ -0,0 +1,73 @@
+---
+sidebar_label: 贡献指南
+sidebar_position: 7
+---
+
+# 如何为帮助中心贡献
+
+GitLink 帮助中心是一个开源文档项目，欢迎所有人参与贡献！
+
+## 贡献流程
+
+### 1. 复刻项目
+
+点击项目右上角的 **"复刻"（Fork）** 按钮，将项目复制到您的个人账户下。
+
+### 2. 编辑文档
+
+有两种编辑方式：
+
+**方式一：网页端直接编辑**
+
+1. 进入您复刻的仓库
+2. 找到需要修改的文件（`docs/` 目录下的 `.md` 文件）
+3. 点击文件上方的 **编辑** 按钮（铅笔图标）
+4. 修改内容并提交
+
+**方式二：本地编辑**
+
+```bash
+git clone https://gitlink.org.cn/您的用户名/gitlink_help_center.git
+cd gitlink_help_center
+npm install --legacy-peer-deps
+npm run dev
+# 在浏览器中访问 http://localhost:3000 预览
+```
+
+### 3. 文档格式规范
+
+每个 Markdown 文件应包含以下 frontmatter：
+
+```yaml
+---
+sidebar_label: 页面显示标题
+sidebar_position: 排序位置
+---
+```
+
+### 4. 提交合并请求
+
+修改完成后，向原仓库提交合并请求：
+
+1. 在原仓库页面点击 **合并请求 → 新建合并请求**
+2. 选择您的修改分支作为源分支
+3. 填写修改说明
+4. 等待审核
+
+## 贡献类型
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| 错别字修正 | 修正文档中的错别字 | "帐号" → "账号" |
+| 内容补充 | 补充缺失或不完整的文档 | 补充操作步骤 |
+| 截图更新 | 更新过时的界面截图 | 替换旧版界面图 |
+| 新增章节 | 添加全新的文档章节 | FAQ 页面 |
+| 功能建议 | 提出网站功能改进建议 | 新增搜索功能 |
+
+## 注意事项
+
+- 提交前请运行 `npm run build -- --locale zh-CN` 确保构建通过
+- 提交信息请使用规范格式：`fix:`、`docs:`、`feat:` 等
+- 如有疑问，可在项目中提交疑修（Issue）讨论
+
+> 感谢您的贡献！每一份改进都让 GitLink 帮助中心变得更好。
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@ -16,6 +16,20 @@ module.exports = {
  organizationName: 'luffyZh', // Usually your GitHub org/user name.
  projectName: 'docusaurus-luffyzh-website', // Usually your repo name.
  scripts: [],
+  plugins: [
+    [
+      '@docusaurus/plugin-pwa',
+      {
+        debug: false,
+        offlineModeActivationStrategies: ['appInstalled', 'standalone', 'queryString'],
+        pwaHead: [
+          { tagName: 'link', rel: 'icon', href: '/img/icon.ico' },
+          { tagName: 'link', rel: 'manifest', href: '/manifest.json' },
+          { tagName: 'meta', name: 'theme-color', content: '#466aff' },
+        ],
+      },
+    ],
+  ],
  // stylesheets: ['styles/dark-mode.css'],
  themeConfig: {
    docs:{
@ -23,6 +37,10 @@ module.exports = {
        hideable:true,
      },
   },
+    tableOfContents: {
+      minHeadingLevel: 2,
+      maxHeadingLevel: 4,
+    },
    metadata:[
      {name:"Keywords",content:"Gitlink,forgeplus,GitLink,gitLink,GitLink,gitlink,帮助中心"},
      {name:"hostname",content:"gitlink.org.cn"},
@ -71,10 +89,10 @@ module.exports = {
          position: 'left',
          dropdownActiveClassDisabled: true
        },
-        // {
-        //   type: 'localeDropdown',
-        //   position: 'right',
-        // },
+        {
+          type: 'localeDropdown',
+          position: 'right',
+        },
        // {
          // position: 'right',
          // component:'./src/components/LanguageSwitcher',
@ -192,7 +210,7 @@ module.exports = {
        hashed: true,
        language: ["en", "zh"],
        highlightSearchTermsOnTargetPage: true,
-        blogRouteBasePath: "/", 
+        blogRouteBasePath: "/",
        explicitSearchResultPath: true,
        // For Docs using Chinese, The `language` is recommended to set to:
        // ```
--- a/i18n/en/code.json
+++ b/i18n/en/code.json
@ -0,0 +1,14 @@
+{
+  "theme.ErrorPageContent.title": {
+    "message": "Page not found",
+    "description": "The title of the 404 page"
+  },
+  "theme.NotFound.title": {
+    "message": "Page Not Found",
+    "description": "Title of the 404 page"
+  },
+  "theme.AnnouncementBar.closeButtonAriaLabel": {
+    "message": "Close",
+    "description": "The ARIA label for close button of announcement bar"
+  }
+}
--- a/i18n/en/docusaurus-plugin-content-docs/current/intro.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/intro.md
@ -0,0 +1,25 @@
+---
+sidebar_label: "Introduction"
+sidebar_position: 1
+slug: /
+---
+
+# About GitLink
+
+GitLink is the official open-source innovation service platform designated by CCF (China Computer Federation).
+
+![GitLink](/img/ccf_gitlink.png)
+
+# Platform Features
+
+- **Distributed Collaborative Development**: Online file editing, branch management, contribution statistics, repository forking, and merge requests
+- **One-stop Process Management**: Issues, milestones, notifications, labels, Wiki, and organization management
+- **Efficient CI/CD Pipeline**: Lightweight workflow engine with custom configurations, static analysis, and artifact building
+- **Multi-level Code Analysis**: Code traceability, license risk analysis, vulnerability detection, and hardening recommendations
+- **Multi-dimensional User Profiling**: Development activity statistics, contribution calendar, capability modeling, and role positioning
+
+# Help Documentation
+
+The help documentation will help you fully understand the GitLink platform. Let's contribute to open-source innovation together!
+
+> **Note**: English documentation is currently under development. For complete documentation, please switch to the Chinese version using the language selector in the top-right corner.
--- a/i18n/en/docusaurus-theme-classic/navbar.json
+++ b/i18n/en/docusaurus-theme-classic/navbar.json
@ -0,0 +1,10 @@
+{
+  "title": {
+    "message": "GitLink Help Center",
+    "description": "The title in the navbar"
+  },
+  "item.label.帮助中心": {
+    "message": "Help Center",
+    "description": "Navbar item with label 帮助中心"
+  }
+}
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@ -16,6 +16,7 @@
  "dependencies": {
    "@docusaurus/core": "3.9.2",
    "@docusaurus/plugin-client-redirects": "3.9.2",
+    "@docusaurus/plugin-pwa": "^3.9.2",
    "@docusaurus/preset-classic": "3.9.2",
    "@easyops-cn/docusaurus-search-local": "^0.55.1",
    "@mdx-js/react": "^3.1.1",
--- a/src/components/ReadingProgress.js
+++ b/src/components/ReadingProgress.js
@ -0,0 +1,45 @@
+import React, { useState, useEffect } from 'react';
+import { useLocation } from '@docusaurus/router';
+
+export default function ReadingProgress() {
+  const [progress, setProgress] = useState(0);
+  const location = useLocation();
+
+  useEffect(() => {
+    const isDocPage = location.pathname !== '/';
+    if (!isDocPage) {
+      setProgress(0);
+      return;
+    }
+
+    const updateProgress = () => {
+      const scrollTop = window.scrollY;
+      const docHeight = document.documentElement.scrollHeight - window.innerHeight;
+      if (docHeight > 0) {
+        setProgress(Math.min((scrollTop / docHeight) * 100, 100));
+      }
+    };
+
+    window.addEventListener('scroll', updateProgress);
+    updateProgress();
+    return () => window.removeEventListener('scroll', updateProgress);
+  }, [location.pathname]);
+
+  if (progress === 0 && location.pathname === '/') return null;
+
+  return (
+    <div
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        height: '3px',
+        width: `${progress}%`,
+        background: 'linear-gradient(90deg, #466aff, #00d4ff)',
+        zIndex: 9999,
+        transition: 'width 0.1s ease-out',
+        boxShadow: '0 0 8px rgba(70, 106, 255, 0.5)',
+      }}
+    />
+  );
+}
--- a/src/css/custom.css
+++ b/src/css/custom.css
@ -26,9 +26,6 @@
 .navbar__link{
  color: #fff;
 }
-.table-of-contents__link--active{
-  color: #466aff;
-}
 html[data-theme=light] .menu{
  background-image:linear-gradient(180deg,#f3f5f8 0%,#ffffff 100%);
  box-shadow:8px 6px 18px rgba(171, 202, 255, 0.24) inset;
@ -41,9 +38,6 @@ html[data-theme=light] .menu{
  padding: 0 var(--ifm-pre-padding);
 }

-html[data-theme='dark'] .docusaurus-highlight-code-line {
-  background-color: rgba(0, 0, 0, 0.3);
-}
 .navbar__search span[role='listbox']{
  background-color: #33416b;
 }
@ -179,9 +173,6 @@ html[data-theme='dark'] .cardContainer {
  background: var(--ifm-background-surface-color);
  border-color: var(--ifm-color-emphasis-300);
 }
-html[data-theme='dark'] .cardContainer:hover {
-  border-color: var(--ifm-color-primary);
-}
 html[data-theme='dark'] .docusaurus-highlight-code-line {
  background-color: rgba(255, 255, 255, 0.1);
 }
@ -211,6 +202,7 @@ html[data-theme='dark'] .markdown img {
 }
 html[data-theme='dark'] .cardContainer:hover {
  box-shadow: 0 8px 25px rgba(70, 106, 255, 0.25);
+  border-color: var(--ifm-color-primary);
 }
 .cardTitle {
  color: var(--ifm-color-emphasis-900);
@ -219,4 +211,23 @@ html[data-theme='dark'] .cardContainer:hover {
 .cardContainer p {
  color: var(--ifm-color-emphasis-600);
  font-size: 0.9rem;
+}
+
+/* === 目录导航优化 === */
+.table-of-contents {
+  border-left: 2px solid var(--ifm-color-emphasis-300);
+  padding-left: 1rem;
+}
+.table-of-contents__link {
+  font-size: 0.85rem;
+  line-height: 1.8;
+}
+.table-of-contents__link:hover {
+  color: var(--ifm-color-primary);
+}
+.table-of-contents__link--active {
+  font-weight: 600;
+  border-left: 2px solid var(--ifm-color-primary);
+  margin-left: -1rem;
+  padding-left: calc(1rem - 2px);
 }
--- a/static/manifest.json
+++ b/static/manifest.json
@ -0,0 +1,16 @@
+{
+  "name": "GitLink 帮助中心",
+  "short_name": "GitLink Help",
+  "description": "GitLink（确实开源）帮助中心文档",
+  "start_url": "/",
+  "display": "standalone",
+  "theme_color": "#466aff",
+  "background_color": "#ffffff",
+  "icons": [
+    {
+      "src": "/img/icon.ico",
+      "sizes": "64x64",
+      "type": "image/x-icon"
+    }
+  ]
+}