用途:通过本项目 CLI 在闲鱼发布商品,覆盖填写发布表单、上传图片、设置价格、分类、计价方式、应用场景、发货方式,以及确认发布或一步发布。触发场景包括用户要求发布、上架、测试发布、填写发布草稿,或提供标题、描述、价格、图片素材需要上传。
主要能力:只使用 python scripts/cli.py <command> 调用。推荐流程为先执行 check-login,准备描述文件与本地图片路径,执行 fill-publish 只填表不发布,读取返回的 category_resolution、selected、unsupported_category_marker 和页面提示,让用户在 Chrome 中确认图片、描述、价格、分类与平台提示,确认后执行 click-publish,再用 get-item-detail 或 get-item-stats 反查商品。用户明确要求直接发布时可用 publish 一步发布。
关键参数:--description 直接传描述;--description-file 从本地 UTF-8 文本文件读取,推荐正式发布使用;--price 价格;--original-price 原价可选;--images 一个或多个本地图片路径;--category 分类名或 auto-safe / auto / next-supported,默认 auto-safe;--pricing-unit 计价方式;--scenario 应用场景;--shipping 发货方式,服务类常用“无需邮寄”。
素材与分类:正式发布优先使用用户真实商品图片;本地图片直接传绝对路径,图片 URL 需先下载到本地临时目录再传路径,设计工具或其他 Agent 生成的图片也须先保存为本地路径。不要上传含二维码、手机号、微信号、外部链接、明显水印、平台外导流、夸张承诺或敏感文字的图片。分类默认 auto-safe,脚本按页面反馈处理,不硬编码映射;若出现“网页版暂不支持发布此分类”等提示,会从相邻候选分类依次尝试,仍不支持则返回尝试列表由用户人工确认。
输出与限制:success: true 只表示命令执行成功,不一定表示已发布,是否成功以 click-publish / publish 的最终 URL 和状态为准;未检测到商品详情页不要声称发布成功。selected.pricing_unit / scenario 为 false 可能是该分类无对应字段。发布前应让用户确认最终描述、价格、图片和分类。图片被识别为二维码需更换图片;发布后很快消失可能进入审核、被下架或触发风控。ImageGen 不是必需依赖。