CatalogFlow 0.10.0 — 新手引导与采集衔接

CatalogFlow 0.10.0

新手流程已衔接

• 新增 CN / English (US) 首次使用引导，区分 AI 安装、登录检查及可选的小型请求测试。保存连接不再被误认为已可用。
• CJ / Alibaba 国际站主动选品接入“已采集商品”，用一条配对码连接；确认采集后选择商品，再点击生成预览。
• Alibaba 手动资料可直接填写表单，支持事实、图片、变体、成本及运费，无需编写 JSON。
• CatalogFlow 自动调用所选本机 Codex / Claude CLI，无需再向聊天窗口发送“可以开始”。CLI 安装与官方账号登录仍由使用者完成。
• 仅预览无需店铺连接；创建隐藏草稿仍需另行选店铺并审核确认。工作报告保留时间、原链接和结果。
• 修复配置变更后的旧检查状态、商品资料混用、关闭后的迟到采集请求和 AI 子进程超时问题。

Downloads

Windows: download and extract CatalogFlow-0.10.0-windows-x64.zip, then open CatalogFlow.exe. Python is not required. The wheel is available for Python users; checksum files accompany the artifacts.

The package contains public application code only. It does not include private connections, SSH keys, AI login state or work reports. Existing local settings remain outside the executable.

See the first-run walkthrough for installation, pairing and preview steps. Alibaba's automatic official-API product adapter is not yet implemented; its selected links use manual data entry.

CatalogFlow v0.9.0 - Visual import wizard

CatalogFlow v0.9.0

中文

现在可以直接在窗口中完成单商品搬运：填写来源 → 生成预览 → 审核并创建隐藏草稿，无需输入导入命令。

• 支持 CJ 官方商品链接/产品 ID，或手动选择单商品规范化 JSON 文件（UTF-8/BOM，最多 48 KiB，成本为 USD）。
• 从已保存连接中选择 CJ、Codex/Claude 和 WooCommerce；也可用无需 AI 的本机模板，仅生成预览。
• 页面显示进度、原链接、图库与变体图片链接、每个变体的成本/运费/USD 售价，以及定价设置快照。
• 可编辑标题、描述、分类与标签。审核勾选后才能创建隐藏草稿；修改来源或重新生成预览会使旧审核失效。
• 确认使用服务器保留的商品、文案、售价和目标店铺，不会再次调用 CJ/AI 或隐式重算价格。重复点击、待确认写入和退出操作均有保护。
• 每次运行自动保存时间戳 TXT/JSON 报告，保留原商品链接和结果。支持中文/English (US)，窄屏控件保持等高。

选择店铺前请配置自己的 WooCommerce REST 凭据；图片上传另需 WordPress 用户名和应用程序密码。未选店铺仍可预览。Alibaba/1688 自动链接采集、批量导入和旧私人历史迁移尚未提供；该来源使用规范化 JSON。

验证：375 项 Python 通过、1 项 Windows 符号链接权限跳过、46 项 Node 通过；Ruff、秘密扫描、GitHub CI/CodeQL 通过。完成模拟店铺的浏览器全流程，以及真实 CJ + 已登录 Codex 预览。EXE 自检含系统凭据库随机写读删，另在无 Python/Node PATH 下通过合成商品预览；wheel 隔离 HTTP 向导验收通过。

下载 Windows ZIP 后解压双击 CatalogFlow.exe。AI CLI 仍需自行安装并登录，EXE 尚未进行代码签名；所有发布文件附 SHA256。

English

Import one product directly from the dashboard: choose a source → generate a preview → review and create a hidden draft. Import command-line arguments are no longer required for this workflow.

• Supports an official CJ product URL/ID or a normalized single-product JSON file (UTF-8/BOM, up to 48 KiB, USD costs).
• Uses saved supplier, Codex/Claude, and WooCommerce connections; a local template option requires no AI.
• Shows progress, source links, gallery/variant image links, per-variant costs, shipping, USD prices, and the pricing snapshot.
• Allows title, description, category, and tag edits with explicit review. New input or another preview attempt invalidates the old approval.
• Confirmation uses server-owned product, listing, price, and store snapshots without another supplier/AI request or implicit repricing. Duplicate submission, incomplete writes, and shutdown are guarded.
• Archives timestamped TXT/JSON reports and integrates their viewer/download controls. Includes Chinese/English (US) copy and responsive layouts.

Configure your own WooCommerce REST credentials before selecting a store. Image uploads also require a WordPress username and application password. Previewing without a store is supported. Automatic Alibaba/1688 URL acquisition, batch imports, and migration of private legacy history are not included.

Validation: 375 Python tests passed, one Windows symlink-permission skip, 46 Node tests passed, plus Ruff, secret scanning, and GitHub CI/CodeQL. Browser tests covered the simulated-store workflow and a real authorized CJ + signed-in Codex preview. EXE checks include a temporary OS-keyring roundtrip and synthetic preview without Python/Node on PATH; isolated wheel HTTP wizard checks also passed.

Extract the Windows ZIP and double-click CatalogFlow.exe. AI CLIs remain separately installed and authenticated. The EXE is unsigned; SHA256 files accompany all release artifacts.

See the visual import guide and Windows guide.

CatalogFlow v0.8.0 - Windows desktop

CatalogFlow v0.8.0

中文

Windows x64 桌面版现已可用。下载 ZIP、解压后双击 CatalogFlow.exe，即可打开中英文定价、连接配置和工作记录界面，无需安装 Python。导入仍通过显式命令参数执行，图形化导入向导尚未提供。

• 保留自定义成本公式、可手动修改的运费汇率、时间戳 TXT/JSON 报告、防重复及图片/变体导入能力。
• 新增启动器、同一 Windows 账户单实例、重新打开界面与退出服务操作。
• 修复打包程序调用外部 AI CLI 的 DLL 环境问题；旧 Codex 版本与模型不兼容时提供明确提示。
• CJ 物流线路不可用或无有效运费时给出中英文诊断；店铺 SKU 查询返回无关商品时停止，避免误关联。
• 上传图片使用唯一数字文件名。配置、系统凭据和私人工作记录均留在本机，不包含在安装包中。

已完成两台 Windows 电脑验收，包含无 Python PATH 启动检查，以及通过最终 EXE 调用已登录 Codex 生成合成商品预览。本地测试为 304 项 Python 通过、1 项 Windows 权限相关跳过、27 项 Node 通过；Ruff、秘密扫描及 GitHub CI 通过。Windows EXE、ZIP 和 Python wheel 均附 SHA256。

默认保持预览；显式店铺写入仅创建隐藏草稿。AI 功能需要同一电脑上已安装并登录的 Codex CLI 或 Claude Code；供应商及店铺连接需要自行配置。此 EXE 尚未进行 Windows 代码签名。

English

The Windows x64 desktop build is ready. Extract the ZIP and double-click CatalogFlow.exe to open the bilingual pricing, connection, and work-history dashboard without installing Python. Imports still use explicit command-line arguments; a graphical import wizard is not included yet.

• Includes a launcher, account-scoped single instance, reopen controls, and clean service shutdown.
• Retains custom cost formulas, editable freight exchange rates, timestamped TXT/JSON reports, duplicate protection, images, and product variants.
• Fixes external AI CLI DLL isolation in frozen builds and explains outdated Codex CLI/model incompatibility.
• Adds bilingual CJ freight diagnostics, rejects unrelated store SKU-search results, and uses unique numeric upload filenames.
• Keeps configuration, OS-keyring credentials, and private reports outside release artifacts.

Validated on two Windows computers, including startup without Python on PATH and a real signed-in Codex synthetic-product preview through the final EXE. Local checks: 304 Python tests passed, one Windows permission-related skip, 27 Node tests passed, plus Ruff, secret scanning, and GitHub CI. SHA256 files accompany the EXE, ZIP, and wheel.

Preview remains the default; explicit store writes create hidden drafts only. AI generation requires a separately installed and signed-in Codex CLI or Claude Code on that computer. Supplier/store credentials are configured separately. The EXE is currently unsigned.

See Windows guide and changelog.

CatalogFlow v0.7.0 — 工作记录与完整草稿导出

中文

• 恢复旧流程的工作记录：每次 CLI 导入自动归档带时间戳的 TXT / JSON，记录原链接、来源商品 ID、逐项处理结果和店铺草稿对应关系。
• 可视化面板新增中英文“工作记录”，查看最近批次和逐项详情，下载记事本报告；旧私人记录不会自动迁入。
• 完成过的草稿导入会在调用 AI 前跳过；未确认或部分写入阻止直接重建；确定没有开始写入的错误可修正后重试。
• WooCommerce 导出保留各变体属性和价格，支持商品及变体图片。图片上传需单独配置 WordPress 用户名与应用程序密码；密钥仍进入系统凭据库。所有商品保持隐藏草稿，变体保持草稿。
• 每次导出最多 100 个变体、20 张去重图片，每图上限 8 MiB；超限报错，不静默丢弃。已上传媒体可能通过直接 URL 访问。
• 这次先补齐工作流程，尚未提供 Windows EXE，也不包含可视化导入向导或旧历史数据迁移。

验证：268 项 Python 测试通过，1 项因 Windows 不允许创建符号链接而跳过；27 项 Node 测试通过。静态检查、精确文件秘密扫描和本机中英文/窄屏/TXT 下载验收通过。店铺接口采用模拟测试，没有操作正式商店。

English

• Archive each CLI import in timestamped TXT/JSON reports with source links, item outcomes and store-draft references. Review recent runs and download TXT in the bilingual dashboard.
• Preserve store-scoped durable draft history. Completed duplicates skip AI; uncertain and partial writes require review; definitive no-write failures may retry after correction.
• Export actual product variations and bounded authorized images. Media uploads require a WordPress username/application password in addition to WooCommerce product credentials. Parents stay hidden drafts and variations stay drafts; media URLs may be directly accessible.
• Limits: 100 variations, 20 distinct images, 8 MiB per image. Exceeding limits rejects the export rather than truncating it.
• Private historic reports and registries are not automatically imported. This release does not include Windows EXE packaging or a graphical import wizard.

Validation: 268 Python tests passed, one OS-dependent symlink test skipped; 27 Node tests passed. Synthetic store tests, lint, secret scan and browser acceptance passed. No production store operations were performed.

Install the wheel with python -m pip install --upgrade catalogflow-0.7.0-py3-none-any.whl, then run python -m catalogflow configure.

CatalogFlow v0.6.0 — Custom cost formulas and aligned pricing controls

CatalogFlow v0.6.0 adds editable arithmetic to Plan B and fixes bilingual currency-field alignment.

中文

• 方案 B 卡片内可直接填写商品成本公式：*5、/5、+2、-2、*3+2，也支持 *(5+2)/3 等括号表达式。只填 5 等同 *5，默认仍为 *3。
• 先对商品成本执行公式，再加一次运费、预估税费和固定手续费；仍应用最低售价和 .95 尾数。页面显示每步金额，预估利润继续扣除原始商品成本。
• 中英文切换保留公式，回车只重新试算，点击保存才用于后续商品变体预览。除以零、非法字符、负数或过大结果会明确报错并清除过期预览。
• 汇率三栏改为等宽列和共享行高中英文排版，长标签换行仍保持框体对齐。手机使用单列，公式输入框占满可用宽度。

English

• Edit Plan B's product-cost formula in its comparison card using numbers, + - * /, and parentheses. Multiplication/division take precedence; a bare number means multiplication.
• Shipping, duties, and the fixed fee are added after the formula. The original minimum-price and .95 rules remain visible. Saved formulas apply to each later CLI variant's own cost and freight.
• Bounded decimal arithmetic rejects executable syntax and zero divisors; invalid product results fail closed. No formula or cost is sent to AI.
• Equal-width freight currency fields now align across English/Chinese label wrapping, with consistent narrow-screen controls.

Settings compatibility

Existing version-1 numeric pricing files load without being rewritten. Explicit saves use version 2 with cost_formula; a non-null formula takes precedence over the legacy numeric multiplier. Older CatalogFlow versions cannot read version-2 files.

Validation

194 Python tests and 18 Node tests passed, plus Ruff, JavaScript syntax, local doctor, and exact-file secret scans. Isolated browser checks covered arithmetic, price floors, error clearing, save/reopen/undo, language switching, and 320/390/521/820-width layouts. Test settings were synthetic; production store and supplier credentials were not used.

Preview-first and WooCommerce draft plus catalog_visibility=hidden behavior remain in place.

Download the wheel and SHA-256 checksum below. Full changes: v0.5.0...v0.6.0.

Built from merged commit 3cf72b0c0da6df5caf4de95a7de7c7d550cb2af2. The 38-file wheel passed source equality, metadata, isolated import, and extracted secret checks. SHA-256: c93b9c744bcfadbc571a54014290aadd8523f881020c37ec29c89ac862bf8ca6.

CatalogFlow v0.5.0 — Bilingual pricing and editable freight conversion

CatalogFlow v0.5.0 adds a bilingual pricing workbench and an editable freight currency converter.

中文

• 可视化定价支持 A/B 方案对比，展示费用、预留、预估利润、利润率、保本价及价格下限说明。
• 整个连接与定价面板可切换中文（CN）或 English（US），切换保留表单内容。
• Last-mile 运费下方新增三栏：目标币种、自动拉取且可直接手动修改的汇率、换算总金额。支持 USD、CNY、HKD、EUR 等 11 种货币。
• 默认汇率来自 Frankfurter 的每日参考数据，界面显示来源和汇率日期；这不是实时银行或交易报价。本地缓存一小时，接口仅请求 USD 基准汇率，不发送成本、金额或凭证。
• 手动输入后按输入精度换算，异步返回的数据不会覆盖手动值；切换语言或币种保留本次页面会话中各币种的手动值。点击“恢复参考汇率”才移除该币种的手动覆盖。总额按目标币种的小数位显示；换算仅供展示，原始定价和保存设置仍以 USD 为单位。
• 本版本同时包含 v0.4.0 后进入主分支的 CJ 官方 API 预览适配及逐变体官方运费报价；需要操作者自己的授权，缺失运费时停止该项处理。

English

• Compare pricing plans with estimated fees, reserves, profit, margins, break-even prices, and floor/rounding explanations.
• Switch the entire dashboard between Chinese and US English without losing form edits.
• Convert last-mile freight with three fields: currency, an automatically populated but directly editable rate, and the converted total. Daily reference rates carry their source/date; manual overrides survive late responses and language/currency changes within the page session. Restore reference rates explicitly to remove an override.
• Includes the CJ official API preview adapter and per-variant official freight quoting added since v0.4.0.

Validation and package

• 143 Python tests and 17 Node tests passed, together with Ruff, JavaScript syntax checks, local CLI discovery, and exact-file Gitleaks scans.
• Browser checks covered both languages, direct rate editing, large amounts, reference restoration, invalid-value clearing, and narrow screens.
• Pull request CI, CodeQL, and secret scans passed. The wheel was built from merged commit b20bac3b752b87cccd018d9e740e438992ba0d7a; bundled sources and version metadata were verified and the extracted package passed a secret scan.
• Download the Python wheel and its SHA-256 checksum below. Wheel SHA-256: c3a951268da123d76c2600c5014f667fb2b29913980ee02de44e3911bdc94fe0.

Preview-first behavior remains the default. Permitted WooCommerce writes remain draft with catalog_visibility=hidden. No real store or supplier credentials were used for validation.

Full changes: v0.4.0...v0.5.0.

CatalogFlow v0.4.0 — Authenticated browser selection queue

Authenticated browser selection queue

• Run catalogflow collect to start a loopback-only receiver and a fresh local selection queue.
• Install the packaged Tampermonkey selector from the local URL printed by the command.
• Select an Alibaba product detail page, inspect the exact minimal payload, and add it to the local queue.
• Keep the one-time token only in the userscript's page-memory closure—never browser storage or Git.
• Reject cookies, authorization headers, raw HTML, unexpected fields, foreign origins, non-detail URLs, oversized/rate-limited requests, and queues over 100 items.
• Canonicalize and deduplicate chosen URLs, then press Enter in the terminal to freeze the queue.

This release intentionally stops at selection. It does not scrape missing fields, call AI, or write to a store. The next official supplier adapter will normalize selected identifiers through each user's own authorized API access.

The attached wheel was built from commit ebab0f7. Verify it with the attached SHA-256 file.

CatalogFlow v0.3.0 — Visual connection center

Visual connection center

• Configure named store, supplier, and local-AI profiles from a loopback-only browser panel.
• Keep API secrets in the operating-system keyring; stored secrets are never returned to the page or written to Git.
• Use WooCommerce REST API, Codex CLI, and Claude Code CLI profiles today.
• See clearly labeled planned paths for Shopify Admin API, restricted WP-CLI over SSH, CJ, Alibaba/1688, and Zendrop.
• Preserve an official-API-first, user-initiated selection model instead of bulk crawling or silent scraping fallbacks.
• Document the verified split between the historical Tampermonkey product selector and its local Python queue receiver.

Run catalogflow configure after installation. The included wheel was built from the tagged source; verify it with the attached SHA-256 file.

CatalogFlow v0.2.0

Adds self-contained local Codex and Claude Code CLI integration, bounded authorized-image inputs, a read-only setup doctor, complete English/Chinese usage documentation, a sanitized agent workflow, and the security design for the future browser-to-CMD collector. Preview-first and hidden-draft-only safeguards remain unchanged.

CatalogFlow 0.1.0

Initial safety-first release.

• Provider-neutral catalog import pipeline
• Dry-run by default; explicit confirmation required for store writes
• WooCommerce output limited to hidden drafts
• Deterministic and schema-constrained Codex listing generators
• Synthetic examples, tests, CI, secret scanning, and CodeQL

This release contains no production credentials, supplier payload archives, customer data, or private store records.