Desktop 消息
在桌面客户端查看 Agent 的回答与执行过程
系统要求
macOS 版本需要 macOS 13 Ventura 或更新版本。
输入与焦点
搜索、设置表单和多行编辑使用统一的输入样式。悬浮时背景轻微变化,点击或通过键盘进入后,聚焦背景会持续显示;输入框不绘制外扩光圈,靠近面板或滚动区边缘时也保持在容器内。搜索头和聊天编辑器由整个输入区域表达焦点,内部字段不重复显示背景。只读内容可以选择和复制,禁用字段保持弱化,输入错误在字段旁说明。
聊天草稿会在暂停输入后自动保存在本机。离开输入区或切换会话时,会立即保存待保存的内容;切换回来时,各会话会恢复各自的草稿。
测试 System One 决策模型
在 设置 → 模型 的决策模型区域点击 JEV 或其他决策模型,在详情中使用 测试决策模型。表单预填了可直接运行的示例;修改待判断内容与判断问题,选择布尔判断、选项判断或评分,再点击 运行测试。选项判断每行填写一个不重复的候选项(2–255 项);评分需要填写上下界,区间宽度为 1–9。切换答案类型时,请同步调整判断问题。
结果展示结构化答案、上游提供的概率或选项分布、用量以及本次耗时。失败时在表单内显示错误,可以修改输入后重试。测试使用当前账户,按模型正常计费;关闭详情不会取消已经提交的请求。
City Remote
在 设置 → 通用 → City Remote 启用 HTTP 连接,默认监听 127.0.0.1:5314。开关直接生效;修改地址或端口后点击保存更改。页面显示实际运行状态、连接地址及启动失败原因。把运行中的地址复制到 Chrome 扩展的 City URL,无需另行执行 city on。
在同一页创建 City Token,填写名称、选择允许的 Agents(或明确允许全部现有及未来 Agent)和过期时间。点击创建 Token,在弹窗中选择 30 天、90 天、永不过期或自定义日期。明文仅在创建后的独立弹窗中显示一次,复制到 Chrome 的访问凭据后点击完成。已有凭据可修改范围、有效期或撤销;CLI 的 city token 管理的是同一份凭据。
服务默认关闭,开启设置会在下次 Desktop 启动时恢复。关闭开关、修改监听设置或退出 Desktop 会断开远程连接。Desktop 与 CLI 仍采用单宿主机制,不需要同时启动。127.0.0.1 仅供本机连接;监听其他地址时使用对应机器地址,并自行配置所需的网络访问。
粘贴图片与附件保存
粘贴图片后,输入草稿中的附件以 Data URL 保存在本地 IndexedDB。发送时,Session 会将附件解码保存到自己的 attachments 目录,消息的 file part 记录本地绝对路径,并紧跟一个 attachment_path context part,以“对应图片路径:…”(其他文件为“对应附件路径:…”)向模型提供保存路径。
连续发送与接管
在 Chat 中发送消息时,只有会话空闲且待发送列表为空才会立即提交;当前一轮仍在执行,或待发送列表里还有消息时,新输入会追加到待发送列表末尾,等上一个 Turn 结束后按顺序逐条提交,不会越过前面排队的内容。
列表中的消息在真正提交前只是本地记录:可以编辑、删除、调整顺序,或逐条暂停。⌥/Alt + ⌘/Ctrl + Enter 直接追加一条暂停项,不会自动发送;⌘/Ctrl + Shift + Enter 绕过整个列表立即提交当前输入,不影响列表中的其他消息。提交失败的消息保留在列表中并转为暂停,修复后可以重试。
每一轮工作由发起者占用。同一用户可以持续补充;如果当前工作由其他对象发起,队列提交会被拒绝,消息保留在待发送列表中并转为暂停,不会丢弃。需要接管时,先使用停止按钮,等待当前工作停止,再发送自己的消息。停止只针对界面已显示的那一轮;状态已变化时请刷新后重试。提交被拒绝不会把原有工作标为执行失败。
停止前登记的完成通知仍会携带原任务的停止结果送达,不会使用接管后新一轮的回答。
重试失败的 Agent 回复
当对话中最新可见的消息是已结束且包含可恢复错误的 Agent 回复时,可点击错误卡片右侧的重试。会话忙碌、等待或正在提交,有消息排队、历史记录正在加载,或本次重试仍在提交时,按钮不可用。请先处理待回答问题或操作审批;会话接收重试请求时也会检查这些待处理项。
重试会保留已有输出和工具结果,失败卡片留在历史中,新的 Agent 尝试追加到对话末尾,不会重复显示一条用户消息。Agent 根据现有上下文继续执行,不会从头重放整个请求。已执行的操作仍可能再次发生,重试不保证这些操作的副作用只发生一次。
提交重试期间,按钮显示加载指示并阻止重复点击。提交失败时会显示错误,按钮恢复可用后可以再次重试。
回答问题与操作确认
Agent 的待回答问题和操作审批集中显示在聊天输入框上方,单聊与群聊使用相同入口。交互卡片使用统一浅色背景和圆角,多条待处理项通过左右箭头切换;群聊会标出当前发起的成员。切换待处理项或折叠消息中的工具详情不会清空已填写内容,多题问题也可通过左右箭头返回修改。补充说明按需展开填写。
长内容在待处理区内滚动,聊天输入框保持可见。提交成功后,该项从待处理区移出;提交失败会显示错误并保留内容,可直接重试。工具详情只展示工具执行信息,不重复展示审批卡片或“已允许”等审批结果。待处理交互统一在输入框上方操作,不再提供独立的右侧作答面板。
手动压缩上下文
在已有单聊 Session 的输入框中输入 /,选择 /compact,即可将较早的稳定对话内容合并为上下文摘要,原始聊天记录仍然保留。会话运行中也可以提交;压缩请求进入 Session 队列,在维护检查点按队列顺序执行。压缩与 prompt 共用 Session 队列的忙碌状态,执行期间会话加载指示持续显示,队列全部排空后才结束;连续排队不会在命令之间提前显示空闲。压缩过程与结果显示在聊天时间线中,没有可压缩内容时也会给出提示。新对话草稿不显示该命令。
摘要历史以纯文本传入:用户和 Agent 保留正文,工具只保留结果,省略调用参数、调用 ID、协议状态和 JSON 包装;结构化结果按缩进键值呈现,保留必要的字段含义。压缩与正常对话共用模型可见内容的转换规则,忽略界面展示数据、活动记录和推理过程;附件保留引用与元信息,不重新读取二进制内容。工具结果中嵌套的图片 data URL 和明确的 base64 字段也只保留媒体类型与大小等元信息,同级页面文字、路径和 URL 继续保留;原始工具记录不变。系统以压缩较早稳定内容约 65% 为目标,在完整内容边界选择最近的位置;至少保留 10,000 tokens 的原始历史,此要求优先于比例。历史不超过该保留量,或没有可推进的完整内容时不压缩。保留量不包含 system、旧摘要和工具定义。每次压缩将旧摘要、本次所选的每条历史记录和最终摘要要求分别放入多条纯文本消息,一次请求模型生成新摘要;历史保持原顺序,不再拼成单条超长 user 消息,也不分批反复重写。没有固定的 16k 或 64k 输入限制;已知模型窗口时预留 4,000 tokens 输出和 2,048 tokens 安全余量,放不下时只缩小本次历史范围。窗口未知时不设置人为输入上限。当前模型接口没有 tokenizer,英文、代码与 JSON 按每三 ASCII 字符约一 token、其他字符按码点估算;连续的长编码串按更高 token 密度估算,避免当作普通英文文本。以上并非精确 token 计数。单次摘要输出上限为 4,000 tokens。
完整摘要生成成功后一次保存新摘要与边界;失败保持原摘要和边界不变。传输中断时最多重试同一请求一次,部分生成但尚未保存的摘要会丢弃。HTTP 400 等请求拒绝直接反馈,不自动当作上下文超限。使用新版 Federation 服务时,错误还会包含上游状态码、可用请求 ID 和经过脱敏、长度限制的响应正文,方便定位具体拒绝原因。
窗口与面板
左侧 Sidebar、中间正文和右侧 BayBar 共享窗口空间。调整窗口大小时,Sidebar 优先保持你设置的宽度,正文先随窗口伸缩;空间不足时,BayBar 会先收窄,再自动收起。正文阅读空间继续不足时,Sidebar 也会自动隐藏。默认宽度和 100% 界面缩放下,窗口窄于 860px 时隐藏 Sidebar,重新达到 908px 时恢复;你设置的 Sidebar 宽度和界面缩放会同步调整该阈值。关闭的面板会释放全部占宽。
拖动面板与正文之间的边界可以调整宽度,松开后保存。临时缩小窗口不会覆盖已保存的宽度;重新放大窗口后,自动收起的面板会在空间足够时恢复,手动收起的面板保持关闭。窄窗口中主动打开 BayBar 或点击文件链接时,它会覆盖右侧内容区域,调整窗口大小后重新按可用空间布局。
Sidebar 自动隐藏或手动收起后,将鼠标移到窗口左边缘或顶部 Sidebar 按钮,停留约 150ms 即可浮出导航。浮动导航覆盖在正文上方,正文位置与宽度保持不变。移开鼠标约 250ms 后收起;操作关联菜单、拖拽宽度或在导航内使用键盘时保持展开。点击顶部按钮可固定展开;空间不足时保持浮动,点击外部或按 Escape 关闭。
使用窗口顶部按钮或 ⌘/Ctrl+B 开关 Sidebar,使用右上角按钮或 ⌘/Ctrl+L 开关 BayBar。窗口缩放和面板拖拽立即跟随操作,点击开关时使用短动画;系统开启减少动态效果时省略该动画。
会话层级
Works 侧栏的 Workspace 分组内,子 Session 紧跟所属的父 Session,并逐级缩进。根会话与同级子会话按运行状态优先、最近更新时间其次排列。父会话不在当前 Workspace 分组中时,子会话仍会作为根会话显示。置顶时整棵子树一起进入置顶区,保留层级和展开状态。归档父会话时,其所有层级的子会话也会一起归档;如果其中任一会话正在运行或有排队输入,需要先结束或停止执行。
每个父会话默认最多显示 3 个直接子会话,超出时在第 4 行显示“更多(还有 N 条)”。点击可展开全部子会话,再点击末尾的“收起子会话”恢复为 3 个。多层子会话分别控制展开状态;Workspace 的“更多”按根会话分页,多选范围只包含实际显示的会话。如果当前打开项或已选项排在第 4 个及之后,会自动展开必要的父列表,并暂时禁用该列表的收起操作;切换会话或取消选择后恢复原来的手动展开状态。
置顶会话
在 Works 侧栏中,会话行的更多菜单里选择置顶,这条根会话及其所有层级的子会话会一起移到列表最上方的置顶区,不随任何 Workspace 折叠。置顶区按置顶先后排列,新置顶的在最前;它在行尾标出所属 Workspace。Chat 页头的会话菜单里有同一项,显示为取消置顶。子会话菜单显示“置顶所属会话”或“取消所属会话置顶”,操作作用于所属根会话及整棵子树;取消置顶后,各会话回到所属 Workspace,新建的子会话自动跟随根会话。置顶区同样默认显示 3 个直接子会话,可展开、收起。置顶只用于 Works 侧栏里的会话,群聊会话同样可以置顶。
分享消息与会话
分享图片和 PDF 在文档页首显示 Downcity Logo 与品牌名称,预览和保存结果一致。
在已完成的 Agent 回复下方打开更多菜单,选择分享,在预览中选择保存为图片、保存为 PDF或保存为 Markdown,包含 Agent 名称、发送时间和完整正文。
在 Chat Session 右上角的更多菜单中选择分享,再选择保存为图片、保存为 PDF或保存为 Markdown。导出会读取完整历史,按原始顺序包含用户消息和 Agent 回复;思考过程、工具调用记录和内部上下文不包含在内。Markdown 保留可编辑正文和附件链接;图片与 PDF 保留代码块、表格、数学公式、图片以及内置可视化的静态展示。第三方或无法渲染的可视化使用已发布的文字摘要。
点击分享后先打开预览。顶部通过分段按钮切换图片、PDF 和 Markdown,中间画布居中展示内容,底部集中显示内容开关、复制和保存操作。图片随窗口等比缩放;长图的全部分段按顺序连续滚动展示。
分享单条 Agent 回复时,如果存在上一条用户消息,可开启包含上一条用户消息,将其发送者、时间、正文和附件放在回复之前。默认关闭;切换选项会更新预览,图片、PDF 和 Markdown 保存相同范围的内容。上一条用户消息位于更早历史时也支持,无需先手动加载聊天记录。
PNG 按实际图片分段展示,底部的复制图片会将当前主要可见的那张图片复制到剪贴板,无需先保存文件;PDF 可查看分页,Markdown 展示待保存的源码。确认后点击对应格式的**保存为…**按钮,才会打开系统保存框;取消保存仍保留预览,关闭预览会释放准备的内容。资源加载失败会在预览中提示。
短图片选择文件保存位置;长内容会提示选择目录,并在其中新建文件夹,按顺序保存多张 PNG。PDF 自动分页,文字可选择。完成后可直接打开文件或图片目录;取消保存不会产生导出文件。图片资源读取失败时会提示错误,可以处理资源后重新导出。
消息与文件
点击对话中的工作区文件链接,会在右侧文件面板打开预览,当前对话保持可见。指向其他已注册工作区的文件也在该面板打开;链接带有行号时会定位到对应行。网页链接通过默认浏览器打开。
文件面板与 Workspace 主视图按格式选择预览方式:Markdown 展示排版后的文档;本地 .html、.htm 展示静态网页,支持相对路径的样式表、字体和图片,禁用脚本与页面内跳转。CSV、TSV 展示带行列编号的表格,保留引号内的分隔符与换行,最多展示 1,000 行、100 列。Markdown、HTML、CSV、TSV 均可通过文件菜单中的源码模式查看完整原始文本;带行号的文本链接默认进入源码模式。
Markdown 文件中的相对图片路径(如 images/chart.svg 或 ../images/chart.png)按当前文档所在目录解析,BayBar 文件面板与 Workspace 预览均支持。
Markdown 中标记为 mermaid 的围栏代码块会显示为图表,并随可用宽度调整布局。图表跟随当前主题,可复制源码或打开全屏查看;全屏支持缩放、拖拽、适应窗口和下载保留当前主题的 PNG。生成中的不完整语法会保留最近一次成功图表,生成结束仍无法解析时显示源码与重试按钮。
Markdown 中标记为 svg 的围栏代码块会直接显示为图片,适配可用宽度;BayBar 文件预览与聊天消息均支持。流式生成尚未形成完整 SVG、内容无效或图片加载失败时显示源码。SVG 以隔离图片方式加载,不执行脚本。
PNG、JPEG、GIF、WebP、SVG、AVIF、APNG、BMP、ICO 文件以图片展示,可切换适配面板或原始尺寸。图片独立加载,不经过文本读取接口。其他二进制文件显示用系统默认应用打开按钮,点击后使用系统关联的应用打开;打开失败时显示原因,可再次尝试。文本预览仍限制为 2 MB;代码与配置文件展示源码。
在右侧 BayBar 文件面板中选中文字,选区附近会出现引用浮动按钮。点击后,当前聊天输入框会加入包含工作区、文件路径和选中文字的引用;源码模式还会附带选区行号。引用保留点击时的内容,可以随草稿保存或在发送前移除。清空选区、滚动、切换文件或更新文件内容后,浮动按钮会收起。Markdown、表格预览和源码支持该操作;HTML 网页预览需要先切换到源码模式,图片不提供文字选区引用。
Agent 消息采用左右布局:左侧竖排头像与可选折叠按钮,右侧顶部信息栏显示 Agent 名称和时间,中间展示消息主体,下方展示文件改动。信息栏与主体之间保留间距。复制、引用和分支等消息操作位于全部内容下方;有文件改动时,操作栏显示在文件改动卡片之后。
有执行过程时,头像下方显示箭头折叠按钮,与头像竖向排列。按钮常显,悬停时显示浅色背景;收起时箭头朝右,展开时朝下。点击按钮可展开或收起执行过程,也可以通过键盘操作。
生成过程中,执行过程默认展开;完成后默认收起。收起时隐藏过程,最终回答保持完整可见,不再显示工具摘要折叠栏。只有执行过程而没有最终回答时,左侧箭头仍可用于重新展开。
展开与收起以按钮为滚动锚点。手动切换后,这条消息会保留你的选择。没有执行过程的消息直接展示回答,不显示折叠按钮。