社区支持 · GitHub Issues · 无注册门槛

反馈问题

Bug、功能建议、打包问题、文档错别字——都欢迎在 OpenBox 的 GitHub issue 跟踪中提出。没有独立论坛，没有付费支持等级，没有"高级用户优先"。所有讨论都在同一个地方。

→ 提交新 issue 浏览现有 issue

提交之前

提前做一点准备，你的问题被快速修复的概率会高得多。

🔍

先搜索

同时搜索 开放和已关闭的 issue，看看是否已有相关问题。很多常见问题已经被回答过了。

🧪

在最新构建上复现

针对老版本的 issue 很难修复。先下载最新版本，确认 Bug 仍然存在。如果不存在，你其实已经解决问题了。

📋

选对模板

issue 选择器提供 Bug 反馈、功能建议、打包问题三种模板。选最接近的——模板会提示你需要提供哪些信息。

📸

附上截图

如果是 UI Bug，把截图拖入 issue 正文。如果是 CLI Bug，粘贴完整命令和错误输出（先隐去任何敏感路径）。

💻

提供环境信息

操作系统版本、OpenBox 版本（在"关于"标签或 samai-openbox --version 可见），Linux 还需发行版和桌面环境。一行说明就够。

🎯

一个 issue 一个问题

发现三个 Bug 就提三个 issue。这样讨论更聚焦，每个修复都能独立发布，不会互相阻塞。

Issue 模板

GitHub issue 选择器会让你填的内容。能填多少填多少。

Bug

Bug 反馈

OpenBox 崩溃、行为异常或输出错误时使用此模板。需要填写：

  • OpenBox 版本与操作系统（选择器会自动填充）
  • 复现步骤——精确的点击或命令，用编号列出
  • 期望行为 vs 实际行为
  • 截图或错误日志（拖入 issue 即可）
  • 压缩包文件本身（如可分享；否则提供文件清单）
功能

功能建议

OpenBox 能用但你希望它做现在做不到的事情时使用。需要填写：

  • 你想解决的问题（不是你设想的解决方案）
  • 当前的临时方案（如有）以及为什么不好用
  • 提议的行为——要具体，但不要过度规定实现细节
  • 你考虑过的备选方案
打包

打包 / 安装问题

下载后无法安装、文件关联不生效或二进制无法启动时使用。需要包含：

  • 操作系统版本和 CPU 架构（如 Windows 11 23H2 x64、macOS 14.5 arm64、Ubuntu 24.04 x64）
  • 下载的具体文件名（从下载页获取）
  • 失败的具体步骤（双击？向导？安装后启动？）
  • 任何错误对话框的截图，或终端输出粘贴

安全报告

发现安全漏洞？请不要开公开 issue，私下报告。

OpenBox 是桌面压缩工具，主要安全面是解压过程。 我们已在引擎层面拦截路径穿越条目（../../etc/passwd 类型攻击）， 且不会自动执行压缩包内的任何内容。

如果你发现了以下情况：

请通过 GitHub 的安全公告功能私下报告：

→ 提交私密安全公告

我们将在 48 小时内确认收到报告，高危漏洞力争 30 天内修复。

其他联系方式

有明确动作的 Bug 和功能建议用 issue 最合适。其他情况可以用以下方式。

💬

讨论区

"怎么做 ……" 或"…… 用什么格式最好"这类问题请去 GitHub Discussions，不要开 issue。issue 用来跟踪可执行的工作项。

🔀

Pull Request

欢迎提交代码——fork 仓库、推到分支、向 main 开 PR。小 Bug 修复可直接提交；大改动请先开 issue 讨论方案。

📣

SamAI 集团

OpenBox 是 SamAI 集团公益开源项目之一。跨项目讨论在 samai.cc 上的 SamAI 社区频道进行。