会话设置
在 App 内配置会话行为、权限、会话记录展示及工具渲染。
会话设置界面用于控制 Kaiwu 会话在应用中的运行行为。
常用控制项保留在主界面;其余项则归入各自的子界面中,以确保主界面清晰易览。
查找位置
打开设置 → 会话。在详细会话行为下,你会看到四个页面:
| 子界面 | 包含内容 |
|---|---|
| 输入框与发送 | 回车发送、消息历史、输入框外观,以及智能体忙碌时的发送行为。 |
| 提供商用量与限额 | 用量限制恢复,以及输入框旁的提供商用量仪表盘。 |
| 恢复与交接 | 基于重放的恢复,以及跨设备迁移会话的默认设置。 |
| 运行时与终端 | tmux、Windows 终端窗口,以及终端连接兼容性。 |
权限和会话记录 并不 在这里——它们本身就是设置中的顶级条目。工具渲染则可从“会话记录”中进入。如果你在“会话”界面中找不到这些项,原因便在于此。
会话主界面保留项
会话主界面保留了影响日常工作流的核心控制项:
- 会话列表行为:如信息密度、分组、隐藏非活跃会话、标签,以及待处理会话的显示位置
- 新建会话快捷方式行为:如项目快捷方式是否复用该项目最新会话的选项配置
- 移动端会话布局:用于在手机端驾驶舱布局与经典聚焦界面布局之间切换,以及开启或关闭驾驶舱的滑动切换会话手势
- 消息发送行为:如打断与排队/等待策略
- 输入框交互行为:如回车发送
- 消息历史范围下拉菜单
- 输入区布局偏好
- 重放 / 恢复默认设置
- 会话交接默认设置
- 终端连接选项
- 附加 / 本地控制启动默认设置:如 tmux 与 Windows 远程会话模式
这样可以确保主界面专注于常用工作流设置,避免混入大量繁杂的高级设置项。
会话列表关注设置
会话主界面上的活动与状态信号分组,决定了会话列表如何处理需要你操作介入的会话。
待处理会话用于设置这类会话的显示位置:
- 保留在原位置(默认):列表完全保持现有的分组与排序规则
- 置顶分组:在列表顶部单独生成一个待处理分区
- 移至当前分组顶部:会话仅在其所属的文件夹或工作区分组内部上浮
将已处理会话保留在“待处理”中用于设定当会话不再需要你介入时的行为:
- 关(默认):会话会自动移出待处理区域;你可以通过会话操作菜单中的保留在“待处理”中手动留存关键会话
- 开:所有会话都会一直保留,直到你手动选择从“待处理”中移除
无论选用哪种默认行为,针对单个会话的手动设置都具有更高优先级。这两项配置均基于账户全局生效,会自动同步到你的其他设备。
完整指南:会话已读与未读状态
会话交接设置
独立的会话交接界面用于配置跨设备迁移会话时的默认行为。
包含以下选项:
- 传输工作区
- 工作区冲突策略
- 忽略的文件
- 直连会话目标模式
工作区传输默认设置
默认情况下,Kaiwu 会关闭工作区传输。
你可以将默认行为更改为:
- 默认传输工作区
- 默认保持目标工作区不变
在每次交接时,弹窗中仍支持单独覆盖此设置。
冲突策略
默认冲突策略可选:
- 创建同级副本
- 替换现有路径
该选项用于控制当目标路径已存在时的处理方式。
忽略的文件
默认的忽略文件模式可选:
- 排除忽略的文件
- 包含选定的被忽略文件
若选择包含选定的被忽略文件,可设置以逗号分隔的包含通配符(glob),例如:
dist/**.env.local
直连会话目标模式
此设置仅在源会话当前处于直连状态时生效。
可选项包括:
- 保持直连
- 转为同步
该设置将作为交接弹窗中的默认选项,但在实际操作中仍可逐次覆盖。
完整工作流请参阅会话交接。
附加与本地控制设置
会话主界面还包含了相关默认配置,用于控制在应用中启动的会话后续如何通过终端接续运行。
tmux 集成
若希望支持的会话在 tmux 中启动,请启用 tmux 集成。
适用于满足以下条件的设备:
- 已安装
tmux; - 希望先从应用启动,随后再在 Shell 中运行
KAIWU attach ⟦K3⟧进行接管; - 希望 Claude 或 Codex 等提供商在同一个由 tmux 支撑的本地主机中重新打开。
Windows 远程会话模式
针对 Windows 设备,“会话”界面还提供了默认 Windows 远程会话模式选项。
可选模式包括:
- 隐藏——将会话保持在后台运行,供远程应用访问
- Windows Terminal——在专属的 Windows Terminal 宿主中启动会话,以便后续在本地直接接续操作
- 控制台——在可见的控制台宿主中启动会话
此项为全局默认设置。你仍可通过以下方式进行针对性覆盖:
- 在设备详情界面按设备单独覆盖
- 在新建会话流程中(所选设备为 Windows 时)按会话单独覆盖
优先级次序如下:
- 会话级选项
- 设备级覆盖
- 全局会话设置
完整工作流请参阅附加到运行中的会话。
权限界面
独立的权限界面将两类不同层面的配置解耦拆分:
1. 默认权限
该部分针对已启用的每个后端分别展示一行,供你为新建会话指定默认权限模式。
关键细节:
- 列表项为动态加载
- 数据源自解析出的后端目录
- 内置后端与已配置的自定义 ACP 后端均可在此显示
- 若某个后端在当前账户、构建版本或设置中未启用,则不会显示
2. 应用权限更改
该配置现已独立为专属的下拉菜单分组。
用于控制运行中会话的权限变更何时生效:
- 立即生效
- 下一轮提示词
若希望正在运行的会话即刻响应,请选择立即生效;若希望在下一轮交互才启用变更、避免中途干扰当前执行,请选择下一轮提示词。
当相关功能可用时,该界面还会显示配套的权限及会话默认控制项,例如提示词显示位置,以及各后端选项的会话记录存储默认策略。
完整指南:权限
新建会话快捷方式设置
会话设置主界面包含新建会话弹窗分组。
该分组包含新建会话向导配置行(用于设置向导选择器的呈现样式),以及基于项目创建会话的快捷方式设置。
记住上次项目会话选择设置用于控制在会话列表中点击项目 + 按钮时的行为。
开启后,Kaiwu 会直接读取该项目分组内最新会话的配置来初始化新建会话界面。这将复用包括设备、文件夹、引擎、配置文件、权限、模型、会话模式、MCP 选择、已连接服务以及提供商配置选项在内的各项设置。
关闭后,项目 + 操作仅会预选该项目的设备与文件夹,新建会话界面的其余项则遵循常规的草稿或默认行为。
上下文快捷方式在复用快捷方式源配置的同时,会保留你已输入的草稿内容(如未发送的提示词)。这样既能留存编辑意图,又不会错误带入其他项目的过时选项。
完整指南:新建会话快捷方式
会话记录界面
会话记录界面用于控制会话对话内容的展示方式:
- 会话记录布局
- 思考过程展示
- 工具栏边框模式
- 工具调用分组与折叠预览行为
- 动效与滚动默认行为
- 代码及 Diff 对比呈现
此处均为表现层设置,不会改变提供商的运行行为或工具权限。
部分与会话记录相关的默认设置(例如新建会话的会话记录存储默认策略)仍与后端类型绑定。也就是说,内置后端与已配置的 ACP 后端可以具备各自独立的默认行为。
工具渲染界面
工具渲染界面用于控制工具调用在会话记录中的显示方式。
包含以下配置:
- 工具详情默认行为
- 针对单个工具的自定义覆盖
- 展开视图与全屏视图的独立覆盖规则
当你需要对不同工具设定差异化的默认表现时,该功能十分有用,例如:
BashReadEditDiffWebSearch
例如,你可以让时间线中的大多数工具保持紧凑收起,而在展开 Diff 或 Patch 时显示更充分的内容。
相关指南:工具时间线与标准化
输入框交互行为
会话设置还包含消息输入框的交互控制。
这些设置仅改变你在应用中键入和发送提示词的方式,不会影响提供商权限、模型行为或会话记录的存储机制。
回车发送
回车发送用于控制在输入框中按下 Return / Enter 键的行为。
关闭时:
- 按回车键将在输入框中换行
- 发送消息需点击发送按钮
开启时:
- Web 端:按回车键直接发送消息
- Web 端:按 Shift+回车键换行
- 配备外接键盘的 iOS 及 iPadOS 设备:按回车键直接发送消息
- 配备外接键盘的 iOS 及 iPadOS 设备:按 Shift+回车键换行
Kaiwu 仅在输入框存在可发送内容时才会执行发送。内容可以为键入的文本、附加的文件,或包含的代码审查批注上下文。内容为空或处于禁用发送状态时,按键将被忽略。
偏好即时聊天风格的工作流时,可启用回车发送;若经常需要撰写长篇提示词、代码块或多行指令,建议保持关闭。
Web 端与原生客户端的设置相互独立存储,因此你可以在一个平台上启用回车发送,在另一个平台上保持回车换行。
在未连接实体键盘的手机和平板电脑上,界面上可见的发送按钮依然是发送提示词最直观的方式。
移动端会话布局
移动端会话布局用于控制手机尺寸屏幕下的会话界面排布结构。
该设置与账户同步,默认值为驾驶舱(Cockpit)。
驾驶舱
驾驶舱是手机端的默认布局。
底部会显示一个包含会话核心工作面板的标签栏:
- 当前智能体对话界面,带有对应的后端标识(如 Claude、Codex 或 OpenCode)
- 文件
- Git
- 标签页:用于查看已打开的文件预览、编辑器、代码审查、提交详情、贮藏详情以及其他详情视图
- 终端:启用内置终端且可作为会话标签页时显示
如果你希望移动端会话能呈现为紧凑的工作区、而非单纯的一长串聊天列表,建议选用驾驶舱布局。
经典
经典布局延续了原先适用于手机端会话的单屏聚焦模式。
如果你更习惯将文件、Git、终端及各项详情作为独立的聚焦路由页面打开,而不是在驾驶舱标签栏中来回切换,请选择经典布局。
你随时可以通过设置 → 会话 → 移动端会话布局调整该选项。
滑动切换会话
滑动切换会话默认处于启用状态,并且会随账户自动同步。
启用该功能后,在驾驶舱底部区域左右滑动,即可按照最近浏览的会话列表顺序直接切换至上一个或下一个会话,无需退回列表界面。点击返回按钮仍可回到会话列表。
若不希望底部区域触发滑动手势,可将其关闭。此项设置仅对移动端 App 的驾驶舱生效,Web 端与桌面客户端均不受影响。
完整说明:滑动切换会话。
消息历史
消息历史现已改为下拉选择框,取代了原先的行内开关组合。
你可以指定输入框历史记录的保留范围:
- 按会话独立保留,或
- 全局保留
这种设计让当前生效的配置项更加一目了然。
找不到某项设置?
如果你印象中曾见过某项行内设置,它大概率是被归入了上述四个子界面之一,而非被移除;另外,“权限”、“会话记录”和“工具渲染”并不属于“会话”设置项下的子内容。