对话与执行

对话页面承载项目上下文中的 Agent 协作，是主线上 Chat 阶段的落点。Agent 在这里分析需求、检索代码佐证、引导团队权衡取舍，与你一起收敛出决策，再继续推动 Proposal 和 Apply & Archive 阶段。

主要能力

• 管理 Workspace 内的会话列表
• 通过 /chat/<session-id> 独立 URL 直达、刷新恢复和定位每个真实会话
• 按标题、Session ID 或对话正文搜索当前 Workspace 的历史会话
• 将重要会话置顶到独立分组，重启后仍保持置顶状态
• 独立折叠“置顶会话”和“最近会话”分组；少量置顶会话按内容收缩，最近会话使用剩余高度
• 选择已安装的 ACP Agent
• 在首条消息前选择 FylloCode 或 原生 会话模式
• 通过单一菜单查看和修改 Agent 提供的 Session 配置
• 在 Chat header 查看固定的 Session scope，区分当前 Workspace、快照外成员和 stale 成员
• 从 Chat header 复制当前 FylloCode Session ID
• 发送文本和附件上下文
• 展示 Agent 的思考、工具调用、子 Agent 调用、流式输出状态和本轮文件变更
• 把聚焦任务委派给其他已安装的 ACP Agent，并查看同步或后台 spawned Session
• 支持 Mermaid、Markdown 等结构化内容展示
• 在 Markdown 阅读区域和工具 Locations 中安全预览 Agent 提供的绝对本地文件路径
• 在任务上下文中推进 proposal 创建和后续阶段
• 从任务发起的会话显示来源任务横幅，重新进入会话仍可见
• Agent 可通过 fyllo-action 提议创建任务、提交 plan 审阅、标记或复核 knowledge，由你确认后由 FylloCode 接管执行
• Agent 可通过 Fyllo Signal 显示无需确认的轻量信息；Signal 不进入会话事件栏

管理会话分组

“置顶会话”和“最近会话”按最近活动时间分别排序。每个非空分组都可以独立折叠。两个分组同时展开时，置顶组按标题和会话条目的实际高度展示，最多占会话列表可用高度的 50%；最近组使用剩余空间。任一组内容溢出时会在组内独立滚动。只有一个组展开或存在时，该组使用标题之外的全部剩余高度。

折叠不会中断后台执行，重新展开会恢复原来的滚动位置。分组状态只保留到当前 Chat 侧栏卸载，不会写入会话元数据。

搜索历史会话

点击“新建会话”旁的“搜索会话”，可以按标题、FylloCode Session ID 或 User / Assistant 的可见对话正文搜索当前 Workspace。搜索不读取其他 Workspace，也不匹配 reasoning、Tool 输入输出、附件内容或 system reminder。结果按标题、Session ID、正文的命中优先级排列，同类结果按最近更新时间排序，最多显示 50 条。

输入框会等待短暂输入停顿再查询，并且同一窗口不会并行扫描多份会话历史。结果包含会话标题、更新时间和可用的正文片段；点击结果会沿用既有会话打开流程，不会改变置顶状态或列表顺序。搜索直接读取现有会话记录，不创建索引或缓存文件。

调整 Session 配置

Agent 提供 Session 配置时，输入框下方只显示一个配置按钮。按钮优先以“model · thought level”的形式显示当前选值；如果只提供其中一项，则只显示该项。两者都不存在时，按钮显示 Config。没有可见配置时，按钮不会出现。

打开菜单后，select 配置通过子菜单展示选项，boolean 配置通过一级 checkbox 直接切换。菜单保持 Agent 提供的配置顺序；修改配置后，FylloCode 使用 Agent 返回的完整配置快照刷新摘要、当前值和可用选项，因此 model 变化带来的 thought level 调整会同步显示。

选择会话模式

新会话在输入框上方提供 FylloCode 与 原生 两种模式，默认选择 FylloCode。发送首条消息后，模式会固定在 Session metadata 中，Chat header 以 badge 显示当前模式；既有 Session 不能中途切换模式，历史 Session 缺少该字段时按 FylloCode 读取。

• FylloCode：使用创建 Session 时固定的 Workspace scope，向 Agent 提供内置 MCP，并注入 specs、guidelines、knowledge、Task 与 Fyllo Action / Signal 等协作上下文。
• 原生：仍使用同一份固定 Workspace scope 和 Agent 提供的 Session 配置，但不提供 FylloCode bundled MCP，也不注入 FylloCode system reminder 或恢复历史 reminder。

原生模式适合只需要 Agent CLI 桌面界面的会话。它不会影响 Proposal Apply、Archive 等由 FylloCode 内部启动的流程。

发送文本与附件

每条用户消息都必须包含 trim 后非空的文本，附件不能单独发送。新会话中选择的图片或文件会先保留为本地草稿和预览，不会因此创建或激活 Session；发送首条消息时，FylloCode 才创建唯一 Session，再按顺序持久化附件和消息。

除了从附件菜单选择文件，也可以把剪贴板图片直接粘贴到输入区，或把图片和普通文件拖放到 Chat 输入面板。粘贴不会阻止浏览器插入剪贴板中的文本，因此文字与图片可以一起进入草稿；拖放只接管文件，文本拖动仍使用系统原生行为。首版不读取目录，拖入目录时会明确反馈并继续接收同批次中受支持的文件。

FylloCode 会按当前 Agent 的图片和嵌入上下文能力检查每个附件。混合批次只保留受支持的项目，并用一次汇总反馈说明被拒绝的图片、文件或目录；被拒绝的项目不会创建预览、附件记录或 Session。

如果 Session 创建、附件保存或首条消息写入失败，未提交 Session 及其附件副本会被清理，输入文字和本地附件草稿会保留以便重试。已有 Session 中的附件继续在选择后保存到当前 Session，不改变其归属。

复制 Session ID

打开已有 Session 后，Chat header 右侧的“会话操作”菜单提供“复制会话 ID”。它复制当前 FylloCode Session ID，不是底层 ACP session ID；写入剪贴板成功或失败时都会显示明确反馈。草稿态没有可复制的 Session，因此不显示该入口。

定位历史消息

本次会话存在至少两条 user prompt 时，对话区左侧会出现垂直居中的悬浮时间线。2–10 条 prompt 各对应一个导览刻度；更多 prompt 固定使用 10 个刻度，但整条时间线仍连续映射到完整历史。独立的 teal thumb 跟随当前阅读位置，时间线不会因对话变长而持续增高或占用消息列宽度。

悬停或使用方向键时，摘要浮层最多显示当前 prompt 附近五条摘要。点击时间线或按 Enter 会固定完整 prompt 列表；列表独立滚动，点击任一摘要即可定位对应消息。拖动或滚动滚轮可以逐条快速定位，Home 和 End 跳到首尾，Escape 关闭摘要浮层。少于两条 prompt 时时间线不显示。

阅读 Agent 执行过程

正在生成的 assistant 消息会在已有内容之后显示运行状态指示，包含通用状态文案和自然单位耗时。该状态只表示当前回复仍在处理，不会根据工具调用推断 Agent 正在做的具体动作；流结束、失败或取消后指示会移除，历史消息不会保留这段运行时状态。

连续的 Thinking 和普通工具调用会收拢为一个可折叠的 Activity group。展开 group 后，可以分别查看每个 Thinking、Tool 的完整 Input 和 Output；失败工具使用错误色图标，并在 Error 分区保留错误文本。工具标题不追加运行状态后缀，进行中的工具继续使用 shimmer，因此展开多个工具不会因隐藏状态节点产生横向滚动。

FylloCode 会识别 ACP 1.3 的 read、write、edit、delete、move、search、execute、think、fetch 与 switch mode 等工具语义，并在直接工具和 Activity 摘要中使用一致的图标和分类。未知或未来新增的类型安全回退为通用工具，不会根据 Agent 身份猜测类别。

如果工具返回结构化 ACP diff，详情中的 Changes 会列出本工具涉及的新增、修改或删除路径。打开任一路径后，“本轮文件变更” Slideover 会聚合当前 assistant message 中可见普通工具的净变化，以默认折叠、可多项展开的只读 Diff 列表展示。本视图使用消息中保存的执行快照，不重新读取磁盘，不聚合整个 Session，也不代表当前 Git 或 worktree 状态。工具提供的 Locations 可以沿用本地文件预览打开绝对路径和行号。

当 Claude Code 通过 Agent 工具启动子 Agent 时，父调用会渲染为独立卡片。打开详情后，可以查看 prompt、状态、模型、token、耗时、工具统计、子工具活动和最终回复。详情只连接同一条 assistant 消息内可安全确认的父子工具关系；无法关联的工具仍按普通工具展示。

委派到其他 ACP Agent

FylloCode 模式会在当前 Agent 支持 HTTP MCP 且后端可用时提供 fyllo-spawn。父 Agent 可以选择另一个已安装的 ACP Agent，把一个边界清楚的任务同步执行，或作为后台 turn 运行。多个 spawned Agent 共享父 Session 固定的 Workspace 目录，因此并行委派应使用互不重叠的文件范围。

每个真实会话都有独立的 /chat/<session-id> URL，可以从任务页、会话搜索或 lineage 直接定位，刷新后也能恢复到同一会话；/chat 本身保留为未发送首条消息的草稿入口。会话路由无效、缺失或不属于当前 Workspace 时，会回退到 /chat 并给出提示。

新建 spawned Session 后，Main 会自动把当前父 Session 名下的所有 spawned Session 暴露到对话区底部的活动栏；活动栏显示“子 Agent N”总数和正在运行的数量，点击后按活跃优先、最近更新优先列出每个 Session 的 Agent、同步或后台模式、状态、Prompt 预览和更新时间。打开任一 Session 会显示按 Turn 组织的只读详情 Slideover，默认选中最新 Turn，可切换历史 Turn，查看该轮的原始 Prompt、聚合 Activity、压缩 Transcript、状态和 response ID。这些入口只读，不能继续、取消或重试任务，切换到其他 Session 后只显示新父 Session 名下的子 Agent。

历史 assistant 正文中的 spawn.session Signal 仍可作为深链打开同一详情，但它只是可选的上下文入口，不再承担 Session 发现或状态更新。后台 spawned turn 完成后，完成通知会像普通回复一样流式进入父会话，期间该会话显示运行状态并暂时禁用发送；同一会话的多条完成通知按顺序逐条处理。

关闭 Workspace 窗口不会把详情视为任务事实来源；重新打开后会重新查询 Main。后台 turn 不跨应用进程继续运行，重启后未完成的记录会显示为已中断。完整 tool、并发、超时和响应读取契约见 fyllo-spawn MCP。

查看 Context 用量

已有 Session 收到 token usage 后，输入区会显示 Context 使用率。低于 75% 使用正常色，75% 起为黄色，90% 起为橙色，95% 起为红色。Tooltip 始终显示当前 Context 用量；进入风险区间后还会提示留意后续用量、总结当前对话或新建会话。Cost 与 Remaining 不在这个 Tooltip 中显示，但底层 usage 数据仍保留。

Session scope

创建多根 ACP Session 时，FylloCode 会固定当时的 Workspace 成员快照。具备额外目录能力的 Agent 可以同时访问授权的多个 Project；Workspace 后续增删或移动成员不会改变已经运行的 Session。Chat header 的 scope popover 会列出每个 Project、路径和主 Project 标识，并在当前 Workspace 与 Session 快照不一致时显示提醒。关于多根 Workspace 要解决的问题和授权边界，见多根 Workspace。

预览本地文件

Agent 输出的 Markdown 链接或工具 Locations 如果指向 POSIX、Windows drive 或 UNC 绝对路径，点击后会在窗口级 Slideover 中打开只读预览。当前 Session 快照中各 Project 的根目录和已注册 worktree 内的文件可直接读取；指向这些可信根之外的文件时，FylloCode 会在读取内容前显示完整规范路径、大小和修改时间，并要求选择“仅打开一次”或“打开并在此窗口中信任”。

预览只接受不超过 5 MiB 的 UTF-8 普通文本文件，不支持目录、设备、二进制或无效 UTF-8 文件。链接末尾可使用 :line[:column] 定位源码；预览允许搜索、选择和复制，但不提供保存或回写。窗口信任只保存在当前 Renderer Window 的内存中，关闭窗口或重启应用后会失效。

所有文本文件都可以在“内容溢出”和“自动换行”之间切换。识别为 Markdown 的文件还会显示“原文”和“预览”模式；“预览”使用共享 MarkStream 渲染当前只读快照。关闭 Slideover 后，这些查看选择不会保留。

Fyllo Signal

Fyllo Signal 是 Agent 在 assistant 正文中输出的被动展示标记。show.time 会把时间标签显示为非交互 pill；spawn.session 会按消息所属父 Session 查询并打开只读的 spawned Session 详情。Signal 不需要确认，不创建 Action 状态，不进入会话事件栏，也不改变待处理数量。历史 Signal 只从已保存的 assistant 文本重新渲染，详细协议见 Fyllo Signal 参考。

会话事件栏

对话区右侧是可折叠的会话事件栏，收纳三类不会打断当前讨论、但需要留意的信息：

• Agent 待办：Agent 在本次会话中给出的执行项列表
• Proposal 卡片：本次会话中创建的 proposal 及其实时状态
• fyllo-action 待处理项：knowledge.flag、knowledge.review 等 rail 类型 action 的只读摘要和定位入口；确认操作仍在对话正文的内联卡片中完成

事件栏可以随时折叠为窄条，展开状态会在会话间保持。

与 lineage 的关系

从任务发起的会话会自动绑定到该任务的 lineage 脉络；直接发起的会话会创建一条 chat 起源的脉络，之后可以补建任务回到主线。会话中通过 fyllo-specs 创建的 proposal 也会自动记录到同一条脉络上，无需手动关联。

工作方式

FylloCode 模式会把项目规范、历史决策、任务上下文和 guidelines 组织成 Agent 可读取的背景，让 Agent 在更明确的边界内工作。原生 模式保留 Agent 默认工作方式，不注入这些 FylloCode 协作能力。

对话页面负责把聊天结果送入可治理流程：当问题收敛、决策确定后，应该生成 Proposal；Proposal 通过后进入 Apply & Archive，把实现与变更记录沉淀下来。