使用说明
从部署到精通的完整手册。左侧目录可快速跳转。
01快速上手
发卡机器人有两种运行方式，任选其一（也可同时备用）：
方式 A：框架插件版（推荐）
- 支持 MyQQ、小栗子（Qstar）、萌QNT 三款 QQ 框架。
- 把插件 DLL 放进框架的插件目录，在框架里启用插件，机器人 QQ 登录框架即可。
- 萌QNT 与小栗子一样必须使用插件 DLL，区别是它是走 OneBot 协议，
还需在「系统设置」里填 OneBot 的 WebSocket 地址（默认
ws://127.0.0.1:3001）与 Token。 - 首次启动出现闪屏进度界面，解压完成后自动弹出管理面板。
方式 B：OneBot 独立版
- 直接运行
faka_bot.exe独立程序，配合 NapCat 等 OneBot 11 实现使用，不需要萌QNT 等任何 QQ 框架。 - 独立版同样走 OneBot 协议：在「系统设置」里填 WebSocket 地址
（默认
ws://127.0.0.1:3001）与 Token，保存即自动连接。
授权
- 启动后弹出登录窗口，使用发卡网会员账号登录授权。
- 未登录时机器人处于休眠等待状态，点「设置」可随时唤起登录窗。
02基础配置
全部配置在管理面板的「系统设置」页完成，保存即生效，无需重启。
| 配置项 | 说明 |
|---|---|
| 卡网地址 / 卡网密钥 | 异次元发卡网的站点地址与通讯密钥 （站点后台 → 插件 → QQ/微信机器人 里查看）。保存时会自动验证连通性。 |
| 发卡机器人 | 作为售卡机器人的 QQ 号（框架里登录的那个）。 |
| 主人账号 | 管理员 QQ，收订单失败告警、结算通知等。 |
| 支付平台 | 选择 Epay（易支付/xpay）等收银台， 发卡网设置平台信息这里只需选择即可。 |
| 支付方式 | 下拉选择收款渠道（微信/支付宝），选项实时来自卡网。 |
| 支付超时 | 订单等待支付的秒数，超时自动取消。 |
03买家指令
买家私聊机器人（或在开启了购卡功能的群里）发送以下指令：
| 指令 | 作用 |
|---|---|
激活 | 新买家首次使用，自动注册卡网账号 |
余额 | 查询卡网账户余额 |
商品 / 新品 | 查看在售商品列表 |
搜索 关键词 | 按关键词搜索商品 |
序号#数量 | 购买，如 6#1 表示买 6 号商品 1 件；
余额不足自动发起扫码补差 |
取消订单 | 取消当前待支付订单 |
账单 | 用户查询详细账单；开启对账的代理会同时发起结算 |
充值 | 自助充值余额（生成收款二维码） |
04AI 智能客服
内置 AI 客服，在面板「AI管家」页配置，保存即时生效。全部接入平台均可免费使用， 注册拿到 API Key 填上即可。
接入平台
- 支持 智谱、硅基流动、魔搭、OpenRouter 以及 自定义（任何 OpenAI 兼容接口），全部有免费额度。
- 多平台可逐行开关、按顺序自动切换：某个平台当天调用异常会自动熔断， 换下一个平台顶上。
- 配好后点「测试连接」会真实调一次接口验证，通了再投入使用。
接待规则
- 私聊主动答疑；群聊只回复 @机器人 的消息，不会在群里刷屏。
- AI 实时读你的商品库：报价、查详情、报库存都能答；买家让 AI 帮忙下单时 走的是和手动下单完全相同的真实流程。
- 回复前先发「AI正在努力思考中…」提示（支持动图的框架会发思考动图）， 答完自动撤回。
知识库投喂
- 「AI管家」页可投喂问答对：买家原话与「问」完全一致时直接作答、不调 AI； 不完全一致时作为知识注入给 AI 参考。
- 每条知识可选范围：全局（处处生效）、单QQ（只答该买家私聊）、 群聊（只在指定群生效）。
主人特权
开启后主人号私聊机器人时，可用自然语言指挥 AI：投喂知识库、改客服设置、 查商品、改价、上下架等（主人指令仍然优先，特权只在私聊生效）。
05代理账单与自动结算
这是「先提货、后结账」的赊账体系，专治每天对账催款的痛点。
开启对账
- 在「用户管理」列表点目标用户的对账列开关，弹出设置浮窗： 信用额度、结算方式（周期 / 触发金额）、结算时间、收款支付方式、强制结算。
- 开启后该代理出现在「代理账单」页，显示余额、额度、欠款（欠款=额度−余额）。
两种自动结算模式
| 模式 | 触发逻辑 |
|---|---|
| 周期结算 | 勾选星期几 + 填时间（如 每周一三五 10:30）， 到点只要欠款大于 0 就自动向代理发起收款。 |
| 触发金额 | 当天没勾周期时，欠款达到触发金额立即自动发起结算， 防止欠款滚大。 |
强制结算
开启后，发起结算的同时自动限制该代理提卡，付清欠款后自动恢复。 代理不结账就不能继续拿货，彻底杜绝拖欠。
手动结算
「代理账单」页点行内结算立即发起；点账单查看自上次结算以来的 明细流水（可复制全部）。
06群管功能
面板「群管」页选中机器人和群，勾选分群开关后该群的群管功能生效。
黑白名单
- 分群名单只作用于本群，全局名单所有群共用。
- 指令：加黑/删黑/查黑、加白/删白/查白、全局加黑/全局删黑等，
支持
批量加黑 QQ,QQ,QQ一次多个。 - 开关：被踢拉黑（被踢出群自动进黑名单）、退群拉黑、拒绝黑名单进群 （申请直接拒绝/进群后秒踢）、白名单跳过发言检测。
进群验证
有人申请进群时可自动同意 / 拒绝 / 忽略，可按昵称、签名、QQ 等级、 是否已在指定群等条件过滤，拒绝理由可自定义。
违禁词与名片
- 违禁词命中自动撤回，可配置禁言、踢出、累计处罚。
- 名片管理：强制统一名片格式、改名片提醒、人数控制（满员自动审批策略）。
数据统计
「群管 → 数据」页按天查看各群的发言人数/条数、入群/退群/被踢人数。
07更新转发
监控上家的群或好友，把符合条件的消息自动转发到你的群/好友。
- 「更新转发」页添加规则：监控群号/QQ → 转发群号/QQ，状态开关即时生效。
- 支持关键词过滤（只转含关键词的）、过滤词（剔除广告尾巴）、 最小/最大行数（太短的闲聊、太长的刷屏都不转）。
- 支持关键词替换与转发模板：把上家的联系方式换成你的， 套上自己的公告头尾。
- 图片、语音、链接、公告、文件、视频均可随文字一并转发（可按需开关）。
08定时任务
- 「定时任务」页添加群发广告：选择发送对象（多个群/好友）、填写内容、 设置时间（几点几分）或间隔（每隔多少分钟）。
- 支持图文混发；任务可随时停用/启用/删除。
- 币价播报等内置任务也在此处统一管理。
09管理面板
面板页签一览：
| 页签 | 用途 |
|---|---|
| 商品管理 | 同步卡网商品、改价、上下架、批量加卡 |
| 用户管理 | 查用户余额/等级、充值、改代理等级、对账开关、实时搜索筛选 |
| 订单管理 | 卡网订单查询、手动补发货 |
| 代理账单 | 赊账额度、欠款、自动/手动结算 |
| 更新转发 / 定时任务 | 见对应章节 |
| 群管 / 功能管理 | 群管配置与各业务模块开关 |
| AI管家 | AI 客服平台配置、知识库投喂、主人特权、测试连接 |
| 系统设置 | 卡网对接、支付平台、机器人/主人账号 |
| 日志 | 运行日志实时查看（自动刷新、复制、清空） |
10常见问题
提示「卡网未配置/连接失败」
检查系统设置的卡网地址与通讯密钥；保存时会做连通验证，验证不过不会落盘。
下单报「请选择支付方式」
站点支付渠道 ID 变更过。机器人已内置自愈：自动按渠道代码重新对号并重试； 老版本请到系统设置重新选择一次支付方式并保存。
二维码被风控
让买家先发送「取消订单」再重新下单，系统会自动换码重试（前提是你已经配置多个收款码）。
启动报 E21（配置校验未通过）
配置文件被外部改动过。确认是你自己改的，在登录窗口选择「以当前配置为准」 重新封印即可。
面板打不开 / 没窗口
先查 8765 端口是否被占用（被占会自动顺延端口）；框架模式下框架关窗只是隐藏， 从插件菜单点「设置」可重新唤起。