第十九节 状态指示与提示
[!ref] 详解见用户手册「会话」节。
19.1 左侧栏状态点
| 颜色 | 含义 |
|---|---|
| 绿 | 一切正常 |
| 琥珀 | 凭证 1 小时内到期 / 限流警告 / 通道重连中 |
| 红 | 离线 / 凭证已过期 / 严重错误 |
| 灰 | 未登录 |
19.1.1 上下文占用圆环
显示当前上下文窗口占用比例的圆环按占用分档变色：
| 占用 | 颜色 |
|---|---|
| < 75% | 常态色 |
| ≥ 75% | 黄 |
| ≥ 90% | 红（已接近上下文上限，宜续跑 / 折叠） |
19.2 会话标签徽章
| 徽章 | 含义 |
|---|---|
| 数字 | 该会话有 N 条新消息（仅当切换走时累计） |
| 该会话当前有助手在运行 | |
| 🌙 | 该会话当前有后台子任务 |
| 红点 | 该会话有未处理的审批请求 |
19.3 输入框右侧按钮
| 形态 | 含义 |
|---|---|
| 发送（默认） | 助手空闲；点击发送当前输入 |
| 停止 | 助手运行中；点击同步终止主助手 + 所有子任务，并取消本会话的全部会话内例行程序（§18.7） |
| 置灰 | 输入框为空 |
19.4 输入区两个会话级开关
| 开关 | 默认 | 说明 |
|---|---|---|
| 盾牌（无限制模式） | 关 | 见 §14.4.1 |
| 联网（本地模式） | 联网启用 | 点击弹「禁用联网工具？」确认框；开启后禁用内置联网工具，按会话生效，重启恢复；子代理同受限。斜杠命令 /local |
19.5 轨迹面板（Trace）
| 维度 | 取值 |
|---|---|
| 入口 | 会话顶部统计气泡 → 「轨迹」Tab（与 Stats 并列） |
| 数据源 | 会话 JSONL 的服务端聚合；打开加载一次，不轮询；本轮运行结束时自动刷新一次 |
| 运行（run）切分 | 按真实用户消息切分，默认最新一次；每个 run 标签带步数 / 工具调用 / token / 失败数 |
| 步数窗口 | 默认末 500 步（聚合仍全量）；提示「已省略更早的 N 步」，「加载更早」按窗翻页 |
| 过滤 | 全部 / 仅工具 / 仅错误 |
| 子代理下钻 | Agent / AgentParallel 步提供「子轨迹」；下钻态禁跳转消息流（行号属子会话文件） |
| 疑似循环阈值 | 同 (工具, 参数) 指纹重复 ≥ 3 次开始警示 |
| 聚合口径 | 「Token 合计」含已排除出上下文窗口的步；「门禁注入」= 门禁 / goal / compact / todo / 自愈 的自动注入合计 |
| 特殊步 | 「上下文压缩 (SUMMARY)」标注收编条数；「自报暂停」标注 <todo-status>paused</todo-status>（标签不入正文） |
| 趋势 | 「每轮 Prompt」序列（窗口内 assistant 步的 prompt token） |
| 导出 | 见 §24.5 |
| 错误态 | 「读取轨迹失败，点『刷新』重试」 |
工具度量表：每工具的次数 / 失败 / P50 / P95 / 最长耗时。
19.6 待注入队列（即时指导）
| 项 | 取值 |
|---|---|
| 入队条件 | 只看当前会话：Agent 在跑或 IM 出站投递中 → 入队；本会话发送在途或正在生成 → 与在途文本相同则忽略（「上一条还在发送中,已忽略这次重复发送」），不同则入队；其余直接发送 |
| 不入队 | 带待发图片（「运行中不能附图发送」）；还没有会话时文字留在输入框 |
| 输入框占位 | 「即时指导：Enter 入队，本轮结束后整体注入...」 |
| strip | 「待注入 N」（Inbox 图标）；有表单类询问时隐藏；队列不落盘、按会话隔离 |
| 默认发出 | 本轮自然结束或会话空闲时，按入队顺序以 \n\n 合并为一条 user 消息；压缩中不发；只发当前会话 |
「优先」（step_end） |
当前步骤结束后注入（工具结果落地后、下一次请求模型前）；最终回复中则回复完后同进程续跑一轮处理 |
「立刻处理」（interrupt） |
截停当前生成：已出正文 / 思考保留（一字未出时占位「（生成被用户打断）」），未写完的工具调用不执行；执行工具中不打断，按「优先」时机送达。可由「优先」升级，不可降级 |
| 不注入的时点 | 首次请求前、本步以错误收场、尚有待执行的工具调用、步数上限已到 → 留到回合结束后作为新一轮发出 |
| 送出后 | 显示「已优先 · 当前步骤结束后处理」/「立刻处理中」，流回同 id 的 user 记录才出队；不可撤回 |
| 投递失败 | 「现在没法把这条指导插进去,它还在队列里,本轮结束后发出」 |
| 全部清空 | 只清未送出的；toast「已丢弃 N 条待注入的即时指导」 |
| 退回输入框 | 用户停止 / 发送中止或失败 / 重新开始或重新生成失败 / 自愈未起 → 退回；排在现有草稿之前（复述确认条取消时排在原文之后）；toast「已退回 N 条即时指导到输入框」 |
19.7 标记消息
| 项 | 取值 |
|---|---|
| 入口 | 消息右键或消息柄菜单「标记消息 / 取消标记」；尚未落盘（如流式中）的消息不可标记 |
| 角标 | 消息左侧 14px 书签图标，仅作指示（不可点）；悬停 / 开菜单 / 生成中让位给消息柄 |
| strip | 「标记 N」；按消息在会话中的先后排序；无标记时不显示 |
| 点行定位 | 未加载的早期页自动向上拉页；折叠的工具组自动展开；定位途中切换会话即作罢 |
| 复制为 Markdown / 保存 HTML | 只含有正文的消息（非工具结果且内容去空白后非空）；全部无正文时置灰，悬停「标记的消息没有可导出的正文(只有工具调用、思考过程或图片)」；标题为「{会话名} · 标记消息」 |
| 导出 .zsession | 同会话导出确认框（含脱敏）；带工具调用的回复连同其工具结果、被标记的工具结果连同所属回复一并导出（配对限于同一次声明）；记录 id 重新生成；会话名加后缀「 (标记摘录)」 |
| 清空标记 | 只取消标记，不删消息 |
| 存储 | 会话 YAML marked_messages（id + marked_at），仅后端写；复制会话 / 从此处开始新会话时按新 id 重映射（分支点之后的丢弃）；消息删除后自动剔除 |
19.8 思考强度（澜砥 N2.7）
| 档位 id | 显示名 | 说明 |
|---|---|---|
none |
不思考 | 直接作答，最快 |
low |
低 | 少量思考 |
high |
高（默认） | 充分思考；未设置时同样发送 high |
xhigh |
更高 | 更深入的思考 |
max |
全力以赴 | 思考预算拉满，最慢、最耗用量 |
| 项 | 取值 |
|---|---|
| 显示条件 | 仅内置 AVL-Zero 中「澜砥 N2.7」及其 - 后缀变体（如「澜砥 N2.7-Flash」）；其它模型（含自定义 provider 同名模型）隐藏 |
| 入口 | 输入区模型名右侧电池图标按钮；滑轨两端「更快 / 更努力」；拖动预览、松手保存；←→ / Home / End，Enter / 空格选中，Esc 收起 |
| 保存粒度 | 按模型（params.reasoning_effort），对该模型全部会话生效，下一条消息起；「恢复默认」回到未设置 |
| 辅助调用 | 压缩摘要、自动改名、记忆提炼、Hook 补全、sec.decompile / code.ask 等恒发 none |
| 实发记录 | llm_meta.reasoning_effort；统计面板协议行「思考强度 {档位}」，参数被去掉时显示「默认」。上游拒收后去掉该参数重试，被拒档位 24 小时内不再发送 |
</think> 兜底 |
N2.7 系列、本次未带档位、思考字段为空且正文含 </think> → 首个 </think> 之前挪入思考；落盘与回喂历史已拆分（流式期间仍先显示在正文） |
19.9 工具调用行内进度
| 来源 | 文案 / 节拍 |
|---|---|
等模型输出（sec.decompile / code.ask） |
每 20 秒心跳：「等待 {模型} 输出(已 Ns)」→「{模型} 思考中(已 Ns, 思考 ~N tokens)」→「{模型} 生成中(约 P%, 预计还需 ~Ms, 已 Ns, ~N tokens, R tok/s)」；百分比基于同工具 / 模型历史（进程内 EMA，首次不报），封顶 99% |
| 建代码索引（待索引 ≥ 8 文件） | 「建立代码索引 X/N」+ 比例条；超出上限时「已达 N 个文件上限, 另有 M 个未进索引」 |
| 已运行 | 工具真正开始执行满 60 秒出现，之后每 20 秒对表，前端每 0.5 秒走表；「已运行 45s」/「已运行 1m05s / 上限 2m00s」。上限 = 通告到达时已运行 + 通告时限；工具 30 秒内报过进度则不发；Agent / AgentParallel / TaskOutput / TaskStop / TaskWait / ask_user 不发 |
| 工具默认时限 | fs.exec 120 s（参数 / tools.yaml 可改）；test.run 300 s；lint.run 180 s；sast.run 240 s；sec.decompile / code.ask = 模型超时 |
| 呈现 | 工具名右侧：转圈 + 文案（最多占行宽 70%），有比例时 48px 细进度条；只点亮在途调用；非当前会话弹原地更新的进度 toast（30 秒自动关），「已运行」不弹；极简密度下显示进度的那条不并入「N 次工具调用尝试」 |
19.10 复读检测
| 层 | 判据 | 结果 |
|---|---|---|
| 单轮行级截停 | 最近 25 个有效行内同一行 ≥ 3 次且至少两次相邻，或 ≥ 5 次；短行计入；代码块、| 开头的表格行、纯标点行、流式中未换行的末行不计；带工具调用的响应不截 |
取消本次请求，正文保留一遍，finish_reason=repetition；已流出的思考保留；下一请求尾部带不可见提醒 |
| 跨回合 | 复读链上最近 25 个无工具调用的 assistant 回合；真人输入 / 工具结果 / 带工具调用的回合 / 停转记录截断链，auto_* 续跑透明 |
≥ 3 次瞬态提醒，≥ 5 次加重，≥ 8 次或累计 3 次单轮截停 → 停转：落一条可见 system 记录并暂停自动续跑家族 |
| 告警 | 3 / 5 次与停转时 | 会话列表「疑似空转」（落盘）；3 / 5 次 toast 只在非当前会话弹，停转 toast 当前会话也弹 |
与「重复调用提醒」（同参工具调用 3 / 8 / 20 次分级提示、轮询类豁免、只在工具结果里提示、不停转）不同，复读检测只看无工具调用的回复正文。