PSD注释添加

scripts/export_psd_from_json.py

@@ -1,7 +1,50 @@
 """
-PSD导出模块：基于Vue模板配置生成PSD文件
+ * @file        export_psd_from_json.py
-支持从Vue模板解析图层信息、文本样式和位置信息
+ * @brief       PSD导出模块：基于Vue模板配置生成PSD文件
-适配海报生成流程
+ *              支持从Vue模板解析图层信息、文本样式和位置信息
+ * 
+ * @author      徐海潆 (2212180@mail.nankai.edu.cn)
+ * @date        2025.7.4
+ * @version     v2.0.0
+ *
+ * @details
+ * 本文件主要实现：
+ *  - Vue模板配置文件解析和图层信息提取
+ *  - CSS样式解析和透明度、字体、颜色等属性提取
+ *  - 图片和文本图层的创建和位置计算
+ *  - PSD文件生成和图层叠加处理
+ *  - 字体加载和文本渲染功能
+ *  - 图像缩放、对齐和透明度处理
+ * 
+ * @note
+ * - 支持多种图片格式和字体文件加载
+ * - 自动处理图层z-index排序和透明度设置
+ * - 提供图片路径自动查找功能
+ * - 生成预览图和缩略图便于查看效果
+ * - 兼容PIL和psd-tools库进行图像处理
+ * 
+ * @usage
+ * # 从Vue模板配置创建PSD文件
+ * create_psd_from_vue_config(
+ *     vue_templates_path='configs/vue_templates.yaml',
+ *     output_path='outputs/design.psd',
+ *     template_name='nku.png',
+ *     content_data={'title_content': '标题', 'subtitle_content': '副标题'}
+ * )
+ * 
+ * # 从图片列表创建简单PSD文件
+ * create_psd_from_images(
+ *     image_paths=['image1.jpg', 'image2.png'],
+ *     output_path='outputs/simple.psd'
+ * )
+ * 
+ * # 快速运行
+ * python export_psd_from_json.py
+ * # 需完善
+ * 字体加载需要接口
+ * @copyright
+ * (c) 2025 砚生项目组
+ */
 """  
   
 import yaml