Polish docs site homepage and localization

Author: 54895y

README.md

@@ -1,19 +1,22 @@
 # Matrix Docs
 
-`D:\Matrix\Docs` 是 Matrix 系列插件的统一 Docusaurus 文档站。
+`54895y.github.io` 是 Matrix 系列插件的统一 Docusaurus 文档站。
 
 当前已收录：
 
 - MatrixAuth
+- MatrixCook
 - MatrixShop
 
 ## 当前结构
 
 - `docs/plugins.mdx`：插件列表
 - `docs/intro.md`：站点总览
 - `docs/matrixauth/`：MatrixAuth 文档
+- `docs/matrixcook/`：MatrixCook 文档
 - `docs/matrixshop/`：MatrixShop 文档
 - `src/pages/index.tsx`：首页
+- `src/pages/ai-search.js`：AI 搜索页
 - `docusaurus.config.ts`：站点配置
 - `sidebars.ts`：侧边导航
 
@@ -29,17 +32,31 @@
 - `baseUrl = /`
 - `deploymentBranch = main`
 
+## 环境要求
+
+- `Node.js >= 20`
+- `npm >= 10`
+
 ## 本地开发
 
-```powershell
-cd D:\Matrix\Docs
+```bash
+cd /www/codex-work/54895y.github.io
 npm install
 npm start
 ```
 
 ## 构建
 
-```powershell
-cd D:\Matrix\Docs
+```bash
+cd /www/codex-work/54895y.github.io
+npm run build
+```
+
+## 常用命令
+
+```bash
+npm run start
 npm run build
+npm run serve
+npm run typecheck
 ```

docusaurus.config.ts

@@ -34,6 +34,8 @@ const config: Config = {
         docs: {
           sidebarPath: './sidebars.ts',
           editUrl: 'https://github.com/54895y/54895y.github.io/tree/main/',
+          showLastUpdateAuthor: true,
+          showLastUpdateTime: true,
           exclude: ['**/tutorial-basics/**', '**/tutorial-extras/**'],
         },
         blog: false,
@@ -64,11 +66,30 @@ const config: Config = {
   ],
   themeConfig: {
     image: 'img/logo.svg',
+    metadata: [
+      {
+        name: 'description',
+        content: 'MatrixAuth、MatrixCook、MatrixShop 官方文档，包含插件索引、本地搜索与 AI 搜索入口。',
+      },
+      {
+        name: 'keywords',
+        content: 'MatrixAuth, MatrixCook, MatrixShop, Minecraft, Paper, Bukkit, 插件文档',
+      },
+      {
+        property: 'og:description',
+        content: 'Matrix 系列插件官方文档站点，覆盖概览、安装、配置、命令与常见问题。',
+      },
+    ],
     colorMode: {
       defaultMode: 'light',
       disableSwitch: false,
       respectPrefersColorScheme: true,
     },
+    docs: {
+      sidebar: {
+        hideable: true,
+      },
+    },
     navbar: {
       title: 'Matrix Wiki',
       logo: {
@@ -80,9 +101,8 @@ const config: Config = {
           type: 'docSidebar',
           sidebarId: 'docsSidebar',
           position: 'left',
-          label: 'Docs',
+          label: '文档目录',
         },
-        {to: '/docs/plugins', label: 'Plugins', position: 'left'},
         {to: '/docs/matrixauth/overview', label: 'MatrixAuth', position: 'left'},
         {to: '/docs/matrixcook/overview', label: 'MatrixCook', position: 'left'},
         {to: '/docs/matrixshop', label: 'MatrixShop', position: 'left'},
@@ -99,16 +119,24 @@ const config: Config = {
       style: 'light',
       links: [
         {
-          title: 'Documentation',
+          title: '文档',
           items: [
+            {
+              label: '站点总览',
+              to: '/docs/intro',
+            },
             {
               label: '插件列表',
               to: '/docs/plugins',
             },
+            {
+              label: 'AI 搜索',
+              to: '/ai-search',
+            },
           ],
         },
         {
-          title: 'Projects',
+          title: '插件',
           items: [
             {
               label: 'MatrixAuth',
@@ -125,7 +153,7 @@ const config: Config = {
           ],
         },
         {
-          title: 'Repository',
+          title: '仓库',
           items: [
             {
               label: '54895y.github.io',

i18n/zh-Hans/code.json

@@ -0,0 +1,14 @@
+{
+  "theme.IconExternalLink.ariaLabel": {
+    "message": "（在新标签页中打开）"
+  },
+  "theme.colorToggle.ariaLabel.mode.system": {
+    "message": "跟随系统"
+  },
+  "theme.navbar.mobileDropdown.collapseButton.collapseAriaLabel": {
+    "message": "收起下拉菜单"
+  },
+  "theme.navbar.mobileDropdown.collapseButton.expandAriaLabel": {
+    "message": "展开下拉菜单"
+  }
+}

src/pages/ai-search.js

@@ -35,9 +35,9 @@ function getResultTitle(item) {
     type === SearchDocumentType.Description ||
     type === SearchDocumentType.Keywords
   ) {
-    return normalizeText(document.s || page?.t || document.t || 'Untitled');
+    return normalizeText(document.s || page?.t || document.t || '未命名文档');
   }
-  return normalizeText(document.t || page?.t || 'Untitled');
+  return normalizeText(document.t || page?.t || '未命名文档');
 }
 
 function getResultPath(item) {
@@ -71,9 +71,9 @@ function buildDeepSeekMessages(query, results) {
             const url = getResultUrl(result);
             return [
               `[${index + 1}] ${title}`,
-              path ? `Path: ${path}` : null,
-              `URL: ${url}`,
-              `Snippet: ${snippet}`,
+              path ? `路径：${path}` : null,
+              `链接：${url}`,
+              `摘要：${snippet}`,
             ]
               .filter(Boolean)
               .join('\n');
@@ -305,23 +305,23 @@ export default function AiSearchPage() {
       <main className={styles.page}>
         <div className={styles.shell}>
           <section className={styles.heroCard}>
-            <p className={styles.kicker}>Manual AI Search</p>
+            <p className={styles.kicker}>手动 AI 搜索</p>
             <h1 className={styles.heroTitle}>AI 搜索</h1>
             <p className={styles.heroDescription}>
               先使用本地索引检索当前 Wiki；只有在你主动点击按钮后，才会调用 DeepSeek 继续回答。
             </p>
             <div className={styles.heroMeta}>
-              <span>Provider: DeepSeek</span>
-              <span>Model: {model}</span>
-              <span>Mode: 手动触发</span>
+              <span>提供方：DeepSeek</span>
+              <span>模型：{model}</span>
+              <span>触发方式：手动</span>
             </div>
           </section>
 
           <section className={styles.controlGrid}>
             <article className={styles.panel}>
               <div className={styles.panelHeader}>
                 <div>
-                  <p className={styles.sectionKicker}>Step 1</p>
+                  <p className={styles.sectionKicker}>第一步</p>
                   <h2>本地搜索</h2>
                 </div>
                 <Link className={styles.inlineLink} to="/search">
@@ -357,13 +357,13 @@ export default function AiSearchPage() {
             <article className={styles.panel}>
               <div className={styles.panelHeader}>
                 <div>
-                  <p className={styles.sectionKicker}>Step 2</p>
-                  <h2>DeepSeek Key</h2>
+                  <p className={styles.sectionKicker}>第二步</p>
+                  <h2>DeepSeek 密钥</h2>
                 </div>
               </div>
 
               <label className={styles.field}>
-                <span>API Key</span>
+                <span>API 密钥</span>
                 <input
                   className={styles.textInput}
                   type="password"
@@ -372,7 +372,7 @@ export default function AiSearchPage() {
                     setApiKey(event.target.value);
                     setKeyMessage('');
                   }}
-                  placeholder="输入 DeepSeek API Key"
+                  placeholder="输入 DeepSeek API 密钥"
                   autoComplete="off"
                 />
               </label>
@@ -382,12 +382,12 @@ export default function AiSearchPage() {
                   保存到当前浏览器
                 </button>
                 <button className={styles.ghostButton} type="button" onClick={handleClearKey}>
-                  清除本地 Key
+                  清除本地密钥
                 </button>
               </div>
 
               <p className={styles.hint}>
-                本站部署在 GitHub Pages 上，不能安全地把服务端密钥写进公开仓库。这里的 Key 只会保存在你当前浏览器的本地存储中。
+                本站部署在 GitHub Pages 上，不能安全地把服务端密钥写进公开仓库。这里的密钥只会保存在你当前浏览器的本地存储中。
               </p>
 
               {keyMessage ? <p className={styles.notice}>{keyMessage}</p> : null}
@@ -398,7 +398,7 @@ export default function AiSearchPage() {
             <article className={styles.panel}>
               <div className={styles.panelHeader}>
                 <div>
-                  <p className={styles.sectionKicker}>Local Results</p>
+                  <p className={styles.sectionKicker}>本地结果</p>
                   <h2>本地命中结果</h2>
                 </div>
                 {localResults.length > 0 ? <span className={styles.badge}>{localResults.length} 条</span> : null}
@@ -431,7 +431,7 @@ export default function AiSearchPage() {
             <article className={styles.panel}>
               <div className={styles.panelHeader}>
                 <div>
-                  <p className={styles.sectionKicker}>AI Answer</p>
+                  <p className={styles.sectionKicker}>AI 回答</p>
                   <h2>DeepSeek 回答</h2>
                 </div>
                 <span className={styles.badge}>