进阶 jean.build 2026-10-18 10:33:18 · 27 阅读

第19章 重置设置

重置设置

通过删除本地配置目录来彻底重置 Jean。这在认证、偏好设置或会话状态出现异常时非常有用。 Jean 将所有本地状态集中存储在一个配置目录中。 当某些内容卡住时——例如过期的认证循环、损坏的偏好设置或异常的 UI 状态——最快的修复方法是退出 Jean 并删除该目录。应用会在下次启动时自动重建它。

重置的内容

清空配置目录会清除:

* 偏好设置和 UI 状态 * 项目列表和会话元数据 * 恢复快照和粘贴的图片 * Jean 管理内置的 CLI 安装(Claude、Codex、OpenCode、GitHub) * Webview 的 Cookie、缓存和本地存储

以下内容不会受影响:

* 磁盘上的 Git 仓库或工作树 * 存储在配置目录之外的后端凭据(例如,macOS 钥匙串中的 Claude Code-credentials 条目) * 系统级安装的内容,如通过 Homebrew 安装的 gh 二进制文件

具有破坏性

删除配置目录会移除你的项目列表和会话历史。如果其中有值得保留的内容,请在继续操作前将 `preferences.json` 和 `projects.json` 复制到安全位置。

设置存储位置

Jean 使用标识符 `com.jean.desktop` 的 Tauri 应用数据目录。

| 平台 | 路径 | | :--- | :--- | | macOS | `~/Library/Application Support/com.jean.desktop/` | | Linux | `~/.local/share/com.jean.desktop/` | | Windows | `%APPDATA%\com.jean.desktop\` |

开发版和 Nightly 版使用 `com.jean.desktop.dev` 代替 `com.jean.desktop`。

重置前准备

* 完全退出 Jean——在 macOS 上按 Cmd+Q,在 Windows 和 Linux 上从托盘退出。正在运行的应用在退出时会重写部分文件。 * 可选:从配置目录备份 `preferences.json` 和 `projects.json`。

重置配置目录

macOS: ```bash rm -rf ~/Library/Application\ Support/com.jean.desktop ``` 开发版: ```bash rm -rf ~/Library/Application\ Support/com.jean.desktop.dev ```

Linux: ```bash rm -rf ~/.local/share/com.jean.desktop ``` 开发版: ```bash rm -rf ~/.local/share/com.jean.desktop.dev ``` 如果你设置了 `$XDG_DATA_HOME`,请将其中的 `~/.local/share` 替换为相应路径。

Windows: ```powershell Remove-Item -Recurse -Force "$env:APPDATA\com.jean.desktop" ``` 开发版: ```powershell Remove-Item -Recurse -Force "$env:APPDATA\com.jean.desktop.dev" ``` 或使用 CMD: ```cmd rmdir /s /q "%APPDATA%\com.jean.desktop" ``` 开发版: ```cmd rmdir /s /q "%APPDATA%\com.jean.desktop.dev" ```

仅重置特定部分

如果只有状态的一部分损坏,可以删除单个文件而不是整个目录:

* `preferences.json` - 应用偏好设置、默认值、键盘快捷键 * `projects.json` - 项目列表 * `ui-state.json` - 窗口和面板状态 * `sessions/` - 会话历史和元数据 * `recovery/` - 崩溃恢复快照

路径解析规则与上述相同,只需在末尾追加文件或文件夹名称即可。

重启 Jean

再次启动 Jean。应用将以首次运行状态启动并重建配置目录。请重新添加你的项目,并重新认证任何已清除的后端。

如果问题在重置后立即重现,请记录操作步骤并在 coollabsio/jean/issues 提交 Issue——这通常表明存在 Bug 而非设置卡死。

延伸阅读

* 设置与自定义 * 归档、恢复与更新 保持工作区整洁,恢复有用的历史,并了解 Jean 如何更新和清理本地状态。

评论 (0)