Appearance
Kiro IDE Linux 每次启动都弹出设置向导的修复方法
问题
在 Linux 上安装 Kiro IDE 后，每次启动都会重新弹出初始配置向导（onboarding wizard），无法持久化已完成的设置。重新设置后下次启动仍重复此问题。
受影响的发行版：Ubuntu 22.04、Debian Bookworm、Pop!_OS、Linux Mint 等
根本原因
通过 tar.gz 手动解压安装 Kiro 时，直接运行的是原始二进制（/opt/kiro/Kiro/kiro），而不是wrapper 启动脚本（/opt/kiro/Kiro/bin/kiro）。
Kiro 依赖 wrapper 脚本设置正确的环境变量和用户数据目录，直接运行原始二进制会导致配置无法持久化到正确位置，表现为每次启动都像"首次运行"。
解决方案
方案一：使用 wrapper 路径启动（推荐）
bash
# 结束当前 Kiro 进程
pkill -f "/opt/kiro/Kiro/kiro" || true
# 使用 wrapper 启动
/opt/kiro/Kiro/bin/kiro方案二：修复 .desktop 快捷方式
如果你通过桌面快捷方式或启动器启动 Kiro，编辑 .desktop 文件，确保使用 wrapper 路径：
bash
# 找到 .desktop 文件
find ~/.local/share/applications /usr/share/applications -name "*kiro*" 2>/dev/null
# 编辑，将 Exec 行改为 wrapper 路径
# 修改前：Exec=/opt/kiro/Kiro/kiro %U
# 修改后：Exec=/opt/kiro/Kiro/bin/kiro %U方案三：使用包管理器安装（避免此问题）
通过 .deb 或官方包管理器安装 Kiro，可以避免此问题：
bash
# 下载 .deb 包（从 kiro.dev/download 获取最新链接）
sudo dpkg -i kiro_latest_amd64.deb
# dpkg 安装会自动创建正确的 .desktop 文件和路径快速验证
修复后启动 Kiro，完成初始配置，关闭重启——如果设置正常保留，说明问题已解决。