对话基础

消息是怎么呈现的

• 流式输出 — 回复逐字出现,随时可点停止。

• 思考过程 — 推理型模型的思考默认折叠为一行(✦ 思考过程),点开可看全文。

• 工具调用 — AI 动手干活(读文件、跑命令等)时,每一步以工具卡片内联展示,连续的步骤自动折叠成组,点开看详情。见工具与审批。

• 待办与计划 — 复杂任务中 AI 会展示自己的待办清单和计划卡片,进度一目了然。

• 右侧面板 — 窗口够宽时,聊天右侧显示本次任务的概览卡,agent 也可以把做出来的东西直接摆在那里。见 Agent Desk 与任务概览。

消息操作

悬浮在消息上可以:

插话等待区

AI 干活的过程中你可以继续发消息:补充要求、纠正方向,不用等它跑完。任务跑动期间发出的消息先停在输入框上方的等待区,还没有进入对话:

• 每条都可以删掉,也可以按 ↑ 撤回到输入框里再改;

• 点立即插话会打断当前任务,消息马上送达;

• 不打断的话,消息会在任务跑到合适的节点时送入,并从等待区移进对话里。

被打断的那条回答会被标记出来,下一轮 agent 知道任务还没做完,会接着往下干,而不会当成已经收尾。

斜杠命令

在输入框的任意位置输入 / 都能唤出命令菜单,已经写好的内容保留。内置命令按用途分组,常用的几条:

• 看状态:/help /status /cost /tools /agents /mcp /plugins

• 管会话:/export(全量高保真导出)、/copy、/retry、/compact(压缩上下文,带进度条)

• 调配置:/approval(切换审批档)、/memory、/config、/login

自定义命令:在 ~/.tangu/commands/ 里放一个 md 文件,文件名就是命令名,正文就是发出去的提示词。正文里可以写 $ARGUMENTS(命令后跟的全部内容)或 $1…$9(逐个参数),调用时自动替换。

把东西拖进聊天

从工作区把会话、笔记、文件拖进输入框,松手即生成一条引用:

• 拖笔记或文件 — agent 读得到它的内容;

• 拖会话 — agent 读得到那个会话里聊过什么,适合"接着上次那件事往下办"。

会话之间

• 侧栏的会话悬停即预览摘要,不点开也知道那条聊的是什么。

• [[ 双链补全可以引用会话,把一次对话挂进笔记网络。见双链与属性。

• 新开的会话延续你上次用的审批档、模型与思考档,不必每次重设。审批四档的含义见工具与审批。

项目详情与 Git

会话属于某个本地项目文件夹时,右栏的详情会变成项目详情,其中「Git」页显示分支、上游、改动和最近提交,也能直接操作:

• 创建 Git 仓库:文件夹还不是 git 仓库时出现。会建好 .git,没有 .gitignore 时顺手写一份常用的忽略规则,但不会自动提交。Tangu 不会自己替你建仓,建不建由你决定。

• 提交…:先列出这次会提交的全部文件,再由这条会话的模型写提交信息(计入额度),你可以改。有已暂存的改动时只提交已暂存的部分,其余改动原样留着;没有暂存时提交全部改动(.gitignore 里的不算)。常见的密码 / 密钥类文件(如 .env、私钥)、单个超过 50 MB 的文件、多到不像话的新文件,或者夹在里面的别的 git 仓库,都会被拦下并点名,补好 .gitignore 再提交。

• 新建分支…:从当前位置建分支并切过去,未提交的改动会一起带过去;名字预填分支前缀。

• 推送:推到当前分支的上游;还没有上游时推到 origin(只有一个远端时推到它)并设为上游。需要输入密码的推送不会弹出等待,会直接报错,这时请在终端里完成一次登录。

这些动作按你自己的 git 配置执行(钩子、签名、LFS 照常生效)。但如果仓库自己带着会在你电脑上执行程序的配置(比如钩子、过滤器),Forsion 会先列出这些配置,等你点「信任这个仓库」之后才读取改动、提交或推送;信任只需要一次。下载或解压来的项目,确认来源可信再点。提交时钩子要是往提交里加了清单之外的东西(比如重新生成的文件),提交照常完成,Git 页会点名这些文件、提醒推送前先检查 —— Forsion 不会替你撤回。

以下情况 Git 页只显示状态、不给操作:默认工作区(所有不在项目里的对话共用的文件夹)、编码工作室托管的项目(版本在编码工作室的「版本」里管),以及位于更大仓库子目录里的项目(请在仓库根目录的项目里操作)。

设置 → 常规 → Git 里可以改分支前缀(默认 tangu/)、写提交说明(比如「用中文写」「遵循 Conventional Commits」),以及允许推送时改写远端历史(带 --force-with-lease --force-if-includes,远端有你本地还没合进来的提交时仍会拒绝)。Agent 在对话里替你建分支、写提交信息时,也会照前两项来。

出错与中断

• 请求因网络抖动失败时会自动重试(最多 3 次,间隔 1.5 / 3 / 4.5 秒),聊天区出现琥珀色提示,例如:

  ⟳ 网络波动,3.0 秒后自动重试(第 2/3 次)

  重试成功后提示自动消失。

• 回复已经开始输出、中途断线时会自动接着写,单次任务最多续 3 次。

• 报错给出的是能照做的说明(额度用尽、单轮成本超限、输入过长等),而不是英文错误码。额度相关见账号、额度与积分,其余错误的含义见常见问题。

快捷键

常用操作均有快捷键,可在 设置 → 选项 → 快捷键 中查看和自定义。

下一步

• 模型与接入方式

• 工具与审批

• Agent Desk 与任务概览

• 附件与图片