Fecify 站群管家 v1 版本:v1 | 配置数据存储于 data/fecify-shared/,发版升级不影响已有配置
所有 exec 调用必须带 env:{ FECIFY_SESSION:"<标识>" }。
会话标识:用户指定 → 用指定名称;未指定 → 用 session key 后 8 位。
exec({ env:{ FECIFY_SESSION:"agent-a" },command: "node scripts/base/check-config.js" })
node scripts/base/check-config.js
未配置 → 提示用户提交 站点 URL + AccessToken(任意格式),然后:
node scripts/base/save-config.js "" ""
该脚本自动保存配置并拉取 init 数据。配置持久化,不受重启影响。
已配置 → 显示站点 URL 和 init 状态。
API 操作
模块 文档
API 商品 products.md 列表/详情/创建/更新
图片 base-image.md 列表/上传(跨模块公用)
订单 orders.md 待补充
优惠券 coupons.md 待补充
业务场景
场景 文档 说明
CSV 导入 csv-import.md 所有平台 CSV 商品导入入口
参考 文档 说明
architecture.md 目录结构 / api-client / site-config
extending.md 新增模块 / 新增 CSV 格式
node scripts/proxy/api-call.js [BODY_JSON]
示例:
node scripts/proxy/api-call.js GET /api/skill/product/list '{"pageNum":1,"pageSize":20}'
node scripts/proxy/api-call.js POST /api/skill/product/create '{"product":{...}}'
先读 docs/ 下对应文档获取参数说明,再调用。
响应判断
code === 200 → 成功;否则 → 失败。
// 成功
{ "code": 200, "message": "success", "data": { ... } }
// 业务错误
{ "code": 100701001, "message": "product save fail | ..." }
// PHP 异常(HTML 响应)
{ "code": -1, "message": "服务端返回 HTML 异常...", "_raw": "..." }
code === 200 → 读 data
code === -1 → 网络/解析层错误
其他 code → 业务错误,看 message
用户上传 CSV → 先检测再导入,不可跳过检测。
检测分两步:① 表格格式识别 ② 数据行校验。有异常 → 提示修复重新上传;无异常 → 展示选项等用户确认。
完整交互模板见 shopify-csv-product-import.md。
# Step 1 — 检测
node scripts/csv-import/detect-shopify-csv.js
# Step 2 — 执行(根据用户选择组装参数)
node scripts/csv-import/import-shopify-csv.js [--max=N] [--skip=N] [--dry-run] [--use-network-images] [--gen-tags=none|auto|force] [--tag-count=N] [--img-concurrency=N] [--img-retries=N] [--import-concurrency=N] [--skip-validation]