🤖 Assistant

🎨 SketchCraft Pro (v1.1)

Industrial Design AI Renderer | 工业设计 AI 渲染工作台

"From a script to a System."

SketchCraft Pro 是一个集成了 AI 智能渲染辅助功能的本地设计工具。它旨在通过 AI 技术（基于 ComfyUI 和 LLM）简化工业设计与概念设计的渲染流程，让设计师从繁琐的参数调整中解放出来。

✨ 主要特性 (Features)

🎨 智能渲染 (Aether Core):

• 搭载 v1.4 "智能大脑"，支持通过自然语言描述自动调整渲染风格与参数。
• 集成 DeepSeek 大语言模型，精确理解设计意图。

🔌 无缝 ComfyUI 集成:

• 直接与本地 ComfyUI 后端通信，利用 Flux/Stable Diffusion 强大的生图能力。
• 支持线稿渲染、基础生图等多种工作流。

🛠 极简工作流:

• 自动化处理"线稿 -> 渲染图"的复杂流程。
• 提供"快速"与"深度"两种创作模式。

📂 项目结构 (Project Structure)

本项目采用双核心架构：

• aether_core/: [新增] 智能大脑核心。包含 LLM 客户端、提示词工程、参数映射逻辑及设计知识库。
• sketchcraft/: 应用主程序。包含用户界面 (UI)、后端通信模块及工作流管理。

🚀 快速开始 (Getting Started)

前置要求

1. 安装 Python 3.10+
2. 确保本地已安装并运行 ComfyUI [1][2][3][4]
3. 申请 DeepSeek API Key (用于智能模式)

ComfyUI 安装参考

根据搜索结果，ComfyUI 的安装方法包括：

Windows 安装 [1][7]:

• 下载独立压缩包：ComfyUI_windows_portable_nvidia_cu118_or_cpu.7z
• 解压后运行 run_nvidia_gpu.bat (GPU) 或 run_cpu.bat (CPU)
• 需要 7-Zip 解压缩软件

macOS 安装 [1][7]:

• 需要 M1 以上芯片，macOS 12.3+
• 使用 Homebrew 安装依赖
• 创建虚拟环境并安装 PyTorch

Linux 安装 [1]:

• 安装系统依赖包
• 创建虚拟环境
• 安装 CUDA 版本或 CPU 版本的 PyTorch

安装

1. 克隆项目到本地：

   git clone https://github.com/你的用户名/SketchCraftPro.git

2. 安装依赖：

   pip install -r requirements.txt

配置

在 sketchcraft/ 目录下创建 settings.json（可参考 settings.example.json），并填入你的配置信息：

{
    "comfy_url": "http://127.0.0.1:8188",
    "api_key": "your_deepseek_api_key"
}

运行

在项目根目录下运行：

python SketchCraftPro/sketchcraft/app.py

📝 版本历史

• v1.4: 引入 Aether Core 智能大脑，重构项目目录。
• v1.0: 基础线稿渲染功能上线。

💡 相关资源

ComfyUI 资源

• 官方文档: ComfyUI 官方文档 [4]
• 安装指南: ComfyUI 安装指南 [2]
• 整合包: 秋叶 ComfyUI 整合包 [3] 和疯狂 AI 整合包 [6]
• 模型下载: 可从 Hugging Face 下载模型 [7][8]

优势特点

根据搜索结果，ComfyUI 相比传统 WebUI 具有以下优势 [3][7]:

1. 轻量级: 内存使用量更低，生成速度更快
2. 灵活性: 极其灵活的可配置能力
3. 工作流易于分享: 可保存为 PNG 或 JSON 文件
4. 性能优化: 内存管理和按需加载机制
5. 可扩展性: 支持自定义节点和插件

🔧 故障排除

常见问题

1. 模型加载问题: 确保模型文件放置在正确的文件夹位置 [8]
2. ComfyUI 启动失败: 检查 Python 版本兼容性 (3.8-3.11) [1]
3. 显存不足: 使用 --force-fp16 或 --lowvram 参数 [1]
4. 网络问题: 使用国内镜像源安装依赖 [1]

模型共享配置

如果已安装 AUTOMATIC1111 WebUI，可以共享模型文件避免重复下载 [7]:

1. 重命名 extra_model_paths.yaml.example 为 extra_model_paths.yaml
2. 修改 base_path 指向 WebUI 安装目录
3. 重启 ComfyUI

📝 更新日志

详见 RELEASE_NOTES.md

Created by Teddy Zeng @ HNU Industrial Design Studio

---