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

@@ -88,6 +88,7 @@ const App = React.memo(() => {
       `GitHub Token状态: ${hasTokenFlag ? "已配置" : "未配置"}, Token数量: ${tokenCount.toString()}`,
     );
 
+    // 此日志仅供本地开发环境使用，部署至平台后无法检测环境变量
     if (!hasTokenFlag) {
       logger.warn(
         "未检测到GitHub Token，API搜索功能可能受限。请考虑配置Token以获取更好的搜索体验。",
@@ -181,7 +182,7 @@ const App = React.memo(() => {
                     {SITE_TITLE}
                   </Typography>
 
-                  {/* 面包屑在顶部栏的容器 */}
+                  {/* 面包屑导航（顶部栏）的容器 */}
                   <Collapse
                     in={showBreadcrumbInToolbar}
                     orientation="horizontal"
@@ -226,7 +227,7 @@ const App = React.memo(() => {
   );
 });
 
-// 添加显示名称以便调试
+// DevTools 显示名称
 App.displayName = "App";
 
 export default App;