Fecify Skill 工作流索引
本文档列出 Fecify Skill 中所有工作流（workflow-*.md），按模块分组。 工作流是多个 API 或脚本协同完成的复杂操作流程，区别于单个 API 的直接调用。
目录
- 商品 (Products)
- 商品专辑 (Collections)
- 多语言翻译 (Language)
- 菜单管理 (Menu)
- 订单管理 (Order)
- 系统物流 (Shipping)
- 模版装修 (Theme)
- 汇总统计
1. 商品 (Products)
workflow-batch-upload — 商品创建（本地文件夹上传）
| 项目 | 内容 |
|---|---|
| 文件 | docs/products/workflow-batch-upload.md |
| 别名 | 批量上传商品、文件夹导商品、上传单个商品 |
| 功能 | 从本地文件夹上传图片并创建商品。AI agent 扫描指定文件夹中的图片，按子文件夹分组为不同商品，上传图片后调用创建API生成商品。支持"单个商品上传"和"批量上传"两种模式。 |
| 适用场景 | 本地有商品图片需要一次创建多个商品；或手动上传单个商品的图片并创建 |
| 涉及能力 | 图片上传 API / 商品创建 API / AI 图片识别（自动生成标题和描述） |
文档路径: docs/products/workflow-batch-upload.md
2. 商品专辑 (Collections)
workflow-collection-batch — 商品专辑批量创建/更新/添加商品
| 项目 | 内容 |
|---|---|
| 文件 | docs/collections/workflow-collection-batch.md |
| 功能 | 一次性处理多个专辑任务。支持三种 action：create（新建专辑+搜索添加商品）、update（更新已有专辑信息）、add_only（向已有专辑添加商品）。采用严格的两阶段提交：Phase 1 检查 → 用户确认 → Phase 2 执行 → 刷新缓存。 |
| 6条铁律 | ① 两阶段提交 ② 语言一致性（用户指定语言则全部翻译为该语言） ③ 缺失字段自动补全 ④ 单次确认 ⑤ 单次缓存刷新 ⑥ 搜索分页+去重 |
| 适用场景 | 批量创建多个商品专辑并添加对应商品；或为已有专辑批量补充商品 |
| 涉及API | collection/list / create / update / info / get-collect-product-list / update-collect-product / product/list（搜索）+ refresh-cache |
| 核心脚本 | scripts/collection/batch-collection.js、scripts/collection/create.js |
文档路径: docs/collections/workflow-collection-batch.md
3. 多语言翻译 (Language)
所有翻译工作流遵循统一的 4 阶段模式：collect（收集数据） → translate（翻译） → 用户确认 → apply（应用保存）。
workflow-product-translate — 商品批量翻译
| 项目 | 内容 |
|---|---|
| 文件 | docs/language/workflow-product-translate.md |
| 功能 | 对店铺商品进行批量多语言翻译。商品翻译涉及 title、sub_title、body_html、meta_title、meta_keywords、meta_description 6个字段，以及规格名称（options）和规格值（variant items）的翻译。是最复杂的翻译工作流。 |
| 适用场景 | 将商品从中文翻译到英文/法语/阿拉伯语等目标语言 |
| 涉及API | product/list → product/info → language/get-product-translate → language/save-product-translate / save-option-translate / save-option-item-translate → refresh-cache |
| 核心脚本 | scripts/language/auto-translate.js、scripts/language/translate-product.js |
文档路径: docs/language/workflow-product-translate.md
workflow-product-collection-translate — 商品专辑批量翻译
| 项目 | 内容 |
|---|---|
| 文件 | docs/language/workflow-product-collection-translate.md |
| 功能 | 对商品专辑进行批量多语言翻译。翻译字段：title、sub_title、body_html、meta_title、meta_keywords、meta_description（6个字段），无规格/变体结构。 |
| 适用场景 | 商品专辑页面需要多语言展示 |
| 涉及API | collection/list → collection/info → language/get-collection-translate → language/save-collection-translate → refresh-cache |
| 核心脚本 | scripts/language/translate-collection.js |
文档路径: docs/language/workflow-product-collection-translate.md
workflow-page-translate — 自定义页面批量翻译
| 项目 | 内容 |
|---|---|
| 文件 | docs/language/workflow-page-translate.md |
| 功能 | 对自定义页面进行批量多语言翻译。翻译字段：title、body_html、meta_title、meta_keywords、meta_description（5个字段）。 |
| 适用场景 | About Us、Contact Us 等自定义页面需要多语言 |
| 涉及API | page/list → page/info → language/get-page-translate → language/save-page-translate → refresh-cache |
| 核心脚本 | scripts/language/translate-page.js |
文档路径: docs/language/workflow-page-translate.md
workflow-blog-article-translate — 博客文章批量翻译
| 项目 | 内容 |
|---|---|
| 文件 | docs/language/workflow-blog-article-translate.md |
| 功能 | 对博客文章进行批量多语言翻译。翻译字段：title、summary_html、body_html、meta_title、meta_keywords、meta_description（6个字段）。 |
| 适用场景 | 博客文章需要多语言展示 |
| 涉及API | blog-article/list → blog-article/info → language/get-blog-article-translate → language/save-blog-article-translate → refresh-cache |
| 核心脚本 | scripts/language/translate-blog-article.js |
文档路径: docs/language/workflow-blog-article-translate.md
workflow-blog-collection-translate — 博客专辑批量翻译
| 项目 | 内容 |
|---|---|
| 文件 | docs/language/workflow-blog-collection-translate.md |
| 功能 | 对博客专辑进行批量多语言翻译。翻译字段：title、body_html、meta_title、meta_keywords、meta_description（5个字段），无 sub_title。 |
| 适用场景 | 博客专辑页面需要多语言展示 |
| 涉及API | blog-collection/list → blog-collection/info → language/get-blog-collection-translate → language/save-blog-collection-translate → refresh-cache |
| 核心脚本 | scripts/language/translate-blog-collection.js |
文档路径: docs/language/workflow-blog-collection-translate.md
4. 菜单管理 (Menu)
workflow-build — 构建菜单树
| 项目 | 内容 |
|---|---|
| 文件 | docs/menu/workflow-build.md |
| 功能 | 从缩进文本构建完整菜单树。用户提供缩进格式的菜单结构文本，AI agent 解析层级关系，创建完整的菜单树（含所有节点、URL、类型）。支持三种模式：新建（从零创建菜单树）、重建（删除旧树再建）、追加（在现有菜单树末尾追加新节点）。 |
| 适用场景 | 快速搭建网站导航菜单；从规划文本一键创建菜单 |
| 涉及API | menu/list → menu/info（重建/追加模式） → menu/create / menu/update / menu/delete → refresh-cache |
文档路径: docs/menu/workflow-build.md
workflow-patch — 菜单修补
| 项目 | 内容 |
|---|---|
| 文件 | docs/menu/workflow-patch.md |
| 功能 | 对已有菜单树做局部修改：改链接URL、改名称、提级/降级（调整父子关系）、增删子项。支持引用其他实体（商品/专辑/页面）的URL自动填充。 |
| 适用场景 | 调整已有菜单的链接或结构，无需重建整个菜单树 |
| 涉及API | menu/info → product/info / collection/info / page/info（引用URL时） → menu/update |
文档路径: docs/menu/workflow-patch.md
5. 订单管理 (Order)
workflow-ship — 订单发货工作流
| 项目 | 内容 |
|---|---|
| 文件 | docs/order/workflow-ship.md |
| 功能 | 端到端指南：从获取订单信息到完成发货的完整步骤。流程包括：获取订单详情 → 查看可发货商品清单 → 获取库存和物流方式 → 创建发货包裹 → 确认发货。支持拆包裹发货（部分发货）。 |
| 适用场景 | 处理已支付订单的发货操作 |
| 涉及API | order/info → order/fulfill-product-list → order/fulfill（创建发货） → order/receive（确认收货） |
| 核心脚本 | scripts/order/ |
文档路径: docs/order/workflow-ship.md
6. 系统物流 (Shipping)
workflow-setup — 物流配送方案工作流
| 项目 | 内容 |
|---|---|
| 文件 | docs/shipping/workflow-setup.md |
| 别名 | 设置运费、设置快递、设置配送 |
| 功能 | 完整的物流方案搭建流程：创建物流方案 → 设置配送区域（Zone） → 配置运费规则。支持按国家/省份划分配送区域，每个区域可设置不同的运费（按重量/阶梯/免运费条件）。 |
| 适用场景 | 首次配置物流配送系统；新增新的物流方式 |
| 涉及API | shipping/create / list / info / update / change-status / delete / zone-create / zone-update / zone-delete / zone-countries（冲突检查） |
| 核心脚本 | scripts/shipping/ |
文档路径: docs/shipping/workflow-setup.md
7. 模版装修 (Theme)
workflow-img — 模版装修图片处理工作流
| 项目 | 内容 |
|---|---|
| 文件 | docs/theme/workflow-img.md |
| 功能 | 模版装修中图片的生成、上传、填充的完整流程和所有规则。涵盖：扫描装修文件中已有和缺失的图片 → AI生成缺失图片 → 上传图片到服务器 → 替换JSON中的图片引用路径。 |
| 适用场景 | 为新模版生成所有装修素材图片；为主题切换时批量填充图片 |
| 涉及API | theme/file-content-get / save-file-content / image/upload |
| 核心脚本 | scripts/theme/（block-image-fields、block-settings-schema、decorate-images 等）、scripts/image-gen/（AI 图片生成） |
文档路径: docs/theme/workflow-img.md
8. 汇总统计
| 模块 | 工作流数 | 工作流列表 |
|---|---|---|
| 商品 (Products) | 1 | 批量上传 |
| 商品专辑 (Collections) | 1 | 专辑批量创建/更新/添加商品 |
| 多语言翻译 (Language) | 5 | 商品翻译、商品专辑翻译、自定义页面翻译、博客文章翻译、博客专辑翻译 |
| 菜单管理 (Menu) | 2 | 构建菜单树、菜单修补 |
| 订单管理 (Order) | 1 | 订单发货 |
| 系统物流 (Shipping) | 1 | 物流配送方案 |
| 模版装修 (Theme) | 1 | 图片处理 |
| 总计 | 12 |
工作流完整路径清单
| # | 工作流 | 文件路径 |
|---|---|---|
| 1 | 商品批量上传 | docs/products/workflow-batch-upload.md |
| 2 | 专辑批量创建/更新/添加商品 | docs/collections/workflow-collection-batch.md |
| 3 | 商品批量翻译 | docs/language/workflow-product-translate.md |
| 4 | 商品专辑批量翻译 | docs/language/workflow-product-collection-translate.md |
| 5 | 自定义页面批量翻译 | docs/language/workflow-page-translate.md |
| 6 | 博客文章批量翻译 | docs/language/workflow-blog-article-translate.md |
| 7 | 博客专辑批量翻译 | docs/language/workflow-blog-collection-translate.md |
| 8 | 构建菜单树 | docs/menu/workflow-build.md |
| 9 | 菜单修补 | docs/menu/workflow-patch.md |
| 10 | 订单发货 | docs/order/workflow-ship.md |
| 11 | 物流配送方案 | docs/shipping/workflow-setup.md |
| 12 | 模版装修图片处理 | docs/theme/workflow-img.md |