Fecify 站群管家 v1

版本: v1 | 配置数据存储于 data/fecify-shared/，发版升级不影响已有配置

0. 会话隔离

所有 exec 调用必须带 env: { FECIFY_SESSION: "\x3C标识>" }。

会话标识：用户指定 → 用指定名称；未指定 → 用 session key 后 8 位。

exec({ env: { FECIFY_SESSION: "agent-a" }, command: "node scripts/base/check-config.js" })

1. 会话启动

node scripts/base/check-config.js

未配置 → 提示用户提交 站点URL + AccessToken（任意格式），然后：

node scripts/base/save-config.js "\x3CURL>" "\x3CToken>"

该脚本自动保存配置并拉取 init 数据。配置持久化，不受重启影响。

已配置 → 显示站点 URL 和 init 状态。

2. 模块速查

API 操作

业务场景

参考

3. API 调用

node scripts/proxy/api-call.js \x3CMETHOD> \x3CPATH> [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

4. CSV 导入（两步交互）

用户上传 CSV → 先检测再导入，不可跳过检测。 检测分两步：① 表格格式识别 ② 数据行校验。有异常 → 提示修复重新上传；无异常 → 展示选项等用户确认。 完整交互模板见 shopify-csv-product-import.md。

# Step 1 — 检测
node scripts/csv-import/detect-shopify-csv.js \x3CCSV文件>

# Step 2 — 执行（根据用户选择组装参数）
node scripts/csv-import/import-shopify-csv.js \x3CCSV> [--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]