@accio-ai/ecommerce-cli 0.0.8-rc.2 → 0.0.9-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,8 +4,17 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ 当前候选版本为 `0.0.9-rc.2`,稳定基版为 `0.0.9`;本轮补充已发布的 `v0.0.9-rc.1` 之后的变化,保留此前候选版的累计说明,仍处于未正式发布状态。
8
+
7
9
  ### Added
8
10
 
11
+ - 海外 blocking `collection run/batch` 结束后保留终态 Job 快照并回填 `job_id`,可通过 `status/ready` 读取;采集结果补充逐单元覆盖证明,快照保留失败时明确返回错误。
12
+ - 国内 `collection describe` 新增 `fact_dimension` 和 `collection_dimension`,分别说明事实粒度与采集粒度;整店采集但保存商品事实的来源必须提供 `store_id`,导入预检与正式执行遵循同一规则。
13
+ - 新增 `overseas collection batch`,从计划文件执行有界并发采集,支持整批及单项超时、共享请求预算和原子进度文件;重叠覆盖在请求前拒绝,当前不接受 Shopify 项。
14
+ - 扩展 Amazon、Temu、eBay 和 Shopify 采集来源,支持配置化请求时间窗、周期报表、分页与详情扇出;Shopify 通过调用绑定的本地 CLI 会话执行。来源注册不代表真实账号全部验收通过,eBay finance/payout 仍要求可信执行期签名能力,详见 [采集兼容边界](docs/海外采集兼容边界.md)。
15
+ - 新增 eBay `overseas store list`、`listing capability/execute` 和 `advertising report`,提供当前授权账号发现、受限的既有 Listing 操作和广告报表分步处理;写入要求明确确认及账号匹配,结果未知时不自动重发。新增 `overseas product apply`,通过当前授权店铺执行已批准的 TikTok 商品变更集。
16
+ - 新增 1688 公开商品监控、商品概况及单品分析来源与后处理;`domestic collection normalize` 支持 XLS、业务期间及显式商品范围输入。
17
+ - 新增命令骨架生成、自动命令索引、跨平台架构依赖检查,以及双二进制发现、保留数据交接和性能对照工具;真实宿主、账号与六平台原生验收范围见 [兼容矩阵](docs/22-统一架构兼容矩阵与验收操作.md)。
9
18
  - Amazon 商品采集新增公共 `--asin` / JSON `asin` 选择器;`amz_listings_item` 按 `identifiers` 直接过滤 Listing,`amz_catalog_items` 按 ASIN 批量查询,并通过独立 coverage key 与全店快照隔离。
10
19
  - 新增独立 Monitor 和命令/API/后台执行三类安全事件,通过 Phoenix Gateway 上报;兼容原 API JSONL,以 invocation/apiCall/job/execution 关联,恢复上下文独立。队列与网络预算有界,关闭开关和发送失败不改变业务输出或退出码;未确认持久化时不宣称任务完成。真实 Desktop → SLS 验收仍待可信测试宿主,详见 [验收记录](docs/monitor-acceptance.md)。
11
20
  - 海外商品 publish 新增 `--expected-platform` 和 `--concurrency`,支持显式限定平台与有界并发(默认 2、最多 4);同一次调用选定平台、店铺和站点内的全部待提交商品通过预检后才正式发送,任一商品预检失败时其他待提交商品返回 `not_attempted`,未选平台的错误不阻断当前平台。
@@ -20,6 +29,7 @@
20
29
  - 保留 `sourceimport.Service.ImportBatch` 批量业务能力:接收已解析的 Command,完成整批校验、组装和去重,再在同一事务提交事实、列定义与覆盖台账,事务失败时整批回滚;文件转换、初始化和报告不属于该事务,统一 CLI 一次仍导入一个 source。
21
30
  - 新增 `domestic collection plan`,按业务域、店铺/商品范围和日期生成采集计划,结合覆盖台账识别待补采数据;主题与指标列表补充 `description`,更新业务域分类和指标路由配置。
22
31
  - 海外报表采集新增持久化轮询状态与结果分发,等待期间释放 worker,支持进程恢复、租约接管和有界重试;报表结果按覆盖单元提交,采集时间统一保存为 UTC。
32
+ - 接入 TikTok shopmiddle 已打通的 17 个读接口为可执行 Source(`erpShopId` 按店寻址;商品/订单/结算详情与库存、类目属性通过 fanout 从列表取数)。美区 `responsiblePerson/page` 因 HTTP 400 不纳入。
23
33
  - 新增 `--input-json-file`,从最多 1 MiB 的 UTF-8 / UTF-8 BOM 文件读取命令参数,沿用内联 JSON 的校验与默认值,避免 CMD / PowerShell 内联引号差异;补充 Windows 调用指南和三种 Windows Shell 的 EXE / npm 入口 smoke。
24
34
  - 新增海外源发现、按日分页与快照采集,以及持久化任务状态、结果交付和失败重试;可信长驻宿主支持带提交幂等、租约与恢复的异步执行,独立 CLI 使用同步执行。
25
35
  - 新增按作用域隔离的多连接授权和跨平台凭据批量查询,采集范围按授权店铺解析;扩展 Amazon 运营数据源与游标分页库存快照。
@@ -42,6 +52,11 @@
42
52
 
43
53
  ### Changed
44
54
 
55
+ - 国内采集计划支持按 `--source-id` / `--biz-id` 精确选择来源,并返回逐来源覆盖决策;待采集项使用 `source_type`、`biz_id` 和 `param_spec`,调用方需适配旧 `type` / `dsl_id` 字段,按需读取 `execution_groups`、`selection` 和 `source_decisions`。
56
+ - 海外采集按来源配置合并请求时间窗并还原业务日期,报表分片与覆盖提交支持持久状态和原子写入;合并范围限于当前同步调用,不承诺跨 Batch 项或持久 Job 合并。
57
+ - 业务核心与命令契约统一归入 `modules/domestic|overseas|system`,由域 JSON 清单与显式装配注入唯一 Catalog;国内共用查询和日期规则归入 `support`,自动命令索引增加真实契约及源码导航。通用 CLI 运行实现收敛到 `clikit`,原 CLI 包保留源码转发入口;纯架构迁移沿用既有公开协议,本版累计业务新增另行列明。
58
+ - `overseas store list` 扩展为按平台读取已授权店铺目录,继续使用当前调用的授权范围。
59
+ - 扩展国内 1688 配置及海外来源、周期和报表存储的已知历史迁移。旧库升级使用当前 `setup`;未知历史形态仍拒绝迁移,新版数据格式不承诺由任意旧版读取,升级及回退需保留完整数据副本。
45
60
  - 海外类目与素材定义默认使用中文,可指定 `en-US`,Schema 同步声明默认语言;TikTok 查询关键词需与语言匹配,但生成素材包时允许语言与类目证据不同,也兼容无 locale 的旧证据,仍校验证据摘要、授权上下文和类目。Amazon 素材定义将 `zh-CN` / `en-US` 映射为接口要求的 `zh_CN` / `en_US`,校验返回语言并保留模板的 `locale` / `uiLocale`。
46
61
  - Amazon、TikTok 和 Temu 的 `publish --dry-run --store-id` 改为通过当前宿主授权唯一选择目标店铺、平台、市场和经营模式,不再按包内来源店铺筛选;缺失授权或目标歧义明确报错。此预检会获取或刷新当前授权,但不上传、发品或创建发布记录;未传店铺 ID 时仍为离线检查。升级自 `0.0.7-rc.1` 的调用方需提供宿主授权,正式发布会重新核对身份与目标。
47
62
  - Temu 属性 `valueRule` 暂仅对已知值执行附加聚合校验:`1` 保持百分比范围及总和为 100 的要求,其他未知值不再单独导致“不支持”错误;必填、数值、范围、精度和单位等校验继续执行,最终仍以平台规则为准。
@@ -81,6 +96,13 @@
81
96
 
82
97
  ### Fixed
83
98
 
99
+ - 修正 1688 时序产物的日期证据、交付体积与退役来源兼容处理;业务日期入库与采集覆盖遵循来源声明,批量导入预检无法安全读取时返回 `preflight_incomplete`。
100
+ - 修复海外批次采集阻塞与超时处理,完善 Report 下载错误诊断、TSV 解析、按日请求恢复及授权拒绝条目的处理。
101
+ - 修复 TikTok 素材工作簿中文字段及选项读取、日本市场币种与区域类目适配,以及 Temu 同名品牌选项的映射歧义。
102
+ - eBay 草稿创建保留部分图片失败信息并兼容提供方回执;图片上传遇到授权失败时停止重试。
103
+ - Amazon SP Campaign 采集请求补齐 `sales14d`、`purchases14d`,保持数据库结构和覆盖版本不变;已有缺归因字段的缓存须通过 `--force-recheck` 重新采集,详见 [采集兼容边界](docs/海外采集兼容边界.md)。
104
+ - 修正国内导入覆盖台账的时间范围处理,减少国内查询重复读取;1688 广告多工作表输入仅采用分日数据,并规范化日期及商品身份。
105
+ - 修正 Temu 外包装必填契约、电子说明书预检和上传流程;完善 eBay 授权、报表结果和公开契约的错误边界。
84
106
  - Temu 全托、半托供货价及建议零售价按模板的最小货币单位原值传递,避免重复乘币种倍率;拒绝非整数最小单位、非正数和越界金额,并补充字段及单元格定位。
85
107
  - Amazon 素材 Schema 错误在可唯一定位时补充输入单元格和命中的条件位置,区分禁止填写与值不合法;无法确定分支时保留通用诊断,不猜测修正动作或回显原始值。
86
108
  - 完善多平台素材包兼容、TikTok 图片推断与映射、Temu 包装数量及属性输入处理;预检按实际选中的目标工作表报告问题,避免被其他平台的有效素材或错误干扰。
package/checksums.json CHANGED
@@ -1,35 +1,35 @@
1
1
  {
2
- "version": "0.0.8-rc.2",
2
+ "version": "0.0.9-rc.2",
3
3
  "binaries": {
4
4
  "darwin-arm64": {
5
5
  "package": "@accio-ai/ecommerce-cli-darwin-arm64",
6
6
  "file": "ecomctl",
7
- "sha256": "13a2d4ecf7b04196f43c7ac921647e15966472c3f3f58527a41227488c010d8e"
7
+ "sha256": "799c6717cc663654a7f0f50a11b41c09bc3083a43c0ee98370b59565ec0afa16"
8
8
  },
9
9
  "darwin-x64": {
10
10
  "package": "@accio-ai/ecommerce-cli-darwin-x64",
11
11
  "file": "ecomctl",
12
- "sha256": "b786d26f1cd1ea2972111dc28b0ca80ac556ccdd5ea20976eeb33070e7251a44"
12
+ "sha256": "44b7b6b9fd57975acd92c1b2be58e27560d0eadea01a9903089bd6534fb210c0"
13
13
  },
14
14
  "linux-arm64": {
15
15
  "package": "@accio-ai/ecommerce-cli-linux-arm64",
16
16
  "file": "ecomctl",
17
- "sha256": "9505545d40894153890a4770fae11d37e53d023d371ff857e2913707a9288c42"
17
+ "sha256": "e4308cdea7fa12b221a6b558ba471b12ca4ff7b3939b06619f1cdb55a3250e49"
18
18
  },
19
19
  "linux-x64": {
20
20
  "package": "@accio-ai/ecommerce-cli-linux-x64",
21
21
  "file": "ecomctl",
22
- "sha256": "0d203e9dcfdb866cbf129f9913abbafe54dac11c8b1133ae266b520fea31814e"
22
+ "sha256": "eebd07a92636952ce8694d273c46947644a1ff399b3c4c00a2c5eae6f2662499"
23
23
  },
24
24
  "win32-arm64": {
25
25
  "package": "@accio-ai/ecommerce-cli-win32-arm64",
26
26
  "file": "ecomctl.exe",
27
- "sha256": "014dc69d9d3f9b945e1637b64905068167f8899890e663820faaa651b161dcf4"
27
+ "sha256": "5c5ffd9ba4563527204b563a130ce5495975622b825cc1ae0cd56f1299cb1d8d"
28
28
  },
29
29
  "win32-x64": {
30
30
  "package": "@accio-ai/ecommerce-cli-win32-x64",
31
31
  "file": "ecomctl.exe",
32
- "sha256": "ca97112a290a600174e0004f86ef420ee1f3346b9b2a89487a0c0a1a80e38384"
32
+ "sha256": "b3705247cc0530c37e165695af5f577b92ad8407abab4ade7d5891656adc84ab"
33
33
  }
34
34
  }
35
35
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@accio-ai/ecommerce-cli",
3
- "version": "0.0.8-rc.2",
3
+ "version": "0.0.9-rc.2",
4
4
  "description": "Local, statically compiled ecommerce automation toolkit",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {
@@ -18,12 +18,12 @@
18
18
  "postinstall": "node postinstall.cjs"
19
19
  },
20
20
  "optionalDependencies": {
21
- "@accio-ai/ecommerce-cli-darwin-arm64": "0.0.8-rc.2",
22
- "@accio-ai/ecommerce-cli-darwin-x64": "0.0.8-rc.2",
23
- "@accio-ai/ecommerce-cli-linux-arm64": "0.0.8-rc.2",
24
- "@accio-ai/ecommerce-cli-linux-x64": "0.0.8-rc.2",
25
- "@accio-ai/ecommerce-cli-win32-arm64": "0.0.8-rc.2",
26
- "@accio-ai/ecommerce-cli-win32-x64": "0.0.8-rc.2"
21
+ "@accio-ai/ecommerce-cli-darwin-arm64": "0.0.9-rc.2",
22
+ "@accio-ai/ecommerce-cli-darwin-x64": "0.0.9-rc.2",
23
+ "@accio-ai/ecommerce-cli-linux-arm64": "0.0.9-rc.2",
24
+ "@accio-ai/ecommerce-cli-linux-x64": "0.0.9-rc.2",
25
+ "@accio-ai/ecommerce-cli-win32-arm64": "0.0.9-rc.2",
26
+ "@accio-ai/ecommerce-cli-win32-x64": "0.0.9-rc.2"
27
27
  },
28
28
  "files": [
29
29
  "bin",