闲鱼自动化 · 安装说明
版本 20261114-7902af3 · 包名 xianyu-install-20261114-7902af3-b030418.zip · 全程约 15 分钟(含下载依赖)
标 👤 的地方必须人来操作;其余可以交给你的 AI agent 做。
先看这个-五步上手.html —— 一页纸,五分钟看完,够你装好并发出第一条。这份说明是完整版(含每一项为什么、以及出问题怎么查),装的过程中卡住了再回来翻。
install.cmd。
不用改任何目录名,也不用再下载别的东西。
0 · 装之前先确认三件事 👤
| 项 | 要求 | 怎么查 |
|---|---|---|
| 系统 | Windows 10 / 11 | — |
| Node.js | 18 或更高 | 命令行跑 node -v。没有就去 nodejs.org 下 LTS,装完重开命令行 |
| 磁盘 | 留 3 GB | 首次装会下 Chromium(约 1.5 GB) |
系统代理 / VPN 要关掉。闲鱼会把代理连接掐断,表现是「浏览器打不开闲鱼 / 一直转圈」,不是安装器的问题。
杀毒软件可能静默拦 node.exe。360 / 火绒 / 电脑管家会阻止 node.exe 联网,且不弹任何提示。
表现是:安装全成功、网页能开,但一操作就「连不上 / 连接被重置」。
处理:在安全软件的「程序联网控制」里把 node.exe 放行;不确定就先临时退出安全软件试一次。
1 · 解压(别改名)👤
把这个 zip 解压到一个固定、路径简单的地方(D: 或 E: 都行,后面任何位置都不要再搬动它),会得到:
<解压目录>\ ← 解压出来的这一个文件夹就是安装目录
├─ xianyu-achun\ ← 主控仓(后面命令都在这里跑)
├─ xianyu-playwright-service\ ← 8093 浏览器服务
├─ xianyu-monitor\ ← 桌面发布台(⚠️ 不是可选的)
├─ install.cmd ← 双击它开始装
└─ install-guide.html ← 本文件
2 · 填一份你自己的配置 👤
目标文件:xianyu-playwright-service\service.local.json(和 server.js 同目录)。
它决定这台机器上能看到哪个店,所以只能放你自己的账号。包里给了模板,复制一份再填:
cd <解压目录>\xianyu-achun
copy service.local.json.example ..\xianyu-playwright-service\service.local.json
node -e "console.log(require('crypto').randomUUID())"
第二条命令会打印一串 UUID。用记事本打开刚复制出来的那个文件,改
localAccounts 里那一个对象(不是外面的 _说明):
{
"_说明": [ ... 五段中文,是给你看的,别动 ... ],
"localAccounts": [
{
"id": "<把这里换成上一步生成的 UUID>",
"name": "<把这里换成你的店铺名>",
"username": "<可留空>",
"password": "<可留空>"
}
]
}
别把尖括号 < > 一起留下 —— <你的店铺名> 要改成
XX票务 这样,不是原样保留。
| 字段 | 填什么 |
|---|---|
id | 上面那串 UUID。填好之后永远不要再改 —— 闲鱼登录态就存在 browser-profiles\<id>\ 下,改了等于退出登录,要重新扫码 |
name | 你的店铺名(自己起一个,比如「XX票务」)。后面所有命令都用它,写法要一致 |
username / password | 可以留空。扫码登录用不到;只有想用密码登录才填 |
xianyu-playwright-service\start.bat 把 8093 服务启动一次 ——
这个文件只在服务启动时读一次,不重启不生效。
3 · 双击 install.cmd 开始装 👤
双击会先跑一次预演(什么都不改),停在中间让你看两行:
playwright-service 仓库:<解压目录>\xianyu-playwright-service
xianyu-monitor 仓库:<解压目录>\xianyu-monitor
两行都对,按任意键继续正式安装;显示「找不到」或指到别的路径,就停下来,说明第 1 步解压没解对。 安装器会自动:推导本机路径 → 写配置 → 起 8093 → 建店铺骨架。 中间任何一步失败都不会中断,它会把缺的东西列成清单打给你 —— 那份清单原样发回来。
4 · 装完之后怎么用(日常就三步)👤
不用敲命令,用网页就行。下面三步做完一次,以后每次只要第 ③ 步。
① 打开网页
双击 xianyu-achun\tools\staff-ui\启动.cmd,浏览器会自动打开 http://127.0.0.1:8099。
网页顶上有一块「第一次用?按这三步走」的提示,它会按你的实际状态告诉你下一步该干什么(还没登录 / 登录了还没配 / 已就绪)。
② 配一次自己的模板(只做一次)
点「⑤ 配置一家新店」,五步:
- 店铺名(要和你的闲鱼账号名一致)· 标价 · 规格档位 · 分类
- 主图风格 —— 金 / 红 / 蓝紫 / 粉紫 / 黑金,工具会用 museav 中台给你生成一张专属底图
- 版式 —— 按底图颜色自动推荐(红底配红字会看不清,工具会拦住)
- 文案口味 · 日推广预算 · 单次咨询出价(红线 ≤4 元)
配完档案就存下来了。第一次建议勾上「只预览」先看一眼成品图,满意了再正式配。
③ 登录,然后发链接
登录:点右上角「店铺:xxx ▾」→ 选你的店 → 点「登录」→ 在弹出的 Chrome 窗口里扫码 + 过滑块 + 输短信验证码。登录态存在本机,不用反复登。
发链接:点「① 发一条新链接」,在「一句话输入」里敲 广州 王嘉尔(空格/逗号/直接连写都行),
然后:
- 先不勾「确认发布」,点开始 —— 它会查大麦、出图、算标题,最后给你一版完整预演,什么都不发
- 看着没问题,再勾上「确认发布」点一次,这次才真发
⚠️ 如果停在「大麦有 X、但没有 Y」——不是故障,是这场在这个城市还没开票。 打开大麦 app 搜一下哪场还有票,换个确定在卖的「城市 明星」再试就行。
发完它自己等 10 分钟复核。注意:发布成功 ≠ 在售,-9 是审核中,等 10–30 分钟自己会转正,别重复发。
用命令行也行(熟悉的人)
cd xianyu-achun
node tools\store-login.js "你的店铺名" --wait=15 :: 扫码登录(15 是【分钟】,默认 10)
$env:XY_STORE="你的店铺名"
node publish-one.js 广州 王嘉尔 --dry :: 只预演,出图不发
node publish-one.js 广州 王嘉尔 :: 真发(不加 --dry 就是真发)
⚠️ 注意:这个脚本没有 --yes 这个参数。
加不加 --dry 就是「预演」和「真发」的唯一区别 —— 所以第一次务必先跑带 --dry 的那条。
副图(可选)
把要用的副图丢进 publish-assets\你的店铺名\副图,然后:
node tools\store-init.js "你的店铺名" --apply --verify
5 · 验收(必须跑,输出发回来)
node tools\store-list.js :: 应该列出你的店铺,"问题"列是 — 或只有 ⚠️
node tools\store-init.js --all :: 连网完整体检(账号/版式库/文案池/素材)
node tools\selftest-lib.js :: 公共库自检
通过标准:store-init.js --all 里 ❌ 是 0 个。有 ❌ 就把整段输出发回来,别自己猜着改。
6 · 给 AI agent 的一段话
把下面这段连同本文件路径,一起发给你电脑上的 AI。它读完会自己往下做。
请读【本文件同目录下】的 xianyu-achun\学员安装-给学员DSH.md,然后按它在这台电脑上安装闲鱼自动化。
四条硬规矩:
1) 标 👤 的步骤(扫码、过滑块、输短信验证码、点浏览器确认)必须等人,不要替人做;
2) 每一步都要回读验证,不要拿"命令没报错"当成功;
3) 卡住就停下来问,不要自己猜着改代码;把完整原始输出贴出来,不要只贴最后一行;
4) 不要改 lib/ 里的东西(那是代码不是配置),配置只走 config.local.json / service.local.json。
(本文件所在的那个文件夹,就是解压出来的 xianyu-install-xxx —— 不管它在 D: 还是 E:,下面都用"那个文件夹"指代)
前提:这台机器上三个目录已经并排解压好了,service.local.json 已经按要求填好。
先跑 powershell -ExecutionPolicy Bypass -File install.ps1 -DryRun 给我看结果,再继续。
7 · 出问题了先看这几条
| 现象 | 怎么办 |
|---|---|
install.ps1 无法加载,因为在此系统上禁止运行脚本 | 用 install.cmd(自带 Bypass),或命令前加 powershell -ExecutionPolicy Bypass -File |
| 服务起来了,但发布和广告全都不工作,也不报错 | 九成是 xianyu-monitor 没解压在并排位置(见第 1 步)。服务缺它时是静默跳过的 |
| 发布时报「店铺未就绪」 | node tools\store-ready.js "店铺名" —— 浏览器上下文闲 20 分钟会被回收 |
--list-accounts 里看不到自己的店 | service.local.json 没填对,或改完没重启 8093(双击 start.bat) |
| 浏览器打不开闲鱼 / 连不上 | 关掉系统代理或 VPN —— 代理会让闲鱼掐断连接 |
| 出图失败 / 提示积分不足 | 大麦没查到这场:明星名写法不对,或让管理员给张海报 |
| 服务连不上 | netstat -ano | Select-String ':8093'(别用 Get-NetTCPConnection,它查不到) |
| 想更详细 | 包里 xianyu-achun\学员常见错误速查.md,按报错关键词 Ctrl+F |
8 · 三条红线
- 一个闲鱼账号,只能一台机器、一个店在用。两台机器登同一个号会互相踢,还会重复发布。
- 别把
config.local.json/service.local.json发到群里。里面有密钥和密码,是明文。 - 下架只能点「下架」,永远不要点「删除」。下架可逆,删除不可恢复。