入门指南
安装 Kition
在 macOS / Windows 上下载安装包并完成首次启动。
下载
Kition 是一个独立桌面应用 — 不需要浏览器、不需要 Docker、不需要 Node 环境。安装包由 Electron 壳和一个本地 Go sidecar 进程打包在一起，全部解压后约 250 MB。
从官网 kition.ai/download 选择对应平台的安装包。安装包都是签名过的：macOS 用 Apple Developer ID，Windows 用 EV 代码签名证书。
- macOS (Apple Silicon)：
Kition-arm64.dmg - macOS (Intel)：
Kition-x64.dmg - Windows：
Kition-Setup.exe（per-user，默认装到%LOCALAPPDATA%\Programs\Kition） - Windows 便携版：
Kition-portable.zip（不写注册表）
安装步骤 — macOS
双击 .dmg，把 Kition 拖到 Applications 文件夹。第一次打开 Gatekeeper 会询问 — 选 Open。安装包是 notarized 的，所以不会看到那个红色"无法验证"的告警。
如果你下载的是企业内部分发或开发者构建，可能会看到 Gatekeeper 拦截，可以右键 → Open 绕过一次。
- 如果磁盘空间紧张：app 占用约 480 MB
- Rosetta：Apple Silicon 上请用 arm64 版本，性能差异明显
- 多用户机器：建议每个账号单独安装到
~/Applications/
安装步骤 — Windows
运行 Kition-Setup.exe。安装器默认是 per-user 模式，不需要管理员权限，也不会写 Program Files。这样在公司锁屏的机器上也能装。
如果有 SmartScreen 提示"不常见"，点击 More info → Run anyway。EV 签名几天后会逐步累积信任。
- 默认安装目录：
%LOCALAPPDATA%\Programs\Kition - 想全机器安装：
Kition-Setup.exe /allusers（需要管理员） - 便携版：解压
Kition-portable.zip到任意目录，运行Kition.exe - 杀软可能首次扫描会慢 — 给安装目录加白名单
首次启动
第一次打开会有一个简短的引导：选 Vault 目录、选界面主题、可选地配置一个 AI provider。Vault 默认放在 ~/Documents/Kition，可以随时在 Settings → Vault 改动。
引导结束后，应用会在后台启动 Go sidecar（监听本地 loopback 上的随机端口）。这是 Agent、表数据库和文件索引服务，完全不出网，除非你显式配置了 provider。
- 第一次索引可能持续几秒到一分钟 — 取决于 Vault 大小
- 系统托盘图标可以快速切换 Vault / 显示 sidecar 状态
- 右下角 status 圆点：绿色 = sidecar 就绪
常见安装问题
- "App is damaged" (macOS)：
xattr -cr /Applications/Kition.app清掉 quarantine 属性 - macOS 启动卡在白屏：删
~/Library/Application Support/Kition/Cache/后重启 - Windows 安装器报 0x80070643：旧版本残留，先在 Settings → Apps 卸载干净
- Sidecar 起不来：防火墙拦了 loopback — 把
Kition.exe加进允许列表 - 企业环境 SSL 中间人：参考
configure-provider配置自定义 CA
验证安装
想确认 sidecar 真的在跑？菜单栏 Help → About 会显示当前版本号和 sidecar 端口。或者打开 Settings → Diagnostics 跑一次 self-check，它会检查 keychain 读写、Vault 写权限、provider 连通性。