# 灵声智库：站点架构总览 (V8.0 PRO)

本项目是一个高性能、全自动化的 ASR 解决方案品牌站点。采用 **Zero-Dependency (零依赖)** 静态架构，由单个 Python 脚本驱动全站渲染。

---

## 🏗️ 1. 核心目录结构 (Directory Structure)

```text
/site2_aigv
├── index.html                # 首页 (由 site_builder 自动生成)
├── solutions.html            # 解决方案页 (由 site_builder 自动生成)
├── news-list.html            # 资讯列表 (支持分页)
├── news/                     # 
│   ├── article-template.html # 文章详情页母版
│   ├── *.md                  # 1500+ 字技术源文件 (需保留)
│   └── *.html                # 渲染后的详情页面
├── img/                      # 
│   ├── logo.png              # 品牌 Logo (主视觉)
│   └── article/              # 4K 品牌配图库 (Hero Mapped)
└── site_builder_v5.py        # 🚀 全站核心渲染中枢 (V7.4.1 PRO)
```

---

## ⚙️ 2. 全自动渲染引擎 (Automation Engine)

### **`site_builder_v5.py`**
- **馈送同步**：统一首页与解决方案页的文章呈现顺序。
- **视觉映射**：前三篇核心文章映射专属视觉；4-10 篇自动轮询配图库。
- **SEO 自动化**：自动基于 MD 元数据生成 `<title>`、`<meta>` 及面包屑导航。
- **UI 风格锚定**：内置 TailwindCSS 全局主题配置，分页按钮统一定义为 `#003da6`。

---

## 🚑 3. 灾难恢复与维护 (Disaster Recovery)

- **源码丢失**：若 `news/*.md` 被误删，运行 `python restore_news.py` 即可从渲染后的 HTML 中提取并重新重建所有 Markdown 源。
- **视觉异常**：若详情页出现多余图片，请检查 `news/article-template.html` 并在 header 处确保删除了 `h-[400px]` 容器。

---
📝 *最后修订: 2026-03-31 | 使命：极致、稳定、专业。*