webnovel-writer/.github/ISSUE_TEMPLATE/bug_report.yml

name: Bug 反馈
description: 反馈命令、Agent、数据链或 Dashboard 中可复现的问题。
title: "【Bug】"
labels: ["bug"]
body:
  - type: markdown
    attributes:
      value: |
        感谢帮助改进 Webnovel Writer。请尽量提供可复现信息；如果涉及小说正文、API Key 或个人数据，请先脱敏。
  - type: textarea
    id: summary
    attributes:
      label: 问题概述
      description: 简短说明发生了什么。
      placeholder: "例如：执行 /webnovel-write 12 后 review-pipeline 通过，但没有生成 CHAPTER_COMMIT。"
    validations:
      required: true
  - type: dropdown
    id: area
    attributes:
      label: 影响范围
      description: 请选择问题涉及的模块。
      multiple: true
      options:
        - Claude Code Skill 命令
        - Python CLI
        - Story System / CHAPTER_COMMIT
        - RAG / reference search
        - Dashboard
        - Agent 提示词 / 工作流
        - 模板 / 题材画像
        - 文档
        - 其他
    validations:
      required: true
  - type: input
    id: command
    attributes:
      label: 触发命令或入口
      description: 是哪个命令触发了问题？
      placeholder: "/webnovel-write 12 或 python -X utf8 ... webnovel.py preflight"
  - type: textarea
    id: reproduce
    attributes:
      label: 复现步骤
      description: 请写出最小、稳定的复现步骤。
      placeholder: |
        1. 使用 ... 安装插件
        2. 在 ... 项目中执行 ...
        3. 看到 ...
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: 预期行为
      description: 正常情况下应该发生什么？
    validations:
      required: true
  - type: textarea
    id: actual
    attributes:
      label: 实际行为
      description: 实际发生了什么？如有报错或日志，请贴出关键片段。
    validations:
      required: true
  - type: textarea
    id: environment
    attributes:
      label: 运行环境
      description: 请补充版本和平台信息。
      value: |
        - 操作系统：
        - Python 版本：
        - Claude Code 版本：
        - 插件版本：
        - 安装范围：user / project
    validations:
      required: true
  - type: input
    id: model
    attributes:
      label: 使用模型
      description: 请填写触发问题时使用的模型名称；不确定时请写“未知”。
      placeholder: "例如：deepseek-v4-pro / gpt-5.5 / claude-opus-4-8 / claude-sonnet-4-6 / gemini-3.1-pro-preview / gemini-3.5-flash"
    validations:
      required: true
  - type: textarea
    id: diagnostics
    attributes:
      label: 诊断信息
      description: 请贴出相关 preflight/status 输出。请先脱敏 API Key、私密正文和个人信息。
      placeholder: |
        python -X utf8 "<CLAUDE_PLUGIN_ROOT>/scripts/webnovel.py" --project-root "<PROJECT_ROOT>" preflight --format json
  - type: textarea
    id: files
    attributes:
      label: 相关文件或状态
      description: 请列出相关文件、commit artifact、截图或 Dashboard 页面。除非必要，不要粘贴私密章节全文。
      placeholder: ".story-system/commits/chapter_012.commit.json, .webnovel/state.json, Dashboard > System"
  - type: checkboxes
    id: checklist
    attributes:
      label: 提交前检查
      options:
        - label: 我已经搜索过现有 Issue，确认不是重复反馈。
          required: true
        - label: 我已经移除或脱敏 API Key、私密小说内容和个人信息。
          required: true
        - label: 我提供了足够用于复现或诊断的信息。
          required: true