无极开物Docs
在会话中工作

会话设置

在 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. 会话级选项
  2. 设备级覆盖
  3. 全局会话设置

完整工作流请参阅附加到运行中的会话。

权限界面

独立的权限界面将两类不同层面的配置解耦拆分:

1. 默认权限

该部分针对已启用的每个后端分别展示一行,供你为新建会话指定默认权限模式。

关键细节:

  • 列表项为动态加载
  • 数据源自解析出的后端目录
  • 内置后端与已配置的自定义 ACP 后端均可在此显示
  • 若某个后端在当前账户、构建版本或设置中未启用,则不会显示

2. 应用权限更改

该配置现已独立为专属的下拉菜单分组。

用于控制运行中会话的权限变更何时生效:

  • 立即生效
  • 下一轮提示词

若希望正在运行的会话即刻响应,请选择立即生效;若希望在下一轮交互才启用变更、避免中途干扰当前执行,请选择下一轮提示词。

当相关功能可用时,该界面还会显示配套的权限及会话默认控制项,例如提示词显示位置,以及各后端选项的会话记录存储默认策略。

完整指南:权限

新建会话快捷方式设置

会话设置主界面包含新建会话弹窗分组。

该分组包含新建会话向导配置行(用于设置向导选择器的呈现样式),以及基于项目创建会话的快捷方式设置。

记住上次项目会话选择设置用于控制在会话列表中点击项目 + 按钮时的行为。

开启后,Kaiwu 会直接读取该项目分组内最新会话的配置来初始化新建会话界面。这将复用包括设备、文件夹、引擎、配置文件、权限、模型、会话模式、MCP 选择、已连接服务以及提供商配置选项在内的各项设置。

关闭后,项目 + 操作仅会预选该项目的设备与文件夹,新建会话界面的其余项则遵循常规的草稿或默认行为。

上下文快捷方式在复用快捷方式源配置的同时,会保留你已输入的草稿内容(如未发送的提示词)。这样既能留存编辑意图,又不会错误带入其他项目的过时选项。

完整指南:新建会话快捷方式

会话记录界面

会话记录界面用于控制会话对话内容的展示方式:

  • 会话记录布局
  • 思考过程展示
  • 工具栏边框模式
  • 工具调用分组与折叠预览行为
  • 动效与滚动默认行为
  • 代码及 Diff 对比呈现

此处均为表现层设置,不会改变提供商的运行行为或工具权限。

部分与会话记录相关的默认设置(例如新建会话的会话记录存储默认策略)仍与后端类型绑定。也就是说,内置后端与已配置的 ACP 后端可以具备各自独立的默认行为。

工具渲染界面

工具渲染界面用于控制工具调用在会话记录中的显示方式。

包含以下配置:

  • 工具详情默认行为
  • 针对单个工具的自定义覆盖
  • 展开视图与全屏视图的独立覆盖规则

当你需要对不同工具设定差异化的默认表现时,该功能十分有用,例如:

  • Bash
  • Read
  • Edit
  • Diff
  • WebSearch

例如,你可以让时间线中的大多数工具保持紧凑收起,而在展开 Diff 或 Patch 时显示更充分的内容。

相关指南:工具时间线与标准化

输入框交互行为

会话设置还包含消息输入框的交互控制。

这些设置仅改变你在应用中键入和发送提示词的方式,不会影响提供商权限、模型行为或会话记录的存储机制。

回车发送

回车发送用于控制在输入框中按下 Return / Enter 键的行为。

关闭时:

  • 按回车键将在输入框中换行
  • 发送消息需点击发送按钮

开启时:

  • Web 端:按回车键直接发送消息
  • Web 端:按 Shift+回车键换行
  • 配备外接键盘的 iOS 及 iPadOS 设备:按回车键直接发送消息
  • 配备外接键盘的 iOS 及 iPadOS 设备:按 Shift+回车键换行

Kaiwu 仅在输入框存在可发送内容时才会执行发送。内容可以为键入的文本、附加的文件,或包含的代码审查批注上下文。内容为空或处于禁用发送状态时,按键将被忽略。

偏好即时聊天风格的工作流时,可启用回车发送;若经常需要撰写长篇提示词、代码块或多行指令,建议保持关闭。

Web 端与原生客户端的设置相互独立存储,因此你可以在一个平台上启用回车发送,在另一个平台上保持回车换行。

在未连接实体键盘的手机和平板电脑上,界面上可见的发送按钮依然是发送提示词最直观的方式。

移动端会话布局

移动端会话布局用于控制手机尺寸屏幕下的会话界面排布结构。

该设置与账户同步,默认值为驾驶舱(Cockpit)。

驾驶舱

驾驶舱是手机端的默认布局。

底部会显示一个包含会话核心工作面板的标签栏:

  • 当前智能体对话界面,带有对应的后端标识(如 Claude、Codex 或 OpenCode)
  • 文件
  • Git
  • 标签页:用于查看已打开的文件预览、编辑器、代码审查、提交详情、贮藏详情以及其他详情视图
  • 终端:启用内置终端且可作为会话标签页时显示

如果你希望移动端会话能呈现为紧凑的工作区、而非单纯的一长串聊天列表,建议选用驾驶舱布局。

经典

经典布局延续了原先适用于手机端会话的单屏聚焦模式。

如果你更习惯将文件、Git、终端及各项详情作为独立的聚焦路由页面打开,而不是在驾驶舱标签栏中来回切换,请选择经典布局。

你随时可以通过设置 → 会话 → 移动端会话布局调整该选项。

滑动切换会话

滑动切换会话默认处于启用状态,并且会随账户自动同步。

启用该功能后,在驾驶舱底部区域左右滑动,即可按照最近浏览的会话列表顺序直接切换至上一个或下一个会话,无需退回列表界面。点击返回按钮仍可回到会话列表。

若不希望底部区域触发滑动手势,可将其关闭。此项设置仅对移动端 App 的驾驶舱生效,Web 端与桌面客户端均不受影响。

完整说明:滑动切换会话。

消息历史

消息历史现已改为下拉选择框,取代了原先的行内开关组合。

你可以指定输入框历史记录的保留范围:

  • 按会话独立保留,或
  • 全局保留

这种设计让当前生效的配置项更加一目了然。

找不到某项设置?

如果你印象中曾见过某项行内设置,它大概率是被归入了上述四个子界面之一,而非被移除;另外,“权限”、“会话记录”和“工具渲染”并不属于“会话”设置项下的子内容。

相关内容

© 乾元执中(南京)科技有限公司 · WUJI-Labs

On this page