Fecify 站群管家 v1
版本: v1 | 配置数据存储于
data/fecify-shared/，发版升级不影响已有配置
0. 会话隔离
所有 exec 调用必须带 env: { FECIFY_SESSION: "<标识>" }。
会话标识：用户指定 → 用指定名称；未指定 → 用 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 "<URL>" "<Token>"
该脚本自动保存配置并拉取 init 数据。配置持久化，不受重启影响。
已配置 → 显示站点 URL 和 init 状态。
2. 模块速查
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 格式 |
3. API 调用
node scripts/proxy/api-call.js <METHOD> <PATH> [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→ 读datacode === -1→ 网络/解析层错误- 其他
code→ 业务错误，看message
4. CSV 导入（两步交互）
用户上传 CSV → 先检测再导入，不可跳过检测。 检测分两步：① 表格格式识别 ② 数据行校验。有异常 → 提示修复重新上传；无异常 → 展示选项等用户确认。 完整交互模板见 shopify-csv-product-import.md。
# Step 1 — 检测
node scripts/csv-import/detect-shopify-csv.js <CSV文件>
# Step 2 — 执行（根据用户选择组装参数）
node scripts/csv-import/import-shopify-csv.js <CSV> [--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]