提交 BUG / 意见和建议

一句话

用着不对劲、或者想要某个功能，都到这里提：

👉 https://qji.io/bug

提交后会有人看，不需要注册账号。

先花 30 秒自查一下

有一多半的"BUG"其实是这三种，自查比等回复快得多：

现象	先试试
后台改了，前台没变	强制刷新（Ctrl+F5 / Cmd+Shift+R），再等 1 分钟
页面显示不对、按钮点不动	换无痕窗口打开，排除浏览器缓存和插件
某个功能"没反应"	看看对应的功能开关是不是关着（站点设置 → 功能开关）

还不行再提，见 出问题了怎么办。

⭐ 怎么写一个能被修的 BUG

只写「XX 坏了」基本修不了

不是不想修，是重现不出来。同一个页面在不同数据、不同设备、 不同配置下表现完全不同 —— 收到「订单页有问题」这种描述， 对方只能反过来问你一堆问题，一来一回就是好几天。

把这三句话写清楚，效率能差十倍：

1. 我做了什么   → 在「订单管理 → 订单列表」点了某一单的「发货」
2. 我以为会怎样 → 弹出填运单号的框
3. 实际怎样     → 按钮点了没反应，页面也没报错

再加上这几样，基本一次就能定位：

附上	为什么有用
截图（整个浏览器窗口，别只截一小块）	边上的菜单、地址栏、报错提示往往就是线索
时间（几点几分，说清楚是哪个时区）	服务器日志按时间查
订单号 / 商品 ID	能直接查到那条数据
手机还是电脑、什么浏览器	很多问题只在某一种上出现

能重现的话，写清楚重现步骤

「每次都这样」和「昨天出现过一次」是两种完全不同的问题， 前者当天就能修，后者可能要等到再次发生。说清楚是哪一种。

控制台报错（会的话）

按 F12 → 切到 Console 标签 → 把红色的那几行截图。 这一步能省掉一半的排查时间。不会弄就跳过，不影响提交。

提建议也一样

说「你遇到的问题」，别只说「要什么功能」

• ❌ 「加一个批量改价功能」
• ✅ 「我有 200 个商品，换季要统一打八折，现在得一个个点进去改， 一下午改不完」

后者更容易被做，而且往往会做出一个比你想的更好用的东西 —— 比如上面这个需求，做成「按分类批量打折」比「批量改价」省事得多。

这几种情况别走这里

买家的问题 → 客服工单

买家收不到货、要退款、问尺码 —— 那是 客服工单， 不是这里。这个页面是给你（店主）反馈系统本身的问题用的。

网站完全打不开、支付收不到钱 → 先自救

这类事情等回复来不及。先看 出问题了怎么办， 里面有立刻能跑的排查命令。

自救之后再来提，把当时的现象一并写上。

千万别在反馈里贴这些

• 密码、API Key、.secrets.json 的内容
• 买家的完整邮箱、电话、地址

截图前先把这些遮掉。需要举例的话，订单号和商品 ID 就够了 —— 那两个不算敏感信息。

提交之后

会有人看，但不保证每条都回复。

想提高被处理的优先级

• 影响下单收钱的 > 影响后台操作的 > 显示不好看的，说清楚属于哪一类
• 附上重现步骤的，基本都会被优先处理 —— 因为能立刻验证
• 同一个问题不用反复提，多提几次不会更快