{{/* index.html 使用 docs_layout.html 作为布局模板 */}}

{{define "sidebar-nav"}}
{{if .Data.HomePortal}}
<ul class="nav-list" id="homePortalNavList">
    {{range .Data.Directories}}
    <li class="nav-item doc">
        <a class="nav-link" href="{{index . "url"}}" title="{{index . "alias"}}">
            <i class='{{if index . "icon"}}{{index . "icon"}}{{else}}bx bx-folder{{end}}'></i>
            <span>{{index . "alias"}}</span>
        </a>
    </li>
    {{end}}
</ul>
<div class="sg-home-nav-hint" role="note">
    <div class="sg-home-nav-hint-visual" aria-hidden="true">
        <i class="bx bx-chevron-up sg-home-nav-hint-arrow"></i>
        <span class="sg-home-nav-hint-pulse"></span>
        <i class="bx bx-pointer sg-home-nav-hint-icon"></i>
    </div>
    {{if .Data.Directories}}
    <p class="sg-home-nav-hint-title">{{T "home.nav_hint_title"}}</p>
    <p class="sg-home-nav-hint-desc">{{T "home.nav_hint_desc"}}</p>
    {{else}}
    <p class="sg-home-nav-hint-title">{{T "home.nav_hint_empty_title"}}</p>
    <p class="sg-home-nav-hint-desc">{{T "home.nav_hint_empty_desc"}}</p>
    {{end}}
</div>
{{else}}
<ul class="nav-list" id="docsNav">
    <li class="nav-loading">
        <i class='bx bx-loader-alt bx-spin'></i>
        <span>{{T "docs_loading_nav"}}</span>
    </li>
</ul>
{{end}}
{{end}}

{{define "content"}}
<article class="docs-article{{if .Data.HasDocument}} docs-article-detail{{end}}{{if .Data.HomePortal}} sg-home{{end}}" id="docsArticle"{{if .Data.HasDocument}} itemscope itemtype="https://schema.org/TechArticle"{{end}}>
    {{if .Data.HomePortal}}
    <header class="docs-article-header sg-home-hero article-header" id="articleHeader">
        <h1 class="article-title" id="articleTitle">{{if .HomeTitle}}{{.HomeTitle}}{{else}}{{.SiteName}}{{end}}</h1>
        <p class="article-description">
            {{if .HomeSubtitle}}{{.HomeSubtitle}}{{else if .Description}}{{.Description}}{{else}}{{T "home.hero_fallback"}}{{end}}
        </p>
    </header>
    <section class="sg-home-dirs" aria-label="{{T "home.section_dirs"}}">
        <div class="sg-home-dirs-head">
            <h2 class="sg-home-dirs-title"><i class='bx bx-collection'></i> {{T "home.section_dirs"}}</h2>
        </div>
        <div class="sg-dir-grid">
            {{range .Data.Directories}}
            <a href="{{index . "url"}}" class="sg-dir-card" title="{{index . "alias"}}">
                <span class="sg-dir-card-icon">
                    <i class='{{if index . "icon"}}{{index . "icon"}}{{else}}bx bx-folder{{end}}'></i>
                </span>
                <span class="sg-dir-card-body">
                    <span class="sg-dir-card-title">{{index . "alias"}}</span>
                    <span class="sg-dir-card-meta">
                        <code>/{{index . "path_prefix"}}</code>
                        <span>{{index . "doc_count"}} {{T "home.docs_unit"}}</span>
                    </span>
                </span>
                <span class="sg-dir-card-action">
                    <span>{{T "home.browse"}}</span>
                    <i class='bx bx-right-arrow-alt'></i>
                </span>
            </a>
            {{else}}
            <div class="sg-home-empty">
                <i class='bx bx-folder-open'></i>
                <p>{{T "home.no_directories"}}</p>
            </div>
            {{end}}
        </div>
    </section>
    {{else}}
    {{if .Data.HasDocument}}
    {{with .Data.SEO}}
    {{if .Breadcrumbs}}
    <nav class="docs-breadcrumb" aria-label="{{T "docs_breadcrumb_aria"}}">
        <ol class="docs-breadcrumb-list" itemscope itemtype="https://schema.org/BreadcrumbList">
            {{$bcs := .Breadcrumbs}}
            {{range $i, $bc := $bcs}}
            <li class="docs-breadcrumb-item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
                {{if lt (add $i 1) (len $bcs)}}
                <a href="{{index $bc "url"}}" itemprop="item" class="docs-breadcrumb-link{{if eq $i 0}} docs-breadcrumb-link--home{{end}}">{{if eq $i 0}}<i class="bx bx-home-alt docs-breadcrumb-home-icon" aria-hidden="true"></i>{{end}}<span itemprop="name">{{index $bc "name"}}</span></a>
                {{else}}
                <span itemprop="name">{{index $bc "name"}}</span>
                {{end}}
                <meta itemprop="position" content="{{add $i 1}}">
            </li>
            {{end}}
        </ol>
    </nav>
    {{end}}
    {{end}}
    {{end}}
    {{if .Data.AuditPreview}}
    <div class="audit-preview-banner" role="status">
        <i class='bx bx-shield-quarter' aria-hidden="true"></i>
        <div class="audit-preview-banner__text">
            <strong>{{T "docs_audit_preview_title"}}</strong>
            {{if eq .Data.AuditPreviewStatus 0}}
            <span>{{T "docs_audit_preview_pending"}}</span>
            {{else if eq .Data.AuditPreviewStatus 2}}
            <span>{{T "docs_audit_preview_rejected"}}</span>
            {{else}}
            <span>{{T "docs_audit_preview_not_approved"}}</span>
            {{end}}
        </div>
        <a href="/admin/audit-detail?id={{with .Data.Document}}{{.id}}{{end}}" class="audit-preview-banner__link">{{T "docs_audit_preview_review_link"}}</a>
    </div>
    {{end}}
    <header class="article-header" id="articleHeader"{{if .Data.ShowNavHint}} style="display: none;"{{end}}>
        <h1 class="article-title" id="articleTitle" itemprop="headline">
            {{if .Data.HasDocument}}{{with .Data.Document}}{{.title}}{{end}}{{else}}{{.SiteName}}{{end}}
        </h1>
        <div class="article-meta" id="articleMeta"{{if not .Data.HasDocument}} style="display: none;"{{end}}>
            {{if .Data.HasDocument}}
            <div class="article-stats">
                {{with .Data.SEO}}
                {{if .PublishedAt}}
                <time class="stat-item" datetime="{{.PublishedAt}}" itemprop="datePublished" title="{{T "docs_meta_published"}}">
                    <i class='bx bx-calendar'></i>
                    <span class="stat-value">{{formatUnixDate .PublishedAt}}</span>
                </time>
                {{end}}
                {{if .AuthorName}}
                <span class="stat-item" itemprop="author" itemscope itemtype="https://schema.org/Person">
                    <i class='bx bx-user'></i>
                    <span class="stat-value" itemprop="name">{{.AuthorName}}</span>
                </span>
                {{end}}
                {{end}}
                <span class="stat-item" id="viewCount">
                    <i class='bx bx-show'></i>
                    <span class="stat-value">{{with .Data.Document}}{{if .view_count}}{{.view_count}}{{else}}0{{end}}{{else}}0{{end}}</span>
                </span>
                <button type="button" class="stat-item stat-item-action stat-item-comment" id="commentCount" title="{{T "docs_action_comment"}}" aria-label="{{T "docs_action_comment"}}">
                    <i class='bx bx-message-square-dots'></i>
                    <span class="stat-value">{{with .Data.Document}}{{if .comment_count}}{{.comment_count}}{{else}}0{{end}}{{else}}0{{end}}</span>
                </button>
            </div>
            <div class="doc-reading-tools">
                <div class="article-font-size-tools" id="articleFontSizeTools" role="group" aria-label="{{T "docs_font_size_aria"}}">
                    <button type="button" class="article-font-size-btn js-font-size-dec" title="{{T "docs_font_size_decrease"}}" aria-label="{{T "docs_font_size_decrease"}}">
                        <span class="article-font-size-btn-label">A</span><i class='bx bx-minus' aria-hidden="true"></i>
                    </button>
                    <button type="button" class="article-font-size-reset js-font-size-reset" title="{{T "docs_font_size_reset"}}" aria-label="{{T "docs_font_size_reset"}}">
                        <span class="js-font-size-value">100%</span>
                    </button>
                    <button type="button" class="article-font-size-btn js-font-size-inc" title="{{T "docs_font_size_increase"}}" aria-label="{{T "docs_font_size_increase"}}">
                        <span class="article-font-size-btn-label">A</span><i class='bx bx-plus' aria-hidden="true"></i>
                    </button>
                </div>
                <button type="button" class="doc-content-view-btn js-doc-print" title="{{T "docs_action_print"}}" aria-label="{{T "docs_action_print"}}">
                    <i class='bx bx-printer' aria-hidden="true"></i>
                </button>
                <button type="button" class="doc-content-view-btn js-content-view-toggle" title="{{T "docs_content_view_maximize"}}" aria-label="{{T "docs_content_view_maximize"}}" aria-pressed="false">
                    <i class='bx bx-fullscreen' aria-hidden="true"></i>
                </button>
            </div>
            <div class="article-stat-actions">
                <button type="button" class="stat-item stat-item-action stat-item-like" id="btnLike" title="{{T "docs_action_like"}}" aria-label="{{T "docs_action_like"}}">
                    <i class='bx bx-like'></i>
                    <span class="stat-value">{{with .Data.Document}}{{if .like_count}}{{.like_count}}{{else}}0{{end}}{{else}}0{{end}}</span>
                </button>
                <button type="button" class="stat-item stat-item-action stat-item-favorite" id="btnFavorite" title="{{T "docs_action_favorite"}}" aria-label="{{T "docs_action_favorite"}}">
                    <i class='bx bx-star'></i>
                    <span class="stat-value">{{with .Data.Document}}{{if .favorite_count}}{{.favorite_count}}{{else}}0{{end}}{{else}}0{{end}}</span>
                </button>
                {{if .Data.UserLoggedIn}}
                <button type="button" class="stat-item stat-item-action stat-item-report" id="btnReport" title="{{T "docs_action_report"}}" aria-label="{{T "docs_action_report"}}">
                    <i class='bx bx-flag text-danger'></i>
                </button>
                {{end}}
            </div>
            {{end}}
        </div>
    </header>
    {{if .Data.HasDocument}}
    {{with .Data.Document}}
    {{if .seo_description}}
    <aside class="article-summary-box" id="articleSummaryBox" itemprop="description" aria-label="{{T "docs_summary_aria"}}">
        <div class="article-summary-box__head">
            <i class='bx bx-notepad' aria-hidden="true"></i>
            <span class="article-summary-box__label">{{T "docs_summary_label"}}</span>
        </div>
        <div class="article-summary-box__body">
            <p class="article-summary-box__text">{{.seo_description}}</p>
        </div>
    </aside>
    {{else}}
    <aside class="article-summary-box" id="articleSummaryBox" style="display: none;" aria-label="{{T "docs_summary_aria"}}"></aside>
    {{end}}
    {{else}}
    <aside class="article-summary-box" id="articleSummaryBox" style="display: none;" aria-label="{{T "docs_summary_aria"}}"></aside>
    {{end}}
    {{else}}
    <aside class="article-summary-box" id="articleSummaryBox" style="display: none;" aria-label="{{T "docs_summary_aria"}}"></aside>
    {{end}}
    {{if .Data.ShareBarEnabled}}
    <section class="doc-share-bar" id="docShareBar"{{if not .Data.HasDocument}} style="display:none;" hidden{{end}} aria-label="{{T "docs_page_share_aria"}}">
        <div class="doc-share-bar-inner">
        <div class="doc-share-bar-h5-panel" id="docShareBarPanel">
        <div class="doc-share-icons" role="group" aria-label="{{T "docs_page_share_social_aria"}}">
            {{if index .Data.SharePlatforms "link"}}<button type="button" class="doc-share-icon-btn doc-share-icon--link" id="docShareCopyLinkBtn" data-platform="link" title="{{T "docs_page_share_link"}}" aria-label="{{T "docs_page_share_link"}}"><i class='bx bx-link' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "qrcode"}}<button type="button" class="doc-share-icon-btn doc-share-icon--qrcode" id="docShareQrBtn" data-platform="qrcode" title="{{T "docs_page_share_qrcode"}}" aria-label="{{T "docs_page_share_qrcode"}}"><svg class="doc-share-svg-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" aria-hidden="true"><rect x="3" y="3" width="7" height="7" rx="1"></rect><rect x="14" y="3" width="7" height="7" rx="1"></rect><rect x="3" y="14" width="7" height="7" rx="1"></rect><rect x="14" y="14" width="3" height="3"></rect><rect x="18" y="14" width="3" height="3"></rect><rect x="14" y="18" width="3" height="3"></rect><rect x="18" y="18" width="3" height="3"></rect></svg></button>{{end}}
            {{if index .Data.SharePlatforms "email"}}<button type="button" class="doc-share-icon-btn doc-share-icon--email" id="docShareEmailBtn" data-platform="email" title="{{T "docs_page_share_email"}}" aria-label="{{T "docs_page_share_email"}}"><i class='bx bx-envelope' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "native"}}<button type="button" class="doc-share-icon-btn doc-share-icon--native" id="docShareNativeBtn" data-platform="native" title="{{T "docs_page_share_native"}}" aria-label="{{T "docs_page_share_native"}}" hidden><i class='bx bx-share-alt' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "whatsapp"}}<button type="button" class="doc-share-icon-btn doc-share-icon--whatsapp" data-platform="whatsapp" title="{{T "docs_page_share_whatsapp"}}" aria-label="{{T "docs_page_share_whatsapp"}}"><i class='bx bxl-whatsapp' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "telegram"}}<button type="button" class="doc-share-icon-btn doc-share-icon--telegram" data-platform="telegram" title="{{T "docs_page_share_telegram"}}" aria-label="{{T "docs_page_share_telegram"}}"><i class='bx bxl-telegram' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "facebook"}}<button type="button" class="doc-share-icon-btn doc-share-icon--facebook" data-platform="facebook" title="{{T "docs_page_share_facebook"}}" aria-label="{{T "docs_page_share_facebook"}}"><i class='bx bxl-facebook' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "x"}}<button type="button" class="doc-share-icon-btn doc-share-icon--x" data-platform="x" title="{{T "docs_page_share_x"}}" aria-label="{{T "docs_page_share_x"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--x" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M14.234 10.162L22.977 0h-2.072l-7.591 8.824L7.251 0H.258l9.168 13.343L.258 24H2.33l8.016-9.318L16.749 24h6.993zm-2.837 3.299l-.929-1.329L3.076 1.56h3.182l5.965 8.532l.929 1.329l7.754 11.09h-3.182z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "linkedin"}}<button type="button" class="doc-share-icon-btn doc-share-icon--linkedin" data-platform="linkedin" title="{{T "docs_page_share_linkedin"}}" aria-label="{{T "docs_page_share_linkedin"}}"><i class='bx bxl-linkedin' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "pinterest"}}<button type="button" class="doc-share-icon-btn doc-share-icon--pinterest" data-platform="pinterest" title="{{T "docs_page_share_pinterest"}}" aria-label="{{T "docs_page_share_pinterest"}}"><i class='bx bxl-pinterest' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "reddit"}}<button type="button" class="doc-share-icon-btn doc-share-icon--reddit" data-platform="reddit" title="{{T "docs_page_share_reddit"}}" aria-label="{{T "docs_page_share_reddit"}}"><i class='bx bxl-reddit' aria-hidden="true"></i></button>{{end}}
            {{if index .Data.SharePlatforms "threads"}}<button type="button" class="doc-share-icon-btn doc-share-icon--threads" data-platform="threads" title="{{T "docs_page_share_threads"}}" aria-label="{{T "docs_page_share_threads"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--threads" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12.186 24h-.007c-3.581-.024-6.334-1.205-8.184-3.509C2.35 18.44 1.5 15.586 1.472 12.01v-.017c.03-3.579.879-6.43 2.525-8.482C5.845 1.205 8.6.024 12.18 0h.014c2.746.02 5.043.725 6.826 2.098 1.677 1.29 2.858 3.13 3.509 5.467l-2.04.569c-1.104-3.96-3.898-5.984-8.304-6.015-2.91.022-5.11.936-6.54 2.717C4.307 6.504 3.616 8.914 3.589 12c.027 3.086.718 5.496 2.057 7.164 1.43 1.783 3.631 2.698 6.54 2.717 2.623-.02 4.358-.631 5.8-2.045 1.647-1.613 1.618-3.593 1.09-4.798-.31-.71-.873-1.3-1.634-1.75-.192 1.352-.622 2.446-1.284 3.272-.886 1.102-2.14 1.704-3.73 1.79-1.202.065-2.361-.218-3.259-.801-1.063-.689-1.685-1.74-1.752-2.964-.065-1.19.408-2.285 1.33-3.082.88-.76 2.119-1.207 3.583-1.291a13.853 13.853 0 0 1 3.02.142c-.126-.742-.375-1.332-.75-1.757-.513-.586-1.308-.883-2.359-.89h-.029c-.844 0-1.992.232-2.721 1.32L7.734 7.847c.98-1.454 2.568-2.256 4.478-2.256h.044c3.194.02 5.097 1.975 5.287 5.388.108.046.216.094.321.142 1.49.7 2.58 1.761 3.154 3.07.797 1.82.871 4.79-1.548 7.158-1.85 1.81-4.094 2.628-7.277 2.65Zm1.003-11.69c-.242 0-.487.007-.739.021-1.836.103-2.98.946-2.916 2.143.067 1.256 1.452 1.839 2.784 1.767 1.224-.065 2.818-.543 3.086-3.71a10.5 10.5 0 0 0-2.215-.221z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "bluesky"}}<button type="button" class="doc-share-icon-btn doc-share-icon--bluesky" data-platform="bluesky" title="{{T "docs_page_share_bluesky"}}" aria-label="{{T "docs_page_share_bluesky"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--bluesky" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 10.8c-1.087-2.114-4.046-6.053-6.798-7.995C2.566.944 1.561 1.266.902 1.565.139 1.908 0 3.08 0 3.768c0 .69.378 5.65.624 6.479.815 2.736 3.713 3.66 6.383 3.364.136-.02.275-.039.415-.056-.138.022-.276.04-.415.056-3.912.58-7.387 2.005-2.83 7.078 5.013 5.19 6.87-1.113 7.823-4.308.953 3.195 2.05 9.497 7.823 4.308 4.267-4.193 1.211-6.49-2.691-7.078a8.741 8.741 0 0 1-.415-.056c.14.017.279.036.415.056 2.67.297 5.568-.628 6.383-3.364.246-.828.624-5.788.624-6.478 0-.69-.139-1.861-.902-2.203-.659-.298-1.664-.62-4.3 1.24C16.046 4.747 13.087 8.686 12 10.8z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "hackernews"}}<button type="button" class="doc-share-icon-btn doc-share-icon--hackernews" data-platform="hackernews" title="{{T "docs_page_share_hackernews"}}" aria-label="{{T "docs_page_share_hackernews"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--hackernews" viewBox="0 0 192 192" fill="currentColor" aria-hidden="true"><path d="m57 47h15l24 50 24-50h15l-33 62v40h-12v-40z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "wechat"}}<button type="button" class="doc-share-icon-btn doc-share-icon--wechat" data-platform="wechat" title="{{T "docs_page_share_wechat"}}" aria-label="{{T "docs_page_share_wechat"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--wechat" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M9.5 4C5.36 4 2 6.69 2 10.08c0 1.95 1.03 3.68 2.63 4.86L3.5 18.5l3.6-1.8c.97.27 1.99.42 3.04.42.41 0 .81-.03 1.19-.08-.28-.88-.43-1.8-.43-2.76 0-3.39 3.36-6.08 7.5-6.08.76 0 1.49.1 2.17.28C16.12 5.92 13.02 4 9.5 4zM7 8.5a1 1 0 110-2 1 1 0 010 2zm5 0a1 1 0 110-2 1 1 0 010 2zm4.5 3.5c-3.59 0-6.5 2.37-6.5 5.29S13.41 22.5 17 22.5c.94 0 1.84-.17 2.67-.47l2.58 1.29-.68-2.79c1.15-.92 1.93-2.28 1.93-3.84 0-2.92-2.91-5.29-6.5-5.29zm-2.5 3a.875.875 0 110-1.75.875.875 0 010 1.75zm5 0a.875.875 0 110-1.75.875.875 0 010 1.75z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "qq"}}<button type="button" class="doc-share-icon-btn doc-share-icon--qq" data-platform="qq" title="{{T "docs_page_share_qq"}}" aria-label="{{T "docs_page_share_qq"}}"><span class="doc-share-icon-letter" aria-hidden="true">Q</span></button>{{end}}
            {{if index .Data.SharePlatforms "qzone"}}<button type="button" class="doc-share-icon-btn doc-share-icon--qzone" data-platform="qzone" title="{{T "docs_page_share_qzone"}}" aria-label="{{T "docs_page_share_qzone"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--qzone" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M23.987 9.201c-.032-.099-.127-.223-.334-.258S16.3 7.537 16.3 7.537s-.105-.022-.198-.07c-.092-.047-.127-.167-.127-.167S12.447.954 12.349.768C12.25.58 12.104.53 12 .53s-.25.05-.349.238C11.553.954 8.025 7.3 8.025 7.3s-.036.12-.129.167c-.092.047-.197.07-.197.07S.555 8.907.347 8.942c-.208.036-.302.16-.333.258a.48.48 0 0 0 .125.45L5.5 15.14s.072.08.12.172c.015.104.004.21.004.21s-1.189 7.243-1.22 7.451a.46.46 0 0 0 .16.43c.082.062.232.106.42.013c.19-.093 6.813-3.261 6.813-3.261s.098-.044.201-.061s.201.06.201.06s6.624 3.17 6.813 3.262c.188.094.338.05.421-.013a.46.46 0 0 0 .16-.43l-.93-5.678c.875-.54 1.424-1.039 1.848-1.747c-2.594.97-6.007 1.717-9.416 1.866c-.915.041-2.41.097-3.473-.015c-.679-.07-1.17-.144-1.244-.438c-.053-.215.054-.46.545-.83l2.862-2.156c1.285-.968 3.56-2.47 3.56-2.732c0-.285-2.145-.78-4.038-.78c-1.945 0-2.276.131-2.812.167c-.488.034-.769.005-.804-.138c-.06-.248.183-.389.588-.568c.71-.314 1.86-.594 1.985-.626c.194-.052 3.082-.805 5.618-.535c1.319.14 3.245.668 3.245 1.276c0 .342-1.721 1.495-3.226 2.598c-1.149.843-2.217 1.56-2.217 1.688c0 .342 3.534 1.241 6.69 1.01l.003-.022c.048-.092.12-.172.12-.172l5.362-5.49a.48.48 0 0 0 .127-.45"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "weibo"}}<button type="button" class="doc-share-icon-btn doc-share-icon--weibo" data-platform="weibo" title="{{T "docs_page_share_weibo"}}" aria-label="{{T "docs_page_share_weibo"}}"><svg class="doc-share-svg-icon doc-share-svg-icon--weibo" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M10.098 20.323c-3.977.391-7.414-1.406-7.672-4.02c-.259-2.609 2.759-5.047 6.74-5.441c3.979-.394 7.413 1.404 7.671 4.018c.259 2.6-2.759 5.049-6.737 5.439zM9.05 17.219c-.384.616-1.208.884-1.829.602c-.612-.279-.793-.991-.406-1.593c.379-.595 1.176-.861 1.793-.601c.622.263.82.972.442 1.592m1.27-1.627c-.141.237-.449.353-.689.253c-.236-.09-.313-.361-.177-.586c.138-.227.436-.346.672-.24c.239.09.315.36.18.601zm.176-2.719c-1.893-.493-4.033.45-4.857 2.118c-.836 1.704-.026 3.591 1.886 4.21c1.983.64 4.318-.341 5.132-2.179c.8-1.793-.201-3.642-2.161-4.149m7.563-1.224c-.346-.105-.57-.18-.405-.615c.375-.977.42-1.804 0-2.404c-.781-1.112-2.915-1.053-5.364-.03c0 0-.766.331-.571-.271c.376-1.217.315-2.224-.27-2.809c-1.338-1.337-4.869.045-7.888 3.08C1.309 10.87 0 13.273 0 15.348c0 3.981 5.099 6.395 10.086 6.395c6.536 0 10.888-3.801 10.888-6.82c0-1.822-1.547-2.854-2.915-3.284zm1.908-5.092a3.1 3.1 0 0 0-2.96-.962a.786.786 0 0 0-.616.932a.79.79 0 0 0 .932.602a1.51 1.51 0 0 1 1.442.465c.376.421.466.977.316 1.473a.786.786 0 0 0 .51.992a.813.813 0 0 0 .992-.512a3.11 3.11 0 0 0-.646-3.035zm2.418-2.195c-1.576-1.757-3.905-2.419-6.054-1.968a.91.91 0 0 0-.706 1.081a.91.91 0 0 0 1.082.707a4.5 4.5 0 0 1 4.296 1.383a4.53 4.53 0 0 1 .947 4.416a.91.91 0 0 0 .586 1.157c.479.165.991-.104 1.157-.586a6.39 6.39 0 0 0-1.338-6.235z"></path></svg></button>{{end}}
            {{if index .Data.SharePlatforms "tieba"}}<button type="button" class="doc-share-icon-btn doc-share-icon--tieba" data-platform="tieba" title="{{T "docs_page_share_tieba"}}" aria-label="{{T "docs_page_share_tieba"}}"><span class="doc-share-icon-letter" aria-hidden="true">贴</span></button>{{end}}
            {{if index .Data.SharePlatforms "douban"}}<button type="button" class="doc-share-icon-btn doc-share-icon--douban" data-platform="douban" title="{{T "docs_page_share_douban"}}" aria-label="{{T "docs_page_share_douban"}}"><span class="doc-share-icon-letter" aria-hidden="true">豆</span></button>{{end}}
        </div>
        <div class="doc-reading-tools doc-share-reading-tools">
        <div class="doc-share-font-size-tools article-font-size-tools article-font-size-tools--compact" id="docShareFontSizeTools" role="group" aria-label="{{T "docs_font_size_aria"}}">
            <button type="button" class="article-font-size-btn js-font-size-dec" title="{{T "docs_font_size_decrease"}}" aria-label="{{T "docs_font_size_decrease"}}">
                <span class="article-font-size-btn-label">A</span><i class='bx bx-minus' aria-hidden="true"></i>
            </button>
            <button type="button" class="article-font-size-reset js-font-size-reset" title="{{T "docs_font_size_reset"}}" aria-label="{{T "docs_font_size_reset"}}">
                <span class="js-font-size-value">100%</span>
            </button>
            <button type="button" class="article-font-size-btn js-font-size-inc" title="{{T "docs_font_size_increase"}}" aria-label="{{T "docs_font_size_increase"}}">
                <span class="article-font-size-btn-label">A</span><i class='bx bx-plus' aria-hidden="true"></i>
            </button>
        </div>
        <button type="button" class="doc-content-view-btn js-doc-print" title="{{T "docs_action_print"}}" aria-label="{{T "docs_action_print"}}">
            <i class='bx bx-printer' aria-hidden="true"></i>
        </button>
        <button type="button" class="doc-content-view-btn js-content-view-toggle" title="{{T "docs_content_view_maximize"}}" aria-label="{{T "docs_content_view_maximize"}}" aria-pressed="false">
            <i class='bx bx-fullscreen' aria-hidden="true"></i>
        </button>
        </div>
        </div>
        <span class="doc-share-icons-divider doc-share-font-size-divider" aria-hidden="true"></span>
        <span class="doc-share-icons-divider doc-share-actions-divider" aria-hidden="true"></span>
        <div class="doc-share-stat-actions" id="docShareStatActionsSlot"></div>
        <button type="button" class="doc-share-bar-h5-toggle js-share-bar-h5-toggle" aria-expanded="false" aria-controls="docShareBarPanel" title="{{T "docs_page_share_tools_expand"}}" aria-label="{{T "docs_page_share_tools_expand"}}">
            <i class='bx bx-share-alt' aria-hidden="true"></i>
            <span class="doc-share-bar-h5-toggle-label">{{T "docs_page_share_tools"}}</span>
            <i class='bx bx-chevron-down js-share-bar-h5-toggle-icon' aria-hidden="true"></i>
        </button>
        </div>
    </section>
    {{end}}
    <div class="article-content" id="articleContent"{{if .Data.HasDocument}} itemprop="articleBody"{{end}}>
        {{if .Data.HasDocument}}
        {{with .Data.Document}}
        {{if .content_html}}
        <div class="article-content-rendered">{{.content_html | safeHTML}}</div>
        {{else if .content_md}}
        <script type="application/json" id="doc-md-data">{{.content_md | json}}</script>
        <div class="article-content-rendered" data-markdown-from="doc-md-data"></div>
        {{else if .content}}
        <script type="application/json" id="doc-md-data">{{.content | json}}</script>
        <div class="article-content-rendered" data-markdown-from="doc-md-data"></div>
        {{else}}
        <div class="article-empty"><p class="text-muted">{{T "docs_doc_empty"}}</p></div>
        {{end}}
        {{end}}
        {{else if .Data.ShowNavHint}}
        <div class="docs-nav-hint">
            <div class="docs-nav-hint-inner">
                <div class="docs-nav-hint-brand">
                    <h2 class="docs-nav-slogan">{{T "docs_nav_slogan"}}</h2>
                    <p class="docs-nav-slogan-sub">{{T "docs_nav_slogan_sub"}}</p>
                </div>
                <div class="docs-nav-hint-figure" aria-hidden="true">
                    <i class='bx bx-file-blank docs-nav-hint-doc-icon'></i>
                </div>
                <p class="docs-nav-hint-text">{{T "docs_nav_pick_hint"}}</p>
                <p class="docs-nav-hint-arrow" aria-hidden="true"><i class='bx bx-left-arrow-alt'></i></p>
            </div>
        </div>
        {{else}}
        <div class="welcome-content">
            <div class="text-center py-5">
                <i class='bx bx-book-open display-1 bx-lg mb-4'></i>
                <h2>Welcome to {{.SiteName}}</h2>
                <p class="lead">Select a project or document from the sidebar to get started.</p>
            </div>
        </div>
        {{end}}
    </div>
    <nav class="article-navigation" id="articleNavigation" hidden aria-label="{{T "docs_nav_aria"}}">
        <div class="nav-item nav-prev" id="articleNavPrev"></div>
        <div class="nav-item nav-next" id="articleNavNext"></div>
    </nav>
    <section class="doc-comments-section" id="docCommentsSection" style="display:none;" aria-label="{{T "docs_comments_title"}}">
        <div class="doc-comments-header">
            <h3 class="doc-comments-title"><i class='bx bx-message-square-dots'></i> {{T "docs_comments_title"}} <span class="doc-comments-count" id="docCommentCount">0</span></h3>
        </div>
        <p class="doc-comments-disabled text-muted" id="docCommentsDisabled" style="display:none;"></p>
        <p class="doc-comments-login text-muted small" id="docCommentsLoginHint" style="display:none;"></p>
        <div id="docCommentsFormWrap" style="display:none;">
            <div class="doc-comments-form">
                <input type="text" name="website" id="docCommentHoneypot" class="doc-comment-honeypot" tabindex="-1" autocomplete="off" aria-hidden="true">
                <div id="docCommentReplyBar" class="doc-comment-reply-bar" style="display:none;">
                    <div class="doc-comment-reply-bar-inner">
                        <i class='bx bx-reply'></i>
                        <span class="doc-comment-reply-bar-text" id="docCommentReplyBarText"></span>
                        <button type="button" class="doc-comment-reply-cancel" id="btnDocCommentCancelReply" title="{{T "docs_comments_cancel_reply"}}"><i class='bx bx-x'></i></button>
                    </div>
                </div>
                <textarea class="form-control" id="docCommentInput" rows="3" maxlength="2000" placeholder="{{T "docs_comments_placeholder"}}"></textarea>
                <div class="doc-comments-form-actions" id="docCommentsFormActions">
                    <div class="doc-comment-captcha-wrap is-collapsed" id="docCommentCaptchaWrap">
                        <input type="text" class="form-control form-control-sm doc-comment-captcha-input" id="docCommentCaptcha" maxlength="4" placeholder="{{T "docs_comments_captcha_placeholder"}}" autocomplete="off">
                        <input type="hidden" id="docCommentCaptchaKey" value="">
                        <button type="button" class="doc-comment-captcha-box" id="docCommentCaptchaBox" title="{{T "docs_comments_captcha_refresh"}}">
                            <img id="docCommentCaptchaImg" src="" alt="{{T "docs_comments_captcha_alt"}}" style="display:none;">
                            <span class="doc-comment-captcha-loading" id="docCommentCaptchaLoading">{{T "docs_comments_captcha_loading"}}</span>
                        </button>
                    </div>
                    <button type="button" class="btn btn-primary btn-sm" id="btnDocCommentSubmit">{{T "docs_comments_submit"}}</button>
                </div>
            </div>
        </div>
        <div class="doc-comments-list" id="docCommentsList"></div>
    </section>
    {{if and .Data.HasDocument .Data.SEO .Data.SEO.FullURL}}<link itemprop="url" href="{{.Data.SEO.FullURL}}">{{end}}
    {{end}}{{/* end !HomePortal */}}
</article>
<div class="modal fade" id="docShareQrModal" tabindex="-1" aria-labelledby="docShareQrModalTitle" aria-hidden="true">
    <div class="modal-dialog modal-dialog-centered doc-share-modal">
        <div class="modal-content">
            <div class="modal-header">
                <h5 class="modal-title" id="docShareQrModalTitle">{{T "docs_page_share_qr_title"}}</h5>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{T "docs_report_cancel"}}"></button>
            </div>
            <div class="modal-body doc-share-modal__body">
                <div class="doc-share-qr-wrap">
                    <div class="doc-share-qr-canvas" aria-hidden="true"></div>
                </div>
                <p class="doc-share-qr-hint">{{T "docs_page_share_qr_hint"}}</p>
            </div>
        </div>
    </div>
</div>
<div class="modal fade" id="docShareWechatModal" tabindex="-1" aria-labelledby="docShareWechatModalTitle" aria-hidden="true">
    <div class="modal-dialog modal-dialog-centered doc-share-modal">
        <div class="modal-content">
            <div class="modal-header">
                <h5 class="modal-title" id="docShareWechatModalTitle">{{T "docs_page_share_wechat_title"}}</h5>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{T "docs_report_cancel"}}"></button>
            </div>
            <div class="modal-body doc-share-modal__body">
                <div class="doc-share-qr-wrap doc-share-qr-wrap--wechat">
                    <div class="doc-share-qr-canvas" aria-hidden="true"></div>
                </div>
                <p class="doc-share-qr-hint">{{T "docs_page_share_wechat_hint"}}</p>
            </div>
        </div>
    </div>
</div>
{{if .Data.UserLoggedIn}}
<div class="modal fade" id="docReportModal" tabindex="-1" aria-labelledby="docReportModalTitle" aria-hidden="true">
    <div class="modal-dialog modal-dialog-centered">
        <div class="modal-content user-form-modal user-project-modal">
            <div class="modal-header user-project-modal__header">
                <div class="user-project-modal__title-wrap">
                    <span class="user-project-modal__icon" aria-hidden="true"><i class='bx bx-flag'></i></span>
                    <h5 class="modal-title" id="docReportModalTitle">{{T "docs_report_title"}}</h5>
                </div>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{T "docs_report_cancel"}}"></button>
            </div>
            <div class="modal-body user-project-modal__body">
                <input type="hidden" id="docReportDocId" value="">
                <div class="row g-3">
                    <div class="col-12">
                        <label class="form-label user-project-modal__label" for="docReportReason">{{T "docs_report_reason"}} <span class="text-danger">*</span></label>
                        <select class="form-select" id="docReportReason">
                            <option value="spam">{{T "docs_report_reason_spam"}}</option>
                            <option value="illegal">{{T "docs_report_reason_illegal"}}</option>
                            <option value="abuse">{{T "docs_report_reason_abuse"}}</option>
                            <option value="copyright">{{T "docs_report_reason_copyright"}}</option>
                            <option value="misinfo">{{T "docs_report_reason_misinfo"}}</option>
                            <option value="other">{{T "docs_report_reason_other"}}</option>
                        </select>
                    </div>
                    <div class="col-12">
                        <label class="form-label user-project-modal__label" for="docReportDetail">{{T "docs_report_detail"}}</label>
                        <textarea class="form-control" id="docReportDetail" rows="4" placeholder="{{T "docs_report_detail_placeholder"}}" maxlength="1000"></textarea>
                    </div>
                </div>
            </div>
            <div class="modal-footer user-project-modal__footer">
                <button type="button" class="btn btn-outline-secondary" data-bs-dismiss="modal">{{T "docs_report_cancel"}}</button>
                <button type="button" class="btn btn-primary user-project-modal__save" id="docReportSubmitBtn">
                    <i class='bx bx-check'></i> {{T "docs_report_submit"}}
                </button>
            </div>
        </div>
    </div>
</div>
{{end}}
{{end}}

{{define "toc-nav"}}
<!-- TOC内容将由JavaScript动态生成 -->
{{end}}

{{define "scripts"}}
<script src="{{asset "/static/js/mermaid.min.js"}}"></script>
<script src="{{asset "/template/default/assets/js/mermaid-render.js"}}"></script>
<script src="{{asset "/static/viewer/viewer-jquery.min.js"}}"></script>
<script src="{{asset "/template/default/assets/js/sd-image-viewer.js"}}"></script>
<script>
window.DocsCommentConfig = {
    globalEnabled: {{if .Data.CommentsGlobalEnabled}}true{{else}}false{{end}},
    auditEnabled: {{if .Data.CommentAuditEnabled}}true{{else}}false{{end}},
    userCanComment: {{if .Data.UserCanComment}}true{{else}}false{{end}},
    userLoggedIn: {{if .Data.UserLoggedIn}}true{{else}}false{{end}}
};
window.DocsShareConfig = {
    barEnabled: {{if .Data.ShareBarEnabled}}true{{else}}false{{end}},
    platforms: {{if .Data.SharePlatforms}}{{json .Data.SharePlatforms}}{{else}}{}{{end}}
};
</script>
{{if .Data.NeedRestart}}
<script>
(function () {
    var token = {{json .Data.NeedRestartToken}};
    if (!token) return;
    var storageKey = 'sd_restart_prompt_dismissed';
    try {
        if (localStorage.getItem(storageKey) === String(token)) return;
    } catch (e) {}

    var title = {{json .Data.NeedRestartTitle}};
    var body = {{json .Data.NeedRestartBody}};
    var btnText = {{json .Data.NeedRestartBtn}};

    function dismiss() {
        try { localStorage.setItem(storageKey, String(token)); } catch (e) {}
    }

    function showRestartPrompt() {
        if (window.BootstrapModal && typeof BootstrapModal.open === 'function') {
            var contentHtml = '<p style="margin:0;line-height:1.7;white-space:pre-wrap;">' +
                BootstrapModal.escapeHtml(body || '') + '</p>';
            BootstrapModal.open({
                title: BootstrapModal.escapeHtml(title || ''),
                content: contentHtml,
                btn: [btnText || 'OK'],
                shadeClose: false,
                area: ['480px', 'auto'],
                yes: function (index) {
                    dismiss();
                    BootstrapModal.close(index);
                },
                end: function () {
                    dismiss();
                }
            });
            return;
        }
        window.alert((title || '') + '\n\n' + (body || ''));
        dismiss();
    }

    if (document.readyState === 'loading') {
        document.addEventListener('DOMContentLoaded', function () {
            setTimeout(showRestartPrompt, 200);
        });
    } else {
        setTimeout(showRestartPrompt, 200);
    }
})();
</script>
{{end}}
<script>
// 全局变量
let currentProject = null;
let currentDocument = null;
let tocItems = [];
var serverShowNavHint = {{if .Data.ShowNavHint}}true{{else}}false{{end}};
var serverHomePortal = {{if .Data.HomePortal}}true{{else}}false{{end}};
var serverDefaultDirectory = {{if .Data.Directory}}{{json .Data.Directory}}{{else}}''{{end}};

// 目录映射列表（动态从 API 获取）
let DIRECTORY_MAPPINGS = [];

// 待高亮的文档信息（用于页面加载时的高亮）
let pendingHighlightDoc = {
    docId: null,
    shortId: null,
    directory: null,
    categorySlug: null,
    docPath: null
};

function resolveDefaultDirectoryFromList(directories, preferred) {
    if (preferred) {
        return preferred;
    }
    if (!directories || directories.length === 0) {
        return '';
    }
    var latest = directories[0];
    directories.forEach(function(dir) {
        var currentID = parseInt(dir.id, 10) || 0;
        var latestID = parseInt(latest.id, 10) || 0;
        if (currentID > latestID) {
            latest = dir;
        }
    });
    return latest.path_prefix || latest.slug || '';
}

function isDocsHomepage(pathname) {
    const path = (pathname || window.location.pathname || '').replace(/\/+$/, '');
    return path === '';
}

function setPendingHighlightFromDoc(doc, directory) {
    if (!doc) return;
    pendingHighlightDoc.docId = doc.id || null;
    pendingHighlightDoc.shortId = doc.short_id || null;
    pendingHighlightDoc.directory = doc.public_directory || directory || null;
    pendingHighlightDoc.categorySlug = resolveDocNavCategoryPath(doc);
    pendingHighlightDoc.docPath = null;
}

function resolveDocNavCategoryPath(doc) {
    if (!doc) return null;
    var navPath = String(doc.nav_category_path || '').trim().replace(/^\/+|\/+$/g, '');
    if (navPath) return navPath;
    var userCat = String(doc.user_category_slug || '').trim().replace(/^\/+|\/+$/g, '');
    if (userCat) return userCat;
    if (String(doc.category_type || '') === '1' || doc.category_type === 1) {
        var projectSlug = String(doc.project_slug || '').trim().replace(/^\/+|\/+$/g, '');
        if (projectSlug) return projectSlug;
    }
    return null;
}

function setPendingHighlightFromCategoryPath(directory, categoryPath) {
    pendingHighlightDoc.docId = null;
    pendingHighlightDoc.shortId = null;
    pendingHighlightDoc.directory = directory || null;
    pendingHighlightDoc.categorySlug = (categoryPath || '').replace(/^\/+|\/+$/g, '') || null;
    pendingHighlightDoc.docPath = pendingHighlightDoc.categorySlug;
}

function setMetaTag(name, content, isProperty) {
    if (!content) return;
    const attr = isProperty ? 'property' : 'name';
    let el = document.querySelector('meta[' + attr + '="' + name + '"]');
    if (!el) {
        el = document.createElement('meta');
        el.setAttribute(attr, name);
        document.head.appendChild(el);
    }
    el.setAttribute('content', content);
}

function updateDocumentSEOMeta(doc) {
    if (!doc) return;
    const siteName = {{json .SiteName}};
    const title = doc.title || '';
    if (title) {
        document.title = title + ' - ' + siteName;
    }
    const desc = doc.seo_description || doc.description || '';
    setMetaTag('description', desc, false);
    setMetaTag('abstract', desc, false);
    setMetaTag('summary', desc, false);
    setMetaTag('og:title', title, true);
    setMetaTag('og:description', desc, true);
    setMetaTag('og:type', 'article', true);
    if (doc.url) {
        const fullUrl = window.location.origin + doc.url;
        setMetaTag('og:url', fullUrl, true);
        let canonical = document.querySelector('link[rel="canonical"]');
        if (!canonical) {
            canonical = document.createElement('link');
            canonical.rel = 'canonical';
            document.head.appendChild(canonical);
        }
        canonical.href = fullUrl;
    }
}

function clearDocumentBreadcrumbs() {
    const $ = window.jQuery || window.$;
    $('#docsArticle > .docs-breadcrumb').remove();
}

function renderDocumentBreadcrumbs(doc) {
    const $ = window.jQuery || window.$;
    if (!doc) {
        clearDocumentBreadcrumbs();
        return;
    }

    const breadcrumbs = doc.breadcrumbs;
    clearDocumentBreadcrumbs();
    if (!breadcrumbs || !breadcrumbs.length) {
        return;
    }

    const ariaLabel = docsT('breadcrumbAria', 'Breadcrumb');
    let html = '<nav class="docs-breadcrumb" aria-label="' + escapeHtml(ariaLabel) + '">';
    html += '<ol class="docs-breadcrumb-list" itemscope itemtype="https://schema.org/BreadcrumbList">';

    breadcrumbs.forEach(function(bc, i) {
        const name = bc.name || '';
        const url = bc.url || '';
        const isLast = i === breadcrumbs.length - 1;
        const isHome = i === 0 && isDocsBreadcrumbHomeUrl(url);
        html += '<li class="docs-breadcrumb-item" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">';
        if (!isLast && url) {
            html += '<a href="' + escapeHtml(url) + '" itemprop="item" class="docs-breadcrumb-link' + (isHome ? ' docs-breadcrumb-link--home' : '') + '">';
            if (isHome) {
                html += buildDocsBreadcrumbHomeIconHtml();
            }
            html += '<span itemprop="name">' + escapeHtml(name) + '</span></a>';
        } else {
            html += '<span itemprop="name">' + escapeHtml(name) + '</span>';
        }
        html += '<meta itemprop="position" content="' + (i + 1) + '">';
        html += '</li>';
    });

    html += '</ol></nav>';

    const $article = $('#docsArticle');
    const $banner = $article.children('.audit-preview-banner').first();
    if ($banner.length) {
        $banner.after(html);
    } else {
        $article.prepend(html);
    }
}

function formatDocumentTimestamp(ts) {
    if (!ts) return '';
    const n = parseInt(ts, 10);
    if (!n || n <= 0) return '';
    const d = new Date(n * 1000);
    if (isNaN(d.getTime())) return '';
    const pad = function(v) { return v < 10 ? '0' + v : '' + v; };
    return d.getFullYear() + '-' + pad(d.getMonth() + 1) + '-' + pad(d.getDate());
}

function toDocumentISO8601(ts) {
    if (!ts) return '';
    const n = parseInt(ts, 10);
    if (!n || n <= 0) return '';
    const d = new Date(n * 1000);
    return isNaN(d.getTime()) ? '' : d.toISOString();
}

// HTML 转义（全局，供 IIFE 外 renderDocumentMeta / renderDocumentSummary 使用）
function escapeHtml(text) {
    if (text === null || text === undefined) return '';
    const div = document.createElement('div');
    div.textContent = String(text);
    return div.innerHTML;
}

// GitHub / 常见 Markdown 预览兼容的标题 slug（如 #9-收益账变与提现）
function slugifyHeading(text) {
    return String(text || '')
        .trim()
        .toLowerCase()
        // 保留字母数字、CJK、空格与连字符，去掉标点（含「.」「、」等）
        .replace(/[^\w\u4e00-\u9fff\u3400-\u4dbf\u3040-\u30ff\uac00-\ud7af\s-]/gu, '')
        .replace(/\s+/g, '-')
        .replace(/-+/g, '-')
        .replace(/^-|-$/g, '');
}

// 文档标题锚点滚动偏移（顶栏 + 置顶分享栏）
function getDocsHeadingScrollOffset() {
    var root = document.documentElement;
    var topNav = 50;
    var shareBar = 0;
    var pad = 12;
    if (document.body.classList.contains('docs-content-maximized')) {
        topNav = 0;
    } else {
        var raw = getComputedStyle(root).getPropertyValue('--top-nav-height');
        var parsed = parseInt(raw, 10);
        if (!isNaN(parsed) && parsed > 0) {
            topNav = parsed;
        }
    }
    var $bar = $('#docShareBar');
    if ($bar.length && $bar.is(':visible') && $('#docsArticle').hasClass('docs-article-detail')) {
        shareBar = $bar.outerHeight() || 0;
        if (shareBar <= 0) {
            raw = getComputedStyle(root).getPropertyValue('--sidebar-topcat-height');
            parsed = parseInt(raw, 10);
            if (!isNaN(parsed) && parsed > 0) {
                shareBar = parsed;
            } else {
                shareBar = 50;
            }
        }
    }
    return topNav + shareBar + pad;
}

// 安全获取带特殊字符 id 的元素（中文锚点等）
// 兼容：goldmark 剥中文后的 id（如 7-）与 GitHub 风格 id（如 7-用户管理与日志）
function getHeadingElementById(id) {
    if (!id) return null;
    try {
        id = decodeURIComponent(String(id).replace(/^#/, ''));
    } catch (e) {
        id = String(id).replace(/^#/, '');
    }
    if (!id) return null;

    var el = document.getElementById(id);
    if (el) return el;

    var matched = null;
    $('#articleContent h1, #articleContent h2, #articleContent h3, #articleContent h4, #articleContent h5, #articleContent h6').each(function() {
        var hid = String(this.id || '').trim();
        var textSlug = slugifyHeading($(this).text() || '');
        if ((hid && hid === id) || (textSlug && textSlug === id)) {
            matched = this;
            return false;
        }
        // hash 为完整中文，元素仍是截断 id（7-）
        if (hid && id.indexOf(hid) === 0 && /-$/.test(hid) && id.length > hid.length) {
            matched = this;
            return false;
        }
        // hash 为截断 id，元素已是完整中文 id
        if (id && hid.indexOf(id) === 0 && /-$/.test(id) && hid.length > id.length) {
            matched = this;
            return false;
        }
    });
    return matched;
}

// 滚动到 URL hash / 指定标题锚点（内容异步渲染后需手动定位）
function scrollToHeadingAnchor(hash, options) {
    options = options || {};
    const smooth = options.smooth !== false;
    const delay = typeof options.delay === 'number' ? options.delay : 0;
    let id = hash || (window.location.hash || '');
    if (!id) return false;
    id = String(id).replace(/^#/, '');
    try {
        id = decodeURIComponent(id);
    } catch (e) {
        // keep as-is
    }
    if (!id) return false;

    const doScroll = function() {
        const el = getHeadingElementById(id);
        if (!el) return false;

        const offsetTop = $(el).offset().top - getDocsHeadingScrollOffset();
        $('html, body').stop(true).animate({
            scrollTop: Math.max(0, offsetTop)
        }, smooth ? 300 : 0);
        // 同步 TOC 高亮
        if (typeof tocItems !== 'undefined' && tocItems.length) {
            const item = tocItems.find(function(t) { return t.id === id; });
            if (item) {
                $('.toc-link').removeClass('active');
                $('.toc-link').filter(function() {
                    let hrefId = ($(this).attr('href') || '').replace(/^#/, '');
                    try {
                        hrefId = decodeURIComponent(hrefId);
                    } catch (e) {
                        // keep as-is
                    }
                    return hrefId === id;
                }).addClass('active');
            }
        }
        return true;
    };

    if (delay > 0) {
        setTimeout(doScroll, delay);
        return true;
    }
    return doScroll();
}

// 文字划词分享等需保留的 hash 前缀
function shouldPreserveDocumentHash(hash) {
    hash = hash || window.location.hash || '';
    return hash.indexOf('#hl=') === 0;
}

// 切换文档时回到顶部，并清除上一篇文档遗留的 TOC 锚点
function resetDocumentViewScroll(options) {
    options = options || {};
    window.scrollTo(0, 0);
    if (window.jQuery) {
        window.jQuery('html, body').scrollTop(0);
    }
    const tocEl = document.getElementById('docsToc');
    if (tocEl) {
        tocEl.scrollTop = 0;
    }
    if (window.jQuery) {
        window.jQuery('.toc-link').removeClass('active');
    }
    if (!options.preserveHash && !shouldPreserveDocumentHash() && window.location.hash) {
        const url = window.location.pathname + window.location.search;
        if (history.replaceState) {
            history.replaceState(null, '', url);
        }
    }
}

function docsT(key, fallback) {
    return (window.DocsI18n && window.DocsI18n[key]) || fallback || '';
}

const DOCS_SITE_NAME = {{json .SiteName}};

function getDocsSiteName() {
    return DOCS_SITE_NAME || '{{if .ProductName}}{{.ProductName}}{{else}}{{.SiteName}}{{end}}';
}

function isDocsBreadcrumbHomeUrl(url) {
    if (!url) return false;
    if (url === '/') return true;
    try {
        const parsed = new URL(url, window.location.origin);
        const path = (parsed.pathname || '/').replace(/\/+$/, '') || '/';
        return path === '/';
    } catch (e) {
        return false;
    }
}

function buildDocsBreadcrumbHomeIconHtml() {
    return '<i class="bx bx-home-alt docs-breadcrumb-home-icon" aria-hidden="true"></i>';
}

function buildCategoryBreadcrumbNavHtml(crumbs) {
    const ariaLabel = docsT('breadcrumbAria', 'Breadcrumb');
    let html = '<nav class="docs-breadcrumb category-docs-breadcrumb" aria-label="' + escapeHtml(ariaLabel) + '">';
    html += '<ol class="docs-breadcrumb-list">';
    crumbs.forEach(function(crumb) {
        html += '<li class="docs-breadcrumb-item">';
        if (crumb.current) {
            html += '<span>' + escapeHtml(crumb.name) + '</span>';
        } else if (crumb.href) {
            const homeClass = crumb.home ? ' docs-breadcrumb-link--home' : '';
            html += '<a href="' + escapeHtml(crumb.href) + '" class="docs-breadcrumb-link' + homeClass + '">';
            if (crumb.home) {
                html += buildDocsBreadcrumbHomeIconHtml();
            }
            html += '<span>' + escapeHtml(crumb.name) + '</span></a>';
        } else {
            html += '<a href="javascript:;" class="docs-breadcrumb-link category-breadcrumb-link" data-directory="' +
                escapeHtml(crumb.directory) + '" data-subpath="' + escapeHtml(crumb.subpath || '') + '">' +
                '<span>' + escapeHtml(crumb.name) + '</span></a>';
        }
        html += '</li>';
    });
    html += '</ol></nav>';
    return html;
}

// 拼接分类子路径
function joinCategorySubpath(baseSubpath, segment) {
    const base = (baseSubpath || '').replace(/^\/+|\/+$/g, '');
    const seg = (segment || '').replace(/^\/+|\/+$/g, '');
    if (!base) return seg;
    if (!seg) return base;
    return base + '/' + seg;
}

function buildCategoryBreadcrumbCrumbs(directory, dirName, subpath, sectionName) {
    const crumbs = [{
        name: getDocsSiteName(),
        href: '/',
        home: true
    }];
    if (!subpath) {
        crumbs.push({ name: dirName, current: true });
        return crumbs;
    }
    crumbs.push({
        name: dirName,
        directory: directory,
        subpath: ''
    });
    const segments = subpath.split('/').filter(function(s) { return s; });
    let accumulated = '';
    segments.forEach(function(seg, idx) {
        accumulated = joinCategorySubpath(accumulated, seg);
        const isLast = idx === segments.length - 1;
        crumbs.push({
            name: isLast ? sectionName : seg,
            directory: directory,
            subpath: isLast ? null : accumulated,
            current: isLast
        });
    });
    return crumbs;
}

function buildReadingToolsHtml() {
    return '<div class="doc-reading-tools">' +
        '<div class="article-font-size-tools" id="articleFontSizeTools" role="group" aria-label="' + escapeHtml(docsT('fontSizeAria', 'Text size')) + '">' +
            '<button type="button" class="article-font-size-btn js-font-size-dec" title="' + escapeHtml(docsT('fontSizeDecrease', 'Decrease text size')) + '" aria-label="' + escapeHtml(docsT('fontSizeDecrease', 'Decrease text size')) + '">' +
            '<span class="article-font-size-btn-label">A</span><i class="bx bx-minus" aria-hidden="true"></i></button>' +
            '<button type="button" class="article-font-size-reset js-font-size-reset" title="' + escapeHtml(docsT('fontSizeReset', 'Reset text size (100%)')) + '" aria-label="' + escapeHtml(docsT('fontSizeReset', 'Reset text size (100%)')) + '">' +
            '<span class="js-font-size-value">100%</span></button>' +
            '<button type="button" class="article-font-size-btn js-font-size-inc" title="' + escapeHtml(docsT('fontSizeIncrease', 'Increase text size')) + '" aria-label="' + escapeHtml(docsT('fontSizeIncrease', 'Increase text size')) + '">' +
            '<span class="article-font-size-btn-label">A</span><i class="bx bx-plus" aria-hidden="true"></i></button>' +
        '</div>' +
        '<button type="button" class="doc-content-view-btn js-doc-print" title="' + escapeHtml(docsT('actionPrint', 'Print')) + '" aria-label="' + escapeHtml(docsT('actionPrint', 'Print')) + '">' +
            '<i class="bx bx-printer" aria-hidden="true"></i></button>' +
        '<button type="button" class="doc-content-view-btn js-content-view-toggle" title="' + escapeHtml(docsT('contentViewMaximize', 'Expand reading area')) + '" aria-label="' + escapeHtml(docsT('contentViewMaximize', 'Expand reading area')) + '" aria-pressed="false">' +
            '<i class="bx bx-fullscreen" aria-hidden="true"></i></button>' +
        '</div>';
}

function renderDocumentMeta(doc) {
    if (!doc) return;
    const $ = window.jQuery || window.$;

    const publishedTs = doc.published_at || doc.created_at || 0;
    const publishedISO = toDocumentISO8601(publishedTs);
    const publishedDisplay = formatDocumentTimestamp(publishedTs);
    const authorName = (doc.author_name || '').trim();
    const viewCount = doc.view_count != null ? doc.view_count : 0;
    const likeCount = doc.like_count != null ? doc.like_count : 0;
    const favoriteCount = doc.favorite_count != null ? doc.favorite_count : 0;
    const commentCount = doc.comment_count != null ? doc.comment_count : 0;
    const publishedTitle = docsT('metaPublished', 'Published');
    const likeLabel = docsT('actionLike', 'Like');
    const favoriteLabel = docsT('actionFavorite', 'Save');
    const commentLabel = docsT('actionComment', 'Comments');
    const reportLabel = docsT('actionReport', 'Report');
    const userLoggedIn = !!(window.DocsCommentConfig && window.DocsCommentConfig.userLoggedIn);

    let statsHtml = '';
    if (publishedDisplay) {
        statsHtml += '<time class="stat-item" datetime="' + escapeHtml(publishedISO) + '" itemprop="datePublished" title="' + escapeHtml(publishedTitle) + '">' +
            '<i class="bx bx-calendar"></i><span class="stat-value">' + escapeHtml(publishedDisplay) + '</span></time>';
    }
    if (authorName) {
        statsHtml += '<span class="stat-item" itemprop="author" itemscope itemtype="https://schema.org/Person">' +
            '<i class="bx bx-user"></i><span class="stat-value" itemprop="name">' + escapeHtml(authorName) + '</span></span>';
    }
    statsHtml += '<span class="stat-item" id="viewCount"><i class="bx bx-show"></i><span class="stat-value">' +
        escapeHtml(String(viewCount)) + '</span></span>';
    statsHtml += '<button type="button" class="stat-item stat-item-action stat-item-comment" id="commentCount" title="' + escapeHtml(commentLabel) + '" aria-label="' + escapeHtml(commentLabel) + '">' +
        '<i class="bx bx-message-square-dots"></i><span class="stat-value">' +
        escapeHtml(String(commentCount)) + '</span></button>';

    let actionsHtml =
        '<button type="button" class="stat-item stat-item-action stat-item-like" id="btnLike" title="' + escapeHtml(likeLabel) + '" aria-label="' + escapeHtml(likeLabel) + '">' +
        '<i class="bx bx-like"></i><span class="stat-value">' + escapeHtml(String(likeCount)) + '</span></button>' +
        '<button type="button" class="stat-item stat-item-action stat-item-favorite" id="btnFavorite" title="' + escapeHtml(favoriteLabel) + '" aria-label="' + escapeHtml(favoriteLabel) + '">' +
        '<i class="bx bx-star"></i><span class="stat-value">' + escapeHtml(String(favoriteCount)) + '</span></button>';
    if (userLoggedIn) {
        actionsHtml +=
            '<button type="button" class="stat-item stat-item-action stat-item-report" id="btnReport" title="' + escapeHtml(reportLabel) + '" aria-label="' + escapeHtml(reportLabel) + '">' +
            '<i class="bx bx-flag"></i></button>';
    }

    $('#docShareStatActionsSlot .article-stat-actions').remove();

    $('#articleMeta').html(
        '<div class="article-stats">' + statsHtml + '</div>' +
        buildReadingToolsHtml() +
        '<div class="article-stat-actions">' + actionsHtml + '</div>'
    ).show();
    if (window.DocFontSize && typeof window.DocFontSize.refreshControls === 'function') {
        window.DocFontSize.refreshControls();
    }
    if (window.DocContentView && typeof window.DocContentView.syncButtons === 'function') {
        window.DocContentView.syncButtons();
    }
    if (window.DocPageShare && typeof window.DocPageShare.syncStatActions === 'function') {
        window.DocPageShare.syncStatActions($('#docShareBar').hasClass('is-stuck'));
    }
}

function renderDocumentSummary(doc) {
    const $ = window.jQuery || window.$;
    const summary = ((doc && (doc.seo_description || doc.description)) || '').trim();
    const summaryLabel = docsT('summaryLabel', 'Summary');
    const summaryAria = docsT('summaryAria', 'Page summary');
    let $box = $('#articleSummaryBox');

    if (!summary) {
        if ($box.length) {
            $box.hide().empty();
        }
        return;
    }

    if ($box.length === 0) {
        $box = $('<aside class="article-summary-box" id="articleSummaryBox" itemprop="description"></aside>');
        $box.attr('aria-label', summaryAria);
        $('#articleContent').before($box);
    }

    $box.html(
        '<div class="article-summary-box__head">' +
        '<i class="bx bx-notepad" aria-hidden="true"></i>' +
        '<span class="article-summary-box__label">' + escapeHtml(summaryLabel) + '</span></div>' +
        '<div class="article-summary-box__body">' +
        '<p class="article-summary-box__text">' + escapeHtml(summary) + '</p></div>'
    ).attr('aria-label', summaryAria).show();
}

function hideArticleNavigation() {
    const $ = window.jQuery || window.$;
    $('#articleNavigation').attr('hidden', 'hidden').css('display', '');
    $('#articleNavPrev, #articleNavNext').empty();
}

function buildArticleNavLink(item, type) {
    const label = type === 'prev'
        ? docsT('navPrev', 'Previous')
        : docsT('navNext', 'Next');
    const icon = type === 'prev' ? 'bx-chevron-left' : 'bx-chevron-right';
    const rel = type === 'prev' ? 'prev' : 'next';
    const url = (item && item.url) ? item.url : '';
    const title = (item && (item.title || item.name)) ? (item.title || item.name) : '';
    if (!url) {
        return '';
    }
    return '<a href="' + escapeHtml(url) + '" class="nav-link" rel="' + rel + '" title="' + escapeHtml(title) + '">' +
        '<i class="bx ' + icon + '" aria-hidden="true"></i>' +
        '<span class="nav-content">' +
        '<span class="nav-label">' + escapeHtml(label) + '</span>' +
        '<span class="nav-title" title="' + escapeHtml(title) + '">' + escapeHtml(title) + '</span>' +
        '</span></a>';
}

function renderDocumentArticleNavigation(prev, next) {
    const $ = window.jQuery || window.$;
    const $nav = $('#articleNavigation');
    const $prev = $('#articleNavPrev');
    const $next = $('#articleNavNext');

    $prev.empty();
    $next.empty();

    if (!prev && !next) {
        hideArticleNavigation();
        return;
    }

    if (prev && prev.url) {
        $prev.html(buildArticleNavLink(prev, 'prev'));
    }
    if (next && next.url) {
        $next.html(buildArticleNavLink(next, 'next'));
    }

    if (!$prev.children().length && !$next.children().length) {
        hideArticleNavigation();
        return;
    }

    $nav.removeAttr('hidden').css('display', '');
}

function loadDocumentArticleNavigation(doc) {
    const $ = window.jQuery || window.$;
    if (!doc || !doc.id) {
        hideArticleNavigation();
        return;
    }

    let docIDStr = doc.short_id || doc.id;
    if (typeof docIDStr === 'number') {
        docIDStr = String(docIDStr);
    }

    const directory = doc.public_directory || (typeof pendingHighlightDoc !== 'undefined' && pendingHighlightDoc.directory) || (typeof currentDirectory !== 'undefined' ? currentDirectory : '') || '';
    const params = directory ? { directory: directory } : {};

    $.ajax({
        url: '/api/documents/' + encodeURIComponent(docIDStr) + '/navigation',
        type: 'GET',
        dataType: 'json',
        data: params,
        success: function(res) {
            if (res.success && res.data) {
                renderDocumentArticleNavigation(res.data.prev || null, res.data.next || null);
            } else {
                hideArticleNavigation();
            }
        },
        error: function() {
            hideArticleNavigation();
        }
    });
}

// 确保 jQuery 可用，避免 $ 冲突
(function($) {
    'use strict';
    
    // 检查 jQuery 是否加载
    if (typeof $ === 'undefined' || typeof jQuery === 'undefined') {
        console.error('jQuery 未加载！');
        return;
    }
    
    // 确保 $ 指向 jQuery
    if ($ !== jQuery) {
        console.warn('$ 与 jQuery 不一致，可能存在冲突');
        $ = jQuery;
    }
    
$(document).ready(function() {
    // 初始化文档系统
    initDocsSystem();

    // 响应式处理
    handleResponsive();
    
    // 全局文档链接点击事件（路径型 URL）
    $(document).on('click', '.nav-item.doc .nav-link, .article-navigation .nav-link', function(e) {
        const $link = $(this);
        const href = $link.attr('href');
        if (!href || href.indexOf('javascript:') === 0) {
            return;
        }
        const parsed = parsePublicDocPath(href);
        if (parsed) {
            e.preventDefault();
            resetDocumentViewScroll();
            loadDocumentByPublicPath(parsed.directory, parsed.docPath);
            $('.nav-link').removeClass('active');
            $link.addClass('active');
            history.pushState(null, '', href);
            return;
        }
        const location = parseDocLocationFromPath(href);
        if (location && location.mode === 'id') {
            e.preventDefault();
            resetDocumentViewScroll();
            loadDocumentByID(location.docId);
            $('.nav-link').removeClass('active');
            $link.addClass('active');
            history.pushState(null, '', href);
        }
    });
    
    // hover 事件已直接在代码块上绑定，不需要全局事件
});

// 对路径各段分别编码，保留 / 分隔符（支持中文）
function encodePathSegments(path) {
    if (!path) return '';
    return path.split('/').map(function(part) {
        return encodeURIComponent(part);
    }).join('/');
}

// 解码路径各段
function decodePathSegments(path) {
    if (!path) return '';
    return path.split('/').map(function(part) {
        try { return decodeURIComponent(part); } catch (e) { return part; }
    }).join('/');
}

// 渲染侧栏公共分类标题（仅展示，不可点击）
function renderNavSectionTitle(directory, displayName, iconClass) {
    const iconCls = normalizeNavIconClass(iconClass, 'bx-folder');
    return `<div class="nav-section-title" title="${escapeHtml(displayName)}">` +
        `<i class='${iconCls}'></i>` +
        `<span>${escapeHtml(displayName)}</span>` +
        `</div>`;
}

// 渲染侧栏分类无内容提示（带图标）
function renderNavEmptyStateHtml() {
    const text = docsT('navCategoryEmpty', 'Nothing here yet');
    const hint = docsT('navCategoryEmptyHint', 'No pages or subfolders in this category');
    return '<li class="nav-section-empty"' + (hint ? ' title="' + escapeHtml(hint) + '"' : '') + '>' +
        '<span class="nav-section-empty-inner">' +
        '<i class="bx bx-info-circle" aria-hidden="true"></i>' +
        '<span class="nav-section-empty-text">' + escapeHtml(text) + '</span>' +
        '</span></li>';
}

// 渲染公共分类根区块（无子项时也保留分类标题与空状态提示）
function renderDirectoryNavSectionShell(directory, listInnerHtml) {
    const displayName = getDirectoryDisplayName(directory);
    const iconClass = directoryIconMap[directory] || 'bx-folder';
    const inner = listInnerHtml || renderNavEmptyStateHtml();
    return '<div class="nav-section">' +
        renderNavSectionTitle(directory, displayName, iconClass) +
        '<ul class="nav-list">' + inner + '</ul>' +
        '</div>';
}

// 获取公共分类展示名称（优先数据库 name/alias，其次 slug）
function getDirectoryDisplayName(directory) {
    if (!directory) {
        return '';
    }
    let decodedDirectory = directory;
    try {
        decodedDirectory = decodeURIComponent(directory);
    } catch (e) {
        decodedDirectory = directory;
    }
    const dirInfo = findDirectoryInfo(cachedDirectoriesList, directory);
    if (dirInfo) {
        return dirInfo.alias || dirInfo.name || decodedDirectory;
    }
    return directoryAliasMap[directory] || decodedDirectory;
}

// 预加载公共分类映射后再执行回调
function ensureDirectoryMapsLoaded(callback) {
    if (cachedDirectoriesList.length > 0) {
        if (callback) {
            callback();
        }
        return;
    }
    $.ajax({
        url: '/api/directories',
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success && res.data) {
                applyDirectoryMaps(getVisibleDirectories(res.data.list || []));
            }
            if (callback) {
                callback();
            }
        },
        error: function() {
            if (callback) {
                callback();
            }
        }
    });
}

// 分类页（如 /doc）直接渲染该公共分类下的文档树
function loadNavigationForDirectory(directory) {
    ensureDirectoryMapsLoaded(function() {
        loadDirectoryNavigation(directory);
    });
}

// 将 slug 拆分为子目录路径与文档名（子目录在 short_id 之前）
function splitDocumentSlugForSEOURL(slug) {
    slug = (slug || '').replace(/\.(md|markdown)$/i, '').replace(/^\/+|\/+$/g, '');
    if (!slug) {
        return { parentPath: '', docName: '' };
    }
    const idx = slug.lastIndexOf('/');
    if (idx >= 0) {
        return { parentPath: slug.substring(0, idx), docName: slug.substring(idx + 1) };
    }
    return { parentPath: '', docName: slug };
}

// 构建文档 SEO URL：根级 /{dir}/{short_id}/{slug}；含子目录 /{dir}/{parent}/{short_id}/{name}
function buildDocumentSEOPath(directory, shortID, slug) {
    const dir = encodeURIComponent(directory || 'doc');
    if (!shortID) {
        return '/' + dir;
    }
    const parts = splitDocumentSlugForSEOURL(slug);
    if (parts.parentPath) {
        let url = '/' + dir + '/' + encodePathSegments(parts.parentPath) + '/' + encodeURIComponent(shortID);
        if (parts.docName) {
            url += '/' + encodePathSegments(parts.docName);
        }
        return url;
    }
    let url = '/' + dir + '/' + encodeURIComponent(shortID);
    if (parts.docName) {
        url += '/' + encodePathSegments(parts.docName);
    }
    return url;
}

// 构建文档 SEO URL：/{公共分类}/{short_id}/{slug}（不含用户分类 slug）
function buildDocPublicUrl(directory, item) {
    if (item && item.url) {
        return item.url;
    }
    const shortID = (item && item.short_id) || '';
    if (shortID) {
        let slug = (item && (item.slug || item.path)) || '';
        if (slug && directory && slug.startsWith(directory + '/')) {
            slug = slug.substring(directory.length + 1);
        }
        const categorySlug = (item && (item.category_slug || item.project_slug)) || '';
        if (categorySlug && slug && (item.category_type === 1 || item.is_user_category)) {
            if (slug === categorySlug) {
                slug = '';
            } else if (slug.startsWith(categorySlug + '/')) {
                slug = slug.substring(categorySlug.length + 1);
            }
        }
        return buildDocumentSEOPath(directory, shortID, slug);
    }
    let relPath = (item && (item.path || item.slug)) || '';
    if (relPath && directory && relPath.startsWith(directory + '/')) {
        relPath = relPath.substring(directory.length + 1);
    }
    const categorySlug = (item && (item.category_slug || item.project_slug)) || '';
    if (categorySlug && relPath && (item.category_type === 1 || item.is_user_category)) {
        if (relPath === categorySlug) {
            relPath = '';
        } else if (relPath.startsWith(categorySlug + '/')) {
            relPath = relPath.substring(categorySlug.length + 1);
        }
    }
    if (!relPath) {
        return '/' + encodeURIComponent(directory || 'doc');
    }
    return '/' + encodeURIComponent(directory || 'doc') + '/' + encodePathSegments(relPath);
}

// 从当前页面路径解析目录与文档相对路径
function isLikelyDocumentIDSegment(seg) {
    if (!seg) return false;
    if (/^\d+$/.test(seg)) return true;
    if (seg.length >= 9 && /^[0-9a-zA-Z]+$/.test(seg)) return true;
    return false;
}

function findDocumentIDSegmentIndex(pathParts) {
    if (pathParts.length < 2) {
        return -1;
    }
    function decodeSeg(seg) {
        try { return decodeURIComponent(seg); } catch (e) { return seg; }
    }
    if (isLikelyDocumentIDSegment(decodeSeg(pathParts[1]))) {
        return 1;
    }
    for (let i = 1; i < pathParts.length; i++) {
        if (isLikelyDocumentIDSegment(decodeSeg(pathParts[i]))) {
            return i;
        }
    }
    return -1;
}

function parseDocLocationFromPath(pathname) {
    const pathParts = pathname.split('/').filter(function(p) { return p; });
    if (pathParts.length < 2) {
        return null;
    }
    let directory = pathParts[0];
    try { directory = decodeURIComponent(pathParts[0]); } catch (e) {}

    function decodeSeg(seg) {
        try { return decodeURIComponent(seg); } catch (e) { return seg; }
    }

    const idIndex = findDocumentIDSegmentIndex(pathParts);
    if (idIndex > 0) {
        const docId = decodeSeg(pathParts[idIndex]);
        const docSlug = idIndex + 1 < pathParts.length
            ? decodePathSegments(pathParts.slice(idIndex + 1).join('/'))
            : '';
        return { mode: 'id', directory: directory, docId: docId, docSlug: docSlug };
    }

    return { mode: 'path', directory: directory, docPath: decodePathSegments(pathParts.slice(1).join('/')) };
}

function parsePublicDocPath(pathname) {
    const location = parseDocLocationFromPath(pathname);
    if (!location || location.mode !== 'path') {
        return null;
    }
    return { directory: location.directory, docPath: location.docPath };
}

function loadDocumentByID(docId, updateURL, options) {
    if (typeof updateURL === 'undefined') {
        updateURL = true;
    }
    options = options || {};
    resetDocumentViewScroll({ preserveHash: !!options.preserveHash });
    const apiUrl = '/api/documents/' + encodeURIComponent(docId);

    if (window.DocComments && typeof window.DocComments.hide === 'function') {
        window.DocComments.hide();
    }

    $('#articleContent').html(
        '<div class="article-loading"><div class="text-center py-5">' +
        '<div class="spinner-border text-primary" role="status"><span class="visually-hidden">Loading...</span></div>' +
        '<p class="mt-3 text-muted">Loading document...</p></div></div>'
    );

    $.ajax({
        url: apiUrl,
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success && res.data) {
                renderDocument(res.data, options);
                if (updateURL && res.data.url) {
                    history.pushState(null, '', res.data.url);
                }
            } else {
                showNavPickHint(null, '');
            }
        },
        error: function() {
            showNavPickHint(null, '');
        }
    });
}

function loadDocumentFromLocation(location, updateURL, options) {
    if (!location) return;
    options = options || {};
    if (location.mode === 'id') {
        loadDocumentByID(location.docId, updateURL, options);
        return;
    }
    loadDocumentByPublicPath(location.directory, location.docPath, updateURL, options);
}

// 通过公共路径加载文档
function loadDocumentByPublicPath(directory, docPath, updateURL, options) {
    if (typeof updateURL === 'undefined') {
        updateURL = true;
    }
    options = options || {};
    resetDocumentViewScroll({ preserveHash: !!options.preserveHash });
    const encodedDirectory = encodeURIComponent(directory);
    const encodedDocPath = encodePathSegments(docPath);
    const apiUrl = '/api/documents/directory/' + encodedDirectory + '/' + encodedDocPath;
    const displayUrl = '/' + encodedDirectory + '/' + encodedDocPath;

    if (window.DocComments && typeof window.DocComments.hide === 'function') {
        window.DocComments.hide();
    }

    $('#articleContent').html(
        '<div class="article-loading"><div class="text-center py-5">' +
        '<div class="spinner-border text-primary" role="status"><span class="visually-hidden">Loading...</span></div>' +
        '<p class="mt-3 text-muted">Loading document...</p></div></div>'
    );

    $.ajax({
        url: apiUrl,
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success && res.data) {
                renderDocument(res.data, options);
                if (updateURL) {
                    const finalUrl = res.data.url || displayUrl;
                    history.pushState(null, '', finalUrl);
                }
            } else {
                setPendingHighlightFromCategoryPath(directory, docPath);
                showCategoryLanding(directory, docPath);
                resolvePendingNavHighlight();
            }
        },
        error: function(xhr, status, error) {
            setPendingHighlightFromCategoryPath(directory, docPath);
            showCategoryLanding(directory, docPath);
            resolvePendingNavHighlight();
        }
    });
}

// 首页无正文时：显示导航选择提示（不发起 index.md 请求，避免卡在 Loading）
function loadHomepageDefaultContent(directory) {
    showNavPickHint(directory || '', '');
}

// 初始化文档系统
function initDocsSystem() {
    const path = window.location.pathname;
    const urlParams = new URLSearchParams(window.location.search);
    let docLocation = parseDocLocationFromPath(path);
    
    let currentDirectory = null;
    let shouldLoadDoc = false;
    
    if (docLocation) {
        currentDirectory = docLocation.directory;
        shouldLoadDoc = true;
    } else {
        const pathParts = path.split('/').filter(function(p) { return p; });
        if (pathParts.length >= 1 && pathParts[0] !== '') {
            let firstPart = pathParts[0];
            try {
                firstPart = decodeURIComponent(firstPart);
            } catch (e) {}
            if (firstPart !== 'api' && firstPart !== 'static' && firstPart !== 'template') {
                currentDirectory = firstPart;
            }
        }
    }
    
    // 保存当前文档信息，用于导航栏加载完成后高亮
    {{if .Data.HasDocument}}
    var ssrDocumentMeta = null;
    try {
        ssrDocumentMeta = {{if .Data.DocumentSSRMeta}}{{.Data.DocumentSSRMeta | json}}{{else}}null{{end}};
    } catch (e) {
        ssrDocumentMeta = null;
    }
    try {
        setPendingHighlightFromDoc(ssrDocumentMeta, currentDirectory);
        if (ssrDocumentMeta && ssrDocumentMeta.public_directory) {
            currentDirectory = ssrDocumentMeta.public_directory;
        }
    } catch (e) {}
    {{else}}
    if (shouldLoadDoc && docLocation) {
        pendingHighlightDoc.directory = currentDirectory;
        if (docLocation.mode === 'path') {
            pendingHighlightDoc.docPath = docLocation.docPath || null;
            if (docLocation.docPath) {
                pendingHighlightDoc.categorySlug = docLocation.docPath.replace(/^\/+|\/+$/g, '');
            }
        } else if (docLocation.mode === 'id') {
            pendingHighlightDoc.shortId = docLocation.docId;
            if (docLocation.docSlug) {
                const slugParts = docLocation.docSlug.split('/').filter(function(p) { return p; });
                if (slugParts.length > 0) {
                    pendingHighlightDoc.categorySlug = slugParts[0];
                }
            }
        }
    }
    {{end}}
    
    // 检查查询参数中的 doc_path（用于自动加载 index.md）
    const queryDocPath = urlParams.get('doc_path');
    const queryDocId = urlParams.get('doc_id');
    if (queryDocPath && currentDirectory && !shouldLoadDoc) {
        shouldLoadDoc = true;
        docLocation = { mode: 'path', directory: currentDirectory, docPath: queryDocPath };
        setTimeout(function() {
            loadDocumentByPublicPath(currentDirectory, queryDocPath, false);
        }, 100);
    } else if (queryDocId && currentDirectory && !shouldLoadDoc) {
        shouldLoadDoc = true;
        docLocation = { mode: 'id', directory: currentDirectory, docId: queryDocId };
        setTimeout(function() {
            loadDocumentByID(queryDocId, false);
        }, 100);
    }
    
    // 加载导航结构（首页门户模式已 SSR，跳过 AJAX 展开默认分类）
    if (!serverHomePortal) {
        loadNavigation(currentDirectory, isDocsHomepage(path));
    }
    
    // 检查页面是否已经通过服务端渲染了文档内容
    var hasServerRenderedDoc = false;
    var serverRenderedDoc = null;
    {{if .Data.HasDocument}}
    hasServerRenderedDoc = true;
    serverRenderedDoc = ssrDocumentMeta;
    {{end}}
    
    // 如果已经通过服务端渲染，初始化文档相关功能（TOC、代码复制等）
    if (hasServerRenderedDoc && serverRenderedDoc) {
        // 将地址栏同步为规范 URL（与左侧导航链接一致）
        if (serverRenderedDoc.url) {
            const canonicalPath = serverRenderedDoc.url.replace(/\/$/, '');
            const currentPath = window.location.pathname.replace(/\/$/, '');
            if (canonicalPath && canonicalPath !== currentPath) {
                // 保留 #hl= 文字定位 hash，避免分享链接失效
                history.replaceState(null, '', serverRenderedDoc.url + (window.location.hash || ''));
            }
        }
        // 等待 highlight.js 加载完成后再初始化
        const initServerRenderedDoc = function() {
            if (typeof initDocumentFeatures === 'function') {
                initDocumentFeatures(serverRenderedDoc);
            } else {
                if (typeof renderDocument === 'function') {
                    renderDocument(serverRenderedDoc);
                }
            }
            // 不需要通过AJAX加载，但需要初始化导航状态和统计数据
            if (serverRenderedDoc) {
                const projectId = serverRenderedDoc.project_id || null;
                const docId = serverRenderedDoc.id || null;
                const projectSlug = serverRenderedDoc.project_slug || null;
                const shortId = serverRenderedDoc.short_id || null;
                
                // 保存文档数据到全局变量，供其他函数使用
                window.currentDocumentData = {
                    id: docId,
                    short_id: shortId,
                    project_id: projectId,
                    project_slug: projectSlug
                };
                
                // 加载文档统计数据和导航（服务端渲染时也需要）
                if (docId) {
                    // 延迟加载，确保DOM已完全渲染
                    setTimeout(function() {
                        if (typeof loadDocumentStats === 'function') {
                            // 传递 short_id 作为第二个参数
                            loadDocumentStats(docId, shortId);
                        }
                        if (typeof loadDocumentArticleNavigation === 'function') {
                            loadDocumentArticleNavigation(serverRenderedDoc);
                        }
                    }, 300);
                }
                
                // 延迟调用，等待导航栏加载完成
                setTimeout(function() {
                    highlightCurrentNavItem(
                        docId,
                        shortId,
                        serverRenderedDoc.public_directory || currentDirectory,
                        0,
                        resolveDocNavCategoryPath(serverRenderedDoc)
                    );
                }, 500);
            }
        };
        
        // 检查 highlight.js 是否已加载
        if (typeof hljs !== 'undefined') {
            // 已加载，延迟初始化确保 DOM 就绪
            setTimeout(initServerRenderedDoc, 100);
        } else {
            // 等待 highlight.js 加载（最多等待 3 秒）
            let waitCount = 0;
            const maxWait = 30; // 30 * 100ms = 3秒
            const checkInterval = setInterval(function() {
                waitCount++;
                if (typeof hljs !== 'undefined') {
                    clearInterval(checkInterval);
                    setTimeout(initServerRenderedDoc, 100);
                } else if (waitCount >= maxWait) {
                    clearInterval(checkInterval);
                    console.warn('highlight.js 加载超时，尝试初始化文档功能');
                    initServerRenderedDoc();
                }
            }, 100);
        }
    } else if (shouldLoadDoc && docLocation && serverShowNavHint) {
        if (docLocation.mode === 'path' && docLocation.docPath) {
            setTimeout(function() {
                showCategoryLanding(docLocation.directory, docLocation.docPath);
            }, 100);
        }
    } else if (shouldLoadDoc && docLocation && !serverShowNavHint) {
        setTimeout(function() {
            loadDocumentFromLocation(docLocation, true, {
                preserveHash: !!window.location.hash,
                scrollToHash: !!window.location.hash
            });
        }, 100);
    } else if (!hasServerRenderedDoc && currentDirectory && !shouldLoadDoc && !serverShowNavHint) {
        // 仅访问分类根路径（如 /doc），无默认文档时提示从侧栏选择
        setTimeout(function() {
            showNavPickHint(currentDirectory, '');
        }, 150);
    } else if (!hasServerRenderedDoc && !shouldLoadDoc && isDocsHomepage(path)) {
        if (!serverHomePortal && !serverShowNavHint) {
            setTimeout(function() {
                loadHomepageDefaultContent(serverDefaultDirectory || '');
            }, 150);
        }
    }

    // 初始化TOC生成器
    initTocGenerator();

    // 无正文时隐藏 TOC，释放右侧空间（首页、空分类页等）
    if (!hasServerRenderedDoc && !serverShowNavHint && !shouldLoadDoc) {
        generateToc('');
    }

    // 初始化滚动监听
    initScrollSpy();
}

    // 加载导航结构
    // 目录 alias 映射（用于显示导航标题）
    var directoryAliasMap = {};
    // 目录 icon 映射（用于显示导航图标）
    var directoryIconMap = {};
    var cachedDirectoriesList = [];

    function normalizeNavIconClass(iconConfig, fallback) {
        var raw = (iconConfig || fallback || 'bx-folder').trim();
        if (!raw) {
            return 'bx bx-folder';
        }
        if (raw.indexOf('bx ') === 0 || raw.indexOf('bx bx-') === 0) {
            return raw;
        }
        if (raw.indexOf('bx-') === 0) {
            return 'bx ' + raw;
        }
        return 'bx bx-' + raw;
    }

    function applyDirectoryMaps(directories) {
        cachedDirectoriesList = directories || [];
        cachedDirectoriesList.forEach(function(dir) {
            if (!dir || !dir.slug) {
                return;
            }
            if (dir.alias) {
                directoryAliasMap[dir.slug] = dir.alias;
            }
            if (dir.icon) {
                directoryIconMap[dir.slug] = dir.icon;
            }
        });
    }

    function getVisibleDirectories(directories) {
        return (directories || []).filter(function(dir) {
            return dir && dir.visible !== false;
        });
    }

    function expandDirectoryNavItem(directorySlug, loadIfEmpty) {
        if (!directorySlug) {
            return;
        }
        var $item = $('.nav-item.language-package[data-directory-slug="' + directorySlug + '"]');
        if (!$item.length) {
            return;
        }
        var $subList = $item.find('> .nav-sub-list');
        $item.addClass('expanded');
        if (loadIfEmpty && $subList.children().length === 0) {
            $subList.html('<li class="nav-loading"><i class=\'bx bx-loader-alt bx-spin\'></i><span>Loading...</span></li>').show();
            loadDirectoryNavigation(directorySlug, $subList);
        } else {
            $subList.slideDown(200);
        }
    }

    function fetchAndRenderPublicCategories(expandSlug) {
        if (cachedDirectoriesList.length > 0) {
            renderDirectoriesNavigation(cachedDirectoriesList, { expandSlug: expandSlug || '' });
            return;
        }
        $.ajax({
            url: '/api/directories',
            type: 'GET',
            dataType: 'json',
            success: function(res) {
                if (res.success && res.data) {
                    applyDirectoryMaps(getVisibleDirectories(res.data.list || []));
                    renderDirectoriesNavigation(cachedDirectoriesList, { expandSlug: expandSlug || '' });
                } else {
                    $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> No doc sets</li>');
                }
            },
            error: function() {
                $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> Load failed</li>');
            }
        });
    }
    
    // currentDirectory: 当前访问的目录映射路径（如 'doc'）；首页为 null 时加载默认分类
    const loadNavigation = function(currentDirectory, homepageMode) {
        if (!currentDirectory || currentDirectory === '') {
            if (homepageMode) {
                $.ajax({
                    url: '/api/directories',
                    type: 'GET',
                    dataType: 'json',
                    success: function(res) {
                        if (res.success && res.data) {
                            applyDirectoryMaps(getVisibleDirectories(res.data.list || []));
                            const defaultDir = resolveDefaultDirectoryFromList(
                                cachedDirectoriesList,
                                res.data.default_directory || serverDefaultDirectory
                            );
                            if (defaultDir) {
                                loadNavigationForDirectory(defaultDir);
                            } else {
                                renderDirectoriesNavigation(cachedDirectoriesList);
                            }
                        } else {
                            $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> No doc sets</li>');
                        }
                    },
                    error: function() {
                        $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> Load failed</li>');
                    }
                });
                return;
            }

            fetchAndRenderPublicCategories('');
            return;
        }

        loadNavigationForDirectory(currentDirectory);
    };

// 渲染公共分类顶级导航（支持展开/折叠子目录树）
function renderDirectoriesNavigation(directories, options) {
    options = options || {};
    directories = getVisibleDirectories(directories);
    if (!directories || directories.length === 0) {
        $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> No directories</li>');
        return;
    }

    let html = `<div class="nav-section">
        <ul class="nav-list">`;

    directories.forEach(dir => {
        // 优先使用 alias，如果没有则使用目录名
        let dirName = dir.alias || dir.name || dir.slug || '';
        
        try {
            // 如果名称是 URL 编码的，尝试解码
            if (!dir.alias) {
                dirName = decodeURIComponent(dirName);
            }
        } catch (e) {
            // 如果解码失败，使用原始名称
            dirName = dir.alias || dir.name || dir.slug || '';
        }
        
        const dirSlug = dir.slug || dir.path_prefix || '';
        const iconClass = normalizeNavIconClass(dir.icon, 'bx-folder');
        
        // 保存到 alias 和 icon 映射
        if (dirSlug) {
            if (dir.alias) {
                directoryAliasMap[dirSlug] = dir.alias;
            }
            if (dir.icon) {
                directoryIconMap[dirSlug] = dir.icon;
            }
        }
        
        html += `<li class="nav-item language-package" data-directory-slug="${dirSlug}">
            <a href="javascript:;" class="nav-link nav-language-toggle" data-directory-slug="${dirSlug}" title="${escapeHtml(dirName)}">
                <i class="${iconClass} nav-icon-topcat"></i>
                <span class="nav-text">${escapeHtml(dirName)}</span>
                <i class='bx bx-chevron-right arrow'></i>
            </a>
            <ul class="nav-sub-list" style="display:none"></ul>
        </li>`;
    });

    html += `</ul></div>`;
    $('#docsNav').html(html);

    // 绑定公共分类点击事件（展开/折叠，不跳转）
    $(document).off('click.language', '.nav-language-toggle').on('click.language', '.nav-language-toggle', function(e) {
        e.preventDefault();
        const $item = $(this).closest('.nav-item');
        const directorySlug = $(this).data('directory-slug');
        const $subList = $item.find('> .nav-sub-list');

        if ($item.hasClass('expanded')) {
            // 折叠当前项
            $item.removeClass('expanded');
            $subList.slideUp(200);
        } else {
            // 手风琴效果：先关闭同级其他展开的项
            $item.siblings('.nav-item.language-package.expanded').each(function() {
                $(this).removeClass('expanded');
                $(this).find('> .nav-sub-list').slideUp(200);
            });

            // 展开当前项
            $item.addClass('expanded');
            if ($subList.children().length === 0) {
                // 懒加载该分类下的子目录与文档
                $subList.html('<li class="nav-loading"><i class=\'bx bx-loader-alt bx-spin\'></i><span>Loading...</span></li>').show();
                loadDirectoryNavigation(directorySlug, $subList);
            } else {
                $subList.slideDown(200);
            }
        }
    });

    if (options.expandSlug) {
        setTimeout(function() {
            expandDirectoryNavItem(options.expandSlug, true);
        }, 0);
    }
}

// 加载目录映射的导航结构（使用文件系统API，支持手风琴效果，带回调）
// $container: 容器元素，如果为空则使用 #docsNav
// callback: 加载完成后的回调函数
function loadDirectoryNavigationWithCallback(directory, $container, callback) {
    if (!directory) {
        console.error('[loadDirectoryNavigationWithCallback] 错误: directory 参数为空');
        if ($container) {
            $container.html('<li class="nav-error"><i class="bx bx-error"></i> Invalid directory</li>');
        } else {
            $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> Invalid directory</li>');
        }
        if (callback) callback();
        return;
    }
    
    // 如果没有指定容器，使用默认容器
    if (!$container) {
        $container = $('#docsNav');
        // 清除加载提示
        $container.html('<li class="nav-loading"><i class=\'bx bx-loader-alt bx-spin\'></i><span>Loading document structure...</span></li>');
    }
    
    // 使用文件系统目录树API
    // 注意：directory 参数需要保持原始格式（可能是编码或解码的），后端会自动处理
    const apiUrl = '/api/docs/filesystem/tree';
    const apiParams = {
        directory: directory, // 使用解码后的目录名，后端会尝试多种格式匹配
        subpath: ''
    };
    
    
    // 先绑定手风琴效果事件（使用事件委托，支持动态元素）
    bindAccordionEvents(directory);
    
    // 加载根级目录树（带回调）
    loadFilesystemNavigationTreeWithCallback(apiUrl, apiParams, $container, 0, directory, callback);
}

// 加载目录映射的导航结构（使用文件系统API，支持手风琴效果）
// $container: 容器元素，如果为空则使用 #docsNav
function loadDirectoryNavigation(directory, $container) {
    loadDirectoryNavigationWithCallback(directory, $container, null);
}

// 加载文件系统导航树（支持递归加载子目录，带回调；公共分类最多三级子目录）
function loadFilesystemNavigationTreeWithCallback(apiUrl, params, $container, depth, directory, callback) {
    const maxNavDepth = 3;
    if (depth > maxNavDepth) {
        if (callback) callback();
        return;
    }
    
    $.ajax({
        url: apiUrl,
        type: 'GET',
        data: params,
        dataType: 'json',
        success: function(res) {
            if (res.success && res.data) {
                renderFilesystemNavigationTree(res.data, $container, depth, directory);
                // 移除加载提示（无论是根节点还是子节点）
                $container.find('.nav-loading').remove();
                
                // 如果是根节点加载完成，尝试高亮当前文档或分类
                if (depth === 0 && hasPendingNavHighlight()) {
                    setTimeout(function() {
                        resolvePendingNavHighlight();
                    }, 200);
                }
                
                // 调用回调函数
                if (callback) {
                    setTimeout(callback, 100);
                }
            } else {
                // 移除加载提示
                $container.find('.nav-loading').remove();
                if (depth === 0 && !$container.hasClass('nav-sub-list')) {
                    $container.html(renderDirectoryNavSectionShell(directory, ''));
                } else if (depth === 0) {
                    $container.html(renderNavEmptyStateHtml());
                } else {
                    $container.append(renderNavEmptyStateHtml());
                }
                if (callback) callback();
            }
        },
        error: function(xhr, status, error) {
            console.error('[loadFilesystemNavigationTreeWithCallback] 加载失败:', error);
            // 移除加载提示
            $container.find('.nav-loading').remove();
            if (depth === 0 && !$container.hasClass('nav-sub-list')) {
                $container.html(renderDirectoryNavSectionShell(directory, ''));
            } else if (depth === 0) {
                $container.html('<li class="nav-empty">Load failed</li>');
            } else {
                $container.append('<li class="nav-empty">Load failed</li>');
            }
            if (callback) callback();
        }
    });
}

// 加载文件系统导航树（支持递归加载子目录）
function loadFilesystemNavigationTree(apiUrl, params, $container, depth, directory) {
    loadFilesystemNavigationTreeWithCallback(apiUrl, params, $container, depth, directory, null);
}

// 渲染单个目录节点（支持 sd_directories 子分类与 slug 逻辑目录，无限级懒加载）
function buildFilesystemCategoryNavHtml(item, depth) {
    const iconClass = normalizeNavIconClass(item.icon, 'bx-folder');
    const sourceClass = item.source === 'directory' ? ' nav-category-directory' : '';
    const dirID = item.directory_id || item.id || '';
    return '<li class="nav-item category' + sourceClass + '" data-path="' + escapeHtml(item.path || '') + '" data-depth="' + depth + '"' +
        (dirID ? ' data-directory-id="' + dirID + '"' : '') + '>' +
        '<a href="javascript:;" class="nav-link nav-category-toggle">' +
        '<i class="' + iconClass + ' nav-icon-subdir"></i>' +
        '<span class="nav-text">' + escapeHtml(item.name || '') + '</span>' +
        '<i class="bx bx-chevron-right arrow"></i></a>' +
        '<ul class="nav-sub-list" style="display:none"></ul></li>';
}

function buildFilesystemDocNavHtml(item, directory) {
    const docID = item.id || 0;
    const docUrl = buildDocPublicUrl(directory, item);
    let fileIcon = item.icon || 'bx-file-blank';
    if (fileIcon.indexOf('bx ') !== 0 && fileIcon.indexOf('bx-') === 0) {
        fileIcon = 'bx ' + fileIcon;
    } else if (fileIcon.indexOf('bx ') !== 0) {
        fileIcon = 'bx bx-' + fileIcon.replace(/^bx-/, '');
    }
    const displayName = (item.name || '') + (item.file_ext || '');
    return '<li class="nav-item doc" data-id="' + docID + '" data-short-id="' + escapeHtml(item.short_id || '') + '" data-slug="' + escapeHtml(item.slug || '') + '" data-file-ext="' + escapeHtml(item.file_ext || '') + '">' +
        '<a href="' + docUrl + '" class="nav-link">' +
        '<i class="' + fileIcon + '"></i>' +
        '<span class="nav-text">' + escapeHtml(displayName) + '</span></a></li>';
}

function appendFilesystemNavItems(items, $target, depth, directory, appendMode) {
    let html = '';
    items.forEach(function(item) {
        if (item.type === 'category' && depth >= 3) {
            return;
        }
        if (item.type === 'category') {
            html += buildFilesystemCategoryNavHtml(item, depth);
        } else {
            html += buildFilesystemDocNavHtml(item, directory);
        }
    });
    if (appendMode) {
        $target.append(html);
    } else {
        $target.html(html);
    }
}

// 渲染文件系统导航树（支持无限级子目录 + 同级直挂文档）
function renderFilesystemNavigationTree(items, $container, depth, directory) {
    if (!items || items.length === 0) {
        if (depth > 0) {
            $container.append(renderNavEmptyStateHtml());
        } else if ($container.hasClass('nav-sub-list')) {
            $container.html(renderNavEmptyStateHtml());
        } else {
            $container.html(renderDirectoryNavSectionShell(directory, ''));
        }
        return;
    }

    if (depth === 0) {
        const isSubContainer = $container.hasClass('nav-sub-list');
        let listHtml = '';

        items.forEach(function(item) {
            if (item.type === 'category') {
                listHtml += buildFilesystemCategoryNavHtml(item, 1);
            } else {
                listHtml += buildFilesystemDocNavHtml(item, directory);
            }
        });

        if (!isSubContainer) {
            $container.html(renderDirectoryNavSectionShell(directory, listHtml));
        } else {
            $container.html('<ul class="nav-list">' + listHtml + '</ul>');
        }

        if (hasPendingNavHighlight()) {
            setTimeout(function() {
                resolvePendingNavHighlight();
            }, 100);
        }
        return;
    }

    $container.empty();
    appendFilesystemNavItems(items, $container, depth, directory, true);

    if (hasPendingNavHighlight()) {
        setTimeout(function() {
            resolvePendingNavHighlight();
        }, 100);
    }
}

// 绑定手风琴效果事件
function bindAccordionEvents(directory) {
    // 使用事件委托，支持动态添加的元素
    // 使用命名空间避免冲突
    $(document).off('click.accordion', '.nav-category-toggle').on('click.accordion', '.nav-category-toggle', function(e) {
        e.preventDefault();
        const $item = $(this).closest('.nav-item');
        const subpath = $item.data('path') || '';
        const depth = parseInt($item.data('depth') || 0);
        const $subList = $item.find('> .nav-sub-list');

        if ($item.hasClass('expanded')) {
            // 折叠当前项
            $item.removeClass('expanded');
            $subList.slideUp(200);
        } else {
            // 手风琴效果：先关闭同级其他展开的项
            // 找到所有同级的分类项（同一父级下的分类）
            const $parentList = $item.parent();
            $parentList.find('.nav-item.category.expanded').not($item).each(function() {
                $(this).removeClass('expanded');
                $(this).find('> .nav-sub-list').slideUp(200);
            });

            // 展开当前项
            $item.addClass('expanded');
            if ($subList.children().length === 0) {
                // 懒加载子目录与文档（无限级）
                const apiUrl = '/api/docs/filesystem/tree';
                const apiParams = {
                    directory: directory,
                    subpath: subpath
                };
                // 显示加载提示
                $subList.html('<li class="nav-loading"><i class=\'bx bx-loader-alt bx-spin\'></i><span>Loading...</span></li>').show();
                loadFilesystemNavigationTree(apiUrl, apiParams, $subList, depth + 1, directory);
            } else {
                $subList.slideDown(200);
            }
        }
    });
}

// 渲染目录映射的导航结构
function renderDirectoryNavigation(directory, projectSlug, documents) {
    if (!documents || documents.length === 0) {
        $('#docsNav').html(renderDirectoryNavSectionShell(directory, ''));
        loadDefaultContent();
        return;
    }

    // 优先使用公共分类 name/alias
    let displayName = getDirectoryDisplayName(directory);
    
    // 获取图标，优先使用配置的 icon，如果没有则使用默认的 bx-folder
    let iconClass = directoryIconMap[directory] || 'bx-folder';

    let html = `<div class="nav-section">
        ${renderNavSectionTitle(directory, displayName, iconClass)}
        <ul class="nav-list">`;

    documents.forEach(doc => {
        // 解码文档标题和 slug，支持中文等多语言
        let docTitle = doc.title || '';
        let docSlug = doc.slug || '';
        
        try {
            // 如果标题或 slug 是 URL 编码的，尝试解码
            if (docTitle) {
                docTitle = decodeURIComponent(docTitle);
            }
            if (docSlug) {
                docSlug = decodeURIComponent(docSlug);
            }
        } catch (e) {
            // 如果解码失败，使用原始值
            docTitle = doc.title || '';
            docSlug = doc.slug || '';
        }
        
        // 路径型文档链接
        // 确保 slug 不包含 directory 前缀
        if (docSlug && directory && docSlug.startsWith(directory + '/')) {
            docSlug = docSlug.substring(directory.length + 1);
        }
        const docUrl = buildDocPublicUrl(directory, doc);
        
        html += `<li class="nav-item">
            <a href="${docUrl}" class="nav-link nav-doc-link" data-doc-id="${doc.id}" data-short-id="${doc.short_id || ''}" data-project-slug="${projectSlug}" data-doc-slug="${doc.slug || ''}" title="${escapeHtml(docTitle)}">
                <i class='bx bx-file'></i>
                <span class="nav-text">${escapeHtml(docTitle)}</span>
            </a>
        </li>`;
    });

    html += `</ul></div>`;
    $('#docsNav').html(html);

    // 绑定文档点击事件
    $('.nav-doc-link').on('click', function(e) {
        e.preventDefault();
        const href = $(this).attr('href');
        const parsed = parsePublicDocPath(href);
        if (parsed) {
            loadDocumentByPublicPath(parsed.directory, parsed.docPath);
        }
        $('.nav-link').removeClass('active');
        $(this).addClass('active');
    });

    // 如果当前路径是目录根路径（没有指定具体文档），自动加载第一个文档
    const path = window.location.pathname;
    const pathParts = path.split('/').filter(p => p);
    if (pathParts.length === 1 && pathParts[0] === directory) {
        const firstDoc = documents[0];
        if (firstDoc) {
            const firstDocPath = firstDoc.slug || '';
            loadDocumentByPublicPath(directory, firstDocPath);
        }
    }
}

// 渲染导航结构
function renderNavigation(data) {
    // 兼容两种返回格式：[{}, {}] 或 {list: [{}, {}]}
    const projects = Array.isArray(data) ? data : (data && data.list ? data.list : []);
    
    if (!projects || projects.length === 0) {
        $('#docsNav').html('<li class="nav-error"><i class="bx bx-error"></i> No projects</li>');
        return;
    }

    let html = '';

    // 按分类组织项目
    const sections = {};
    projects.forEach(project => {
        const category = project.category || 'General';
        if (!sections[category]) {
            sections[category] = [];
        }
        sections[category].push(project);
    });

    // 渲染分类和项目
    Object.keys(sections).sort().forEach(category => {
        html += `<div class="nav-section">
            <div class="nav-section-title">${category}</div>
            <ul class="nav-list">`;

        sections[category].forEach(project => {
            // 解码项目名称，支持中文等多语言
            let projectName = project.name || '';
            try {
                // 如果名称是 URL 编码的，尝试解码
                projectName = decodeURIComponent(projectName);
            } catch (e) {
                // 如果解码失败，使用原始名称
                projectName = project.name || '';
            }
            
            // 确保 slug 存在且有效
            const projectSlug = (project.slug && project.slug.trim() !== '') ? project.slug : '';
            html += `<li class="nav-item">
                <a href="#" class="nav-link" data-project-id="${project.id}" data-project-slug="${projectSlug}" title="${escapeHtml(projectName)}">
                    <i class='bx bx-folder nav-icon-subdir'></i>
                    <span class="nav-text">${escapeHtml(projectName)}</span>
                    <i class='bx bx-chevron-right nav-arrow'></i>
                </a>
                <ul class="nav-list nav-docs" id="project-${project.id}-docs" style="display: none;">
                    <li class="nav-loading-small">
                        <i class='bx bx-loader-alt bx-spin'></i>
                    </li>
                </ul>
            </li>`;
        });

        html += `</ul></div>`;
    });

    $('#docsNav').html(html);

    // 绑定项目点击事件
    $('.nav-link[data-project-id]').on('click', function(e) {
        e.preventDefault();
        const projectId = $(this).data('project-id');
        const projectSlug = $(this).data('project-slug');
        toggleProjectDocs(projectId, projectSlug, $(this));
    });
}

// 切换项目文档显示
function toggleProjectDocs(projectId, projectSlug, $link) {
    const $docsList = $(`#project-${projectId}-docs`);

    if ($docsList.is(':visible')) {
        $docsList.slideUp();
        $link.removeClass('expanded');
    } else {
        // 加载项目文档（传递 slug 用于 SEO URL）
        loadProjectDocs(projectId, projectSlug);
        $link.addClass('expanded');
    }
}

// 加载项目文档
function loadProjectDocs(projectId, projectSlug) {
    const $docsList = $(`#project-${projectId}-docs`);

    // 优先使用 slug API（如果提供了有效的 projectSlug）
    // 注意：需要检查 projectSlug 是否非空且有效
    const apiUrl = (projectSlug && projectSlug.trim() !== '') 
        ? `/api/projects/slug/${projectSlug}/documents`
        : `/api/projects/${projectId}/documents`;

    $.ajax({
        url: apiUrl,
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success && res.data) {
                // 检查返回的数据格式
                if (res.data.list && Array.isArray(res.data.list)) {
                    // 传递完整的 data 对象，包含 project_slug
                    renderProjectDocs(projectId, res.data);
                } else if (Array.isArray(res.data)) {
                    // 兼容直接返回数组的情况
                    renderProjectDocs(projectId, { list: res.data });
                } else {
                    $docsList.html('<li class="nav-error-small"><i class="bx bx-error"></i> Invalid data format</li>');
                    console.error('API 返回数据格式错误:', res);
                }
            } else {
                $docsList.html('<li class="nav-error-small"><i class="bx bx-error"></i> No documents</li>');
                if (res.message) {
                }
            }
        },
        error: function(xhr, status, error) {
            $docsList.html('<li class="nav-error-small"><i class="bx bx-error"></i> Load failed</li>');
            console.error('加载项目文档失败:', {
                url: apiUrl,
                status: status,
                error: error,
                response: xhr.responseText
            });
        }
    });
}

// 渲染项目文档
function renderProjectDocs(projectId, data) {
    // 兼容两种返回格式
    const documents = Array.isArray(data) ? data : (data && data.list ? data.list : []);
    
    if (!documents || documents.length === 0) {
        $(`#project-${projectId}-docs`).html('<li class="nav-error-small"><i class="bx bx-error"></i> No documents</li>');
        return;
    }

    let html = '';

    // 获取项目信息（包含 slug）
    const projectSlug = data.project_slug || null;

    documents.forEach(doc => {
        // 解码文档标题和 slug，支持中文等多语言
        let docTitle = doc.title || '';
        let docSlug = doc.slug || '';
        
        try {
            // 如果标题或 slug 是 URL 编码的，尝试解码
            if (docTitle) {
                docTitle = decodeURIComponent(docTitle);
            }
            if (docSlug) {
                docSlug = decodeURIComponent(docSlug);
            }
        } catch (e) {
            // 如果解码失败，使用原始值
            docTitle = doc.title || '';
            docSlug = doc.slug || '';
        }
        
        const docUrl = buildDocPublicUrl(projectSlug, doc);
        
        html += `<li class="nav-item">
            <a href="${docUrl}" class="nav-link nav-doc-link" data-doc-id="${doc.id}" data-short-id="${doc.short_id || ''}" data-project-slug="${projectSlug || ''}" data-doc-slug="${doc.slug || ''}" title="${escapeHtml(docTitle)}">
                <i class='bx bx-file'></i>
                <span class="nav-text">${escapeHtml(docTitle)}</span>
            </a>
        </li>`;
    });

    $(`#project-${projectId}-docs`).html(html).slideDown();

    // 绑定文档点击事件
    $(`#project-${projectId}-docs .nav-doc-link`).on('click', function(e) {
        e.preventDefault();
        const href = $(this).attr('href');
        const parsed = parsePublicDocPath(href);
        if (parsed) {
            loadDocumentByPublicPath(parsed.directory, parsed.docPath);
        }
        $('.nav-link').removeClass('active');
        $(this).addClass('active');
    });
}

// 读取服务端注入的 Markdown 原文（JSON script，避免 attribute 换行破坏 HTML）
function readInitialMarkdownContent() {
    var $src = $('#doc-md-data');
    if (!$src.length) {
        return '';
    }
    try {
        var raw = $src.text() || $src.html() || '';
        if (!raw.trim()) {
            return '';
        }
        var parsed = JSON.parse(raw);
        return (parsed === null || parsed === undefined) ? '' : String(parsed);
    } catch (e) {
        console.warn('[readInitialMarkdownContent] parse failed:', e);
        return '';
    }
}

// 初始化服务端渲染的文档功能（TOC、代码复制等）
function initDocumentFeatures(doc) {
    // 确保使用正确的 jQuery 引用
    const $ = window.jQuery || window.$;
    
    // 更新标题（如果还没有设置）
    if (doc && doc.title) {
        $('#articleHeader').show();
        $('#articleTitle').text(doc.title);
    }

    // 获取已有的内容HTML（服务端已渲染）
    let contentHtml = '';
    const $content = $('#articleContent .article-content-rendered');
    
    if ($content.length > 0) {
        var markdownContent = readInitialMarkdownContent();
        if (!markdownContent) {
            markdownContent = $content.attr('data-markdown-content') || '';
        }
        if (markdownContent) {
            // 文档 Markdown 由管理员/作者在后台维护；marked.parse 仅渲染 Markdown，不执行用户提交的 HTML
            if (typeof marked !== 'undefined') {
                contentHtml = marked.parse(markdownContent);
            } else {
                // 简单的 Markdown 转 HTML（基础支持）
                contentHtml = simpleMarkdownToHtml(markdownContent);
            }
            // 更新内容
            $content.html(contentHtml).removeAttr('data-markdown-content').removeAttr('data-markdown-from');
            $('#doc-md-data').remove();
        } else {
            // 直接使用已有的 HTML 内容
            contentHtml = $content.html();
            // 检查内容是否在 <pre> 标签中（不应该发生，但为了兼容性）
            if (contentHtml.trim().startsWith('<pre>') && contentHtml.trim().endsWith('</pre>')) {
                // 提取 <pre> 标签内的内容
                const preContent = $content.find('pre').text();
                if (preContent) {
                    // 尝试解析为 Markdown
                    if (typeof marked !== 'undefined') {
                        contentHtml = marked.parse(preContent);
                    } else {
                        contentHtml = simpleMarkdownToHtml(preContent);
                    }
                    $content.html(contentHtml);
                }
            }
        }
    } else if (doc && doc.content_html) {
        // 如果 DOM 中没有内容，但 doc 对象有 content_html，使用它
        contentHtml = doc.content_html;
        $('#articleContent').html(`<div class="article-content-rendered">${contentHtml}</div>`);
    } else if (doc && doc.content) {
        // 如果有 marked.js，使用它来解析 Markdown
        if (typeof marked !== 'undefined') {
            contentHtml = marked.parse(doc.content);
        } else {
            // 简单的 Markdown 转 HTML（基础支持）
            contentHtml = simpleMarkdownToHtml(doc.content);
        }
        $('#articleContent').html(`<div class="article-content-rendered">${contentHtml}</div>`);
    }
    
    // 如果仍然没有内容，记录警告
    if (!contentHtml || contentHtml.trim() === '') {
        // 无法获取文档内容
        console.warn('无法获取文档内容', {
            hasContentElement: $content.length > 0,
            hasDocContentHtml: !!(doc && doc.content_html),
            hasDocContent: !!(doc && doc.content)
        });
    }

    // 清理代码块和段落中的多余 <br> 标签（修复行间距问题）
    cleanupCodeBlocks();
    cleanupParagraphs();
    
    // 处理普通文本段落中的换行（确保单换行显示为 <br>）
    processTextLineBreaks();

    // 生成TOC（必须在 initCodeCopyButtons 之前，因为会重新设置 HTML）
    if (contentHtml) {
        generateToc(contentHtml, { scrollToHash: !!window.location.hash });
    }
    applyArticleImageLazyLoading();
    
    // 初始化 highlight.js 语法高亮（必须在 generateToc 之后，因为 generateToc 会重新设置 HTML）
    // 延迟执行，确保 DOM 更新完成
    setTimeout(function() {
        initSyntaxHighlight();
        if (typeof initMermaidDiagrams === 'function') {
            initMermaidDiagrams();
        }
    }, 50);
    
    // 为代码块添加复制功能（使用 Clipboard.js）
    // 必须在 generateToc 和 initSyntaxHighlight 之后，因为会重新设置 HTML
    setTimeout(function() {
        initCodeCopyButtons();
    }, 120);
    
    // 为内联 code 标签添加复制功能
    setTimeout(function() {
        initInlineCodeCopy();
    }, 170);
    
    // 处理 CSV 文件自定义渲染
    setTimeout(function() {
        renderCSVFiles();
    }, 220);

    setTimeout(function() {
        initArticleImageViewer();
    }, 270);

    if (window.DocTextShare && typeof window.DocTextShare.onContentReady === 'function') {
        window.DocTextShare.onContentReady();
    }

    if (window.DocPageShare && typeof window.DocPageShare.onContentReady === 'function') {
        window.DocPageShare.onContentReady(doc);
    }

    if (window.DocFontSize && typeof window.DocFontSize.apply === 'function') {
        window.DocFontSize.apply();
    }

    if (window.SdDocAttachLink && typeof window.SdDocAttachLink.bindAttachLinks === 'function') {
        window.SdDocAttachLink.bindAttachLinks($('#articleContent'));
    }
    
    // 加载文档统计数据和导航
    if (doc && doc.id) {
        if ($('#viewCount').length === 0) {
            renderDocumentMeta(doc);
        }
        renderDocumentSummary(doc);
        setTimeout(function() {
            loadDocumentStats(doc.id, doc.short_id);
            loadDocumentArticleNavigation(doc);
        }, 300);
    }
}

// 渲染文档内容（AJAX加载时使用）
function renderDocument(doc, options) {
    options = options || {};
    // 确保使用正确的 jQuery 引用
    const $ = window.jQuery || window.$;

    if (window.DocContentView && typeof window.DocContentView.reset === 'function') {
        window.DocContentView.reset();
    }

    $('#docsArticle').addClass('docs-article-detail').attr('itemscope', '').attr('itemtype', 'https://schema.org/TechArticle');
    $('.docs-content').addClass('docs-content-detail');
    
    updateDocumentSEOMeta(doc);
    renderDocumentBreadcrumbs(doc);
    renderDocumentMeta(doc);
    renderDocumentSummary(doc);
    
    // 更新标题
    $('#articleHeader').show();
    $('#articleTitle').text(doc.title || '文档标题');
    
    // 更新浏览器标题（SEO优化）
    if (doc.title) {
        document.title = doc.title + ' - {{.SiteName}}';
    }

    // 渲染文档内容
    // 安全说明：正文经 goldmark 渲染后由 bluemonday 消毒（允许安全标签与 video，剥离 script/事件）；
    // 客户端 marked.parse 仅作 Markdown 渲染补充，不信任用户提交的原始 HTML。
    let contentHtml = '';
    if (doc.content_html) {
        contentHtml = doc.content_html;
    } else if (doc.content_md) {
        if (typeof marked !== 'undefined') {
            contentHtml = marked.parse(doc.content_md);
        } else {
            contentHtml = simpleMarkdownToHtml(doc.content_md);
        }
    } else if (doc.content) {
        // 如果有 marked.js，使用它来解析 Markdown
        if (typeof marked !== 'undefined') {
            contentHtml = marked.parse(doc.content);
        } else {
            // 简单的 Markdown 转 HTML（基础支持）
            contentHtml = simpleMarkdownToHtml(doc.content);
        }
    }

    $('#articleContent').html('<div class="article-content-rendered">' + contentHtml + '</div>');

    // 清理代码块和段落中的多余 <br> 标签（修复行间距问题）
    cleanupCodeBlocks();
    cleanupParagraphs();
    
    // 处理普通文本段落中的换行（确保单换行显示为 <br>）
    processTextLineBreaks();

    // 生成TOC（必须在 initCodeCopyButtons 之前，因为会重新设置 HTML）
    generateToc(contentHtml, { scrollToHash: !!options.scrollToHash });
    applyArticleImageLazyLoading();
    
    // 初始化 highlight.js 语法高亮（必须在 generateToc 之后，因为 generateToc 会重新设置 HTML）
    // 延迟执行，确保 DOM 更新完成
    setTimeout(function() {
        initSyntaxHighlight();
        if (typeof initMermaidDiagrams === 'function') {
            initMermaidDiagrams();
        }
    }, 50);
    
    // 为代码块添加复制功能（使用 Clipboard.js）
    // 必须在 generateToc 和 initSyntaxHighlight 之后，因为会重新设置 HTML
    setTimeout(function() {
        initCodeCopyButtons();
    }, 120);
    
    // 为内联 code 标签添加复制功能
    setTimeout(function() {
        initInlineCodeCopy();
    }, 170);
    
    // 处理 CSV 文件自定义渲染
    setTimeout(function() {
        renderCSVFiles();
    }, 220);

    setTimeout(function() {
        initArticleImageViewer();
    }, 270);

    // 更新导航状态（传递 project_slug 和 short_id 如果存在）
    const projectSlug = doc.project_slug || null;
    const shortId = doc.short_id || null;
    const publicDirectory = doc.public_directory || pendingHighlightDoc.directory || null;
    
    setPendingHighlightFromDoc(doc, publicDirectory);
    
    setTimeout(function() {
        highlightCurrentNavItem(
            doc.id,
            shortId,
            publicDirectory,
            0,
            resolveDocNavCategoryPath(doc)
        );
    }, 500);
    
    if (doc && doc.id) {
        window.currentDocumentData = {
            id: doc.id,
            short_id: doc.short_id,
            project_id: doc.project_id,
            project_slug: projectSlug
        };
    }

    if (window.DocComments && typeof window.DocComments.reload === 'function') {
        window.DocComments.reload();
    }

    if (window.DocTextShare && typeof window.DocTextShare.onContentReady === 'function') {
        window.DocTextShare.onContentReady();
    }

    if (window.DocPageShare && typeof window.DocPageShare.onContentReady === 'function') {
        window.DocPageShare.onContentReady(doc);
    }

    if (window.DocFontSize && typeof window.DocFontSize.apply === 'function') {
        window.DocFontSize.apply();
    }

    if (window.SdDocAttachLink && typeof window.SdDocAttachLink.bindAttachLinks === 'function') {
        window.SdDocAttachLink.bindAttachLinks($('#articleContent'));
    }

    // 加载文档统计数据和导航
    if (doc && doc.id) {
        // 延迟加载，确保DOM已完全渲染
        setTimeout(function() {
            // 传递 short_id 作为第二个参数
            loadDocumentStats(doc.id, doc.short_id);
            loadDocumentArticleNavigation(doc);
        }, 300);
    }
}

// 处理普通文本段落中的换行
function processTextLineBreaks() {
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    const $content = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
    
    if ($content.length === 0) {
        return;
    }
    
    // 处理段落内的换行符（将文本中的换行符转换为 <br>）
    $content.find('p').each(function() {
        const $p = $(this);
        let html = $p.html();
        
        // 如果段落中包含换行符（\n），且不是代码块，则转换为 <br>
        if (html && html.includes('\n') && !html.match(/<pre|<code/i)) {
            // 将换行符转换为 <br>，但避免重复转换
            html = html.replace(/\n/g, '<br>');
            $p.html(html);
        }
    });
}

// 清理段落之间的多余 <br> 标签
function cleanupParagraphs() {
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    const $content = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
    
    if ($content.length === 0) {
        return;
    }
    
    // 移除段落标签之间的 <br>
    $content.find('p').each(function() {
        const $p = $(this);
        let html = $p.html();
        
        // 移除段落开头和结尾的 <br>
        html = html.replace(/^(<br\s*\/?>)+|(<br\s*\/?>)+$/gi, '');
        
        // 移除段落内连续的多个 <br>，只保留一个
        html = html.replace(/(<br\s*\/?>){2,}/gi, '<br>');
        
        $p.html(html);
    });
    
    // 移除标题前后的 <br> 和空白文本节点
    $content.find('h1, h2, h3, h4, h5, h6').each(function() {
        const $heading = $(this);
        const $prev = $heading.prev();
        const $next = $heading.next();
        
        // 移除标题前的 <br>
        if ($prev.length && ($prev.is('br') || ($prev.is('p') && $prev.html().trim() === ''))) {
            $prev.remove();
        }
        
        // 移除标题后的 <br>
        if ($next.length && ($next.is('br') || ($next.is('p') && $next.html().trim() === ''))) {
            $next.remove();
        }
    });
    
    // 移除段落之间的多余 <br>（段落标签之间的 <br>）
    $content.find('p + br + p').prev('br').remove();
    
    // 移除紧跟在段落后的单个 <br>（段落之间不应该有 <br>）
    $content.find('p').each(function() {
        const $p = $(this);
        const $next = $p.next();
        if ($next.length && $next.is('br') && $next.next().is('p')) {
            $next.remove();
        }
    });
    
    // 清理表格周围的 <br> 标签
    $content.find('.table-responsive').each(function() {
        const $tableDiv = $(this);
        
        // 移除表格前的 <br>
        const $prev = $tableDiv.prev();
        if ($prev.length && $prev.is('br')) {
            $prev.remove();
        } else if ($prev.length && $prev.is('p')) {
            // 检查段落是否只包含 <br> 或为空
            const pHtml = $prev.html().trim();
            if (pHtml === '' || pHtml === '<br>' || /^(<br\s*\/?>)+$/i.test(pHtml)) {
                $prev.remove();
            }
        }
        
        // 移除表格后的 <br>
        const $next = $tableDiv.next();
        if ($next.length && $next.is('br')) {
            $next.remove();
        } else if ($next.length && $next.is('p')) {
            // 检查段落是否只包含 <br> 或为空
            const pHtml = $next.html().trim();
            if (pHtml === '' || pHtml === '<br>' || /^(<br\s*\/?>)+$/i.test(pHtml)) {
                $next.remove();
            }
        }
    });
    
    // 清理表格容器内的 <br>（不应该出现在表格容器内）
    $content.find('.table-responsive br').remove();
}

// 清理代码块中的 <br> 标签和顶部空白
function cleanupCodeBlocks() {
    // 确保使用正确的 jQuery 引用
    const $ = window.jQuery || window.$;
    
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    const $content = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
    
    if ($content.length === 0) {
        return;
    }
    
    $content.find('pre').each(function() {
        const $pre = $(this);
        const $code = $pre.find('code');
        
        // 移除代码块前的 <br> 标签和空白（顶部空白）
        const $prev = $pre.prev();
        if ($prev.length) {
            if ($prev.is('br')) {
                $prev.remove();
            } else if ($prev.is('p')) {
                // 检查段落末尾是否有 <br>
                const pHtml = $prev.html();
                if (pHtml && pHtml.trim().endsWith('<br>')) {
                    $prev.html(pHtml.replace(/<br>\s*$/gi, ''));
                }
            }
        }
        
        // 移除代码块 wrapper 前的 <br>
        const $wrapper = $pre.parent('.code-block-wrapper');
        if ($wrapper.length) {
            const $wrapperPrev = $wrapper.prev();
            if ($wrapperPrev.length && $wrapperPrev.is('br')) {
                $wrapperPrev.remove();
            }
        }
        
        // 处理代码块内容
        // 注意：代码块内容应该保持原样，只清理多余的 <br> 标签
        if ($code.length > 0) {
            // 获取原始文本内容（不包含 HTML 标签）
            let text = $code.text();
            
            // 如果 text() 返回空，说明内容可能被转义了，尝试从 html() 中提取
            if (!text || text.trim() === '') {
                let html = $code.html();
                // 移除代码块中的所有 <br> 标签，替换为换行符
                html = html.replace(/<br\s*\/?>/gi, '\n');
                // 解码 HTML 实体
                const tempDiv = document.createElement('div');
                tempDiv.innerHTML = html;
                text = tempDiv.textContent || tempDiv.innerText || '';
            }
            
            // 清理多余的空白行（保留单个换行）
            text = text.replace(/\n{3,}/g, '\n\n');
            
            // 移除首尾的换行和空白（包括顶部空白）
            text = text.replace(/^\s*\n+|\n+\s*$/g, '');
            
            // 使用 text() 设置内容，确保原样显示（text() 会自动转义 HTML 特殊字符）
            $code.text(text);
        } else {
            // 如果 pre 内没有 code 标签，直接处理 pre 的内容
            let text = $pre.text();
            
            // 如果 text() 返回空，尝试从 html() 中提取
            if (!text || text.trim() === '') {
                let html = $pre.html();
                // 移除代码块中的所有 <br> 标签，替换为换行符
                html = html.replace(/<br\s*\/?>/gi, '\n');
                // 解码 HTML 实体
                const tempDiv = document.createElement('div');
                tempDiv.innerHTML = html;
                text = tempDiv.textContent || tempDiv.innerText || '';
            }
            
            // 清理多余的空白行（保留单个换行）
            text = text.replace(/\n{3,}/g, '\n\n');
            
            // 移除首尾的换行和空白（包括顶部空白）
            text = text.replace(/^\s*\n+|\n+\s*$/g, '');
            
            // 使用 text() 设置内容，确保原样显示
            $pre.text(text);
        }
    });
}

// 初始化代码块复制按钮（使用 Clipboard.js）
function initCodeCopyButtons() {
    // 确保使用正确的 jQuery 引用
    const $ = window.jQuery || window.$;
    
    if (typeof $ === 'undefined') {
        console.error('[initCodeCopyButtons] jQuery 未加载！');
        return;
    }
    
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    const $content = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
    
    // 查找所有 pre 代码块
    const $codeBlocks = $content.find('pre');
    
    if ($codeBlocks.length === 0) {
        return;
    }
    
    $codeBlocks.each(function(index) {
        const $pre = $(this);
        const $wrapper = $pre.parent('.code-block-wrapper');

        if ($wrapper.length > 0 && $wrapper.find('.code-lang-badge').first().text().trim().toLowerCase() === 'mermaid') {
            return;
        }
        
        // 检查是否已经有复制按钮
        if ($wrapper.length > 0 && $wrapper.find('.code-copy-btn').length > 0) {
            return; // 已有按钮，跳过
        }
        
        // 获取代码内容（优先从 code 标签获取，如果没有则从 pre 获取）
        // 注意：排除语言徽标的内容，只复制纯代码
        let codeText = '';
        const $code = $pre.find('code');
        
        if ($code.length > 0) {
            // 直接从 code 标签获取文本，不包含徽标
            codeText = $code.text();
        } else {
            codeText = $pre.text();
        }
        
        // 确保代码文本是干净的（不包含徽标文本）
        codeText = codeText.trim();
        
        // 如果代码为空，跳过
        if (!codeText || codeText.trim() === '') {
            return;
        }
        
        // 包装 pre 元素（如果还没有包装）
        let $finalWrapper = $pre.parent('.code-block-wrapper');
        if ($finalWrapper.length === 0) {
            $pre.wrap('<div class="code-block-wrapper"></div>');
            $finalWrapper = $pre.parent('.code-block-wrapper');
        }
        
        // 创建复制按钮
        const $copyBtn = $('<button>', {
            'class': 'code-copy-btn',
            'type': 'button',
            'data-clipboard-text': codeText,
            'title': docsT('codeCopyTitle', 'Copy code'),
            'html': '<i class="bx bx-copy"></i><span class="copy-text">' + escapeHtml(docsT('codeCopy', 'Copy')) + '</span>'
        });
        
        // 添加复制按钮到 wrapper 内部
        $finalWrapper.append($copyBtn);
        
        // hover 时显示复制按钮
        // 使用原生事件确保能触发
        const preElement = $pre[0];
        const wrapperElement = $finalWrapper[0];
        let hideTimer = null;
        
        if (preElement && wrapperElement) {
            // hover 显示按钮
            const mouseEnterHandler = function(e) {
                // 清除隐藏定时器
                if (hideTimer) {
                    clearTimeout(hideTimer);
                    hideTimer = null;
                }
                $finalWrapper.addClass('show-copy-btn');
            };
            
            const mouseLeaveHandler = function(e) {
                // 检查鼠标是否移到按钮上
                const relatedTarget = e.relatedTarget;
                if (relatedTarget && (relatedTarget.closest('.code-copy-btn') || relatedTarget.closest('.code-block-wrapper') === wrapperElement)) {
                    return;
                }
                // 延迟隐藏，给用户时间移到按钮上
                hideTimer = setTimeout(function() {
                    $finalWrapper.removeClass('show-copy-btn');
                }, 300);
            };
            
            // 绑定 hover 事件到 wrapper（更可靠）
            wrapperElement.addEventListener('mouseenter', mouseEnterHandler, { passive: true });
            wrapperElement.addEventListener('mouseleave', mouseLeaveHandler, { passive: true });
            
            // 同时在 pre 上绑定（双重保险）
            preElement.addEventListener('mouseenter', mouseEnterHandler, { passive: true });
            preElement.addEventListener('mouseleave', mouseLeaveHandler, { passive: true });
            
            // 按钮 hover 时保持显示
            const btnElement = $copyBtn[0];
            if (btnElement) {
                btnElement.addEventListener('mouseenter', function() {
                    // 清除隐藏定时器
                    if (hideTimer) {
                        clearTimeout(hideTimer);
                        hideTimer = null;
                    }
                    $finalWrapper.addClass('show-copy-btn');
                }, { passive: true });
                
                btnElement.addEventListener('mouseleave', function() {
                    // 延迟隐藏
                    hideTimer = setTimeout(function() {
                        $finalWrapper.removeClass('show-copy-btn');
                    }, 200);
                }, { passive: true });
            }
        }
        
        // 使用 Clipboard.js 初始化复制功能
        if (typeof ClipboardJS !== 'undefined') {
            const clipboard = new ClipboardJS($copyBtn[0], {
                text: function(trigger) {
                    return $(trigger).data('clipboard-text') || codeText;
                }
            });
            
            clipboard.on('success', function(e) {
                e.clearSelection();
                showCopySuccess($copyBtn);
            });
            
            clipboard.on('error', function(e) {
                console.error(`[initCodeCopyButtons] 代码块 ${index + 1} - 复制失败:`, e);
                // 降级到原生方法
                fallbackCopyToClipboard(codeText, $copyBtn);
            });
        } else {
            // 如果 Clipboard.js 未加载，使用原生方法
            $copyBtn.on('click', function(e) {
                e.preventDefault();
                e.stopPropagation();
                fallbackCopyToClipboard(codeText, $copyBtn);
            });
        }
    });
}

// 备用复制方法（当 Clipboard.js 不可用时）
function fallbackCopyToClipboard(text, $button, successCallback) {
    // 使用现代 Clipboard API（优先）
    if (navigator.clipboard && navigator.clipboard.writeText) {
        navigator.clipboard.writeText(text).then(function() {
            if ($button) {
                showCopySuccess($button);
            }
            if (successCallback) {
                successCallback();
            }
        }).catch(function(err) {
            console.error('复制失败:', err);
            // 降级到 execCommand
            execCommandCopy(text, $button, successCallback);
        });
    } else {
        // 使用 execCommand
        execCommandCopy(text, $button, successCallback);
    }
}

// execCommand 复制方法
function execCommandCopy(text, $button, successCallback) {
    const $textarea = $('<textarea>').val(text).css({
        position: 'fixed',
        left: '-9999px',
        top: '-9999px',
        opacity: '0'
    }).appendTo('body');
    
    try {
        $textarea[0].select();
        $textarea[0].setSelectionRange(0, text.length);
        
        const successful = document.execCommand('copy');
        if (successful) {
            if ($button) {
                showCopySuccess($button);
            }
            if (successCallback) {
                successCallback();
            }
        } else {
            console.error('复制失败');
        }
    } catch (err) {
        console.error('复制失败:', err);
    } finally {
        $textarea.remove();
    }
}

// 显示复制成功提示
function showCopySuccess($button) {
    const $icon = $button.find('i');
    const $text = $button.find('.copy-text');
    
    // 保存原始内容
    const originalIcon = $icon.attr('class');
    const originalText = $text.text();
    
    // 更新为成功状态
    $icon.attr('class', 'bx bx-check');
    $text.text(docsT('codeCopied', 'Copied'));
    $button.addClass('copied');
    
    // 2秒后恢复
    setTimeout(function() {
        $icon.attr('class', originalIcon);
        $text.text(originalText);
        $button.removeClass('copied');
    }, 2000);
}

// 初始化内联 code 标签的复制功能
function initInlineCodeCopy() {
    // 确保使用正确的 jQuery 引用
    const $ = window.jQuery || window.$;
    
    if (typeof $ === 'undefined') {
        console.error('[initInlineCodeCopy] jQuery 未加载！');
        return;
    }
    
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    const $content = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
    
    if ($content.length === 0) {
        return;
    }
    
    // 查找所有内联 code 标签（不在 pre 内的 code）
    const $inlineCodes = $content.find('code').filter(function() {
        return $(this).closest('pre').length === 0;
    });
    
    $inlineCodes.each(function() {
        const $code = $(this);
        
        // 如果已经有复制功能，跳过
        if ($code.hasClass('code-copy-enabled')) {
            return;
        }
        
        // 添加可复制标识和样式
        $code.addClass('code-copy-enabled');
        $code.css({
            'cursor': 'pointer',
            'position': 'relative',
            'user-select': 'none'
        });
        
        // 添加 title 提示
        $code.attr('title', docsT('codeClickCopy', 'Click to copy'));
        
        // 点击复制功能
        $code.on('click', function(e) {
            e.preventDefault();
            e.stopPropagation();
            
            const codeText = $code.text().trim();
            
            if (!codeText) {
                return;
            }
            
            // 直接使用降级方案（已包含 Clipboard API 和 execCommand）
            fallbackCopyToClipboard(codeText, null, function() {
                // 复制成功回调
                showInlineCodeCopySuccess($code);
            });
        });
        
        // 添加 hover 效果
        $code.on('mouseenter', function() {
            if (!$code.hasClass('code-copy-copied')) {
                $code.css('background-color', '#e3f2fd');
            }
        });
        
        $code.on('mouseleave', function() {
            if (!$code.hasClass('code-copy-copied')) {
                $code.css('background-color', '');
            }
        });
    });
}

// 显示内联 code 复制成功提示
function showInlineCodeCopySuccess($code) {
    // 添加成功状态样式
    $code.addClass('code-copy-copied');
    $code.css({
        'background-color': '#d4edda',
        'color': '#155724',
        'border': '1px solid #28a745'
    });
    $code.attr('title', docsT('codeCopied', 'Copied'));
    
    // 2秒后恢复
    setTimeout(function() {
        $code.removeClass('code-copy-copied');
        $code.css({
            'background-color': '',
            'color': '',
            'border': ''
        });
        $code.attr('title', docsT('codeClickCopy', 'Click to copy'));
    }, 2000);
}

// 生成TOC
function generateToc(content, options) {
    options = options || {};
    // 如果内容为空，尝试从 DOM 中获取
    if (!content || content.trim() === '') {
        const $renderedContent = $('#articleContent .article-content-rendered');
        const $ajaxContent = $('#articleContent .article-content');
        const $existingContent = $renderedContent.length > 0 ? $renderedContent : $ajaxContent;
        
        if ($existingContent.length > 0) {
            content = $existingContent.html();
        }
    }
    
    const $docsLayout = $('.docs-layout');
    const $tocSidebar = $('.docs-toc');
    
    // 如果仍然没有内容，隐藏 TOC
    if (!content || content.trim() === '') {
        $docsLayout.addClass('no-toc');
        $tocSidebar.hide();
        $('#tocList').empty();
        tocItems = [];
        return;
    }
    
    const $content = $('<div>').html(content);
    const headings = $content.find('h1, h2, h3, h4, h5, h6');
    tocItems = [];

    // 如果没有标题，隐藏 TOC
    if (headings.length === 0) {
        $docsLayout.addClass('no-toc');
        $tocSidebar.hide();
        $('#tocList').empty();
        return;
    }

    // 有标题时，显示 TOC
    $docsLayout.removeClass('no-toc');
    $tocSidebar.show();
    
    // GitHub 风格 slug，重复标题追加 -1、-2…
    const usedIds = {};
    let html = '';
    headings.each(function(index) {
        const $heading = $(this);
        const level = parseInt($heading.prop('tagName').charAt(1));
        const text = $heading.text();
        // 始终用 GitHub 风格 slug（保留中文）。goldmark 默认会剥掉 CJK，留下如 "7-"，
        // 导致 #7-用户管理与日志 无法定位，需覆盖服务端旧 id。
        let id = slugifyHeading(text);
        if (!id) {
            id = ($heading.attr('id') || '').trim();
        }
        if (!id || id.indexOf('heading-') === 0) {
            id = 'heading-' + index;
        }
        if (Object.prototype.hasOwnProperty.call(usedIds, id)) {
            let n = usedIds[id];
            let candidate;
            do {
                n += 1;
                candidate = id + '-' + n;
            } while (Object.prototype.hasOwnProperty.call(usedIds, candidate));
            usedIds[id] = n;
            id = candidate;
            usedIds[id] = 0;
        } else {
            usedIds[id] = 0;
        }

        // 添加ID到标题
        $heading.attr('id', id);

        tocItems.push({
            id: id,
            text: text,
            level: level
        });

        // 中文 id 在 href 中直接使用，与 GitHub / MD 预览锚点一致
        html += `<li class="toc-item toc-level-${level}">
            <a href="#${escapeHtml(id)}" class="toc-link">${escapeHtml(text)}</a>
        </li>`;
    });

    $('#tocList').html(html);

    // 重新设置内容（包含ID）
    // 注意：这会清除之前绑定的事件，所以 initCodeCopyButtons 必须在这之后调用
    // 同时支持服务端渲染的 .article-content-rendered 和 AJAX 加载的 .article-content
    const $renderedContent = $('#articleContent .article-content-rendered');
    const $ajaxContent = $('#articleContent .article-content');
    
    if ($renderedContent.length > 0) {
        // 服务端渲染的内容
        $renderedContent.html($content.html());
    } else if ($ajaxContent.length > 0) {
        // AJAX 加载的内容
        $ajaxContent.html($content.html());
    } else {
        // 如果都不存在，尝试创建容器
        $('#articleContent').html(`<div class="article-content-rendered">${$content.html()}</div>`);
    }

    // 内容渲染完成后，按 URL hash 定位到对应标题（仅首屏/后退等场景，切换文档时不沿用旧锚点）
    if (options.scrollToHash && window.location.hash) {
        scrollToHeadingAnchor(window.location.hash, { smooth: false, delay: 80 });
    }
}

// 更新导航状态
function updateNavState(projectId, docId, projectSlug, shortId) {
    $('.nav-link').removeClass('active');
    
    // 高亮项目链接（如果提供了 projectId）
    if (projectId) {
        $(`.nav-link[data-project-id="${projectId}"]`).addClass('active');
        
        // 确保项目文档列表展开
        const $projectLink = $(`.nav-link[data-project-id="${projectId}"]`);
        if (!$projectLink.hasClass('expanded')) {
            const $docsList = $(`#project-${projectId}-docs`);
            if ($docsList.length && !$docsList.is(':visible')) {
                const projectSlug = $projectLink.data('project-slug') || '';
                loadProjectDocs(projectId, projectSlug);
                $projectLink.addClass('expanded');
            }
        }
    }
    
    // 高亮文档链接（支持多种匹配方式）
    if (docId) {
        // 1. 优先匹配项目文档列表中的文档（.nav-doc-link）
        const $projectDocLink = $(`.nav-doc-link[data-doc-id="${docId}"]`);
        if ($projectDocLink.length > 0) {
            $projectDocLink.addClass('active');
        }
        
        // 2. 匹配文件系统导航中的文档（通过 data-id）
        const $filesystemDocLinkById = $(`.nav-item.doc[data-id="${docId}"] .nav-link`);
        if ($filesystemDocLinkById.length > 0) {
            $filesystemDocLinkById.addClass('active');
        }
        
        // 3. 如果提供了 shortId，也尝试通过 data-short-id 匹配
        if (shortId) {
            const $filesystemDocLinkByShortId = $(`.nav-item.doc[data-short-id="${shortId}"] .nav-link`);
            if ($filesystemDocLinkByShortId.length > 0) {
                $filesystemDocLinkByShortId.addClass('active');
            }
        }
    }
}

function hasPendingNavHighlight() {
    return !!(pendingHighlightDoc.docId || pendingHighlightDoc.shortId || pendingHighlightDoc.categorySlug);
}

function resolvePendingNavHighlight() {
    highlightCurrentNavItem(
        pendingHighlightDoc.docId,
        pendingHighlightDoc.shortId,
        pendingHighlightDoc.directory,
        0,
        pendingHighlightDoc.categorySlug
    );
}

function scrollNavLinkIntoSidebar($link) {
    if (!$link || !$link.length) {
        return;
    }
    setTimeout(function() {
        const navItemTop = $link.offset().top;
        const sidebarTop = $('#docsSidebar').offset().top;
        const sidebarHeight = $('#docsSidebar').height();
        const scrollTop = $('#docsSidebar').scrollTop();
        const itemRelativeTop = navItemTop - sidebarTop + scrollTop;
        const viewportTop = scrollTop;
        const viewportBottom = scrollTop + sidebarHeight;
        if (itemRelativeTop < viewportTop || itemRelativeTop > viewportBottom) {
            $('#docsSidebar').animate({
                scrollTop: itemRelativeTop - sidebarHeight / 2
            }, 300);
        }
    }, 300);
}

function getCategoryPathSegments(categoryPath) {
    return (categoryPath || '').split('/').filter(function(segment) { return segment; });
}

function findCategoryNavItemByPath(categoryPath) {
    const normalizedPath = (categoryPath || '').replace(/^\/+|\/+$/g, '');
    if (!normalizedPath) {
        return $();
    }
    return $('.nav-item.category').filter(function() {
        return String($(this).data('path') || '') === normalizedPath;
    }).first();
}

// 按路径逐级展开分类导航（如 admin 或 admin/settings）
function highlightCategoryNavPath(directory, categoryPath, retryCount) {
    directory = directory || pendingHighlightDoc.directory;
    categoryPath = (categoryPath || pendingHighlightDoc.categorySlug || '').replace(/^\/+|\/+$/g, '');
    retryCount = retryCount || 0;

    if (!categoryPath) {
        return;
    }
    if (retryCount > 15) {
        console.warn('[highlightCategoryNavPath] 重试次数过多，停止尝试');
        return;
    }

    const segments = getCategoryPathSegments(categoryPath);
    if (segments.length === 0) {
        return;
    }

    let accumulatedPath = '';
    for (let i = 0; i < segments.length; i++) {
        accumulatedPath = accumulatedPath ? accumulatedPath + '/' + segments[i] : segments[i];
        const $categoryItem = findCategoryNavItemByPath(accumulatedPath);

        if (!$categoryItem.length) {
            setTimeout(function() {
                highlightCategoryNavPath(directory, categoryPath, retryCount + 1);
            }, 400);
            return;
        }

        const $subList = $categoryItem.find('> .nav-sub-list');
        const isTarget = i === segments.length - 1;

        if (!$categoryItem.hasClass('expanded')) {
            $categoryItem.addClass('expanded');
            if ($subList.children().length === 0 || $subList.find('.nav-loading').length > 0) {
                const depth = parseInt($categoryItem.data('depth') || 0, 10);
                loadFilesystemNavigationTreeWithCallback('/api/docs/filesystem/tree', {
                    directory: directory,
                    subpath: accumulatedPath
                }, $subList, depth + 1, directory, function() {
                    setTimeout(function() {
                        highlightCategoryNavPath(directory, categoryPath, retryCount + 1);
                    }, 150);
                });
                return;
            }
            $subList.slideDown(200);
        } else if (!$subList.is(':visible')) {
            $subList.slideDown(200);
        }

        if (isTarget) {
            $('.nav-link').removeClass('active');
            const $categoryLink = $categoryItem.find('> .nav-link.nav-category-toggle');
            $categoryLink.addClass('active');
            scrollNavLinkIntoSidebar($categoryLink);
        }
    }
}

// 高亮当前导航项（用于页面加载时的高亮）
// 支持通过 docId、shortId 或 categorySlug 匹配，并自动展开到该项
function highlightCurrentNavItem(docId, shortId, directory, retryCount, categorySlug) {
    directory = directory || pendingHighlightDoc.directory;
    categorySlug = categorySlug || pendingHighlightDoc.categorySlug;

    retryCount = retryCount || 0;
    if (retryCount > 15) {
        console.warn('[highlightCurrentNavItem] 重试次数过多，停止尝试');
        return;
    }

    if (!docId && !shortId && !categorySlug) {
        return;
    }

    if (!docId && !shortId && categorySlug) {
        highlightCategoryNavPath(directory, categorySlug, retryCount);
        return;
    }
    
    // 移除所有现有的高亮
    $('.nav-link').removeClass('active');
    
    let $targetLink = null;
    
    // 优先通过 docId 匹配
    if (docId) {
        $targetLink = $(`.nav-item.doc[data-id="${docId}"] .nav-link`);
    }
    
    // 如果通过 docId 没找到，尝试通过 shortId 匹配
    if (!$targetLink || $targetLink.length === 0) {
        if (shortId) {
            $targetLink = $(`.nav-item.doc[data-short-id="${shortId}"] .nav-link`);
        }
    }
    
    // 通过文档 URL 匹配（路径型链接）
    if (!$targetLink || $targetLink.length === 0) {
        const currentPath = window.location.pathname.replace(/\/$/, '');
        $('.nav-item.doc .nav-link').each(function() {
            const href = ($(this).attr('href') || '').replace(/\/$/, '');
            if (href && href === currentPath) {
                $targetLink = $(this);
                return false;
            }
        });
    }
    
    // 如果找到了目标链接
    if ($targetLink && $targetLink.length > 0) {
        // 高亮该项
        $targetLink.addClass('active');
        
        // 展开到该项：找到所有父级分类并展开
        const $navItem = $targetLink.closest('.nav-item.doc');
        if ($navItem.length > 0) {
            // 向上查找所有父级分类
            let $parent = $navItem.parent();
            let needsLoad = false;
            
            while ($parent.length > 0 && !$parent.is('#docsNav')) {
                // 检查是否是分类容器
                if ($parent.hasClass('nav-sub-list')) {
                    const $categoryItem = $parent.closest('.nav-item.category');
                    if ($categoryItem.length > 0) {
                        // 展开该分类
                        if (!$categoryItem.hasClass('expanded')) {
                            $categoryItem.addClass('expanded');
                            // 如果子列表为空，需要先加载
                            if ($parent.children().length === 0 || $parent.find('.nav-loading').length > 0) {
                                needsLoad = true;
                                // 获取分类路径和目录信息
                                const categoryPath = $categoryItem.data('path') || '';
                                const directorySlug = $categoryItem.closest('.nav-item.language-package').data('directory-slug') || directory;
                                // 加载子项，并在加载完成后重新尝试高亮
                                loadFilesystemNavigationTreeWithCallback('/api/docs/filesystem/tree', {
                                    directory: directorySlug,
                                    subpath: categoryPath
                                }, $parent, parseInt($categoryItem.data('depth') || 0) + 1, directorySlug, function() {
                                    // 加载完成后，重新尝试高亮
                                    setTimeout(function() {
                                        highlightCurrentNavItem(docId, shortId, directory, retryCount + 1, categorySlug);
                                    }, 200);
                                });
                            } else {
                                $parent.slideDown(200);
                            }
                        } else {
                            // 已经展开，确保可见
                            if (!$parent.is(':visible')) {
                                $parent.slideDown(200);
                            }
                        }
                    }
                    
                    // 检查是否是语言包容器
                    const $languageItem = $parent.closest('.nav-item.language-package');
                    if ($languageItem.length > 0) {
                        // 展开该语言包
                        if (!$languageItem.hasClass('expanded')) {
                            $languageItem.addClass('expanded');
                            // 如果子列表为空，需要先加载
                            if ($parent.children().length === 0 || $parent.find('.nav-loading').length > 0) {
                                needsLoad = true;
                                const directorySlug = $languageItem.data('directory-slug') || directory;
                                // 加载该语言包下的导航，并在加载完成后重新尝试高亮
                                loadDirectoryNavigationWithCallback(directorySlug, $parent, function() {
                                    // 加载完成后，重新尝试高亮
                                    setTimeout(function() {
                                        highlightCurrentNavItem(docId, shortId, directory, retryCount + 1, categorySlug);
                                    }, 200);
                                });
                            } else {
                                $parent.slideDown(200);
                            }
                        } else {
                            // 已经展开，确保可见
                            if (!$parent.is(':visible')) {
                                $parent.slideDown(200);
                            }
                        }
                    }
                }
                
                // 继续向上查找
                $parent = $parent.parent();
            }
            
            // 如果需要加载，等待加载完成后再滚动
            if (needsLoad) {
                return; // 等待回调函数重新调用高亮函数
            }
        }
        
        // 等待展开动画完成后再滚动
        setTimeout(function() {
            // 滚动到该项（如果不在可视区域）
            const navItemTop = $targetLink.offset().top;
            const sidebarTop = $('#docsSidebar').offset().top;
            const sidebarHeight = $('#docsSidebar').height();
            const scrollTop = $('#docsSidebar').scrollTop();
            
            // 检查是否在可视区域
            const itemRelativeTop = navItemTop - sidebarTop + scrollTop;
            const viewportTop = scrollTop;
            const viewportBottom = scrollTop + sidebarHeight;
            
            if (itemRelativeTop < viewportTop || itemRelativeTop > viewportBottom) {
                // 不在可视区域，滚动到该项
                $('#docsSidebar').animate({
                    scrollTop: itemRelativeTop - sidebarHeight / 2
                }, 300);
            }
        }, 500);
    } else {
        // 如果没找到，尝试展开用户分类后再定位
        if (categorySlug && retryCount < 10) {
            const $categoryItem = $(`.nav-item.category[data-path="${categorySlug}"]`);
            if ($categoryItem.length > 0) {
                const $subList = $categoryItem.find('> .nav-sub-list');
                if (!$categoryItem.hasClass('expanded')) {
                    $categoryItem.addClass('expanded');
                    if ($subList.children().length === 0 || $subList.find('.nav-loading').length > 0) {
                        const categoryPath = $categoryItem.data('path') || categorySlug;
                        const depth = parseInt($categoryItem.data('depth') || 0, 10);
                        loadFilesystemNavigationTreeWithCallback('/api/docs/filesystem/tree', {
                            directory: directory,
                            subpath: categoryPath
                        }, $subList, depth + 1, directory, function() {
                            setTimeout(function() {
                                highlightCurrentNavItem(docId, shortId, directory, retryCount + 1, categorySlug);
                            }, 200);
                        });
                        return;
                    }
                    $subList.slideDown(200);
                }
                setTimeout(function() {
                    highlightCurrentNavItem(docId, shortId, directory, retryCount + 1, categorySlug);
                }, 300);
                return;
            }
        }
        
        // 如果没找到，可能是导航栏还没加载完成，或者需要展开父级分类
        // 先尝试展开语言包（如果目录匹配）
        if (directory) {
            const $languageItem = $(`.nav-item.language-package[data-directory-slug="${directory}"]`);
            if ($languageItem.length > 0 && !$languageItem.hasClass('expanded')) {
                const $subList = $languageItem.find('> .nav-sub-list');
                if ($subList.length > 0) {
                    $languageItem.addClass('expanded');
                    if ($subList.children().length === 0 || $subList.find('.nav-loading').length > 0) {
                        // 加载该语言包下的导航，并在加载完成后重新尝试高亮
                        loadDirectoryNavigationWithCallback(directory, $subList, function() {
                            setTimeout(function() {
                                highlightCurrentNavItem(docId, shortId, directory, retryCount + 1, categorySlug);
                            }, 200);
                        });
                        return; // 等待加载完成
                    } else {
                        $subList.slideDown(200);
                    }
                }
            }
        }
        
        // 延迟重试
        if (hasPendingNavHighlight()) {
            setTimeout(function() {
                resolvePendingNavHighlight();
            }, 500);
        }
    }
}

// 初始化TOC生成器
function initTocGenerator() {
    // TOC点击事件
    $('#tocList').on('click', '.toc-link', function(e) {
        e.preventDefault();
        const href = $(this).attr('href') || '';
        scrollToHeadingAnchor(href, { smooth: true });
        if (history.replaceState) {
            history.replaceState(null, '', href);
        } else {
            window.location.hash = href.replace(/^#/, '');
        }
    });

    // 浏览器前进/后退或直接改 hash 时定位
    $(window).on('hashchange', function() {
        scrollToHeadingAnchor(window.location.hash, { smooth: true });
    });

    // 正文内 Markdown 锚点链接（[文字](#锚点)）点击定位
    $(document).on('click', '#articleContent a[href^="#"]', function(e) {
        const href = $(this).attr('href') || '';
        if (!href || href === '#') return;
        const el = getHeadingElementById(href);
        if (!el) return;
        e.preventDefault();
        scrollToHeadingAnchor(href, { smooth: true });
        if (history.replaceState) {
            try {
                history.replaceState(null, '', '#' + decodeURIComponent(href.replace(/^#/, '')));
            } catch (err) {
                history.replaceState(null, '', href);
            }
        }
    });

    // 正文内相对 .md 链接：未改写时浏览器会落到错误路径，运行时解析到侧栏文档 URL
    $(document).on('click', '#articleContent a[href]', function(e) {
        const href = ($(this).attr('href') || '').trim();
        if (!href || href.charAt(0) === '#' || /^(https?:|mailto:|tel:|\/\/)/i.test(href)) return;
        if (href.charAt(0) === '/') return;
        const resolved = resolveRelativeMarkdownDocHref(href);
        if (!resolved) return;
        e.preventDefault();
        const parsed = parsePublicDocPath(resolved.split('#')[0]);
        if (parsed) {
            loadDocumentByPublicPath(parsed.directory, parsed.docPath);
            if (resolved.indexOf('#') >= 0) {
                setTimeout(function() {
                    scrollToHeadingAnchor(resolved.substring(resolved.indexOf('#')), { smooth: true, delay: 120 });
                }, 400);
            }
            return;
        }
        window.location.href = resolved;
    });
    
    // TOC 最小化/恢复功能
    initTocMinimize();
}

// 从当前 URL 还原文档逻辑 slug（不含公共分类与 short_id）
function getCurrentDocumentLogicalSlug() {
    const pathParts = window.location.pathname.split('/').filter(function(p) { return p; });
    if (pathParts.length < 2) return '';
    function decodeSeg(seg) {
        try { return decodeURIComponent(seg); } catch (e) { return seg; }
    }
    const idIndex = findDocumentIDSegmentIndex(pathParts);
    if (idIndex > 0) {
        const parent = pathParts.slice(1, idIndex).map(decodeSeg);
        const name = pathParts.slice(idIndex + 1).map(decodeSeg);
        return parent.concat(name).join('/');
    }
    return pathParts.slice(1).map(decodeSeg).join('/');
}

// 将相对 .md 链接解析为站内文档 SEO URL（优先匹配侧栏已加载文档）
function resolveRelativeMarkdownDocHref(href) {
    href = String(href || '').trim();
    if (!href) return '';
    let pathPart = href;
    let fragment = '';
    const hashIdx = href.indexOf('#');
    if (hashIdx >= 0) {
        pathPart = href.slice(0, hashIdx);
        fragment = href.slice(hashIdx);
    }
    try { pathPart = decodeURIComponent(pathPart); } catch (e) {}
    if (!/\.(md|markdown)$/i.test(pathPart)) return '';

    const baseSlug = getCurrentDocumentLogicalSlug();
    let baseDir = '';
    if (baseSlug) {
        const slash = baseSlug.lastIndexOf('/');
        baseDir = slash >= 0 ? baseSlug.slice(0, slash) : '';
    }
    let joined = pathPart;
    if (pathPart.indexOf('./') === 0 || pathPart.indexOf('../') === 0 || pathPart.indexOf('/') < 0) {
        const stack = baseDir ? baseDir.split('/') : [];
        String(pathPart).split('/').forEach(function(seg) {
            if (!seg || seg === '.') return;
            if (seg === '..') {
                if (stack.length) stack.pop();
                return;
            }
            stack.push(seg);
        });
        joined = stack.join('/');
    }
    let targetSlug = joined.replace(/\.(md|markdown)$/i, '').replace(/^\/+|\/+$/g, '');
    if (!targetSlug) return '';
    const baseName = targetSlug.split('/').pop();

    let foundHref = '';
    $('.nav-doc-link').each(function() {
        const slug = String($(this).attr('data-doc-slug') || '').replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
        if (!slug) return;
        if (slug === targetSlug || slug === baseName || slug.slice(-(baseName.length + 1)) === '/' + baseName) {
            foundHref = $(this).attr('href') || '';
            return false;
        }
        // 去掉公共分类前缀再比
        const parts = window.location.pathname.split('/').filter(Boolean);
        if (parts.length) {
            let dir = parts[0];
            try { dir = decodeURIComponent(dir); } catch (e) {}
            if (slug.indexOf(dir + '/') === 0) {
                const rel = slug.slice(dir.length + 1);
                if (rel === targetSlug || rel === baseName) {
                    foundHref = $(this).attr('href') || '';
                    return false;
                }
            }
        }
    });
    if (foundHref) return foundHref + fragment;

    // 侧栏尚未加载时：拼 SEO 路径（无 short_id，交给路由 / API 再解析）
    const parts = window.location.pathname.split('/').filter(Boolean);
    if (!parts.length) return '';
    let directory = parts[0];
    try { directory = decodeURIComponent(directory); } catch (e) {}
    return '/' + encodeURIComponent(directory) + '/' + encodePathSegments(targetSlug) + fragment;
}

// 初始化 TOC 最小化功能
function initTocMinimize() {
    const $toc = $('#docsToc');
    const $tocToggleBtn = $('#tocToggleBtn');
    const $tocMinimizedBtn = $('#tocMinimizedBtn');
    const $docsLayout = $('.docs-layout');
    
    // 如果元素不存在，直接返回
    if ($toc.length === 0 || $tocToggleBtn.length === 0) {
        return;
    }
    
    const refreshShareBarAfterTocChange = function() {
        if (window.DocPageShare && typeof window.DocPageShare.refreshLayout === 'function') {
            window.DocPageShare.refreshLayout();
        }
    };

    // 定义最小化 TOC 函数
    const minimizeToc = function() {
        $toc.addClass('minimized');
        $docsLayout.addClass('toc-minimized');
        if ($tocMinimizedBtn.length > 0) {
            $tocMinimizedBtn.fadeIn(300);
        }
        localStorage.setItem('tocMinimized', 'true');
        
        // 更新按钮图标和提示
        $tocToggleBtn.find('i').removeClass('bx-chevron-right').addClass('bx-chevron-left');
        $tocToggleBtn.attr('title', '展开');
        
        // 确保按钮仍然可见和可点击
        $tocToggleBtn.css({
            'position': 'absolute',
            'right': '0.5rem',
            'top': '0.5rem',
            'z-index': '1000'
        });

        refreshShareBarAfterTocChange();
        setTimeout(refreshShareBarAfterTocChange, 320);
    };
    
    // 定义恢复 TOC 函数
    const restoreToc = function() {
        $toc.removeClass('minimized');
        $docsLayout.removeClass('toc-minimized');
        if ($tocMinimizedBtn.length > 0) {
            $tocMinimizedBtn.fadeOut(300);
        }
        localStorage.setItem('tocMinimized', 'false');
        
        // 更新按钮图标和提示
        $tocToggleBtn.find('i').removeClass('bx-chevron-left').addClass('bx-chevron-right');
        $tocToggleBtn.attr('title', '最小化');
        
        // 恢复按钮样式
        $tocToggleBtn.css({
            'position': '',
            'right': '',
            'top': '',
            'z-index': ''
        });

        refreshShareBarAfterTocChange();
        setTimeout(refreshShareBarAfterTocChange, 320);
    }
    
    // 检查是否已保存最小化状态
    const isMinimized = localStorage.getItem('tocMinimized') === 'true';
    if (isMinimized) {
        minimizeToc();
    }
    
    // 点击最小化按钮
    $tocToggleBtn.on('click', function(e) {
        e.preventDefault();
        e.stopPropagation();
        
        if ($toc.hasClass('minimized')) {
            restoreToc();
        } else {
            minimizeToc();
        }
    });
    
    // 点击右下角浮动按钮恢复（如果按钮存在）
    if ($tocMinimizedBtn.length > 0) {
        $tocMinimizedBtn.on('click', function(e) {
            e.preventDefault();
            e.stopPropagation();
            restoreToc();
        });
    }
}

// 初始化滚动监听
function initScrollSpy() {
    $(window).on('scroll', function() {
        const scrollTop = $(window).scrollTop();

        // TOC高亮
        updateTocHighlight(scrollTop);
    });
}

// 更新TOC高亮
function updateTocHighlight(scrollTop) {
    let currentItem = null;

    tocItems.forEach(item => {
        const el = getHeadingElementById(item.id);
        if (el) {
            const headingTop = $(el).offset().top - getDocsHeadingScrollOffset();
            if (scrollTop >= headingTop) {
                currentItem = item;
            }
        }
    });

    const $allLinks = $('.toc-link');
    const $activeLink = currentItem ? $allLinks.filter(function() {
        let hrefId = ($(this).attr('href') || '').replace(/^#/, '');
        try {
            hrefId = decodeURIComponent(hrefId);
        } catch (e) {
            // keep as-is
        }
        return hrefId === currentItem.id;
    }) : $();
    
    // 只有当 activeLink 发生变化时才进行操作
    if ($activeLink.length && !$activeLink.hasClass('active')) {
        $allLinks.removeClass('active');
        $activeLink.addClass('active');
        
        // 同步滚动 TOC 容器，使高亮项居中
        const $tocContainer = $('.docs-toc');
        if ($tocContainer.length) {
            const containerHeight = $tocContainer.height();
            const linkTop = $activeLink.position().top; // 这里的 position 是相对于最近的定位父元素，即 .docs-toc
            const linkHeight = $activeLink.outerHeight();
            const currentScrollTop = $tocContainer.scrollTop();
            
            // 计算目标滚动位置，使链接位于容器中间
            const targetScrollTop = currentScrollTop + linkTop - (containerHeight / 2) + (linkHeight / 2);
            
            // 使用 animate 平滑滚动
            $tocContainer.stop().animate({
                scrollTop: targetScrollTop
            }, 300);
        }
    } else if (!currentItem) {
        $allLinks.removeClass('active');
    }
}

// 处理响应式
function handleResponsive() {
    $(window).on('resize', function() {
        const width = $(window).width();

        if (width < 768) {
            // 移动端处理
            $('#docsSidebar').removeClass('show');
        }
    });
}

// 加载默认内容（无默认公共分类时的欢迎态）
function loadDefaultContent() {
    const siteName = '{{if .SiteName}}{{.SiteName}}{{else if .ProductName}}{{.ProductName}}{{else}}Docs{{end}}';
    $('#articleTitle').text(siteName);
}

// 无默认文档：提示从左侧导航选择
function showNavPickHint(directory, subpath) {
    if (window.DocPageShare && typeof window.DocPageShare.hide === 'function') {
        window.DocPageShare.hide();
    }
    if (window.DocContentView && typeof window.DocContentView.reset === 'function') {
        window.DocContentView.reset();
    }
    const hintText = {{json (T "docs_nav_pick_hint")}};
    const sloganText = {{json (T "docs_nav_slogan")}};
    const sloganSubText = {{json (T "docs_nav_slogan_sub")}};
    $('#docsArticle').removeClass('docs-article-detail').removeAttr('itemscope itemtype');
    $('.docs-content').removeClass('docs-content-detail');
    clearDocumentBreadcrumbs();
    $('#articleHeader').hide();
    $('#articleMeta').hide();
    if (directory) {
        let title = getDirectoryDisplayName(directory);
        if (subpath) {
            const seg = subpath.split('/').filter(function(s) { return s; }).pop() || subpath;
            $('#articleTitle').text(title + ' / ' + seg);
        } else {
            $('#articleTitle').text(title);
        }
    } else {
        $('#articleTitle').text('{{if .SiteName}}{{.SiteName}}{{else if .ProductName}}{{.ProductName}}{{else}}Docs{{end}}');
    }
    $('#articleContent').html(buildNavPickHintHtml(hintText, sloganText, sloganSubText));
    generateToc('');
    if (window.DocComments && typeof window.DocComments.hide === 'function') {
        window.DocComments.hide();
    }
}

function buildNavPickHintHtml(hintText, sloganText, sloganSubText) {
    return '<div class="docs-nav-hint">' +
        '<div class="docs-nav-hint-inner">' +
        '<div class="docs-nav-hint-brand">' +
        '<h2 class="docs-nav-slogan">' + escapeHtml(sloganText || '') + '</h2>' +
        '<p class="docs-nav-slogan-sub">' + escapeHtml(sloganSubText || '') + '</p>' +
        '</div>' +
        '<div class="docs-nav-hint-figure" aria-hidden="true">' +
        '<i class="bx bx-file-blank docs-nav-hint-doc-icon"></i>' +
        '</div>' +
        '<p class="docs-nav-hint-text">' + escapeHtml(hintText) + '</p>' +
        '<p class="docs-nav-hint-arrow" aria-hidden="true"><i class="bx bx-left-arrow-alt"></i></p>' +
        '</div></div>';
}

// 从目录列表中查找公共分类信息
function findDirectoryInfo(directories, directory) {
    if (!directories || !directory) return null;
    return directories.find(function(d) {
        return d.slug === directory || d.path_prefix === directory || d.url === '/' + directory;
    }) || null;
}

// 从父级树节点中匹配子路径段名称
function matchTreeItemName(items, segment) {
    if (!items || !segment) return segment;
    const match = items.find(function(item) {
        return item.path === segment || item.slug === segment;
    });
    return (match && match.name) ? match.name : segment;
}

// 目录页视图模式：list | grid
var CATEGORY_VIEW_MODE_KEY = 'sd_category_view_mode';

function getCategoryViewMode() {
    try {
        return localStorage.getItem(CATEGORY_VIEW_MODE_KEY) === 'grid' ? 'grid' : 'list';
    } catch (e) {
        return 'list';
    }
}

function setCategoryViewMode(mode) {
    try {
        localStorage.setItem(CATEGORY_VIEW_MODE_KEY, mode === 'grid' ? 'grid' : 'list');
    } catch (e) {}
}

function buildCategoryViewToggleHtml(mode) {
    return '<div class="category-view-toggle" role="group" aria-label="视图切换">' +
        '<button type="button" class="category-view-btn' + (mode === 'list' ? ' is-active' : '') + '" data-view="list" title="列表视图" aria-label="列表视图"><i class="bx bx-list-ul"></i></button>' +
        '<button type="button" class="category-view-btn' + (mode === 'grid' ? ' is-active' : '') + '" data-view="grid" title="宫格视图" aria-label="宫格视图"><i class="bx bx-grid-alt"></i></button>' +
        '</div>';
}

function applyCategoryViewMode($root, mode) {
    if (!$root || !$root.length) return;
    var viewMode = mode === 'grid' ? 'grid' : 'list';
    $root.find('.category-items-panel').removeClass('is-list is-grid').addClass(viewMode === 'grid' ? 'is-grid' : 'is-list');
    $root.find('.category-view-btn').removeClass('is-active').filter('[data-view="' + viewMode + '"]').addClass('is-active');
}

// 计算目录页文档项的相对路径（用于 API 回退加载）
function documentRelPathInSubpath(directory, subpath, item) {
    let path = (item.path || item.slug || '').replace(/\.(md|markdown)$/i, '');
    const dirPrefix = (directory || '').replace(/^\/+|\/+$/g, '');
    if (dirPrefix && path.startsWith(dirPrefix + '/')) {
        path = path.substring(dirPrefix.length + 1);
    }
    const base = (subpath || '').replace(/^\/+|\/+$/g, '');
    if (base && path.startsWith(base + '/')) {
        path = path.substring(base.length + 1);
    } else if (base && path === base) {
        path = '';
    }
    return joinCategorySubpath(subpath, path);
}

// 展示分类目录页（无默认文档时的友好空状态）
function showCategoryLanding(directory, subpath, fallbackError) {
    hideArticleNavigation();
    clearDocumentBreadcrumbs();
    if (window.DocPageShare && typeof window.DocPageShare.hide === 'function') {
        window.DocPageShare.hide();
    }
    if (window.DocComments && typeof window.DocComments.hide === 'function') {
        window.DocComments.hide();
    }
    subpath = (subpath || '').replace(/^\/+|\/+$/g, '');

    $('#articleContent').html(
        '<div class="article-loading"><div class="text-center py-5">' +
        '<div class="spinner-border text-primary" role="status"><span class="visually-hidden">Loading...</span></div>' +
        '<p class="mt-3 text-muted">Loading section...</p></div></div>'
    );

    const segments = subpath ? subpath.split('/').filter(function(s) { return s; }) : [];
    const parentSubpath = segments.length > 1 ? segments.slice(0, -1).join('/') : '';
    const lastSeg = segments.length ? segments[segments.length - 1] : '';

    const requests = [
        $.ajax({ url: '/api/directories', type: 'GET', dataType: 'json' }),
        $.ajax({
            url: '/api/docs/filesystem/tree',
            type: 'GET',
            dataType: 'json',
            data: { directory: directory, subpath: subpath }
        })
    ];
    if (subpath) {
        requests.push($.ajax({
            url: '/api/docs/filesystem/tree',
            type: 'GET',
            dataType: 'json',
            data: { directory: directory, subpath: parentSubpath }
        }));
    }

    $.when.apply($, requests).done(function() {
        const args = Array.prototype.slice.call(arguments);
        const dirPayload = (args[0] && args[0][0]) ? args[0][0] : {};
        const treePayload = (args[1] && args[1][0]) ? args[1][0] : {};
        const parentPayload = (args[2] && args[2][0]) ? args[2][0] : null;

        const directories = (dirPayload.success && dirPayload.data) ? (dirPayload.data.list || []) : [];
        const items = (treePayload.success && treePayload.data) ? treePayload.data : null;

        if (items === null) {
            showError(fallbackError || 'Failed to load section');
            return;
        }

        const dirInfo = findDirectoryInfo(directories, directory);
        const dirName = dirInfo ? (dirInfo.alias || dirInfo.name || directory) : directory;
        const dirDesc = dirInfo ? (dirInfo.description || '') : '';
        let dirIcon = dirInfo ? (dirInfo.icon || 'bx-folder') : 'bx-folder';
        if (dirIcon.indexOf('bx ') === 0) {
            dirIcon = dirIcon.replace('bx ', '');
        }
        if (dirIcon.indexOf('bx-') !== 0) {
            dirIcon = 'bx-' + dirIcon;
        }

        let sectionName = dirName;
        let sectionDesc = dirDesc;
        let sectionIcon = dirIcon;

        if (subpath) {
            const parentItems = (parentPayload && parentPayload.success) ? parentPayload.data : [];
            sectionName = matchTreeItemName(parentItems, lastSeg);
            sectionDesc = '';
            sectionIcon = 'bx-folder-open';
        }

        $('#articleHeader').hide();
        $('#articleMeta').hide();

        let breadcrumbHtml = '';
        const itemCountLabel = items.length + ' 项内容';
        const countHtml = items.length > 0 ? '<span class="category-count">' + itemCountLabel + '</span>' : '';
        const viewMode = getCategoryViewMode();
        const viewToggleHtml = items.length > 0 ? buildCategoryViewToggleHtml(viewMode) : '';
        const categoryCrumbs = buildCategoryBreadcrumbCrumbs(directory, dirName, subpath, sectionName);
        const breadcrumbMainHtml = buildCategoryBreadcrumbNavHtml(categoryCrumbs) + countHtml;
        breadcrumbHtml = '<div class="category-breadcrumb-row">' +
            '<div class="category-breadcrumb-main">' + breadcrumbMainHtml + '</div>' +
            viewToggleHtml +
            '</div>';

        let itemsHtml = '';
        if (items.length > 0) {
            itemsHtml = '<div class="category-items-panel ' + (viewMode === 'grid' ? 'is-grid' : 'is-list') + '">' +
                '<div class="category-items-list">';
            items.forEach(function(item) {
                const isCategory = item.type === 'category';
                const itemPath = isCategory
                    ? joinCategorySubpath(subpath, item.path || item.slug || '')
                    : documentRelPathInSubpath(directory, subpath, item);
                const icon = isCategory ? 'bx-folder' : (item.icon || 'bx-file-blank');
                const displayName = item.name + (item.file_ext || '');
                const itemClass = isCategory ? 'category-item category-item--folder' : 'category-item category-item--doc';
                const metaLabel = isCategory ? '子目录' : '文档';
                const itemHref = isCategory
                    ? ('/' + encodeURIComponent(directory) + '/' + encodePathSegments(itemPath))
                    : buildDocPublicUrl(directory, item);
                itemsHtml += '<a href="' + itemHref + '" class="' + itemClass + '" ' +
                    'data-directory="' + escapeHtml(directory) + '" ' +
                    'data-subpath="' + escapeHtml(itemPath) + '" ' +
                    'data-type="' + (isCategory ? 'category' : 'document') + '">' +
                    '<span class="category-item-icon"><i class="bx ' + icon + '"></i></span>' +
                    '<span class="category-item-main">' +
                    '<span class="category-item-title">' + escapeHtml(displayName) + '</span>' +
                    '<span class="category-item-meta">' + metaLabel + '</span>' +
                    '</span>' +
                    '<span class="category-item-arrow" aria-hidden="true"><i class="bx bx-chevron-right"></i></span>' +
                    '</a>';
            });
            itemsHtml += '</div></div>';
        } else {
            itemsHtml = '<div class="category-empty">' +
                '<i class="bx bx-file-blank"></i>' +
                '<p>该目录下暂无文档</p>' +
                '<p class="category-empty-hint">请从左侧导航选择其他目录，或稍后再来查看</p>' +
                '</div>';
        }

        const landingHtml =
            '<div class="category-landing' + (subpath ? ' category-landing--sub' : '') + '">' +
            breadcrumbHtml +
            '<div class="category-items">' + itemsHtml + '</div>' +
            '</div>';

        $('#articleContent').html(landingHtml);
        generateToc('');

        $('.category-breadcrumb-link').on('click', function(e) {
            e.preventDefault();
            const dir = $(this).data('directory');
            const sp = $(this).data('subpath') || '';
            const url = '/' + encodeURIComponent(dir) + (sp ? '/' + encodePathSegments(sp) : '');
            history.pushState(null, '', url);
            setPendingHighlightFromCategoryPath(dir, sp);
            showCategoryLanding(dir, sp);
            resolvePendingNavHighlight();
        });

        $('.category-view-btn').on('click', function() {
            const mode = $(this).data('view');
            setCategoryViewMode(mode);
            applyCategoryViewMode($('#articleContent .category-landing'), mode);
        });

        $('.category-item').on('click', function(e) {
            const href = $(this).attr('href');
            if (!href || href.indexOf('javascript:') === 0) {
                return;
            }
            e.preventDefault();
            const dir = $(this).data('directory');
            const sp = $(this).data('subpath') || '';
            const type = $(this).data('type');
            if (type === 'document') {
                const location = parseDocLocationFromPath(href);
                if (location) {
                    loadDocumentFromLocation(location, true);
                } else {
                    loadDocumentByPublicPath(dir, sp, true);
                }
            } else {
                history.pushState(null, '', href);
                setPendingHighlightFromCategoryPath(dir, sp);
                showCategoryLanding(dir, sp);
                resolvePendingNavHighlight();
            }
        });

        setPendingHighlightFromCategoryPath(directory, subpath);
        resolvePendingNavHighlight();
    }).fail(function() {
        showError(fallbackError || 'Failed to load section');
    });
}

// 显示错误
function showError(message) {
    $('#articleContent').html(`
        <div class="error-content">
            <div class="text-center py-5">
                <i class='bx bx-error display-1 text-danger mb-4'></i>
                <h3 class="text-danger">Something went wrong</h3>
                <p class="text-muted">${escapeHtml(message)}</p>
                <button class="btn btn-primary" onclick="location.reload()">Reload</button>
            </div>
        </div>
    `);
    
    // 清空TOC并隐藏
    generateToc('');
}

// 处理行内 Markdown（粗体、斜体、代码、链接）
function processInlineMarkdown(text) {
    if (!text) return '';
    return String(text)
        .replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
        .replace(/\*(.*?)\*/g, '<em>$1</em>')
        .replace(/`([^`]+)`/g, '<code>$1</code>')
        .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
}

// 简单的 Markdown 转 HTML（基础支持）
function simpleMarkdownToHtml(markdown) {
    if (!markdown) return '';
    markdown = String(markdown).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
    
    // 存储代码块的占位符
    const codeBlocks = [];
    let codeBlockIndex = 0;
    
    // HTML 转义函数（用于代码块内容）
    const escapeHtmlForCode = function(text) {
        if (!text) return '';
        // 转义 HTML 特殊字符，确保代码原样显示
        return String(text)
            .replace(/&/g, '&amp;')
            .replace(/</g, '&lt;')
            .replace(/>/g, '&gt;')
            .replace(/"/g, '&quot;')
            .replace(/'/g, '&#39;');
    };
    
    // 第一步：先保护代码块，用占位符替换
    // 匹配 ```语言类型 或 ``` 开头的代码块
    // 正则说明：``` 后跟可选的语言标识（字母、数字、连字符），然后是换行，最后是代码内容
    // 只去掉首尾换行，保留行首空格（ASCII 图示对齐依赖缩进）
    const normalizeCodeBlock = function(raw) {
        let s = String(raw).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
        if (s.startsWith('\n')) s = s.slice(1);
        if (s.endsWith('\n')) s = s.slice(0, -1);
        return s;
    };

    let html = markdown.replace(/```(\w+)?\s*\n([\s\S]*?)```/g, function(match, lang, code) {
        const placeholder = `__CODE_BLOCK_${codeBlockIndex}__`;
        const escapedCode = escapeHtmlForCode(normalizeCodeBlock(code));
        
        // 如果有语言类型，创建带徽标的代码块
        if (lang && lang.trim()) {
            const langLower = lang.trim().toLowerCase();
            if (langLower === 'mermaid') {
                const rawCode = normalizeCodeBlock(code);
                const safeCode = escapeHtmlForCode(rawCode);
                codeBlocks[codeBlockIndex] = '<div class="mermaid-diagram-wrapper mermaid-pending" data-mermaid-source="' + escapeHtmlForCode(rawCode) + '"><div class="mermaid-diagram-container"><pre class="mermaid">' + safeCode + '</pre></div></div>';
            } else {
                // 所有语言类型都显示为徽标（sql, php, javascript, python 等）
                codeBlocks[codeBlockIndex] = '<div class="code-block-wrapper"><div class="code-lang-badge">' + escapeHtmlForCode(langLower) + '</div><pre><code>' + escapedCode + '</code></pre></div>';
            }
        } else {
            // 没有语言类型，普通代码块
            codeBlocks[codeBlockIndex] = '<div class="code-block-wrapper"><pre><code>' + escapedCode + '</code></pre></div>';
        }
        codeBlockIndex++;
        return placeholder;
    });
    
    // 第二步：按行处理，识别块级元素
    const lines = html.split('\n');
    const result = [];
    let inList = false;
    let listType = null; // 'ul' or 'ol'
    let listItems = [];
    let inTable = false;
    let tableRows = [];
    let tableHeaders = [];
    let tableAlignments = [];
    
    // 辅助函数：解析表格行
    const parseTableRow = function(line) {
        // 移除首尾的 |，然后按 | 分割
        const cells = line.replace(/^\|/, '').replace(/\|$/, '').split('|').map(cell => cell.trim());
        return cells;
    };
    
    // 辅助函数：解析表格对齐方式
    const parseTableAlignment = function(line) {
        const cells = parseTableRow(line);
        const alignments = [];
        for (let i = 0; i < cells.length; i++) {
            const cell = cells[i];
            if (cell.match(/^:?-+:?$/)) {
                if (cell.startsWith(':') && cell.endsWith(':')) {
                    alignments.push('center');
                } else if (cell.endsWith(':')) {
                    alignments.push('right');
                } else {
                    alignments.push('left');
                }
            } else {
                alignments.push('left');
            }
        }
        return alignments;
    };
    
    // 辅助函数：处理表格单元格内容（转义HTML并处理行内格式）
    const processTableCell = function(cell) {
        if (!cell) return '';
        // 先转义HTML特殊字符
        let processed = String(cell)
            .replace(/&/g, '&amp;')
            .replace(/</g, '&lt;')
            .replace(/>/g, '&gt;')
            .replace(/"/g, '&quot;')
            .replace(/'/g, '&#39;');
        // 然后处理行内格式（粗体、斜体、代码、链接）
        processed = processed
            .replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
            .replace(/\*(.*?)\*/g, '<em>$1</em>')
            .replace(/`([^`]+)`/g, '<code>$1</code>')
            .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
        return processed;
    };
    
    // 辅助函数：渲染表格
    const renderTable = function() {
        if (tableRows.length === 0 && tableHeaders.length === 0) {
            return '';
        }
        
        let tableHtml = '<div class="table-responsive"><table class="table table-bordered table-striped table-sm">\n';
        
        // 表头
        if (tableHeaders.length > 0) {
            tableHtml += '<thead><tr>\n';
            for (let i = 0; i < tableHeaders.length; i++) {
                const align = tableAlignments[i] || 'left';
                const alignStyle = align === 'center' ? 'text-center' : (align === 'right' ? 'text-end' : 'text-start');
                const cellContent = processTableCell(tableHeaders[i]);
                tableHtml += `<th class="${alignStyle}">${cellContent}</th>\n`;
            }
            tableHtml += '</tr></thead>\n';
        }
        
        // 表体
        if (tableRows.length > 0) {
            tableHtml += '<tbody>\n';
            for (let i = 0; i < tableRows.length; i++) {
                tableHtml += '<tr>\n';
                for (let j = 0; j < tableRows[i].length; j++) {
                    const align = tableAlignments[j] || 'left';
                    const alignStyle = align === 'center' ? 'text-center' : (align === 'right' ? 'text-end' : 'text-start');
                    const cellContent = processTableCell(tableRows[i][j]);
                    tableHtml += `<td class="${alignStyle}">${cellContent}</td>\n`;
                }
                tableHtml += '</tr>\n';
            }
            tableHtml += '</tbody>\n';
        }
        tableHtml += '</table></div>\n';
        
        return tableHtml;
    };
    
    for (let i = 0; i < lines.length; i++) {
        const line = lines[i].trim();
        
        // 跳过空行（但保留用于段落分隔）
        if (line === '') {
            // 如果有未关闭的列表，先关闭它
            if (inList) {
                result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                listItems = [];
                inList = false;
                listType = null;
            }
            // 如果有未关闭的表格，先关闭它（表格后的空行不添加到结果中，避免产生多余的 <br>）
            if (inTable || tableHeaders.length > 0) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
                // 表格后的空行不添加到结果中，直接跳过
                continue;
            }
            // 其他空行保留用于段落分隔
            result.push('');
            continue;
        }
        
        // 处理标题（h1-h6）
        if (line.match(/^#{1,6}\s+/)) {
            // 如果有未关闭的列表，先关闭它
            if (inList) {
                result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                listItems = [];
                inList = false;
                listType = null;
            }
            // 如果有未关闭的表格，先关闭它
            if (inTable) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
            }
            
            const match = line.match(/^(#{1,6})\s+(.*)$/);
            if (match) {
                const level = match[1].length;
                const text = match[2];
                result.push(`<h${level}>${text}</h${level}>`);
            }
            continue;
        }
        
        // 处理表格
        // 表格行：以 | 开头或包含 | 分隔符
        if (line.includes('|') && line.split('|').length >= 2) {
            // 检查是否是分隔行（对齐行，只包含 |、-、:、空格）
            const isSeparator = line.match(/^[\s|:\-]+$/);
            if (isSeparator) {
                // 这是对齐行，解析对齐方式
                if (tableHeaders.length > 0 && tableAlignments.length === 0) {
                    tableAlignments = parseTableAlignment(line);
                    inTable = true; // 标记已进入表格模式
                }
                continue;
            } else {
                // 这是数据行或表头行
                const cells = parseTableRow(line);
                if (cells.length > 0) {
                    if (tableHeaders.length === 0) {
                        // 第一行是表头
                        tableHeaders = cells;
                    } else if (inTable && tableAlignments.length > 0) {
                        // 已经解析了对齐行，这是数据行
                        tableRows.push(cells);
                    } else if (tableHeaders.length > 0 && tableAlignments.length === 0) {
                        // 有表头但还没有对齐行，可能是格式不标准的表格
                        // 默认使用左对齐，然后添加数据行
                        if (tableHeaders.length > 0) {
                            tableAlignments = new Array(tableHeaders.length).fill('left');
                            inTable = true;
                            tableRows.push(cells);
                        }
                    }
                    continue;
                }
            }
        } else if (inTable || tableHeaders.length > 0) {
            // 当前行不是表格行，但之前有表格，关闭表格
            result.push(renderTable());
            tableRows = [];
            tableHeaders = [];
            tableAlignments = [];
            inTable = false;
        }
        
        // 处理无序列表项（- 或 * 开头）
        if (line.match(/^[-*]\s+/)) {
            // 如果有未关闭的表格，先关闭它
            if (inTable) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
            }
            
            const text = processInlineMarkdown(line.replace(/^[-*]\s+/, ''));
            if (!inList || listType !== 'ul') {
                // 如果有未关闭的列表，先关闭它
                if (inList) {
                    result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                    listItems = [];
                }
                inList = true;
                listType = 'ul';
                listItems = [text];
            } else {
                listItems.push(text);
            }
            continue;
        }
        
        // 处理有序列表项（数字. 开头）
        if (line.match(/^\d+\.\s+/)) {
            // 如果有未关闭的表格，先关闭它
            if (inTable) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
            }
            
            const text = processInlineMarkdown(line.replace(/^\d+\.\s+/, ''));
            if (!inList || listType !== 'ol') {
                // 如果有未关闭的列表，先关闭它
                if (inList) {
                    result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                    listItems = [];
                }
                inList = true;
                listType = 'ol';
                listItems = [text];
            } else {
                listItems.push(text);
            }
            continue;
        }
        
        // 水平线
        if (line.match(/^(-{3,}|\*{3,}|_{3,})\s*$/)) {
            if (inTable || tableHeaders.length > 0) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
            }
            if (inList) {
                result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                listItems = [];
                inList = false;
                listType = null;
            }
            result.push('<hr>');
            continue;
        }

        // 引用块
        if (line.match(/^>\s?/)) {
            if (inTable || tableHeaders.length > 0) {
                result.push(renderTable());
                tableRows = [];
                tableHeaders = [];
                tableAlignments = [];
                inTable = false;
            }
            if (inList) {
                result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
                listItems = [];
                inList = false;
                listType = null;
            }
            const quoteLines = [];
            while (i < lines.length && lines[i].trim().match(/^>\s*/)) {
                quoteLines.push(lines[i].trim().replace(/^>\s*/, ''));
                i++;
            }
            i--;
            result.push('<blockquote>' + quoteLines.map(function(l) {
                return processInlineMarkdown(l);
            }).join('<br>') + '</blockquote>');
            continue;
        }

        // 普通文本行
        // 如果有未关闭的表格，先关闭它
        if (inTable) {
            result.push(renderTable());
            tableRows = [];
            tableHeaders = [];
            tableAlignments = [];
            inTable = false;
        }
        
        // 如果有未关闭的列表，先关闭它
        if (inList) {
            result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
            listItems = [];
            inList = false;
            listType = null;
        }
        
        result.push(line);
    }
    
    // 关闭最后一个列表
    if (inList) {
        result.push(`<${listType}><li>${listItems.join('</li><li>')}</li></${listType}>`);
    }
    
    // 关闭最后一个表格
    if (inTable) {
        result.push(renderTable());
    }
    
    // 第三步：合并结果，处理行内格式和换行
    html = result.join('\n');
    
    // 处理行内格式（粗体、斜体、代码、链接）；跳过已渲染的列表块，避免重复解析
    html = html.split(/(<(?:ul|ol)>[\s\S]*?<\/(?:ul|ol)>)/g).map(function(part) {
        if (!part || part.match(/^<(ul|ol)>/)) {
            return part || '';
        }
        return processInlineMarkdown(part);
    }).join('');
    
    // 第四步：处理换行和段落
    // 保留表格前后的段落分隔（\n\n），切勿压成单换行，否则标题会与表格并入同一段，
    // 随后 \n → <br> 会把表格内部换行变成大量空行。
    html = html.replace(/<\/table><\/div>\s*\n{3,}/g, '</table></div>\n\n');
    html = html.replace(/\n{3,}/g, '\n\n');
    
    const paragraphs = html.split(/\n\n+/);
    const processedParagraphs = [];
    
    for (let i = 0; i < paragraphs.length; i++) {
        let para = paragraphs[i].trim();
        if (!para) continue;

        if (para.indexOf('<div class="table-responsive">') !== -1) {
            const tableRe = /(<div class="table-responsive">[\s\S]*?<\/table><\/div>)/gi;
            let lastIndex = 0;
            let m;
            while ((m = tableRe.exec(para)) !== null) {
                const before = para.slice(lastIndex, m.index).trim();
                if (before) {
                    if (before.match(/^<(h[1-6]|pre|ul|ol|table|blockquote)/i)) {
                        processedParagraphs.push(before);
                    } else {
                        processedParagraphs.push('<p>' + before.replace(/\n/g, '<br>') + '</p>');
                    }
                }
                processedParagraphs.push(m[1].replace(/<br\s*\/?>/gi, ''));
                lastIndex = m.index + m[0].length;
            }
            const after = para.slice(lastIndex).trim();
            if (after) {
                if (after.match(/^<(h[1-6]|pre|ul|ol|table|blockquote|div)/i)) {
                    processedParagraphs.push(after);
                } else {
                    processedParagraphs.push('<p>' + after.replace(/\n/g, '<br>') + '</p>');
                }
            }
            continue;
        }
        
        if (para.match(/^__CODE_BLOCK_\d+__$/) || para.match(/^<(h[1-6]|pre|ul|ol|table|blockquote|hr|div class="table-responsive")/i)) {
            processedParagraphs.push(para);
        } else {
            para = para.replace(/\n/g, '<br>');
            processedParagraphs.push(`<p>${para}</p>`);
        }
    }
    
    html = processedParagraphs.join('\n');
    
    html = html.replace(/(<br\s*\/?>)+(\s*)<div class="table-responsive">/gi, '$2<div class="table-responsive">');
    html = html.replace(/<\/table><\/div>(\s*)(<br\s*\/?>)+/gi, '</table></div>$1');
    html = html.replace(/<p>\s*<\/p>\s*<div class="table-responsive">/gi, '<div class="table-responsive">');
    html = html.replace(/<\/table><\/div>\s*<p>\s*<\/p>/gi, '</table></div>');
    html = html.replace(/(<div class="table-responsive">[\s\S]*?<\/table><\/div>)/gi, function(block) {
        return block.replace(/<br\s*\/?>/gi, '');
    });
    
    // 第五步：恢复代码块
    for (let i = 0; i < codeBlocks.length; i++) {
        html = html.replace(`__CODE_BLOCK_${i}__`, codeBlocks[i]);
    }
    html = html.replace(/<p>\s*(<div class="code-block-wrapper">[\s\S]*?<\/div>)\s*<\/p>/gi, '$1');
    html = html.replace(/<p>\s*(<div class="mermaid-diagram-wrapper">[\s\S]*?<\/div>)\s*<\/p>/gi, '$1');
    
    return html;
}

// 浏览器前进后退支持
window.addEventListener('popstate', function(event) {
    console.log('[popstate] 浏览器历史记录变化，当前路径:', window.location.pathname);
    
    const path = window.location.pathname;
    const pathParts = path.split('/').filter(p => p);
    
    const parsed = parseDocLocationFromPath(path);
    if (parsed) {
        pendingHighlightDoc.directory = parsed.directory;
        pendingHighlightDoc.docId = null;
        pendingHighlightDoc.shortId = null;
        if (parsed.mode === 'path') {
            pendingHighlightDoc.docPath = parsed.docPath || null;
            pendingHighlightDoc.categorySlug = parsed.docPath ? parsed.docPath.replace(/^\/+|\/+$/g, '') : null;
        } else if (parsed.mode === 'id') {
            pendingHighlightDoc.shortId = parsed.docId;
            pendingHighlightDoc.categorySlug = null;
            pendingHighlightDoc.docPath = null;
        }
        loadNavigation(parsed.directory);
        setTimeout(function() {
            loadDocumentFromLocation(parsed, false, {
                preserveHash: !!window.location.hash,
                scrollToHash: !!window.location.hash
            });
        }, 100);
        return;
    }
    
    // 如果只有目录路径，展示分类目录页
    if (pathParts.length === 1 && pathParts[0] !== '') {
        const directory = pathParts[0];
        // 排除已知路径
        if (directory !== 'api' && directory !== 'static' && directory !== 'template' && directory !== 'admin') {
            loadNavigation(directory);
            showCategoryLanding(directory, '');
            return;
        }
    }
    
    // 根路径或其他情况，显示默认内容
    console.log('[popstate] 显示默认内容');
    loadDefaultContent();
});
    
// 初始化 highlight.js 语法高亮
function shouldSkipSyntaxHighlight(codeText, lang) {
    if (lang === 'mermaid' || lang === 'text' || lang === 'plaintext') {
        return true;
    }
    if (/[┌┐└┘│─┼├┤┬┴┈┊╭╮╯╰╔╗╝╚║═╬]/.test(codeText)) {
        return true;
    }
    if (!lang) {
        return true;
    }
    return false;
}

function applyArticleImageLazyLoading() {
    const $ = window.jQuery || window.$;
    if (!$) return;
    const $imgs = $('#articleContent .article-content-rendered img, #articleContent .article-content img');
    $imgs.each(function() {
        const alt = (this.getAttribute('alt') || '').trim();
        if (alt && !this.getAttribute('title')) {
            this.setAttribute('title', alt);
        }
        if (!this.getAttribute('loading')) {
            this.setAttribute('loading', 'lazy');
        }
    });
}

function initArticleImageViewer() {
    if (!window.SdImageViewer || typeof SdImageViewer.initArticleContentViewer !== 'function') {
        return;
    }
    SdImageViewer.initArticleContentViewer();
}

function initSyntaxHighlight() {
    if (typeof hljs === 'undefined') {
        console.warn('highlight.js 未加载，跳过语法高亮');
        // 如果 highlight.js 未加载，尝试延迟重试
        setTimeout(function() {
            if (typeof hljs !== 'undefined') {
                initSyntaxHighlight();
            }
        }, 500);
        return;
    }
    
    const $ = window.jQuery || window.$;
    if (typeof $ === 'undefined') {
        console.warn('jQuery 未加载，跳过语法高亮');
        return;
    }
    
    const $content = $('#articleContent .article-content-rendered, #articleContent .article-content');
    
    if ($content.length === 0) {
        return;
    }
    
    // 查找所有代码块
    $content.find('pre code').each(function() {
        const $code = $(this);
        
        // 如果已经有 highlight.js 处理过，跳过
        if ($code.hasClass('hljs')) {
            return;
        }
        
        // 获取语言类型（从 class 或父元素）
        let lang = $code.attr('class') || '';
        // 移除 language- 前缀和 hljs 类名
        lang = lang.replace(/language-|hljs/g, '').trim();
        // 统一语言名为小写，避免 PHP/Go 等大小写导致 hljs.getLanguage 识别失败
        if (lang) {
            lang = String(lang).toLowerCase();
        }
        
        // 如果没有语言类型，尝试从父元素获取
        if (!lang) {
            const $pre = $code.parent('pre');
            const $wrapper = $pre.parent('.code-block-wrapper');
            if ($wrapper.length > 0) {
                const langBadge = $wrapper.find('.code-lang-badge');
                if (langBadge.length > 0) {
                    lang = langBadge.text().trim().toLowerCase();
                }
            }
        }
        
        // 获取原始代码文本（需要先获取，因为高亮后会改变 HTML）
        const codeText = $code.text();
        
        if (shouldSkipSyntaxHighlight(codeText, lang)) {
            return;
        }
        
        // 高亮代码
        if (lang && hljs.getLanguage(lang)) {
            try {
                // highlight.js 11.9.0 API: hljs.highlight(code, options)
                const highlighted = hljs.highlight(codeText, { language: lang });
                $code.html(highlighted.value);
                $code.addClass('hljs');
                // 保留语言类名
                if (!$code.hasClass('language-' + lang)) {
                    $code.addClass('language-' + lang);
                }
            } catch (e) {
                console.warn('语法高亮失败:', e, '语言:', lang);
                // 降级到自动检测
                try {
                    const highlighted = hljs.highlightAuto(codeText);
                    $code.html(highlighted.value);
                    $code.addClass('hljs');
                } catch (e2) {
                    console.warn('自动语法高亮也失败:', e2);
                }
            }
        } else {
            // 自动检测语言
            try {
                // highlight.js 11.9.0 API: hljs.highlightAuto(code, options)
                const highlighted = hljs.highlightAuto(codeText);
                $code.html(highlighted.value);
                $code.addClass('hljs');
                // 如果检测到语言，添加语言类名
                if (highlighted.language) {
                    $code.addClass('language-' + highlighted.language);
                }
            } catch (e) {
                console.warn('自动语法高亮失败:', e);
            }
        }
    });
}

// 渲染 CSV 文件为表格
function renderCSVFiles() {
    const $ = window.jQuery || window.$;
    const $content = $('#articleContent .article-content-rendered, #articleContent .article-content');
    
    if ($content.length === 0) {
        return;
    }
    
    // 检查是否有 CSV 内容（通过文件扩展名或内容特征判断）
    // 这里我们假设 CSV 内容已经在服务端处理，或者通过 data-file-type 属性标识
    $content.find('[data-file-type="csv"], .csv-content').each(function() {
        const $container = $(this);
        const csvText = $container.text().trim();
        
        if (!csvText) {
            return;
        }
        
        // 解析 CSV（简单实现）
        const lines = csvText.split('\n').filter(line => line.trim());
        if (lines.length === 0) {
            return;
        }
        
        let html = '<div class="csv-table-wrapper"><table class="table table-bordered table-striped table-sm table-hover">\n';
        
        lines.forEach(function(line, index) {
            const fields = line.split(',').map(f => f.trim());
            
            if (index === 0) {
                // 表头
                html += '<thead><tr>\n';
                fields.forEach(function(field) {
                    html += `<th>${escapeHtml(field)}</th>\n`;
                });
                html += '</tr></thead><tbody>\n';
            } else {
                // 数据行
                html += '<tr>\n';
                fields.forEach(function(field) {
                    html += `<td>${escapeHtml(field)}</td>\n`;
                });
                html += '</tr>\n';
            }
        });
        
        html += '</tbody></table></div>\n';
        $container.html(html);
    });
}

// 获取当前文档ID（优先使用short_id混淆ID）
function getCurrentDocumentID() {
    const $ = window.jQuery || window.$;
    
    // 优先从页面数据中获取 short_id（服务端渲染时注入）
    if (window.currentDocumentData && window.currentDocumentData.short_id) {
        return window.currentDocumentData.short_id;
    }
    
    // 尝试从URL查询参数获取
    const urlParams = new URLSearchParams(window.location.search);
    const docIDStr = urlParams.get('doc_id');
    if (docIDStr) {
        return docIDStr;
    }
    
    // 尝试从URL路径中获取（新格式：/{directory}/{id}/{slug}）
    const pathParts = window.location.pathname.split('/').filter(p => p);
    const idIndex = typeof findDocumentIDSegmentIndex === 'function' ? findDocumentIDSegmentIndex(pathParts) : -1;
    if (idIndex > 0) {
        let idPart = pathParts[idIndex];
        try {
            idPart = decodeURIComponent(pathParts[idIndex]);
        } catch (e) {}
        if (typeof isLikelyDocumentIDSegment === 'function' && isLikelyDocumentIDSegment(idPart)) {
            return idPart;
        }
    }
    
    return null;
}

// 加载文档统计数据
function loadDocumentStats(docID, shortID) {
    const $ = window.jQuery || window.$;
    
    // 优先使用 short_id（混淆ID），如果没有则使用数字ID
    // 注意：不要使用 encodeID，因为那是 Base62 编码，不是后端的混淆ID格式
    let docIDStr = shortID || docID;
    if (typeof docIDStr === 'number') {
        // 如果是数字且没有 shortID，尝试从页面数据获取
        if (window.currentDocumentData && window.currentDocumentData.short_id) {
            docIDStr = window.currentDocumentData.short_id;
        } else {
            // 如果都没有，使用数字ID（后端会尝试解析）
            docIDStr = docIDStr.toString();
        }
    }
    
    // 显示统计信息区域（如果还没有显示）
    if (!$('#articleMeta').is(':visible')) {
        $('#articleMeta').show();
    }
    
    // 延迟2秒后记录浏览数（作为有效浏览）
    setTimeout(function() {
        $.ajax({
            url: `/api/documents/${docIDStr}/view`,
            type: 'POST',
            dataType: 'json',
            success: function(res) {
                if (res.success && res.view_count !== undefined) {
                    $('#viewCount .stat-value').text(res.view_count || 0);
                }
            },
            error: function() {
                console.error('更新浏览数失败');
            }
        });
    }, 2000); // 延迟2秒
    
    // 获取点赞状态（实时更新）
    $.ajax({
        url: `/api/documents/${docIDStr}/like`,
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success) {
                const cookieName = `doc_like_${docID}`;
                const likeCookie = getCookie(cookieName);
                const isLiked = res.is_liked || (likeCookie === '1');
                updateLikeUI(isLiked, res.like_count || 0);
            }
        }
    });

    // 获取收藏状态（实时更新）
    $.ajax({
        url: `/api/documents/${docIDStr}/favorite`,
        type: 'GET',
        dataType: 'json',
        success: function(res) {
            if (res.success) {
                updateFavoriteUI(!!res.is_favorited, res.favorite_count || 0);
            }
        }
    });

    if (window.DocComments && typeof window.DocComments.reload === 'function') {
        window.DocComments.reload();
    }
}

function resolveDocumentIDStr(docID) {
    let docIDStr = docID;
    if (typeof docID === 'number') {
        if (window.currentDocumentData && window.currentDocumentData.short_id) {
            docIDStr = window.currentDocumentData.short_id;
        } else {
            docIDStr = docIDStr.toString();
        }
    }
    return docIDStr;
}

function updateLikeUI(isLiked, count) {
    const $ = window.jQuery || window.$;
    const $btn = $('#btnLike');
    if (!$btn.length) return;
    $btn.find('.stat-value').text(count || 0);
    $btn.toggleClass('active', !!isLiked);
    $btn.find('i').attr('class', isLiked ? 'bx bxs-like' : 'bx bx-like');
    $btn.attr('title', docsT(isLiked ? 'actionLiked' : 'actionLike', isLiked ? 'Liked' : 'Like'));
}

function updateFavoriteUI(isFavorited, count) {
    const $ = window.jQuery || window.$;
    const $btn = $('#btnFavorite');
    if (!$btn.length) return;
    $btn.find('.stat-value').text(count || 0);
    $btn.toggleClass('active', !!isFavorited);
    $btn.find('i').attr('class', isFavorited ? 'bx bxs-star' : 'bx bx-star');
    $btn.attr('title', docsT(isFavorited ? 'actionFavorited' : 'actionFavorite', isFavorited ? 'Saved' : 'Save'));
}

// 点赞/取消点赞文档（支持游客点赞，但仅登录用户可取消）
function toggleLike(docID) {
    const $ = window.jQuery || window.$;
    const docIDStr = resolveDocumentIDStr(docID);
    const $btn = $('#btnLike');
    const isLiked = $btn.hasClass('active');
    const method = isLiked ? 'DELETE' : 'POST';

    $.ajax({
        url: `/api/documents/${docIDStr}/like`,
        type: method,
        dataType: 'json',
        success: function(res) {
            if (res.success) {
                updateLikeUI(!!res.is_liked, res.like_count || 0);
                BootstrapModal.msg(docsT(res.is_liked ? 'actionLiked' : 'actionUnliked', res.is_liked ? 'Liked' : 'Like removed'), {icon: res.is_liked ? 1 : 0});
            } else {
                const alreadyLiked = !!(res.is_liked || (res.message && (res.message.indexOf('Already') >= 0 || res.message.indexOf('already') >= 0 || res.message.indexOf('Liked') >= 0)));
                if (alreadyLiked) {
                    updateLikeUI(true, res.like_count || $btn.find('.stat-value').text());
                }
                const errorMsg = alreadyLiked
                    ? docsT('actionLikeAlready', 'You already liked this page')
                    : docsT('actionErrorGeneric', 'Something went wrong. Try again.');
                BootstrapModal.msg(errorMsg, {icon: alreadyLiked ? 0 : 2});
            }
        },
        error: function(xhr) {
            let errorMsg = docsT('actionErrorGeneric', 'Something went wrong. Try again.');
            if (xhr.status === 401) {
                errorMsg = docsT('actionLoginRequired', 'Sign in to continue');
            }
            BootstrapModal.msg(errorMsg, {icon: 2});
        }
    });
}

// 举报文档（仅登录用户，弹窗样式同用户项目页）
function openDocumentReport(docID) {
    const $ = window.jQuery || window.$;
    const docIDStr = resolveDocumentIDStr(docID);
    if (!docIDStr) {
        BootstrapModal.msg(docsT('actionErrorGeneric', 'Something went wrong. Try again.'), {icon: 2});
        return;
    }
    if (!(window.DocsCommentConfig && window.DocsCommentConfig.userLoggedIn)) {
        BootstrapModal.msg(docsT('reportLoginRequired', 'Sign in to report'), {icon: 2});
        return;
    }
    var modalEl = document.getElementById('docReportModal');
    if (!modalEl || typeof bootstrap === 'undefined' || !bootstrap.Modal) {
        BootstrapModal.msg(docsT('actionErrorGeneric', 'Something went wrong. Try again.'), {icon: 2});
        return;
    }
    $('#docReportDocId').val(docIDStr);
    $('#docReportReason').val('spam');
    $('#docReportDetail').val('');
    bootstrap.Modal.getOrCreateInstance(modalEl).show();
}

function submitDocumentReport() {
    const $ = window.jQuery || window.$;
    var docIDStr = ($('#docReportDocId').val() || '').trim();
    var reason = ($('#docReportReason').val() || '').trim();
    var detail = ($('#docReportDetail').val() || '').trim();
    if (!docIDStr) {
        BootstrapModal.msg(docsT('actionErrorGeneric', 'Something went wrong. Try again.'), {icon: 2});
        return;
    }
    if (!reason) {
        BootstrapModal.msg(docsT('reportReasonRequired', 'Select a reason'), {icon: 2});
        return;
    }
    var $btn = $('#docReportSubmitBtn');
    $btn.prop('disabled', true);
    $.ajax({
        url: '/api/documents/' + docIDStr + '/report',
        type: 'POST',
        contentType: 'application/json',
        dataType: 'json',
        data: JSON.stringify({ reason: reason, detail: detail }),
        success: function(res) {
            $btn.prop('disabled', false);
            if (res.success) {
                var modalEl = document.getElementById('docReportModal');
                if (modalEl && typeof bootstrap !== 'undefined' && bootstrap.Modal) {
                    var inst = bootstrap.Modal.getInstance(modalEl);
                    if (inst) inst.hide();
                }
                BootstrapModal.msg(res.message || docsT('reportSuccess', "Report submitted. We'll review it soon."), {icon: 1});
            } else {
                BootstrapModal.msg(res.message || docsT('actionErrorGeneric', 'Something went wrong. Try again.'), {icon: 2});
            }
        },
        error: function(xhr) {
            $btn.prop('disabled', false);
            var errorMsg = docsT('actionErrorGeneric', 'Something went wrong. Try again.');
            if (xhr.status === 401) {
                errorMsg = docsT('reportLoginRequired', 'Sign in to report');
            } else if (xhr.responseJSON && xhr.responseJSON.message) {
                errorMsg = xhr.responseJSON.message;
            }
            BootstrapModal.msg(errorMsg, {icon: 2});
        }
    });
}

// 收藏/取消收藏文档（需登录）
function toggleFavorite(docID) {
    const $ = window.jQuery || window.$;
    const docIDStr = resolveDocumentIDStr(docID);
    const $btn = $('#btnFavorite');
    const isFavorited = $btn.hasClass('active');
    const method = isFavorited ? 'DELETE' : 'POST';

    $.ajax({
        url: `/api/documents/${docIDStr}/favorite`,
        type: method,
        dataType: 'json',
        success: function(res) {
            if (res.success) {
                updateFavoriteUI(!!res.is_favorited, res.favorite_count || 0);
                BootstrapModal.msg(docsT(res.is_favorited ? 'actionFavorited' : 'actionUnfavorited', res.is_favorited ? 'Saved' : 'Unsaved'), {icon: res.is_favorited ? 1 : 0});
            } else {
                const errorMsg = docsT('actionFavoriteLogin', 'Sign in to save');
                BootstrapModal.msg(errorMsg, {icon: 2});
            }
        },
        error: function(xhr) {
            let errorMsg = docsT('actionFavoriteLogin', 'Sign in to save');
            if (xhr.status !== 401 && xhr.responseJSON && xhr.responseJSON.message) {
                const raw = String(xhr.responseJSON.message || '');
                if (raw.indexOf('Already') >= 0 || raw.indexOf('already') >= 0 || raw.indexOf('Saved') >= 0) {
                    errorMsg = docsT('actionFavoriteAlready', 'You already saved this page');
                }
            }
            BootstrapModal.msg(errorMsg, {icon: 2});
        }
    });
}

// 获取Cookie
function getCookie(name) {
    const value = `; ${document.cookie}`;
    const parts = value.split(`; ${name}=`);
    if (parts.length === 2) return parts.pop().split(';').shift();
    return null;
}

// 绑定点赞/收藏交互
$(document).ready(function() {
    const $ = window.jQuery || window.$;

    $(document).on('click', '#btnLike', function() {
        const docID = getCurrentDocumentID();
        if (docID) {
            toggleLike(docID);
        }
    });

    $(document).on('click', '#btnFavorite', function() {
        const docID = getCurrentDocumentID();
        if (docID) {
            toggleFavorite(docID);
        }
    });

    $(document).on('click', '#btnReport', function() {
        const docID = getCurrentDocumentID();
        if (docID) {
            openDocumentReport(docID);
        }
    });

    $(document).on('click', '#docReportSubmitBtn', function() {
        submitDocumentReport();
    });
});

})(jQuery || window.jQuery || window.$);
</script>
<script src="{{asset "/template/default/assets/js/document-attach-link.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-comments.js"}}"></script>
<script src="{{asset "/static/js/qrcode.min.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-page-share.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-font-size.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-content-view.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-print.js"}}"></script>
<script src="{{asset "/template/default/assets/js/doc-text-share.js"}}"></script>

<!-- 样式已整合到 docs.css 统一维护 -->
{{end}}