docs: 记录快捷提示主分支集成与工作树清理

.project-docs/20-architecture/system-overview.md

@@ -1,5 +1,7 @@
 # System Overview
 
+咨询输入区从当前老师发布定义的 `shortcuts` 按序渲染展示文案，并通过已有普通提问路径发送实际提示词；不附加旧 suggestions 意图。明确的空列表隐藏入口，缺字段/null 保留旧入口。多项长文案在限定高度内滚动，正在回答时不可点击；目录更新不替换项目聊天或草稿，同一未确认提问重试保留请求身份。详见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
+
 云端咨询的 Main 声明 `read_protocol=2`：目录按层分页（默认深度 4、最多 6，跳过生成缓存），文件与捕获会话返回连续文本及准确的下一页行／Unicode 字符列。文件增量解码，不受 UI 预览大小限制。每问题最多 12 批、累计成功结果 64 KiB、单页 8 KiB；剩余不足 512 字节时停止读取。Yuxi 消费最后一批结果后通过 `tool_choice: none` 请求最终答案，保留原身份、版本、时限与幂等续接；未声明新协议的旧客户端保持六批。工具活动以问题与逻辑 tool_call_id 合并跨 Run 重放，原始 interrupt 工具错误不单独判为失败。Main 区分读取额度、上下文失效与协议错误；失败问题不自动重试。须先更新 Yuxi API／worker，再更新客户端；生产供应商与安装版验收仍待完成。
 
 智能体图标跟随发布定义：Yuxi 将原生 `icon` 固定到发布快照，Works Square 转为公开地址 `icon_url` 下发。Makelore 顶栏、邀请、面板标题、欢迎区和消息行统一读取该字段；缺失或加载失败时回退到既有 `avatar_id`。每个新问题取当前发布定义，已接受问题保持原版本；自定义图标使用正常图像渲染，内置像素头像保持像素样式。