快速上手
发布包解压即用，三步装完一个站，全程不重启。
1
启动发布包
下载对应平台发布包（windows-amd64 / linux-amd64 / linux-arm64），解压后直接运行 qipai.exe（Windows）或 chmod +x qipai && ./qipai（Linux）。
2
打开 /install 完成安装
浏览器打开 http://你的域名/install，填写数据库连接与后台管理员账号（密码至少 6 位），按需勾选「演示数据」。程序自动建库、导表、写回配置并加锁。
3
接上 AI 开始干活
后台「智能与接入设置」选择 AI 引擎并填入密钥；再用一条 URL + 一个 Token 把站点接入你的 AI 客户端。
Q装完之后再访问 /install 会怎样？
会自动跳转回管理后台，不会重复安装。安装状态记录在
storage/data/installed.lock，如需重装请先清空数据库并删除该锁文件。Q没有独立数据库服务器可以装吗？
可以，安装页填本机 MySQL 连接即可。系统在安装时自动建库导表，不需要提前手工建库。
Q管理后台和前台站点的地址分别是什么？
管理后台
/system/，前台站点 /。多站点模式下，前台按域名自动解析对应子站。账号与登录
会员账号用于购买模板与插件、管理订阅与下载；后台管理员账号在安装时创建，两者相互独立。
Q怎么注册会员账号？
打开登录页切换到「注册」标签，填写邮箱与密码（至少 6 位）即可。注册成功赠送 100 积分，可直接用于资源兑换。
Q有没有演示账号可以先体验？
有。演示账号
demo@tradeadmin.com，密码 123456，登录页有「一键填入」按钮。演示账号含订阅、订单、积分、下载记录等完整示例数据。Q忘记密码怎么办？
在登录页点击「忘记密码」，通过注册邮箱接收验证邮件后重置。生产环境需先在后台「邮件设置」配好发信通道。
Q会员账号和管理员账号是一回事吗？
不是。管理员账号管理站点（后台
/system/，JWT + casbin 权限体系）；会员账号是前台消费者身份，用于购买资源、订阅、积分与交易。订阅与续费
订阅方案见订阅定价页，支持按年或按月付费，年付更划算。
Q订阅到期后，已下载的资源还能用吗？
能。已购资源是永久权益，到期后仍可从下载记录重新下载；只是不能再下载新的付费资源，也无法继续享受订阅期内的更新推送。
Q开启自动续费后如何取消？
进入我的订阅，关闭「自动续费」开关即可，当期权益不受影响，到期后不再扣费。
Q中途升级方案，费用怎么算？
升级按剩余天数折算差价，权益立即生效且到期时间从原到期日顺延，不会重置。续费同理：在到期前续费，新周期叠加在原到期时间之后。
Q订阅和买断有什么区别？
订阅期内可下载全部在售资源并持续获得更新；单个模板/插件也可以单独购买获得永久权益，适合只需要个别资源的用户。
支付与退款
所有订单与流水可在支付记录中查询，支持按状态、类型与时间筛选，并可导出 CSV。
Q支持哪些支付方式？
支付宝、微信支付、QQ 支付，支付网关在后台开箱可配。使用现金支付还可获得积分返还（按支付金额 10 倍计）。
Q下单后未支付，订单会怎样？
订单保持「待支付」状态，可随时在支付记录中继续支付或主动关闭；超时未支付的订单会自动关闭，不占用权益。
Q退款规则是什么？
已支付订单支持 7 天内申请退款：进入支付记录打开订单详情，点击「申请退款」即可。退款按原路退回，同时回收对应资源权益。使用余额支付的订单，退款金额退回余额；重复退款会被拒绝。
Q支付成功了但权益没到账怎么办？
先刷新会员中心确认；若仍未到账，在支付记录里找到对应订单核对状态，若显示已支付但权益缺失，请联系客服并提供订单号，人工补发不影响后续下载。
积分与余额
积分与余额的收支明细（含变动后结余）都在积分余额页。
Q积分怎么获得？
四个渠道：新注册赠送 100 分；每日签到；现金支付按金额 10 倍返还；或直接购买积分包。所有变动都有流水记录可查。
Q积分能干什么？
在模版市场与插件市场可以直接用积分兑换付费资源，兑换成功即获得与购买一致的永久权益。
Q余额怎么充值？能退款吗？
在积分余额页选择充值金额，通过支付宝或微信支付完成充值。余额充值后不支持提现，但可用于下单支付；用余额支付的订单退款时，金额退回余额。
Q余额和积分优先用哪个？
下单时可自选支付方式：余额、积分或在线支付。余额不足时会明确提示并阻止下单，不会出现部分扣款。
模板与插件
模板与插件都在站内市场购买或兑换，下载与更新通过下载记录统一管理。
Q模板怎么安装到我的站点？
下载得到主题包后，在后台「模板设计」上传即可；也可以直接解压到
resource/template/<主题名>/。内容分类可在后台绑定独立的列表与详情模板。Q插件放在哪里才会被识别？
放进
resource/addons/<name>/ 即被自动发现并安装，也可在后台上传 zip。插件独立进程运行，崩溃不牵连宿主，语言不限（Go / Node / Python / PHP）。Q已购资源丢了或换了服务器怎么办？
登录后在下载记录点击「重新下载」，已购权益永久有效、不限次数。
Q免费资源需要付费吗？
不需要。免费模板与插件在市场页直接点击下载即可；部分资源对订阅会员免费、非会员收费，卡片上会标注。
AI 引擎与 MCP
接入类问题（接口地址、Token、智能体、技能包）都在这一节，协议细节见MCP 接入指南。
QAI 引擎支持哪几家？怎么切换？
OpenAI 兼容接口、Anthropic Messages 协议、讯飞星火三选一。在后台「智能与接入设置」里切换引擎会自动带出官方地址与默认模型，只需补密钥。接上后 AI 写作、翻译、TDK 生成等功能全部生效，不用再配第二处。
QAI 客户端（Claude / Cursor / WorkBuddy）怎么接入我的站点？
后台 MCP 设置里按客户端「一键复制配置」，粘进客户端的配置文件即可 —— 一条 URL + 一个 Token。接入后可读写内容、分类、附件、SEO、统计与设置，共 113 个工具、10 个分组。
Q智能体怎么创建？跑挂了能查吗？
在 AI 客户端里建一个智能体：一条「执行策略 + Cron 表达式」。每次执行都有状态、摘要和完整会话记录，跑没跑成、跑了几次、上次干了什么一屏看得到，失败可以追。
Q技能包从哪里来？
技能是磁盘上的能力包（
resource/skills/<name>/SKILL.md），写法与安企一致，第三方现成技能包拷进来就能用，也可以让 AI 从 zip 或网址直接安装。支持搜索与热重载，插件还能自带技能。QMCP 调用安全吗？
每个 Token 可单独设置调用频率与日额度，每次调用都留一行审计日志：谁、什么时候、调了哪个工具、改了什么，都可追溯。
疑难排查
按现象对号入座。仍未解决时，可通过后台「文档中心 → API 文档」核对接口行为，或联系我们。
Q前台页面样式不对或模板没生效？
依次检查：内容分类是否绑定了正确的列表/详情模板；是否开启了静态缓存（后台「静态缓存」清空后重试）；模板里标签拼写与大小写是否正确。结构化数据由系统自动注入，模板里不需要手写 JSON-LD。
Q伪静态切换后出现 404？
后台「SEO 设置 → 伪静态」提供五种方案，切换后先用页面上的规则校验与预览确认 URL 形态，再检查 Web 服务器的 rewrite 配置是否指向入口文件。
Q登录后台提示密码错误或被锁定？
连续失败会触发同 IP 频控（内容安全设置），稍等后再试。仍无法登录时，通过「登录日志」核对失败记录；管理员密码可通过数据库重置或由其他超管账号协助修改。
Q翻译日志报错或翻译没生效？
文本翻译按 md5 缓存，先确认目标语言是否已建多语言站点；查看「翻译日志」确认调用是否留痕与报错信息。整页翻译依赖 AI 引擎连通性，可在引擎配置里点测试。
Q插件启动失败或崩溃了？
在「插件管理」查看状态与日志。插件是独立进程，崩溃不影响宿主；先确认
resource/addons/<name>/ 目录结构完整、运行语言环境可用，再重启该插件。Q网站被恶意采集或刷留言怎么办？
打开三层防护：防采集设置、请求限流（前台频率限制与 IP 封禁）、内容安全（验证码、同 IP 提交与留言间隔、UA 与 IP 限制），评论与留言另有 Akismet 反垃圾兑底。