报告问题:分类、随附上下文与助手
“报告问题”界面发送一份缺陷报告,随附一段实测的技术上下文(版本、操作系统、打开的模块、数据源、最近的错误行),并在你发送之前把它展示出来。它不需要登录会话,也不需要 AI 密钥;侧边助手只是帮你把描述写清楚。
Senzoukria · 文档 · 更新于 2026 年 9 月
位置
- 位置
- 菜单 → 报告问题,或 设置 → 关于 → 报告问题 →
- 路由
- /report,未登录也可访问
- 接口
- POST https://senzoukria.com/api/report,15 s 超时
- 默认分类
- 由你离开的模块推断(图表页面 → 图表与指标,Trading → 经纪商连接,其余为 其他)
它做什么
界面由一个表单和一个侧边栏组成。表单收集分类、标题、描述和一个可选的回复地址。技术上下文不需要你填写:它由应用实测并列在发送按钮旁的“随附技术上下文”区块中,因此离开这台电脑的内容在离开之前就是可见的。清单显示应用版本、操作系统、界面语言、打开的模块、经纪商与环境一行、最近的错误行以及回复地址(某一行显示短横线表示该行不发送任何内容)。
发送绝不会无声失败。网络故障会说明什么都没有发出,并提供“重试”;HTTP 429 会说明这台电脑发出的报告过多,请等待几分钟。两种情况下表单都保留已填内容。发送成功后界面显示“报告已发送”和一个请你保存的参考编号,以及一个“再发一份报告”的按钮,它会清空标题和描述,但保留邮箱地址。
字段与分类
| 字段 | 默认值 | 作用 |
|---|---|---|
| 受影响的部分 | 根据最后打开的模块预选;否则为 其他 | 决定报告的流向。经纪商连接、市场数据、账户与许可证以 blocking 严重级发送;图表与指标、脚本、回放与回测以及其他以 normal 严重级发送 |
| 标题 | 空,必填 | 一行,凭据会被脱敏,截断到 160 个字符 |
| 发生了什么 | 空,必填,显示 9 行 | 自由文本,会被脱敏,截断到 8 000 个字符。提示语要求写明你做了什么、你预期什么、实际发生了什么 |
| 你的邮箱 — 可选 | 空 | 仅在问题修复后用于回复你。点击“再发一份报告”时保留。会校验明显的拼写错误,截断到 200 个字符 |
| 随附技术上下文 | 折叠;点击“查看随附内容”展开 | 展示序列化进请求里的那份诊断包,一字不差 |
随附什么,剔除什么
诊断包包含应用版本、平台、界面语言、打开报告界面之前最后访问的模块路径、数据源偏好(Rithmic 直连、NinjaTrader 或 Quantower)、每个活动连接的一行摘要,以及最多五条最近的错误行。错误行来自未处理的 Promise 拒绝和未捕获的错误,而不是控制台输出,每条截断到 240 个字符。
每一个文本字段,包括你输入的标题和描述,在进入请求体之前都会经过与崩溃报告相同的脱敏器。它会屏蔽 AI API 密钥、Bearer 与 Basic 令牌、Windows 与 Unix 用户路径、电子邮件地址,以及诸如 password、token、api_key、user_id、username、login 或 account 之类的键值对。回复地址是唯一一个有意的例外,因为那是你为了被联系而填写的。余额、持仓和盈亏从不被读取。
助手面板
右侧的助手会做一次简短的问询:你观察到什么、你预期什么、复现步骤,以及涉及的模块。集齐这些之后它写出一份报告,并提供“用作描述”,该操作会把文本追加到你已输入的内容之后,而不是替换它。它从不询问版本或操作系统,因为这些会自动随附。三条建议提示可以开启对话:连接之后图表一直是空的、帮我把这个 bug 描述准确、我应该附上哪些细节?
只有当存在能够作答的引擎时,面板才会打开:存放在操作系统钥匙串中的你自己的 Claude API 密钥,或一个可访问的本地引擎。你可以通过粘贴、拖放或文件选择器附上最多三张截图;本地引擎不读取图片,因此附件会被立即拒绝。警告会提醒你,截图会暴露你的余额和持仓,请先裁剪再附上。“清空对话”会重置面板。表单本身从不需要任何密钥。
局限与陷阱
- 即使应用的其余部分已经出问题,报告界面依然能打开;每一项上下文都是独立采集的,缺少其中一项不会阻止发送。
- 发送后显示的参考编号是再次找到这份报告的唯一途径;应用内没有历史报告列表。
- 分类不限制你写什么,但它决定严重级和流向,因此请选最接近的那一个。
- 助手的对话历史只属于这个面板,与其他助手相互独立。
相关页面
其他语言版本
常见问题
- 发送报告需要账户或 AI 密钥吗?
- 不需要。该路由在未登录时也可访问,表单不带任何密钥即可提交。只有侧边助手需要钥匙串中的 Claude 密钥或一个可访问的本地引擎,而且它只限制自己。
- 我的经纪商登录名或账号会进入报告吗?
- 文本字段和错误行在发送前都会经过凭据脱敏器,余额、持仓和盈亏从不被读取。可选的回复邮箱是唯一的可识别字段,它按你输入的原样保留,因为那是你要求被联系。
- 如果发送失败会怎样?
- 表单保持已填状态,并显示具体消息:服务器不可达(什么都没有发出)并附带“重试”按钮,或者这台电脑发出的报告过多(请等待几分钟)。返回成功但响应体不可读时仍算已发送,只是没有参考编号。