写文章时从别处复制过来的图片，地址还挂在别人的服务器上。对方删图、换域名、加上防盗链，文章里就只剩破图。这个插件负责把它们搬回自己家：下载到本站上传目录、把正文里的地址换成自己的、同时在后台「资源」库里登记一条记录。

功能一览

一键图片本地化

编辑或新建文章时，正文上方「+ 资源媒体库」旁边并排两个控件，在同一条中线上：

• 一键图片本地化：显示当前正文里待处理的外链张数。点击后逐张抓取，进度条实时推进，
  处理完把新地址直接回填进编辑器，正文结构、图片顺序、alt 文本都不改动。
• 保存时自动本地化：与插件设置里的是同一个开关，点一下就记住，对之后每一次保存生效。
  开着则保存时自动抓取外链图片，关掉则只在点左侧按钮时处理。

处理完成后会给出结果明细：成功、跳过、失败各多少张，以及每张图的具体原因
（例如「命中缓存」「已本地化（2.05 KB）」「远程内容不是图片」「超出体积上限」）。

本地化是单向的：插件只把外链换成本站地址，不提供「一键撤销」。搬错了想改回去，
在编辑器里把地址换回原来的外链再保存即可，
下载下来的图片属于站点资源，可在后台「资源」里自行删除。

同一个地址在正文里出现多次，只会下载一次；已经本地化过的地址再次点击会直接命中缓存，不再发请求。

保存时自动本地化

编辑页顶部的开关与插件设置里的是同一个，改哪边都一样：设置页改完要点「保存设置」，
编辑页上点一下立刻生效并记住，下次进编辑页、换台电脑登录都是这个状态。

• 开着：发布、手动存草稿、编辑器自动存草稿都会先把正文 / 摘要 / 封面的外链图片抓回本站再落库；
• 关掉：保存动作完全不联网，只在点「一键图片本地化」时处理。

自动保存的草稿同样会处理（草稿正文里同样是外链，不处理就一直在外面挂着），
只是这类保存不刷新设置页的「最近一次处理」时间，避免高频草稿把时间刷花。
同一张图反复保存只会下载一次。不想让草稿也抓图，就把顶部开关关掉。

正文、摘要、封面都处理

不只正文。摘要里手写的图片、封面框里填的外链地址，都会一并抓取并替换，
开关在设置页里，默认都是开启的。

下载下来的图会进资源库

图片落盘走系统自带的上传流程，目录按年月分档、存进资源库这些行为和你手动上传完全一致，
下载完成后在后台「资源」列表里就能看到，可以继续复用、换分类、删除。
正文里用的是文件本体，所以这条记录也指向原图；开了后台「生成缩略图」时顺手生成的那张小图
没有地方引用它，落盘时会直接删掉，不让它变成一条记录删完还剩个空文件的孤儿
（资源库列表照常显示这张图，只是不另存一份小图）。

登记时记录的是远程原始文件名（比如 hero-banner-01.png），不是本地随机生成名。
这样带来两个好处：资源库里的名字可读；而且即使你清掉了地址映射缓存、换了服务器或迁移了站点，
插件还能按文件名去资源库里认回同一张图，直接复用，不会重复下载占空间。

为避免张冠李戴，文件名主体太短（如 logo.png、ab.png 这类通用名）时不做复用判断，宁可重新下载一次。

映射表指向的文件如果已经在资源库里被删掉，插件会确认文件是否真的还在：
不在了就当作没命中，清掉这条废记录并重新下载一张，绝不会往正文里写一个打不开的地址。

落盘前压缩成 WebP

抓回来的 jpg、png、bmp 在存盘前会转成 WebP：长宽和画面一点不动，体积一般能省一半以上，
一篇多图的文章能明显小下来。正文里回填的地址、资源库里登记的记录，都是转换之后的那个文件，
不会出现「记录写的是原图、盘上却是另一个文件」这种对不上的情况。

不是所有图都会转，下面这些一律原样保存：

• 本来就带不动的格式：gif、webp、avif、svg；动起来的 PNG（APNG）也不转，转了只剩一帧；
• 16 KB 以下的小图：省不出可见的体积，白挨一次编解码；
• 转完反而没小够一成的图：保留原图，不做赔本买卖；
• 服务器 PHP 没有 WebP 写入能力，或图片尺寸太大、内存不够用时：设置页会说明这一项当前不生效。

结果明细会直接告诉你这张图有没有被压：压过的写「已本地化（254.63 KB，原图 303.28 KB）」，
没压的只写「已本地化（303.28 KB）」。

在意兼容性可以把这一项关掉（设置页「保存时压缩图片（转成 WebP）」）。
只在不支持 WebP 的老浏览器（例如 IE11）上会有影响：转过的那些图它们显示不出来。

上传的图片也能压

设置页里另有一个「上传时也压缩（转成 WebP）」，默认关闭。打开后，你从电脑往后台上传图片，
文件存好之后会顺手压一道：正文里插入的是压缩后的地址，资源库里登记的也是它。
判定标准与上面完全一样——只动 jpg / png / bmp、只动 16 KB 以上的、省不下一成就不动。

处理范围是全站上传：资源库与编辑器的上传、站点 logo、会员头像、开放接口都走同一道。
logo 和头像一般只有几 KB，够不上 16 KB 的门槛，通常不会被改到。

开启前需要知道两件事：

• 这一项会让本插件接管站点的上传入口，和云存储 / 七牛 / OSS 类插件互斥，两者只能留一个。
  关闭时完全不介入，不影响别的上传插件。
• 站点开启了「生成缩略图」时，那张缩略图会跟着原图一起换格式（thum-xxx.jpg → thum-xxx.webp），
  资源库记录、磁盘文件、正文地址三者依旧一一对应。在资源库里删除这条记录，核心会把这一对一起删掉，
  删完磁盘上不留多余文件——和没开压缩时的行为完全相同。（删记录会连正文里的图一起没，
  这是 emlog 本来的行为，开不开压缩都一样。）

抓取策略与安全

• 只处理 http / https 地址，data:、blob:、锚点、相对路径一律跳过；
• 服务器上找得到 CA 根证书时会校验 HTTPS 证书，防止图片在半路被人换掉；
• 默认拒绝解析到内网与保留地址的主机，避免被利用来探测服务器（自建内网图床才需要显式放开）；
• 以图片的真实内容判定类型，而不是只看响应头，对方返回错误页或防盗链提示图时会主动放弃，
  不会把垃圾文件存进资源库；
• 边下载边限制体积，单张超限立即中断，不会因为一张大图卡住整篇；
• 单张超时可控，慢站不会拖垮整篇处理；
• SVG 含脚本能力，可以单独关闭。

支持的编辑器

适配层按「先具体后通用」的顺序探测，认不出就退回兜底方案，不会因为某个编辑器版本差异整块失效。
回填统一以服务端改写结果为准（服务端同时认 Markdown 与 HTML），
所以富文本编辑器不需要另写一套替换逻辑。

Markdown 图片、HTML 的单引号 / 双引号 / 无引号 img 标签三种写法都能识别。

设置项

设置页顶部还有三项统计：已本地化图片张数、地址映射缓存条数、最近一次处理时间。

「已本地化图片」数的是本插件抓下来、此刻仍留在站点上的图片：同一张图用在多篇文章里只算一张，
在后台「资源」里删掉一张，这个数就跟着少一张。它不是从安装到现在处理过的总次数，
反复编辑同一批文章不会把数字抬高。

另有一个「清除地址映射缓存」按钮——清掉是安全的，插件会退回按文件名去资源库认图。

常见问题

抓取失败怎么办？

先切换设置里的「防盗链处理」，多数图床会校验来源，换成「携带图片所在站点的 Referer」即可。
若提示「远程内容不是图片」，说明对方返回的是错误页或防盗链提示图，插件会主动放弃。

保存变慢？

开启「保存时自动本地化」后，保存耗时会加上抓图时间。图片较多时建议只用一键按钮，处理过程是可见的。
插件已内置单张体积上限与超时，不会因为个别大图卡住整篇。

会不会重复下载同一张图？

不会，有两道保险：地址映射表记着「远程地址 → 本站地址」，同一个地址再来直接替换，不发请求；
即使映射表被清空，插件还会按远程原始文件名去资源库里认，找到同名且文件仍在的图片就直接复用。

为什么有的图转成了 WebP，有的没有？

转 WebP 是有条件的：格式得是 jpg / png / bmp、原图得大于 16 KB、转完至少得省下一成体积，
四个条件缺一个就保留原图。gif、webp、avif、svg 和动起来的 PNG 根本不参与转换。
明细里写着「已本地化（新体积，原图旧体积）」的就是压过的，只写一个体积的没压。
担心老浏览器不支持 WebP，可以在设置页把「保存时压缩图片（转成 WebP）」关掉。

我刚上传的图怎么没转成 WebP？

上传那条要单独开：设置页「上传时也压缩（转成 WebP）」默认是关闭的。
开着还没转，就是上面那几个条件没满足（格式、16 KB 门槛、至少省下一成）。
只有走上传表单的图片才会被处理，AI 生成图片那种由服务端直接落盘的不经过这一步。

图片没有出现在资源库？

正常情况下都会出现。如果 content/uploadfile 目录不可写，图片无法落盘，设置页顶部会给出提示。

单页（page）能处理吗？

可以。单页与文章都在内容落库后定向更新，推荐单页也用一键按钮处理，体验更直观。

删除插件会留下什么？

设置、映射缓存、统计全部存在核心的 Storage 里，不创建自定义数据表、不修改核心表结构，
删除插件时核心会自动清理这些记录。已经下载到 content/uploadfile/ 的图片属于站点资源，不会被删除，
可以在「资源」里自行管理。

核心特点
极简部署：单文件统计，5 分钟完成安装
基础数据：PV、UV、IP、来源、地区、设备统计
智能过滤：自动识别并过滤 AI 爬虫和搜索引擎机器人
多站管理：一个后台管理多个网站
数据安全：所有数据存储在自己服务器

本插件和Discuz应用中心那些积分充值等插件是有本质区别的，那些插件需要新增一个积分充值页面，而本插件是直接替换了DiscuzX 3.5自带的支付接口，所以Discuz自带的积分充值功能就可以直接调用本插件，邀请码购买也同样可以直接调用。

与DiscuzX 3.5自带的支付功能相比，有如下功能特点：

1、支持支付宝当面付与微信JSAPI扫码，原版不支持；

2、支持通过支付插件来扩展其他支付通道，原版不支持；

3、支持微信小程序支付接口，原版不支持；

4、针对手机端扫码支付进行了特别优化，可直接跳转APP支付；

5、支持订单原路退款功能，原版不支持。

6、新增商家转账

后台演示截图：

电脑端支付演示截图：

手机端支付演示截图：

使用方法：

环境要求 PHP >= 7.0，本插件只支持DiscuzX 3.5版本，上传到/source/plugin/目录后解压，在后台插件列表开启。

如需开启积分充值功能，还需要在【运营】-【电子商务】-【基本设置】里填写现金积分兑换比率。

如果后续因Discuz版本更新，导致插件部分文件被覆盖而功能失效，可尝试卸载重新安装插件（卸载插件不会影响到任何配置信息）。

更新记录：

V1.2：新增支付宝APP支付、JSAPI支付，新增微信和支付宝的APP支付接口。虎皮椒将2种支付方式分开了。

V1.3：修复支付宝偶尔失败的问题，更新虎皮椒PC支付流程

V1.4：支持微信支付V3接口的公钥模式

部署方法：

· 运行环境要求PHP7.4+，MySQL5.6+
· 设置网站运行目录为public
· 设置伪静态为ThinkPHP
· 访问网站，会自动跳转到安装页面，根据提示安装完成
· 访问 /admin 进入后台管理
· 需要对业务代码进行一定修改，具体可以点“帮助”按钮查看

更新日志：

V1.1
1、新增支付宝开放平台域名回调功能
2、新增企业微信token获取功能
3、简化后台帮助文档

V1.2
1、新增微信消息事件转发功能，同时支持微信公众平台与企业微信。

V1.3
修复一些微信消息转发功能的问题

V1.5
修复了一些已知问题

V1.6
新增支持支付宝第三方应用授权回调

V1.7
1、框架升级到ThinkPHP 8.1，要求最低PHP版本8.0
2、css、js静态资源本地化
3、增加QQ互联多域名回调

功能特点：

在线预览图片、视频、音频、文本文件、Markdown文件、Office文档等
自动识别目录下的README.md文件并展示（类GitHub）
后台管理可设置网站标题、公告、底部代码等信息
文件搜索功能，支持缓存文件索引
自带第三方文件管理器
支持中文文件名编码设置，解决乱码问题
支持安装在子目录

更新日志：

V1.7
css、js静态资源本地化，后台可选择使用CDN，增加WebDAV功能

V1.6：
1、新增VSCode在线编辑器，2种编辑器可自由切换
2、点击文件名可改为弹出文件操作窗口
3、可设置指定文件扩展名强制下载
4、支持更多压缩包格式解压

V1.5：
1、优化手机端搜索、文件信息展示、预览
2、优化音乐播放，支持按顺序播放当前列表音乐
3、新增文件列表翻页功能
4、支持搜索密码加密的文件夹

V1.4：修复静态资源失效

V1.3：增加文本在线编辑功能

V1.2：更新了全新的文件管理功能、支持设置目录密码访问

V1.1：优化文件列表表格样式

功能特性：

- 多用户管理，可为每个用户可分配不同的域名解析权限；

- 提供API接口，可获取域名单独的登录链接，方便各种IDC系统对接；

- 容灾切换功能，支持ping、tcp、http(s)检测协议并自动暂停/修改域名解析，并支持发送通知；

- 定时切换功能，设置在指定时间/周期，自动修改/开启/暂停/删除域名解析；

- CF优选IP功能，支持获取最新的Cloudflare优选IP，并自动更新到解析记录；

- SSL证书申请与自动部署功能，支持从Let's Encrypt等渠道申请SSL证书，并自动部署到各种面板、云服务商、服务器等；

- 支持邮件、微信公众号、Telegram、钉钉、飞书、企业微信等多种通知渠道。

演示截图

部署方法：

1、运行环境要求PHP8.0+，MySQL5.6+

2、设置网站运行目录为public

3、设置伪静态为ThinkPHP

4、访问网站，会自动跳转到安装页面，根据提示安装完成

5、访问首页登录控制面板

点点精灵是一款免费的 Windows 键鼠自动化工具。录制、回放、可视化编辑、屏幕识别—— 把每天重复的鼠标键盘操作，交给一个不知疲倦的小精灵。

脚本与逻辑

• 高精度录制回放，还原真实时序
• 循环 · 条件判断 · 变量与表达式
• 标签跳转 · 子程序 · 动作组
• 文本提取：从识别结果里挑出要的那段
• 多脚本标签并行运行
• 每个脚本独立热键、独立暂停

项目定位

祈福导航系统面向个人主页、团队资源导航和公开网址目录。系统提供响应式沉浸式前台、站点与分类运营、友链审核、广告位管理、在线统计、备份与维护等能力，并配套基于 Vue 3 与 Art Design Pro 深度定制的管理后台。

正式部署不依赖 Composer，也不要求服务器安装 Node.js。仓库已经包含编译后的后台静态资源，上传 PHP 程序并完成安装向导即可运行；只有二次开发后台界面时才需要 Node.js 与 pnpm。

• 三端响应式体验：前台与后台同时适配桌面、平板和手机，搜索、表格、表单和操作区会按屏幕宽度自动调整。
• 全新现代化后台：基于 Vue 3、Element Plus 与 Art Design Pro 深度定制，统一导航、表格、表单、通知和页面切换体验。
• 站点与分类运营：支持站点和分类的新增、编辑、排序、启停、批量操作、图标设置与网站信息自动获取。
• 本站资源搜索：可按名称、描述、分类、域名和链接实时筛选，并保留百度、Google、Bing 等外部搜索入口。
• 完整广告管理：支持搜索栏下方四个固定槽位以及 PC 左右悬浮广告位，可配置素材、链接、时间、排序、权重和开关。
• 广告效果统计：记录广告展示量与点击量，后台可查看各广告素材的实际投放数据。
• 友链申请与审核：前台提供友链申请，后台支持审核、拒绝和通过后直接加入导航。
• 访问与状态统计：支持匿名访问统计、演示数据规则、站点可用性、HTTP 状态码和响应延迟检测。
• 备份与恢复：提供数据库备份、恢复记录和操作反馈，升级前后可以更稳妥地保护业务数据。
• 安全在线更新：更新清单与安装包执行 Ed25519 签名、SHA-256、文件大小和版本校验，并支持维护状态、备份和失败回滚。
• 安装流程加固：完善环境检测、数据库连接、配置生成、安装完成页和异常提示，降低宝塔环境中出现空白页的概率。
• 安全能力升级：包含参数化查询、CSRF、防登录爆破、安全 Cookie、上传校验、SSRF 防护和后台目录改名支持。
• 登录与会话稳定性：修复登录跳转循环、异常错误提示和安装后后台空白，后台空闲有效期统一为 12 小时并增加安全保活。
• 站点批量运营：修复筛选时误改站点状态，新增批量修改站点归属分类功能。
• 分类数据一致性：分类状态默认开启且显示与实际值一致，分类改名后所属站点和前台同步更新。

• 沉浸式导航首页：支持自定义背景、LOGO、搜索引擎、本站搜索、快捷标签和响应式 H5 布局。
• 站点内容运营：管理站点、分类、排序和上下架状态，支持站点图标设置与网址图标获取。
• 分类视觉配置：提供彩色图标选择，并允许管理员补充自定义图标。
• 友链申请与审核：前台毛玻璃申请弹窗、提交反馈，以及后台审核和状态管理。
• 完整广告管理：搜索栏下方四宫格广告位，以及 PC 左侧、右侧独立悬浮广告位。
• 在线统计组件：支持真实匿名访客统计或按规则稳定生成的随机展示数据，并可选择暗色或高亮文字。
• 现代化管理后台：统一菜单、表格、表单、通知、页面渐入动画和移动端适配。
• 维护与升级：提供操作日志、备份、系统信息、在线更新检查和版本信息管理。
• 远程查询接口：保留完整远程查询、签名校验和匿名功能调用上报代码，专属凭据通过本地配置或环境变量注入。
• 安全加固：参数化查询、CSRF、登录限速、安全 Cookie、SSRF 防护、上传内容校验和后台目录改名支持。

一个人，把几十个闲鱼账号做成一门自动运转的生意。**

多账号统一托管，买家下单自动发卡密、自动确认收货、自动评价、自动求小红花、收货后自动致谢。
关键词和 AI 双层自动回复接住每一句咨询，商品与订单自动同步，滑块与人机验证自动处理。
从「盯着手机一个个回」变成「打开网页看数据」。

- 🏪 **多账号管理** — 扫码即接入，一个后台管完所有小号，逐账号独立配置策略
- 📦 **自动发货** — 卡密自动发出，支持多规格、多数量，发货前风险拦截
- 💬 **自动回复** — 关键词精确命中 + AI 议价，可设最低价与议价轮数，绝不越线让价
- ⭐ **买家互动** — 确认收货后自动评价、自动求小红花、自动发送致谢文本
- 🤖 **商品自动化** — 商品同步、素材库、定时擦亮、自动上下架
- 📊 **经营看板** — 成交额、到账、退款、订单和库存一屏掌握，**历史订单可一次性拉回**

## 核心功能| ------------------------------------------------------------------------------------- 
| 总览               | 汇总营收、账号、订单、卡密库存和运行状态
| 账号               | 扫码、密码或 Cookie 登录，资料同步，监听任务状态，暂停和自动回复配置
| 商品               | 从闲鱼同步商品，维护本地详情、图片、规格、数量和商品回复
| 商品自动化    | 商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务
| 订单               | 一键拉取闲鱼历史卖出订单，状态判定、详情补全、批量刷新、手动发货和异常保护
| 卡密               | 卡券分组、库存导入、状态管理、多规格和多数量发货
| 自动回复        | 账号关键词回复、默认回复和回复一次控制
| 人工智能回复 | 兼容 OpenAI 协议的大模型配置、上下文对话和测试
| 自动发货        | 全局、指定账号、指定商品三级发货规则及发货前风险拦截
| 消息管理        | 闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则
| 通知与日志    | 通知渠道、账号绑定、风险日志和系统日志
| 设置               | 管理员账号与改密、注册与邮箱验证开关、服务、备份及系统配置
| 公告与更新    | 从自建地址拉取公告与版本信息，首页横幅提示，「关于」页手动检查更新

## 界面预览

### 账号管理：一个后台管完所有小号

扫码添加账号，实时显示监听状态。每个账号可独立设置自动确认、人工接入暂停时长、
是否启用 AI 回复，互不干扰。

### 商品与发货：卡密自动发到买家手上

同步在售商品，逐个商品绑定发货内容，支持多规格和多数量。已下架的商品会被标记出来
并默认隐藏，不和在售的混在一起。

### 订单管理：接入前的历史订单也能一次拉回来

「拉取卖出订单」会把闲鱼上的历史订单整批同步进来，不只是接入之后的新单，
所以刚部署就能看到完整的经营数据。状态、买家、实付金额和发货情况一目了然，
支持按账号和状态筛选，也能手动发货或补发。

### 买家互动：确认收货后的动作全部自动完成

评价买家、索要小红花、发送收货致谢，三项都能逐账号开关。买家一确认收货，
致谢立即发出，评价和求花在订单状态就绪后自动执行。

### 消息中心：所有账号的会话在一个页面里

跨账号会话列表，支持搜索和筛选，可以直接接管对话。自动回复的每一次决策都有日志，
能查到为什么回了、为什么没回。

## 如何部署

> **⚠️ 请勿部署到 Hugging Face Spaces 等共享托管平台**
>
> 本项目内置反检测浏览器（Patchright）、验证码处理（CAPTCHA/Geetest）与 Telegram 通知等组件，
> 这类组合极易被共享平台判定为滥用（platform abuse），已有多起导致账号被封、其他 Space 受牵连的先例。
> 此外，海外出口 IP 也会显著增加闲鱼自有风控的触发概率。
> **推荐部署到本地设备、自有 VPS 或国内服务器。**

### 一条命令直接启动（最快，不用克隆仓库）

有 Docker 就能跑，不需要下载源码：

```bash
docker run -d --name xianyu-butler \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  -v $(pwd)/backups:/app/backups \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=改成你自己的密码 \
  --restart unless-stopped \
  ghcr.io/23star/xianyu-super-butler:latest
```

浏览器打开 `http://服务器IP:8080` 即可。数据都在当前目录的 `data` / `logs` / `backups` 里，
升级只需 `docker pull` 后重建容器，数据不丢。

Windows PowerShell 把 `$(pwd)` 换成 `${PWD}`，续行的 `\` 换成反引号 `` ` ``。

### Docker Compose（推荐长期使用）

```bash
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler
docker compose -f docker-compose.nas.yml up -d
```

同样是预构建镜像，不在本机编译任何东西，支持 amd64 / arm64。相比上面一条命令，
Compose 的好处是配置写在文件里、改起来清楚，升级也只有一行命令。

该配置不依赖 `.env`，管理员账号密码在 `docker-compose.nas.yml` 里的 `CHANGE_ME` 处直接改。

### NAS 与低配设备（飞牛 fnOS、群晖、威联通、软路由、低配 VPS）

**用上面那条命令，不要本地构建。**

`npm ci`、前端打包、Python 依赖编译和 Chromium 下载会同时抢占 CPU 和内存，
轻则卡十几分钟，重则内存不足被杀，反复重启表现为「装不上、机器卡死」。
预构建镜像已同时提供 amd64 和 arm64，绕开全部编译步骤。

```bash
docker compose -f docker-compose.nas.yml up -d
```

飞牛 fnOS、群晖等图形界面的 Docker 通常没地方放 `.env`，所以这份配置把变量直接写在
compose 文件里，改完 `CHANGE_ME` 就能用。

### Docker 本地构建（需要改代码时）

```bash
cp .env.example .env          # 不改也能启动，此时使用默认密码
docker compose up -d --build
```

国内网络用 CN 配置（apt、pip、npm、Chromium 全部走国内镜像）：

```bash
docker compose -f docker-compose-cn.yml up -d --build
```

可选 Nginx：`docker compose --profile with-nginx up -d --build`

### 源码运行（开发调试）

需要 Python 3.11+、Node.js 20+、npm。

```bash
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
playwright install chromium

cd frontend && npm ci && npm run build && cd ..
python Start.py
```

### 访问

- 管理页面：`http://localhost:8080/`
- API 文档：`http://localhost:8080/docs`
- 健康检查：`http://localhost:8080/health`

默认管理员 **admin / admin123**，登录后请在「设置 → 账号与同步 → 修改登录密码」立即改掉。

数据持久化到 `./data`（数据库）、`./logs`（日志）、`./backups`（备份）。

### 更新

```bash
# 预构建镜像（推荐方式对应的更新命令）
docker compose -f docker-compose.nas.yml pull && docker compose -f docker-compose.nas.yml up -d

# 本地构建
git pull && docker compose up -d --build
```

> **滑块与人机验证、部署失败排查、使用流程** 见 [docs/deployment.md](docs/deployment.md)。
> 自动过滑块受平台风控限制不保证成功，自动失败时可在账号页转人工验证。