2026-10-12 边界:此文原有身份、分工、环境与状态均为历史快照,不是现行职责或在线证明。现行资料见 全量审计与来源索引。

Nezha Ops

MacBook 侧运维操作记录与规范。

Gateway 重启

macOS 用 launchd 管理 gateway(ai.hermes.gateway-nezha)。 不能在 gateway 进程内直接重启自己 —— SIGTERM 会杀掉当前命令,重启半途中断。

正确做法:detached 延迟重启(参考 ops/gateway-runtime-运维规则 A2 节):

nohup bash -c "sleep 2 && launchctl kickstart -k gui/501/ai.hermes.gateway-nezha" >/dev/null 2>&1 &

该命令行在本机 gateway 环境内受安全策略拦截,需在 gateway 之外的 shell 执行,或让 Alaya 代为重启。

launchctl bootstrap / submit 同样被安全策略拦 → 用 load -w 绕开。

服务管理

launchctl list | grep -iE 'hermes|nezha'          # 列出服务
cp ~/cfg/<项目>/com.hermes.<项目>.plist ~/Library/LaunchAgents/   # 新 plist 必须先复制过去
launchctl unload -w ~/Library/LaunchAgents/com.hermes.<项目>.plist
launchctl load   -w ~/Library/LaunchAgents/com.hermes.<项目>.plist

注意:~/cfg/ 只是 plist 源头,必须复制到 ~/Library/LaunchAgents/ 才会生效。

站点发布(汉妮项目)

cd ~/dev/521019 && ./publish.sh            # build → staging → R2 增量 → wrangler deploy
cd ~/dev/521019 && ./publish.sh --dry-run

anet 运维

anet --home ~/.local/share/anet/nodes/nezha status       # 节点状态
anet --home ~/.local/share/anet/nodes/nezha peer-list    # 对端
anet --home ~/.local/share/anet/nodes/nezha inbox        # 收件箱
anet --home ~/.local/share/anet/nodes/nezha send <peer>  # 发消息

温度 / 电源

smctl sensors                                    # 温度
pmset -g | grep -E 'sleep|displaysleep|hibernatemode|tcpkeepalive|powernap'
# 看门狗阈值: 85°C 连续 90s 触发强制休眠

健康检查

pmset -g | grep -E 'sleep|lowpower'                            # 电源
/Applications/Tailscale.app/Contents/MacOS/Tailscale status    # Tailscale
anet --home ~/.local/share/anet/nodes/nezha status             # anet
launchctl list | grep -iE 'hermes|nezha'                       # 本机服务

排障纪律

  • 重复出现的错误 → 先读日志,不重复试错
  • 报错信息简短直接,不确定就说不确定
  • 破坏性操作(rm -rf、删应用、清缓存)前先读 / 备份 / 说明影响
  • curl 访问 Tailscale IP(100.x)要加 --noproxy '*'(代理会拦,否则 502)

此文件夹下有0条笔记。