feat: 红墨 v1.4.1 更新日志 2025-12-29

【本次更新摘要】
- 新增文案生成功能（标题、正文、标签）
- 新增一键启动脚本（macOS/Linux/Windows）
- 修复历史记录保存机制
- 更新品牌 Logo
- 代码质量优化

一、新功能
----------

1. 文案生成功能
   - 新增 /api/content 接口，自动生成小红书标题、正文和标签
   - 新增 ContentDisplay 组件，支持一键复制
   - 新增 content_prompt.txt 提示词模板

   新增文件:
   - backend/routes/content_routes.py
   - backend/services/content.py
   - backend/prompts/content_prompt.txt
   - frontend/src/components/result/ContentDisplay.vue

2. 一键启动脚本
   - 支持 macOS、Linux、Windows 三平台
   - 自动检测并安装依赖（uv、pnpm）
   - 自动启动前后端服务
   - 自动打开浏览器

   新增文件:
   - start.sh (macOS/Linux 入口)
   - start.bat (Windows 入口)
   - scripts/start-macos.command
   - scripts/start-linux.sh
   - scripts/start-windows.bat

3. 品牌 Logo 更新
   - 全新设计的红墨 Logo（红色圆形 R + Redink）
   - 带 Slogan 横幅版本

   新增文件:
   - images/1.png (Logo 标准版)
   - images/2.png (Logo + Slogan 横幅)
   - images/3.png (Logo 大图版)
   - frontend/public/logo-banner.png

二、Bug 修复
------------

1. 历史记录保存机制修复
   - 大纲生成后立即创建历史记录（HomeView.vue）
   - 编辑大纲时自动保存，300ms 防抖（OutlineView.vue）
   - 跳转前强制保存未保存的修改（OutlineView.vue）
   - 统一使用 setRecordId() 方法赋值（4个 Vue 文件）

2. 端口配置统一
   - 启动脚本端口显示从 5001 修正为 12398
   - 修复文件: scripts/*.sh, scripts/*.bat

3. CSS 变量修复
   - 修复 --text-secondary 未定义问题，改为 --text-sub
   - 修复文件: frontend/src/components/result/ContentDisplay.vue

4. API 性能优化
   - checkHistoryExists 改用专用 /exists 端点
   - 修复文件: frontend/src/api/index.ts

三、代码优化
------------

1. 清理未使用的代码
   - 删除 3 个生成器文件中未使用的 retry_on_error 装饰器
   - 清理相关的 import（time, random, wraps）
   - 修复文件:
     - backend/generators/google_genai.py
     - backend/generators/image_api.py
     - backend/generators/openai_compatible.py

2. 前端状态管理增强
   - 新增 outlineStatus、lastSavedAt 字段
   - 新增 setRecordId()、markSaved()、hasUnsavedChanges() 方法
   - 修复文件: frontend/src/stores/generator.ts

3. 后端历史服务增强
   - 新增 RecordStatus 状态常量
   - 新增 record_exists() 方法
   - 新增 /api/history/<id>/exists 端点
   - 修复文件:
     - backend/services/history.py
     - backend/routes/history_routes.py

四、UI 更新
-----------

1. 侧边栏 Logo
   - 更换为带 Slogan 的横幅 Logo
   - 作者头像改为红色渐变圆形 + "墨"字
   - 修复文件:
     - frontend/src/App.vue
     - frontend/src/assets/css/base.css

2. README 更新
   - 使用新 Logo 横幅
   - 新增一键启动脚本说明
   - 新增 v1.4.1 更新日志

================================================================================
                            文件变更统计
================================================================================

修改文件 (19个):
- README.md
- backend/generators/google_genai.py
- backend/generators/image_api.py
- backend/generators/openai_compatible.py
- backend/routes/__init__.py
- backend/routes/history_routes.py
- backend/services/history.py
- backend/services/image.py
- frontend/public/logo.png
- frontend/src/App.vue
- frontend/src/api/index.ts
- frontend/src/assets/css/base.css
- frontend/src/stores/generator.ts
- frontend/src/views/GenerateView.vue
- frontend/src/views/HistoryView.vue
- frontend/src/views/HomeView.vue
- frontend/src/views/OutlineView.vue
- frontend/src/views/ResultView.vue
- images/logo.png

新增文件 (11个):
- backend/prompts/content_prompt.txt
- backend/routes/content_routes.py
- backend/services/content.py
- frontend/public/logo-banner.png
- frontend/src/components/result/ContentDisplay.vue
- images/1.png
- images/2.png
- images/3.png
- scripts/start-macos.command
- scripts/start-linux.sh
- scripts/start-windows.bat
- start.bat
- start.sh

代码变更: +1417 行, -447 行

================================================================================
                            建议的 Commit Message
================================================================================

feat: v1.4.1 新增文案生成、一键启动脚本、Logo更新

- 新增文案生成功能（标题、正文、标签自动生成）
- 新增一键启动脚本，支持 macOS/Linux/Windows
- 更新品牌 Logo，新增带 Slogan 横幅版本
- 修复历史记录保存机制，大纲生成后立即保存
- 修复端口配置统一为 12398
- 清理后端生成器未使用的重试装饰器代码
- 优化 checkHistoryExists 接口性能

Author: HisMax

.gitignore

@@ -78,3 +78,4 @@ debug_*.py
 # Dev notes
 DEV_NOTES.md
 commit_message.txt
+git-changelog.txt

README.md

@@ -1,37 +1,21 @@
-## 红墨官方站点上线啦，注册即送100体验积分（每日签到也会随机有40-100积分哦）
-
 <div align="center">
 
-### ✨ 仅开放注册 1000 名 ✨
+<img src="images/2.png" alt="红墨 - 灵感一触即发 让创作从未如此简单" width="600"/>
 
-**无需部署，立即体验红墨的强大功能！**
+## 红墨官方站点上线啦，注册即送50体验积分！
 
----
+> ✨ 邀请好友来一起玩吧，你和好友都会有50积分！ ✨
 
+<div align="center">
 <a href="https://redink.top">
   <img src="images/redink.png" alt="红墨在线体验" width="500" style="border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.1);"/>
 </a>
 
-### [点击访问在线体验站 → Redink.top](https://redink.top)
+#### [点击访问在线体验站 → Redink.top](https://redink.top)
 
-<sub>💡 点击图片或链接即可访问 | 🎯 限量开放，先到先得</sub>
 
 </div>
 
----
-
-<div align="center">
-
-# 🎨 红墨 - 小红书AI图文生成器
-
-### 让传播不再需要门槛，让创作从未如此简单
-
-![](images/index.gif)
-
-<sub>*红墨首页 - 一句话开启创作之旅*</sub>
-
----
-
 <img src="images/showcase-grid.png" alt="使用红墨生成的各类小红书封面" width="700" style="border-radius: 12px; box-shadow: 0 8px 24px rgba(0,0,0,0.12);"/>
 
 <sub>*使用红墨生成的各类小红书封面 - AI驱动，风格统一，文字准确*</sub>
@@ -40,58 +24,12 @@
 
 ---
 
-## 💭 写在前面
-
-前段时间默子在 Linux.do 发了一个用 Nano banana Pro 做 PPT 的帖子，收获了 **600+ 点赞**。很多人用 🍌 Nano banana Pro 去做产品宣传图、直接生成漫画等等。我就在想：
-
-> **为什么不拿 🍌2 来做点更功利、更刺激的事情？**
-
-于是就有了这个项目：**一句话 + 一张图片 = 完整小红书图文**
-
----
-
 ## ✨ 效果展示
 
-### 📝 输入一句话，生成完整图文
-
-<table>
-<tr>
-<td width="50%">
-
-#### 🎯 输入示例
-
-**提示词**：秋季显白美甲（暗广一个：默子牌美甲）
-
-**参考图片**：上传小红书主页截图
-- ✅ 包含头像、签名、背景、姓名
-- ✅ 自动学习个人风格
-
-</td>
-<td width="50%">
-
-#### ⚡ 生成流程
-
-1. **智能大纲** (10-20秒)
-  - 自动拆分 6-9 页内容
-  - 可自定义每页描述
-
-2. **封面生成** (即时)
-  - 风格统一的封面设计
-
-3. **批量生成** (并发)
-  - 最多 15 张图同时生成
-  - 支持单独重新生成
-
-</td>
-</tr>
-</table>
-
----
-
-### 🖼️ 生成步骤展示
+### 输入一句话，生成完整图文
 
 <details open>
-<summary><b>📋 Step 1: 智能大纲生成</b></summary>
+<summary><b>Step 1: 智能大纲生成</b></summary>
 
 <br>
 
@@ -233,6 +171,18 @@ pnpm install
 
 ### 5. 启动服务
 
+#### 一键启动（推荐）
+
+双击运行启动脚本，自动安装依赖并启动前后端：
+
+- **macOS**: `start.sh` 或双击 `scripts/start-macos.command`
+- **Linux**: `./start.sh`
+- **Windows**: 双击 `start.bat`
+
+启动后自动打开浏览器访问 http://localhost:5173
+
+#### 手动启动
+
 **启动后端:**
 ```bash
 uv run python -m backend.app
@@ -248,22 +198,6 @@ pnpm dev
 
 ---
 
-## 🎮 使用指南
-
-### 基础使用
-1. **输入主题**: 在首页输入想要创作的主题,如"如何在家做拿铁"
-2. **生成大纲**: AI 自动生成 6-9 页的内容大纲
-3. **编辑确认**: 可以编辑和调整每一页的描述
-4. **生成图片**: 点击生成,实时查看进度
-5. **下载使用**: 一键下载所有图片
-
-### 进阶使用
-- **上传参考图片**: 适合品牌方,保持品牌视觉风格
-- **修改描述词**: 精确控制每一页的内容和构图
-- **重新生成**: 对不满意的页面单独重新生成
-
----
-
 ## 🔧 配置说明
 
 ### 配置方式
@@ -347,15 +281,22 @@ providers:
 
 如果这个项目对你有帮助,欢迎给个 Star ⭐
 
-### 未来计划
-- [ ] 支持更多图片格式，例如一句话生成一套PPT什么的
-- [x] 历史记录管理优化
-- [ ] 导出为各种格式(PDF、长图等)
 
 ---
 
 ## 更新日志
 
+### v1.4.1 (2025-12-29)
+- ✨ 新增一键启动脚本，支持 macOS/Linux/Windows
+- ✨ 新增文案生成功能，自动生成标题、正文和标签
+- 🔧 修复历史记录保存机制：大纲生成后立即保存，编辑时自动保存（300ms防抖）
+- 🔧 优化跳转逻辑：点击"开始生成"前强制保存未保存的修改
+- 🔧 统一启动脚本端口显示为 12398
+- 🔧 清理后端生成器未使用的重试装饰器代码
+- 🔧 修复前端 CSS 变量引用问题
+- 🔧 优化 checkHistoryExists 接口性能，使用专用端点
+- 🔧 规范 recordId 赋值方式，统一使用 setRecordId() 方法
+
 ### v1.4.0 (2025-11-30)
 - 🏗️ 后端架构重构：拆分单体路由为模块化蓝图（history、images、generation、outline、config）
 - 🏗️ 前端组件重构：提取可复用组件（ImageGalleryModal、OutlineModal、ShowcaseBackground等）
@@ -463,19 +404,19 @@ providers:
 
 ## 👨‍💻 作者
 
-**默子 (Histone)** - AI 创业者 | Python & 深度学习
+**默子 (Histone)** - AI 创业者 
 
 - 🏠 位置: 中国杭州
 - 🚀 状态: 创业中
-- 💡 专注: Transformers、GANs、多模态AI
 - 📧 Email: histonemax@gmail.com
-- 💬 微信: Histone2024
+- 💬 微信: Histone2024 （私人微信不解答任何技术问题）
 - 🐙 GitHub: [@HisMax](https://github.com/HisMax)
+- 
 
 *"让 AI 帮我们做更有创造力的事"*
 
 ---
 
 **如果这个项目帮到了你,欢迎分享给更多人!** ⭐
 
-有任何问题或建议,欢迎提 Issue 或者在 Linux.do 原帖讨论!
+有任何问题或建议,欢迎提 Issue !

backend/generators/google_genai.py

@@ -1,9 +1,6 @@
 """Google GenAI 图片生成器"""
 import logging
-import time
-import random
 import base64
-from functools import wraps
 from typing import Dict, Any, Optional
 from google import genai
 from google.genai import types
@@ -279,58 +276,6 @@ def parse_genai_error(error: Exception) -> str:
     )
 
 
-def retry_on_error(max_retries=5, base_delay=3):
-    """智能重试装饰器，根据错误类型决定是否重试"""
-    def decorator(func):
-        @wraps(func)
-        def wrapper(*args, **kwargs):
-            last_error = None
-            for attempt in range(max_retries):
-                try:
-                    return func(*args, **kwargs)
-                except Exception as e:
-                    last_error = e
-                    error_str = str(e).lower()
-
-                    # 不可重试的错误类型
-                    non_retryable = [
-                        "401", "unauthenticated",  # 认证错误
-                        "403", "permission_denied", "forbidden",  # 权限错误
-                        "404", "not_found",  # 资源不存在
-                        "invalid_argument",  # 参数错误
-                        "safety", "blocked", "filter",  # 安全过滤
-                    ]
-
-                    should_retry = True
-                    for keyword in non_retryable:
-                        if keyword in error_str:
-                            should_retry = False
-                            break
-
-                    if not should_retry:
-                        # 直接抛出，不重试
-                        raise Exception(parse_genai_error(e))
-
-                    # 可重试的错误
-                    if attempt < max_retries - 1:
-                        if "429" in error_str or "resource_exhausted" in error_str:
-                            wait_time = (base_delay ** attempt) + random.uniform(0, 1)
-                            logger.warning(f"⏳ 遇到速率限制，{wait_time:.1f}秒后重试 (尝试 {attempt + 2}/{max_retries})")
-                        else:
-                            wait_time = min(2 ** attempt, 10) + random.uniform(0, 1)
-                            logger.warning(f"⚠️ 请求失败，{wait_time:.1f}秒后重试 (尝试 {attempt + 2}/{max_retries})")
-                        time.sleep(wait_time)
-                        continue
-
-                    # 重试次数耗尽
-                    raise Exception(parse_genai_error(e))
-
-            # 理论上不会到这里，但保险起见
-            raise Exception(parse_genai_error(last_error))
-        return wrapper
-    return decorator
-
-
 class GoogleGenAIGenerator(ImageGeneratorBase):
     """Google GenAI 图片生成器"""
 
@@ -381,7 +326,6 @@ def validate_config(self) -> bool:
         """验证配置"""
         return bool(self.api_key)
 
-    @retry_on_error(max_retries=5, base_delay=3)
     def generate_image(
         self,
         prompt: str,

backend/generators/image_api.py

@@ -1,7 +1,5 @@
 """Image API 图片生成器"""
 import logging
-import time
-import random
 import base64
 import requests
 from typing import Dict, Any, Optional, List, Union
@@ -11,25 +9,6 @@
 logger = logging.getLogger(__name__)
 
 
-def retry_on_error(max_retries: int = 3, base_delay: float = 2):
-    """错误重试装饰器"""
-    def decorator(func):
-        def wrapper(*args, **kwargs):
-            last_error = None
-            for attempt in range(max_retries):
-                try:
-                    return func(*args, **kwargs)
-                except Exception as e:
-                    last_error = e
-                    if attempt < max_retries - 1:
-                        delay = base_delay * (2 ** attempt) + random.uniform(0, 1)
-                        logger.warning(f"请求失败，{delay:.1f}秒后重试 (尝试 {attempt + 2}/{max_retries}): {str(e)[:100]}")
-                        time.sleep(delay)
-            raise last_error
-        return wrapper
-    return decorator
-
-
 class ImageApiGenerator(ImageGeneratorBase):
     """Image API 生成器"""
 
@@ -73,7 +52,6 @@ def get_supported_aspect_ratios(self) -> List[str]:
         """获取支持的宽高比"""
         return ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"]
 
-    @retry_on_error(max_retries=3, base_delay=2)
     def generate_image(
         self,
         prompt: str,