面向 UI 研发/策划协作的 PSD → Cocos 工作流编辑器：
支持导入 PSD 图层结构、为工作流节点挂载图层引用、导出 AI 素材包（图层 PNG + 位置信息 + 翻转信息）并生成提示词（Prompt）。
功能概览
- PSD 图层导入：读取 PSD/PSB 的图层树（不依赖 Canvas）。
- 缩略图：后台空闲队列逐步生成并展示图层缩略图。
- 工作流编辑：新增/删除节点，节点多选/框选，批量拖拽移动，Delete 快捷删除。
- 连线编辑：拖拽端口创建连线，连线可选中、编辑描述、删除。
- 导出 AI 素材包 + 提示词：
- 导出 PSD 内部图层图片（跳过纯透明）
- 导出 bbox（位置/尺寸）与 flipX/flipY
- 生成 Prompt（会保存为 Markdown 文件并复制到剪贴板）
快速开始
- 打开一个工作区文件夹（必须是 workspace root）。
- 打开侧边栏：Activity Bar → PSD Workflow → Workflow。
- 点击 打开编辑器。
- 点击 导入 PSD，选择
.psd/.psb 文件。
- 在画布中新增节点，并在左侧图层树选择图层 → 添加所选图层 绑定到节点 refs。
画布交互
- 平移视野：中键拖动，或按住空格 + 左键拖动。
- 回到中心：右下角“回到中心”。
- Overview 缩略图：右上角显示整体分布与当前视口，点击可快速跳转。
- 多选节点：
- 空白处左键拖动框选
- Ctrl/Cmd 点击节点进行多选/反选
- 删除：Delete / Backspace 删除选中节点或选中连线。
- 拖拽连线：从节点的圆点端口拖到另一节点端口。
导出与配置
导出目录（推荐）
在左侧 PSD Workflow: Workflow 面板中配置：
导出相对目录：相对工作区根目录的导出路径，例如 asset/ 或默认的 .workflow/psd-export
导出 AI 素材包 + 提示词
点击侧边栏按钮 导出AI素材包+提示词：
- 输出目录：
<导出相对目录>/<psd文件名>/
images/*.png：图层导出的 PNGexport.json：图层 bbox/flip 等元数据
- 同时会在导出目录根下写入：
ai_prompt_YYYYMMDD_HHMMSS.md（并复制到剪贴板）
依赖说明（Python）
扩展 不会自动安装 Python 依赖。以下功能需要本机可用的 Python：
- 图层缩略图生成
- 导出 AI 素材包（图层 PNG / export.json）
安装依赖：
pip install psd-tools Pillow
常见问题
侧边栏一直加载/空白
通常是扩展激活失败。请打开：
查看 → 输出 → Log (Extension Host) 查看报错
如果看到类似 Cannot find module 'ag-psd'，说明 VSIX 未包含依赖，请使用包含依赖的 VSIX 版本重新安装。
导出/缩略图失败
请确认：
- 系统
python 可执行
- 已安装
psd-tools 与 Pillow
并查看：
查看 → 输出 → PSD Workflow 的 [thumb] / [export] 日志。
命令列表
PSD Workflow: Open EditorPSD Workflow: Import PSDPSD Workflow: Create CheckpointPSD Workflow: Diff CheckpointsPSD Workflow: Export AI Bundle & Prompt
| |
