核心用法
xianyu-publisher 是一款基于 Playwright 浏览器自动化技术的闲鱼商品发布工具，提供命令行与 Python 模块两种使用方式。用户可通过配置 JSON 格式的商品信息（标题、价格、描述、图片路径等），实现单商品发布或批量上架功能。工具支持 Cookie 持久化登录、图片批量上传、价格设置及反检测机制，并可通过 --interval 参数控制发布间隔。
核心工作流程包括：首次扫码登录保存 Cookie → 配置商品信息文件 → 执行 xianyu-publish 命令完成自动化发布。作为 Python 模块使用时，可集成至现有业务系统实现程序化商品管理。
显著优点
1. 效率提升显著：批量发布功能支持从 JSON 文件读取多商品信息，配合间隔控制实现无人值守上架，大幅降低重复操作成本。
2. 技术栈成熟：基于 Playwright 框架，具备稳定的浏览器控制能力，支持 Chromium 内核，兼容主流平台。
3. 使用门槛低：同时提供 CLI 工具和 Python API，非开发者可通过命令行快速上手，开发者可深度集成。
4. 功能完整度高：覆盖商品发布全流程——自动登录、信息填写、图片上传、价格设置，且具备登录状态持久化。
潜在缺点与局限性
1. 平台合规风险极高：自动化操作可能违反闲鱼/淘宝服务条款，存在账号封禁、IP 黑名单、商品强制下架等后果，且关联账号可能受连带处罚。
2. 反检测机制有限：虽有基础反检测，但面对平台风控升级可能失效，稳定性无法长期保障。
3. 输入验证薄弱：商品信息缺乏有效性校验，特殊字符、超长文本或无效价格可能导致操作失败。
4. 来源可信度低：T3 级个人开发者发布，无开源社区背书，缺乏长期维护记录，代码透明度有限。
适合的目标群体
- 中小闲鱼卖家：需要频繁上架同类商品（如闲置物品、代购商品）的个人或小型店铺运营者。
- 自动化测试人员：需模拟闲鱼发布流程进行功能测试的开发者。
- 效率工具爱好者：理解平台风险、愿意承担账号后果的技术用户。
不适合：企业级电商运营（合规要求严格）、闲鱼重度依赖账号持有者、无技术背景且不愿阅读风险提示的用户。
使用风险
- 账号安全风险：Cookie 本地持久化存储，设备共享或恶意软件可能导致凭证泄露；账号被封将造成经营损失。
- 法律合规风险：违反平台服务条款可能触发违约责任，商业使用需单独获取授权。
- 运行稳定性风险：依赖 Playwright 和 Chromium，环境配置不当可能导致启动失败；平台页面结构变更将直接破坏功能。
- 数据隐私风险：商品图片需提供本地绝对路径，存在路径信息暴露隐患。