完整安装与校验步骤

English · 简体中文

下载与校验

从 GitHub Latest 下载前核对其 tag 与 macOS 已签名清单一致。若不同，或缺少匹配的 DMG 和校验文件，暂停安装，不使用默认旧版。目前只发行 Apple Silicon（arm64），尚未发行 Intel 包。最低系统和电脑操控的支持边界见平台说明。

将 .dmg 及同名 .dmg.sha256 下载到“下载”目录。下面整段命令可直接粘贴：选择最近下载的 Caelis DMG，核验其对应校验值，只读挂载，安装到 ~/Applications。安装前先退出已运行的 CaelisBot；应用仍运行或目标已存在时会停止。升级时先将旧 .app 移到废纸篓，保留 ~/Library/Application Support/Caelis Bot/ 中的应用数据。

/bin/bash <<'INSTALL'
set -euo pipefail
cd "$HOME/Downloads"
DMG=$(ls -t Caelis-Bot-*-macos-*.dmg 2>/dev/null | head -n 1)
test -n "$DMG"
ARCH=$(uname -m)
if [[ "$(sysctl -in sysctl.proc_translated 2>/dev/null || true)" == 1 ]]; then ARCH=arm64; fi
[[ "$DMG" == *"-macos-$ARCH.dmg" ]]
EXPECTED=$(awk 'NR==1 {print $1}' "$DMG.sha256")
[[ "$EXPECTED" =~ ^[0-9a-f]{64}$ ]]
[[ "$(shasum -a 256 "$DMG" | awk '{print $1}')" == "$EXPECTED" ]]
if pgrep -x caelis-bot >/dev/null; then echo 'Quit Caelis Bot before installing.' >&2; exit 1; fi
APP="$HOME/Applications/Caelis Bot.app"
if [[ -e "$APP" ]]; then echo 'Move the previous app to Trash first; keep your application data.' >&2; exit 1; fi
MOUNT=$(mktemp -d /tmp/caelis-install.XXXXXX)
trap 'hdiutil detach "$MOUNT" -quiet 2>/dev/null || true; rmdir "$MOUNT" 2>/dev/null || true' EXIT
hdiutil verify "$DMG"
codesign --verify --strict --test-requirement '=anchor apple generic and certificate leaf[field.1.2.840.113635.100.6.1.13] exists and certificate leaf[subject.OU] = "64KZ67PM5J" and identifier "dev.caelis.bot.dmg"' "$DMG"
spctl --assess --type open --context context:primary-signature "$DMG"
hdiutil attach -readonly -nobrowse -noautoopen -mountpoint "$MOUNT" "$DMG"
codesign --verify --deep --strict --test-requirement '=anchor apple generic and certificate leaf[field.1.2.840.113635.100.6.1.13] exists and certificate leaf[subject.OU] = "64KZ67PM5J" and identifier "dev.caelis.bot"' "$MOUNT/Caelis Bot.app"
spctl --assess --type execute "$MOUNT/Caelis Bot.app"
mkdir -p "$HOME/Applications"
ditto "$MOUNT/Caelis Bot.app" "$APP"
codesign --verify --deep --strict "$APP"
printf 'Installed: %s\n' "$APP"
INSTALL

首次启动

从“应用程序”打开 Caelis Bot.app，如出现 macOS 正常的首次打开提示，确认打开即可。稳定版使用 Developer ID 签名与 Apple 公证，App 和 DMG 均附带公证票据，无需执行移除隔离标记的命令。

open "$HOME/Applications/Caelis Bot.app"

如果通过 DMG 拖入了系统“应用程序”，使用 /Applications/Caelis Bot.app。校验值、签名或 Gatekeeper 验证失败时，重新下载官方安装包；不要关闭系统安全机制或通过重新签名掩盖失败。

连接与使用

启动后查看状态栏和桌面角色；它默认不显示普通 Dock 图标。单击角色开关聊天，双击唤回聊天及已打开的设置，从状态栏进入设置、显示/隐藏或退出。隐藏角色不会退出应用。

首次设置或在“设置 → 连接与模型”中选择运行时。安装包内置 Caelis，可连接模型服务或复用已有认证模型；Codex 使用本机安装与账户，缺失时按应用引导安装、登录。确认模型并完成介绍后即可聊天，系统权限在使用相应功能时申请。兼容性按实际能力协商，详见运行时说明。

系统通知需要主动开启，退出时定时提醒暂停。替换 .app 会保留偏好、附件和对话绑定；除非有意清除数据，请保留 Application Support/Caelis Bot 文件夹。

更新

接入更新器的正式版每天检查更新。在“设置 → 更新”可关闭或开启自动检查，也可立即检查。确认原生更新窗口后，应用下载并安装签名的更高版本；未完成工作和待决定事项会先安全交接，对话、Notebook 与设置保留在原数据目录。

已发布的 v0.1.0 需要手动升级一次才能接入更新器。分发镜像按平台保留最新已验证基线，历史包保留在 GitHub。旧缓存指向的下载不可用时，重新检查更新或使用当前官方发行包。本地 Caelis Bot Dev.app 开发构建不使用公开更新源，也不会替换正式安装版。