桌面应用
日志与配置文件位置
排查问题时第一个该查的地方 — 三大平台的路径。
总览
Kition 桌面端由两部分组成：Electron 主进程负责 UI，Go sidecar 二进制负责本地索引、Vault 同步与 provider 调用。两者各自有日志，但都写在同一个 logs/ 目录下，方便整体打包。
配置目录里除了 settings.json，还包含 sidecar 的工作状态、provider 凭据缓存以及最近一次崩溃 dump。如果你在反馈问题，请把日志目录整个压缩发回 — 单独抓一行往往不够上下文。
macOS
- 日志：
~/Library/Logs/Kition/ - 配置：
~/Library/Application Support/Kition/ - Sidecar 状态：
~/Library/Application Support/Kition/sidecar/ - Keychain：通过 Keychain Access 搜 "Kition"，provider key 与 Vault 加密种子都在这里
- 崩溃 dump：
~/Library/Logs/DiagnosticReports/Kition_*.ips
# Tail the most recent main + sidecar logs
tail -f ~/Library/Logs/Kition/main.log ~/Library/Logs/Kition/sidecar.log
# Open the config folder in Finder
open ~/Library/Application\ Support/Kition/
# Zip the full log dir for a bug report
cd ~/Library/Logs && zip -r ~/Desktop/kition-logs.zip KitionWindows
- 日志：
%APPDATA%\Kition\logs\ - 配置：
%APPDATA%\Kition\ - Sidecar 状态：
%APPDATA%\Kition\sidecar\ - 凭据：Windows Credential Manager 中前缀为
Kition: - 崩溃 dump：
%LOCALAPPDATA%\Kition\Crashpad\reports\
# Open the logs folder
explorer "$env:APPDATA\Kition\logs"
# Tail the main process log in PowerShell
Get-Content "$env:APPDATA\Kition\logs\main.log" -Wait -Tail 200
# Zip the log dir for a bug report
Compress-Archive -Path "$env:APPDATA\Kition\logs\*" -DestinationPath "$HOME\Desktop\kition-logs.zip"Linux（experimental）
Linux 构建目前是 experimental — 走的是 XDG 基本目录规范，路径与 macOS / Windows 不同。AppImage、deb、tarball 都共用同一组位置。
- 日志：
~/.config/Kition/logs/或$XDG_STATE_HOME/Kition/logs/ - 配置：
~/.config/Kition/ - 凭据：Secret Service（libsecret） — GNOME Keyring 或 KWallet
常用排查命令
日志按天轮转，保留最近 14 天。如果你要快速定位某次失败，grep -i error 加上时间戳往往是最快的入手点。
Sidecar 日志里包含 provider 请求耗时、本地索引重建进度、Hook 触发记录 — 它是排查 Agent 异常的主战场。
# macOS / Linux — find all errors in the last 24h of sidecar log
grep -iE 'error|panic|fatal' ~/Library/Logs/Kition/sidecar.log | tail -50
# Find which provider call timed out
grep -E 'provider=.*duration=' ~/Library/Logs/Kition/sidecar.log | tail -20
# Tail the live sidecar log filtered for hook events
tail -f ~/Library/Logs/Kition/sidecar.log | grep -E 'hook='提高日志详细度
默认日志级别是 info。在排查疑难问题时可以临时切到 debug，记得排查完切回 — debug 模式下日志体积会增长约 5-10 倍。
日志级别既可以在 Settings → Advanced → Log level 里改，也可以通过环境变量启动 — 后者适合需要在干净状态下复现问题的场景。
# macOS — relaunch with debug logging
KITION_LOG_LEVEL=debug open -a Kition
# Windows PowerShell — relaunch with debug logging
$env:KITION_LOG_LEVEL="debug"; Start-Process "$env:LOCALAPPDATA\Programs\Kition\Kition.exe"