1.4.0

【修复】
- TS 静态错误
- 过时的构建命令
- 潜在的代码问题

【优化】
- 搜索高亮性能
- 虚拟列表性能
- 移除部分死代码
- 文档/注释语法错误
- 文本类型文件预览性能
- 文本类型文件预览响应式设计
- README 中弃用的 HTML 特性
- Markdown 相对链接跳转稳定性

Author: UE-DND

.env.backup

@@ -1,7 +1,7 @@
 SITE_TITLE=Repo-Viewer
 SITE_DESCRIPTION=基于MD3设计语言的GitHub仓库浏览应用
 SITE_KEYWORDS= GitHub, 仓库, 浏览器, 代码, 查看器
-GITHUB_REPO_OWNER=UE-DND
+GITHUB_REPO_OWNER=CQUT-OpenProject
 GITHUB_REPO_NAME=Repo-Viewer
 GITHUB_REPO_BRANCH=master
 

.env.example

@@ -11,7 +11,7 @@ SITE_DESCRIPTION = 基于MD3设计语言的GitHub仓库浏览应用
 SITE_KEYWORDS = GitHub, 仓库, 浏览器, 代码, 查看器
 
 # GitHub仓库信息 - 配置要浏览的GitHub仓库
-GITHUB_REPO_OWNER = UE-DND
+GITHUB_REPO_OWNER = CQUT-OpenProject
 GITHUB_REPO_NAME = Repo-Viewer
 GITHUB_REPO_BRANCH = master
 

CONTRIBUTING.md

@@ -17,7 +17,7 @@
 - **克隆仓库**
 
     ```bash
-    git clone https://github.com/UE-DND/Repo-Viewer.git
+    git clone https://github.com/CQUT-OpenProject/Repo-Viewer.git
     cd Repo-Viewer
     ```
 
@@ -91,7 +91,7 @@ npm run lint
 
 ### 代码格式化
 
-我们使用 `EditorConfig` 进行一致的格式化，请确保你的编辑器安装了相应插件以自动应用格式规则。
+我们使用 `EditorConfig` 进行统一格式化，请确保你的编辑器安装了相应插件以自动应用格式规则。
 
 ## 提交 issue
 
@@ -104,7 +104,7 @@ npm run lint
 
 ### [enhancement]
 
-- 清晰的增强描述，杜绝抽象概念
+- 清晰地描述增强点，杜绝抽象概念
 - 建议的实现逻辑
 
 ### [feature]
@@ -115,8 +115,6 @@ npm run lint
 
 > 推荐保持与历史 issue 一致的标题格式
 
----
-
 ### 许可证
 
 通过贡献，您同意您的贡献将按照与项目相同的许可证 [AGPL-3.0](LICENSE) 进行许可。

README.md

@@ -1,14 +1,16 @@
-<h1 align="center">
-  <em>Repo-Viewer</em>
-</h1>
-
-<p align="center">
-  <strong>基于 Material Design 3设计风格的 GitHub仓库浏览应用</strong>
-  &nbsp;&nbsp;
-  <a href="https://deepwiki.com/UE-DND/Repo-Viewer">
-    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
-  </a>
-</p>
+<div style="text-align: center;">
+  <h1><em>Repo-Viewer</em></h1>
+</div>
+
+<div style="text-align: center;">
+  <p>
+    <strong>基于 Material Design 3设计风格的 GitHub仓库浏览应用</strong>
+    &nbsp;&nbsp;
+    <a href="https://deepwiki.com/CQUT-OpenProject/Repo-Viewer">
+      <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+    </a>
+  </p>
+</div>
 
 ![Preview Dark](docs/image/dark.png)
 
@@ -20,9 +22,17 @@
   <tr>
 </table>
 
+## 为 Repo Viewer 贡献代码
+
+此项目已进入稳定阶段，本人将不再花过多精力维护。若发现已知的问题，欢迎任何形式的贡献！无论是修复错误、改进功能，还是提升代码质量，我们都非常欢迎您的参与。
+
+> 此组织的所有成员均有管理员权限，若不想提交 Pull Request，直接推送代码是被允许的。
+> 
+> 但在提交贡献前，推荐阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 以了解建议的代码规范和提交流程。
+
 ## 主要功能
 
-- 📁 **仓库浏览**：直观的文件结构导航，同时提供首页文件和文件夹排除选项.
+- 📁 **仓库浏览**：直观的文件结构导航，同时提供首页文件与文件夹排除选项.
 - 🔎 **文件搜索**：支持基于自建索引和 Github API 的快速文件搜索，可按分支、路径前缀和扩展名过滤.
 - 📄 **文件预览**：多种文件格式预览，目前支持 `Markdown`、 `PDF` 和 `图片`.
 - ⬇️ **文件下载**：可下载单个文件或整个文件夹.
@@ -76,8 +86,8 @@ Repo-Viewer 使用 docfind 生成静态索引并随站点发布。构建时运
 
 ## 贡献者
 
-[![Contributors](https://contrib.rocks/image?repo=UE-DND/Repo-Viewer)](https://github.com/UE-DND/Repo-Viewer/graphs/contributors)
+[![Contributors](https://contrib.rocks/image?repo=CQUT-OpenProject/Repo-Viewer)](https://github.com/CQUT-OpenProject/Repo-Viewer/graphs/contributors)
 
 ## Stars
 
-![Star History](https://api.star-history.com/svg?repos=UE-DND/Repo-Viewer&type=Date)
+![Star History](https://api.star-history.com/svg?repos=CQUT-OpenProject/Repo-Viewer&type=Date)

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "repo-viewer",
   "private": true,
-  "version": "1.3.9",
+  "version": "1.4.0",
   "type": "module",
   "engines": {
     "node": "24.x"
@@ -10,7 +10,7 @@
     "dev": "vite",
     "build": "tsc -p scripts/tsconfig.json && node scripts/dist/generateInitialContent.js && node scripts/dist/generateDocfindIndex.js && tsc && vite build",
     "generate:index": "tsc -p scripts/tsconfig.json && node scripts/dist/generateDocfindIndex.js",
-    "install-deps": "npm install --legacy-peer-deps",
+    "install-deps": "npm install",
     "lint": "eslint . --ext ts,tsx",
     "preview": "vite preview"
   },

package.json

@@ -402,7 +402,7 @@ const resolveBranchRef = async (repoPath: string, branch: string): Promise<strin
       await runCommandText("git", ["rev-parse", "--verify", candidate], repoPath);
       return candidate;
     } catch {
-      continue;
+
     }
   }
   return null;

scripts/generateDocfindIndex.ts

@@ -78,7 +78,7 @@ const fetchJson = async <T>(url: string): Promise<T> => {
   if (!response.ok) {
     throw new Error(`Request failed: ${response.status} ${response.statusText}`);
   }
-  return response.json() as Promise<T>;
+  return (await response.json()) as T;
 };
 
 const fetchText = async (url: string): Promise<string> => {
@@ -139,7 +139,9 @@ const run = async (): Promise<void> => {
     const contents = await fetchJson<unknown>(contentsUrl);
 
     if (!Array.isArray(contents)) {
-      throw new Error("Unexpected contents response");
+      console.warn("[hydration] Unexpected contents response, writing null payload.");
+      await writeOutput(null);
+      return;
     }
 
     const contentItems = contents.filter(isRecord);

scripts/generateInitialContent.ts

@@ -1,3 +1 @@
-import type { InitialContentHydrationPayload } from "@/types";
-
-export const initialContentPayload: InitialContentHydrationPayload | null = null;
+export {};

scripts/src/generated/initialContent.ts

@@ -5,7 +5,7 @@ import { AutoSizer } from "react-virtualized-auto-sizer";
 import AlphabetIndex from "./AlphabetIndex";
 import { RowComponent } from "./FileListRow";
 import { FILE_ITEM_CONFIG, LIST_HEIGHT_CONFIG } from "./utils/fileListConfig";
-import { calculateLayoutMetrics } from "./utils/fileListLayout";
+import { calculateLayoutMetrics, getListPadding, getRowMetrics } from "./utils/fileListLayout";
 import type { VirtualListItemData, FileListLayoutMetrics } from "./utils/types";
 import type { GitHubContent } from "@/types";
 import { theme } from "@/utils";
@@ -70,17 +70,8 @@ const FileList = React.memo<FileListProps>(
 
     // 计算每个文件项的高度（包括间距）
     // 这个计算需要与 FileListItem 的实际高度保持一致
-    const rowHeight = useMemo(() => {
-      // 基础高度
-      const baseHeight = isSmallScreen
-        ? FILE_ITEM_CONFIG.baseHeight.xs
-        : FILE_ITEM_CONFIG.baseHeight.sm;
-
-      // 行间距（上下各分一半）
-      const rowGap = FILE_ITEM_CONFIG.spacing.marginBottom;
-
-      // 计算总高度：基础高度 + 行间距
-      return baseHeight + rowGap;
+    const { rowHeight, rowPaddingBottom } = useMemo(() => {
+      return getRowMetrics(isSmallScreen);
     }, [isSmallScreen]);
 
     /**
@@ -200,6 +191,7 @@ const FileList = React.memo<FileListProps>(
         isScrolling,
         scrollSpeed,
         highlightedIndex,
+        rowPaddingBottom,
       }),
       [
         contents,
@@ -214,26 +206,17 @@ const FileList = React.memo<FileListProps>(
         isScrolling,
         scrollSpeed,
         highlightedIndex,
+        rowPaddingBottom,
       ],
     );
 
     // 简化的列表内边距计算
-    const listPadding = useMemo((): { paddingTop: number; paddingBottom: number } => {
-      // 非滚动模式：使用固定的对称内边距，稍微增加一点
-      if (!needsScrolling) {
-        const padding = isSmallScreen ? 16 : 20;
-        return {
-          paddingTop: padding - 4,
-          paddingBottom: padding,
-        };
-      }
-
-      // 滚动模式：使用较小的内边距
-      return {
-        paddingTop: 0,
-        paddingBottom: 8,
-      };
-    }, [needsScrolling, isSmallScreen]);
+    // 列表内边距规则集中管理，区分滚动与非滚动模式。
+    const listPadding = useMemo(
+      (): { paddingTop: number; paddingBottom: number } =>
+        getListPadding(needsScrolling, isSmallScreen),
+      [needsScrolling, isSmallScreen],
+    );
 
     // 处理滚动事件（监听列表容器）
     React.useEffect(() => {