From c43982f8342c76ce9d688605951148cedfb58429 Mon Sep 17 00:00:00 2001 From: ZacharyZcR <2903735704@qq.com> Date: Mon, 1 Jun 2026 08:17:00 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=20Issue=20=E6=A8=A1?= =?UTF-8?q?=E6=9D=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 版本号更新至 2.2.0-rc / 2.1.3 / 2.1.2 - 移除 placeholder 预填充内容，避免用户不删不改直接提交 - 新增 SDK、代理、mips 等选项 - macOS/Ubuntu 版本更新 - 新增安全漏洞报告入口指引 - 模板顶部增加"未填写有效信息会被关闭"提示 --- .github/ISSUE_TEMPLATE/bug_report.yml | 35 ++++++------ .github/ISSUE_TEMPLATE/config.yml | 12 ++-- .github/ISSUE_TEMPLATE/false_positive.yml | 64 ++++++++++------------ .github/ISSUE_TEMPLATE/feature_request.yml | 24 +++----- .github/ISSUE_TEMPLATE/plugin_request.yml | 41 ++++---------- 5 files changed, 74 insertions(+), 102 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index e85de5e..93c4609 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -1,6 +1,6 @@ name: 🐛 Bug 报告 description: 报告扫描异常、崩溃或错误行为 -title: "[Bug] 简要描述问题" +title: "[Bug] " labels: ["bug"] body: @@ -8,6 +8,7 @@ body: attributes: value: | 感谢您提交 Bug 报告！请尽可能详细地填写以下信息，这将帮助我们更快定位和修复问题。 + **请勿直接提交未修改的模板**，未填写有效信息的 Issue 会被直接关闭。 - type: dropdown id: module @@ -21,8 +22,10 @@ body: - 弱口令爆破 (Brute Force) - POC/漏洞扫描 (POC Scan) - Web指纹识别 (Web Fingerprint) + - 代理功能 (Proxy) - 输出/日志 (Output/Logging) - 命令行参数 (CLI Arguments) + - 嵌入式 SDK (Embedded SDK) - 其他 (Other) validations: required: true @@ -32,7 +35,7 @@ body: attributes: label: 严重程度 options: - - 崩溃/无法使用 (Crash) + - 崩溃/Panic (Crash) - 功能异常 (Malfunction) - 结果不准确 (Inaccurate) - 性能问题 (Performance) @@ -44,10 +47,7 @@ body: id: description attributes: label: 问题描述 - description: 清晰描述遇到的问题 - placeholder: | - 发生了什么？ - 预期的行为是什么？ + description: 清晰描述遇到的问题，包括预期行为和实际行为 validations: required: true @@ -55,10 +55,7 @@ body: id: reproduce attributes: label: 复现步骤 - description: 提供可以复现问题的命令或步骤 - placeholder: | - 1. 执行命令: fscan -h xxx -p xxx - 2. 观察到... + description: 提供可以复现问题的完整命令（请脱敏 IP/密码） render: shell validations: required: true @@ -75,10 +72,12 @@ body: attributes: label: fscan 版本 options: + - 2.2.0-rc (dev) + - 2.1.3 + - 2.1.2 - 2.1.0 - - 2.0.1 - - 2.0.0 - - 1.8.4 + - 2.0.x + - 1.8.x - 其他/自编译 validations: required: true @@ -92,14 +91,13 @@ body: - Windows 10 - Windows Server 2022 - Windows Server 2019 + - Ubuntu 24.04 - Ubuntu 22.04 - - Ubuntu 20.04 - - CentOS 7 - - CentOS 8/Stream + - CentOS 7/8/Stream - Debian 11/12 - Kali Linux + - macOS 15 (Sequoia) - macOS 14 (Sonoma) - - macOS 13 (Ventura) - 其他 Linux - 其他 validations: @@ -114,6 +112,7 @@ body: - arm64 (aarch64) - 386 (x86) - arm + - mips/mipsle validations: required: true @@ -121,4 +120,4 @@ body: id: additional attributes: label: 补充信息 - description: 其他可能有助于排查问题的信息（如自编译请注明 Go 版本） + description: 其他有助于排查的信息（网络环境、是否使用代理、自编译请注明 Go 版本等） diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 6472364..b0b3d52 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,11 +1,13 @@ # Issue 模板配置 -# 禁止空白 issue，强制用户选择模板 blank_issues_enabled: false contact_links: - - name: 📖 使用文档 + - name: 📖 使用文档 / README url: https://github.com/shadow1ng/fscan/blob/main/README.md - about: 提交 Issue 前请先查阅文档 - - name: 💬 讨论区 + about: 提交 Issue 前请先查阅文档，确认不是用法问题 + - name: 💬 讨论区 / Discussions url: https://github.com/shadow1ng/fscan/discussions - about: 一般性问题和讨论请使用 Discussions + about: 使用疑问、经验分享、一般性讨论请使用 Discussions + - name: 🔐 安全漏洞报告 + url: https://github.com/shadow1ng/fscan/security/advisories/new + about: fscan 自身的安全漏洞请通过 Security Advisory 私下报告，不要公开提 Issue diff --git a/.github/ISSUE_TEMPLATE/false_positive.yml b/.github/ISSUE_TEMPLATE/false_positive.yml index 99c6c5c..883903d 100644 --- a/.github/ISSUE_TEMPLATE/false_positive.yml +++ b/.github/ISSUE_TEMPLATE/false_positive.yml @@ -1,13 +1,14 @@ name: 🎯 误报/漏报 description: 报告扫描结果不准确的问题 -title: "[Accuracy] 服务名 - 误报/漏报描述" +title: "[Accuracy] " labels: ["accuracy"] body: - type: markdown attributes: value: | - 感谢您帮助提高 fscan 的准确性！误报和漏报都是需要优化的问题。 + 感谢您帮助提高 fscan 的准确性！ + **请提供对比验证结果**（如 nmap、手动连接等），仅描述"感觉不对"的报告无法处理。 - type: dropdown id: type @@ -34,11 +35,20 @@ body: validations: required: true + - type: textarea + id: command + attributes: + label: 使用的命令 + description: 执行的 fscan 命令（请脱敏真实 IP/密码） + render: shell + validations: + required: true + - type: textarea id: fscan-output attributes: label: fscan 输出结果 - description: 粘贴相关的扫描输出（请脱敏敏感信息如真实IP、密码等） + description: 粘贴相关的扫描输出（请脱敏敏感信息） render: shell validations: required: true @@ -46,11 +56,8 @@ body: - type: textarea id: actual attributes: - label: 实际情况 - description: 描述目标的真实状态 - placeholder: | - 实际上这个端口是关闭的 / 服务版本是 xxx / 密码不是 xxx... - 验证方式: 通过 nmap/手动连接/其他工具 确认... + label: 实际情况及验证方式 + description: 描述目标的真实状态，以及你通过什么方式验证的（nmap、手动连接、其他工具等） validations: required: true @@ -59,15 +66,13 @@ body: attributes: label: 目标操作系统 options: - - Windows Server 2022 - - Windows Server 2019 - - Windows Server 2016 - - Windows 10/11 - - Ubuntu + - Windows Server + - Windows Desktop + - Ubuntu/Debian - CentOS/RHEL - - Debian - 其他 Linux - 网络设备 + - 容器/Docker - 未知 validations: required: true @@ -77,20 +82,10 @@ body: attributes: label: 网络环境 options: - - 直连 - - 通过代理 + - 直连（同网段） + - 跨网段/路由 + - 通过代理 (SOCKS5/HTTP) - VPN - - 跨网段 - validations: - required: true - - - type: textarea - id: command - attributes: - label: 使用的命令 - description: 执行的 fscan 命令 - placeholder: "fscan -h x.x.x.x -p 1-65535 -pwdf pass.txt" - render: shell validations: required: true @@ -99,10 +94,12 @@ body: attributes: label: fscan 版本 options: + - 2.2.0-rc (dev) + - 2.1.3 + - 2.1.2 - 2.1.0 - - 2.0.1 - - 2.0.0 - - 1.8.4 + - 2.0.x + - 1.8.x - 其他/自编译 validations: required: true @@ -110,8 +107,5 @@ body: - type: textarea id: suggestion attributes: - label: 改进建议 - description: 如果您有改进的想法，请分享 - placeholder: | - 建议增加 xxx 判断条件... - 或者调整 xxx 检测逻辑... + label: 改进建议（可选） + description: 如果您有改进判断逻辑的想法 diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index ca88290..257c590 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -1,13 +1,14 @@ name: ✨ 功能请求 description: 提议新功能或改进现有功能 -title: "[Feature] 一句话描述功能" +title: "[Feature] " labels: ["enhancement"] body: - type: markdown attributes: value: | - 感谢您的功能建议！请详细描述您的需求，这将帮助我们评估和实现。 + 感谢您的功能建议！请描述清楚使用场景和期望行为。 + 纯 "+1" 类请求请用 Reaction 表达，不要开新 Issue。 - type: dropdown id: category @@ -19,6 +20,7 @@ body: - 用户体验 (UX/CLI) - 输出格式 (Output Format) - 配置选项 (Configuration) + - 嵌入式 SDK (Embedded SDK) - 集成/API (Integration/API) - 其他 (Other) validations: @@ -28,10 +30,7 @@ body: id: problem attributes: label: 解决什么问题？ - description: 描述您遇到的痛点或使用场景 - placeholder: | - 在进行 xxx 操作时，我希望能够... - 目前的问题是... + description: 描述您的实际使用场景和痛点 validations: required: true @@ -39,20 +38,15 @@ body: id: solution attributes: label: 期望的解决方案 - description: 描述您希望的功能或行为 - placeholder: | - 希望能够通过 -xxx 参数来... - 或者增加一个新的模块来... + description: 描述您希望的功能行为，最好包含预期的命令行用法示例 validations: required: true - type: textarea id: alternatives attributes: - label: 替代方案 - description: 您考虑过的其他解决方案或变通方法 - placeholder: | - 目前我通过 xxx 方式来解决，但是... + label: 替代方案（可选） + description: 您目前的变通方法，或考虑过的其他方案 - type: dropdown id: priority @@ -60,7 +54,7 @@ body: label: 优先级建议 description: 您认为这个功能的重要程度 options: - - 高 - 核心功能缺失 + - 高 - 核心场景缺失，严重影响使用 - 中 - 明显改善体验 - 低 - 锦上添花 validations: diff --git a/.github/ISSUE_TEMPLATE/plugin_request.yml b/.github/ISSUE_TEMPLATE/plugin_request.yml index cb61fd8..4b7873c 100644 --- a/.github/ISSUE_TEMPLATE/plugin_request.yml +++ b/.github/ISSUE_TEMPLATE/plugin_request.yml @@ -1,6 +1,6 @@ name: 🔌 新插件/协议支持 description: 请求支持新的服务、协议或漏洞检测 -title: "[Plugin] 协议/服务名称" +title: "[Plugin] " labels: ["plugin", "enhancement"] body: @@ -8,6 +8,7 @@ body: attributes: value: | 感谢您的插件请求！fscan 持续扩展对各种服务和协议的支持。 + 提交前请先确认该服务尚未被支持（查看 README 的支持列表）。 - type: dropdown id: type @@ -25,7 +26,7 @@ body: id: service attributes: label: 服务/协议名称 - placeholder: "如: Kafka, ClickHouse, etcd, Consul" + description: 例如 ClickHouse、etcd、Consul、Zookeeper validations: required: true @@ -33,49 +34,31 @@ body: id: port attributes: label: 默认端口 - placeholder: "如: 9092, 8123, 2379" + description: 例如 9000、2379、8500 - type: textarea id: description attributes: - label: 服务描述 - description: 简要介绍这个服务/协议 - placeholder: | - 这是一个用于 xxx 的服务... - 在内网环境中常见于... + label: 服务描述与检测思路 + description: 简要介绍服务用途、在内网中的常见程度，以及如何识别（Banner 特征、认证方式等） validations: required: true - - type: textarea - id: detection - attributes: - label: 识别方法 - description: 如何识别/检测这个服务（如有了解） - placeholder: | - Banner 特征: xxx - 默认响应: xxx - 认证方式: xxx - - type: textarea id: reference attributes: - label: 参考资料 - description: 相关文档、其他工具实现、漏洞详情等 - placeholder: | - - 官方文档: https://... - - 其他工具实现: https://... - - CVE编号: CVE-xxxx-xxxx + label: 参考资料（可选） + description: 官方文档链接、协议规范、其他工具实现、CVE 编号等 - type: dropdown id: prevalence attributes: - label: 使用普遍程度 - description: 这个服务在目标环境中的常见程度 + label: 内网常见程度 options: - - 非常常见 (企业环境标配) - - 较为常见 (经常遇到) + - 非常常见（企业环境标配） + - 较为常见（经常遇到） - 偶尔遇到 - - 较少见但重要 + - 较少见但高价值 validations: required: true