codex-proxy-rs/.github/ISSUE_TEMPLATE/api-bug-report.yml

name: 接口问题反馈
description: 客户端调用模型、搜索等 API 时的报错、断流、超时或响应异常
body:
  - type: markdown
    attributes:
      value: |
        管理端页面、账号导入或服务部署的问题请选择“常规问题反馈”；新增能力请选择“功能建议”。
        请提供最小复现信息。请求、日志和截图发布前请移除密钥、令牌、Cookie、代理认证及私人内容。

  - type: textarea
    id: description
    attributes:
      label: 问题描述
      description: 说明发生了什么、实际结果以及出现的频率；已有正常账号、模型或客户端的对照结果也可说明。
    validations:
      required: true

  - type: input
    id: version
    attributes:
      label: 服务版本
      description: 填写实际运行的完整版本号，不要只写“最新”或 latest；源码运行填写提交号。
      placeholder: 完整版本号或提交号
    validations:
      required: true

  - type: dropdown
    id: deployment
    attributes:
      label: 部署方式
      options:
        - Docker Compose
        - 其他容器部署
        - 二进制运行
        - 源码运行
        - 其他方式（请在环境信息中说明）
    validations:
      required: true

  - type: textarea
    id: environment
    attributes:
      label: 环境信息
      description: 填写服务端与客户端的操作系统及版本；性能或超时问题可补充 CPU、内存和容器资源限制。
      placeholder: |
        服务端操作系统与版本：
        客户端操作系统与版本：
        相关资源限制（如有）：
    validations:
      required: true

  - type: input
    id: client-name
    attributes:
      label: 客户端名称
      description: 区分 CLI、桌面端、编辑器扩展、SDK 或自编脚本。
      placeholder: 例如 Codex CLI、Codex Desktop 或某个编辑器扩展
    validations:
      required: true

  - type: input
    id: client-version
    attributes:
      label: 客户端版本
      description: 填写完整版本号；Codex CLI 可填写 codex --version 的输出。无法取得时说明原因。
      placeholder: 完整版本号或相关 SDK 版本
    validations:
      required: true

  - type: input
    id: client-source
    attributes:
      label: 客户端安装来源与启动方式
      description: 说明安装来源，以及是否通过包装脚本、启动器或第三方修改版运行；不确定时填写已知部分。
      placeholder: 例如通过 npm 安装 @openai/codex，直接执行 codex
    validations:
      required: true

  - type: input
    id: endpoint
    attributes:
      label: 请求方法与端点
      description: 填写发生异常的请求方法与路径，无需真实域名；不清楚端点时说明客户端当时执行的具体操作。
      placeholder: 例如 POST /v1/responses、POST /v1/alpha/search 或 WebSocket /v1/responses
    validations:
      required: true

  - type: dropdown
    id: intermediary
    attributes:
      label: 是否经过中转或反向代理
      description: |
        指客户端到本服务之间的链路。API 中转包括 New API、One API、CCH 等；反向代理或 CDN 包括 Nginx、Caddy、Cloudflare Tunnel 等。
        如有中转，请在下方填写链路详情；本服务到上游的出站代理请在补充信息中说明。
      options:
        - 否，直接连接本服务
        - 是，仅经过 API 中转服务
        - 是，仅经过反向代理或 CDN
        - 是，同时经过 API 中转和反向代理或 CDN
        - 不确定
    validations:
      required: true

  - type: textarea
    id: request-chain
    attributes:
      label: 请求链路
      description: |
        按调用顺序填写中间服务的名称与版本，例如：Codex → New API → Nginx → 本服务。不确定时填写已知部分。
        如果已测试过直连本服务，请说明是否仍能复现；未测试可注明，不要求先完成对照测试。
      placeholder: |
        调用顺序与各中间服务版本：
        是否启用请求参数或请求头改写（如已知）：
        直连本服务的对照结果（如已测试）：

  - type: textarea
    id: account-model
    attributes:
      label: 平台、账号类型与模型
      description: 填写与失败请求相关的信息，不要提供账号凭据；不涉及模型或无法确认的信息请注明。
      placeholder: |
        平台与认证类型：
        账号套餐（如相关）：
        请求模型与映射后的上游模型（如已知）：

  - type: textarea
    id: reproduction
    attributes:
      label: 复现步骤
      description: 描述触发问题的操作；无法稳定复现时，说明已知触发条件。
      placeholder: |
        1. 使用什么配置或输入
        2. 执行什么操作
        3. 出现什么结果
    validations:
      required: true

  - type: textarea
    id: expected-behavior
    attributes:
      label: 预期行为
    validations:
      required: true

  - type: textarea
    id: request-response
    attributes:
      label: 请求、响应与诊断附件
      description: |
        提供脱敏后的最小请求、网关实际状态/响应片段和客户端显示，区分上游、中转、网关与客户端的错误来源。
        可在此直接上传管理端默认诊断包并检查其缺失说明；原始错误与日志片段需另行审阅脱敏，粘贴时请使用 Markdown 代码块。
        按部署文档的“请求错误排查”检查关联 ID、错误详情与 application 日志，不默认开启完整 dump；无法取得的信息请注明。
      placeholder: |
        发生时间与时区：
        传输（HTTP JSON / SSE / WebSocket）：
        脱敏后的最小请求：
        网关关联 ID（x-gateway-request-id；配置的入口头请单独注明）：
        上游关联 ID（x-request-id / x-oai-request-id，注明来源）：
        网关实际状态、Content-Type 与响应片段：
        中转服务的状态与错误（如有）：
        客户端显示的错误：
        诊断包或无法取得的信息：

  - type: textarea
    id: additional-context
    attributes:
      label: 补充信息
      description: 最近有升级时填写升级前后版本及前后端是否同步更新；网络问题补充出站代理、系统代理、TUN 和自定义证书等相关环境。
      placeholder: |
        服务或客户端升级前版本 → 当前版本（如有）：
        服务前后端是否同步更新（如有升级）：
        最近的配置变更：
        其他相关环境：