项目与会话管理
桌面端按项目和工作目录整理会话。你可以创建项目并添加多个工作目录、管理会话,也可以从当前会话或历史轮次派生副本,或在侧边面板中发起独立提问。
工作区管理
项目用于把多个相关工作目录放在一起。新建项目时指定主目录,并可继续添加源文件夹;编辑项目时可以改名、增删源文件夹,或从主目录的 .kimi-code/local.toml 导入旧版附加目录。会话、草稿、文件预览和终端按项目隔离。
可以通过以下方式添加工作目录:
- 新建会话后,点击输入框上方的文件夹名称打开工作区选择器,从最近使用的文件夹中选择,或点击“选择文件夹…”添加新的本地文件夹;
- 添加时选择“直接输入绝对路径”,路径会以本地绝对路径解析;
- 将 Finder 或文件资源管理器中的文件夹拖到侧边栏,直接添加为工作目录。
新添加的文件夹会加入当前项目,并进入最近使用的文件夹列表。空会话必须先选择工作目录才能发送消息;已有项目、工作目录和会话可以直接从左侧切换。
项目包含多个工作目录时,在文件树顶部选择“切换文件树根目录”即可切换要浏览的根目录。打开未信任的文件夹时,桌面端会提示是否信任该工作区;选择不信任则无法在其中发送消息。
会话管理
工作区内的会话支持新建、切换、重命名、归档、恢复、删除、Fork、导出、置顶和搜索。归档、搜索、恢复和导出用于管理历史会话。
需要清理已归档会话时,在 设置 → 已归档的会话 中直接删除。
当前会话的标题显示在顶部栏,并在首轮对话后由 AI 生成。你可以在会话项中重新生成标题,也可以通过标题右侧的“更多”菜单执行会话操作。
在应用外修改 AGENTS.md、技能或配置后,输入 /reload 或在会话标题的“更多”菜单中选择“重新加载会话”,即可立即应用这些变更,无需重启桌面端。会话生成期间和已归档时不能重新加载。
Fork 会话
Fork 用于在不破坏当前对话的前提下尝试另一种方向:它会基于当前会话或所选历史轮次派生一份副本,原会话不受影响;副本以“Fork: ”前缀命名,与原会话彼此独立,可以分别继续。
对会话项使用 Fork 操作,或在输入框输入 /fork,都可以派生当前会话。已完成回复的历史轮次底部会出现“从此处分叉”,新会话只保留所选轮次及之前的内容。
运行中的会话可以从会话行菜单选择“分叉会话”。源会话会继续执行;新会话保留当前用户输入,但不带入尚未完成的回复或工具输出。
侧边提问
侧边提问(临时对话)基于主会话的上下文创建一个临时副本:在右侧面板新建“新对话”标签页,即可在不打断主会话的情况下讨论其他问题。
- 临时对话不会保存为普通会话,其中的聊天内容也不会影响主会话;
- 临时对话只能使用只读工具,不能修改文件;
- 它和 Fork 会话不是同一功能:Fork 会派生一份独立保存、可以继续工作的会话副本,侧边提问的对话在关闭标签页后不可恢复。
与 CLI 共享会话
桌面端与 CLI 共用本地会话数据。通过任一客户端创建的会话,均可在另一客户端的会话列表中打开并继续。同一会话已在其他客户端打开时,再次打开会显示占用提示和正在使用该会话的客户端名称,可一键重试;重试后仍被占用时,可以选择接管会话。接管前请确认原客户端已经退出,避免两个客户端同时写入导致会话历史交错。若两者同时运行,会话列表及内容可能无法实时同步;重启或重新加载相应客户端后,可获取最新状态。