闲鱼自动化 · 安装说明

版本 20261114-7902af3 · 包名 xianyu-install-20261114-7902af3-b030418.zip · 全程约 15 分钟(含下载依赖)
标 👤 的地方必须人来操作;其余可以交给你的 AI agent 做。

👉 只想快点开始? 打开同一个目录下的 先看这个-五步上手.html —— 一页纸,五分钟看完,够你装好并发出第一条。
这份说明是完整版(含每一项为什么、以及出问题怎么查),装的过程中卡住了再回来翻。
这个包是自包含的。解开就有三个并排的目录 + 本说明 + 一个 install.cmd。 不用改任何目录名,也不用再下载别的东西。
重新下载 / 取最新版:
https://achun1107.github.io/xianyu-project/xianyu-install-20261114-7902af3-b030418.zip

0 · 装之前先确认三件事 👤

项要求怎么查
系统Windows 10 / 11—
Node.js18 或更高命令行跑 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 服务启动一次 —— 这个文件只在服务启动时读一次,不重启不生效。
这个文件里是明文密码:别发群、别传 git、别贴到聊天里。装完也别删它。

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。

网页顶上有一块「第一次用?按这三步走」的提示,它会按你的实际状态告诉你下一步该干什么(还没登录 / 登录了还没配 / 已就绪)。

② 配一次自己的模板(只做一次)

点「⑤ 配置一家新店」,五步:

配完档案就存下来了。第一次建议勾上「只预览」先看一眼成品图,满意了再正式配。

③ 登录,然后发链接

登录:点右上角「店铺: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 · 三条红线

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