Skip to content

🐟 闲鱼自动化:学员安装与验收 ​

给拿到这套工具的学员(及其电脑上的 AI)用。 从零到能发第一条链接,约 15 分钟。 装的是本地一套自动化:闲鱼扫码登录、批量上架、超级擦亮推广、数据监控, 跑在学员自己的电脑上,数据不出本机。

这一页要解决的是「装不起来」,不是「怎么运营」

玩法、话术、投放策略看 私域玩法与获客。 这一页只管:下载 → 填一份配置 → 双击安装 → 扫码 → 验收通过。

一、先确认三件事 ​

项要求怎么查
系统Windows 10 / 11—
Node.js18 或更高命令行跑 node -v;没有就去 nodejs.org 下 LTS,装完重开命令行
磁盘留 3 GB首次安装要下 Chromium(约 1.5 GB)

两个必须提前说清的

  1. 关掉系统代理 / VPN。 闲鱼会掐断代理连接,表现是「浏览器打不开闲鱼」—— 不是安装坏了,多数人会在这一步怀疑工具。
  2. 一个闲鱼账号只能一台机器、一个店在用。 两台机器登同一个号会互相踢, 而且会重复发布。换机器前先让旧机器停手。

二、下载 ​

下载页(固定入口):https://achun1107.github.io/xianyu-project/

点页面上的「下载安装包」即可。文件名里的版本号、以及 sha256,都以那一页显示的为准 (每次发版会变,本页不写死)。

解压前校验一次,避免下不全:

powershell
Get-FileHash .\xianyu-install-*.zip -Algorithm SHA256 | Format-List

别用 GitHub Release 的下载链接

github.com/.../releases/download/... 会 302 跳到 release-assets.githubusercontent.com, 该域名在国内网络不通(实测 HTTP 000)。用它会以为是包坏了。下载只走上面的下载页。

三、解压(别改名) ​

解压到一个固定位置(比如 D:\),解开就是:

D:\xianyu-install-<版本>\
  ├─ xianyu-achun\                 ← 主控:店铺档案 + 发布管线 + 安装器
  ├─ xianyu-playwright-service\    ← 8093 浏览器服务(出图/发布/账号全靠它)
  ├─ xianyu-monitor\               ← 桌面发布台(⚠️ 不是可选的)
  ├─ install.cmd                   ← 双击开始装
  └─ install-guide.html            ← 图文说明(浏览器双击打开)

一个目录都不用改名、不用搬动 —— 安装器按「主控仓的上一级 + 固定名字」找另外两个。 只解压其中一个、或把某个目录拖到别处,预演就会报「找不到依赖仓」。

四、填一份自己的配置 ​

目标文件:xianyu-playwright-service\service.local.json(和 server.js 同目录)。 它决定这台机器能看到哪个店,所以只能放自己的账号。包里给了模板:

powershell
cd D:\xianyu-install-<版本>\xianyu-achun
copy service.local.json.example ..\xianyu-playwright-service\service.local.json
node -e "console.log(require('crypto').randomUUID())"

记事本打开刚复制出来的文件,把 <...> 换成:

字段填什么
id上面那串 UUID。填好永不再改 —— 登录态存在 browser-profiles\<id>\,改了等于退出登录
name店铺名(自己起一个)。后面所有命令都用它,写法要一致
username / password可留空。扫码登录用不到

填完双击 xianyu-playwright-service\start.bat 重启一次服务 —— 这个文件只在服务启动时读一次。

这个文件是明文密码文件

别发群、别进 git。代码包本身不含它,安装器也不会生成它 —— 只能自己填一次。

五、双击 install.cmd ​

它会先跑预演(什么都不改),停下来让你看两行:

playwright-service 仓库:D:\xianyu-install-<版本>\xianyu-playwright-service
xianyu-monitor 仓库:D:\xianyu-install-<版本>\xianyu-monitor

两行都对 → 按任意键正式安装。显示「找不到」→ 停下来,回第三节检查解压。

安装器会自动:推导本机路径 → 写配置 → 起 8093 服务 → 建店铺骨架。 中间任何一步失败都不会中断,缺什么它会列成清单打出来 —— 那份清单原样发回来即可。

六、装完还有三件只有人能做的 ​

① 扫码登录闲鱼 ​

powershell
node tools\store-ready.js "你的店铺名"
node tools\store-login.js "你的店铺名" --wait=15

浏览器会弹出来,按提示扫码 + 过滑块 + 输短信验证码。登录态存本机,之后不用反复登。

② 出一张主图看看(只出图,不发布) ​

powershell
$env:XY_STORE="你的店铺名"
node publish-one.js 杭州 那英 首开 --dry

③ 副图(可选) ​

把副图丢进 publish-assets\<店铺名>\副图\,然后:

powershell
node tools\store-new.js --list-accounts
node tools\store-init.js "你的店铺名" --apply --verify

七、验收(必须跑,输出发回来) ​

powershell
node tools\store-list.js
node tools\store-init.js --all
node tools\selftest-lib.js

通过标准

store-init.js --all 里 ❌ 是 0 个。有 ❌ 就把整段输出发回来,别自己猜着改。

八、给 AI agent 的一段话 ​

完整任务书在 装机任务书(给 agent) —— 逐步执行手册, agent 可以直接读那一页,不用先下载;装到一半要回看也在那页。 包里也有一份同源的:xianyu-achun\学员安装-给学员DSH.md。

把下面这段 + 那一页的链接一起发给学员的 AI(把 <版本> 换成实际目录名):

请先完整读 https://docs.hympro.cn/16b-xianyu-install-agent
(那是逐步装机任务书),再读 D:\xianyu-install-<版本>\xianyu-achun\学员安装-给学员DSH.md 确认实际路径,
按它在这台电脑上安装闲鱼自动化。

四条硬规矩:
1) 标 👤 的步骤(扫码、过滑块、输短信验证码、点浏览器确认)必须等人,不要替人做;
2) 每一步都要回读验证,不要拿"命令没报错"当成功;
3) 卡住就停下来问,不要自己猜着改代码;把完整原始输出贴出来,不要只贴最后一行;
4) 不要改 lib/ 里的东西(那是代码不是配置),配置只走 config.local.json / service.local.json。

前提:三个目录已经并排解压好,service.local.json 已按要求填好。
先跑 powershell -ExecutionPolicy Bypass -File install.ps1 -DryRun 给我看结果,再继续。

九、出问题先看这几条 ​

现象怎么办
install.ps1 无法加载,因为在此系统上禁止运行脚本用 install.cmd(自带 Bypass)
服务起来了,但发布和广告全都不工作,也不报错九成是 xianyu-monitor 没解压在并排位置
发布时报「店铺未就绪」node tools\store-ready.js "店铺名"(浏览器上下文闲 20 分钟会被回收)
--list-accounts 里看不到自己的店service.local.json 没填对,或改完没重启 8093
浏览器打不开闲鱼 / 连不上关掉系统代理或 VPN
出图失败 / 提示积分不足大麦没查到这场:明星名写法不对,或找管理员要海报
服务连不上netstat -ano | Select-String ':8093'(别用 Get-NetTCPConnection,它查不到)
想看更细的排错包里的 学员常见错误速查.md,按报错关键词 Ctrl+F

十、三条红线 ​

  1. 一个闲鱼账号,只能一台机器、一个店在用。 两台机器登同一个号会互相踢,还会重复发布。
  2. 别把 config.local.json / service.local.json 发到群里。 里面有密钥和密码,是明文。
  3. 下架只能点「下架」,永远不要点「删除」。 下架可逆,删除不可恢复。

好易美(HYM)· 票务业务与后台知识库