fecify skill文件结构
fecify skill文件结构
fecify skill的文件结构，采用三层递进式的文件结构
- skill.md 总入口文件
- docs/xxxx.md 某块功能，譬如商品部分：docs/products.md，然后商品的创建为：docs/products/product-create.md.md
- script/xxx.js 功能js部分
fecify_skills/ (4.4 KB SKILL.md + 313 KB 文档 + 100 KB 脚本)
│
├── SKILL.md (7.6K) # 规则入口 — 会话隔离/模块一览/操作安全/CSV导入/AI图片/目录结构/文档索引
│
├── docs/ # 📚 文档 (总计 ~150KB)
│ │
│ ├── architecture.md (2.9K) # 架构设计 — schema驱动/API代理/存储设计
│ ├── extending.md (8.7K) # 扩展指南 — 新增模块/CSV格式/脚本编写
│ ├── image-gen.md (5.7K) # AI 图片生成 — Seedream配置/提示词/裁切输出
│ ├── coupons.md (40B) # 优惠券（占位，待扩展）
│ ├── orders.md (37B) # 订单（占位，待扩展）
│ │
│ ├── products.md (8.4K) # 商品管理主文档 — API一览/注意事项/多规格/多语言/工作流
│ ├── products/ # 商品 API 子文档 (11 个, 共 ~78KB)
│ │ ├── product-create.md (15.2K) # 创建 — 参数详解/单规格/多规格/图片/变体/tag/批发价/VIP/属性/眼镜
│ │ ├── product-create-language.md (6.9K) # 创建-多语言
│ │ ├── product-update.md (10.1K) # 更新(全量)
│ │ ├── product-update-columns.md (2.1K) # 更新指定字段
│ │ ├── product-update-columns-language.md (3.3K) # 更新字段-多语言
│ │ ├── product-update-language.md (6.1K) # 更新-多语言
│ │ ├── product-update-status.md (0.9K) # 批量上下架
│ │ ├── product-update-stock.md (1.7K) # 更新库存(覆盖)
│ │ ├── product-delete.md (1.7K) # 删除
│ │ ├── product-info.md (9.1K) # 详情
│ │ └── product-list.md (9.6K) # 列表
│ │
│ ├── collection.md (2.1K) # 商品专辑主文档
│ ├── collections/ # 专辑 API 子文档 (10 个, 共 ~15KB)
│ │ ├── collection-create.md (6.2K) # 创建 — 含SEO/tag/图片/产品绑定
│ │ ├── collection-update.md (1.8K) # 更新
│ │ ├── collection-update-products.md (1.2K) # 更新绑定产品
│ │ ├── collection-delete.md (1.7K) # 删除
│ │ ├── collection-info.md (0.6K) # 详情
│ │ ├── collection-list.md (0.8K) # 列表
│ │ ├── collection-get-product-list.md (0.6K) # 获取绑定产品
│ │ ├── collection-set-top.md (0.5K) # 置顶
│ │ ├── collection-unset-top.md (0.5K) # 取消置顶
│ │ └── collection-unbind-product.md (0.6K) # 解绑产品
│ │
│ ├── base-image.md (2.8K) # 图片管理主文档 — 列表/上传/工作流/约束
│ ├── base-images/ # 图片 API 子文档 (2 个, 共 ~6KB)
│ │ ├── image-list.md (3.0K) # 列表 — group_type枚举/分页/时间过滤
│ │ └── image-upload.md (3.0K) # 上传 — base64/响应字段/image_base_url
│ │
│ ├── blog-article.md (2.3K) # 博客文章主文档 — 长度限制/API速查/传参方式
│ ├── blog-article/ # 文章 API 子文档 (8 个, 共 ~9KB)
│ │ ├── blog-article-create.md (2.0K) # 创建 — 参数/封面图/关联商品
│ │ ├── blog-article-update.md (1.6K) # 更新(全量) — 约定禁止delete+create
│ │ ├── blog-article-update-publish-status.md (.8K) # 批量发布
│ │ ├── blog-article-delete.md (0.8K) # 删除
│ │ ├── blog-article-info.md (0.6K) # 详情
│ │ ├── blog-article-list.md (0.7K) # 列表
│ │ ├── blog-article-get-settings.md (0.6K) # 获取显示配置
│ │ └── blog-article-set-settings.md (0.8K) # 保存显示配置
│ │
│ ├── blog-collection.md (2.1K) # 博客专辑主文档
│ ├── blog-collection/ # 博客专辑 API 子文档 (10 个, 共 ~8KB)
│ │ ├── blog-collection-create.md (1.1K) # 创建
│ │ ├── blog-collection-update.md (0.7K) # 更新
│ │ ├── blog-collection-update-articles.md (1.0K) # 更新绑定文章
│ │ ├── blog-collection-delete.md (0.9K) # 删除
│ │ ├── blog-collection-info.md (0.5K) # 详情
│ │ ├── blog-collection-list.md (0.8K) # 列表
│ │ ├── blog-collection-get-article-list.md (.6K) # 获取绑定文章
│ │ ├── blog-collection-set-article-top.md (.6K) # 置顶文章
│ │ ├── blog-collection-unset-article-top.md (.5K) # 取消置顶
│ │ └── blog-collection-unbind-article.md (0.6K) # 解绑文章
│ │
│ ├── page.md (1.4K) # 自定义页面主文档 — 长度限制/API速查/模板布局
│ ├── page/ # 页面 API 子文档 (5 个, 共 ~6KB)
│ │ ├── page-create.md (1.6K) # 创建 — title/body_html/SEO/template
│ │ ├── page-update.md (1.6K) # 更新(全量)
│ │ ├── page-delete.md (1.3K) # 删除
│ │ ├── page-info.md (0.5K) # 详情
│ │ └── page-list.md (0.7K) # 列表
│ │
│ ├── shop.md (5.4K) # 店铺配置主文档 — 使用场景/语言/货币/模板详解
│ ├── shop/ # 店铺 API 子文档 (3 个, 共 ~5.5KB)
│ │ ├── shop-languages.md (2.3K) # 多语言列表 — code/full_code/currency_code
│ │ ├── shop-currencies.md (1.9K) # 多货币列表 — code/symbol/符号位置
│ │ └── shop-template-layouts.md (1.3K) # 模板布局 — 5种page_type可选值
│ │
│ ├── product-csv-import.md (2.6K) # CSV导入主文档 — 三段式交互模板/选项
│ ├── product-csv-import/ # CSV导入子文档 (2 个, 共 ~13KB)
│ │ ├── shopify-csv-product-import.md (8.7K) # Shopify格式 — 列映射/检测/导入/并发配置
│ │ └── fecify-csv-product-import.md (4.4K) # Fecify内部格式 — 2行表头/Handle分组/三段式
│ │
│ └── schemas/ # API Schema JSON (9 个, 共 ~29KB)
│ ├── products.json (11.6K) # 商品 — create/update/list/info/delete/status/stock/language
│ ├── collections.json (4.3K) # 专辑 — 10个API参数定义
│ ├── base-image.json (1.8K) # 图片 — list/upload
│ ├── blog-article.json (3.7K) # 博客文章 — 8个API + 长度限制
│ ├── blog-collection.json (3.6K) # 博客专辑 — 10个API
│ ├── page.json (2.2K) # 自定义页面 — 5个API + 长度限制
│ ├── shop.json (1.2K) # 店铺 — languages/currencies/template-types
│ ├── coupons.json (189B) # 优惠券（占位）
│ └── orders.json (184B) # 订单（占位）
│
├── scripts/ # 🔧 脚本实现 (总计 ~100KB)
│ │
│ ├── proxy/ # 通用工具
│ │ ├── api-call.js (1.7K) # 通用 API 代理 — GET/POST/PUT/DELETE
│ │ └── api-doc.js (6.6K) # API 参数查询 — 按模块/API/关键词搜索
│ │
│ ├── base/ # 配置/鉴权/HTTP客户端
│ │ ├── api-client.js (4.5K) # HTTP请求封装 — 自动拼路径/鉴权/插件校验/错误解析
│ │ ├── site-config.js (4.1K) # 站点配置读写 — 会话隔离/domain/token持久化
│ │ ├── check-config.js (1.0K) # 检查当前会话配置状态
│ │ └── save-config.js (3.0K) # 保存URL+Token并调用init获取站点信息
│ │
│ ├── product/ # 商品安全
│ │ └── check-delete-permit.js (2.1K) # 删除授权控制 — allow/revoke
│ │
│ ├── product-csv-import/ # CSV批量导入
│ │ ├── detect-fecify-csv.js (13.1K) # 通用格式检测 — Shopify/Fecify识别+数据校验
│ │ ├── detect-shopify-csv.js (13.1K) # Shopify格式检测（通用检测器内部调用）
│ │ ├── import-fecify-csv.js (24.3K) # Fecify格式导入 — 图片上传/变体/并发/汇总
│ │ └── import-shopify-csv.js (28.6K) # Shopify格式导入 — 列映射/转换/并发/汇总
│ │
│ ├── image/ # 图片生成 + 本地上传
│ │ ├── image-client.js (10.9K) # AI图片生成客户端 — Provider注册/尺寸映射/调用/裁切
│ │ ├── generate.js (3.8K) # 生成入口 — 提示词增强/输出Webp/尺寸类型
│ │ ├── config.js (3.1K) # 配置管理 — 查看/保存AI图片模型配置
│ │ ├── prompt-enhancer.js (3.7K) # 提示词增强 — 电商场景词追加
│ │ └── upload-local.js (5.9K) # 本地图片上传 — 目录批量/单文件/HTTPS直传避base64限制
│ │
│ ├── collection/ # 商品专辑
│ │ └── create.js (16.5K) # 专辑批量创建 — 多语言/产品绑定/图片
│ │
│ └── init/ # 初始化
│ └── get-addons.js (0.4K) # 获取已安装插件列表
│
├── data/fecify-shared/ # 💾 持久化配置（跨skill版本）
│ └── sessions/ # 站点绑定 — 每个FECIFY_SESSION一个配置
│ ├── current_default.txt # 默认会话
│ ├── current_<session>.txt # 命名会话
│ └── <domain>/ # 按域名分目录
│ ├── config.json # URL + Token
│ └── init-data.json # 站点初始化信息
│
└── temp/ # ⏳ 临时文件
├── import_results.json (1.7K) # CSV导入结果汇总
├── .gitkeep
└── failed/
└── .gitkeep