diff --git a/apps/ai-game-creator-shell/src-tauri/src/main.rs b/apps/ai-game-creator-shell/src-tauri/src/main.rs
index fe77f4532..f6764b155 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/main.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/main.rs
@@ -284,6 +284,7 @@ mod resource_inspect;
 mod resource_preview_scheduler;
 mod runner;
 mod swarm_cli;
+mod template_library;
 mod tool_plan_handoff;
 mod user_input;
 mod windows;
@@ -323,6 +324,7 @@ use resource_inspect::*;
 use resource_preview_scheduler::*;
 use runner::*;
 use swarm_cli::*;
+use template_library::*;
 use user_input::*;
 use windows::*;
 #[tauri::command]
@@ -2660,7 +2662,10 @@ fn main() {
             start_game_creator_external_mcp,
             stop_game_creator_external_mcp,
             create_automatic_local_game_project,
+            create_automatic_local_game_project_from_template,
             init_local_game_project,
+            fetch_game_template_library,
+            download_game_template,
             import_local_godot_project,
             import_local_cocos_project,
             is_local_project_directory_non_empty,
diff --git a/apps/ai-game-creator-shell/src-tauri/src/template_library.rs b/apps/ai-game-creator-shell/src-tauri/src/template_library.rs
new file mode 100644
index 000000000..00e0b9c96
--- /dev/null
+++ b/apps/ai-game-creator-shell/src-tauri/src/template_library.rs
@@ -0,0 +1,1031 @@
+//! AGC 游戏模板库：读取公共 OSS 模板清单、下载模板 zip、安装到本机并据此建项目。
+//!
+//! 边界：模板库只做「远端清单 → 本机安装 → 复制进新项目」这条路，不生成模板内容，
+//! 也不改写已存在项目。远端对象只允许来自受信任 OSS 主机下的 `templates/` 前缀；
+//! 清单、zip 与封面一律先校验再落盘，zip 解压只接受普通文件与目录。
+
+use super::*;
+use serde::{Deserialize, Serialize};
+
+const TEMPLATE_LIBRARY_SCHEMA_VERSION: &str = "agc-template-library.v1";
+const TEMPLATE_LIBRARY_INDEX_KEY: &str = "templates/index.json";
+const TEMPLATE_LIBRARY_OBJECT_PREFIX: &str = "templates/";
+const TEMPLATE_LIBRARY_OSS_HOST: &str = "agc-dev.oss-rg-china-mainland.aliyuncs.com";
+const DEFAULT_TEMPLATE_LIBRARY_BASE_URL: &str =
+    "https://agc-dev.oss-rg-china-mainland.aliyuncs.com";
+const TEMPLATE_LIBRARY_BASE_URL_ENV: &str = "AGC_TEMPLATE_LIBRARY_BASE_URL";
+const TEMPLATE_CACHE_DIRECTORY_NAME: &str = "templates";
+const TEMPLATE_INSTALLED_DIRECTORY_NAME: &str = "installed";
+const TEMPLATE_INSTALLED_MARKER_FILE: &str = "installed.json";
+const TEMPLATE_INDEX_CACHE_FILE: &str = "index.json";
+const TEMPLATE_LIBRARY_MAX_INDEX_BYTES: u64 = 4 * 1024 * 1024;
+const TEMPLATE_ARCHIVE_MAX_BYTES: u64 = 512 * 1024 * 1024;
+const TEMPLATE_ARCHIVE_MAX_FILES: usize = 4_096;
+const TEMPLATE_ARCHIVE_MAX_FILE_BYTES: u64 = 256 * 1024 * 1024;
+const TEMPLATE_ID_MAX_CHARS: usize = 64;
+const TEMPLATE_VERSION_MAX_CHARS: usize = 32;
+
+/// 远端清单里的单个模板条目（`templates/index.json` 中的 `templates[]`）。
+#[derive(Clone, Debug, Deserialize, Serialize, Eq, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct GameTemplateSummary {
+    pub(crate) id: String,
+    pub(crate) title: String,
+    #[serde(default)]
+    pub(crate) summary: String,
+    #[serde(default)]
+    pub(crate) tags: Vec<String>,
+    #[serde(default)]
+    pub(crate) runtime: String,
+    #[serde(default)]
+    pub(crate) engine: String,
+    #[serde(default)]
+    pub(crate) engine_version: String,
+    pub(crate) template_version: String,
+    #[serde(default)]
+    pub(crate) updated_at: String,
+    #[serde(default)]
+    pub(crate) entry: String,
+    pub(crate) zip_key: String,
+    pub(crate) zip_size_bytes: u64,
+    pub(crate) zip_sha256: String,
+    pub(crate) cover_key: String,
+    #[serde(default)]
+    pub(crate) cover_width: u32,
+    #[serde(default)]
+    pub(crate) cover_height: u32,
+    #[serde(default)]
+    pub(crate) cover_sha256: String,
+    #[serde(default)]
+    pub(crate) metadata_key: String,
+}
+
+/// `templates/index.json` 的库头信息。
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct GameTemplateLibraryHeader {
+    pub(crate) schema_version: String,
+    #[serde(default)]
+    pub(crate) library: String,
+    #[serde(default)]
+    pub(crate) library_version: u32,
+    #[serde(default)]
+    pub(crate) updated_at: String,
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, PartialEq)]
+#[serde(rename_all = "camelCase")]
+struct GameTemplateLibraryIndex {
+    #[serde(flatten)]
+    header: GameTemplateLibraryHeader,
+    #[serde(default)]
+    templates: Vec<GameTemplateSummary>,
+}
+
+/// 返回给前端的模板条目：清单字段 + 远端地址 + 本机安装状态。
+#[derive(Clone, Debug, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct GameTemplateEntry {
+    pub(crate) id: String,
+    pub(crate) title: String,
+    pub(crate) summary: String,
+    pub(crate) tags: Vec<String>,
+    pub(crate) runtime: String,
+    pub(crate) engine: String,
+    pub(crate) engine_version: String,
+    pub(crate) template_version: String,
+    pub(crate) updated_at: String,
+    pub(crate) entry: String,
+    pub(crate) zip_url: String,
+    pub(crate) zip_size_bytes: u64,
+    pub(crate) zip_sha256: String,
+    pub(crate) cover_url: String,
+    pub(crate) cover_width: u32,
+    pub(crate) cover_height: u32,
+    pub(crate) installed: bool,
+    pub(crate) installed_version: Option<String>,
+    pub(crate) installed_at_millis: Option<u64>,
+}
+
+#[derive(Clone, Debug, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct GameTemplateLibrarySnapshot {
+    pub(crate) schema_version: String,
+    pub(crate) library: String,
+    pub(crate) library_version: u32,
+    pub(crate) updated_at: String,
+    pub(crate) fetched_at_millis: u64,
+    /// `network` 或 `cache`：命中本机缓存时前端应提示清单可能不是最新。
+    pub(crate) source: String,
+    pub(crate) templates: Vec<GameTemplateEntry>,
+}
+
+#[derive(Clone, Debug, Deserialize, Serialize)]
+#[serde(rename_all = "camelCase")]
+struct InstalledGameTemplateRecord {
+    template_id: String,
+    template_version: String,
+    installed_at_millis: u64,
+    zip_sha256: String,
+    file_count: usize,
+    project_dir: String,
+}
+
+#[derive(Clone, Debug, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub(crate) struct InstalledGameTemplate {
+    pub(crate) template_id: String,
+    pub(crate) template_version: String,
+    pub(crate) installed_at_millis: u64,
+    pub(crate) zip_sha256: String,
+    pub(crate) file_count: usize,
+    pub(crate) project_dir: String,
+}
+
+fn now_millis() -> u64 {
+    SystemTime::now()
+        .duration_since(UNIX_EPOCH)
+        .map(|duration| duration.as_millis() as u64)
+        .unwrap_or_default()
+}
+
+fn template_library_base_url() -> String {
+    std::env::var(TEMPLATE_LIBRARY_BASE_URL_ENV)
+        .ok()
+        .map(|value| value.trim().trim_end_matches('/').to_string())
+        .filter(|value| !value.is_empty())
+        .unwrap_or_else(|| DEFAULT_TEMPLATE_LIBRARY_BASE_URL.to_string())
+}
+
+/// 只接受受信任 OSS 主机下的 HTTPS 地址；返回去掉尾斜杠的 base。
+pub(crate) fn validated_template_library_base_url(raw: &str) -> Result<String, String> {
+    let trimmed = raw.trim().trim_end_matches('/');
+    let parsed = url::Url::parse(trimmed).map_err(|_| "模板库地址无效".to_string())?;
+    if parsed.scheme() != "https" || parsed.host_str() != Some(TEMPLATE_LIBRARY_OSS_HOST) {
+        return Err("模板库地址必须来自受信任的 OSS".to_string());
+    }
+    if parsed.path() != "/" || parsed.query().is_some() || parsed.fragment().is_some() {
+        return Err("模板库地址只能包含主机名".to_string());
+    }
+    Ok(trimmed.to_string())
+}
+
+fn template_library_base() -> Result<String, String> {
+    validated_template_library_base_url(&template_library_base_url())
+}
+
+fn sha256_hex(bytes: &[u8]) -> String {
+    let mut hasher = sha2::Sha256::new();
+    hasher.update(bytes);
+    format!("{:x}", hasher.finalize())
+}
+
+fn is_valid_sha256(value: &str) -> bool {
+    let trimmed = value.trim();
+    trimmed.len() == 64 && trimmed.bytes().all(|byte| byte.is_ascii_hexdigit())
+}
+
+fn validate_template_identifier(value: &str, max_chars: usize, label: &str) -> Result<(), String> {
+    let trimmed = value.trim();
+    if trimmed.is_empty() || trimmed.chars().count() > max_chars {
+        return Err(format!("{label}无效"));
+    }
+    if !trimmed.chars().all(|value| {
+        value.is_ascii_lowercase() || value.is_ascii_digit() || matches!(value, '-' | '_' | '.')
+    }) {
+        return Err(format!("{label}无效"));
+    }
+    if trimmed.contains("..") {
+        return Err(format!("{label}无效"));
+    }
+    Ok(())
+}
+
+/// 远端对象键必须落在 `templates/` 前缀下，且不含绝对路径、上跳或反斜杠。
+pub(crate) fn validate_template_object_key(key: &str) -> Result<(), String> {
+    let trimmed = key.trim();
+    if trimmed.is_empty() || !trimmed.starts_with(TEMPLATE_LIBRARY_OBJECT_PREFIX) {
+        return Err("模板对象键必须位于 templates/ 前缀下".to_string());
+    }
+    if trimmed.starts_with('/') || trimmed.contains('\\') || trimmed.contains("..") {
+        return Err("模板对象键无效".to_string());
+    }
+    if trimmed
+        .chars()
+        .any(|value| value.is_control() || value == ' ' || value == '?')
+    {
+        return Err("模板对象键无效".to_string());
+    }
+    Ok(())
+}
+
+fn template_object_url(key: &str) -> Result<String, String> {
+    validate_template_object_key(key)?;
+    Ok(format!("{}/{}", template_library_base()?, key.trim()))
+}
+
+fn validate_template_summary(entry: &GameTemplateSummary) -> Result<(), String> {
+    validate_template_identifier(&entry.id, TEMPLATE_ID_MAX_CHARS, "模板 ID")?;
+    validate_template_identifier(
+        &entry.template_version,
+        TEMPLATE_VERSION_MAX_CHARS,
+        "模板版本",
+    )?;
+    if entry.title.trim().is_empty() || entry.title.chars().count() > 120 {
+        return Err(format!("模板 {} 的标题无效", entry.id));
+    }
+    if entry.tags.len() > 32 {
+        return Err(format!("模板 {} 的标签过多", entry.id));
+    }
+    validate_template_object_key(&entry.zip_key)?;
+    validate_template_object_key(&entry.cover_key)?;
+    if !entry.metadata_key.trim().is_empty() {
+        validate_template_object_key(&entry.metadata_key)?;
+    }
+    if entry.zip_size_bytes == 0 || entry.zip_size_bytes > TEMPLATE_ARCHIVE_MAX_BYTES {
+        return Err(format!("模板 {} 的包大小无效", entry.id));
+    }
+    if !is_valid_sha256(&entry.zip_sha256) {
+        return Err(format!("模板 {} 的包摘要无效", entry.id));
+    }
+    if !entry.cover_sha256.trim().is_empty() && !is_valid_sha256(&entry.cover_sha256) {
+        return Err(format!("模板 {} 的封面摘要无效", entry.id));
+    }
+    Ok(())
+}
+
+/// 解析并校验远端清单；任何一条不合法都让整次读取失败，避免前端拿到半可信数据。
+pub(crate) fn parse_game_template_library_index(
+    body: &str,
+) -> Result<(GameTemplateLibraryHeader, Vec<GameTemplateSummary>), String> {
+    let index: GameTemplateLibraryIndex =
+        serde_json::from_str(body).map_err(|error| format!("模板库清单不是有效 JSON：{error}"))?;
+    if index.header.schema_version != TEMPLATE_LIBRARY_SCHEMA_VERSION {
+        return Err("模板库清单版本不受支持".to_string());
+    }
+    let mut seen = std::collections::BTreeSet::new();
+    for entry in &index.templates {
+        validate_template_summary(entry)?;
+        if !seen.insert(entry.id.clone()) {
+            return Err(format!("模板库清单存在重复模板：{}", entry.id));
+        }
+    }
+    Ok((index.header, index.templates))
+}
+
+fn template_cache_root(app: &tauri::AppHandle) -> Result<PathBuf, String> {
+    app.path()
+        .app_data_dir()
+        .map(|root| root.join(TEMPLATE_CACHE_DIRECTORY_NAME))
+        .map_err(|error| format!("无法读取 AGC 应用数据目录：{error}"))
+}
+
+fn installed_templates_root(cache_root: &Path) -> PathBuf {
+    cache_root.join(TEMPLATE_INSTALLED_DIRECTORY_NAME)
+}
+
+fn installed_template_dir(
+    cache_root: &Path,
+    template_id: &str,
+    template_version: &str,
+) -> Result<PathBuf, String> {
+    validate_template_identifier(template_id, TEMPLATE_ID_MAX_CHARS, "模板 ID")?;
+    validate_template_identifier(template_version, TEMPLATE_VERSION_MAX_CHARS, "模板版本")?;
+    Ok(installed_templates_root(cache_root)
+        .join(template_id.trim())
+        .join(template_version.trim()))
+}
+
+fn read_installed_record(directory: &Path) -> Option<InstalledGameTemplateRecord> {
+    let body = fs::read_to_string(directory.join(TEMPLATE_INSTALLED_MARKER_FILE)).ok()?;
+    serde_json::from_str(&body).ok()
+}
+
+/// 扫描本机已安装模板，返回 `(模板 ID, 安装记录)`；损坏或缺少标记的目录视为未安装。
+fn collect_installed_records(cache_root: &Path) -> Vec<InstalledGameTemplateRecord> {
+    let root = installed_templates_root(cache_root);
+    let Ok(template_entries) = fs::read_dir(&root) else {
+        return Vec::new();
+    };
+    let mut records = Vec::new();
+    for template_entry in template_entries.flatten() {
+        let Ok(version_entries) = fs::read_dir(template_entry.path()) else {
+            continue;
+        };
+        for version_entry in version_entries.flatten() {
+            if let Some(record) = read_installed_record(&version_entry.path()) {
+                records.push(record);
+            }
+        }
+    }
+    records
+}
+
+fn installed_record_for(
+    records: &[InstalledGameTemplateRecord],
+    template_id: &str,
+) -> Option<InstalledGameTemplateRecord> {
+    records
+        .iter()
+        .filter(|record| record.template_id == template_id)
+        .max_by_key(|record| record.installed_at_millis)
+        .cloned()
+}
+
+fn to_entry(
+    summary: &GameTemplateSummary,
+    installed: Option<&InstalledGameTemplateRecord>,
+) -> Result<GameTemplateEntry, String> {
+    Ok(GameTemplateEntry {
+        id: summary.id.clone(),
+        title: summary.title.clone(),
+        summary: summary.summary.clone(),
+        tags: summary.tags.clone(),
+        runtime: summary.runtime.clone(),
+        engine: summary.engine.clone(),
+        engine_version: summary.engine_version.clone(),
+        template_version: summary.template_version.clone(),
+        updated_at: summary.updated_at.clone(),
+        entry: summary.entry.clone(),
+        zip_url: template_object_url(&summary.zip_key)?,
+        zip_size_bytes: summary.zip_size_bytes,
+        zip_sha256: summary.zip_sha256.to_ascii_lowercase(),
+        cover_url: template_object_url(&summary.cover_key)?,
+        cover_width: summary.cover_width,
+        cover_height: summary.cover_height,
+        installed: installed.is_some(),
+        installed_version: installed.map(|record| record.template_version.clone()),
+        installed_at_millis: installed.map(|record| record.installed_at_millis),
+    })
+}
+
+fn build_template_library_client() -> reqwest::Client {
+    reqwest::Client::builder()
+        .connect_timeout(Duration::from_secs(10))
+        .timeout(Duration::from_secs(120))
+        .build()
+        .unwrap_or_else(|_| reqwest::Client::new())
+}
+
+async fn fetch_limited_bytes(
+    client: &reqwest::Client,
+    url: &str,
+    max_bytes: u64,
+) -> Result<Vec<u8>, String> {
+    let response = client
+        .get(url)
+        .send()
+        .await
+        .map_err(|error| format!("请求模板库失败：{error}"))?;
+    if !response.status().is_success() {
+        return Err(format!("模板库返回 HTTP {}", response.status().as_u16()));
+    }
+    if response
+        .content_length()
+        .is_some_and(|length| length > max_bytes)
+    {
+        return Err("模板库对象超过大小限制".to_string());
+    }
+    let mut body = Vec::new();
+    let mut stream = response.bytes_stream();
+    while let Some(chunk) = stream.next().await {
+        let chunk = chunk.map_err(|error| format!("读取模板库对象失败：{error}"))?;
+        if body.len() as u64 + chunk.len() as u64 > max_bytes {
+            return Err("模板库对象超过大小限制".to_string());
+        }
+        body.extend_from_slice(&chunk);
+    }
+    Ok(body)
+}
+
+fn write_cached_index(cache_root: &Path, body: &str) {
+    let _ = ensure_game_creator_private_directory_tree(cache_root, "模板库缓存目录");
+    let _ = write_game_creator_private_file(
+        &cache_root.join(TEMPLATE_INDEX_CACHE_FILE),
+        body.as_bytes(),
+        "模板库清单缓存",
+    );
+}
+
+fn read_cached_index(cache_root: &Path) -> Option<String> {
+    fs::read_to_string(cache_root.join(TEMPLATE_INDEX_CACHE_FILE)).ok()
+}
+
+/// 单个 zip 条目路径：只允许相对普通路径，禁止绝对路径、上跳、反斜杠与盘符。
+pub(crate) fn safe_archive_relative_path(raw: &str) -> Result<PathBuf, String> {
+    let trimmed = raw.trim();
+    if trimmed.is_empty() {
+        return Err("模板包条目名为空".to_string());
+    }
+    let normalized = trimmed.replace('\\', "/");
+    if normalized.starts_with('/') || normalized.contains(':') {
+        return Err(format!("模板包条目路径无效：{raw}"));
+    }
+    let mut path = PathBuf::new();
+    for segment in normalized.split('/') {
+        if segment.is_empty() || segment == "." {
+            continue;
+        }
+        if segment == ".." {
+            return Err(format!("模板包条目路径无效：{raw}"));
+        }
+        path.push(segment);
+    }
+    if path.as_os_str().is_empty() {
+        return Err(format!("模板包条目路径无效：{raw}"));
+    }
+    Ok(path)
+}
+
+fn extract_template_archive(bytes: &[u8], destination: &Path) -> Result<usize, String> {
+    let mut archive = zip::ZipArchive::new(std::io::Cursor::new(bytes))
+        .map_err(|error| format!("模板包不是有效 zip：{error}"))?;
+    if archive.len() > TEMPLATE_ARCHIVE_MAX_FILES {
+        return Err("模板包文件数量超过上限".to_string());
+    }
+    let mut written = 0_usize;
+    for index in 0..archive.len() {
+        let mut entry = archive
+            .by_index(index)
+            .map_err(|error| format!("读取模板包条目失败：{error}"))?;
+        if entry
+            .unix_mode()
+            .is_some_and(|mode| mode & 0o170000 == 0o120000)
+        {
+            return Err("模板包不允许包含符号链接".to_string());
+        }
+        let relative = safe_archive_relative_path(entry.name())?;
+        let target = destination.join(&relative);
+        if entry.is_dir() {
+            ensure_game_creator_private_directory_tree(&target, "模板目录")?;
+            continue;
+        }
+        if entry.size() > TEMPLATE_ARCHIVE_MAX_FILE_BYTES {
+            return Err(format!("模板包文件超过大小上限：{}", entry.name()));
+        }
+        let mut buffer = Vec::with_capacity(entry.size() as usize);
+        entry
+            .read_to_end(&mut buffer)
+            .map_err(|error| format!("读取模板包文件失败：{error}"))?;
+        if let Some(parent) = target.parent() {
+            ensure_game_creator_private_directory_tree(parent, "模板目录")?;
+        }
+        write_game_creator_private_file(&target, &buffer, "模板文件")?;
+        written += 1;
+    }
+    if written == 0 {
+        return Err("模板包没有可写入的文件".to_string());
+    }
+    Ok(written)
+}
+
+fn install_template_archive(
+    cache_root: &Path,
+    summary: &GameTemplateSummary,
+    bytes: &[u8],
+) -> Result<InstalledGameTemplateRecord, String> {
+    if bytes.len() as u64 != summary.zip_size_bytes {
+        return Err("模板包大小校验失败".to_string());
+    }
+    let actual_sha256 = sha256_hex(bytes);
+    if actual_sha256 != summary.zip_sha256.trim().to_ascii_lowercase() {
+        return Err("模板包完整性校验失败".to_string());
+    }
+    let directory = installed_template_dir(cache_root, &summary.id, &summary.template_version)?;
+    if directory.exists() {
+        // 只清理本模板自己的安装目录；路径由标识符白名单拼出，不含远端输入。
+        let _ = fs::remove_dir_all(&directory);
+    }
+    ensure_game_creator_private_directory_tree(&directory, "模板安装目录")?;
+    let file_count = extract_template_archive(bytes, &directory)?;
+    let record = InstalledGameTemplateRecord {
+        template_id: summary.id.clone(),
+        template_version: summary.template_version.clone(),
+        installed_at_millis: now_millis(),
+        zip_sha256: actual_sha256,
+        file_count,
+        project_dir: directory.to_string_lossy().into_owned(),
+    };
+    let body = serde_json::to_string_pretty(&record)
+        .map_err(|error| format!("写入模板安装记录失败：{error}"))?;
+    write_game_creator_private_file(
+        &directory.join(TEMPLATE_INSTALLED_MARKER_FILE),
+        body.as_bytes(),
+        "模板安装记录",
+    )?;
+    Ok(record)
+}
+
+fn copy_template_project(source_dir: &Path, target_root: &Path) -> Result<usize, String> {
+    let mut copied = 0_usize;
+    let mut stack = vec![source_dir.to_path_buf()];
+    while let Some(directory) = stack.pop() {
+        let entries =
+            fs::read_dir(&directory).map_err(|error| format!("读取模板目录失败：{error}"))?;
+        for entry in entries.flatten() {
+            let path = entry.path();
+            if entry.file_name() == TEMPLATE_INSTALLED_MARKER_FILE {
+                continue;
+            }
+            let metadata = entry
+                .metadata()
+                .map_err(|error| format!("读取模板条目失败：{error}"))?;
+            if metadata.is_dir() {
+                stack.push(path);
+                continue;
+            }
+            if !metadata.is_file() {
+                return Err(format!("模板包含不支持的条目：{}", path.display()));
+            }
+            let relative = path
+                .strip_prefix(source_dir)
+                .map_err(|error| format!("模板条目路径无效：{error}"))?;
+            let target = target_root.join(relative);
+            if let Some(parent) = target.parent() {
+                ensure_game_creator_private_directory_tree(parent, "项目模板目录")?;
+            }
+            let bytes = fs::read(&path).map_err(|error| format!("读取模板文件失败：{error}"))?;
+            write_game_creator_private_file(&target, &bytes, "项目模板文件")?;
+            copied += 1;
+        }
+    }
+    if copied == 0 {
+        return Err("模板没有可复制的文件".to_string());
+    }
+    Ok(copied)
+}
+
+fn find_template_summary(
+    cache_root: &Path,
+    template_id: &str,
+    template_version: &str,
+) -> Result<GameTemplateSummary, String> {
+    let body = read_cached_index(cache_root).ok_or_else(|| "本机没有模板库清单缓存".to_string())?;
+    let (_, templates) = parse_game_template_library_index(&body)?;
+    templates
+        .into_iter()
+        .find(|entry| entry.id == template_id && entry.template_version == template_version)
+        .ok_or_else(|| "模板库清单里没有该模板版本".to_string())
+}
+
+async fn ensure_template_installed(
+    cache_root: &Path,
+    template_id: &str,
+    template_version: &str,
+) -> Result<InstalledGameTemplateRecord, String> {
+    let installed_directory = installed_template_dir(cache_root, template_id, template_version)?;
+    if let Some(record) = read_installed_record(&installed_directory) {
+        return Ok(record);
+    }
+    let summary = find_template_summary(cache_root, template_id, template_version)?;
+    let client = build_template_library_client();
+    let url = template_object_url(&summary.zip_key)?;
+    let bytes = fetch_limited_bytes(&client, &url, TEMPLATE_ARCHIVE_MAX_BYTES).await?;
+    install_template_archive(cache_root, &summary, &bytes)
+}
+
+#[tauri::command]
+pub(crate) async fn fetch_game_template_library(
+    app: tauri::AppHandle,
+) -> Result<GameTemplateLibrarySnapshot, String> {
+    let cache_root = template_cache_root(&app)?;
+    ensure_game_creator_private_directory_tree(&cache_root, "模板库缓存目录")?;
+    let index_url = format!(
+        "{}/{}",
+        template_library_base()?,
+        TEMPLATE_LIBRARY_INDEX_KEY
+    );
+    let client = build_template_library_client();
+    let (body, source) =
+        match fetch_limited_bytes(&client, &index_url, TEMPLATE_LIBRARY_MAX_INDEX_BYTES).await {
+            Ok(bytes) => {
+                let body =
+                    String::from_utf8(bytes).map_err(|_| "模板库清单不是有效 UTF-8".to_string())?;
+                parse_game_template_library_index(&body)?;
+                write_cached_index(&cache_root, &body);
+                (body, "network")
+            }
+            Err(error) => match read_cached_index(&cache_root) {
+                Some(cached) => {
+                    parse_game_template_library_index(&cached)?;
+                    (cached, "cache")
+                }
+                None => return Err(error),
+            },
+        };
+    let (header, templates) = parse_game_template_library_index(&body)?;
+    let installed = collect_installed_records(&cache_root);
+    let entries = templates
+        .iter()
+        .map(|summary| {
+            to_entry(
+                summary,
+                installed_record_for(&installed, &summary.id).as_ref(),
+            )
+        })
+        .collect::<Result<Vec<_>, _>>()?;
+    Ok(GameTemplateLibrarySnapshot {
+        schema_version: header.schema_version,
+        library: header.library,
+        library_version: header.library_version,
+        updated_at: header.updated_at,
+        fetched_at_millis: now_millis(),
+        source: source.to_string(),
+        templates: entries,
+    })
+}
+
+#[tauri::command]
+pub(crate) async fn download_game_template(
+    app: tauri::AppHandle,
+    template_id: String,
+    template_version: String,
+) -> Result<InstalledGameTemplate, String> {
+    let cache_root = template_cache_root(&app)?;
+    ensure_game_creator_private_directory_tree(&cache_root, "模板库缓存目录")?;
+    let record =
+        ensure_template_installed(&cache_root, template_id.trim(), template_version.trim()).await?;
+    Ok(InstalledGameTemplate {
+        template_id: record.template_id,
+        template_version: record.template_version,
+        installed_at_millis: record.installed_at_millis,
+        zip_sha256: record.zip_sha256,
+        file_count: record.file_count,
+        project_dir: record.project_dir,
+    })
+}
+
+/// 用已安装模板在自动工作区根目录下建项目：先把模板文件铺进新目录，再走标准项目初始化。
+pub(crate) fn create_project_from_installed_template_at(
+    projects_root: &Path,
+    installed_project_dir: &Path,
+    requested_name: Option<&str>,
+    planning: bool,
+) -> Result<InitLocalProjectResult, String> {
+    let requested_name = requested_name
+        .map(normalize_game_creation_project_name)
+        .transpose()?;
+    if projects_root.as_os_str().is_empty() || !projects_root.is_absolute() {
+        return Err("自动工作区根目录必须是绝对路径".to_string());
+    }
+    if !installed_project_dir.is_dir() {
+        return Err("模板尚未安装到本机".to_string());
+    }
+    ensure_game_creator_private_directory_tree(projects_root, "自动工作区根目录")?;
+    prepare_game_creator_private_path_for_read(projects_root, true, "自动工作区根目录")?;
+    let metadata = fs::symlink_metadata(projects_root).map_err(|error| {
+        format!(
+            "读取自动工作区根目录失败：{}: {error}",
+            projects_root.display()
+        )
+    })?;
+    if metadata.file_type().is_symlink() || !metadata.is_dir() {
+        return Err("自动工作区根目录必须是普通文件夹".to_string());
+    }
+
+    for _ in 0..16 {
+        let workspace_id = uuid::Uuid::new_v4().simple().to_string();
+        let short_id = &workspace_id[..8];
+        let project_name = requested_name.clone().unwrap_or_else(|| {
+            let prefix = if planning {
+                "策划项目"
+            } else {
+                "GameAgent 项目"
+            };
+            format!("{prefix} {short_id}")
+        });
+        let project_root = projects_root.join(format!("gameagent-{short_id}"));
+        match fs::create_dir(&project_root) {
+            Ok(()) => {
+                let result = (|| {
+                    harden_new_game_creator_private_path(&project_root, true, "自动项目目录")?;
+                    enforce_project_permission_policy(&project_root, "project.create")?;
+                    let _lock = acquire_project_write_lock(&project_root, "project.create")?;
+                    copy_template_project(installed_project_dir, &project_root)?;
+                    init_local_game_project_at(
+                        &project_root,
+                        &format!("gameagent-{workspace_id}"),
+                        &project_name,
+                    )
+                })();
+                if result.is_err() {
+                    let _ = fs::remove_dir_all(&project_root);
+                }
+                return result;
+            }
+            Err(error) if error.kind() == std::io::ErrorKind::AlreadyExists => continue,
+            Err(error) => {
+                return Err(format!(
+                    "创建自动工作区失败：{}: {error}",
+                    project_root.display()
+                ));
+            }
+        }
+    }
+    Err("自动工作区命名冲突，请重试".to_string())
+}
+
+#[tauri::command]
+pub(crate) async fn create_automatic_local_game_project_from_template(
+    app: tauri::AppHandle,
+    template_id: String,
+    template_version: String,
+    name: Option<String>,
+    planning: Option<bool>,
+) -> Result<InitLocalProjectResult, String> {
+    let projects_root = app
+        .path()
+        .app_data_dir()
+        .map(|root| root.join("projects"))
+        .map_err(|error| format!("无法读取 AGC 应用数据目录：{error}"))?;
+    let cache_root = template_cache_root(&app)?;
+    ensure_game_creator_private_directory_tree(&cache_root, "模板库缓存目录")?;
+    let record =
+        ensure_template_installed(&cache_root, template_id.trim(), template_version.trim()).await?;
+    create_project_from_installed_template_at(
+        &projects_root,
+        Path::new(&record.project_dir),
+        name.as_deref(),
+        planning.unwrap_or(false),
+    )
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    fn sample_index_body() -> String {
+        serde_json::json!({
+            "schemaVersion": TEMPLATE_LIBRARY_SCHEMA_VERSION,
+            "library": "agc-game-templates",
+            "libraryVersion": 1,
+            "updatedAt": "2026-09-17T00:00:00Z",
+            "templates": [
+                {
+                    "id": "demo-template",
+                    "title": "演示模板",
+                    "summary": "用于测试",
+                    "tags": ["2d", "demo"],
+                    "runtime": "html",
+                    "engine": "phaser",
+                    "engineVersion": "4.2.1",
+                    "templateVersion": "1.0.0",
+                    "updatedAt": "2026-09-17T00:00:00Z",
+                    "entry": "game/index.html",
+                    "zipKey": "templates/v1/demo-template/template.zip",
+                    "zipSizeBytes": 128,
+                    "zipSha256": "0".repeat(64),
+                    "coverKey": "templates/v1/demo-template/cover.png",
+                    "coverWidth": 960,
+                    "coverHeight": 540,
+                    "coverSha256": "1".repeat(64),
+                    "metadataKey": "templates/v1/demo-template/template.json"
+                }
+            ]
+        })
+        .to_string()
+    }
+
+    fn sample_summary() -> GameTemplateSummary {
+        parse_game_template_library_index(&sample_index_body())
+            .expect("parse sample index")
+            .1
+            .remove(0)
+    }
+
+    fn build_archive(entries: &[(&str, &[u8])]) -> Vec<u8> {
+        let mut writer = zip::ZipWriter::new(std::io::Cursor::new(Vec::new()));
+        let options = zip::write::SimpleFileOptions::default();
+        for (name, bytes) in entries {
+            writer.start_file(*name, options).expect("start file");
+            writer.write_all(bytes).expect("write file");
+        }
+        writer.finish().expect("finish archive").into_inner()
+    }
+
+    /// 自动工作区根目录要走私有 DACL 校验，和 `tests::unique_project_path` 一样
+    /// 在临时目录下取一个尚未存在的唯一路径，而不是用 tempdir 预先建好的目录。
+    fn unique_projects_root() -> PathBuf {
+        let millis = SystemTime::now()
+            .duration_since(UNIX_EPOCH)
+            .expect("system clock")
+            .as_millis();
+        std::env::temp_dir().join(format!(
+            "genarrative-agc-template-library-test-{}-{millis}",
+            std::process::id()
+        ))
+    }
+
+    #[test]
+    fn rejects_index_with_unsupported_schema_or_duplicate_templates() {
+        let unsupported =
+            sample_index_body().replace(TEMPLATE_LIBRARY_SCHEMA_VERSION, "agc-template-library.v2");
+        assert!(parse_game_template_library_index(&unsupported).is_err());
+
+        let entry = serde_json::to_string(&sample_summary()).expect("serialize summary");
+        let duplicated = serde_json::json!({
+            "schemaVersion": TEMPLATE_LIBRARY_SCHEMA_VERSION,
+            "templates": [
+                serde_json::from_str::<serde_json::Value>(&entry).expect("value"),
+                serde_json::from_str::<serde_json::Value>(&entry).expect("value"),
+            ]
+        })
+        .to_string();
+        let error = parse_game_template_library_index(&duplicated).expect_err("duplicate rejected");
+        assert!(error.contains("重复模板"), "{error}");
+    }
+
+    #[test]
+    fn rejects_object_keys_outside_the_templates_prefix() {
+        assert!(validate_template_object_key("agc/templates/v1/demo/template.zip").is_err());
+        assert!(validate_template_object_key("templates/../secret").is_err());
+        assert!(validate_template_object_key("/templates/a.zip").is_err());
+        assert!(validate_template_object_key("templates\\a.zip").is_err());
+        assert!(validate_template_object_key("templates/v1/demo/template.zip").is_ok());
+    }
+
+    #[test]
+    fn rejects_template_base_url_outside_trusted_oss() {
+        assert!(validated_template_library_base_url(
+            "https://agc-dev.oss-rg-china-mainland.aliyuncs.com"
+        )
+        .is_ok());
+        assert!(validated_template_library_base_url(
+            "http://agc-dev.oss-rg-china-mainland.aliyuncs.com"
+        )
+        .is_err());
+        assert!(validated_template_library_base_url("https://evil.example.com").is_err());
+        assert!(validated_template_library_base_url(
+            "https://agc-dev.oss-rg-china-mainland.aliyuncs.com/other-prefix"
+        )
+        .is_err());
+    }
+
+    /// 固定 2026-09-17 实际发布的 `templates/index.json`：客户端解析必须与线上契约一致。
+    #[test]
+    fn parses_the_published_library_index_fixture() {
+        let body = include_str!("../tests/fixtures/agc-template-library-index.json");
+        let (header, templates) =
+            parse_game_template_library_index(body).expect("parse published index");
+        assert_eq!(header.schema_version, TEMPLATE_LIBRARY_SCHEMA_VERSION);
+        assert_eq!(header.library, "agc-game-templates");
+        assert_eq!(
+            templates
+                .iter()
+                .map(|entry| entry.id.as_str())
+                .collect::<Vec<_>>(),
+            vec!["phaser-2d-starter", "threejs-3d-starter"]
+        );
+        let first = templates.first().expect("first template");
+        assert_eq!(first.runtime, "html");
+        assert_eq!(first.tags.first().map(String::as_str), Some("起步工程"));
+        assert!(first.cover_width > 0 && first.cover_height > 0);
+
+        let entry = to_entry(first, None).expect("build entry");
+        let base = template_library_base().expect("trusted base");
+        assert_eq!(
+            entry.zip_url,
+            format!("{base}/templates/v1/phaser-2d-starter/template.zip")
+        );
+        assert_eq!(
+            entry.cover_url,
+            format!("{base}/templates/v1/phaser-2d-starter/cover.png")
+        );
+        assert!(!entry.installed);
+    }
+
+    #[test]
+    fn rejects_archive_entries_that_escape_the_destination() {
+        assert!(safe_archive_relative_path("game/index.html").is_ok());
+        assert!(safe_archive_relative_path("./game/index.html").is_ok());
+        assert!(safe_archive_relative_path("../escape.txt").is_err());
+        assert!(safe_archive_relative_path("game/../../escape.txt").is_err());
+        assert!(safe_archive_relative_path("C:/escape.txt").is_err());
+        assert!(safe_archive_relative_path("/escape.txt").is_err());
+
+        let archive = build_archive(&[("../escape.txt", b"nope")]);
+        let destination = tempfile::tempdir().expect("temp dir");
+        assert!(extract_template_archive(&archive, destination.path()).is_err());
+        assert!(!destination
+            .path()
+            .parent()
+            .unwrap()
+            .join("escape.txt")
+            .exists());
+    }
+
+    #[test]
+    fn installs_template_archive_and_reports_it_as_installed() {
+        let cache_root = tempfile::tempdir().expect("temp dir");
+        let archive = build_archive(&[
+            ("game/index.html", b"<html></html>"),
+            ("game/game.js", b"console.log('demo');"),
+        ]);
+        let mut summary = sample_summary();
+        summary.zip_size_bytes = archive.len() as u64;
+        summary.zip_sha256 = sha256_hex(&archive);
+
+        let record = install_template_archive(cache_root.path(), &summary, &archive)
+            .expect("install template");
+        assert_eq!(record.file_count, 2);
+        let installed = collect_installed_records(cache_root.path());
+        assert_eq!(installed.len(), 1);
+        assert_eq!(installed[0].template_version, "1.0.0");
+
+        let entry = to_entry(
+            &summary,
+            installed_record_for(&installed, &summary.id).as_ref(),
+        )
+        .expect("build entry");
+        assert!(entry.installed);
+        assert_eq!(entry.installed_version.as_deref(), Some("1.0.0"));
+        assert!(entry.zip_url.starts_with("https://"));
+        assert!(entry
+            .cover_url
+            .ends_with("/templates/v1/demo-template/cover.png"));
+    }
+
+    #[test]
+    fn rejects_archive_when_size_or_digest_do_not_match_the_index() {
+        let cache_root = tempfile::tempdir().expect("temp dir");
+        let archive = build_archive(&[("game/index.html", b"<html></html>")]);
+        let mut summary = sample_summary();
+        summary.zip_size_bytes = archive.len() as u64 + 1;
+        let error = install_template_archive(cache_root.path(), &summary, &archive)
+            .expect_err("size mismatch rejected");
+        assert!(error.contains("大小校验失败"), "{error}");
+
+        summary.zip_size_bytes = archive.len() as u64;
+        summary.zip_sha256 = "f".repeat(64);
+        let error = install_template_archive(cache_root.path(), &summary, &archive)
+            .expect_err("digest mismatch rejected");
+        assert!(error.contains("完整性校验失败"), "{error}");
+    }
+
+    #[test]
+    fn creates_project_from_installed_template_without_leaking_install_marker() {
+        let cache_root = tempfile::tempdir().expect("temp dir");
+        let projects_root = unique_projects_root();
+        let archive = build_archive(&[
+            ("game/index.html", b"<html><body>template</body></html>"),
+            ("assets/README.txt", b"template assets"),
+        ]);
+        let mut summary = sample_summary();
+        summary.zip_size_bytes = archive.len() as u64;
+        summary.zip_sha256 = sha256_hex(&archive);
+        let record = install_template_archive(cache_root.path(), &summary, &archive)
+            .expect("install template");
+
+        let result = create_project_from_installed_template_at(
+            &projects_root,
+            Path::new(&record.project_dir),
+            Some("模板项目"),
+            false,
+        )
+        .expect("create project from template");
+        assert_eq!(result.manifest.name, "模板项目");
+        let project_root = Path::new(&result.project_path);
+        let index =
+            fs::read_to_string(project_root.join("game/index.html")).expect("template file copied");
+        assert!(index.contains("template"));
+        assert!(project_root.join("assets/README.txt").is_file());
+        assert!(!project_root.join(TEMPLATE_INSTALLED_MARKER_FILE).exists());
+        assert!(!project_root.join("game/index.html.orig").exists());
+        fs::remove_dir_all(&projects_root).ok();
+    }
+
+    #[test]
+    fn refuses_to_create_project_when_template_is_not_installed() {
+        let projects_root = tempfile::tempdir().expect("temp dir");
+        let missing = projects_root.path().join("missing-template");
+        let error =
+            create_project_from_installed_template_at(projects_root.path(), &missing, None, false)
+                .expect_err("missing template rejected");
+        assert!(error.contains("模板尚未安装"), "{error}");
+    }
+
+    /// 可选的真连检查：`cargo test --bin genarrative-ai-game-creator-shell template_library -- --ignored`。
+    /// 默认跳过，避免离线环境因网络失败误报。
+    #[tokio::test]
+    #[ignore = "需要网络：校验客户端能真实读到线上模板库清单与对象键"]
+    async fn fetches_the_live_template_library_index() {
+        let base = template_library_base().expect("trusted base");
+        let client = build_template_library_client();
+        let body = fetch_limited_bytes(
+            &client,
+            &format!("{base}/{TEMPLATE_LIBRARY_INDEX_KEY}"),
+            TEMPLATE_LIBRARY_MAX_INDEX_BYTES,
+        )
+        .await
+        .expect("fetch live index");
+        let body = String::from_utf8(body).expect("utf-8 index");
+        let (header, templates) =
+            parse_game_template_library_index(&body).expect("parse live index");
+        assert_eq!(header.schema_version, TEMPLATE_LIBRARY_SCHEMA_VERSION);
+        assert!(!templates.is_empty(), "线上模板库应当至少有一个模板");
+        for entry in &templates {
+            let zip_url = template_object_url(&entry.zip_key).expect("trusted zip url");
+            assert!(zip_url.starts_with(&format!("{base}/")));
+        }
+    }
+}
diff --git a/apps/ai-game-creator-shell/src-tauri/tauri.conf.json b/apps/ai-game-creator-shell/src-tauri/tauri.conf.json
index 1d4c33053..f27f09c66 100644
--- a/apps/ai-game-creator-shell/src-tauri/tauri.conf.json
+++ b/apps/ai-game-creator-shell/src-tauri/tauri.conf.json
@@ -24,8 +24,8 @@
       }
     ],
     "security": {
-      "csp": "default-src 'self' customprotocol: asset:; img-src 'self' asset: data: blob:; media-src 'self' asset: data: blob:; connect-src 'self' https://agc-dev.oss-rg-china-mainland.aliyuncs.com http://127.0.0.1:* ws://127.0.0.1:*; script-src 'self'; style-src 'self' 'unsafe-inline'; frame-src 'self' http://127.0.0.1:*",
-      "devCsp": "default-src 'self' customprotocol: asset: http://127.0.0.1:*; img-src 'self' asset: http://127.0.0.1:* data: blob:; media-src 'self' asset: http://127.0.0.1:* data: blob:; connect-src 'self' https://agc-dev.oss-rg-china-mainland.aliyuncs.com http://127.0.0.1:* ws://127.0.0.1:*; script-src 'self'; style-src 'self' 'unsafe-inline'; frame-src 'self' http://127.0.0.1:*"
+    "csp": "default-src 'self' customprotocol: asset:; img-src 'self' asset: data: blob: https://agc-dev.oss-rg-china-mainland.aliyuncs.com; media-src 'self' asset: data: blob:; connect-src 'self' https://agc-dev.oss-rg-china-mainland.aliyuncs.com http://127.0.0.1:* ws://127.0.0.1:*; script-src 'self'; style-src 'self' 'unsafe-inline'; frame-src 'self' http://127.0.0.1:*",
+    "devCsp": "default-src 'self' customprotocol: asset: http://127.0.0.1:*; img-src 'self' asset: http://127.0.0.1:* data: blob: https://agc-dev.oss-rg-china-mainland.aliyuncs.com; media-src 'self' asset: http://127.0.0.1:* data: blob:; connect-src 'self' https://agc-dev.oss-rg-china-mainland.aliyuncs.com http://127.0.0.1:* ws://127.0.0.1:*; script-src 'self'; style-src 'self' 'unsafe-inline'; frame-src 'self' http://127.0.0.1:*"
     }
   },
   "bundle": {
diff --git a/apps/ai-game-creator-shell/src-tauri/tests/fixtures/agc-template-library-index.json b/apps/ai-game-creator-shell/src-tauri/tests/fixtures/agc-template-library-index.json
new file mode 100644
index 000000000..256670fe0
--- /dev/null
+++ b/apps/ai-game-creator-shell/src-tauri/tests/fixtures/agc-template-library-index.json
@@ -0,0 +1,58 @@
+{
+  "schemaVersion": "agc-template-library.v1",
+  "library": "agc-game-templates",
+  "libraryVersion": 1,
+  "updatedAt": "2026-09-17T03:06:41Z",
+  "templates": [
+    {
+      "id": "phaser-2d-starter",
+      "title": "Phaser 2D 起步工程",
+      "summary": "AGC 新建项目使用的默认二维起步工程（Phaser 4 + Vite），解压后即为可运行项目根。",
+      "tags": [
+        "起步工程",
+        "2d",
+        "phaser",
+        "像素"
+      ],
+      "runtime": "html",
+      "engine": "phaser",
+      "engineVersion": "4.2.1",
+      "templateVersion": "0.1.0",
+      "updatedAt": "2026-09-17T03:06:41Z",
+      "entry": "game/index.html",
+      "zipKey": "templates/v1/phaser-2d-starter/template.zip",
+      "zipSizeBytes": 8823,
+      "zipSha256": "6d3decc9f770a3e5225c387fb6c907561823a72f2f40da932e71308e6288cc97",
+      "coverKey": "templates/v1/phaser-2d-starter/cover.png",
+      "coverWidth": 960,
+      "coverHeight": 540,
+      "coverSha256": "5fcf952aa89c302258fcf462344d7d799a8bd2a79070d5412c94ac269e313376",
+      "metadataKey": "templates/v1/phaser-2d-starter/template.json"
+    },
+    {
+      "id": "threejs-3d-starter",
+      "title": "Three.js 3D 起步工程",
+      "summary": "网页三维起步工程（Three.js + Vite），自带可旋转立方体场景、方向光与自适应视口。",
+      "tags": [
+        "起步工程",
+        "3d",
+        "three.js",
+        "网页"
+      ],
+      "runtime": "html",
+      "engine": "three.js",
+      "engineVersion": "0.180.0",
+      "templateVersion": "0.1.0",
+      "updatedAt": "2026-09-17T03:06:41Z",
+      "entry": "game/index.html",
+      "zipKey": "templates/v1/threejs-3d-starter/template.zip",
+      "zipSizeBytes": 1700,
+      "zipSha256": "dd353052fd61990ace3aa4bafeb8b48a7121133f33c976dd4865fff9761fc44b",
+      "coverKey": "templates/v1/threejs-3d-starter/cover.png",
+      "coverWidth": 960,
+      "coverHeight": 540,
+      "coverSha256": "3a4d3080853737663d970a21a63e9d6b5cb523b31c5463d2c2dd94fddf66f187",
+      "metadataKey": "templates/v1/threejs-3d-starter/template.json"
+    }
+  ]
+}
diff --git a/apps/ai-game-creator-shell/src/features/app-shell/WorkspaceLauncher.tsx b/apps/ai-game-creator-shell/src/features/app-shell/WorkspaceLauncher.tsx
index c40dca2e4..aea971d8f 100644
--- a/apps/ai-game-creator-shell/src/features/app-shell/WorkspaceLauncher.tsx
+++ b/apps/ai-game-creator-shell/src/features/app-shell/WorkspaceLauncher.tsx
@@ -25,8 +25,10 @@ import {
   type ProjectManifestSnapshotSource,
   rereadAuthoritativeProjectManifestSnapshot,
 } from '../../view/project-development/projectResourceLiveUpdateModel';
+import TemplateLibraryView from '../../view/template-library';
 import { useDirectActiveTurns } from '../agent-runtime/directActiveTurns';
 import { RuntimeConfigDialog } from '../runtime-config/RuntimeConfigDialog';
+import { useTemplateLibrary } from '../template-library/useTemplateLibrary';
 import { AccountWalletBar, AccountWalletDialogs } from './AccountWallet';
 import {
   DeveloperAgentDialogs,
@@ -83,6 +85,11 @@ export function WorkspaceLauncherShell({
     setAgentChatProjectPath: developerAgent.setAgentChatProjectPath,
     rememberRecentWorkspace,
   });
+  const templateLibrary = useTemplateLibrary({
+    onProjectCreated: async (result) => {
+      await homeProject.enterCreatedTemplateProject(result);
+    },
+  });
   const {
     projectPath,
     setProjectPath,
@@ -567,6 +574,13 @@ export function WorkspaceLauncherShell({
               void openProject(path, 'open');
             }}
             onProjectPick={() => void homeProject.pickAndOpenProject()}
+            templateRecommendations={templateLibrary.templates}
+            templateLibraryLoading={
+              templateLibrary.status === 'loading' ||
+              templateLibrary.status === 'idle'
+            }
+            templateLibraryError={templateLibrary.error}
+            onTemplateLibraryOpen={() => setLauncherView('template-library')}
           />
         ) : launcherView === 'projects' ? (
           <ProjectsPage
@@ -574,6 +588,11 @@ export function WorkspaceLauncherShell({
             homeProject={homeProject}
             recentProjects={recentProjects}
           />
+        ) : launcherView === 'template-library' ? (
+          <TemplateLibraryView
+            controller={templateLibrary}
+            onBack={() => setLauncherView('home')}
+          />
         ) : launcherView === 'agent-chat' ? (
           <DeveloperAgentPanel
             controller={developerAgent}
diff --git a/apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts b/apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts
index 27059edca..c07d04499 100644
--- a/apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts
+++ b/apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts
@@ -555,6 +555,35 @@ export function useHomeProjectCreation({
     }
   }
 
+  /**
+   * 模板库建出的项目：模板文件与项目脚手架已在 Rust 侧一次落盘，
+   * 这里只负责登记最近项目并走标准进项目通道（含会话预览核验与代次闸门）。
+   */
+  async function enterCreatedTemplateProject(result: InitLocalProjectResult) {
+    const invoke = resolveTauriInvoke();
+    if (!invoke) {
+      throw new Error('需要在陶泥儿客户端内运行');
+    }
+    await enterProjectDevelopment({
+      projectPath: result.projectPath,
+      projectName:
+        result.manifest.name || projectNameFromPath(result.projectPath),
+      projectKind: 'web',
+      manifest: result.manifest,
+      projectRevision: await readCurrentProjectRevision(
+        invoke,
+        result.projectPath,
+      ),
+      creationType: null,
+      startMode: null,
+      initialPrompt: '',
+      attachments: [],
+      recentRunStatus: null,
+      recentRunStopReason: null,
+      createdAt: Date.now(),
+    });
+  }
+
   async function openProject(nextProjectPath: string, mode: 'open' | 'create') {
     if (mode === 'create') {
       await createProjectFromProjectPage(nextProjectPath);
@@ -1005,6 +1034,7 @@ export function useHomeProjectCreation({
     renameProject,
     pickAndOpenProject,
     pickAndCreateProject,
+    enterCreatedTemplateProject,
     confirmCreateInNonEmptyFolder,
     cancelCreateInNonEmptyFolder,
   };
diff --git a/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.test.ts b/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.test.ts
new file mode 100644
index 000000000..cb71a5363
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.test.ts
@@ -0,0 +1,183 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  collectGameTemplateRuntimes,
+  collectGameTemplateTags,
+  EMPTY_TEMPLATE_LIBRARY_FILTERS,
+  filterGameTemplates,
+  formatGameTemplateSize,
+  type GameTemplateEntry,
+  isTemplateLibraryFiltersEmpty,
+  needsTemplateDownload,
+  templateMatchesQuery,
+  templateRuntimeLabel,
+  toggleGameTemplateTag,
+} from './templateLibraryModel';
+
+function template(
+  overrides: Partial<GameTemplateEntry> & Pick<GameTemplateEntry, 'id'>,
+): GameTemplateEntry {
+  return {
+    title: '未命名模板',
+    summary: '',
+    tags: [],
+    runtime: 'html',
+    engine: 'phaser',
+    engineVersion: '4.2.1',
+    templateVersion: '1.0.0',
+    updatedAt: '2026-09-17T00:00:00Z',
+    entry: 'game/index.html',
+    zipUrl:
+      'https://agc-dev.oss-rg-china-mainland.aliyuncs.com/templates/v1/demo/template.zip',
+    zipSizeBytes: 2048,
+    zipSha256: 'a'.repeat(64),
+    coverUrl:
+      'https://agc-dev.oss-rg-china-mainland.aliyuncs.com/templates/v1/demo/cover.png',
+    coverWidth: 960,
+    coverHeight: 540,
+    installed: false,
+    installedVersion: null,
+    installedAtMillis: null,
+    ...overrides,
+  };
+}
+
+const matchThree = template({
+  id: 'match-3',
+  title: '三消经营',
+  summary: '三消与模拟经营的融合模板',
+  tags: ['三消', '经营'],
+  engine: 'phaser',
+  installed: true,
+  installedVersion: '1.0.0',
+});
+const pixelFarm = template({
+  id: 'pixel-farm',
+  title: '像素农场',
+  summary: '像素风种植玩法',
+  tags: ['经营', '像素'],
+  engine: 'godot',
+  runtime: 'godot',
+  templateVersion: '2.0.0',
+  installed: true,
+  installedVersion: '1.0.0',
+});
+const spaceShooter = template({
+  id: 'space-shooter',
+  title: '太空射击',
+  summary: '纵版弹幕射击',
+  tags: ['射击'],
+  runtime: 'unity',
+  engine: 'unity',
+  installed: false,
+});
+
+const templates: GameTemplateEntry[] = [matchThree, pixelFarm, spaceShooter];
+
+describe('templateMatchesQuery', () => {
+  it('matches title, summary, tags and engine case-insensitively', () => {
+    expect(templateMatchesQuery(matchThree, '三消')).toBe(true);
+    expect(templateMatchesQuery(matchThree, '经营')).toBe(true);
+    expect(templateMatchesQuery(matchThree, 'PHASER')).toBe(true);
+    expect(templateMatchesQuery(matchThree, '弹幕')).toBe(false);
+  });
+
+  it('requires every whitespace separated term to match', () => {
+    expect(templateMatchesQuery(pixelFarm, '像素 种植')).toBe(true);
+    expect(templateMatchesQuery(pixelFarm, '像素 弹幕')).toBe(false);
+    expect(templateMatchesQuery(pixelFarm, '   ')).toBe(true);
+  });
+});
+
+describe('filterGameTemplates', () => {
+  it('filters by tag, runtime, query and installed state together', () => {
+    expect(
+      filterGameTemplates(templates, {
+        ...EMPTY_TEMPLATE_LIBRARY_FILTERS,
+        tags: ['经营'],
+      }).map((entry) => entry.id),
+    ).toEqual(['match-3', 'pixel-farm']);
+
+    expect(
+      filterGameTemplates(templates, {
+        ...EMPTY_TEMPLATE_LIBRARY_FILTERS,
+        runtime: 'godot',
+      }).map((entry) => entry.id),
+    ).toEqual(['pixel-farm']);
+
+    expect(
+      filterGameTemplates(templates, {
+        ...EMPTY_TEMPLATE_LIBRARY_FILTERS,
+        installedOnly: true,
+        query: '经营',
+        tags: ['像素'],
+      }).map((entry) => entry.id),
+    ).toEqual(['pixel-farm']);
+  });
+
+  it('returns everything when no filter is active', () => {
+    expect(
+      filterGameTemplates(templates, EMPTY_TEMPLATE_LIBRARY_FILTERS),
+    ).toHaveLength(3);
+    expect(isTemplateLibraryFiltersEmpty(EMPTY_TEMPLATE_LIBRARY_FILTERS)).toBe(
+      true,
+    );
+    expect(
+      isTemplateLibraryFiltersEmpty({
+        ...EMPTY_TEMPLATE_LIBRARY_FILTERS,
+        query: ' x ',
+      }),
+    ).toBe(false);
+  });
+});
+
+describe('tag and runtime options', () => {
+  it('orders tags by frequency and drops blanks', () => {
+    const withBlank = [
+      ...templates,
+      template({ id: 'blank-tag', tags: ['', '  ', '经营'] }),
+    ];
+    expect(collectGameTemplateTags(withBlank)).toEqual([
+      '经营',
+      '三消',
+      '射击',
+      '像素',
+    ]);
+  });
+
+  it('collects distinct runtimes and labels them', () => {
+    expect(collectGameTemplateRuntimes(templates)).toEqual([
+      'godot',
+      'html',
+      'unity',
+    ]);
+    expect(templateRuntimeLabel('html')).toBe('网页');
+    expect(templateRuntimeLabel('cocos')).toBe('Cocos');
+    expect(templateRuntimeLabel('')).toBe('未标注运行时');
+    expect(templateRuntimeLabel('custom-engine')).toBe('custom-engine');
+  });
+
+  it('toggles tags without mutating the previous filters', () => {
+    const next = toggleGameTemplateTag(EMPTY_TEMPLATE_LIBRARY_FILTERS, '经营');
+    expect(next.tags).toEqual(['经营']);
+    expect(toggleGameTemplateTag(next, '经营').tags).toEqual([]);
+    expect(EMPTY_TEMPLATE_LIBRARY_FILTERS.tags).toEqual([]);
+  });
+});
+
+describe('needsTemplateDownload', () => {
+  it('requires a download when missing or when the installed version is stale', () => {
+    expect(needsTemplateDownload(matchThree)).toBe(false);
+    expect(needsTemplateDownload(pixelFarm)).toBe(true);
+    expect(needsTemplateDownload(spaceShooter)).toBe(true);
+  });
+});
+
+describe('formatGameTemplateSize', () => {
+  it('formats bytes, kilobytes and megabytes', () => {
+    expect(formatGameTemplateSize(0)).toBe('--');
+    expect(formatGameTemplateSize(512)).toBe('512 B');
+    expect(formatGameTemplateSize(2048)).toBe('2.0 KB');
+    expect(formatGameTemplateSize(5 * 1024 * 1024)).toBe('5.0 MB');
+  });
+});
diff --git a/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.ts b/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.ts
new file mode 100644
index 000000000..65f460fb9
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/features/template-library/templateLibraryModel.ts
@@ -0,0 +1,208 @@
+/**
+ * AGC 模板库的前端模型：清单类型、搜索与筛选的纯函数。
+ *
+ * 真源在 OSS 清单与 Rust 侧（`fetch_game_template_library`）；这里只做展示层派生，
+ * 不缓存业务真相，也不拼远端地址（URL 由 Rust 侧按受信任 OSS 前缀给出）。
+ */
+
+export type GameTemplateLibrarySource = 'network' | 'cache';
+
+export type GameTemplateEntry = {
+  id: string;
+  title: string;
+  summary: string;
+  tags: string[];
+  runtime: string;
+  engine: string;
+  engineVersion: string;
+  templateVersion: string;
+  updatedAt: string;
+  entry: string;
+  zipUrl: string;
+  zipSizeBytes: number;
+  zipSha256: string;
+  coverUrl: string;
+  coverWidth: number;
+  coverHeight: number;
+  installed: boolean;
+  installedVersion: string | null;
+  installedAtMillis: number | null;
+};
+
+export type GameTemplateLibrarySnapshot = {
+  schemaVersion: string;
+  library: string;
+  libraryVersion: number;
+  updatedAt: string;
+  fetchedAtMillis: number;
+  source: GameTemplateLibrarySource;
+  templates: GameTemplateEntry[];
+};
+
+export type InstalledGameTemplate = {
+  templateId: string;
+  templateVersion: string;
+  installedAtMillis: number;
+  zipSha256: string;
+  fileCount: number;
+  projectDir: string;
+};
+
+export type TemplateLibraryFilters = {
+  query: string;
+  tags: readonly string[];
+  runtime: string;
+  installedOnly: boolean;
+};
+
+export const EMPTY_TEMPLATE_LIBRARY_FILTERS: TemplateLibraryFilters = {
+  query: '',
+  tags: [],
+  runtime: '',
+  installedOnly: false,
+};
+
+const RUNTIME_LABELS: Record<string, string> = {
+  html: '网页',
+  unity: 'Unity',
+  godot: 'Godot',
+  cocos: 'Cocos',
+};
+
+export function templateRuntimeLabel(runtime: string): string {
+  const normalized = runtime.trim().toLowerCase();
+  if (!normalized) return '未标注运行时';
+  return RUNTIME_LABELS[normalized] ?? runtime.trim();
+}
+
+/**
+ * 空白分隔的多个关键词之间是「与」关系：每个词都必须命中标题、简介、标签或引擎，
+ * 这样「三消 像素」不会退化成命中任意一个就出现的宽泛搜索。
+ */
+export function templateMatchesQuery(
+  template: GameTemplateEntry,
+  query: string,
+): boolean {
+  const terms = query
+    .toLowerCase()
+    .split(/\s+/u)
+    .filter((term) => term.length > 0);
+  if (terms.length === 0) {
+    return true;
+  }
+  const haystack = [
+    template.title,
+    template.summary,
+    template.engine,
+    template.runtime,
+    template.tags.join(' '),
+  ]
+    .join(' ')
+    .toLowerCase();
+  return terms.every((term) => haystack.includes(term));
+}
+
+export function filterGameTemplates(
+  templates: readonly GameTemplateEntry[],
+  filters: TemplateLibraryFilters,
+): GameTemplateEntry[] {
+  const selectedTags = filters.tags
+    .map((tag) => tag.trim().toLowerCase())
+    .filter((tag) => tag.length > 0);
+  const runtime = filters.runtime.trim().toLowerCase();
+  return templates.filter((template) => {
+    if (filters.installedOnly && !template.installed) {
+      return false;
+    }
+    if (runtime && template.runtime.trim().toLowerCase() !== runtime) {
+      return false;
+    }
+    if (selectedTags.length > 0) {
+      const templateTags = template.tags.map((tag) => tag.toLowerCase());
+      if (!selectedTags.some((tag) => templateTags.includes(tag))) {
+        return false;
+      }
+    }
+    return templateMatchesQuery(template, filters.query);
+  });
+}
+
+/** 标签按出现次数降序，次数相同按名称排序，保证筛选条顺序稳定。 */
+export function collectGameTemplateTags(
+  templates: readonly GameTemplateEntry[],
+): string[] {
+  const counts = new Map<string, number>();
+  for (const template of templates) {
+    for (const tag of template.tags) {
+      const trimmed = tag.trim();
+      if (!trimmed) continue;
+      counts.set(trimmed, (counts.get(trimmed) ?? 0) + 1);
+    }
+  }
+  return [...counts.entries()]
+    .sort(
+      ([leftTag, leftCount], [rightTag, rightCount]) =>
+        rightCount - leftCount || leftTag.localeCompare(rightTag, 'zh-CN'),
+    )
+    .map(([tag]) => tag);
+}
+
+export function collectGameTemplateRuntimes(
+  templates: readonly GameTemplateEntry[],
+): string[] {
+  const runtimes = new Set<string>();
+  for (const template of templates) {
+    const runtime = template.runtime.trim().toLowerCase();
+    if (runtime) runtimes.add(runtime);
+  }
+  return [...runtimes].sort((left, right) =>
+    left.localeCompare(right, 'zh-CN'),
+  );
+}
+
+export function formatGameTemplateSize(bytes: number): string {
+  if (!Number.isFinite(bytes) || bytes <= 0) {
+    return '--';
+  }
+  if (bytes < 1024) {
+    return `${Math.round(bytes)} B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+export function isTemplateLibraryFiltersEmpty(
+  filters: TemplateLibraryFilters,
+): boolean {
+  return (
+    !filters.query.trim() &&
+    filters.tags.length === 0 &&
+    !filters.runtime.trim() &&
+    !filters.installedOnly
+  );
+}
+
+export function toggleGameTemplateTag(
+  filters: TemplateLibraryFilters,
+  tag: string,
+): TemplateLibraryFilters {
+  const exists = filters.tags.includes(tag);
+  return {
+    ...filters,
+    tags: exists
+      ? filters.tags.filter((value) => value !== tag)
+      : [...filters.tags, tag],
+  };
+}
+
+/**
+ * 已安装版本低于清单版本时必须重新下载；已安装且版本一致才算可直接使用。
+ */
+export function needsTemplateDownload(template: GameTemplateEntry): boolean {
+  return (
+    !template.installed ||
+    template.installedVersion !== template.templateVersion
+  );
+}
diff --git a/apps/ai-game-creator-shell/src/features/template-library/useTemplateLibrary.ts b/apps/ai-game-creator-shell/src/features/template-library/useTemplateLibrary.ts
new file mode 100644
index 000000000..aa1ef20a7
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/features/template-library/useTemplateLibrary.ts
@@ -0,0 +1,243 @@
+/**
+ * 模板库状态链路：拉取清单、下载模板、用模板建项目。
+ *
+ * 远端真相全在 Rust 侧命令里（受信任 OSS 前缀 + 摘要校验 + 本机安装记录）；
+ * 这里只维护界面状态，并在下载成功后把对应条目的安装状态就地更新，
+ * 避免为了一个"已下载"徽标再打一次清单请求。
+ */
+
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+
+import { resolveTauriInvoke } from '../../app/tauri';
+import type { InitLocalProjectResult } from '../../app/types';
+import {
+  collectGameTemplateRuntimes,
+  collectGameTemplateTags,
+  EMPTY_TEMPLATE_LIBRARY_FILTERS,
+  filterGameTemplates,
+  type GameTemplateEntry,
+  type GameTemplateLibrarySnapshot,
+  type InstalledGameTemplate,
+  isTemplateLibraryFiltersEmpty,
+  needsTemplateDownload,
+  type TemplateLibraryFilters,
+  toggleGameTemplateTag,
+} from './templateLibraryModel';
+
+export type TemplateLibraryStatus = 'idle' | 'loading' | 'ready' | 'error';
+export type TemplateLibraryBusyKind = 'download' | 'create';
+
+type UseTemplateLibraryOptions = {
+  /** 项目已建好：由调用方负责进入项目工作区（模板库不碰工作区状态）。 */
+  onProjectCreated: (result: InitLocalProjectResult) => Promise<void> | void;
+};
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export function useTemplateLibrary({
+  onProjectCreated,
+}: UseTemplateLibraryOptions) {
+  const [snapshot, setSnapshot] = useState<GameTemplateLibrarySnapshot | null>(
+    null,
+  );
+  const [status, setStatus] = useState<TemplateLibraryStatus>('idle');
+  const [error, setError] = useState('');
+  const [notice, setNotice] = useState('');
+  const [filters, setFilters] = useState<TemplateLibraryFilters>(
+    EMPTY_TEMPLATE_LIBRARY_FILTERS,
+  );
+  const [busyTemplateId, setBusyTemplateId] = useState<string | null>(null);
+  const [busyKind, setBusyKind] = useState<TemplateLibraryBusyKind | null>(
+    null,
+  );
+  const loadingRef = useRef(false);
+
+  const refresh = useCallback(async () => {
+    if (loadingRef.current) {
+      return;
+    }
+    const invoke = resolveTauriInvoke();
+    if (!invoke) {
+      setStatus('error');
+      setError('需要在陶泥儿客户端内运行');
+      return;
+    }
+    loadingRef.current = true;
+    setStatus('loading');
+    setError('');
+    try {
+      const next = await invoke<GameTemplateLibrarySnapshot>(
+        'fetch_game_template_library',
+      );
+      setSnapshot(next);
+      setStatus('ready');
+      setNotice(
+        next.source === 'cache' ? '远端清单暂时读不到，当前展示本机缓存' : '',
+      );
+    } catch (nextError) {
+      setStatus('error');
+      setError(errorMessage(nextError));
+    } finally {
+      loadingRef.current = false;
+    }
+  }, []);
+
+  useEffect(() => {
+    void refresh();
+  }, [refresh]);
+
+  const downloadTemplate = useCallback(async (template: GameTemplateEntry) => {
+    const invoke = resolveTauriInvoke();
+    if (!invoke) {
+      throw new Error('需要在陶泥儿客户端内运行');
+    }
+    setBusyTemplateId(template.id);
+    setBusyKind('download');
+    setError('');
+    try {
+      const installed = await invoke<InstalledGameTemplate>(
+        'download_game_template',
+        {
+          templateId: template.id,
+          templateVersion: template.templateVersion,
+        },
+      );
+      setSnapshot((current) =>
+        current
+          ? {
+              ...current,
+              templates: current.templates.map((entry) =>
+                entry.id === template.id
+                  ? {
+                      ...entry,
+                      installed: true,
+                      installedVersion: installed.templateVersion,
+                      installedAtMillis: installed.installedAtMillis,
+                    }
+                  : entry,
+              ),
+            }
+          : current,
+      );
+      setNotice(`已下载模板「${template.title}」`);
+      return installed;
+    } catch (nextError) {
+      setError(errorMessage(nextError));
+      throw nextError;
+    } finally {
+      setBusyTemplateId(null);
+      setBusyKind(null);
+    }
+  }, []);
+
+  const createProjectFromTemplate = useCallback(
+    async (template: GameTemplateEntry) => {
+      const invoke = resolveTauriInvoke();
+      if (!invoke) {
+        throw new Error('需要在陶泥儿客户端内运行');
+      }
+      try {
+        if (needsTemplateDownload(template)) {
+          await downloadTemplate(template);
+        }
+        setBusyTemplateId(template.id);
+        setBusyKind('create');
+        setError('');
+        setNotice(`正在用模板「${template.title}」创建项目`);
+        const result = await invoke<InitLocalProjectResult>(
+          'create_automatic_local_game_project_from_template',
+          {
+            templateId: template.id,
+            templateVersion: template.templateVersion,
+            name: null,
+            planning: false,
+          },
+        );
+        await onProjectCreated(result);
+        setNotice(`已用模板「${template.title}」创建项目`);
+        return result;
+      } catch (nextError) {
+        setError(errorMessage(nextError));
+        throw nextError;
+      } finally {
+        setBusyTemplateId(null);
+        setBusyKind(null);
+      }
+    },
+    [downloadTemplate, onProjectCreated],
+  );
+
+  const templates = useMemo(
+    () => snapshot?.templates ?? [],
+    [snapshot?.templates],
+  );
+  const visibleTemplates = useMemo(
+    () => filterGameTemplates(templates, filters),
+    [templates, filters],
+  );
+  const tagOptions = useMemo(
+    () => collectGameTemplateTags(templates),
+    [templates],
+  );
+  const runtimeOptions = useMemo(
+    () => collectGameTemplateRuntimes(templates),
+    [templates],
+  );
+  const installedCount = useMemo(
+    () => templates.filter((template) => template.installed).length,
+    [templates],
+  );
+  const filtersActive = !isTemplateLibraryFiltersEmpty(filters);
+
+  const setQuery = useCallback((query: string) => {
+    setFilters((current) => ({ ...current, query }));
+  }, []);
+
+  const selectRuntime = useCallback((runtime: string) => {
+    setFilters((current) => ({
+      ...current,
+      runtime: current.runtime === runtime ? '' : runtime,
+    }));
+  }, []);
+
+  const toggleTag = useCallback((tag: string) => {
+    setFilters((current) => toggleGameTemplateTag(current, tag));
+  }, []);
+
+  const setInstalledOnly = useCallback((installedOnly: boolean) => {
+    setFilters((current) => ({ ...current, installedOnly }));
+  }, []);
+
+  const clearFilters = useCallback(() => {
+    setFilters(EMPTY_TEMPLATE_LIBRARY_FILTERS);
+  }, []);
+
+  return {
+    snapshot,
+    status,
+    error,
+    notice,
+    templates,
+    visibleTemplates,
+    tagOptions,
+    runtimeOptions,
+    installedCount,
+    filters,
+    filtersActive,
+    setQuery,
+    selectRuntime,
+    toggleTag,
+    setInstalledOnly,
+    clearFilters,
+    busyTemplateId,
+    busyKind,
+    refresh,
+    downloadTemplate,
+    createProjectFromTemplate,
+    clearNotice: useCallback(() => setNotice(''), []),
+  };
+}
+
+export type TemplateLibraryController = ReturnType<typeof useTemplateLibrary>;
diff --git a/apps/ai-game-creator-shell/src/view/home/InspirationGallery.tsx b/apps/ai-game-creator-shell/src/view/home/InspirationGallery.tsx
deleted file mode 100644
index dc15824e9..000000000
--- a/apps/ai-game-creator-shell/src/view/home/InspirationGallery.tsx
+++ /dev/null
@@ -1,81 +0,0 @@
-import { useEffect, useState } from 'react';
-import { createPortal } from 'react-dom';
-
-// TODO: 后续改为由服务器下发灵感资源；届时保留此组件的展示与预览交互，移除本地目录扫描。
-const INSPIRATION_IMAGES = Object.entries(
-  import.meta.glob('./assets/inspiration/*.{webp,png,jpg,jpeg}', {
-    eager: true,
-    import: 'default',
-    query: '?url',
-  }),
-)
-  .sort(([left], [right]) =>
-    left.localeCompare(right, undefined, { numeric: true }),
-  )
-  .map(([, image]) => image as string);
-
-export default function InspirationGallery() {
-  const [selectedImage, setSelectedImage] = useState<string | null>(null);
-
-  useEffect(() => {
-    if (!selectedImage) {
-      return;
-    }
-    const previousOverflow = document.body.style.overflow;
-    document.body.style.overflow = 'hidden';
-    const handleKeyDown = (event: KeyboardEvent) => {
-      if (event.key === 'Escape') {
-        setSelectedImage(null);
-      }
-    };
-    window.addEventListener('keydown', handleKeyDown);
-    return () => {
-      document.body.style.overflow = previousOverflow;
-      window.removeEventListener('keydown', handleKeyDown);
-    };
-  }, [selectedImage]);
-
-  return (
-    <>
-      <div className="columns-3 gap-3 max-[760px]:columns-2 max-[460px]:columns-1">
-        {INSPIRATION_IMAGES.map((image, index) => (
-          <button
-            className="mb-3 block w-full cursor-zoom-in break-inside-avoid overflow-hidden rounded-lg border-0 bg-transparent p-0 shadow-(--platform-panel-shadow) transition duration-200 hover:-translate-y-0.5 hover:shadow-(--platform-profile-action-shadow) focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-(--platform-warm-text)"
-            type="button"
-            key={image}
-            aria-label={`查看灵感图片 ${index + 1}`}
-            onClick={() => setSelectedImage(image)}
-          >
-            <img
-              className="block h-auto w-full"
-              src={image}
-              alt=""
-              loading="lazy"
-              decoding="async"
-            />
-          </button>
-        ))}
-      </div>
-
-      {selectedImage
-        ? createPortal(
-            <div
-              className="fixed inset-0 z-[1000] grid cursor-zoom-out place-items-center bg-black/80 p-6"
-              role="dialog"
-              aria-modal="true"
-              aria-label="查看灵感图片"
-              onClick={() => setSelectedImage(null)}
-            >
-              <img
-                className="block max-h-[92vh] max-w-[92vw] cursor-default object-contain shadow-2xl"
-                src={selectedImage}
-                alt="放大的灵感图片"
-                onClick={(event) => event.stopPropagation()}
-              />
-            </div>,
-            document.body,
-          )
-        : null}
-    </>
-  );
-}
diff --git a/apps/ai-game-creator-shell/src/view/home/TemplateRecommendations.tsx b/apps/ai-game-creator-shell/src/view/home/TemplateRecommendations.tsx
new file mode 100644
index 000000000..56c4b1be6
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/view/home/TemplateRecommendations.tsx
@@ -0,0 +1,96 @@
+import { BadgeCheck, Loader2, Package } from 'lucide-react';
+
+import type { GameTemplateEntry } from '../../features/template-library/templateLibraryModel';
+import { templateRuntimeLabel } from '../../features/template-library/templateLibraryModel';
+
+type TemplateRecommendationsProps = {
+  templates: readonly GameTemplateEntry[];
+  loading: boolean;
+  error: string;
+  onOpenLibrary: () => void;
+};
+
+const RECOMMENDATION_LIMIT = 6;
+
+/**
+ * 首页模板推荐：只做展示与跳转，下载与建项目都在模板库页面里完成，
+ * 避免首页的卡片点击直接产生项目副作用。
+ */
+export default function TemplateRecommendations({
+  templates,
+  loading,
+  error,
+  onOpenLibrary,
+}: TemplateRecommendationsProps) {
+  if (loading && templates.length === 0) {
+    return (
+      <div className="flex items-center gap-2 py-6 text-[12px] text-(--platform-text-soft)">
+        <Loader2 className="animate-spin" size={14} aria-hidden="true" />
+        正在读取模板库…
+      </div>
+    );
+  }
+
+  if (templates.length === 0) {
+    return (
+      <div className="grid justify-items-center gap-2 py-6">
+        <Package
+          className="text-(--platform-icon-text)"
+          size={22}
+          aria-hidden="true"
+        />
+        <span className="text-[12px] text-(--platform-text-soft)">
+          {error || '模板库暂时没有可用的模板'}
+        </span>
+        <button
+          className="cursor-pointer border-0 bg-transparent p-0 text-[12px] text-(--platform-warm-text)"
+          type="button"
+          onClick={onOpenLibrary}
+        >
+          打开模板库
+        </button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="grid grid-cols-3 gap-3 max-[760px]:grid-cols-2 max-[460px]:grid-cols-1">
+      {templates.slice(0, RECOMMENDATION_LIMIT).map((template) => (
+        <button
+          className="grid cursor-pointer content-start overflow-hidden rounded-lg border border-(--platform-subpanel-border) bg-transparent p-0 text-left shadow-(--platform-panel-shadow) transition duration-200 hover:-translate-y-0.5 hover:shadow-(--platform-profile-action-shadow) focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-(--platform-warm-text)"
+          type="button"
+          key={template.id}
+          aria-label={`查看模板 ${template.title}`}
+          data-template-id={template.id}
+          onClick={onOpenLibrary}
+        >
+          <span className="relative block aspect-video w-full overflow-hidden bg-black/20">
+            <img
+              className="block h-full w-full object-cover"
+              src={template.coverUrl}
+              alt=""
+              loading="lazy"
+              decoding="async"
+            />
+            {template.installed ? (
+              <span className="absolute right-2 top-2 inline-flex items-center gap-1 rounded-full bg-black/60 px-2 py-0.5 text-[10px] text-white">
+                <BadgeCheck size={11} aria-hidden="true" />
+                已下载
+              </span>
+            ) : null}
+          </span>
+          <span className="grid gap-1 p-2.5">
+            <strong className="truncate text-[12px] text-(--platform-text-strong)">
+              {template.title}
+            </strong>
+            <span className="truncate text-[10px] text-(--platform-text-soft)">
+              {[templateRuntimeLabel(template.runtime), template.engine]
+                .filter((value) => value.trim())
+                .join(' · ')}
+            </span>
+          </span>
+        </button>
+      ))}
+    </div>
+  );
+}
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-01.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-01.webp
deleted file mode 100644
index 25821e804..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-01.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-02.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-02.webp
deleted file mode 100644
index ce26591db..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-02.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-03.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-03.webp
deleted file mode 100644
index 90287a674..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-03.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-04.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-04.webp
deleted file mode 100644
index 8fa04357a..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-04.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-05.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-05.webp
deleted file mode 100644
index cc657f1ef..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-05.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-06.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-06.webp
deleted file mode 100644
index bf922e8d3..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-06.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-07.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-07.webp
deleted file mode 100644
index 67048cfb9..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-07.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-08.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-08.webp
deleted file mode 100644
index 13f642612..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-08.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-09.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-09.webp
deleted file mode 100644
index d98a01ec7..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-09.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-10.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-10.webp
deleted file mode 100644
index 4ed427e84..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-10.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-11.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-11.webp
deleted file mode 100644
index b147b8ff7..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-11.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-12.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-12.webp
deleted file mode 100644
index 084ed36bb..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-12.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-13.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-13.webp
deleted file mode 100644
index 7da22fa4f..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-13.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-14.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-14.webp
deleted file mode 100644
index 88dcc70cb..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-14.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-15.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-15.webp
deleted file mode 100644
index 13315c560..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-15.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-16.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-16.webp
deleted file mode 100644
index 4af52bbda..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-16.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-17.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-17.webp
deleted file mode 100644
index 87c1ebe09..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-17.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-18.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-18.webp
deleted file mode 100644
index cc4bcb6c5..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-18.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-19.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-19.webp
deleted file mode 100644
index 413fff72b..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-19.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-20.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-20.webp
deleted file mode 100644
index b55594bba..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-20.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-21.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-21.webp
deleted file mode 100644
index 31db46017..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-21.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-22.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-22.webp
deleted file mode 100644
index 5d2e1fa4e..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-22.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-23.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-23.webp
deleted file mode 100644
index f34cd2398..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-23.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-24.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-24.webp
deleted file mode 100644
index b23f5e8d1..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-24.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-25.webp b/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-25.webp
deleted file mode 100644
index e008db1fc..000000000
Binary files a/apps/ai-game-creator-shell/src/view/home/assets/inspiration/inspiration-25.webp and /dev/null differ
diff --git a/apps/ai-game-creator-shell/src/view/home/index.tsx b/apps/ai-game-creator-shell/src/view/home/index.tsx
index 16236d779..ed160d88f 100644
--- a/apps/ai-game-creator-shell/src/view/home/index.tsx
+++ b/apps/ai-game-creator-shell/src/view/home/index.tsx
@@ -14,13 +14,14 @@ import { useRef, useState } from 'react';
 import BRAND_ICON from '../../../../../packages/shared/src/icons/taonier-product-ip.png';
 import type { ProjectStartMode } from '../../app/types';
 import { ConversationModelSelect } from '../../features/project-workspace/ConversationModelSelect';
+import type { GameTemplateEntry } from '../../features/template-library/templateLibraryModel';
 import RichInputArea, { UploadButton } from './components/RichInputArea';
 import {
   richTextToAttachments,
   richTextToPrompt,
 } from './components/RichInputArea/richTextToPrompt';
 import { resolveHomeStartMode } from './homeStartMode';
-import InspirationGallery from './InspirationGallery';
+import TemplateRecommendations from './TemplateRecommendations';
 import {
   type HomeCreationType,
   type HomeDraft,
@@ -113,6 +114,11 @@ type HomeViewProps = {
   onProjectsOpen: () => void;
   onProjectOpen: (path: string) => void;
   onProjectPick: () => void;
+  /** 模板库推荐位：清单来自 Rust 侧模板库，首页只负责展示与跳转。 */
+  templateRecommendations: readonly GameTemplateEntry[];
+  templateLibraryLoading: boolean;
+  templateLibraryError: string;
+  onTemplateLibraryOpen: () => void;
 };
 
 export default function HomeView({
@@ -126,6 +132,10 @@ export default function HomeView({
   onProjectsOpen,
   onProjectOpen,
   onProjectPick,
+  templateRecommendations,
+  templateLibraryLoading,
+  templateLibraryError,
+  onTemplateLibraryOpen,
 }: HomeViewProps) {
   const homeCreationType = useLauncherHomeDraftStore(
     (state) => state.creationType,
@@ -421,12 +431,12 @@ export default function HomeView({
 
       <section
         className="mx-auto mt-5.5 grid w-[min(814px,calc(100vw-122px))] gap-3.5 max-[760px]:w-[min(100%,calc(100vw-76px))]"
-        aria-label="灵感推荐"
+        aria-label="模板库推荐"
       >
         <header className="flex items-center justify-start gap-3">
           <span className="inline-flex items-baseline gap-1.5">
             <h2 className="m-0 text-[15px] text-(--platform-text-strong)">
-              灵感推荐
+              模板库
             </h2>
             <Sparkles
               className="text-(--platform-warm-text)"
@@ -435,8 +445,20 @@ export default function HomeView({
               style={{ transform: 'translateY(1px)' }}
             />
           </span>
+          <button
+            className="ml-auto cursor-pointer border-0 bg-transparent p-0 text-[12px] text-(--platform-warm-text)"
+            type="button"
+            onClick={onTemplateLibraryOpen}
+          >
+            查看全部模板
+          </button>
         </header>
-        <InspirationGallery />
+        <TemplateRecommendations
+          templates={templateRecommendations}
+          loading={templateLibraryLoading}
+          error={templateLibraryError}
+          onOpenLibrary={onTemplateLibraryOpen}
+        />
       </section>
     </div>
   );
diff --git a/apps/ai-game-creator-shell/src/view/layout.tsx b/apps/ai-game-creator-shell/src/view/layout.tsx
index 9974817f5..4464661ce 100644
--- a/apps/ai-game-creator-shell/src/view/layout.tsx
+++ b/apps/ai-game-creator-shell/src/view/layout.tsx
@@ -3,6 +3,7 @@ import {
   CircleHelp,
   FolderKanban,
   Home,
+  LayoutTemplate,
   Plus,
   Settings,
   User,
@@ -30,6 +31,7 @@ export type LauncherView =
   | 'guide'
   | 'contact'
   | 'news'
+  | 'template-library'
   | 'project-development';
 
 type SidebarUserInfo = {
@@ -284,6 +286,19 @@ export function Sidebar({
         >
           <FolderKanban size={17} aria-hidden="true" />
         </button>
+        <button
+          type="button"
+          aria-label="模板库"
+          title="模板库"
+          className={cx(
+            sidebarIconButtonClass,
+            activeView === 'template-library' &&
+              'border border-(--platform-nav-active-border) bg-(image:--platform-nav-active-fill) text-(--platform-nav-item-text-active) shadow-(--platform-nav-active-shadow)',
+          )}
+          onClick={() => changeView('template-library')}
+        >
+          <LayoutTemplate size={17} aria-hidden="true" />
+        </button>
       </nav>
       <div className="relative z-[60] mt-auto grid justify-items-center gap-[13px]">
         <div className="relative" ref={accountMenuRef}>
diff --git a/apps/ai-game-creator-shell/src/view/template-library/index.tsx b/apps/ai-game-creator-shell/src/view/template-library/index.tsx
new file mode 100644
index 000000000..d20654325
--- /dev/null
+++ b/apps/ai-game-creator-shell/src/view/template-library/index.tsx
@@ -0,0 +1,351 @@
+import {
+  ArrowLeft,
+  BadgeCheck,
+  Download,
+  Loader2,
+  Play,
+  RefreshCw,
+  Search,
+  SearchX,
+  SlidersHorizontal,
+} from 'lucide-react';
+
+import type { GameTemplateEntry } from '../../features/template-library/templateLibraryModel';
+import {
+  formatGameTemplateSize,
+  templateRuntimeLabel,
+} from '../../features/template-library/templateLibraryModel';
+import type { TemplateLibraryController } from '../../features/template-library/useTemplateLibrary';
+
+type TemplateLibraryViewProps = {
+  controller: TemplateLibraryController;
+  onBack: () => void;
+};
+
+const chipClass =
+  'cursor-pointer rounded-full border border-(--platform-subpanel-border) bg-transparent px-2.5 py-1 text-[11px] text-(--platform-text-soft) transition hover:border-(--platform-warm-text) hover:text-(--platform-warm-text)';
+const activeChipClass =
+  'cursor-pointer rounded-full border border-(--platform-warm-text) bg-transparent px-2.5 py-1 text-[11px] text-(--platform-warm-text)';
+
+function TemplateCard({
+  template,
+  busyKind,
+  busyTemplateId,
+  onDownload,
+  onUse,
+}: {
+  template: GameTemplateEntry;
+  busyKind: 'download' | 'create' | null;
+  busyTemplateId: string | null;
+  onDownload: (template: GameTemplateEntry) => void;
+  onUse: (template: GameTemplateEntry) => void;
+}) {
+  const busy = busyTemplateId === template.id;
+  const busyLabel =
+    busy && busyKind === 'download'
+      ? '正在下载模板'
+      : busy && busyKind === 'create'
+        ? '正在创建项目'
+        : '';
+  const meta = [
+    templateRuntimeLabel(template.runtime),
+    template.engine,
+    `v${template.templateVersion}`,
+    formatGameTemplateSize(template.zipSizeBytes),
+  ]
+    .filter((value) => value && value.trim())
+    .join(' · ');
+
+  return (
+    <article
+      className="grid content-start overflow-hidden rounded-xl border border-(--platform-subpanel-border) [background:var(--platform-subpanel-fill)]"
+      data-template-id={template.id}
+      data-template-installed={template.installed ? 'true' : 'false'}
+    >
+      <div className="relative aspect-video w-full overflow-hidden bg-black/20">
+        <img
+          className="block h-full w-full object-cover"
+          src={template.coverUrl}
+          alt=""
+          loading="lazy"
+          decoding="async"
+        />
+        {template.installed ? (
+          <span
+            className="absolute right-2 top-2 inline-flex items-center gap-1 rounded-full bg-black/60 px-2 py-0.5 text-[10px] text-white"
+            title={`已下载 v${template.installedVersion ?? template.templateVersion}`}
+          >
+            <BadgeCheck size={12} aria-hidden="true" />
+            已下载
+          </span>
+        ) : null}
+      </div>
+      <div className="grid gap-2 p-3">
+        <strong className="truncate text-[13px] text-(--platform-text-strong)">
+          {template.title}
+        </strong>
+        <span className="truncate text-[10px] text-(--platform-text-soft)">
+          {meta}
+        </span>
+        {template.summary ? (
+          <p className="m-0 line-clamp-2 text-[11px] leading-4 text-(--platform-neutral-text)">
+            {template.summary}
+          </p>
+        ) : null}
+        {template.tags.length > 0 ? (
+          <div className="flex flex-wrap gap-1">
+            {template.tags.map((tag) => (
+              <span
+                className="rounded-full bg-(--platform-nav-item-hover-fill) px-2 py-0.5 text-[10px] text-(--platform-text-soft)"
+                key={tag}
+              >
+                {tag}
+              </span>
+            ))}
+          </div>
+        ) : null}
+        <div className="mt-1 flex items-center gap-2">
+          <button
+            type="button"
+            className="inline-flex cursor-pointer items-center gap-1.5 rounded-lg border border-(--platform-warm-text) bg-transparent px-2.5 py-1.5 text-[11px] text-(--platform-warm-text) disabled:cursor-default disabled:opacity-50"
+            disabled={busy}
+            onClick={() => onUse(template)}
+          >
+            {busy && busyKind === 'create' ? (
+              <Loader2 className="animate-spin" size={12} aria-hidden="true" />
+            ) : (
+              <Play size={12} aria-hidden="true" />
+            )}
+            使用模板
+          </button>
+          <button
+            type="button"
+            className="inline-flex cursor-pointer items-center gap-1.5 rounded-lg border border-(--platform-subpanel-border) bg-transparent px-2.5 py-1.5 text-[11px] text-(--platform-text-soft) disabled:cursor-default disabled:opacity-50"
+            disabled={busy}
+            onClick={() => onDownload(template)}
+          >
+            {busy && busyKind === 'download' ? (
+              <Loader2 className="animate-spin" size={12} aria-hidden="true" />
+            ) : (
+              <Download size={12} aria-hidden="true" />
+            )}
+            下载
+          </button>
+          {busyLabel ? (
+            <span className="text-[10px] text-(--platform-text-soft)">
+              {busyLabel}
+            </span>
+          ) : null}
+        </div>
+      </div>
+    </article>
+  );
+}
+
+export default function TemplateLibraryView({
+  controller,
+  onBack,
+}: TemplateLibraryViewProps) {
+  const {
+    status,
+    error,
+    notice,
+    templates,
+    visibleTemplates,
+    tagOptions,
+    runtimeOptions,
+    installedCount,
+    filters,
+    filtersActive,
+    setQuery,
+    selectRuntime,
+    toggleTag,
+    setInstalledOnly,
+    clearFilters,
+    busyTemplateId,
+    busyKind,
+    refresh,
+    downloadTemplate,
+    createProjectFromTemplate,
+  } = controller;
+
+  const showEmptyLibrary = status === 'ready' && templates.length === 0;
+  const showNoMatch =
+    status === 'ready' && templates.length > 0 && visibleTemplates.length === 0;
+
+  return (
+    <section
+      className="grid w-full content-start gap-4 px-6 pb-10 pt-5 max-[760px]:px-4"
+      aria-label="模板库"
+    >
+      <header className="flex flex-wrap items-center gap-3">
+        <button
+          type="button"
+          className="inline-flex cursor-pointer items-center gap-1.5 rounded-lg border border-(--platform-subpanel-border) bg-transparent px-2.5 py-1.5 text-[12px] text-(--platform-text-soft)"
+          onClick={onBack}
+        >
+          <ArrowLeft size={14} aria-hidden="true" />
+          返回
+        </button>
+        <span className="inline-flex items-baseline gap-2">
+          <h1 className="m-0 text-[17px] text-(--platform-text-strong)">
+            模板库
+          </h1>
+          <span className="text-[11px] text-(--platform-text-soft)">
+            共 {templates.length} 个模板 · 已下载 {installedCount} 个
+          </span>
+        </span>
+        <button
+          type="button"
+          className="ml-auto inline-flex cursor-pointer items-center gap-1.5 rounded-lg border border-(--platform-subpanel-border) bg-transparent px-2.5 py-1.5 text-[12px] text-(--platform-text-soft) disabled:cursor-default disabled:opacity-60"
+          disabled={status === 'loading'}
+          onClick={() => void refresh()}
+        >
+          {status === 'loading' ? (
+            <Loader2 className="animate-spin" size={13} aria-hidden="true" />
+          ) : (
+            <RefreshCw size={13} aria-hidden="true" />
+          )}
+          刷新
+        </button>
+      </header>
+
+      <div className="grid gap-3 rounded-xl border border-(--platform-subpanel-border) [background:var(--platform-subpanel-fill)] p-3">
+        <div className="flex flex-wrap items-center gap-2">
+          <label className="inline-flex min-w-[220px] flex-1 items-center gap-2 rounded-lg border border-(--platform-subpanel-border) bg-transparent px-2.5 py-1.5">
+            <Search
+              className="text-(--platform-icon-text)"
+              size={14}
+              aria-hidden="true"
+            />
+            <input
+              className="w-full border-0 bg-transparent p-0 text-[12px] text-(--platform-text-strong) outline-none"
+              type="search"
+              value={filters.query}
+              placeholder="搜索模板名称、玩法、标签"
+              aria-label="搜索模板"
+              onChange={(event) => setQuery(event.target.value)}
+            />
+          </label>
+          <button
+            type="button"
+            className={filters.installedOnly ? activeChipClass : chipClass}
+            aria-pressed={filters.installedOnly}
+            onClick={() => setInstalledOnly(!filters.installedOnly)}
+          >
+            仅看已下载
+          </button>
+          {filtersActive ? (
+            <button type="button" className={chipClass} onClick={clearFilters}>
+              清除筛选
+            </button>
+          ) : null}
+        </div>
+        {runtimeOptions.length > 0 ? (
+          <div className="flex flex-wrap items-center gap-2">
+            <span className="inline-flex items-center gap-1 text-[11px] text-(--platform-text-soft)">
+              <SlidersHorizontal size={12} aria-hidden="true" />
+              运行时
+            </span>
+            {runtimeOptions.map((runtime) => (
+              <button
+                type="button"
+                key={runtime}
+                className={
+                  filters.runtime === runtime ? activeChipClass : chipClass
+                }
+                aria-pressed={filters.runtime === runtime}
+                onClick={() => selectRuntime(runtime)}
+              >
+                {templateRuntimeLabel(runtime)}
+              </button>
+            ))}
+          </div>
+        ) : null}
+        {tagOptions.length > 0 ? (
+          <div className="flex flex-wrap items-center gap-2">
+            <span className="text-[11px] text-(--platform-text-soft)">
+              标签
+            </span>
+            {tagOptions.map((tag) => (
+              <button
+                type="button"
+                key={tag}
+                className={
+                  filters.tags.includes(tag) ? activeChipClass : chipClass
+                }
+                aria-pressed={filters.tags.includes(tag)}
+                onClick={() => toggleTag(tag)}
+              >
+                {tag}
+              </button>
+            ))}
+          </div>
+        ) : null}
+      </div>
+
+      {notice ? (
+        <p
+          className="m-0 text-[12px] text-(--platform-text-soft)"
+          role="status"
+        >
+          {notice}
+        </p>
+      ) : null}
+      {error ? (
+        <div
+          className="flex flex-wrap items-center gap-3 rounded-lg border border-(--platform-subpanel-border) px-3 py-2 text-[12px] text-(--platform-warm-text)"
+          role="alert"
+        >
+          <span>{error}</span>
+          <button
+            type="button"
+            className={chipClass}
+            onClick={() => void refresh()}
+          >
+            重试
+          </button>
+        </div>
+      ) : null}
+
+      {status === 'loading' && templates.length === 0 ? (
+        <p className="m-0 text-[12px] text-(--platform-text-soft)">
+          正在读取模板库…
+        </p>
+      ) : null}
+      {showEmptyLibrary ? (
+        <p className="m-0 text-[12px] text-(--platform-text-soft)">
+          模板库暂时还没有可用的模板。
+        </p>
+      ) : null}
+      {showNoMatch ? (
+        <div className="flex items-center gap-2 text-[12px] text-(--platform-text-soft)">
+          <SearchX size={14} aria-hidden="true" />
+          没有符合当前筛选的模板
+          <button type="button" className={chipClass} onClick={clearFilters}>
+            清除筛选
+          </button>
+        </div>
+      ) : null}
+
+      {visibleTemplates.length > 0 ? (
+        <div className="grid grid-cols-[repeat(auto-fill,minmax(250px,1fr))] gap-3.5">
+          {visibleTemplates.map((template) => (
+            <TemplateCard
+              key={template.id}
+              template={template}
+              busyKind={busyKind}
+              busyTemplateId={busyTemplateId}
+              onDownload={(next) => {
+                void downloadTemplate(next).catch(() => undefined);
+              }}
+              onUse={(next) => {
+                void createProjectFromTemplate(next).catch(() => undefined);
+              }}
+            />
+          ))}
+        </div>
+      ) : null}
+    </section>
+  );
+}
diff --git a/docs/README.md b/docs/README.md
index 6450b77c5..c1b562be7 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -39,6 +39,7 @@
 - [AGC 通用插件宿主与编辑器适配](./technical/【技术方案】AGC通用插件宿主与编辑器适配-2026-09-09.md)：通用插件宿主、SDK、权限审计、UI 挂载和 Cocos 编辑器适配边界。
 - [AGC Cocos Creator 编辑器桥接模块](<./technical/【技术方案】AGC Cocos Creator 编辑器桥接模块-2026-09-09.md>)：独立 crate、feature 开关、目标校验与 Windows 注入边界。
 - [AGC 客户端更新检查与下载](./technical/【技术方案】AGC客户端更新检查与下载-2026-08-31.md)：启动版本检测、OSS 清单格式和下载约定。
+- [AGC 模板库与模板建项](./technical/【技术方案】AGC模板库与模板建项-2026-09-17.md)：`templates/` 前缀的模板库契约、下载安装与「用模板建项目」链路。
 - [DirectProject 本轮附件路径映射](./technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md)：Direct 首轮只映射附件原名与项目相对路径，不灌正文、不区别 GDD。
 - [Direct 回合行为审计账本](./technical/【技术方案】Direct回合行为审计账本-2026-08-31.md)：Direct GUI 回合把 native 读 / MCP / 写文件落成项目内有界时间线，用于判断有没有打开本轮附件。
 - [项目开发工作台 PRD](./prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md)：当前工作台页面和验收边界。
diff --git a/docs/project-memory/plans/【实施计划】AGC模板库客户端接入-2026-09-17.md b/docs/project-memory/plans/【实施计划】AGC模板库客户端接入-2026-09-17.md
new file mode 100644
index 000000000..c5559f198
--- /dev/null
+++ b/docs/project-memory/plans/【实施计划】AGC模板库客户端接入-2026-09-17.md
@@ -0,0 +1,57 @@
+# AGC 模板库客户端接入实施计划
+
+Version: 1.0
+Status: active
+Date: 2026-09-17
+Milestone Spec: `docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md`
+
+## 步骤
+
+1. **OSS 库布局与契约**
+   - 在 `agc-dev` 落地 `templates/` 前缀：`index.json`、`v1/<id>/{template.json,template.zip,cover.png}`。
+   - 清单补齐 `tags`、`coverKey/coverWidth/coverHeight/coverSha256`，正文改为 zip（zip 根 == 项目根）。
+   - 交付：`scripts/agc-template-library-publish.mjs`（校验 + 上传 + 回读校验）、`templates/README.md`。
+   - 验收：匿名 `GET templates/index.json` 可读，每个 `zipKey` 回读 SHA-256 与清单一致。
+
+2. **Rust 模板库模块**
+   - 新增 `src-tauri/src/template_library.rs`：清单解析与校验、受信任 base、缓存/安装目录、zip 安全解压、安装记录、由模板建项目。
+   - 注册命令 `fetch_game_template_library`、`download_game_template`、`create_automatic_local_game_project_from_template`。
+   - 交付：模块内 8 项单测（schema/重复模板、键前缀、base 校验、解压逃逸、摘要与大小、安装记录、建项目与失败清理）。
+   - 验收：`cargo test --bin genarrative-ai-game-creator-shell template_library` 全绿。
+
+3. **前端状态链路**
+   - `src/features/template-library/templateLibraryModel.ts`（类型与搜索/筛选纯函数）与 `useTemplateLibrary.ts`（拉取、下载、建项目、就地更新已下载状态）。
+   - `useHomeProjectCreation` 增加 `enterCreatedTemplateProject`，复用既有进项目通道。
+   - 交付：9 项模型单测。
+   - 验收：`npx vitest run src/features/template-library` 全绿。
+
+4. **界面接入**
+   - 新增 `src/view/template-library/index.tsx` 全屏页；`LauncherView` 增加 `template-library`；左侧导航加模板库入口。
+   - 首页「灵感推荐」替换为 `TemplateRecommendations`；删除 `InspirationGallery.tsx` 与 `assets/inspiration/`。
+   - `tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机以加载封面。
+   - 验收：模板库页可搜索、筛选、下载、显示已下载并成功建项目；首页推荐位可跳转。
+
+5. **文档与共享记忆**
+   - 主规范 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`，并在 `docs/README.md` 建索引。
+   - 本里程碑与实施计划；`decision-log.md` 记录库路径、清单 schema、缓存目录与 CSP 约定。
+   - 验收：`node scripts/check-doc-index.mjs` 通过。
+
+## 验证命令
+
+```bash
+cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml
+cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell template_library
+cd apps/ai-game-creator-shell && npx tsc -p tsconfig.json --noEmit
+cd apps/ai-game-creator-shell && npx vitest run src/features/template-library
+node scripts/agc-template-library-publish.mjs --source <dir> --dry-run
+npm run check:encoding
+node scripts/check-doc-index.mjs
+git diff --check
+```
+
+## 风险与回退
+
+- **封面走 WebView 直连**：仅放行受信任 OSS 主机；若日后改用后端签名，清单的 `coverKey` 不变。
+- **模板包体积**：下载上限 512 MiB、解压文件数 4096、单文件 256 MiB；超限直接拒绝，不落盘。
+- **清单漂移**：客户端只信「受信任主机 + 对象键」，清单中的地址字段不参与请求。
+- **回退**：清空 `templates/` 前缀即回到空模板库；客户端保留错误与空态展示，不阻断其它功能。
diff --git a/docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md b/docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md
new file mode 100644
index 000000000..f35aec28b
--- /dev/null
+++ b/docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md
@@ -0,0 +1,40 @@
+# AGC 模板库客户端接入
+
+Version: 1.0
+Status: active
+Date: 2026-09-17
+Parent Spec: `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`
+
+## 目标
+
+AGC 客户端能读取公共 OSS 上的游戏模板库，并把「浏览 → 筛选 → 下载 → 用模板建项目」做成一条可用链路，模板更新不再依赖客户端发版。
+
+## 范围
+
+- OSS `templates/` 前缀的库布局、清单 schema、封面与 zip 元数据契约。
+- Rust 侧读取清单、下载安装、由模板创建项目的命令与安全边界。
+- 模板库全屏页（搜索、标签/运行时筛选、仅看已下载）、首页模板推荐位、左侧导航入口。
+- 仓库内发布脚本与文档、模板库定向单测与类型检查。
+
+## 不做
+
+- 不做模板制作工具、模板审核、模板计费与推荐算法。
+- 不做模板增量更新（按 `templateVersion` 全量重下）。
+- 不把模板回填进已创建项目，也不改写用户项目内容。
+- 不放宽现有项目私有 DACL、下载摘要校验和受信任 OSS 主机边界。
+
+## 验收标准
+
+1. `fetch_game_template_library` 能读到清单并合并本机已安装状态；远端不可用时回退本机缓存并标明 `source=cache`。
+2. `download_game_template` 对字节数与 SHA-256 不一致、越界对象键、非 `templates/` 前缀的包一律拒绝，且不落半成品目录。
+3. zip 解压拒绝绝对路径、`..`、盘符、符号链接；安装完成后才写 `installed.json` 作为已下载判据。
+4. `create_automatic_local_game_project_from_template` 建出的项目同时具备模板文件、`.agent` 清单与标准目录；失败时不留项目目录。
+5. 模板库页可按关键词、标签、运行时与「仅看已下载」筛选；卡片显示封面与已下载徽标；「使用模板」在版本落后时先重下再建项。
+6. 首页推荐位展示模板库内容并可进入模板库页；左侧导航有模板库入口且为独立全屏页。
+7. 定向 Rust 单测 8 项、前端模型单测 9 项、`tsc` 类型检查、`npm run check:encoding`、`git diff --check` 全部通过。
+
+## 依赖
+
+- 现有自动工作区建项链路（`create_automatic_local_game_project_at` / `init_local_game_project_at`）。
+- 现有 AGC 更新通道使用的受信任 OSS 主机与 CSP 白名单口径。
+- 仓库 OSS 凭据（本机 `.env.secrets.local` 的 `ALIYUN_OSS_*`）与 `scripts/agc-template-library-publish.mjs`。
diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md
index 0ba04d1c5..aa8b5084f 100644
--- a/docs/project-memory/shared-memory/decision-log.md
+++ b/docs/project-memory/shared-memory/decision-log.md
@@ -8798,3 +8798,13 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 
 - 决策：采用后台继续运行语义。Direct 回合由进程内项目身份锁持有，页面离开不取消；重进项目通过活动回合只读快照与 Thread Manager bootstrap/consume 恢复忙碌态和进度。左上角面板复用同一快照列出正在运行的 Direct 项目并支持进入。
 - 边界：快照不写项目文件、不进入公共 API、不跨应用重启恢复；读取失败保留上一份结果并单独提示，不改写成权限或审批失败。身份锁排他性、付费身份和项目写锁不变。
+
+## 2026-09-17 AGC 模板库落在 oss://agc-dev/templates/
+
+- 背景：AGC 需要「真·游戏模板」库，让用户能浏览、筛选、下载模板并直接由模板创建项目，且模板内容更新不依赖客户端发版。
+- 决策：模板库固定在 bucket `agc-dev`（endpoint `oss-rg-china-mainland.aliyuncs.com`）的 `templates/` 前缀，公共读；**不再嵌套 `agc/` 这一层**（`agc/` 继续只放客户端安装包与 `latest.json` 更新通道）。目录为 `templates/index.json` + `templates/v1/<templateId>/{template.json,template.zip,cover.png}`，zip 根等于 AGC 项目根。
+- 决策：清单 schema 为 `agc-template-library.v1`，每条模板带 `tags`、`coverKey/coverWidth/coverHeight/coverSha256`、`zipKey/zipSizeBytes/zipSha256` 与 `templateVersion`；客户端只信「受信任 OSS 主机 + 对象键」自行拼 URL，清单里的地址字段不参与请求。
+- 决策：客户端缓存与安装根为 `<app_data>/templates/`（`index.json` 缓存 + `installed/<id>/<version>/`，安装完成才写 `installed.json`）；建项目在 `<app_data>/projects/` 下走既有自动工作区规则，先铺模板文件再补 `.agent` 清单。
+- 决策：模板库首页推荐位替换原「灵感推荐」本机图片目录（已删除 `InspirationGallery.tsx` 与 `assets/inspiration/`）；左侧导航新增模板库入口，打开独立全屏页。`tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机用于封面图。
+- 关联规范：`docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`；开发期计划见 `docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md` 与对应实施计划。
+- 验证：Rust 模板库 8 项定向单测、前端模型 9 项单测、AGC `tsc` 类型检查通过；`templates/index.json` 匿名可读且每个 `zipKey` 回读 SHA-256 与清单一致；发布脚本 `scripts/agc-template-library-publish.mjs` 支持 `--dry-run` 与上传后回读校验。
diff --git a/docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md b/docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md
new file mode 100644
index 000000000..00b071ab6
--- /dev/null
+++ b/docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md
@@ -0,0 +1,93 @@
+# 【技术方案】AGC 模板库与模板建项
+
+## 交付范围
+
+AGC 客户端接入公共 OSS 上的**游戏模板库**（真·游戏模板，正文是 zip），并让用户能浏览、搜索、筛选、下载模板，直接由模板创建项目。模板更新不再依赖客户端发版。
+
+- OSS 侧：bucket `agc-dev`（endpoint `oss-rg-china-mainland.aliyuncs.com`）下的 `templates/` 前缀，公共读。
+- 客户端侧：Rust `template_library` 模块（读清单、下载、安装、建项目）+ 模板库全屏页 + 首页模板推荐 + 左侧导航入口。
+- 不在本次范围：模板制作工具、模板审核、模板计费、增量更新、已建项目的模板回填。
+
+## OSS 契约
+
+```text
+templates/
+  index.json                       # 模板库清单，客户端唯一读取入口
+  v1/<templateId>/
+    template.json                  # 单模板元数据（含文件级摘要）
+    template.zip                   # 模板正文，zip 根 == AGC 项目根（如 game/index.html）
+    cover.png                      # 封面图（卡片展示，客户端 <img> 直接取）
+```
+
+`index.json`（schema `agc-template-library.v1`）：
+
+| 字段 | 说明 |
+| --- | --- |
+| `schemaVersion` | 固定 `agc-template-library.v1`；破坏性变更换 schema，不原地改语义 |
+| `library` / `libraryVersion` / `updatedAt` | 库标识、库格式版本、本次更新时间 |
+| `templates[].id` | 稳定标识，`[a-z0-9][a-z0-9._-]{0,63}`，同时是目录名 |
+| `templates[].title/summary/tags[]` | 展示与搜索/筛选用文案；`tags` 参与标签筛选与关键词命中 |
+| `templates[].runtime` | `html` / `unity` / `godot` / `cocos` |
+| `templates[].engine` / `engineVersion` | 引擎标识与版本（如 `phaser` 4.2.1、`three.js` 0.180.0） |
+| `templates[].templateVersion` / `updatedAt` | 模板内容版本；客户端按它判断是否需要重新下载 |
+| `templates[].entry` | 解压后的项目入口相对路径，如 `game/index.html` |
+| `templates[].zipKey` / `zipSizeBytes` / `zipSha256` | 模板包对象键、字节数、SHA-256（下载后强校验） |
+| `templates[].coverKey` / `coverWidth` / `coverHeight` / `coverSha256` | 封面对象键与尺寸/摘要 |
+| `templates[].metadataKey` | 单模板元数据对象键（`template.json`） |
+
+约束：
+
+- 所有对象键必须落在 `templates/` 前缀内；客户端只用「受信任 OSS 主机 + 对象键」自行拼 URL，**不直接信任清单里的地址**。
+- 任何一项校验失败（schema、标识符、sha256、尺寸、键前缀）都让整次清单读取失败，前端拿到的是全有或全无的清单。
+- 上传与校验由仓库脚本 [`scripts/agc-template-library-publish.mjs`](../../scripts/agc-template-library-publish.mjs) 完成：源目录放 `v1/<id>/{meta.json,template.zip,cover.png,project/}`，脚本生成 `template.json` 与 `index.json`、上传并回读校验。
+- 客户端可用 `AGC_TEMPLATE_LIBRARY_BASE_URL` 覆盖库地址；只接受 `https://agc-dev.oss-rg-china-mainland.aliyuncs.com`（拒绝其他主机、路径、http）。
+
+## 客户端实现
+
+### Rust：`apps/ai-game-creator-shell/src-tauri/src/template_library.rs`
+
+| 命令 | 行为 |
+| --- | --- |
+| `fetch_game_template_library` | 读 `templates/index.json`（≤4 MiB），校验后缓存到 `<app_data>/templates/index.json`；网络失败时回退本机缓存并在 `source` 标 `cache` |
+| `download_game_template` | 取清单里对应条目，流式下载 zip（≤512 MiB），校验字节数与 SHA-256，解压到 `<app_data>/templates/installed/<id>/<version>/`，最后写 `installed.json` 作为安装完成的唯一标记 |
+| `create_automatic_local_game_project_from_template` | 需要时先安装模板，然后在 `<app_data>/projects/` 下按既有自动工作区规则建目录：先复制模板文件，再走 `init_local_game_project_at` 补 `.agent` 清单与标准目录 |
+
+安全与健壮性：
+
+- 解压只接受普通文件与目录：拒绝绝对路径、`..`、盘符、反斜杠、符号链接，并有文件数（4096）与单文件大小（256 MiB）上限。
+- 安装目录名由标识符白名单拼出，不拼接远端字符串；重装时只清理该模板自己的安装目录。
+- 模板文件与安装记录统一走 `write_game_creator_private_file` / `ensure_game_creator_private_directory_tree`，保持项目目录的私有 DACL 口径。
+- 建项目失败时删除刚创建的项目目录，不留半成品。
+
+### 前端
+
+- `src/features/template-library/templateLibraryModel.ts`：清单类型、搜索（空白分隔多关键词「与」）、标签/运行时/已下载筛选、标签选项聚合、体积格式化等纯函数。
+- `src/features/template-library/useTemplateLibrary.ts`：一次拉清单，暴露筛选状态、下载与「用模板建项目」；下载成功后只就地更新该条目的已下载状态。
+- `src/view/template-library/index.tsx`：模板库全屏页（返回、刷新、搜索、运行时/标签筛选、仅看已下载、卡片显示封面与已下载徽标、下载/使用模板）。
+- 首页「灵感推荐」替换为「模板库」推荐位（`src/view/home/TemplateRecommendations.tsx`）：只展示封面、标题、运行时与已下载徽标，点击进入模板库页面；首页不再直接触发建项目。
+- 左侧导航新增模板库入口（`LauncherView = 'template-library'`）。
+- `src-tauri/tauri.conf.json` 的 `csp` / `devCsp` 在 `img-src` 放行 `https://agc-dev.oss-rg-china-mainland.aliyuncs.com`，用于封面图；`connect-src` 原本已放行同一域名。
+- 旧的本机灵感图目录 `src/view/home/assets/inspiration/` 与 `InspirationGallery.tsx` 一并删除，不再保留退役实现。
+
+## 验收与验证
+
+```bash
+# 模板库单测（清单校验、键安全、解压路径逃逸、安装与建项目）
+cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell template_library
+# 前端模型单测
+cd apps/ai-game-creator-shell && npx vitest run src/features/template-library
+# 类型检查 / 编码 / 空白
+cd apps/ai-game-creator-shell && npm run typecheck
+npm run check:encoding
+git diff --check
+# OSS 侧匿名可读
+curl -s https://agc-dev.oss-rg-china-mainland.aliyuncs.com/templates/index.json
+```
+
+手工验收：打开模板库 → 搜索与筛选 → 下载（出现「已下载」徽标）→ 「使用模板」→ 进入项目工作台且项目里已有模板文件。
+
+## 失败与回退
+
+- 清单读不到且没有本机缓存：模板库页显示错误与重试，首页推荐位显示「模板库暂时没有可用的模板」。
+- 版本落后：`installedVersion != templateVersion` 视为需要重新下载，点「使用模板」会先重下再建项目。
+- 需要回退整条链路时，删除 `templates/` 前缀即可让客户端回到"空模板库"；客户端代码路径不受影响。
diff --git a/scripts/agc-template-library-publish.mjs b/scripts/agc-template-library-publish.mjs
new file mode 100644
index 000000000..405da60de
--- /dev/null
+++ b/scripts/agc-template-library-publish.mjs
@@ -0,0 +1,362 @@
+#!/usr/bin/env node
+/**
+ * 发布 AGC 模板库到 OSS。
+ *
+ * 用法：
+ *   node scripts/agc-template-library-publish.mjs --source <dir> [--dry-run]
+ *     [--bucket agc-dev] [--endpoint oss-rg-china-mainland.aliyuncs.com] [--prefix templates]
+ *
+ * 源目录结构（模板正文是 zip，zip 根 == AGC 项目根，例如 game/index.html）：
+ *   <source>/v1/<templateId>/meta.json      模板元数据（title/summary/tags/runtime/engine/…）
+ *   <source>/v1/<templateId>/template.zip   模板包
+ *   <source>/v1/<templateId>/cover.png      封面图
+ *
+ * 脚本会按包内容生成 `v1/<templateId>/template.json` 与库清单 `index.json`，
+ * 然后上传 zip、封面、模板元数据与清单。上传前会完成全部校验，任何一项不合法都不发请求。
+ */
+
+import { createHash, createHmac } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+const SCHEMA_VERSION = 'agc-template-library.v1';
+const TEMPLATE_SCHEMA_VERSION = 'agc-template.v1';
+const TEMPLATE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}$/u;
+const TEMPLATE_VERSION_PATTERN = /^[a-z0-9][a-z0-9._-]{0,31}$/u;
+const RUNTIMES = new Set(['html', 'unity', 'godot', 'cocos']);
+const COVER_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.webp']);
+
+function usage() {
+  console.log(
+    [
+      '用法: node scripts/agc-template-library-publish.mjs --source <dir> [--dry-run]',
+      '      [--bucket agc-dev] [--endpoint oss-rg-china-mainland.aliyuncs.com] [--prefix templates]',
+    ].join('\n'),
+  );
+}
+
+function parseArgs(argv) {
+  const args = {
+    source: '',
+    bucket: process.env.AGC_TEMPLATE_LIBRARY_BUCKET?.trim() || 'agc-dev',
+    endpoint:
+      process.env.AGC_TEMPLATE_LIBRARY_ENDPOINT?.trim() ||
+      'oss-rg-china-mainland.aliyuncs.com',
+    prefix: 'templates',
+    dryRun: false,
+  };
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === '--source') args.source = argv[(index += 1)] ?? '';
+    else if (value === '--bucket') args.bucket = argv[(index += 1)] ?? '';
+    else if (value === '--endpoint') args.endpoint = argv[(index += 1)] ?? '';
+    else if (value === '--prefix') args.prefix = argv[(index += 1)] ?? '';
+    else if (value === '--dry-run') args.dryRun = true;
+    else if (value === '--help' || value === '-h') {
+      usage();
+      process.exit(0);
+    } else throw new Error(`未知参数：${value}`);
+  }
+  return args;
+}
+
+function loadAccessKeys() {
+  if (
+    process.env.ALIYUN_OSS_ACCESS_KEY_ID &&
+    process.env.ALIYUN_OSS_ACCESS_KEY_SECRET
+  ) {
+    return {
+      accessKeyId: process.env.ALIYUN_OSS_ACCESS_KEY_ID.trim(),
+      accessKeySecret: process.env.ALIYUN_OSS_ACCESS_KEY_SECRET,
+    };
+  }
+  const secretsPath = resolve('.env.secrets.local');
+  if (!existsSync(secretsPath)) {
+    throw new Error(
+      '缺少 OSS 凭据：请设置 ALIYUN_OSS_ACCESS_KEY_ID / ALIYUN_OSS_ACCESS_KEY_SECRET',
+    );
+  }
+  const secrets = Object.fromEntries(
+    readFileSync(secretsPath, 'utf8')
+      .split(/\r?\n/u)
+      .map((line) => /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/u.exec(line.trim()))
+      .filter(Boolean)
+      .map((match) => [match[1], match[2].replace(/^"|"$/gu, '')]),
+  );
+  if (
+    !secrets.ALIYUN_OSS_ACCESS_KEY_ID ||
+    !secrets.ALIYUN_OSS_ACCESS_KEY_SECRET
+  ) {
+    throw new Error('仓库 .env.secrets.local 缺少 ALIYUN_OSS_* 凭据');
+  }
+  return {
+    accessKeyId: secrets.ALIYUN_OSS_ACCESS_KEY_ID,
+    accessKeySecret: secrets.ALIYUN_OSS_ACCESS_KEY_SECRET,
+  };
+}
+
+const sha256 = (buffer) => createHash('sha256').update(buffer).digest('hex');
+
+function walkFiles(directory, base = directory) {
+  const files = [];
+  for (const entry of readdirSync(directory, { withFileTypes: true }).sort(
+    (left, right) => left.name.localeCompare(right.name),
+  )) {
+    const full = join(directory, entry.name);
+    if (entry.isDirectory()) files.push(...walkFiles(full, base));
+    else {
+      const bytes = readFileSync(full);
+      files.push({
+        path: full
+          .slice(base.length + 1)
+          .split('\\')
+          .join('/'),
+        sizeBytes: bytes.length,
+        sha256: sha256(bytes),
+      });
+    }
+  }
+  return files;
+}
+
+function readMeta(templateRoot, templateId) {
+  const metaPath = join(templateRoot, 'meta.json');
+  if (!existsSync(metaPath)) throw new Error(`${templateId} 缺少 meta.json`);
+  const meta = JSON.parse(readFileSync(metaPath, 'utf8'));
+  if (!TEMPLATE_ID_PATTERN.test(meta.id ?? ''))
+    throw new Error(`${templateId} 的 meta.id 非法`);
+  if (meta.id !== templateId)
+    throw new Error(`${templateId} 目录名与 meta.id 不一致：${meta.id}`);
+  if (typeof meta.title !== 'string' || !meta.title.trim()) {
+    throw new Error(`${templateId} 缺少 title`);
+  }
+  if (!TEMPLATE_VERSION_PATTERN.test(meta.templateVersion ?? '')) {
+    throw new Error(`${templateId} 缺少合法的 templateVersion`);
+  }
+  if (!RUNTIMES.has(meta.runtime ?? '')) {
+    throw new Error(
+      `${templateId} 的 runtime 必须是 ${[...RUNTIMES].join(' / ')}`,
+    );
+  }
+  if (
+    !Array.isArray(meta.tags) ||
+    meta.tags.some((tag) => typeof tag !== 'string' || !tag.trim())
+  ) {
+    throw new Error(`${templateId} 的 tags 必须是非空字符串数组`);
+  }
+  if (
+    typeof meta.entry !== 'string' ||
+    meta.entry.includes('..') ||
+    meta.entry.startsWith('/')
+  ) {
+    throw new Error(`${templateId} 的 entry 非法`);
+  }
+  return meta;
+}
+
+function buildLibrary(source, prefix) {
+  const versionRoot = join(source, 'v1');
+  if (!existsSync(versionRoot))
+    throw new Error(`源目录缺少 v1/：${versionRoot}`);
+  const templateIds = readdirSync(versionRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort((left, right) => left.localeCompare(right));
+  if (templateIds.length === 0) throw new Error('源目录 v1/ 下没有模板');
+
+  const updatedAt = new Date().toISOString().replace(/\.\d{3}Z$/u, 'Z');
+  const templates = [];
+  const objects = [];
+
+  for (const templateId of templateIds) {
+    const templateRoot = join(versionRoot, templateId);
+    const meta = readMeta(templateRoot, templateId);
+    const zipPath = join(templateRoot, 'template.zip');
+    if (!existsSync(zipPath))
+      throw new Error(`${templateId} 缺少 template.zip`);
+    const zipBytes = readFileSync(zipPath);
+    const coverEntries = readdirSync(templateRoot).filter((name) =>
+      COVER_EXTENSIONS.has(name.slice(name.lastIndexOf('.')).toLowerCase()),
+    );
+    if (coverEntries.length !== 1) {
+      throw new Error(`${templateId} 必须且只能有一张封面图（png/jpg/webp）`);
+    }
+    const coverName = coverEntries[0];
+    const coverBytes = readFileSync(join(templateRoot, coverName));
+    const projectFiles = walkFiles(join(templateRoot, 'project'));
+    if (projectFiles.length === 0)
+      throw new Error(`${templateId} 的 project/ 为空`);
+
+    const zipKey = `${prefix}/v1/${templateId}/template.zip`;
+    const coverKey = `${prefix}/v1/${templateId}/${coverName}`;
+    const metadataKey = `${prefix}/v1/${templateId}/template.json`;
+
+    const templateMetadata = {
+      schemaVersion: TEMPLATE_SCHEMA_VERSION,
+      id: meta.id,
+      title: meta.title,
+      summary: meta.summary ?? '',
+      tags: meta.tags,
+      runtime: meta.runtime,
+      engine: meta.engine ?? '',
+      engineVersion: meta.engineVersion ?? '',
+      templateVersion: meta.templateVersion,
+      updatedAt,
+      entry: meta.entry,
+      zip: {
+        key: zipKey,
+        sizeBytes: zipBytes.length,
+        sha256: sha256(zipBytes),
+      },
+      cover: {
+        key: coverKey,
+        width: Number.isInteger(meta.coverWidth) ? meta.coverWidth : 0,
+        height: Number.isInteger(meta.coverHeight) ? meta.coverHeight : 0,
+        sha256: sha256(coverBytes),
+      },
+      files: projectFiles,
+    };
+
+    templates.push({
+      id: templateMetadata.id,
+      title: templateMetadata.title,
+      summary: templateMetadata.summary,
+      tags: templateMetadata.tags,
+      runtime: templateMetadata.runtime,
+      engine: templateMetadata.engine,
+      engineVersion: templateMetadata.engineVersion,
+      templateVersion: templateMetadata.templateVersion,
+      updatedAt,
+      entry: templateMetadata.entry,
+      zipKey,
+      zipSizeBytes: templateMetadata.zip.sizeBytes,
+      zipSha256: templateMetadata.zip.sha256,
+      coverKey,
+      coverWidth: templateMetadata.cover.width,
+      coverHeight: templateMetadata.cover.height,
+      coverSha256: templateMetadata.cover.sha256,
+      metadataKey,
+    });
+
+    objects.push(
+      { key: zipKey, body: zipBytes, contentType: 'application/zip' },
+      {
+        key: coverKey,
+        body: coverBytes,
+        contentType: coverName.endsWith('.webp')
+          ? 'image/webp'
+          : coverName.endsWith('.png')
+            ? 'image/png'
+            : 'image/jpeg',
+      },
+      {
+        key: metadataKey,
+        body: Buffer.from(
+          `${JSON.stringify(templateMetadata, null, 2)}\n`,
+          'utf8',
+        ),
+        contentType: 'application/json',
+      },
+    );
+  }
+
+  const indexJson = {
+    schemaVersion: SCHEMA_VERSION,
+    library: 'agc-game-templates',
+    libraryVersion: 1,
+    updatedAt,
+    templates,
+  };
+  objects.push({
+    key: `${prefix}/index.json`,
+    body: Buffer.from(`${JSON.stringify(indexJson, null, 2)}\n`, 'utf8'),
+    contentType: 'application/json',
+  });
+  writeFileSync(
+    join(source, 'index.json'),
+    `${JSON.stringify(indexJson, null, 2)}\n`,
+    'utf8',
+  );
+  return { objects, indexJson };
+}
+
+function createClient({ bucket, endpoint, accessKeyId, accessKeySecret }) {
+  async function call(
+    method,
+    key,
+    { body = Buffer.alloc(0), contentType = '' } = {},
+  ) {
+    const date = new Date().toUTCString();
+    const stringToSign = `${method}\n\n${contentType}\n${date}\n/${bucket}/${key}`;
+    const signature = createHmac('sha1', accessKeySecret)
+      .update(stringToSign, 'utf8')
+      .digest('base64');
+    const response = await fetch(`https://${bucket}.${endpoint}/${key}`, {
+      method,
+      headers: {
+        Date: date,
+        Authorization: `OSS ${accessKeyId}:${signature}`,
+        ...(contentType ? { 'Content-Type': contentType } : {}),
+      },
+      ...(method === 'PUT' ? { body } : {}),
+    });
+    return response;
+  }
+  return { call };
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (!args.source) {
+    usage();
+    throw new Error('必须提供 --source');
+  }
+  const source = resolve(args.source);
+  const { objects, indexJson } = buildLibrary(source, args.prefix);
+  console.log(
+    `模板库：${indexJson.templates.length} 个模板 -> oss://${args.bucket}/${args.prefix}/`,
+  );
+  for (const template of indexJson.templates) {
+    console.log(
+      `  - ${template.id}@${template.templateVersion} tags=${template.tags.join('/')} zip=${template.zipSizeBytes}B sha256=${template.zipSha256.slice(0, 12)}…`,
+    );
+  }
+  if (args.dryRun) {
+    console.log('dry-run：未上传。计划上传对象：');
+    for (const object of objects)
+      console.log(`  PUT ${object.key} (${object.body.length} B)`);
+    return;
+  }
+  const credentials = loadAccessKeys();
+  const client = createClient({ ...args, ...credentials });
+  for (const object of objects) {
+    const response = await client.call('PUT', object.key, object);
+    if (!response.ok) {
+      throw new Error(
+        `上传失败 ${object.key}：HTTP ${response.status} ${await response.text()}`,
+      );
+    }
+    console.log(
+      `PUT ${object.key} (${object.body.length} B) -> ${response.status}`,
+    );
+  }
+  const verify = await client.call('GET', `${args.prefix}/index.json`);
+  const liveIndex = JSON.parse(await verify.text());
+  for (const template of liveIndex.templates) {
+    const zipResponse = await client.call('GET', template.zipKey);
+    const zipBytes = Buffer.from(await zipResponse.arrayBuffer());
+    const digest = sha256(zipBytes);
+    if (digest !== template.zipSha256) {
+      throw new Error(`回读校验失败：${template.zipKey}`);
+    }
+    console.log(
+      `verify ${template.zipKey} size=${zipBytes.length} sha256=${digest.slice(0, 12)}… ok`,
+    );
+  }
+  console.log('模板库发布完成。');
+}
+
+main().catch((error) => {
+  console.error(`[agc-template-library-publish] ${error.message}`);
+  process.exit(1);
+});