1.3.9

【调整】
- 移除文件列表上浮动画以提升性能

【修复】
- 相对链接返回顶部时的闪烁
- 请求防抖在取消时可能挂起 Promise

Author: UE-DND

.env.backup

@@ -0,0 +1,19 @@
+SITE_TITLE=Repo-Viewer
+SITE_DESCRIPTION=基于MD3设计语言的GitHub仓库浏览应用
+SITE_KEYWORDS= GitHub, 仓库, 浏览器, 代码, 查看器
+GITHUB_REPO_OWNER=UE-DND
+GITHUB_REPO_NAME=Repo-Viewer
+GITHUB_REPO_BRANCH=master
+
+USE_TOKEN_MODE=true
+GITHUB_PAT1=
+GITHUB_PAT2=
+DOWNLOAD_PROXY_URL=https://gh-proxy.com
+DOWNLOAD_PROXY_URL_BACKUP1=https://ghproxy.com
+DOWNLOAD_PROXY_URL_BACKUP2=https://ghproxy.com
+
+ENABLED_SEARCH_INDEX=true
+SEARCH_INDEX_BRANCHES=master,dev
+SEARCH_INDEX_GENERATION_MODE=action
+
+DEVELOPER_MODE=true

.env.example

@@ -15,6 +15,22 @@ GITHUB_REPO_OWNER = UE-DND
 GITHUB_REPO_NAME = Repo-Viewer
 GITHUB_REPO_BRANCH = master
 
+###########################################################
+# 访问与代理设置
+###########################################################
+
+# API访问模式 - 控制API访问方式（本地开发时适用）
+USE_TOKEN_MODE = false                                            # 是否启用令牌优先，本地开发时有效 ｜ 默认关闭
+
+# GitHub访问令牌（至少需要一个）
+GITHUB_PAT1 =
+GITHUB_PAT2 =
+
+# 代理设置 - 用于文件下载和浏览（可选）
+DOWNLOAD_PROXY_URL = https://gh-proxy.com                         # 主代理URL
+DOWNLOAD_PROXY_URL_BACKUP1 = https://ghproxy.com                  # 备选代理1
+DOWNLOAD_PROXY_URL_BACKUP2 = https://raw.staticdn.net             # 备选代理2
+
 ###########################################################
 # 内容显示控制（可选）
 ###########################################################
@@ -35,29 +51,22 @@ FOOTER_LEFT_TEXT = [text](link)                                   # 页脚左侧
 # 搜索索引功能（可选）
 ###########################################################
 
-# 搜索索引开关 - 需要配合 Repo-Viewer-Search 创建的 RV-Index 分支使用
+# 搜索索引开关
 ENABLED_SEARCH_INDEX = true                                       # 是否启用索引搜索模式 ｜ 默认关闭
-SEARCH_INDEX_BRANCH = RV-Index                                    # 存放 manifest 与索引文件的分支 ｜ 默认 RV-Index
-SEARCH_DEFAULT_BRANCH = master                                    # 索引缺省时回退的仓库分支 ｜ 默认与 GITHUB_REPO_BRANCH 一致
-SEARCH_MANIFEST_PATH = manifest.json                              # manifest 文件路径（位于索引分支根目录）｜ 默认 manifest.json
-SEARCH_REFRESH_INTERVAL = 300000                                  # manifest 轮询刷新间隔（毫秒）｜ 默认 300000 (5 分钟)
 
-###########################################################
-# 访问与代理设置
-###########################################################
-
-# API访问模式 - 控制API访问方式（本地开发时适用）
-USE_TOKEN_MODE = false                                            # 是否启用令牌优先，本地开发时有效 ｜ 默认关闭
+# 索引生成模式：build|action|off
+# - build: 仅生产构建生成（默认）
+# - action: 仅 GitHub Actions 生成
+# - off: 禁用索引生成
+SEARCH_INDEX_GENERATION_MODE = build
 
-# GitHub访问令牌（至少需要一个）
-GITHUB_PAT1 =
-GITHUB_PAT2 =
+# 需要生成索引的分支列表（逗号/空格分隔），首个分支作为默认搜索分支｜留空则使用 GITHUB_REPO_BRANCH
+# 注意：Actions 模式下，需将此变量置于仓库 Environments 中，并将环境名称设为 RV-Index，否则无法识别变量
+SEARCH_INDEX_BRANCHES = master,dev
 
-# 代理设置 - 用于文件下载和浏览（可选）
-DOWNLOAD_PROXY_URL = https://gh-proxy.com                         # 主代理URL
-DOWNLOAD_PROXY_URL_BACKUP1 = https://ghproxy.com                  # 备选代理1
-DOWNLOAD_PROXY_URL_BACKUP2 = https://raw.staticdn.net             # 备选代理2
+SEARCH_INDEX_EXTENSIONS =                                         # 覆盖默认扩展名白名单（逗号/空格分隔，不含点号）
 
+# 索引产物固定发布到 /search-index（manifest/docfind.js/wasm）
 
 ###########################################################
 # 开发者选项（可选）
@@ -74,7 +83,7 @@ DEVELOPER_MODE = false                                            # 是否启用
 # 控制台日志输出
 CONSOLE_LOGGING = true                                            # 是否启用控制台日志记录 ｜ 默认开启
 
-# 组合日志管线（CompositeLogger）配置
+# 日志配置
 # - 若未设置，系统会基于 DEVELOPER_MODE / CONSOLE_LOGGING 推导安全默认值
 # - 下列开关全部可选，按需覆盖
 LOGGER_ENABLE_CONSOLE =                                           # 是否强制启用前端控制台日志 ｜ 推荐 dev=true ｜ prod=false

.github/workflows/generate-index.yml

@@ -4,20 +4,66 @@ on:
   push:
     branches:
       - master
+      - dev
+    paths-ignore:
+      - "public/search-index/**"
   workflow_dispatch: {}
 
 jobs:
   generate-index:
     runs-on: ubuntu-latest
+    environment: RV-Index
     permissions:
       contents: write
     steps:
       - name: Checkout repository
         uses: actions/checkout@v5
         with:
           fetch-depth: 0
-          persist-credentials: false
-      - name: Generate Repo Viewer search index
-        uses: H-Sofie/Repo-Viewer-Search@main
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          branches: master
+          node-version: 24
+          cache: "npm"
+          cache-dependency-path: "package-lock.json"
+      - name: Install dependencies
+        run: npm ci
+      - name: Generate docfind index
+        env:
+          ENABLED_SEARCH_INDEX: "true"
+          SEARCH_INDEX_GENERATION_MODE: "action"
+          SEARCH_INDEX_BRANCHES: ${{ vars.SEARCH_INDEX_BRANCHES }}
+          GITHUB_REPO_OWNER: ${{ vars.GITHUB_REPO_OWNER || github.repository_owner }}
+          GITHUB_REPO_NAME: ${{ vars.GITHUB_REPO_NAME || github.event.repository.name }}
+          GITHUB_REPO_BRANCH: ${{ vars.GITHUB_REPO_BRANCH || github.ref_name }}
+          GITHUB_PAT1: ${{ secrets.GITHUB_PAT1 }}
+          GITHUB_PAT2: ${{ secrets.GITHUB_PAT2 }}
+        run: npm run generate:index
+      - name: Commit search index
+        run: |
+          set -euo pipefail
+          INDEX_DIR="public/search-index"
+          if [ ! -d "$INDEX_DIR" ]; then
+            echo "Index directory not found: $INDEX_DIR"
+            exit 1
+          fi
+
+          WORKTREE_DIR="${RUNNER_TEMP}/rv-index"
+          git worktree add --detach "$WORKTREE_DIR"
+
+          cd "$WORKTREE_DIR"
+          git checkout --orphan "RV-Index"
+          git rm -r --quiet --force . || true
+
+          mkdir -p "public/search-index"
+          cp -R "${GITHUB_WORKSPACE}/${INDEX_DIR}/." "public/search-index/"
+
+          git add -A
+          if git diff --cached --quiet; then
+            echo "No index changes."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git commit -m "chore(search-index): update docfind index"
+          git push --force origin HEAD:RV-Index

.gitignore

@@ -17,5 +17,7 @@ yarn-error.log*
 coverage
 .temp
 .tmp
+.docfind
 report
 src/generated/
+public/search-index/

.nvmrc

@@ -2,23 +2,44 @@
 
 > 感谢您对 Repo Viewer 项目的贡献兴趣！我们很高兴与您一起工作，并感谢您帮助使这个项目变得更好！
 
-### 我们的协作方式
+## 我们的协作方式
 
-  由于项目作者的水平有限，其未曾掌握任何 Web 开发技术栈，因此本项目的代码均使用 AI output。作者也在通过这个项目进一步学习。
+  由于项目作者的水平有限，本项目的**大部分代码**由 AI Agents 完成（在开发者监督和审查下）。作者也在通过这个项目进一步学习。
 
-  是的，你没有听错，本项目完全由人工智能驱动！错误和不完善之处在所难免。正因如此，我们非常欢迎您的贡献，以帮助修复错误、改进功能和提高代码质量！
+  是的，你没有听错，本项目几乎由人工智能驱动！错误和不完善之处在所难免。正因如此，我们非常欢迎您的贡献，以帮助修复错误、改进功能和提高代码质量！
 
   ***为了保证协作的顺畅，在合并代码前，你需要阅读以下规范：***
 
----
+## 快速入门
+
+### 1. 在本地部署项目
+
+- **克隆仓库**
+
+    ```bash
+    git clone https://github.com/UE-DND/Repo-Viewer.git
+    cd Repo-Viewer
+    ```
+
+- **安装依赖**
+
+    ```bash
+   npm install
+   ```
 
-### 快速入门
+- **创建环境配置**：复制 `.env.example` 到 `.env` 并配置必要的环境变量（参见下方内容）
 
-#### 1. 在本地部署项目
+   ```bash
+   cp .env.example .env
+   ```
 
-具体部署操作参见【[本地开发](README.md#本地开发)】。
+- **启动开发服务器**
 
-#### 2. 创建功能分支
+   ```bash
+   npm run dev
+   ```
+
+### 2. 创建功能分支
 
 **重要**：`master`是我们的生产分支，`dev`是开发分支。任何修改请先合并至`dev`分支。
 
@@ -28,9 +49,9 @@ git pull origin dev
 git checkout -b branch-name/your-description
 ```
 
-#### 3. 进行代码更改
+### 3. 进行代码更改
 
-#### 4. 自行测试所有内容
+### 4. 自行测试所有内容
 
 在提交 PR 之前，确保通过 ESLint 测试，不推荐出现任何的错误或警告：
 
@@ -40,17 +61,15 @@ npm run lint
 
 同时请确保代码质量和部署通过，我们不会对 PR 进行任何审查。若预览分支出现问题，我们会直接撤销你的合并请求。
 
-#### 5. 提交您的 PR
+### 5. 提交您的 PR
 
 - 以 `dev` 分支为目标
 - 编写清晰的描述
 - 引用任何相关 issue
 
----
-
-### 开发指南
+## 开发指南
 
-#### 分支命名规范
+### 分支命名规范
 
 - **`master`**：生产就绪的代码
 - **`dev`**：开发/预览分支 - **【PR的目标分支】**
@@ -62,35 +81,33 @@ npm run lint
 
 > 推荐于此规范中选择分支的命名
 
-#### 我们期望的代码标准
+### 我们期望的代码标准
 
 1. 代码职责最小化
 2. 文件分类正确且清晰
 3. 添加或删除依赖后，及时更新相关文档
 4. 注释简洁，不必添加过多说明，除非改动可能引起的其它后果
 5. 谨慎进行大范围重构或技术栈变更，同时需要在 PR 中说明相关变更理由
 
-#### 代码格式化
+### 代码格式化
 
 我们使用 `EditorConfig` 进行一致的格式化，请确保你的编辑器安装了相应插件以自动应用格式规则。
 
----
-
-### 提交 issue
+## 提交 issue
 
-#### [bug]
+### [bug]
 
 - 存在问题的分支
 - 问题重现步骤
 - 期望行为 vs 实际行为
 - 错误日志
 
-#### [enhancement]
+### [enhancement]
 
 - 清晰的增强描述，杜绝抽象概念
 - 建议的实现逻辑
 
-#### [feature]
+### [feature]
 
 - 功能用途说明
 - 清晰的功能描述，杜绝抽象概念
@@ -106,6 +123,6 @@ npm run lint
 
 ---
 
-**感谢您为 Repo Viewer 做出贡献！** 🎉
+**感谢您为 Repo Viewer 做出的贡献！** 🎉
 
 您的贡献有助于为每个人提供更好的 GitHub 仓库浏览体验。