diff --git a/.github/ISSUE_TEMPLATE/01-bug-report.yml b/.github/ISSUE_TEMPLATE/01-bug-report.yml new file mode 100644 index 00000000..8e39c07e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/01-bug-report.yml @@ -0,0 +1,130 @@ +name: 问题反馈 / Bug report +description: 报告 CrossDesk 的错误或异常行为。Report a bug or unexpected behavior in CrossDesk. +title: "[Bug] " +labels: [bug] +assignees: [kunkundi] +body: + - type: markdown + attributes: + value: | + 请先查看 [常见问题 / FAQ](https://github.com/kunkundi/crossdesk/blob/deskhub/docs/FAQ.md) 并搜索 [已有问题 / Existing issues](https://github.com/kunkundi/crossdesk/issues?q=is%3Aissue)。可使用中文或英文填写。 + Please check the FAQ and existing issues first. You can write in Chinese or English. + + - type: textarea + id: problem + attributes: + label: 问题与预期 / Problem and expected behavior + description: 描述实际发生的情况、错误提示，以及期望的行为。Describe what happened, any error messages, and what you expected. + placeholder: | + 实际结果 / Actual behavior: + 预期结果 / Expected behavior: + validations: + required: true + + - type: textarea + id: reproduction + attributes: + label: 复现步骤 / Steps to reproduce + description: 说明操作步骤和出现频率；偶发问题可描述发生前的操作。Include the steps and frequency. For intermittent issues, describe what you were doing. + placeholder: | + 1. + 2. + 3. + 出现频率 / Frequency: + validations: + required: true + + - type: dropdown + id: clients + attributes: + label: 涉及客户端 / Affected clients + description: 可多选；Web 与原生移动端请分别选择。Select all that apply; distinguish Web from native mobile apps. + multiple: true + options: + - 桌面客户端（Windows / macOS / Linux） / Desktop client + - iOS / iPadOS（原生 / Native） + - Android（原生 / Native） + - 鸿蒙 PC / HarmonyOS PC + - 鸿蒙手机或平板 / HarmonyOS mobile + - Web 客户端 / Web client + - 服务端 / Server + - 其他 / Other + validations: + required: true + + - type: textarea + id: controller + attributes: + label: 控制端或本机环境 / Controller or local environment + description: | + 控制端是发起远程操作的设备。请填写完整系统和客户端版本；Web 用户另填浏览器及其版本。自行构建请附提交号。 + 仅涉及安装、启动或服务端时，在此填写发生问题的本机环境。 + The controller initiates remote access. Include full OS and client versions; Web users should also include the browser and its version. For source builds, include the commit. + For installation, startup, or server-only issues, describe the affected local environment here. + placeholder: | + 操作系统及版本 / OS and version: + CPU 架构（x64 / arm64 等） / CPU architecture: + CrossDesk 版本或提交号 / CrossDesk version or commit: + 浏览器及版本（仅 Web） / Browser and version (Web only): + validations: + required: true + + - type: textarea + id: host + attributes: + label: 被控端环境 / Remote host environment + description: | + 被控端是接受远程操作的电脑。连接或会话问题请补充这一端的信息；不涉及远程设备时可留空。 + The host is the computer being controlled. Include its details for connection or session issues; leave empty if no remote device is involved. + placeholder: | + 操作系统及版本 / OS and version: + CPU 架构（x64 / arm64 等） / CPU architecture: + CrossDesk 版本或提交号 / CrossDesk version or commit: + validations: + required: false + + - type: dropdown + id: service + attributes: + label: 服务部署方式 / Server deployment + options: + - 公共服务 / Public service + - 自托管 / Self-hosted + - 不确定 / Unknown + - 不适用 / Not applicable + validations: + required: false + + - type: dropdown + id: connection + attributes: + label: 连接方式 / Connection type + description: 可在会话的网络状态中查看；无法确认时选择“不确定”。Check the session's network status, or choose Unknown. + options: + - P2P 直连 / Direct P2P + - TURN 中继 / TURN relay + - 尚未建立连接 / Connection not established + - 不确定 / Unknown + - 不适用 / Not applicable + validations: + required: false + + - type: textarea + id: context + attributes: + label: 补充环境 / Additional environment + description: | + 按问题补充相关信息，例如普通会话或桌面墙、自托管服务端版本、局域网或公网、VPN；画面问题可补充显卡、编码格式、硬件编解码设置和显示器情况。 + Include relevant details such as a normal session or DeskHub, self-hosted server version, LAN or Internet, and VPN use. For video issues, add GPU, codec, hardware codec settings, and display configuration. + validations: + required: false + + - type: textarea + id: attachments + attributes: + label: 日志与截图 / Logs and screenshots + description: | + 可粘贴相关日志，或拖入日志文件、截图和录屏。上传前请隐去连接密码等敏感信息。 + Paste relevant logs or attach log files, screenshots, and recordings. Redact connection passwords and other private information before uploading. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/02-feature-request.yml b/.github/ISSUE_TEMPLATE/02-feature-request.yml new file mode 100644 index 00000000..68e003a1 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/02-feature-request.yml @@ -0,0 +1,72 @@ +name: 需求建议 / Feature request +description: 提出 CrossDesk 的新功能或改进建议。Suggest a new feature or improvement for CrossDesk. +title: "[Feature] " +labels: [enhancement] +assignees: [kunkundi] +body: + - type: markdown + attributes: + value: | + 提交前请搜索 [已有建议 / Existing requests](https://github.com/kunkundi/crossdesk/issues?q=is%3Aissue)。可使用中文或英文填写。 + Please search existing requests before submitting. You can write in Chinese or English. + + - type: textarea + id: use-case + attributes: + label: 使用场景与问题 / Use case and problem + description: 你希望完成什么？目前遇到什么限制？What are you trying to do, and what limitation do you encounter? + validations: + required: true + + - type: textarea + id: proposal + attributes: + label: 功能建议与预期效果 / Proposal and expected outcome + description: 描述希望新增或改进的行为，以及理想的使用方式。Describe the behavior you would like to add or improve and how you expect to use it. + validations: + required: true + + - type: dropdown + id: scope + attributes: + label: 适用范围 / Scope + description: 可多选；通用建议可选择“跨平台或通用”。Select all that apply, or choose Cross-platform or general. + multiple: true + options: + - 跨平台或通用 / Cross-platform or general + - 桌面客户端（Windows / macOS / Linux） / Desktop client + - iOS / iPadOS + - Android + - 鸿蒙 PC / HarmonyOS PC + - 鸿蒙手机或平板 / HarmonyOS mobile + - Web 客户端 / Web client + - 桌面墙 / DeskHub + - 自托管服务 / Self-hosted services + - 文档或安装体验 / Documentation or installation + - 其他 / Other + validations: + required: false + + - type: textarea + id: impact + attributes: + label: 影响范围与使用频率 / Impact and frequency + description: 哪些用户或场景会受益？你会多频繁地使用？Who would benefit, in which situations, and how often would you use this? + validations: + required: false + + - type: textarea + id: alternatives + attributes: + label: 替代方案 / Alternatives + description: 目前如何处理这个需求？是否考虑过其他实现方式？How do you handle this today, and what other approaches have you considered? + validations: + required: false + + - type: textarea + id: references + attributes: + label: 参考资料与补充说明 / References and additional context + description: 可提供参考链接、截图、示意图或其他要求。Include links, screenshots, mockups, or any additional requirements. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..fc267f91 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,11 @@ +blank_issues_enabled: true +contact_links: + - name: 常见问题 / FAQ + url: https://github.com/kunkundi/crossdesk/blob/deskhub/docs/FAQ.md + about: 连接、黑屏、系统权限与安装排查。Troubleshoot connections, blank video, permissions, and installation. + - name: 使用指南（中文） + url: https://github.com/kunkundi/crossdesk/blob/deskhub/docs/USER_GUIDE.md + about: 查看连接、桌面墙、移动端、无人值守和自托管的使用说明。 + - name: User guide (English) + url: https://github.com/kunkundi/crossdesk/blob/deskhub/docs/USER_GUIDE_EN.md + about: Read about connections, DeskHub, mobile clients, unattended access, and self-hosting. diff --git a/.github/ISSUE_TEMPLATE/问题反馈.md b/.github/ISSUE_TEMPLATE/问题反馈.md deleted file mode 100644 index ebdeea8c..00000000 --- a/.github/ISSUE_TEMPLATE/问题反馈.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -name: 问题反馈 -about: 请在此提交问题报告，以便持续优化产品。 -title: '' -labels: bug -assignees: kunkundi - ---- - -**描述问题** -清晰简洁地描述遇到的错误。 - -**复现步骤** -复现该问题的步骤： -1. 前往 '...' -2. 点击 '....' -3. 出现错误 - -**预期行为** -清晰简洁地描述你期望发生的行为。 - -**截图** -如果适用，请添加截图以帮助说明问题。 - -**桌面端信息（请填写以下内容）：** - - 操作系统: [例如 Windows 11] - - 版本: [例如 v1.1.10] - -**移动端信息（请填写以下内容）：** - - 设备: [例如 iPhone 17] - - 操作系统: [例如 iOS 26.1] - - 浏览器: [例如 系统浏览器、Safari] - -**补充信息** -在此添加与问题相关的其他上下文内容。 diff --git a/.github/ISSUE_TEMPLATE/需求建议.md b/.github/ISSUE_TEMPLATE/需求建议.md deleted file mode 100644 index e6526748..00000000 --- a/.github/ISSUE_TEMPLATE/需求建议.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -name: 需求建议 -about: 请在此提交功能需求或改进建议，以便后续迭代参考。 -title: '' -labels: enhancement -assignees: kunkundi - ---- - -**功能/改进建议描述** -清晰简洁地描述希望新增的功能或改进的内容。 - -**使用场景 / 背景** -说明该功能或改进的使用场景，以及解决后带来的价值。 - -**预期效果** -描述你认为最理想的功能表现或改进效果。 - -**参考示例（可选）** -提供类似功能截图、参考链接或其他说明，帮助更好理解需求。 - -**优先级（可选）** -- [ ] 高 -- [ ] 中 -- [ ] 低 - -**补充信息（可选）** -其他相关信息或特殊要求。