release: bump to v2.0.4 with homepage, admin UI, and changelog

Ship the homepage/sidebar redesign, RoutinAI announcement banner, admin UI polish, and release notes since v2.0.3.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: 239573049

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## v2.0.4 - 2026-08-12
+
+### Added
+- Added repository branch generation tasks, admin controls, and workspace isolation for multi-branch wiki builds.
+- Added repository scan plan controls and startup schema updates.
+- Added repository tree/explorer view for browsing public repositories.
+- Added SITE_URL support for public site URL configuration and SEO/sitemap generation.
+- Added Brazilian Portuguese (pt-BR) UI translations.
+- Added global MCP provider endpoint.
+- Added RoutinAI sponsorship top announcement banner with multi-language copy and dismiss state.
+- Added shared admin UI building blocks (page header, data table, pagination, status badge, breadcrumbs).
+
+### Changed
+- Redesigned the main sidebar into Discover / Workspace / Tools groups with path-based active states.
+- Reworked the homepage into a compact workspace layout with tighter search and actions.
+- Refreshed admin dashboard and list pages for clearer hierarchy and denser operational layouts.
+- Localized admin UI and added language toggle to the admin header.
+- Improved sitemap generation with branch and language support.
+- Updated wiki generation workflow, including segmented content generation and repository page layout polish.
+
+### Fixed
+- Fixed nested `.env` key loading and stale wiki model bindings for DeepSeek setups.
+- Fixed Gemini `finish_reason` normalization for the OpenAI SDK path.
+- Prevented incremental updates from wiping the wiki catalog; added regression coverage.
+- Fixed ZIP upload multipart/form-data handling.
+- Fixed source file links for non-GitHub hosts (e.g. Azure DevOps).
+- Fixed chat stream keepalive and code-block rendering issues.
+- Hardened branch generation locking/mutations and backfilled SQLite schema.
+- Escaped sitemap XML URLs.
+- Improved document generation error handling so partial failures do not always fail the whole repository job.
+- Fixed local Git source branch handling.
+
 ## v2.0.3 - 2026-05-30
 
 ### Added

Directory.Packages.props

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
     <TimeStamp>$([System.DateTime]::UtcNow.ToString("yyyyMMdd"))</TimeStamp>
-    <Version>2.0.3</Version>
+    <Version>2.0.4</Version>
     <!-- 项目信息 -->
     <Product>OpenDeepWiki</Product>
     <Title>OpenDeepWiki - AI驱动的代码知识库</Title>

web/app/(main)/page.tsx

@@ -26,7 +26,7 @@ export default function Home() {
   const [isFormOpen, setIsFormOpen] = useState(false);
   const [isIntegrationsOpen, setIsIntegrationsOpen] = useState(false);
   const [keyword, setKeyword] = useState("");
-  const { isScrolled } = useScrollPosition(100);
+  const { isScrolled } = useScrollPosition(80);
 
   const handleSubmitSuccess = useCallback(() => {
     setIsFormOpen(false);
@@ -50,78 +50,88 @@ export default function Home() {
         visible: isScrolled,
       }}
     >
-      <div className="flex flex-1 flex-col p-4">
-        {/* Hero Section with Main Search Box */}
-        <div className="flex flex-col items-center justify-center py-12">
-          <div className="w-full max-w-2xl space-y-8">
-            <h1 className="text-center text-4xl font-medium tracking-tight text-foreground">
-              {t("home.title")}
-            </h1>
-            {/* Main Search Box with fade animation */}
+      <div className="flex min-h-0 flex-1 flex-col">
+        <section className="relative overflow-hidden border-b border-border/70">
+          <div
+            aria-hidden
+            className="pointer-events-none absolute inset-0 bg-[radial-gradient(ellipse_at_top,color-mix(in_oklab,var(--foreground)_6%,transparent),transparent_58%)]"
+          />
+          <div className="relative mx-auto flex w-full max-w-[1400px] flex-col gap-5 px-4 py-6 sm:px-6 lg:px-8">
+            <div className="flex flex-col gap-4 lg:flex-row lg:items-end lg:justify-between">
+              <div className="min-w-0 space-y-1.5">
+                <p className="text-[11px] font-medium uppercase tracking-[0.14em] text-muted-foreground">
+                  {t("sidebar.explore")}
+                </p>
+                <h1 className="text-2xl font-semibold tracking-tight text-foreground sm:text-[1.75rem]">
+                  {t("home.title")}
+                </h1>
+                <p className="max-w-xl text-sm text-muted-foreground">
+                  {t("home.subtitle")}
+                </p>
+              </div>
+
+              <div className="flex flex-wrap items-center gap-2">
+                <Dialog open={isFormOpen} onOpenChange={setIsFormOpen}>
+                  <Button
+                    className="h-9 gap-2 rounded-lg bg-teal-600 px-3.5 text-white hover:bg-teal-500"
+                    onClick={handleAddRepoClick}
+                  >
+                    <Plus className="h-4 w-4" />
+                    {t("home.addPrivateRepo")}
+                  </Button>
+                  <DialogContent className="max-h-[85vh] overflow-y-auto sm:max-w-2xl">
+                    {user && (
+                      <RepositorySubmitForm onSuccess={handleSubmitSuccess} />
+                    )}
+                  </DialogContent>
+                </Dialog>
+                <Button
+                  variant="outline"
+                  className="h-9 gap-2 rounded-lg border-border/80 bg-background/60"
+                >
+                  <Flame className="h-4 w-4 text-orange-500" />
+                  {t("home.exploreTrending")}
+                </Button>
+                <Button
+                  variant="ghost"
+                  className="h-9 gap-2 rounded-lg text-muted-foreground hover:text-foreground"
+                  onClick={() => setIsIntegrationsOpen(true)}
+                >
+                  <Puzzle className="h-4 w-4" />
+                  <span className="hidden sm:inline">{t("home.mcpIntegrationShort")}</span>
+                  <span className="sm:hidden">MCP</span>
+                </Button>
+              </div>
+            </div>
+
             <div
               className={cn(
-                "relative transition-all duration-250 ease-in-out",
+                "relative max-w-3xl transition-all duration-250 ease-out",
                 isScrolled
-                  ? "opacity-0 -translate-y-2 pointer-events-none"
-                  : "opacity-100 translate-y-0 pointer-events-auto"
+                  ? "pointer-events-none -translate-y-1 opacity-0"
+                  : "translate-y-0 opacity-100"
               )}
             >
-              <div className="absolute left-4 top-1/2 -translate-y-1/2 text-muted-foreground">
-                <Search className="h-5 w-5" />
-              </div>
+              <Search className="pointer-events-none absolute top-1/2 left-3.5 h-4 w-4 -translate-y-1/2 text-muted-foreground" />
               <Input
                 value={keyword}
                 onChange={(e) => setKeyword(e.target.value)}
                 placeholder={t("home.searchPlaceholder")}
                 maxLength={100}
-                className="h-14 rounded-full pl-12 text-lg shadow-sm transition-all hover:shadow-md focus-visible:ring-2 focus-visible:ring-primary/20 bg-secondary/50 border-transparent"
+                className="h-11 rounded-xl border-border/70 bg-background/80 pl-10 text-sm shadow-none transition-[border-color,box-shadow] focus-visible:border-teal-500/40 focus-visible:ring-teal-500/15"
               />
             </div>
-
-            <div className="flex flex-wrap items-center justify-center gap-3">
-              <Dialog open={isFormOpen} onOpenChange={setIsFormOpen}>
-                <Button
-                  variant="secondary"
-                  className="gap-2 rounded-full h-10 px-6 bg-teal-500/10 text-teal-500 hover:bg-teal-500/20 hover:text-teal-400 border border-teal-500/20"
-                  onClick={handleAddRepoClick}
-                >
-                  <Plus className="h-4 w-4" />
-                  {t("home.addPrivateRepo")}
-                </Button>
-                <DialogContent className="sm:max-w-2xl max-h-[85vh] overflow-y-auto">
-                  {user && (
-                    <RepositorySubmitForm
-                      onSuccess={handleSubmitSuccess}
-                    />
-                  )}
-                </DialogContent>
-              </Dialog>
-              <Button variant="secondary" className="gap-2 rounded-full h-10 px-6 bg-blue-500/10 text-blue-500 hover:bg-blue-500/20 hover:text-blue-400 border border-blue-500/20">
-                <Flame className="h-4 w-4" />
-                {t("home.exploreTrending")}
-              </Button>
-            </div>
-            <div className="flex justify-center">
-              <Button
-                variant="ghost"
-                className="gap-2 text-muted-foreground hover:text-foreground"
-                onClick={() => setIsIntegrationsOpen(true)}
-              >
-                <Puzzle className="h-4 w-4" />
-                {t("home.mcpIntegration")}
-              </Button>
-            </div>
-            <IntegrationsDialog
-              open={isIntegrationsOpen}
-              onOpenChange={setIsIntegrationsOpen}
-            />
           </div>
-        </div>
 
-        {/* Public Repository List Section */}
-        <div className="w-full max-w-6xl mx-auto mt-8">
+          <IntegrationsDialog
+            open={isIntegrationsOpen}
+            onOpenChange={setIsIntegrationsOpen}
+          />
+        </section>
+
+        <section className="mx-auto w-full max-w-[1400px] flex-1 px-4 py-5 sm:px-6 lg:px-8">
           <PublicRepositoryList keyword={keyword} />
-        </div>
+        </section>
       </div>
     </AppLayout>
   );

web/app/admin/admin-layout-client.tsx

@@ -1,26 +1,40 @@
 "use client";
 
 import React, { useEffect } from "react";
+import Link from "next/link";
 import { useRouter } from "next/navigation";
+import { Home, Loader2, LogOut } from "lucide-react";
+
 import { useAuth } from "@/contexts/auth-context";
 import { AdminSidebar } from "@/components/admin/admin-sidebar";
+import { AdminBreadcrumb } from "@/components/admin/admin-breadcrumb";
 import { LanguageToggle } from "@/components/language-toggle";
+import { ThemeToggle } from "@/components/theme-toggle";
 import { useTranslations } from "@/hooks/use-translations";
 import {
   SidebarInset,
   SidebarProvider,
   SidebarTrigger,
 } from "@/components/animate-ui/components/radix/sidebar";
+import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar";
+import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
 import { Separator } from "@/components/ui/separator";
-import { Loader2 } from "lucide-react";
 
 export default function AdminLayoutClient({
   children,
 }: {
   children: React.ReactNode;
 }) {
   const router = useRouter();
-  const { user, isLoading } = useAuth();
+  const { user, isLoading, logout } = useAuth();
   const t = useTranslations();
 
   const isAdmin = user?.roles?.includes("Admin") ?? false;
@@ -43,20 +57,69 @@ export default function AdminLayoutClient({
     return null;
   }
 
+  const userInitial = (user?.name || "?").charAt(0).toUpperCase();
+
   return (
     <SidebarProvider defaultOpen={true}>
       <AdminSidebar />
       <SidebarInset>
         <header className="sticky top-0 z-10 flex h-14 shrink-0 items-center gap-2 border-b bg-background/95 px-4 backdrop-blur supports-[backdrop-filter]:bg-background/60">
           <SidebarTrigger className="-ml-1" />
-          <Separator orientation="vertical" className="mr-2 h-4" />
-          <h1 className="text-sm font-semibold">{t("common.adminPanel")}</h1>
-          <div className="ml-auto flex items-center gap-2">
+          <Separator orientation="vertical" className="mr-1 h-4" />
+          <AdminBreadcrumb />
+          <div className="ml-auto flex items-center gap-1">
+            <ThemeToggle />
             <LanguageToggle />
+            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  className="ml-1 h-9 w-9 rounded-full"
+                >
+                  <Avatar className="h-7 w-7">
+                    <AvatarImage src={user?.avatar} alt={user?.name} />
+                    <AvatarFallback className="text-xs">
+                      {userInitial}
+                    </AvatarFallback>
+                  </Avatar>
+                </Button>
+              </DropdownMenuTrigger>
+              <DropdownMenuContent align="end" className="w-56">
+                <DropdownMenuLabel className="font-normal">
+                  <div className="flex flex-col gap-0.5">
+                    <span className="truncate text-sm font-medium">
+                      {user?.name}
+                    </span>
+                    <span className="truncate text-xs text-muted-foreground">
+                      {user?.email}
+                    </span>
+                  </div>
+                </DropdownMenuLabel>
+                <DropdownMenuSeparator />
+                <DropdownMenuItem asChild>
+                  <Link href="/">
+                    <Home className="mr-2 h-4 w-4" />
+                    {t("common.backToHome")}
+                  </Link>
+                </DropdownMenuItem>
+                <DropdownMenuSeparator />
+                <DropdownMenuItem
+                  variant="destructive"
+                  onClick={() => {
+                    logout();
+                    router.push("/");
+                  }}
+                >
+                  <LogOut className="mr-2 h-4 w-4" />
+                  {t("common.logout")}
+                </DropdownMenuItem>
+              </DropdownMenuContent>
+            </DropdownMenu>
           </div>
         </header>
         <main className="flex-1 overflow-auto">
-          <div className="container mx-auto p-6">
+          <div className="mx-auto w-full max-w-screen-2xl p-4 md:p-6">
             {children}
           </div>
         </main>

web/app/admin/api-keys/page.tsx

@@ -24,6 +24,7 @@ import {
 } from "lucide-react";
 import { toast } from "sonner";
 import { useTranslations } from "@/hooks/use-translations";
+import { PageHeader } from "@/components/admin/page-header";
 import { useLocale } from "next-intl";
 
 export default function AdminApiKeysPage() {
@@ -118,24 +119,23 @@ export default function AdminApiKeysPage() {
   };
 
   return (
-    <div className="space-y-6">
-      {/* Header */}
-      <div className="flex items-center justify-between">
-        <div>
-          <h1 className="text-2xl font-bold">{t("admin.apiKeys.title")}</h1>
-          <p className="text-sm text-muted-foreground">{t("admin.apiKeys.subtitle")}</p>
-        </div>
-        <div className="flex gap-2">
-          <Button variant="outline" onClick={fetchData}>
-            <RefreshCw className="mr-2 h-4 w-4" />
-            {t("admin.common.refresh")}
-          </Button>
-          <Button onClick={openCreateDialog}>
-            <Plus className="mr-2 h-4 w-4" />
-            {t("admin.apiKeys.createKey")}
-          </Button>
-        </div>
-      </div>
+    <div className="space-y-5">
+      <PageHeader
+        title={t("admin.apiKeys.title")}
+        description={t("admin.apiKeys.subtitle")}
+        actions={
+          <>
+            <Button variant="outline" onClick={fetchData}>
+              <RefreshCw className="mr-1.5 h-4 w-4" />
+              {t("admin.common.refresh")}
+            </Button>
+            <Button onClick={openCreateDialog}>
+              <Plus className="mr-1.5 h-4 w-4" />
+              {t("admin.apiKeys.createKey")}
+            </Button>
+          </>
+        }
+      />
 
       {/* API Keys Table */}
       {loading ? (