Shepi
技术支持

出问题了？在 App 内告诉我们。

在 Shepi 中，选取帮助 › 发送反馈…（或按 ⌘? 并输入“反馈”）。描述发生了什么，有帮助的话粘贴或拖入截图，然后按“发送”。它会直接送到开发者那里，无需账户，也没有公开页面。如果希望收到回复，请填写邮箱地址。

写信之前：三个常见的解决办法

“Shepi 需要 Herdr”或“Herdr 不在线”

Shepi 是通往 Herdr 的一扇窗。如果它说需要 Herdr，用 curl -fsSL https://herdr.dev/install.sh | sh 安装；装好后 Shepi 会自己连接。如果它需要更新版本的 Herdr，运行 herdr update（用 Homebrew 安装的：brew upgrade herdr）。“Herdr 不在线”表示 Herdr 已安装，但它的服务器停止了或无法连接；Shepi 会自己再次启动它。如果一直失败，在终端里运行一次 herdr，如果仍然连不上，就发送报告。

Shepi 中的按键和你预期的不一样

Shepi 会读取你 Herdr 配置中的按键绑定并实时显示。如果提示显示 ⌃G，而你以为是 ⌃B，那是你在 Herdr 配置中的 keys.prefix，不是 Shepi 的设置。Shepi 从不修改那个文件。

机器需要处理或没有出现

在边栏或“设置 › 机器”中用添加机器从 Shepi 添加机器；它会在终端中运行 Herdr 自己的 herdr machine add，方便你回答它的问题。Shepi 用你自己的 SSH 密钥连接，所以如果 ssh you@your-server 在“终端”里要求输入密码，Shepi 也连不上。需要处理的机器会在边栏中它的标题上显示琥珀色的 !；展开它的工作区（点它的箭头）后，原因和“重新连接”按钮就在下面。

怎样的报告容易修复

  • 你做了什么、预期是什么、实际发生了什么，各用一两行写清楚。
  • 你的 macOS 版本、Shepi 版本（Shepi › 关于 Shepi）和 herdr --version。
  • 截图、短录屏或日志。“发送反馈”接受粘贴或拖入的文件，最多 10 个，总共 15 MB。
  • 如果与按键有关：你的 Herdr 配置中的 keys 部分。

Shepi 从不自行发送报告。报告包含你输入和附加的内容，再加上几行用于复现问题的上下文：Shepi、Herdr 和 macOS 的版本，打开的是哪个视图，当前标签页的布局（使用中性名称，如 space 1 › tab 2），你最近使用的十个快捷键和菜单命令（各带时间），以及窗口大小。从不包含终端内容、名称或路径。面板中的“包含的内容”会在发送前准确显示将要发送的一切。

报告 ID 和诊断日志

“发送反馈”中有一个开关 附带诊断日志，默认打开。保持打开：它会附上 Shepi 自己最近三天的日志（连接、错误、通知决策和更新检查，每条都带时间），以及最近 14 天每次崩溃的摘要（什么出了问题、出在 Shepi 代码的哪里）。从不包含终端内容、名称或路径；“包含的内容”会在你发送前显示日志全文。发送后，Shepi 会显示一个报告 ID，例如 P-7K3Q-9M2X，并提供“拷贝”和“给技术支持发邮件”。要写信到 support@shepi.app？引用这个 ID，就能找到你的日志。下面的表单无法附上 Shepi 的日志；等 Shepi 能再次打开时，从 App 中发送。

许可证、购买和退款

  • 换了新 Mac：打开 Shepi，用你购买时的账户（Google、GitHub 或 X）登录。没有需要找的密钥。
  • 没有 Google、GitHub 或 X 账户？一个免费的 GitHub 或 Google 账户就够了。
  • 收据和付款问题：Shepi 由 Dodo Payments 售出；Dodo Payments 发给你的收据中的链接可以解答这些问题。
  • 退款：所有购买均不可退款，所以请在购买前免费试用 Shepi 14 天（见退款政策）。对某笔扣款有疑问：请附上订单号，写信到 support@shepi.app。

公开渠道：GitHub

Shepi for Herdr 在 GitHub 上有公开主页 wio-apps/shepi，包含每个版本的发布说明，还有 issue 和讨论区，任何人都可以在那里报告问题、提出功能请求，或查看别人问过什么。在那里发帖需要 GitHub 账户，而且你写的一切都是公开的：切勿粘贴终端输出、路径或机器名称，除非你愿意公开它们。私密的事情，请使用 App 中的“发送反馈”；只有开发者会读到。

新闻和简短问题

发布说明、使用技巧和简短答复都发在 X 上：@x_wio_x。报告错误最好通过“发送反馈”，这样能保留细节。

打不开 Shepi？在这里写。

与“发送反馈”相同的报告，从浏览器发送。只有开发者会读到。也可以发邮件到 support@shepi.app。

只有开发者会读到。