会话与分支
会话将消息、工具活动和结果保存在一起。同一项工作的后续要求可以继续在原会话中提出;无关任务适合新建对话,尝试其他思路则可以从较早消息分叉。
新建和整理会话
Section titled “新建和整理会话”先选择工作区,再新建对话。点击会话标题栏中的标题即可重命名。已有会话会立即保存;新建对话会在首条消息创建会话时沿用这个名称。侧栏菜单仍提供重命名、置顶和归档。归档会从普通列表中隐藏会话,之后可以在设置 → 归档中恢复。
删除不可恢复:它会移除保存的历史,清理关联产物,以及仍绑定到该会话的 worktree。删除前请保留需要的成果和改动。会话、侧聊或子代理仍在运行时,Wuu 会拒绝删除。
首条消息发送后,工作区侧栏会立即显示正在创建的会话;创建期间可以切换离开再回来。点击停止可取消等待并保留输入。即使创建结果稍后才返回,也不会发送已取消的消息或保留未使用的空会话。再新建对话会使用独立草稿。
普通侧栏的最近汇总跨工作区的会话。打开窗口时,运行中的会话排在最前,其次是未读会话,之后是按更新时间排列的其他会话。阅读或切换会话只清除未读标记,不改变位置;鼠标或键盘焦点离开列表后也不会补做重排。持续输出和标题更新同样保持顺序。
新会话会出现在最近列表的最上方,包括首条消息仍在等待开始时。已有会话在开始运行或结束后保持相对位置。你可以拖拽会话保存偏好的顺序,之后新加入的会话会排在它们前面。鼠标停留在列表、键盘焦点位于其中或正在拖拽时,新条目会等到操作结束后显示;你正在创建或选择的会话除外。状态标记仍及时更新。最近最多显示 50 条并支持折叠,更早的会话仍可通过工作区或搜索找到。
会话仍保留在各自的工作区列表中。已置顶和已归档的会话不列入最近。最近标题旁的撰写按钮会在当前工作区新建对话;未选择工作区时,会使用第一个可用工作区。
macOS 上,点击任意桌面输入框(包括 Coding 和 Personal Agent 对话)里的麦克风即可开始听写。首次使用时允许麦克风和语音识别权限。波形反映麦克风音量;点击停止会等待最终转写,再把文字追加到现有草稿。录音中直接点击发送,会先完成转写,再按当前会话的发送规则提交。
点击取消或切换会话会结束听写,保留原有草稿。识别使用当前界面语言,需要这台 Mac 支持该语言的设备端语音识别;不支持时会显示原因。
Wuu 任务停止或失败后,保持输入框为空,点击发送控件上的继续,也可以点击失败提示中的继续。它从已保存的有效活动历史启动新轮次,不会重复插入原问题。重新打开会话或重启 Wuu 后仍可继续;输入新要求时仍按普通消息发送。
已完成回复、签名推理和已确认的工具结果会保留给模型。未完成的流式片段可能仍显示在旧轮次中,但不会进入后续模型请求。若工具可能已产生副作用,而结果尚不明确,Wuu 会阻止继续;先检查相关工作,再发送新要求。继续不会关闭工具重放保护。
若断流前已有完整 assistant 条目,自动恢复不会重放旧请求并清除这项进展,而是保留它供用户明确继续。
自动恢复是独立流程:连接等待显示等待网络恢复,其他恢复显示正在重试请求,结束后区分恢复额度耗尽与无法安全重放。停止会取消当前请求和退避等待,不会自动安排新轮次。双击和过期请求不会启动并发的继续操作。
自动重试保留现有负载配置和共享工作流限制。新的模型步骤有自己的操作额度;传输切换、嵌套恢复、可能已计费的请求和等待仍共用工作流预算。成功进展不会重置共享预算。用户明确继续会在上一轮结束后启动新工作流。
重启后选择继续的任务
Section titled “重启后选择继续的任务”Wuu 意外退出或更新重启打断正在运行的会话后,提示会显示上一次运行中被打断的会话数量。提示显示时仍可正常使用 Wuu。点击全部继续,即可让这些会话从已保存的进度继续。若部分会话恢复失败,数量会更新为剩余会话,供你重试。先前已完成、失败、正常退出或手动停止的轮次,以及旧的后台结果,不计入被打断的会话。
关闭提示会让这些会话保持暂停。打开历史或收到后续完成通知都不会自动续跑;之后可以在会话中继续,或发送新要求。关闭提示会保留历史和待处理结果,不会撤销之前的操作,也不会停止单独管理的后台命令。已归档会话和插件私有会话不计入待恢复数量。
恢复未发送文字
Section titled “恢复未发送文字”窗口重新加载后,Wuu 会自动恢复其中尚未发送的文字,无需开启设置。恢复副本仅保存在当前窗口本地,最多保留 24 小时、20 条草稿,每条最多 32K 字符;关闭窗口会清除副本。附件和引用上下文不会恢复,恢复的文字也不会自动发送。
点击侧栏的搜索对话,或按 Command + P(Windows 和 Linux 上为 Ctrl + P)。未输入关键词时,先显示置顶对话,再按最近更新时间显示其他对话。输入后会跨项目搜索标题和历史内容,包括已归档对话。每条结果显示所属项目;内容命中时,在同一行组内显示带匹配词强调的片段。其他信息相同的结果还会显示最后更新的日期和时间。
使用方向键和 Enter,或直接点击结果。带消息地址的用户和助手消息命中会展开并高亮对应消息,包括较早轮次。长消息会加载完整内容并滚动到匹配文本;标题、元数据和工具记录命中会正常打开对话。打开归档结果不会将它恢复到侧栏。按 Escape 关闭搜索,焦点回到打开搜索前的控件。
选择新对话的工作位置
Section titled “选择新对话的工作位置”新对话和已有对话都会在输入框下方显示所属项目及当前 Git 分支。开始对话前可以选择项目,已有对话保留原来的项目绑定。选择其他分支会在当前工作树中检出它,编辑器、终端和使用同一工作树的其他会话都会看到这次切换。工作树内有任务运行时,分支切换不可用。
任务需要隔离的检出目录时,可以让 AI 创建并使用工作树。输入框不再提供手动工作树开关。
收起右侧工具栏后,权限、上下文用量和模型选择会显示在输入框下方。浏览器、终端、文件和新页面入口保持隐藏,重新展开工具栏后恢复。
输入框支持以下键盘操作:
| 按键 | 操作 |
|---|---|
| Enter | 发送草稿;引擎支持引导运行中的任务时,在该处结束当前可见回复并在同一轮继续 |
| Command + Enter(Windows 和 Linux 上为 Ctrl + Enter) | 没有运行中的任务时发送草稿;有任务运行时,若支持排队且草稿非空,则留到本轮结束后处理 |
| Shift + Enter | 换行 |
| Escape | 输入框允许中断时,停止运行中的任务 |
/ 菜单打开时,Enter 和 Tab 用于选择命令。其余情况下 Tab 保持普通焦点切换。发送控件会反映当前引擎是支持即时引导,还是只能排队。
引导正在生成的模型回复时,Wuu 会在当前可见文字处结束这一段输出。片段会作为已打断的回复保留在对话中,新消息紧接在它后面出现,同一轮任务继续发起下一次模型请求,不会另开一轮。若工具正在执行,Wuu 会等当前工具批次结束后再继续,不会取消已经启动的工具。使用 Command + Enter(Windows 和 Linux 上为 Ctrl + Enter)排队时,消息仍会留到下一轮。
在已保存的对话中,排队消息和即时引导会先保存到本地,再确认已接收,包括附件和文档上下文;编辑和移除也会保存。核心进程重启后,尚未进入对话历史的输入会保留为待处理消息,由你查看、编辑、移除或明确发送,不会自动执行。已经进入历史的输入,即使执行中断,也不会再次排队。临时对话仍只保存在内存中;这项恢复不保存尚未发送的草稿。
最终答复完成后,按 Enter 或点击发送会开启正常的下一轮对话,分屏中也一样。后台收尾、已加载会话的后台刷新不会阻止发送。即使在附件准备期间切换页面,消息仍发往提交时的会话和工作区。如果消息被接收前,另一轮任务先启动,Wuu 会将消息及附件排队,在该轮结束后接续,无需再次发送;如果在交接期间点击停止,消息会保留为待处理内容。
其他原因导致发送失败时,如果原输入框仍为空,Wuu 会恢复输入。如果已经切换会话或输入了新草稿,失败的内容会保留在原会话中;如果连会话创建都失败,错误提示会提供打开保留草稿或丢弃它的操作。失败内容不会自动重试。
点击停止可以中断任务,但不会撤销已经执行的命令或文件改动;独立管理的后台工作可能还需要单独停止。继续前先检查当前 diff 和命令结果。
展开处理过程可以查看工具调用。run_code 行会显示操作描述;没有描述时显示简短的代码预览。展开该行可查看和复制完整源码、程序输出,并查看错误信息。较长的代码和输出可在各自的区域内滚动。
引用答复中的一段文字
Section titled “引用答复中的一段文字”在助手答复中选中已显示的文字,即使答复仍在输出,也可以选择添加到对话;也可以先选择批注,在选中段落旁添加可选批注。只要选中文字仍然有效,后续追加输出和本轮完成都会保留选区与批注;选中段落改变时,菜单会关闭。选区会作为引用卡片出现在该会话输入框上方的附件栏中,分屏中也一样。每条引用保存的是选取时已显示的文字。打开卡片可以查看原文、修改批注、移除选区或定位来源。无需另写消息也可以直接发送选区;发送、排队和即时引导都会把引用原文及批注加入模型输入。
切换标签页或退出分屏时,已选文本片段会随草稿保留。发送失败或编辑保留的消息时,引用会单独恢复,不会把序列化上下文塞入输入框。原答复已经加载且可见时,查看原文会高亮准确的选中位置;原答复隐藏、未加载或已改变时,会提示不可用,而不是跳到另一处相同文字。请先打开原会话并加载对应答复,再重试。
旧版宿主可能丢弃引用元数据,但保留发送的文字;旧版桌面端可能不显示结构化引用。请搭配使用当前版本的宿主和桌面端,以便在编辑与历史恢复时保留结构化引用。原生客户端会以普通文字显示引用和批注。
附加粘贴的长文本
Section titled “附加粘贴的长文本”粘贴的长文本会作为 .txt 附件出现在输入框上方,与图片、文档和引用放在一起。已有指令保留在输入框中;如果粘贴时选中了文字,只移除该选区。点击卡片会将完整原文直接铺回输入框,方便编辑,之后按普通消息文本发送;保持附件状态时则按文件发送。移除一份附件不会影响其他附件和指令。短文本仍按普通文字粘贴。
发送时,Wuu 会在工作区状态目录下的 sessions/<thread-id>/input-attachments/ 中生成 UTF-8 工作文件。模型收到文件引用,需要时通过文件工具读取内容,不再将整段粘贴原文直接放进上下文。会话历史保留包含原始空白的完整文本快照,用于预览、编辑和重新发送。
文本工作文件与图片工作文件一样,七天后过期。清理不会删除历史快照或已保存到缓存目录外的副本。打开历史不会重建过期文件;重新发送附件会生成新的工作副本。需要保留超过七天时,请把文件保存到工作区。
操作粘贴的图片
Section titled “操作粘贴的图片”粘贴图片或选择图片文件后发送消息,Wuu 会保存一份本地工作文件,并将绝对路径与用于视觉理解的图片一同交给模型。你可以让模型通过普通文件和命令工具复制、移动或处理这个文件。工作文件保留后端收到的字节;桌面端发送前的图片压缩仍然适用。
上下文压缩省略图片数据时,图片说明和摘要输入的媒体索引会保留工作文件路径。压缩不会重建已丢失的文件,也不会延长文件的有效期。
工作文件位于工作区的 Wuu 状态目录下的 sessions/<thread-id>/input-images/,七天后过期。Wuu 会在 app-server 启动时及运行期间每六小时检查过期文件,因此实际删除可能晚于过期时间。清理不会移除会话历史中的图片,也不会删除已复制或移动到缓存目录外的文件。如需长期保留,可以让模型把图片保存到工作区;如果工作文件已经过期,请重新发送图片。
从较早消息分叉
Section titled “从较早消息分叉”在历史消息上选择分叉,再选择新会话在哪里工作:
| 选项 | 新会话使用的文件 |
|---|---|
| 派生到本地 | 与原会话相同的目录 |
| 派生到 Git worktree | 从源仓库当前 HEAD 创建的独立目录 |
分叉会复制到所选消息为止的对话历史,但不会把文件恢复到那一刻。worktree 从已提交内容开始,不复制未提交的改动;如需继承这些改动,应先检查并提交,再创建分叉。不能创建 worktree 时,对话框会说明原因。
询问旁支问题
Section titled “询问旁支问题”使用 /side 可以询问进度、解释输出或比较方案,消息不会加入主对话。也可以在仍在输出或已完成的助手答复中选中文字,选择在侧边聊天中提问;侧聊输入框会显示相同的选区标签,发送问题时会附上原文作为来源上下文。是否可用取决于执行引擎。需要长期开展的另一项工作,更适合新建会话或分叉。
在 CLI 中使用已保存会话
Section titled “在 CLI 中使用已保存会话”wuu session listwuu session show --lastwuu session search "关键词"wuu exec resume THREAD_ID "继续这个任务"wuu exec --continue 继续最近的会话;--ephemeral 运行时不保存会话。选择会话和脚本选项详见 wuu exec。