Appearance
KiCode Desktop 是 KiCode 的原生桌面客户端。它把项目、会话、模型、权限确认和结果查看整合到一个界面里，适合日常写代码、读代码、改代码和排查问题。
这份文档只关注桌面端用户最常见的使用方式，不展开 SDK、服务端接口或插件开发。
适用对象
如果你属于下面这些场景，这份文档适合你：
- 你第一次打开 KiCode Desktop，不清楚从哪里开始
- 你想在桌面端里打开本地项目并直接和智能体协作
- 你想知道怎么登录、切模型、切项目、看历史会话
- 你想快速理解哪些设置和日常使用最相关
第一次打开后先做什么
建议按这个顺序完成首次设置：
- 打开 KiCode Desktop
- 登录你的 KiCode 账号
- 打开一个本地项目目录
- 新建一个会话
- 发送第一条需求或问题
登录后，应用会直接使用你的 KiCode 账户额度访问模型。对大多数新用户来说，这意味着可以先用 KiCode 自带的模型开始，不需要准备第三方 API Key。
主界面怎么看
KiCode Desktop 可以粗略分成四块：
- 左侧边栏：项目、最近会话、设置、帮助
- 中间主区域：当前会话的消息时间线和执行结果
- 底部输入区：输入问题、附加文件、切换智能体、选择模型、发送消息
- 顶部或状态入口：查看当前服务器状态，以及切换服务器连接
如果你只想先用起来，先盯住这三件事就够了：
- 打开对的项目目录
- 在输入框里说清楚你要它做什么
- 发送前确认当前模型和智能体是否合适
开始第一个项目
最常见的做法是直接打开你的代码仓库根目录。
你可以用下面任一方式打开项目：
- 通过桌面菜单里的“文件 -> 打开项目...”
- 通过侧边栏中的项目入口选择本地文件夹
打开后，KiCode 会把这个目录作为当前工作上下文。之后的新会话、文件阅读、代码修改和终端操作都会围绕这个项目进行。
建议优先打开仓库根目录，而不是仓库里的某个子文件夹。这样模型更容易理解项目结构，也更方便后续切换文件、查看会话和执行命令。
如何开始一次会话
打开项目后，创建一个新会话，然后直接描述你的目标。
适合第一条消息的写法：
text
先快速说明这个项目是干什么的，核心目录分别负责什么。text
帮我看看这个仓库里登录流程是怎么实现的。text
请在不改接口的前提下，把这个页面的筛选逻辑整理清楚。如果你的需求和某个文件强相关，最好把文件一起附上，或者在消息里明确指出文件路径。这样回复会更稳定，也更少跑偏。
输入区里最常用的几个功能
桌面端最常用的操作基本都在输入区附近：
- 附加文件：把图片、PDF 或文本文件带进当前会话
- 选择模型：切换当前会话要使用的模型
- 切换智能体：在不同工作风格之间切换
- 发送消息：提交当前任务
- 停止生成：中断当前正在执行的回复
日常使用里，最关键的是下面两点：
- 当结果不理想时，先换一种更适合的模型再试一次
- 当任务从“解释”变成“实现”时，确认当前智能体是否适合写代码
模型怎么选
KiCode Desktop 的主流程是登录 KiCode 账号，然后直接在输入区选择当前可用模型。
对桌面端用户，可以把它理解成这样：
- 先登录 KiCode
- 再直接选模型
- 然后开始会话
当前桌面端文档不建议把“连接供应商”当成用户日常操作来讲，因为现在的用户界面已经没有独立的供应商选择与连接入口。
如果模型列表里没有你要的模型，通常先检查下面几件事：
- 你是否已经登录 KiCode
- 当前账号是否已经具备该模型的使用权限
- 你当前连接的服务器是否就是预期的那一个
- 这个模型是否被你在模型管理里隐藏掉了
历史会话和项目切换
KiCode 会把项目和会话保存在左侧边栏中。
你可以：
- 从“最近会话”继续上次的工作
- 在同一个项目下开多个独立会话
- 在不同项目之间切换，而不用手动重新组织上下文
如果你在做多个任务，建议按任务拆分会话，而不是把所有问题都塞进一个长对话里。这样后面回看、续接和排查都会更清楚。
权限确认怎么理解
当 KiCode 需要执行可能影响项目的操作时，界面里可能会要求你确认权限。
你可以把它理解成一层安全闸门。常见场景包括：
- 运行命令
- 修改文件
- 调用会访问外部资源的能力
如果你只是想先让它解释代码、梳理思路、定位问题，通常不需要给太多额外权限。
如果你希望它直接落地修改，就要留意这些确认提示，并在执行前看清楚它准备做什么。
服务器是什么，普通用户要管吗
大多数情况下，不用。
KiCode Desktop 默认会启动并连接本地服务器。普通用户直接使用默认状态即可，不需要手动填写服务器 URL。
只有在这些情况你才需要关心服务器设置：
- 你们团队给你提供了一个统一的远程 KiCode 服务地址
- 你自己在别的环境里运行了服务端，想让桌面端连过去
- 你遇到了连接失败，需要检查是不是切到了错误的默认服务器
如果你没有做过任何服务器配置，就默认把它当成本地模式使用。
建议优先看的设置
桌面端里最值得先看的设置，一般是这些：
- 语言：切换显示语言
- 外观和配色方案：调整浅色、深色或跟随系统
- 主题：切换 KiCode 的视觉主题
- 系统通知：决定智能体完成、报错或请求权限时是否弹通知
- 音效：决定关键事件是否播放声音
- 更新：控制启动时检查更新
Windows 用户如果主要在 WSL 环境里开发，也可以关注 WSL 集成设置。
适合桌面端用户的使用习惯
想让 KiCode Desktop 更好用，建议坚持这几个习惯：
- 先打开正确的项目根目录，再开始提问
- 一次只让它处理一个明确任务
- 让它改代码前，先让它说明思路或定位问题
- 和具体文件有关的问题，尽量附上文件或写明路径
- 不同主题的工作分成不同会话
比起“帮我改一下”，更好的写法是：
text
请先定位为什么这个页面在切换筛选条件后会重复请求接口，再给出最小修改方案。或者：
text
只修改这个组件，不改接口定义，也不要改样式结构。先告诉我你准备怎么改。桌面端里好用的文本编辑快捷键
KiCode Desktop 的输入框支持一组很实用的文本编辑快捷键：
ctrl+a：跳到当前行开头ctrl+e：跳到当前行末尾ctrl+b：光标后退一个字符ctrl+f：光标前进一个字符alt+b：光标后退一个单词alt+f：光标前进一个单词ctrl+d：删除光标所在字符ctrl+k：删除到行尾ctrl+u：删除到行首ctrl+w：删除前一个单词alt+d：删除后一个单词ctrl+t：交换相邻字符ctrl+g：关闭弹层或中止当前回复
如果你经常在长提示词里编辑内容，这组快捷键会明显提高效率。
常见问题
1. 打开后不知道下一步干什么
先做这四步：
- 登录 KiCode
- 打开你的项目目录
- 新建会话
- 发送一句清晰的任务说明
2. 看不到想要的模型
先检查这三件事：
- 你是否已经登录 KiCode
- 当前账号是否有该模型的可用权限
- 当前模型列表是否只显示了部分模型，或该模型被你隐藏了
一条最实用的上手路线
如果你只想快速开始，不想先研究所有功能，按这条路线走就够了：
- 登录 KiCode Desktop
- 打开仓库根目录
- 新建一个会话
- 先让它总结项目或解释某段代码
- 再让它做一个小而明确的修改
- 结果满意后，再逐步尝试切模型、开新会话和调整设置
这样上手成本最低，也最不容易一开始就被模型、服务器、配置这些概念打断。