Kimi Code Desktop 多目录项目与会话 Fork 指南

把相关目录放进同一个项目

2026 年 11 月 4 日的 Desktop 1.3.0 发行说明介绍了多目录项目与会话分叉等改进。一个项目可以组合多个本地工作目录：创建时先选主目录，再添加相关源目录；编辑时可重命名项目、添加或移除目录，或从主目录的 .kimi-code/local.toml 导入旧式附加目录。

会话、草稿、文件预览和终端按项目隔离。多个目录属于同一个项目时，可在文件树顶部选择 Switch file tree root 来切换当前浏览的目录；这个选择只是切换文件树根目录。

从会话标题处打开 Show session information 后，右侧面板会按目录列出主目录标记、分支、相对上游领先或落后的提交数（ahead/behind）、变更和 拉取请求（PR）。这些状态有助于定位要检查的目录，但不能证明测试已经通过或更改已经发布。

为会话选定本地工作目录

新建会话后，点击 消息输入区（Composer）上方的文件夹名称打开工作目录选择器，可以选择最近使用的目录，也可以点 Choose folder… 添加另一个本地目录。选择 Enter an absolute path directly 可输入本机绝对路径；也可以从 Finder 或 File Explorer 将文件夹拖到侧边栏。

新目录会加入当前项目和最近目录列表。空会话必须先选好工作目录才能发送消息；如果打开不受信任的文件夹，应用会询问是否信任该工作区，拒绝信任会阻止在其中发送消息。发送任务前核对 消息输入区上方显示的目标目录，避免把工作交给错误的项目位置。

从一轮已完成的历史对话创建 Fork

要从一轮已完成的对话继续另一条思路，选择该轮下方的 Fork from here。新会话保留选中这一轮及之前的对话，原会话不会因创建 Fork 而改变。也可以从会话条目执行 Fork，或在消息输入区输入 /fork 创建当前会话的副本。

Fork 会单独保存为带 Fork: 前缀的会话，之后两段对话可以分别继续。文档定义的是对话复制，没有说明会创建 Git 分支或独立工作区（worktree）、恢复文件或隔离并发文件编辑；需要文件版本或隔离时，应单独使用项目已有的 Git 与备份流程。

运行中 Fork 会保留当前提示

如果源会话还在运行，在会话列表的该行菜单中选择 Fork session。源会话会继续执行，新副本保留当前用户提示，但不包含尚未完成的回复和工具输出。

因此，新副本不会替代源会话，也不能用来确认仍在运行的操作最终做了什么。需要结果时，回到源会话查看其后续回复；Fork 适合保留当前对话节点，另行尝试一条路线。

侧聊适合临时只读讨论

在右侧面板打开 New conversation 会创建基于主会话上下文的临时侧聊。它只能使用只读工具，不能修改文件，也不会保存为常规会话；关闭该标签后，侧聊内容无法恢复。

需要留下可继续的对话副本时使用 Fork；只想围绕当前上下文临时询问、又不打断主会话时使用侧聊。两者的保存方式和工具权限不同，不要把侧聊当成已保存的 Fork。

确认使用条件并准备诊断信息

Quick Start 当前列出的最低系统要求是 macOS 13.0 或更新版本（Apple Silicon 与 Intel）、64 位 Windows 10 或更新版本，以及 x86_64 Linux；macOS 12 不再接收更新。官方 Kimi 模型需要登录 Kimi 账号并具备会员资格，具体可用模型随会员方案而异；第三方模型提供方需单独配置。资料未确定各地区可用性或 工作区或 Fork 的单独价格，需按实际账号与提供方条款确认。

遇到启动缓慢或失败、白屏、内部错误或意外退出时，可从应用菜单或系统托盘菜单选择 Help → Export Diagnostics…，导出的 ZIP 会保存到系统 Downloads 文件夹。它包括日志、启动状态、白屏快照，以及最近 30 天的本地崩溃报告；启动加载页也提供导出、打开日志文件夹或重启选项。

诊断包包含本地日志和崩溃信息，发送给官方支持前先自行查看包内内容。导出功能是收集排查资料的入口，不代表资料已被自动清理或适合直接公开。