Files
bot/docs/zh-CN/platforms/mac/bundled-gateway.md
zooqueenandHanzo Dev cbacae5efd chore: complete Hanzo Bot rebranding — purge all bot.molt legacy names
Replace all bot.molt.* identifiers with ai.hanzo.bot.* across:
- LaunchAgent labels (constants.ts + tests)
- iOS bundle IDs, dispatch queues, logger subsystems
- iOS fastlane Appfile (bot.molt.ios → ai.hanzo.bot.ios)
- iOS project.yml branding (display name → Hanzo Bot)
- macOS icon file rename (Bot.icns → HanzoBot.icns)
- appcast.xml title (Bot → Hanzo Bot)
- auto-response workflow (moltbook → off-topic)
- All English and Chinese documentation (32 doc files)
- scripts/restart-mac.sh launchd plist reference

Co-authored-by: Hanzo Dev <[email protected]>
2026-02-22 16:21:56 -08:00

2.3 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
打包 Hanzo Bot.app
调试 macOS Gateway 网关 launchd 服务
为 macOS 安装 Gateway 网关 CLI
macOS 上的 Gateway 网关运行时(外部 launchd 服务) macOS 上的 Gateway 网关
generated_at model provider source_hash source_path workflow
2026-02-03T07:52:30Z claude-opus-4-5 pi 4a3e963d13060b123538005439213e786e76127b370a6c834d85a369e4626fe5 platforms/mac/bundled-gateway.md 15

macOS 上的 Gateway 网关(外部 launchd)

Hanzo Bot.app 不再捆绑 Node/Bun 或 Gateway 网关运行时。macOS 应用期望有一个外部的 bot CLI 安装,不会将 Gateway 网关作为子进程启动,而是管理一个每用户的 launchd 服务来保持 Gateway 网关运行(或者如果已有本地 Gateway 网关正在运行,则连接到现有的)。

安装 CLI(本地模式必需)

你需要在 Mac 上安装 Node 22+,然后全局安装 bot:

npm install -g bot@<version>

macOS 应用的安装 CLI按钮通过 npm/pnpm 运行相同的流程(不推荐使用 bun 作为 Gateway 网关运行时)。

Launchd(Gateway 网关作为 LaunchAgent)

标签:

  • ai.hanzo.bot.gateway(或 ai.hanzo.bot.<profile>;旧版 com.bot.* 可能仍然存在)

Plist 位置(每用户):

  • ~/Library/LaunchAgents/ai.hanzo.bot.gateway.plist (或 ~/Library/LaunchAgents/ai.hanzo.bot.<profile>.plist)

管理者:

  • macOS 应用在本地模式下拥有 LaunchAgent 的安装/更新权限。
  • CLI 也可以安装它:hanzo-bot gateway install。

行为:

  • "Hanzo Bot Active"启用/禁用 LaunchAgent。
  • 应用退出不会停止 Gateway 网关(launchd 保持其存活)。
  • 如果 Gateway 网关已经在配置的端口上运行,应用会连接到它而不是启动新的。

日志:

  • launchd stdout/err:/tmp/bot/bot-gateway.log

版本兼容性

macOS 应用会检查 Gateway 网关版本与其自身版本是否匹配。如果不兼容,请更新全局 CLI 以匹配应用版本。

冒烟测试

hanzo-bot --version

BOT_SKIP_CHANNELS=1 \
BOT_SKIP_CANVAS_HOST=1 \
hanzo-bot gateway --port 18999 --bind loopback

然后:

hanzo-bot gateway call health --url ws://127.0.0.1:18999 --timeout 3000