桌面端快速开始

本页介绍 KeenKind 桌面端。要在 Codex、ZCode 等工具中使用 KeenKind API，请从 API 快速开始进入。

1. 配置模型

打开 设置 > 配置，选择模型厂商。Keenkind 会为已知厂商选择合适的接口类型，通常不需要额外设置协议。

填写配置名称、API 地址、API Key 和至少一个模型 ID。Ollama、vLLM、LM Studio 等本地服务可以不填写密钥。

提示

DeepSeek 提供 OpenAI 兼容接口，但仍应选择 DeepSeek 厂商，以使用正确的默认地址和接口设置。

2. 打开工作目录

在左侧项目区域添加或选择目录。消息中的相对路径会从该目录开始解析，例如：

src/main/index.ts
docs/architecture.md

普通点击可在 Keenkind 右侧栏预览，Ctrl + 点击使用系统默认应用打开。

3. 选择工作风格与权限

Keenkind 提供两种工作风格：

• 工作：资料整理、写作、分析和一般任务。
• 代码：项目调查、代码修改、测试和构建。

输入框附近的权限选项决定 Keenkind 何时需要确认。第一次使用建议保持 请求审批。

4. 发送第一条任务

阅读当前项目的 README 和 package.json，说明如何启动项目。不要修改文件。

需要文件时点击输入框的添加按钮，或把文件拖入输入框。需要引用工作区文件时输入 @；需要选择 Skill 时输入 $。

5. 查看与停止

• 工具调用会显示在助手消息中。
• 文件修改会显示本轮审查摘要。
• 图片结果会显示在回复末尾。
• 浏览器、文件预览和侧边讨论位于右侧栏。
• 停止按钮会终止当前任务。

常见首次问题

现象	检查项
没有可选模型	配置、模型是否启用，模型 ID 是否正确
401/403	API Key、Base URL 和厂商是否匹配
工具没有执行	权限模式、工作目录和对应扩展是否可用
文件不能上传	检查文件类型、大小和数量
浏览器不出现	设置 > 浏览器 是否启用

下一步可以了解桌面端模型配置、权限和扩展概览。