入门 · GETTING STARTED

第一次使用 SoftBuddy

STEP 01

从 App Store 安装

iOS 17.0 及以上,约 22 MB。

STEP 02

在 Mac 上安装 helper

brew install softbuddy-helper

STEP 03

运行 pair 命令

softbuddy-helper pair

故障排查 · TROUBLESHOOTING

常见连接问题

App 一直显示 "Advertising",扫不到 Mac +
  1. 确认两台设备都开启了蓝牙,且距离在 10 米以内。
  2. 在 Mac 终端运行 softbuddy-helper status 检查 helper 是否在运行。
  3. 在 iPhone 系统设置 → SoftBuddy → 蓝牙权限,确认为"开启"。
  4. 在 App 内长按状态条 → "重置配对",再走一遍配对流程。
小伙伴卡在 Busy 不动了 +
多数情况下是 helper 与 Claude Code 之间的事件流断开。在 Mac 终端运行 softbuddy-helper restart。如仍未恢复,请到 GitHub Issues 附上 ~/.softbuddy/helper.log
收不到审批推送 +
在 iPhone 系统设置 → 通知 → SoftBuddy,确认通知已开启且允许"锁屏 / 横幅 / 通知中心"。请同时确认未启用 iOS 的"专注模式"过滤本 App。
想完全卸载 / 抹除数据 +
iPhone:直接长按图标卸载即可,沙盒数据会随 App 一同移除。Mac:执行 brew uninstall softbuddy-helper && rm -rf ~/.softbuddy
规格 · TECH SPEC

系统要求

iOS
iOS 17.0 及以上 · iPhone 11 及以上(需支持 BLE 5.0+)
macOS
macOS 13 Ventura 及以上 · Apple Silicon 与 Intel 均支持
helper
softbuddy-helper · 约 2 MB · 由 SoftBuddy Lab 提供
Claude
Claude Code CLI 0.10+ · Claude Desktop(可选)
语言
简体中文、繁體中文、English
SERVICE STATUS

All systems operational.

本 App 不依赖云端服务,故"系统状态"实际指 helper 软件包分发与文档站点。

OPERATIONAL
联系 · CONTACT

直接告诉我们。

我们是一支小团队,邮件通常 24 小时内回复(工作日)。希望让你在等 Claude 跑测试的时候,至少能有个会眨眼的伙伴陪你。

联系邮箱
litesky@foxmail.com
一般咨询
Bug 反馈
隐私 / 法律