设置

从左侧导航打开 设置。设置按用途分为个人、集成、编码、数据和回收站几组。

常用设置

页面	用途
账户	登录、退出和查看当前账户状态
常规	启动行为、声音、语言、消息展示、权限和更新重启策略
应用	无项目工作目录、网页搜索方式和集成终端 Shell
外观	主题、字号和动效
配置	添加模型厂商、API 地址和模型
个性化	设置每次对话都遵循的个人偏好
键盘快捷键	查看和自定义常用快捷键
持续化任务	设置目标规划器和验证器使用的模型
扩展	管理 Skill、MCP 和插件
浏览器	设置内置浏览器及其可用范围
本地工具组件	配置 Tesseract OCR 和 gopls 等本地组件
SSH	管理远程开发连接
导入	从 Codex、Claude Code 导入聊天记录和项目
已删除对话	查看、恢复或永久删除已删除的对话

当本地已经存在可用的模型配置时，Keenkind 会直接使用本地配置，并隐藏不再需要的账户与登录入口。模型密钥保存在本机，不会显示在聊天消息中。

更新重启策略

在 常规 中可以选择更新完成后如何重启：

• 打断任务并立即更新：更新准备完成后立即安装并重启，当前任务会被结束；
• 任务结束后自动重启（默认）：等待所有任务完全结算后再自动更新重启；
• 手动重启：在后台下载并校验更新，由你手动触发安装和重启。

网页搜索方式

在 应用 中可以选择 Keenkind 访问网络的方式：

• 已禁用：不允许 Keenkind 搜索网页；
• 已缓存：优先使用本地搜索缓存，未命中时通过当前搜索服务查询并缓存 24 小时；
• 已索引：通过当前搜索服务刷新索引结果，并保留本地缓存作为失败回退；
• 实时：跳过本地缓存，直接获取当前搜索服务的最新结果。

本地工具组件

在 集成 > 本地工具组件 中可以启用并配置本机已安装的工具：

• Tesseract 5 文字识别：按需识别 PDF 图像页，需要指定可执行文件路径、语言数据目录和识别语言（逗号分隔，最多 8 种）；
• gopls 代码定位：使用已安装的 gopls 提供 Go 语义定位；组件不可用时查询会报告降级范围。

这些配置不会自动下载任何组件。保存后仅新查询采用新配置；正在执行的查询维持启动时的配置。

导入聊天记录

在 数据 > 导入 中可以扫描并导入这台电脑上的 Codex 或 Claude Code 聊天记录和项目：

1. 点击 重新扫描 检测本地数据；
2. 查看可导入的聊天数和项目数；
3. 确认导入。

导入只会关联仍然存在的项目文件夹，不会复制、移动或修改源文件。超长消息可能在导入时被截断。

本地配置文件

Keenkind 的用户配置文件位于：

~/.keenkind/<environment>/config.toml

<environment> 为 production（生产版）或 development（开发版），开发与生产数据物理隔离。

它用于保存模型、界面和其他可迁移设置。API Key 等敏感信息由应用单独保护，不建议手工写入配置文件。

修改配置时优先使用设置界面。只有在迁移、备份或排障时才直接编辑文件，并在修改前完全退出 Keenkind。

用户目录

~/.keenkind/<environment> 还可能包含用户主动安装或生成的内容：

目录	内容
skills	本地 Skill
plugins	本地插件
images	保存到 Keenkind 的图片

删除扩展时，可以选择仅从 Keenkind 卸载并保留本地文件。这样便于继续开发或稍后重新安装。

备份与迁移

1. 从系统托盘完全退出 Keenkind。
2. 备份 ~/.keenkind/ 目录（包含生产或开发环境目录）。
3. 在新设备安装 Keenkind 后，先启动并退出一次。
4. 恢复需要的配置、Skill、插件和图片。
5. 重新打开 Keenkind，检查模型和扩展状态。

不要把包含密钥或登录状态的目录提交到代码仓库，也不要在聊天中发送 API Key。