From 23c98ea94eb8a782c0c0982871b37e32b0100d7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Mon, 28 Sep 2026 19:48:08 +0800
Subject: [PATCH 01/19] docs: record latest temporary app update verification

---
 .../20260928-merge-reply-cleanup-eb8d39b3.md   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
index eb041382..227f01f1 100644
--- a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
+++ b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
@@ -72,3 +72,21 @@
 - `typecheck`, full `lint:check` (0 errors / 8 prior warnings), `build:vite`, `git diff --check` and required documentation structure passed. Task drift retains the same 5 unchanged imported source-document diagnostics from the previous integration; current follow-up modifies only this owned record plus the 3 listed test/metadata files relative to `405846c`.
 - Impact: stale expectations made the full validation command fail although the intended auth projection and v7 extension were operating correctly; stale release-proof metadata could mislabel an artifact report. Repair restores meaningful release validation without downgrading runtime behavior. Formal package verification remains the packaging owner's responsibility.
 - Continue the authorized repository handoff with a normal fast-forward push to main after commit; no app restart, package, cloud publication, real model request or subagent creation.
+
+## Follow-up: Update Existing Temporary Application
+
+- User now explicitly requests the latest project on the temporary application; this supersedes this task's previous no-restart scope only for the temporary app. No subagents, foreground activation, production installation changes, cloud publication or intentional model requests.
+- Same-task ownership re-established; source and remote main are `b645cfa`. Reuse the previously verified source/build and unchanged project/architecture/gates; own task and current peer scopes read. Installation peer owns formal signed-app validation, while this update targets only the already established temporary bundle/profile/port. No semantic conflict. Context gate Passed.
+- Existing trial: PID 36109, root `/var/folders/mx/ltbgwsks5_n8zllj69p_wbcw0000gn/T/makelore-trial-tdq_nuah`, Host API 54599, same isolated user-data. It still runs older Main 9adab45 and Renderer 784fa8c plus a style overlay. Formal `/Applications/Makelore.app` PID 40478 stays untouched.
+- Plan: read-only inspect trial readiness/active requests and preserve its drafts/profile; prepare an ignored background-only bootstrap for the verified current build, gracefully stop only the exact trial process, back up the retained profile and restart the same bundle/profile/port without focus; verify loaded Main/Renderer, new UI/protocol and preserved data. Do not rewrite foreign source worktrees.
+
+
+### Temporary Application Outcome And Verification
+
+- Updated the existing `Makelore Teacher Trial.app` in place to verified source `b645cfa312ca23e9a44758211a43f4934a44a70f`, both Main and Renderer; old PID 36109 quit gracefully and current PID 62668 serves the same Host API port 54599. The bootstrap and build are ignored local outputs in this owned checkout. Formal app PID 40478 remains unchanged.
+- Before stopping, verified no active coding or teacher request, saved window/storage state and copied the full isolated profile after exit. Backups, build hashes and verification artifacts are under the trial root's `latest-main-update-b645cfa/`; no profile contents or credentials are committed.
+- Verified current Renderer asset `index-DKXograg.js`, retained route `#/chat`, same authenticated identity, both projects and active project, and all 10 original teacher draft values. On first startup the Renderer account projection was empty although Main's existing `/api/auth/me` returned the original identity; invoking the existing auth store's normal `init()` restored it without changing login credentials or product authentication code.
+- Captured and inspected the actual workspace without activation. Existing teacher selectors are present. Teacher chat pane remains closed; no new model reply was requested, and removal of retired components/old footer is covered by the previously passed source regressions and 28 headless layout cases, not claimed as a new live conversation test.
+- Startup and window restoration used background launch and native inactive showing. NSWorkspace monitoring during both phases recorded no trial foreground activation; final window is visible and unfocused. Closed the temporary Node inspector; port 9229 has no listener while port 54599 still belongs to the current trial PID.
+- No product source changes were needed for this update; reuse the immediately preceding passing full tests/typecheck/lint/build. Required document structure and whitespace checks pass. The same five unchanged source-task documents remain inherited drift findings relative to the task's original pre-merge base; only this owned record changes in this follow-up.
+- Retain this checkout because the live temporary app now executes its compiled build. This local update record does not change the already pushed product revision or formal packaging handoff.

From 3f5d1a8b65784ec42e51ced1b9e04f96c6843c74 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 11:47:43 +0800
Subject: [PATCH 02/19] =?UTF-8?q?fix(ui):=20rename=20teacher=20help=20butt?=
 =?UTF-8?q?ons=20to=20=E5=B8=AE=E6=88=91=E7=9C=8B=E7=9C=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../20260928-merge-reply-cleanup-eb8d39b3.md  | 17 ++++++
 README.md                                     |  4 +-
 src/pages/Chat/TeacherChatPanel.tsx           |  6 +--
 tests/e2e/pi-coding-first-chat.spec.ts        |  4 +-
 tests/e2e/teacher-reply-layout.spec.ts        | 10 ++--
 tests/unit/coding-teacher-ui.test.tsx         | 54 +++++++++----------
 6 files changed, 56 insertions(+), 39 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
index 227f01f1..863c0c4a 100644
--- a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
+++ b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
@@ -90,3 +90,20 @@
 - Startup and window restoration used background launch and native inactive showing. NSWorkspace monitoring during both phases recorded no trial foreground activation; final window is visible and unfocused. Closed the temporary Node inspector; port 9229 has no listener while port 54599 still belongs to the current trial PID.
 - No product source changes were needed for this update; reuse the immediately preceding passing full tests/typecheck/lint/build. Required document structure and whitespace checks pass. The same five unchanged source-task documents remain inherited drift findings relative to the task's original pre-merge base; only this owned record changes in this follow-up.
 - Retain this checkout because the live temporary app now executes its compiled build. This local update record does not change the already pushed product revision or formal packaging handoff.
+
+
+## Follow-up: Rename The Teacher Help Button
+
+- User requests changing the current page's “继续看看” button to exactly “帮我看看”. Continue this same delivered UI/trial follow-up in its owned checkout; no subagents or desktop activation.
+- Project Context Loaded: official start/status verify task ID, feature mode, branch, worktree and original base above. Entry, own record and peer scopes rechecked; unchanged positioning/current-state/architecture/teacher boundaries from the preceding turn reused. Active peers concern formal signed installation and an unfinished language skill; neither owns this trial Renderer label. No semantic conflict. Gate Passed.
+- Scope/plan: replace the two teacher help-entry labels and the fresh help request's matching visible text, retain their playful style, handler and retry/history protections; update existing UI/E2E expectations, run focused checks and required production compile, then refresh the temporary page without foreground activation if no request/draft would be interrupted. No cloud configuration or formal-app change.
+
+
+### Button Rename Outcome And Verification
+
+- Both composer-help and failed/interrupted suggestion retry now display exactly “帮我看看”; fresh suggestion requests carry the matching text. Existing styles, intent, pending-request identity, historical request text, references and draft protection are unchanged. README and existing unit/layout/Electron expectations reflect the new copy.
+- Typecheck, ESLint on all four changed TS/TSX files, `git diff --check` and production `build:vite` passed. Existing UI suite passed 71 tests; three targeted headless browser cases passed (retry plus empty-composer controls at 319px/508px), including click payload, draft retention and positioning. No new tests or full suite rerun were needed for this text-only change; native foreground E2E was not launched.
+- Updated the running trial Renderer without restarting Main PID 62668. Preflight found no text in current textareas, no stop controls and no active Pi workers. Backed up compiled assets and pre-refresh UI storage under trial `help-label-update-20260929/`; retained old Main lazy-load assets and the background launcher.
+- Actual loaded Renderer is `index-DARbkmvA.js`, containing the new label and no “继续看看👀”. Route remains `#/chat`; all 10 persisted teacher drafts are unchanged. The trial was already hidden and signed out before this edit (pre-refresh persisted user/access token absent and refresh unavailable); it stays hidden and signed out, with `/api/auth/me` returning 401. No login was fabricated or restored, and no live teacher request was sent. The component behavior was checked in headless fixtures instead.
+- Focus monitor recorded only the existing foreground WeChat process, no trial activation. Temporary inspector closed after verification. Formal installation remains untouched. This label follow-up is committed locally; no additional remote publication requested this turn.
+- Required document structure passes; inherited drift diagnostic is still limited to the same five source task records imported by the prior merge, not new foreign edits. Retain this checkout for the live trial build.
diff --git a/README.md b/README.md
index 7d1f6c91..e95248f4 100644
--- a/README.md
+++ b/README.md
@@ -174,9 +174,9 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
 - 进入项目时，智能体头像旁先显示运营发布的欢迎语气泡，不调用模型、不声称已检查项目；点击智能体进入咨询时立即收起欢迎语，并按账号记住已查看，关闭、重新打开、切换项目或刷新后不重复弹出；主动收起也保留同样记录。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
-- 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“继续看看👀”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“继续看看👀”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
+- 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“帮我看看”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“帮我看看”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
 - 老师咨询只展示老师正文和可点击的快捷回复卡片，学生也可在“和老师聊聊”输入框自由输入。点击卡片原样发送该回复，保留当前输入草稿；旧话题的数据不会恢复想法板、结构图、流程图或对照表及其操作。
-- 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“继续看看👀”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
+- 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“帮我看看”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
 - Main 对咨询回复统一使用 `{reply, quickReplies}`，本地读取工具的前言和云端非最终片段不当作最终回答；完整解析后展示正文和卡片，主动进展提醒仍直接展示正文。普通 Markdown、JSON 数据和代码示例保持正文。兼容读取旧 `{intro, questions}` 和带 `tool` 的回复，只提取正文与快捷回复，不恢复或更新组件。新输出超过 3 条快捷回复时保留完整正文、提示格式错误并保留原始回答，不展示超额卡片或静默截取；历史中已有的更多卡片在读取与后续保存时仍原样保留。独立资源上限只用于防护，不做旧式字数截断；格式错误的原文默认折叠、字面显示，不再次送进模型。
 - 回复中的引号或换行格式有误时，仅在正文边界明确、修复后整体合法的情况下恢复完整文字，不把半句话当成完整回答。附加建议损坏时仍展示完整正文；正文无法确认完整时显示“这次回复未能完整显示”，由学生点击“重新回答”，沿用原问题、引用与来源；持续聊天须回到原项目和操作对话后重试，新一轮按当前发布版本执行，旧话题仍使用绑定版本，保留当前草稿，连续点击不重复发送。打开聊天或旧话题会从保留的原文中在本地恢复可确认的正文，不调用模型，不因显示修复而改写磁盘记录；原始内容继续折叠保留。不完整的回答和建议不进入后续模型上下文。
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index 215616ed..2feac588 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -471,7 +471,7 @@ export function TeacherChatPanel({
     (request) => request.status === 'preparing' || request.status === 'running'
   );
   const helpUnavailable = busy || !topicEnabled || Boolean(running);
-  const askForSuggestions = () => void send({ text: '继续看看👀', intent: 'suggestions' });
+  const askForSuggestions = () => void send({ text: '帮我看看', intent: 'suggestions' });
   const changeText = (next: string) => { setText(next); persistDraft(next, references, pending.current); };
   const removeReferences = () => { setReferences([]); persistDraft(text, [], pending.current); };
   const questions = definition?.suggested_questions ?? [];
@@ -541,7 +541,7 @@ export function TeacherChatPanel({
                   {request.suggestedQuestions?.map((question, index) => <button key={`${request.id}:${index}`} type="button" disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
                 </div>
               </>}
-            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">继续看看👀</button>}
+            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">帮我看看</button>}
           </> : request.response ? <TeacherReply text={request.response} /> : <div className="text-[13px] leading-7">{['running', 'preparing'].includes(request.status) ? <span role="status" className="inline-flex items-center gap-2 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />{label}正在想…</span> : ['cancelled', 'interrupted'].includes(request.status) ? '这次先停在这里。想继续时可以再说说。' : ''}</div>}
           {request.intent !== 'suggestions' && request.status === 'completed' && !request.replyIncomplete && Boolean(request.suggestedQuestions?.length) && <div className="consultation-follow-ups" aria-label="接着聊">
             {request.suggestedQuestions?.map((question, index) => <button type="button" key={`${request.id}:${index}`} disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
@@ -585,7 +585,7 @@ export function TeacherChatPanel({
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
           <div className="mt-2 flex min-h-11 items-center justify-between gap-2" data-testid="consultation-composer-actions">
             <div className="min-w-0 flex-1">
-              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint">继续看看👀</button>}
+              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint">帮我看看</button>}
             </div>
             {running ? <button type="button" className="rounded-lg border px-3 py-2 text-xs" onClick={() => void teacherApi.cancel(topicBase, endpointId, running.id).then(consume).catch(() => setError('暂时无法停止，请稍后重试。'))}>停止回复</button>
             : <button type="submit" aria-label="提问" title={busy ? '正在发送…' : '发送'} disabled={busy || !topicEnabled || !text.trim()} className="consultation-send flex h-8 w-8 items-center justify-center rounded-full text-white disabled:opacity-30"><ArrowUp className="h-4 w-4" /></button>}
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 58b94c8b..8f7549c6 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1869,7 +1869,7 @@ test('project consultations preserve student drafts and switch between work and
     await expect(page.getByRole('button', { name: '与朋友聊天' })).toHaveAttribute('aria-pressed', 'true');
     await expect(page.locator('#coding-consultation-dock')).toHaveCSS('width', '508px');
     await expect(teacher.locator('form .consultation-hint')).toBeVisible();
-    await expect(teacher.locator('form .consultation-hint')).toHaveText('继续看看👀');
+    await expect(teacher.locator('form .consultation-hint')).toHaveText('帮我看看');
     await expect(teacher.getByText('把你的困惑说出来就好')).toHaveCount(0);
     await expect(teacher.getByText('当前项目',{exact:true})).toHaveCount(0);
     await expect(teacher.getByRole('button',{name:'解释当前代码',exact:true})).toBeVisible();
@@ -1924,7 +1924,7 @@ test('project consultations preserve student drafts and switch between work and
       expect(request.body).not.toHaveProperty('discussion');
     }
     await expect(teacher).toHaveAccessibleName('朋友咨询');
-    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'继续看看👀'});
+    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'帮我看看'});
     expect(consultationRequests[1].body).toMatchObject({text:'怎样观察别人玩游戏？'});
     expect(consultationRequests[1].body?.intent).toBeUndefined();
     await page.screenshot({path:test.info().outputPath('project-teacher-side-chat.png')});
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index 69b53bce..a45e3771 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -29,7 +29,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     const panel = page.getByTestId('teacher-chat-panel');
     const retry = panel.locator('.consultation-retry');
     await expect(retry).toBeEnabled();
-    await expect(retry).toHaveText('继续看看👀');
+    await expect(retry).toHaveText('帮我看看');
     expect(await retry.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
     const [panelBounds, retryBounds] = await Promise.all([panel.boundingBox(), retry.boundingBox()]);
     expect(retryBounds!.x).toBeGreaterThanOrEqual(panelBounds!.x);
@@ -41,7 +41,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
     await expect(input).toHaveValue('我还有一点自己的想法');
     expect(await page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs)).toEqual([
-      { requestId: expect.any(String), text: '继续看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
+      { requestId: expect.any(String), text: '帮我看看', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
     ]);
   }
 });
@@ -89,7 +89,7 @@ for (const width of [319, 508]) {
     const send = page.getByRole('button', { name: '提问', exact: true });
     const sent = () => page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs);
     await expect(hint).toBeEnabled();
-    await expect(hint).toHaveText('继续看看👀');
+    await expect(hint).toHaveText('帮我看看');
     await expect(hint).toHaveCSS('background-color', 'rgb(255, 242, 201)');
     const initialSend = (await send.boundingBox())!;
     const hintBounds = (await hint.boundingBox())!;
@@ -109,9 +109,9 @@ for (const width of [319, 508]) {
     expect(await sent()).toEqual([]);
     await hint.click();
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
-    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '继续看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
+    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '帮我看看', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
     await expect(page.getByRole('button', { name: '我也说不清，你带我看看', exact: true })).toHaveCount(0);
-    await expect(page.locator('.consultation-messages').getByRole('button', { name: '继续看看👀', exact: true })).toHaveCount(0);
+    await expect(page.locator('.consultation-messages').getByRole('button', { name: '帮我看看', exact: true })).toHaveCount(0);
     const card = page.getByRole('button', { name: '可以从哪个小地方开始？' });
     await expect(card).toBeVisible();
     await input.fill('留着我自己的草稿');
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index 6df59675..188f4741 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -496,13 +496,13 @@ describe('teacher side chat', () => {
     }));
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     const input = screen.getByLabelText('向智能体提问');
-    const help = () => screen.getByText('继续看看👀', { selector: 'form .consultation-hint' });
+    const help = () => screen.getByText('帮我看看', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(help()).toBeEnabled());
     expect(screen.getByTestId('consultation-composer-actions')).toContainElement(help());
-    expect(help()).toHaveAccessibleName('继续看看👀');
+    expect(help()).toHaveAccessibleName('帮我看看');
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '我先自己想想' } });
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '   ' } });
     expect(help()).toBeEnabled();
@@ -517,11 +517,11 @@ describe('teacher side chat', () => {
     expect(screen.queryByRole('button', { name: '尚未确认的问题' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(api.send).toHaveBeenCalledWith('p/agent-topics', 'first', expect.objectContaining({
-      intent: 'suggestions', text: '继续看看👀', sourceConversationId: 'c',
+      intent: 'suggestions', text: '帮我看看', sourceConversationId: 'c',
     }));
     expect(help()).toBeDisabled();
     fireEvent.change(input, { target: { value: '我自己还想问的另一件事' } });
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     await waitFor(() => expect(streams.has('first')).toBe(true));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify({
@@ -532,7 +532,7 @@ describe('teacher side chat', () => {
     expect(screen.queryByText('我看看你最近做到了哪里…')).not.toBeInTheDocument();
     for (const question of suggestedQuestions) expect(screen.getByRole('button', { name: question })).toBeEnabled();
     expect(screen.queryByRole('button', { name: '我也说不清，你带我看看', exact: true })).not.toBeInTheDocument();
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(input).toHaveValue('我自己还想问的另一件事');
   });
@@ -567,8 +567,8 @@ describe('teacher side chat', () => {
   it('keeps an uncertain suggestions request identity through reopening and draft edits', async () => {
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我还没写完的问题' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -578,10 +578,10 @@ describe('teacher side chat', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByLabelText('向智能体提问')).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我还没写完的问题');
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '' } });
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(api.send.mock.calls[1][2]).toEqual(originalRequest);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -592,16 +592,16 @@ describe('teacher side chat', () => {
     localStorage.setItem('makelore-consultation-draft:signed-out:p:teacher', JSON.stringify({ text: '', references: [], pending: original }));
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[0][2]))).toEqual(original);
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[1][2]))).toEqual(original);
   });
@@ -626,13 +626,13 @@ describe('teacher side chat', () => {
     api.read.mockResolvedValue({ ...first, requests: [suggestionsRequest({ id: original.requestId, text: original.text, status })] });
     api.send.mockResolvedValue({ ...first, revision: 2 });
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await waitFor(() => expect(api.send).toHaveBeenCalledTimes(1));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     expect(sent.requestId).not.toBe(original.requestId);
-    expect(sent).toMatchObject({ text: '继续看看👀', intent: 'suggestions', references: [], sourceConversationId: 'c' });
+    expect(sent).toMatchObject({ text: '帮我看看', intent: 'suggestions', references: [], sourceConversationId: 'c' });
   });
 
   it.each(['failed', 'cancelled', 'interrupted'] as const)('retries a %s suggestion request without leaking raw JSON or reusing its accepted request id', async status => {
@@ -645,7 +645,7 @@ describe('teacher side chat', () => {
     await screen.findByText('这次没有看清楚，请再试一次。');
     expect(screen.queryByText('{"intro":"未完成')).not.toBeInTheDocument();
     expect(screen.queryByRole('button', { name: suggestedQuestions[0] })).not.toBeInTheDocument();
-    fireEvent.click(screen.getByText('继续看看👀', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send.mock.calls[0][2]).toMatchObject({ intent: 'suggestions' });
     expect(api.send.mock.calls[0][2].requestId).not.toBe(failed.id);
@@ -657,9 +657,9 @@ describe('teacher side chat', () => {
       ...first, revision: 3, requests: [accepted, suggestionsRequest({ id: input.requestId })],
     }));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
     await waitFor(() => expect(streams.has('first')).toBe(true));
-    fireEvent.click(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
     await screen.findByText('响应中途断开');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我的自由提问继续留着' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -673,10 +673,10 @@ describe('teacher side chat', () => {
       act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify(recovered) })));
     }
     await screen.findByText('智能体已接到，但这次回复失败了');
-    await waitFor(() => expect(screen.getByText('继续看看👀', { selector: '.consultation-retry' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText('帮我看看', { selector: '.consultation-retry' })).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我的自由提问继续留着');
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText('继续看看👀', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText('帮我看看', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send).toHaveBeenCalledTimes(2);
     expect(api.send.mock.calls[1][2].requestId).not.toBe(originalRequest.requestId);
@@ -699,7 +699,7 @@ describe('teacher side chat', () => {
     expect(api.send.mock.calls[0][2].intent).toBeUndefined();
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
     expect(screen.queryByRole('button', { name: '移除引用' })).not.toBeInTheDocument();
-    expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeEnabled();
+    expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled();
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -787,7 +787,7 @@ describe('teacher side chat', () => {
     fireEvent.click(screen.getByRole('button', { name: '运营配置的预览问题' }));
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('运营配置的预览问题');
     expect(api.send).not.toHaveBeenCalled();
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.click(screen.getByRole('button', { name: '智能体新话题' }));
     await waitFor(() => expect(api.create).toHaveBeenCalledWith('preview/sample', 7, '学生的练习代码', undefined));
   });
@@ -911,7 +911,7 @@ describe('merged cloud teacher classroom', () => {
     api.sendConversation.mockRejectedValue(new Error('结果暂未确认'));
     const props = { projectId: 'p', sourceId: 'original-source', selectedAgent: agent };
     const view = render(<TeacherChatPanel {...props} />);
-    const hint = () => screen.getByText('继续看看👀', { selector: 'form .consultation-hint' });
+    const hint = () => screen.getByText('帮我看看', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(hint()).toBeEnabled());
     expect(api.sendConversation).not.toHaveBeenCalled();
     fireEvent.click(hint());
@@ -984,10 +984,10 @@ describe('merged cloud teacher classroom', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByText('智能体暂未开放，历史仍可查看。')).toBeVisible());
     const input = screen.getByLabelText('向智能体提问');
-    expect(screen.getByText('继续看看👀', { selector: 'form .consultation-hint' })).toBeDisabled();
+    expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeDisabled();
     fireEvent.change(input, { target: { value: '继续讨论' } });
     expect(screen.getByRole('button', { name: '提问', exact: true })).toBeDisabled();
-    expect(screen.queryByText('继续看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.keyDown(input, { key: 'Enter' });
     expect(api.send).not.toHaveBeenCalled();
   });

From e4b99d5e3200194d347f020e52655f921c725895 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 11:57:29 +0800
Subject: [PATCH 03/19] fix(ui): clarify teacher help prompt and fit narrow
 panels

---
 .../20260928-merge-reply-cleanup-eb8d39b3.md  | 15 ++++++
 README.md                                     |  4 +-
 src/pages/Chat/TeacherChatPanel.tsx           |  8 +--
 tests/e2e/pi-coding-first-chat.spec.ts        |  4 +-
 tests/e2e/teacher-reply-layout.spec.ts        | 11 ++--
 tests/unit/coding-teacher-ui.test.tsx         | 54 +++++++++----------
 6 files changed, 56 insertions(+), 40 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
index 863c0c4a..467fca80 100644
--- a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
+++ b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
@@ -107,3 +107,18 @@
 - Actual loaded Renderer is `index-DARbkmvA.js`, containing the new label and no “继续看看👀”. Route remains `#/chat`; all 10 persisted teacher drafts are unchanged. The trial was already hidden and signed out before this edit (pre-refresh persisted user/access token absent and refresh unavailable); it stays hidden and signed out, with `/api/auth/me` returning 401. No login was fabricated or restored, and no live teacher request was sent. The component behavior was checked in headless fixtures instead.
 - Focus monitor recorded only the existing foreground WeChat process, no trial activation. Temporary inspector closed after verification. Formal installation remains untouched. This label follow-up is committed locally; no additional remote publication requested this turn.
 - Required document structure passes; inherited drift diagnostic is still limited to the same five source task records imported by the prior merge, not new foreign edits. Retain this checkout for the live trial build.
+
+
+## Follow-up: Explicit Unsure-What-To-Ask Button Copy
+
+- User refines the same two button labels to exactly “不知道问什么，你先帮我看看👀”. Continue this owned UI/trial follow-up without subagents, foreground activation or remote publication.
+- Project Context Loaded: official same-task start/status fields verified; own record/current peer scopes rechecked and unchanged entry/project/teacher context reused. Formal signed-app and unspecified language-skill peers do not conflict with this bounded copy change. Gate Passed.
+- Plan: change labels and new help request text, preserving historical fixtures/pending payloads; update existing expectations, verify narrow/wide wrapping and stable send-button position, make only necessary layout accommodation, run focused validation/build and refresh the temporary Renderer with state protection.
+
+
+### Longer Button Copy Outcome And Verification
+
+- Both help entries and fresh suggestion text now use exactly “不知道问什么，你先帮我看看👀”. Preserve previous payloads in legacy fixtures/history and all request/intent/draft safeguards. Narrow buttons wrap after the comma with the second phrase and emoji kept together; the composer action row reserves 68px so hiding the two-line button while typing does not move Send. Existing warm-yellow styling remains.
+- Initial narrow-layout regression exposed an 11px Send shift with two-line text. Reserved action height resolves it without changing dispatch. All 71 focused UI tests, typecheck, changed-file ESLint and final production build pass. All 3 targeted headless layout cases pass at 319px/508px, including clipping, position, click payload and draft preservation; inspected narrow screenshot confirms balanced semantic wrapping and attached emoji.
+- Refreshed only the existing trial Renderer (Main remains PID 62668). Preflight found empty textareas, no stop controls and an idle Pi worker; saved current UI state/build backups under `help-long-label-update-20260929/`. Actual loaded `index-CaxXl4aZ.js` contains the full new copy. Current route and authenticated identity preserved, all 11 pre-refresh teacher drafts unchanged, window remains visible/unfocused. Consultation pane closes on page refresh; no extra teacher/operation model request was made to reopen it.
+- Temporary inspector closed. No formal-app change, model/cloud configuration publication or remote push. Required doc structure and whitespace checks pass; same inherited five foreign-source doc diagnostics remain from the original integration base. Retain checkout for running trial.
diff --git a/README.md b/README.md
index e95248f4..8fbbe35e 100644
--- a/README.md
+++ b/README.md
@@ -174,9 +174,9 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
 - 进入项目时，智能体头像旁先显示运营发布的欢迎语气泡，不调用模型、不声称已检查项目；点击智能体进入咨询时立即收起欢迎语，并按账号记住已查看，关闭、重新打开、切换项目或刷新后不重复弹出；主动收起也保留同样记录。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
-- 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“帮我看看”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“帮我看看”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
+- 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“不知道问什么，你先帮我看看👀”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“不知道问什么，你先帮我看看👀”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
 - 老师咨询只展示老师正文和可点击的快捷回复卡片，学生也可在“和老师聊聊”输入框自由输入。点击卡片原样发送该回复，保留当前输入草稿；旧话题的数据不会恢复想法板、结构图、流程图或对照表及其操作。
-- 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“帮我看看”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
+- 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“不知道问什么，你先帮我看看👀”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
 - Main 对咨询回复统一使用 `{reply, quickReplies}`，本地读取工具的前言和云端非最终片段不当作最终回答；完整解析后展示正文和卡片，主动进展提醒仍直接展示正文。普通 Markdown、JSON 数据和代码示例保持正文。兼容读取旧 `{intro, questions}` 和带 `tool` 的回复，只提取正文与快捷回复，不恢复或更新组件。新输出超过 3 条快捷回复时保留完整正文、提示格式错误并保留原始回答，不展示超额卡片或静默截取；历史中已有的更多卡片在读取与后续保存时仍原样保留。独立资源上限只用于防护，不做旧式字数截断；格式错误的原文默认折叠、字面显示，不再次送进模型。
 - 回复中的引号或换行格式有误时，仅在正文边界明确、修复后整体合法的情况下恢复完整文字，不把半句话当成完整回答。附加建议损坏时仍展示完整正文；正文无法确认完整时显示“这次回复未能完整显示”，由学生点击“重新回答”，沿用原问题、引用与来源；持续聊天须回到原项目和操作对话后重试，新一轮按当前发布版本执行，旧话题仍使用绑定版本，保留当前草稿，连续点击不重复发送。打开聊天或旧话题会从保留的原文中在本地恢复可确认的正文，不调用模型，不因显示修复而改写磁盘记录；原始内容继续折叠保留。不完整的回答和建议不进入后续模型上下文。
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index 2feac588..6203fbf7 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -471,7 +471,7 @@ export function TeacherChatPanel({
     (request) => request.status === 'preparing' || request.status === 'running'
   );
   const helpUnavailable = busy || !topicEnabled || Boolean(running);
-  const askForSuggestions = () => void send({ text: '帮我看看', intent: 'suggestions' });
+  const askForSuggestions = () => void send({ text: '不知道问什么，你先帮我看看👀', intent: 'suggestions' });
   const changeText = (next: string) => { setText(next); persistDraft(next, references, pending.current); };
   const removeReferences = () => { setReferences([]); persistDraft(text, [], pending.current); };
   const questions = definition?.suggested_questions ?? [];
@@ -541,7 +541,7 @@ export function TeacherChatPanel({
                   {request.suggestedQuestions?.map((question, index) => <button key={`${request.id}:${index}`} type="button" disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
                 </div>
               </>}
-            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">帮我看看</button>}
+            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry"><span>不知道问什么，<span className="whitespace-nowrap">你先帮我看看👀</span></span></button>}
           </> : request.response ? <TeacherReply text={request.response} /> : <div className="text-[13px] leading-7">{['running', 'preparing'].includes(request.status) ? <span role="status" className="inline-flex items-center gap-2 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />{label}正在想…</span> : ['cancelled', 'interrupted'].includes(request.status) ? '这次先停在这里。想继续时可以再说说。' : ''}</div>}
           {request.intent !== 'suggestions' && request.status === 'completed' && !request.replyIncomplete && Boolean(request.suggestedQuestions?.length) && <div className="consultation-follow-ups" aria-label="接着聊">
             {request.suggestedQuestions?.map((question, index) => <button type="button" key={`${request.id}:${index}`} disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
@@ -583,9 +583,9 @@ export function TeacherChatPanel({
           <textarea ref={inputRef} aria-label={`向${label}提问`} value={text} disabled={busy} maxLength={6000} onChange={(e) => changeText(e.target.value)} placeholder="和老师聊聊" rows={2}
             onKeyDown={(e) => { if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) { e.preventDefault(); void send(); } }}
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
-          <div className="mt-2 flex min-h-11 items-center justify-between gap-2" data-testid="consultation-composer-actions">
+          <div className="mt-2 flex min-h-[68px] items-center justify-between gap-2" data-testid="consultation-composer-actions">
             <div className="min-w-0 flex-1">
-              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint">帮我看看</button>}
+              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint"><span>不知道问什么，<span className="whitespace-nowrap">你先帮我看看👀</span></span></button>}
             </div>
             {running ? <button type="button" className="rounded-lg border px-3 py-2 text-xs" onClick={() => void teacherApi.cancel(topicBase, endpointId, running.id).then(consume).catch(() => setError('暂时无法停止，请稍后重试。'))}>停止回复</button>
             : <button type="submit" aria-label="提问" title={busy ? '正在发送…' : '发送'} disabled={busy || !topicEnabled || !text.trim()} className="consultation-send flex h-8 w-8 items-center justify-center rounded-full text-white disabled:opacity-30"><ArrowUp className="h-4 w-4" /></button>}
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 8f7549c6..c02816c1 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1869,7 +1869,7 @@ test('project consultations preserve student drafts and switch between work and
     await expect(page.getByRole('button', { name: '与朋友聊天' })).toHaveAttribute('aria-pressed', 'true');
     await expect(page.locator('#coding-consultation-dock')).toHaveCSS('width', '508px');
     await expect(teacher.locator('form .consultation-hint')).toBeVisible();
-    await expect(teacher.locator('form .consultation-hint')).toHaveText('帮我看看');
+    await expect(teacher.locator('form .consultation-hint')).toHaveText('不知道问什么，你先帮我看看👀');
     await expect(teacher.getByText('把你的困惑说出来就好')).toHaveCount(0);
     await expect(teacher.getByText('当前项目',{exact:true})).toHaveCount(0);
     await expect(teacher.getByRole('button',{name:'解释当前代码',exact:true})).toBeVisible();
@@ -1924,7 +1924,7 @@ test('project consultations preserve student drafts and switch between work and
       expect(request.body).not.toHaveProperty('discussion');
     }
     await expect(teacher).toHaveAccessibleName('朋友咨询');
-    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'帮我看看'});
+    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'不知道问什么，你先帮我看看👀'});
     expect(consultationRequests[1].body).toMatchObject({text:'怎样观察别人玩游戏？'});
     expect(consultationRequests[1].body?.intent).toBeUndefined();
     await page.screenshot({path:test.info().outputPath('project-teacher-side-chat.png')});
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index a45e3771..636775fd 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -29,7 +29,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     const panel = page.getByTestId('teacher-chat-panel');
     const retry = panel.locator('.consultation-retry');
     await expect(retry).toBeEnabled();
-    await expect(retry).toHaveText('帮我看看');
+    await expect(retry).toHaveText('不知道问什么，你先帮我看看👀');
     expect(await retry.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
     const [panelBounds, retryBounds] = await Promise.all([panel.boundingBox(), retry.boundingBox()]);
     expect(retryBounds!.x).toBeGreaterThanOrEqual(panelBounds!.x);
@@ -41,7 +41,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
     await expect(input).toHaveValue('我还有一点自己的想法');
     expect(await page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs)).toEqual([
-      { requestId: expect.any(String), text: '帮我看看', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
+      { requestId: expect.any(String), text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
     ]);
   }
 });
@@ -89,7 +89,8 @@ for (const width of [319, 508]) {
     const send = page.getByRole('button', { name: '提问', exact: true });
     const sent = () => page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs);
     await expect(hint).toBeEnabled();
-    await expect(hint).toHaveText('帮我看看');
+    await expect(hint).toHaveText('不知道问什么，你先帮我看看👀');
+    expect(await hint.evaluate(el => el.scrollWidth <= el.clientWidth && el.scrollHeight <= el.clientHeight)).toBe(true);
     await expect(hint).toHaveCSS('background-color', 'rgb(255, 242, 201)');
     const initialSend = (await send.boundingBox())!;
     const hintBounds = (await hint.boundingBox())!;
@@ -109,9 +110,9 @@ for (const width of [319, 508]) {
     expect(await sent()).toEqual([]);
     await hint.click();
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
-    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '帮我看看', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
+    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
     await expect(page.getByRole('button', { name: '我也说不清，你带我看看', exact: true })).toHaveCount(0);
-    await expect(page.locator('.consultation-messages').getByRole('button', { name: '帮我看看', exact: true })).toHaveCount(0);
+    await expect(page.locator('.consultation-messages').getByRole('button', { name: '不知道问什么，你先帮我看看👀', exact: true })).toHaveCount(0);
     const card = page.getByRole('button', { name: '可以从哪个小地方开始？' });
     await expect(card).toBeVisible();
     await input.fill('留着我自己的草稿');
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index 188f4741..ff2dc375 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -496,13 +496,13 @@ describe('teacher side chat', () => {
     }));
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     const input = screen.getByLabelText('向智能体提问');
-    const help = () => screen.getByText('帮我看看', { selector: 'form .consultation-hint' });
+    const help = () => screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(help()).toBeEnabled());
     expect(screen.getByTestId('consultation-composer-actions')).toContainElement(help());
-    expect(help()).toHaveAccessibleName('帮我看看');
+    expect(help()).toHaveAccessibleName('不知道问什么，你先帮我看看👀');
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '我先自己想想' } });
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '   ' } });
     expect(help()).toBeEnabled();
@@ -517,11 +517,11 @@ describe('teacher side chat', () => {
     expect(screen.queryByRole('button', { name: '尚未确认的问题' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(api.send).toHaveBeenCalledWith('p/agent-topics', 'first', expect.objectContaining({
-      intent: 'suggestions', text: '帮我看看', sourceConversationId: 'c',
+      intent: 'suggestions', text: '不知道问什么，你先帮我看看👀', sourceConversationId: 'c',
     }));
     expect(help()).toBeDisabled();
     fireEvent.change(input, { target: { value: '我自己还想问的另一件事' } });
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     await waitFor(() => expect(streams.has('first')).toBe(true));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify({
@@ -532,7 +532,7 @@ describe('teacher side chat', () => {
     expect(screen.queryByText('我看看你最近做到了哪里…')).not.toBeInTheDocument();
     for (const question of suggestedQuestions) expect(screen.getByRole('button', { name: question })).toBeEnabled();
     expect(screen.queryByRole('button', { name: '我也说不清，你带我看看', exact: true })).not.toBeInTheDocument();
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(input).toHaveValue('我自己还想问的另一件事');
   });
@@ -567,8 +567,8 @@ describe('teacher side chat', () => {
   it('keeps an uncertain suggestions request identity through reopening and draft edits', async () => {
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我还没写完的问题' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -578,10 +578,10 @@ describe('teacher side chat', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByLabelText('向智能体提问')).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我还没写完的问题');
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '' } });
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(api.send.mock.calls[1][2]).toEqual(originalRequest);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -592,16 +592,16 @@ describe('teacher side chat', () => {
     localStorage.setItem('makelore-consultation-draft:signed-out:p:teacher', JSON.stringify({ text: '', references: [], pending: original }));
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[0][2]))).toEqual(original);
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[1][2]))).toEqual(original);
   });
@@ -626,13 +626,13 @@ describe('teacher side chat', () => {
     api.read.mockResolvedValue({ ...first, requests: [suggestionsRequest({ id: original.requestId, text: original.text, status })] });
     api.send.mockResolvedValue({ ...first, revision: 2 });
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await waitFor(() => expect(api.send).toHaveBeenCalledTimes(1));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     expect(sent.requestId).not.toBe(original.requestId);
-    expect(sent).toMatchObject({ text: '帮我看看', intent: 'suggestions', references: [], sourceConversationId: 'c' });
+    expect(sent).toMatchObject({ text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], sourceConversationId: 'c' });
   });
 
   it.each(['failed', 'cancelled', 'interrupted'] as const)('retries a %s suggestion request without leaking raw JSON or reusing its accepted request id', async status => {
@@ -645,7 +645,7 @@ describe('teacher side chat', () => {
     await screen.findByText('这次没有看清楚，请再试一次。');
     expect(screen.queryByText('{"intro":"未完成')).not.toBeInTheDocument();
     expect(screen.queryByRole('button', { name: suggestedQuestions[0] })).not.toBeInTheDocument();
-    fireEvent.click(screen.getByText('帮我看看', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send.mock.calls[0][2]).toMatchObject({ intent: 'suggestions' });
     expect(api.send.mock.calls[0][2].requestId).not.toBe(failed.id);
@@ -657,9 +657,9 @@ describe('teacher side chat', () => {
       ...first, revision: 3, requests: [accepted, suggestionsRequest({ id: input.requestId })],
     }));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
     await waitFor(() => expect(streams.has('first')).toBe(true));
-    fireEvent.click(screen.getByText('帮我看看', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
     await screen.findByText('响应中途断开');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我的自由提问继续留着' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -673,10 +673,10 @@ describe('teacher side chat', () => {
       act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify(recovered) })));
     }
     await screen.findByText('智能体已接到，但这次回复失败了');
-    await waitFor(() => expect(screen.getByText('帮我看看', { selector: '.consultation-retry' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' })).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我的自由提问继续留着');
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText('帮我看看', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send).toHaveBeenCalledTimes(2);
     expect(api.send.mock.calls[1][2].requestId).not.toBe(originalRequest.requestId);
@@ -699,7 +699,7 @@ describe('teacher side chat', () => {
     expect(api.send.mock.calls[0][2].intent).toBeUndefined();
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
     expect(screen.queryByRole('button', { name: '移除引用' })).not.toBeInTheDocument();
-    expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeEnabled();
+    expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled();
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -787,7 +787,7 @@ describe('teacher side chat', () => {
     fireEvent.click(screen.getByRole('button', { name: '运营配置的预览问题' }));
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('运营配置的预览问题');
     expect(api.send).not.toHaveBeenCalled();
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.click(screen.getByRole('button', { name: '智能体新话题' }));
     await waitFor(() => expect(api.create).toHaveBeenCalledWith('preview/sample', 7, '学生的练习代码', undefined));
   });
@@ -911,7 +911,7 @@ describe('merged cloud teacher classroom', () => {
     api.sendConversation.mockRejectedValue(new Error('结果暂未确认'));
     const props = { projectId: 'p', sourceId: 'original-source', selectedAgent: agent };
     const view = render(<TeacherChatPanel {...props} />);
-    const hint = () => screen.getByText('帮我看看', { selector: 'form .consultation-hint' });
+    const hint = () => screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(hint()).toBeEnabled());
     expect(api.sendConversation).not.toHaveBeenCalled();
     fireEvent.click(hint());
@@ -984,10 +984,10 @@ describe('merged cloud teacher classroom', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByText('智能体暂未开放，历史仍可查看。')).toBeVisible());
     const input = screen.getByLabelText('向智能体提问');
-    expect(screen.getByText('帮我看看', { selector: 'form .consultation-hint' })).toBeDisabled();
+    expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeDisabled();
     fireEvent.change(input, { target: { value: '继续讨论' } });
     expect(screen.getByRole('button', { name: '提问', exact: true })).toBeDisabled();
-    expect(screen.queryByText('帮我看看', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.keyDown(input, { key: 'Enter' });
     expect(api.send).not.toHaveBeenCalled();
   });

From c82b1a43beeca2ab4f104a7566855c687a913aa5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 14:02:50 +0800
Subject: [PATCH 04/19] feat(ui): introduce each teacher with an individual
 welcome bubble

---
 .../20260928-merge-reply-cleanup-eb8d39b3.md  | 19 +++++
 README.md                                     |  2 +-
 src/pages/Chat/TeacherCompanion.tsx           | 28 ++++++-
 src/pages/Chat/classroom-workspace.css        | 22 +++++
 src/pages/Chat/use-teacher-companion.ts       | 40 ++++++++-
 tests/e2e/fixtures/teacher-preview-layout.tsx |  7 +-
 tests/e2e/pi-coding-first-chat.spec.ts        | 30 +++----
 tests/e2e/teacher-preview-layout.spec.ts      | 46 ++++++++++-
 tests/unit/teacher-companion.test.tsx         | 81 ++++++++++++++++++-
 9 files changed, 253 insertions(+), 22 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
index 467fca80..9f5837bd 100644
--- a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
+++ b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
@@ -122,3 +122,22 @@
 - Initial narrow-layout regression exposed an 11px Send shift with two-line text. Reserved action height resolves it without changing dispatch. All 71 focused UI tests, typecheck, changed-file ESLint and final production build pass. All 3 targeted headless layout cases pass at 319px/508px, including clipping, position, click payload and draft preservation; inspected narrow screenshot confirms balanced semantic wrapping and attached emoji.
 - Refreshed only the existing trial Renderer (Main remains PID 62668). Preflight found empty textareas, no stop controls and an idle Pi worker; saved current UI state/build backups under `help-long-label-update-20260929/`. Actual loaded `index-CaxXl4aZ.js` contains the full new copy. Current route and authenticated identity preserved, all 11 pre-refresh teacher drafts unchanged, window remains visible/unfocused. Consultation pane closes on page refresh; no extra teacher/operation model request was made to reopen it.
 - Temporary inspector closed. No formal-app change, model/cloud configuration publication or remote push. Required doc structure and whitespace checks pass; same inherited five foreign-source doc diagnostics remain from the original integration base. Retain checkout for running trial.
+
+
+## Follow-up: Introduce Every Delivered Teacher
+
+- User approves the reviewed multi-teacher greeting design and requests it in the temporary application. Resume this owned UI/trial task with exact identity/branch/base verified, own/peer scopes reviewed, and unchanged entry/positioning/architecture context reused. Design skill guidance from the preceding review retained. Gate Passed.
+- Replace the single selected-agent welcome presentation for delivered catalogs with individual cloud-configured introductions, pastel speech cards, short staggered entrance, individual dismissal and group “先自己试试”. Receipts belong to account + project + teacher; legacy shared dismissal must not incorrectly suppress other teachers. Existing hover introduction, account-wide chats, version/history/draft behavior and real unread check-ins remain intact.
+- Plan: add bounded UI-only receipt state and accessible responsive cards, retain old no-catalog greeting/check-in path and measured native-preview avoidance; cover independent dismissal, new teachers, account/project boundaries, refresh/selection and no model requests; run relevant tests/typecheck/lint/build and headless layout, then safely refresh the existing trial without taking focus. No subagents, cloud publication, formal installation or remote push.
+
+
+### Multi-Teacher Introduction Outcome And Verification
+
+- Delivered teachers now each have a separate pastel speech card (published description first, welcome message fallback, generic name-only greeting if neither exists), small avatar, explicit open action and individual close. Cards enter at 180ms offsets then remain, with bounded scrolling and reduced-motion support; “先自己试试” dismisses the current group. Opening one teacher consumes only their introduction. Hover still exposes the full description, and the introduction is not injected into chat history or model context.
+- Local presentation receipts are keyed by account/project/teacher and survive refresh. Other projects/accounts and newly delivered teachers remain independent. Existing global welcome-dismissed data remains intact for no-catalog compatibility and does not suppress never-introduced catalog teachers. Preserve legacy proactive invitations and their unread acknowledgment, cloud definitions/version binding, normal selection, free input/drafts, billing and operation behavior; no backend/protocol change.
+- Unit coverage verifies all-teacher display despite legacy dismissal, individual/remount/project/account boundaries, exact clicked-teacher routing, unpublished/new catalog entries after refresh, no reset of unread receipts and absence of model requests. Focused companion suite passes 39 tests; earlier combined relevant suites pass 119 tests before the four new regressions. Final full `pnpm test`: 263 suites / 2646 tests pass with 3 prior skips; separate pressure stage passes 1/1.
+- Typecheck, full lint (0 errors, 8 existing warnings), production build and whitespace checks pass. All 13 headless preview/layout cases pass, including 375/768/1280px multi-card layouts, many-teacher scrolling, reduced motion, individual/all dismissal, exact selection, and measured native preview clearance. Desktop and narrow screenshots inspected. Updated native Electron scenarios parse/list 19 tests; foreground native E2E was not launched.
+- Updated only the running trial Renderer to `index-D9hEfyAc.js`, retaining Main PID 62668, bundle/profile/port and prior lazy-load Main assets. Trial snapshot/backups are under `multi-teacher-welcome-20260929/`. Before refresh, verified no active request/worker and that the one nonempty teacher input exactly matched its account/agent persisted draft; backed it up instead of clearing it. All 13 persisted draft values, route and authenticated identity remain unchanged after refresh.
+- Actual live DOM now has 2 delivered teacher tabs and 2 matching introduction cards (architecture teacher and Alice); screenshot inspected and cropped without activating the window. Window remains visible/unfocused. Focus monitor observed Codex only, and temporary inspector was closed. No cloud publication, live model question, formal install/restart or remote push; source change is committed locally.
+- Required documentation structure passes; inherited drift check still reports only the same five imported task records relative to the original merge base. No foreign task record or canonical document edited. Retain this checkout because the trial runs its build.
+- Promotion candidate: canonical classroom interaction/current-state should replace catalog-wide single welcome with project-scoped per-teacher introductory receipts and independent group presentation. Evidence: user's approved design, source/tests and live two-teacher capture. This supersedes the older shared welcome-dismissal UX for delivered catalogs only; legacy/check-in semantics remain compatible. No additional product decision is needed; canonical promotion requires a separate integration gate.
diff --git a/README.md b/README.md
index 8fbbe35e..7cbe4afd 100644
--- a/README.md
+++ b/README.md
@@ -173,7 +173,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 16px、行高 1.8，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
-- 进入项目时，智能体头像旁先显示运营发布的欢迎语气泡，不调用模型、不声称已检查项目；点击智能体进入咨询时立即收起欢迎语，并按账号记住已查看，关闭、重新打开、切换项目或刷新后不重复弹出；主动收起也保留同样记录。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
+- 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡依次出现后保留，可分别关闭或用“先自己试试”整组收起；按账号、项目、智能体记录已介绍状态，当前项目刷新后不重复，新增智能体单独补上。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
 - 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“不知道问什么，你先帮我看看👀”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“不知道问什么，你先帮我看看👀”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
 - 老师咨询只展示老师正文和可点击的快捷回复卡片，学生也可在“和老师聊聊”输入框自由输入。点击卡片原样发送该回复，保留当前输入草稿；旧话题的数据不会恢复想法板、结构图、流程图或对照表及其操作。
 - 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“不知道问什么，你先帮我看看👀”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
diff --git a/src/pages/Chat/TeacherCompanion.tsx b/src/pages/Chat/TeacherCompanion.tsx
index 56b9c39a..b9d53171 100644
--- a/src/pages/Chat/TeacherCompanion.tsx
+++ b/src/pages/Chat/TeacherCompanion.tsx
@@ -1,5 +1,5 @@
 import { ArrowUpRight, Loader2, RefreshCw, X } from 'lucide-react';
-import { useState, type Ref } from 'react';
+import { useState, type CSSProperties, type Ref } from 'react';
 import { Provider as TooltipProvider } from '@radix-ui/react-tooltip';
 import { TeacherAvatar } from './TeacherAvatar';
 import { TeacherIntroduction } from './TeacherIntroduction';
@@ -14,7 +14,7 @@ export function TeacherCompanion({ companion, open, onOpen, onToggle, bubbleRef,
   bubbleRef?: Ref<HTMLDivElement>;
   introductionRef?: Ref<HTMLDivElement>;
 }) {
-  const { definition, invitation, welcome, loading, enabled, checking, error } = companion;
+  const { definition, invitation, welcome, welcomes, loading, enabled, checking, error } = companion;
   const [introductionId, setIntroductionId] = useState<string | null>(null);
   const introductionProps = (id: string) => ({
     open: introductionId === id,
@@ -25,6 +25,7 @@ export function TeacherCompanion({ companion, open, onOpen, onToggle, bubbleRef,
   const agents = companion.selectedAgent && !companion.agents.some((item) => item.teacher_id === activeId)
     ? [...companion.agents, companion.selectedAgent] : companion.agents;
   const viewConversation = () => { companion.dismiss(); onOpen(); };
+  const meetTeacher = (agentId: string) => { setIntroductionId(null); companion.dismissWelcome(agentId); onOpen(agentId); };
   const status = loading ? '正在连接智能体…'
     : checking ? '智能体在看看你最近的进展…'
     : error || (!enabled ? '智能体暂未开放，仍可查看以往讨论' : open ? '我们慢慢聊，想到什么都可以说' : '点我聊聊，想到什么都可以说');
@@ -60,6 +61,29 @@ export function TeacherCompanion({ companion, open, onOpen, onToggle, bubbleRef,
         <span>{companion.refreshing ? '刷新中' : companion.refreshStatus === 'error' ? '刷新失败' : companion.refreshStatus === 'success' ? '已更新' : '刷新'}</span>
       </button>
       <span className="sr-only" role="status" aria-live="polite">{refreshMessage}</span>
+      {!invitation && welcomes.length > 0 && <div ref={bubbleRef} className="teacher-welcome-presence" data-testid="teacher-welcomes" aria-label="认识这里的老师">
+        <div className="teacher-welcome-heading"><span>来认识一下</span>
+          <button type="button" onClick={companion.dismissWelcomes}>先自己试试</button>
+        </div>
+        <div className="teacher-welcome-list">
+          {welcomes.map((item, index) => <article key={item.agentId} className="teacher-welcome-card" data-agent-id={item.agentId}
+            data-tone={item.tone} style={{ '--welcome-delay': `${Math.min(index, 4) * 180}ms` } as CSSProperties}>
+            <button type="button" className="teacher-welcome-avatar" aria-label={`认识${item.definition.name}`} onClick={() => meetTeacher(item.agentId)}>
+              <TeacherAvatar definition={item.definition} />
+            </button>
+            <div className="teacher-welcome-bubble">
+              <button type="button" className="teacher-welcome-open" aria-label={`和${item.definition.name}聊聊`} onClick={() => meetTeacher(item.agentId)}>
+                <span className="teacher-welcome-name">{item.definition.name}</span>
+                <span className="teacher-welcome-text" title={item.text}>{item.text}</span>
+                <span className="teacher-welcome-action">和我聊聊 <ArrowUpRight aria-hidden="true" className="h-3 w-3" /></span>
+              </button>
+              <button type="button" className="teacher-welcome-dismiss" aria-label={`收起${item.definition.name}的介绍`} onClick={() => companion.dismissWelcome(item.agentId)}>
+                <X className="h-3.5 w-3.5" aria-hidden="true" />
+              </button>
+            </div>
+          </article>)}
+        </div>
+      </div>}
       {(invitation || welcome) && <div ref={bubbleRef} className="teacher-companion-presence" data-testid="teacher-presence">
         <div className="teacher-companion-bubble" data-testid="teacher-invitation" data-bubble-kind={invitation ? 'check-in' : 'welcome'}>
           <div className="teacher-companion-bubble-heading">
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index 057c45c3..267c32d6 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -113,5 +113,27 @@
 .teacher-companion-actions button:hover { text-decoration: underline; text-underline-offset: 4px; }
 .teacher-companion-speaker { flex-shrink: 0; width: 48px; height: 48px; margin-top: 5px; border-radius: 8px; }
 .teacher-companion-speaker img { width: 100%; height: 100%; object-fit: contain; image-rendering: pixelated; filter: drop-shadow(0 3px 1px #33485820); }
+.teacher-welcome-presence { position: absolute; top: calc(100% + 12px); right: 0; z-index: 90; width: 340px; max-width: calc(100vw - 40px); padding: 6px; border-radius: 18px; background: #fffdf8; box-shadow: 0 8px 24px #30465f12; }
+.teacher-welcome-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 0 8px 4px; color: #6a7463; font-size: 12px; }
+.teacher-welcome-heading button { min-height: 32px; padding: 0 4px; color: #4d663c; border-radius: 8px; cursor: pointer; }
+.teacher-welcome-heading button:hover { background: #eef1e8; }
+.teacher-welcome-list { display: grid; gap: 10px; max-height: min(440px, calc(100vh - 200px)); overflow-y: auto; overscroll-behavior: contain; padding: 4px 6px 8px; scrollbar-width: thin; }
+.teacher-welcome-card { --welcome-fill: #fff3ce; --welcome-edge: #efddb0; display: flex; align-items: flex-start; gap: 10px; min-width: 0; animation: teacher-welcome-arrive 220ms ease-out backwards; animation-delay: var(--welcome-delay, 0ms); }
+.teacher-welcome-card[data-tone="1"] { --welcome-fill: #edf5ff; --welcome-edge: #d7e5f5; }
+.teacher-welcome-card[data-tone="2"] { --welcome-fill: #f3edfc; --welcome-edge: #e5d9f5; }
+.teacher-welcome-avatar { flex-shrink: 0; width: 42px; height: 44px; margin-top: 8px; padding: 2px; border: 1px solid var(--welcome-edge); border-radius: 14px; background: #fff; box-shadow: 0 3px 0 var(--welcome-edge); cursor: pointer; }
+.teacher-welcome-avatar img { width: 100%; height: 100%; object-fit: cover; border-radius: 11px; }
+.teacher-welcome-bubble { position: relative; flex: 1; min-width: 0; border: 1px solid var(--welcome-edge); border-radius: 17px 17px 17px 6px; background: var(--welcome-fill); box-shadow: 0 2px 0 var(--welcome-edge); }
+.teacher-welcome-bubble::before { content: ''; position: absolute; top: 23px; left: -5px; width: 8px; height: 8px; transform: rotate(45deg); border-left: 1px solid var(--welcome-edge); border-bottom: 1px solid var(--welcome-edge); background: var(--welcome-fill); }
+.teacher-welcome-open { display: flex; flex-direction: column; gap: 6px; width: 100%; min-width: 0; padding: 12px; border-radius: inherit; color: #34465c; text-align: left; cursor: pointer; }
+.teacher-welcome-open:hover { background: #ffffff40; }
+.teacher-welcome-name { padding-right: 20px; font-size: 13px; font-weight: 600; line-height: 19px; overflow-wrap: anywhere; }
+.teacher-welcome-text { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; overflow-wrap: anywhere; white-space: pre-wrap; font-size: 13px; line-height: 1.6; }
+.teacher-welcome-action { display: inline-flex; align-items: center; gap: 3px; color: #596b55; font-size: 11px; line-height: 18px; }
+.teacher-welcome-dismiss { position: absolute; top: 5px; right: 5px; display: grid; place-items: center; width: 30px; height: 30px; color: #6e776b; border-radius: 10px; cursor: pointer; }
+.teacher-welcome-dismiss:hover { background: #ffffff90; }
+@keyframes teacher-welcome-arrive { from { opacity: 0; transform: translateY(5px); } to { opacity: 1; transform: translateY(0); } }
+@media (prefers-reduced-motion: reduce) { .teacher-welcome-card { animation: none; } }
+@media (max-width: 600px) { .teacher-welcome-presence { position: fixed; top: 64px; right: 12px; max-width: calc(100vw - 24px); } }
 /* Native preview clearance is measured against the bubble, not the whole pane. */
 @media (max-height: 650px) { .teacher-companion-bubble { padding-top: 9px; } .teacher-companion-message { -webkit-line-clamp: 2; } }
diff --git a/src/pages/Chat/use-teacher-companion.ts b/src/pages/Chat/use-teacher-companion.ts
index 2f356390..d95c4386 100644
--- a/src/pages/Chat/use-teacher-companion.ts
+++ b/src/pages/Chat/use-teacher-companion.ts
@@ -42,6 +42,11 @@ function writeLocal(key: string, value: unknown) {
   try { localStorage.setItem(key, JSON.stringify(value)); } catch { /* In-memory state remains usable. */ }
 }
 
+function readIntroducedAgents(key: string | null): string[] {
+  const value = key ? readLocal<unknown>(key, []) : [];
+  return Array.isArray(value) ? value.filter((id): id is string => typeof id === 'string') : [];
+}
+
 function unreadInvitation(state: Pick<CompanionState, 'topic' | 'seen'>) {
   if (state.topic?.conversation) return null;
   return state.topic?.requests.slice().reverse().find((request) => request.intent === 'check-in'
@@ -52,6 +57,21 @@ export function useTeacherCompanion(options: Options) {
   const account = useAuthStore((state) => state.user?.userId ?? state.user?.username ?? 'signed-out');
   const scope = account;
   const storageKey = `makelore-teacher-presence:${scope}`;
+  const introductionKey = options.projectId
+    ? `${storageKey}:project:${encodeURIComponent(options.projectId)}:introduced-agents` : null;
+  const [introductions, setIntroductions] = useState(() => ({ key: introductionKey, ids: readIntroducedAgents(introductionKey) }));
+  const introducedIds = introductions.key === introductionKey ? introductions.ids : readIntroducedAgents(introductionKey);
+  const dismissIntroductions = useCallback((ids: string[]) => {
+    if (!introductionKey || !ids.length) return;
+    setIntroductions(current => {
+      const previous = current.key === introductionKey ? current.ids : readIntroducedAgents(introductionKey);
+      const next = [...new Set([...previous, ...ids])];
+      if (current.key === introductionKey && next.length === previous.length) return current;
+      writeLocal(introductionKey, next);
+      return { key: introductionKey, ids: next };
+    });
+  }, [introductionKey]);
+  const dismissWelcome = useCallback((agentId: string) => dismissIntroductions([agentId]), [dismissIntroductions]);
   const [state, setState] = useState<CompanionState>({ agents: [], definition: null, enabled: false, loading: true, refreshing: false, refreshStatus: 'idle', topic: null, seen: [], welcomeDismissed: false, error: '' });
   const [unreadAgentIds, setUnreadAgentIds] = useState<string[]>([]);
   const selectionEpoch = useRef(0);
@@ -322,7 +342,20 @@ export function useTeacherCompanion(options: Options) {
   const selectedAgentId = visibleState.selectedAgent?.teacher_id ?? selectedDefinition?.config_id;
   const selectedAgent = visibleState.selectedAgent === null ? undefined
     : visibleState.agents.find((item) => item.teacher_id === selectedAgentId) ?? visibleState.selectedAgent;
-  const welcome = topic?.role !== 'friend' && !options.teacherOpen && !visibleState.loading && visibleState.enabled && !visibleState.welcomeDismissed
+  useEffect(() => {
+    // Opening one teacher consumes only that teacher's introduction, never their unread replies.
+    if (options.teacherOpen && selectedAgent?.teacher_id) dismissWelcome(selectedAgent.teacher_id);
+  }, [options.teacherOpen, selectedAgent?.teacher_id, dismissWelcome]);
+  const welcomes = options.projectId && !options.teacherOpen && !visibleState.loading
+    ? visibleState.agents.flatMap((agent, index) => introducedIds.includes(agent.teacher_id) ? [] : [{
+      agentId: agent.teacher_id,
+      definition: agent.definition,
+      text: agent.definition.description.trim() || agent.definition.welcome_message.trim()
+        || `我是${agent.definition.name}，一起聊聊你的想法吧。`,
+      tone: index % 3,
+    }]) : [];
+  const dismissWelcomes = () => dismissIntroductions(welcomes.map(item => item.agentId));
+  const welcome = !visibleState.agents.length && topic?.role !== 'friend' && !options.teacherOpen && !visibleState.loading && visibleState.enabled && !visibleState.welcomeDismissed
     ? selectedDefinition?.welcome_message.trim() || null : null;
   return {
     unreadAgentIds,
@@ -336,7 +369,10 @@ export function useTeacherCompanion(options: Options) {
     topic,
     invitation,
     welcome,
-    bubbleVisible: Boolean(invitation || welcome),
+    welcomes,
+    dismissWelcome,
+    dismissWelcomes,
+    bubbleVisible: Boolean(invitation || welcome || welcomes.length),
     checking: last?.intent === 'check-in' && ['preparing', 'running'].includes(last.status),
     dismiss,
     noteTopic,
diff --git a/tests/e2e/fixtures/teacher-preview-layout.tsx b/tests/e2e/fixtures/teacher-preview-layout.tsx
index 3d26e8f9..50ebed75 100644
--- a/tests/e2e/fixtures/teacher-preview-layout.tsx
+++ b/tests/e2e/fixtures/teacher-preview-layout.tsx
@@ -18,6 +18,8 @@ export function Layout() {
   const [refreshing, setRefreshing] = useState(false);
   const [refreshStatus, setRefreshStatus] = useState<'idle' | 'success' | 'error'>('idle');
   const [selected, setSelected] = useState(0);
+  const welcomeMode = new URLSearchParams(location.search).has('welcomes');
+  const [dismissed, setDismissed] = useState<string[]>([]);
   const agents = Array.from({ length: count }, (_, index) => ({
     teacher_id: `agent-${index}`, version: index + 1, is_default: index === 0,
     definition: { config_id: `agent-${index}`, name: `智能体${index + 1}`, avatar_id: 'avatar-06',
@@ -27,8 +29,11 @@ export function Layout() {
   const companion = {
     agents, unreadAgentIds: [], selectedAgent: agents[selected],
     definition: agents[selected]?.definition ?? { name: '编程老师', avatar_id: 'avatar-06' },
-    invitation: visible ? { response: long ? '你刚才说想做一个宠物游戏。我们一起想想，什么样的小动作，会让你愿意一直陪它玩下去？可以先挑一个最想试的想法。' : '有什么编程问题想一起讨论？' } : null,
+    invitation: !welcomeMode && visible ? { response: long ? '你刚才说想做一个宠物游戏。我们一起想想，什么样的小动作，会让你愿意一直陪它玩下去？可以先挑一个最想试的想法。' : '有什么编程问题想一起讨论？' } : null,
     welcome: null, enabled: true, loading: false, checking: false, error: null,
+    welcomes: welcomeMode && !open ? agents.flatMap((agent, index) => dismissed.includes(agent.teacher_id) ? [] : [{ agentId: agent.teacher_id, definition: agent.definition, text: agent.definition.description, tone: index % 3 }]) : [],
+    dismissWelcome: (id: string) => setDismissed(ids => [...new Set([...ids, id])]),
+    dismissWelcomes: () => setDismissed(agents.map(agent => agent.teacher_id)),
     refreshing, refreshStatus,
     refresh: async () => {
       setRefreshing(true);
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index c02816c1..2d88f823 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -2186,9 +2186,9 @@ test('teacher avatar consumes the welcome bubble through close, reopen and reloa
     await page.getByTestId('ai-module-option-programming').click();
     await page.evaluate(() => { window.location.hash = '/chat'; });
     const teacherButton = page.getByRole('button', { name: '与代码智能体聊天', exact: true });
-    const invitation = page.getByTestId('teacher-invitation');
+    const invitation = page.locator('[data-testid="teacher-welcomes"] .teacher-welcome-card[data-agent-id="teacher-code"]');
     const teacher = page.getByTestId('teacher-chat-panel');
-    await expect(invitation).toHaveAttribute('data-bubble-kind', 'welcome');
+    await expect(invitation).toBeVisible();
     await teacherButton.click();
     await expect(teacher).toBeVisible();
     await expect(teacher.getByText('一起理解代码', { exact: true })).toBeVisible();
@@ -2205,6 +2205,7 @@ test('teacher avatar consumes the welcome bubble through close, reopen and reloa
     await page.reload();
     await expect(teacherButton).toBeVisible();
     await expect(invitation).toHaveCount(0);
+    await expect(page.getByRole('button', { name: '收起朋友的介绍' })).toBeVisible();
     expect((await readState(electronApp)).captured.filter(item => /\/(agent-topics|messages|teacher-check-in|prompt)$/.test(item.path) && item.method === 'POST')).toHaveLength(0);
   } finally { await releaseSnapshot(electronApp); }
 });
@@ -2229,9 +2230,9 @@ test('teacher stays in the top-right header without legacy check-ins or taking o
     await expect(teacherButton.locator('img')).toHaveAttribute('src', /avatar-01/);
     await expect(page.getByRole('checkbox', { name: '智能体偶尔来看看' })).toHaveCount(0);
     await expect(page.getByTestId('teacher-companion')).toHaveCount(1);
-    const invitation = companion.getByTestId('teacher-invitation');
-    await expect(invitation).toHaveAttribute('data-bubble-kind', 'welcome');
-    await expect(invitation).toContainText('一起理解代码');
+    const invitation = companion.locator('.teacher-welcome-card[data-agent-id="teacher-code"]');
+    await expect(invitation).toBeVisible();
+    await expect(invitation).toContainText('一起发现代码里的小奥秘，把想法变成作品。');
     await expect(invitation).toBeInViewport({ ratio: 1 });
     expect((await readState(electronApp)).captured.filter((item) => item.path.endsWith('/teacher-check-in'))).toHaveLength(0);
     await page.screenshot({ path: test.info().outputPath('teacher-entry-greeting.png') });
@@ -2261,27 +2262,28 @@ test('teacher stays in the top-right header without legacy check-ins or taking o
     expect(introductionViewportBounds!.y).toBeGreaterThanOrEqual(introductionBounds!.y + introductionBounds!.height);
     await page.keyboard.press('Escape');
     await expect(introduction).toHaveCount(0);
-    await expect(invitation).toHaveAttribute('data-bubble-kind', 'welcome');
+    await expect(invitation).toBeVisible();
     expect((await readState(electronApp)).captured.filter(item => /\/(messages|teacher-check-in)$/.test(item.path) && item.method === 'POST')).toHaveLength(0);
     await page.getByRole('tab', { name: '操作对话', exact: true }).click();
     await composer.focus();
     await page.clock.fastForward(300_000);
-    await expect(invitation).toContainText('一起理解代码');
-    await expect(invitation).toHaveAttribute('data-bubble-kind', 'welcome');
+    await expect(invitation).toContainText('一起发现代码里的小奥秘，把想法变成作品。');
+    await expect(invitation).toBeVisible();
     expect((await readState(electronApp)).captured.filter((item) => item.path.endsWith('/teacher-check-in'))).toHaveLength(0);
     await expect(invitation).toBeInViewport({ ratio: 1 });
-    const presence = companion.getByTestId('teacher-presence');
-    await expect(presence.getByRole('button', { name: '打开这条智能体消息' })).toBeVisible();
-    await expect(presence.getByRole('button', { name: '打开这条智能体消息' }).locator('img')).toHaveAttribute('src', await teacherButton.locator('img').getAttribute('src') as string);
+    const presence = companion.getByTestId('teacher-welcomes');
+    await expect(presence.getByRole('button', { name: '认识代码智能体' })).toBeVisible();
+    await expect(presence.getByRole('button', { name: '认识代码智能体' }).locator('img')).toHaveAttribute('src', await teacherButton.locator('img').getAttribute('src') as string);
     const [invitationBounds, companionBounds, avatarBounds, presenceBounds, speakerBounds] = await Promise.all([
-      invitation.boundingBox(), companion.boundingBox(), teacherButton.locator('img').boundingBox(), presence.boundingBox(), presence.getByRole('button', { name: '打开这条智能体消息' }).boundingBox(),
+      invitation.boundingBox(), companion.boundingBox(), teacherButton.locator('img').boundingBox(), presence.boundingBox(), presence.getByRole('button', { name: '认识代码智能体' }).boundingBox(),
     ]);
     expect(invitationBounds).not.toBeNull();
     expect(companionBounds).not.toBeNull();
     expect(avatarBounds).not.toBeNull();
     expect(invitationBounds!.y).toBeGreaterThanOrEqual(avatarBounds!.y + avatarBounds!.height);
     expect(Math.abs(presenceBounds!.x + presenceBounds!.width - companionBounds!.x - companionBounds!.width)).toBeLessThanOrEqual(2);
-    expect(speakerBounds!.x - invitationBounds!.x - invitationBounds!.width).toBeLessThanOrEqual(10);
+    expect(speakerBounds!.x).toBeGreaterThanOrEqual(presenceBounds!.x);
+    expect(speakerBounds!.x + speakerBounds!.width).toBeLessThan(invitationBounds!.x + invitationBounds!.width);
     await expect(composer).toBeFocused();
     await expect(composer).toHaveValue('我还在写自己的想法');
     await expect(page.getByRole('tab', { name: '操作对话', exact: true })).toHaveAttribute('aria-selected', 'true');
@@ -2303,7 +2305,7 @@ test('teacher stays in the top-right header without legacy check-ins or taking o
     await expect(composer).toHaveValue('我还在写自己的想法');
     await page.clock.fastForward(300_000);
     expect((await readState(electronApp)).captured.filter((item) => item.path.endsWith('/teacher-check-in'))).toHaveLength(0);
-    await invitation.getByRole('button', { name: '和智能体聊聊' }).click();
+    await invitation.getByRole('button', { name: '和代码智能体聊聊' }).click();
     await expect(invitation).toHaveCount(0);
     await expect(presence).toHaveCount(0);
     await expect(teacherButton).toBeVisible();
diff --git a/tests/e2e/teacher-preview-layout.spec.ts b/tests/e2e/teacher-preview-layout.spec.ts
index 1cc8be0b..a7850600 100644
--- a/tests/e2e/teacher-preview-layout.spec.ts
+++ b/tests/e2e/teacher-preview-layout.spec.ts
@@ -4,7 +4,7 @@ import { resolve } from 'node:path';
 
 let server: ViteDevServer;
 let baseUrl: string;
-test.use({ channel: process.env.MAKELORE_LAYOUT_BROWSER_CHANNEL, video: 'off' });
+test.use({ headless: true, channel: process.env.MAKELORE_LAYOUT_BROWSER_CHANNEL, video: 'off' });
 test.beforeAll(async () => {
   server = await createServer({
     configFile: false,
@@ -35,6 +35,50 @@ test.beforeAll(async () => {
 });
 test.afterAll(async () => { await server?.close(); });
 
+for (const width of [375, 768, 1280]) {
+  test(`all teacher introductions fit at ${width}px and keep the native preview clear`, async ({ page }) => {
+    await page.setViewportSize({ width, height: 800 });
+    await page.goto(baseUrl + '?agents=3&welcomes');
+    const group = page.getByTestId('teacher-welcomes');
+    await expect(group.locator('.teacher-welcome-card')).toHaveCount(3);
+    await expect(group).toBeInViewport({ ratio: 1 });
+    for (const card of await group.locator('.teacher-welcome-card').all()) {
+      await expect(card).toBeInViewport({ ratio: 1 });
+      expect(await card.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
+    }
+    await expect.poll(async () => {
+      const [bubble, viewport] = await Promise.all([group.boundingBox(), page.getByTestId('agent-browser-viewport').boundingBox()]);
+      return !!bubble && !!viewport && viewport.y >= bubble.y + bubble.height;
+    }).toBe(true);
+    await page.screenshot({ path: test.info().outputPath(`teacher-introductions-${width}.png`) });
+    await group.getByRole('button', { name: '收起智能体2的介绍' }).click();
+    await expect(group.locator('.teacher-welcome-card')).toHaveCount(2);
+    await group.getByRole('button', { name: '和智能体3聊聊' }).click();
+    await expect(page.getByRole('button', { name: '与智能体3聊天' })).toHaveAttribute('aria-pressed', 'true');
+    await expect(group).toHaveCount(0);
+    await page.getByRole('button', { name: '关闭智能体栏' }).click();
+    await expect(group.locator('.teacher-welcome-card')).toHaveCount(1);
+    await group.getByRole('button', { name: '先自己试试' }).click();
+    await expect(group).toHaveCount(0);
+  });
+}
+
+test('many teacher introductions remain scrollable and honor reduced motion', async ({ page }) => {
+  await page.setViewportSize({ width: 520, height: 600 });
+  await page.emulateMedia({ reducedMotion: 'reduce' });
+  await page.goto(baseUrl + '?agents=8&welcomes');
+  const group = page.getByTestId('teacher-welcomes');
+  await expect(group).toBeInViewport({ ratio: 1 });
+  await expect(group.locator('.teacher-welcome-card')).toHaveCount(8);
+  await expect(group.locator('.teacher-welcome-card').first()).toHaveCSS('animation-name', 'none');
+  const last = group.getByRole('button', { name: '和智能体8聊聊' });
+  await last.scrollIntoViewIfNeeded();
+  await expect(last).toBeInViewport({ ratio: 1 });
+  expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(520);
+  await group.getByRole('button', { name: '先自己试试' }).click();
+  await expect(group).toHaveCount(0);
+});
+
 for (const width of [520, 1000]) {
   test(`distributed agent tabs scroll inside the title bar at ${width}px`, async ({ page }) => {
     await page.setViewportSize({ width, height: 800 });
diff --git a/tests/unit/teacher-companion.test.tsx b/tests/unit/teacher-companion.test.tsx
index 31ec78b8..d070da70 100644
--- a/tests/unit/teacher-companion.test.tsx
+++ b/tests/unit/teacher-companion.test.tsx
@@ -7,8 +7,9 @@ import { TeacherChatPanel } from '@/pages/Chat/TeacherChatPanel';
 import { TEACHER_CHECK_IN_INTERVAL_MS, type TeacherCatalog, type TeacherDefinition, type TeacherTopic } from '../../shared/coding-teacher';
 
 const api = vi.hoisted(() => ({ catalog: vi.fn(), config: vi.fn(), list: vi.fn(), read: vi.fn(), create: vi.fn(), send: vi.fn(), events: vi.fn(), checkIn: vi.fn(), conversation: vi.fn(), sendConversation: vi.fn(), seenConversation: vi.fn() }));
+const identity = vi.hoisted(() => ({ id: 'kid' }));
 vi.mock('@/lib/coding-teacher', () => ({ teacherApi: api, legacyTopicBase: (base: string) => base, teacherTopicsPath: (project: string) => project }));
-vi.mock('@/stores/auth', () => ({ useAuthStore: (selector: (state: unknown) => unknown) => selector({ user: { userId: 'kid' } }) }));
+vi.mock('@/stores/auth', () => ({ useAuthStore: (selector: (state: unknown) => unknown) => selector({ user: { userId: identity.id } }) }));
 const definition: TeacherDefinition = {
   schema_version: 1, teacher_id: 'coding-teacher', name: '运营配置的智能体', description: '', avatar_id: 'avatar-06', welcome_message: '', suggested_questions: [], system_prompt: '指导', skills: [],
   model: { model_id: 'model', reasoning_choice: { mode: 'default' } }, limits: { max_input_tokens: 8000, max_output_tokens: 1500 },
@@ -37,6 +38,7 @@ async function advance(ms = TEACHER_CHECK_IN_INTERVAL_MS) {
 }
 beforeEach(() => {
   vi.resetAllMocks(); vi.useFakeTimers(); localStorage.clear();
+  identity.id = 'kid';
   vi.stubGlobal('ResizeObserver', class {
     observe() {}
     unobserve() {}
@@ -52,6 +54,83 @@ beforeEach(() => {
 });
 afterEach(() => { cleanup(); vi.useRealTimers(); vi.unstubAllGlobals(); });
 
+describe('individual teacher introductions', () => {
+  const agents = ['方法老师', '体验老师', '故事老师'].map((name, index) => ({
+    teacher_id: `intro-${index}`, version: 1, is_default: index === 0,
+    definition: { ...definition, config_id: `intro-${index}`, name, description: `${name}的自我介绍`, welcome_message: `${name}的聊天欢迎语` },
+  }));
+
+  it('introduces every delivered teacher independently of the old shared welcome dismissal without sending requests', async () => {
+    localStorage.setItem('makelore-teacher-presence:kid:welcome-dismissed', 'true');
+    api.catalog.mockResolvedValue({ items: agents });
+    await mount();
+    const group = screen.getByTestId('teacher-welcomes');
+    for (const agent of agents) expect(within(group).getByText(agent.definition.description)).toBeVisible();
+    expect(screen.queryByTestId('teacher-invitation')).not.toBeInTheDocument();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '收起体验老师的介绍' })));
+    expect(within(group).queryByText('体验老师的自我介绍')).not.toBeInTheDocument();
+    expect(within(group).getByText('方法老师的自我介绍')).toBeVisible();
+    expect(within(group).getByText('故事老师的自我介绍')).toBeVisible();
+    await advance();
+    expect(api.create).not.toHaveBeenCalled();
+    expect(api.send).not.toHaveBeenCalled();
+    expect(api.sendConversation).not.toHaveBeenCalled();
+    expect(api.checkIn).not.toHaveBeenCalled();
+    expect(api.seenConversation).not.toHaveBeenCalled();
+  });
+
+  it('keeps dismissal across reloads for this account/project while leaving other projects and accounts independent', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    const first = await mount();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '收起方法老师的介绍' })));
+    first.unmount();
+    const next = await mount();
+    expect(screen.queryByRole('button', { name: '收起方法老师的介绍' })).not.toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '收起体验老师的介绍' })).toBeVisible();
+    await act(async () => next.rerender(<Harness projectId="other" />));
+    expect(screen.getByRole('button', { name: '收起方法老师的介绍' })).toBeVisible();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '先自己试试' })));
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    await act(async () => next.rerender(<Harness />));
+    expect(screen.queryByRole('button', { name: '收起方法老师的介绍' })).not.toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '收起体验老师的介绍' })).toBeVisible();
+    identity.id = 'another-kid';
+    await act(async () => next.rerender(<Harness />));
+    expect(screen.getByRole('button', { name: '收起方法老师的介绍' })).toBeVisible();
+  });
+
+  it('opens the clicked teacher and consumes only their introduction, preserving the others for later', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    await mount();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '和故事老师聊聊' })));
+    expect(screen.getByRole('button', { name: '与故事老师聊天' })).toHaveAttribute('aria-pressed', 'true');
+    expect(screen.getByTestId('teacher-chat-panel')).toHaveTextContent('故事老师的聊天欢迎语');
+    expect(screen.getByTestId('teacher-chat-panel')).not.toHaveTextContent('故事老师的自我介绍');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '与故事老师聊天' })));
+    expect(screen.queryByRole('button', { name: '收起故事老师的介绍' })).not.toBeInTheDocument();
+    expect(screen.getByRole('button', { name: '收起方法老师的介绍' })).toBeVisible();
+    expect(screen.getByRole('button', { name: '收起体验老师的介绍' })).toBeVisible();
+    expect(api.create).not.toHaveBeenCalled();
+    expect(api.sendConversation).not.toHaveBeenCalled();
+  });
+
+  it('introduces only newly delivered teachers after dismiss-all, without resetting seen replies or existing receipts on refresh', async () => {
+    localStorage.setItem('makelore-teacher-presence:kid:seen', JSON.stringify(['keep-seen']));
+    api.catalog.mockResolvedValue({ items: agents });
+    await mount();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '先自己试试' })));
+    const added = { ...agents[0], teacher_id: 'new', definition: { ...agents[0].definition, config_id: 'new', name: '新老师', description: '', welcome_message: '新老师的云端欢迎语' } };
+    api.catalog.mockResolvedValue({ items: [...agents.map(agent => ({ ...agent, version: 2 })), added] });
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '刷新智能体' })));
+    expect(screen.getByTestId('teacher-welcomes')).toHaveTextContent('新老师的云端欢迎语');
+    for (const agent of agents) expect(screen.queryByRole('button', { name: `收起${agent.definition.name}的介绍` })).not.toBeInTheDocument();
+    expect(JSON.parse(localStorage.getItem('makelore-teacher-presence:kid:seen')!)).toEqual(['keep-seen']);
+    expect(api.sendConversation).not.toHaveBeenCalled();
+    expect(api.checkIn).not.toHaveBeenCalled();
+  });
+});
+
 describe('manual agent refresh', () => {
   it('refreshes while busy and composing, shares one request, and sends through the same agent after publication updates', async () => {
     const original = { teacher_id: 'refresh-first-method', version: 3, is_default: true, definition: { ...definition, config_id: 'refresh-first-method', name: '方法老师', welcome_message: '一起想想办法' } };

From 4199cadd1e067ce9741d6496196f4d13fed61d12 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 14:29:52 +0800
Subject: [PATCH 05/19] Collapse teacher introductions after three operation
 replies

---
 .../20260928-merge-reply-cleanup-eb8d39b3.md  |  17 +++
 README.md                                     |   2 +-
 src/pages/Chat/use-teacher-companion.ts       |   4 +
 .../Chat/use-teacher-introduction-rounds.ts   |  67 +++++++++
 tests/e2e/pi-coding-first-chat.spec.ts        |  40 ++++++
 tests/unit/teacher-companion.test.tsx         | 128 ++++++++++++++++++
 6 files changed, 257 insertions(+), 1 deletion(-)
 create mode 100644 src/pages/Chat/use-teacher-introduction-rounds.ts

diff --git a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
index 9f5837bd..74151afe 100644
--- a/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
+++ b/.project-docs/30-worklog/tasks/20260928-merge-reply-cleanup-eb8d39b3.md
@@ -141,3 +141,20 @@
 - Actual live DOM now has 2 delivered teacher tabs and 2 matching introduction cards (architecture teacher and Alice); screenshot inspected and cropped without activating the window. Window remains visible/unfocused. Focus monitor observed Codex only, and temporary inspector was closed. No cloud publication, live model question, formal install/restart or remote push; source change is committed locally.
 - Required documentation structure passes; inherited drift check still reports only the same five imported task records relative to the original merge base. No foreign task record or canonical document edited. Retain this checkout because the trial runs its build.
 - Promotion candidate: canonical classroom interaction/current-state should replace catalog-wide single welcome with project-scoped per-teacher introductory receipts and independent group presentation. Evidence: user's approved design, source/tests and live two-teacher capture. This supersedes the older shared welcome-dismissal UX for delivered catalogs only; legacy/check-in semantics remain compatible. No additional product decision is needed; canonical promotion requires a separate integration gate.
+
+
+## Follow-up: Collapse Introductions After Three Operation Rounds
+
+- User requests introductions immediately on project entry, left visible when untouched during the first three operation-Agent rounds, then automatically collapsed; hover introductions remain available. Continue the same owned UI/trial task without subagents or foreground activation.
+- Project Context Loaded: official start/status confirm task ID, feature mode, exact worktree/branch and base above; own record and active peer scopes read, unchanged entry/positioning/teacher/runtime context reused. Formal-app/cloud-policy and unfinished language-skill peers have no overlap with this presentation-only change. Gate Passed.
+- Plan: observe successful operation prompt completions from the existing conversation store, count each run once after that teacher's introduction starts, persist at most three receipts per account/project/teacher, and dismiss only introduction cards after the third round. Historical snapshots, tools/retries, failures/aborts, teacher conversations and other projects must not advance the count. Preserve individual dismissal and give newly delivered teachers their own window; do not mutate runtime, history, unread suggestions, drafts or model context. Add focused state/UI and Electron fixture regressions, run required checks/build, and safely refresh the existing temporary Renderer. No cloud publication, formal-app update or remote push.
+
+
+### Three-Round Introduction Outcome And Verification
+
+- Introduction cards appear on entry as before and now dismiss after the third successful operation-Agent prompt completion that started after their introduction. The observer reads the existing conversation store across operation chats in the active project, deduplicates by conversation/run identity, and persists only the introduction start time and up to three run receipts per account/project/teacher. Refresh resumes progress; newly delivered teachers receive their own window. Tools/retries, teacher messages, failed/aborted runs, manual compaction, old history and other projects do not count. No runtime, submission, history, prompt, cloud or billing changes.
+- Automatic dismissal uses only the per-teacher introduction receipt, preserving unread check-ins, ordinary teacher chat, hover descriptions and existing manual dismissal. Returning to a project does not reintroduce previously dismissed teachers. README reflects the new behavior.
+- Five new real-store/UI regressions cover the exact third-completion boundary, duplicate snapshots, streaming/retry/failure/abort/history/compaction exclusions, reload and source switches, project/account/new-teacher isolation, teacher conversations and hover/unread preservation. Focused 3 suites / 112 tests pass. Full test command passes 263 suites / 2651 tests with 3 unchanged skips, followed by the pressure stage 1/1. Typecheck, full lint (0 errors / 8 unchanged warnings), build:vite and whitespace checks pass. All 13 headless preview/layout cases pass; Electron fixture includes the three-round/hover/reload regression and lists 20 cases, but native foreground E2E was not launched.
+- Refreshed the existing temporary Renderer to `index-C18pxj_y.js` without restarting Main PID 62668 or taking focus. Backups and evidence: trial `teacher-introduction-rounds-20260929/`. Before reload there were no active workers/stop controls or nonempty inputs. Verified the loaded new asset, both delivered teacher cards, unchanged authenticated identity/route and all 13 saved teacher drafts. Screenshot reviewed; one initial background capture failed transiently with UnknownVizError, the next read/capture succeeded. No live three-turn model requests were made; counting behavior is verified by the regressions.
+- NSWorkspace monitor observed Codex only; trial remains visible/unfocused. Formal app and cloud configuration untouched, no remote push or subagent. Required document structure passes; drift remains the same five unchanged imported source task records relative to the original merge base. Retain this checkout for the live trial.
+- Promotion candidate: per-teacher introduction receipts now include a three-successful-operation-round window, persistent over page refresh and independent of teacher discussion. No canonical documents edited in this feature task.
diff --git a/README.md b/README.md
index 7cbe4afd..fd4eacfe 100644
--- a/README.md
+++ b/README.md
@@ -173,7 +173,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 16px、行高 1.8，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
-- 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡依次出现后保留，可分别关闭或用“先自己试试”整组收起；按账号、项目、智能体记录已介绍状态，当前项目刷新后不重复，新增智能体单独补上。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
+- 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡进入项目即依次出现，不点击时保留到操作 Agent 第 3 轮完整回复结束后自动收起，也可分别关闭或用“先自己试试”整组收起；按账号、项目、智能体保存计数及已介绍状态，刷新与操作对话切换延续进度。旧历史、老师咨询、工具调用、重试中间状态、失败／中止和其他项目不计入，新增智能体单独补上并从零计数。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
 - 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“不知道问什么，你先帮我看看👀”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“不知道问什么，你先帮我看看👀”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
 - 老师咨询只展示老师正文和可点击的快捷回复卡片，学生也可在“和老师聊聊”输入框自由输入。点击卡片原样发送该回复，保留当前输入草稿；旧话题的数据不会恢复想法板、结构图、流程图或对照表及其操作。
 - 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“不知道问什么，你先帮我看看👀”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
diff --git a/src/pages/Chat/use-teacher-companion.ts b/src/pages/Chat/use-teacher-companion.ts
index d95c4386..1e83407a 100644
--- a/src/pages/Chat/use-teacher-companion.ts
+++ b/src/pages/Chat/use-teacher-companion.ts
@@ -2,6 +2,7 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import { teacherApi, teacherTopicsPath, type TeacherCatalogState } from '@/lib/coding-teacher';
 import { useAuthStore } from '@/stores/auth';
 import { AppError } from '@/lib/error-model';
+import { useTeacherIntroductionRounds } from './use-teacher-introduction-rounds';
 import {
   TEACHER_CHECK_IN_INTERVAL_MS,
   type TeacherCheckInInput,
@@ -346,6 +347,9 @@ export function useTeacherCompanion(options: Options) {
     // Opening one teacher consumes only that teacher's introduction, never their unread replies.
     if (options.teacherOpen && selectedAgent?.teacher_id) dismissWelcome(selectedAgent.teacher_id);
   }, [options.teacherOpen, selectedAgent?.teacher_id, dismissWelcome]);
+  useTeacherIntroductionRounds(introductionKey, options.projectId,
+    visibleState.agents.filter(agent => !introducedIds.includes(agent.teacher_id)).map(agent => agent.teacher_id),
+    dismissIntroductions);
   const welcomes = options.projectId && !options.teacherOpen && !visibleState.loading
     ? visibleState.agents.flatMap((agent, index) => introducedIds.includes(agent.teacher_id) ? [] : [{
       agentId: agent.teacher_id,
diff --git a/src/pages/Chat/use-teacher-introduction-rounds.ts b/src/pages/Chat/use-teacher-introduction-rounds.ts
new file mode 100644
index 00000000..161219c3
--- /dev/null
+++ b/src/pages/Chat/use-teacher-introduction-rounds.ts
@@ -0,0 +1,67 @@
+import { useEffect } from 'react';
+import { codingConversationStore, type CodingConversationStoreState } from '@/stores/coding-conversations';
+
+interface IntroductionProgress {
+  since: number;
+  runs: string[];
+}
+
+function readProgress(key: string): Record<string, IntroductionProgress> {
+  try {
+    const value: unknown = JSON.parse(localStorage.getItem(key) ?? '{}');
+    if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
+    return Object.fromEntries(Object.entries(value).filter(([, progress]) => (
+      progress && typeof progress.since === 'number' && Number.isFinite(progress.since)
+      && Array.isArray(progress.runs) && progress.runs.length <= 3
+      && progress.runs.every((run: unknown) => typeof run === 'string')
+    )));
+  } catch { return {}; }
+}
+
+/** Presentation receipts only: observe Main's settled runs, never dispatch or edit a conversation. */
+export function useTeacherIntroductionRounds(
+  introductionKey: string | null,
+  projectId: string | null,
+  pendingAgentIds: string[],
+  dismiss: (ids: string[]) => void,
+) {
+  const agentIdsKey = JSON.stringify(pendingAgentIds);
+  useEffect(() => {
+    const agentIds: string[] = JSON.parse(agentIdsKey);
+    if (!introductionKey || !projectId || !agentIds.length) return;
+    const key = `${introductionKey}:rounds`;
+    const saved = readProgress(key);
+    const progress = Object.fromEntries(agentIds.map(id => [id, saved[id] ?? { since: Date.now(), runs: [] }]));
+    const persist = () => {
+      try { localStorage.setItem(key, JSON.stringify(progress)); } catch { /* Keep counting in memory. */ }
+    };
+    persist();
+    const observe = (state: CodingConversationStoreState) => {
+      let changed = false;
+      for (const entry of Object.values(state.entriesByConversationId)) {
+        const snapshot = entry.reducer.snapshot;
+        if (entry.loadState !== 'live' || entry.reducer.invalidation || snapshot?.conversation.projectId !== projectId) continue;
+        const run = snapshot.run;
+        // A successful top-level prompt is one round, regardless of its tool calls or retries.
+        if (run.status !== 'idle' || run.terminalReason !== 'completed' || run.mode !== 'prompt'
+          || !run.runId || run.startedAt === undefined) continue;
+        const runKey = JSON.stringify([snapshot.conversation.id, run.runId]);
+        for (const item of Object.values(progress)) {
+          // Persist the starting time so loading old history cannot consume introductions.
+          if (item.runs.length >= 3 || run.startedAt < item.since || item.runs.includes(runKey)) continue;
+          item.runs.push(runKey);
+          changed = true;
+        }
+      }
+      if (changed) persist();
+      const finished = agentIds.filter(id => progress[id].runs.length >= 3);
+      if (finished.length) dismiss(finished);
+    };
+    // Include a completion delivered during a page reload, and observe all project conversations
+    // so switching the selected operation chat cannot lose or double-count a completion.
+    observe(codingConversationStore.getState());
+    return codingConversationStore.subscribe((state, previous) => {
+      if (state.entriesByConversationId !== previous.entriesByConversationId) observe(state);
+    });
+  }, [introductionKey, projectId, agentIdsKey, dismiss]);
+}
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 2d88f823..d2a48c79 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -2174,6 +2174,46 @@ test('settled prompt releases the composer without a client receipt and keeps th
   } finally { await releaseSnapshot(electronApp); }
 });
 
+test('teacher introductions collapse after three operation replies and remain available on hover', async ({ launchElectronApp }) => {
+  const electronApp = await launchElectronApp({ skipSetup: true });
+  let page = await getStableWindow(electronApp);
+  const connection = await page.evaluate(async () => ({ token: await window.electron.ipcRenderer.invoke('hostapi:token') as string, baseUrl: await window.electron.ipcRenderer.invoke('hostapi:base-url') as string }));
+  await installCodingFirstChatHost(electronApp, connection, true);
+  await settleSnapshot(electronApp);
+  await disableCodingEventSource(page);
+  try {
+    await page.reload(); page = await getStableWindow(electronApp);
+    await page.getByTestId('ai-module-option-programming').click();
+    await page.evaluate(() => { window.location.hash = '/chat'; });
+    const introductions = page.getByTestId('teacher-welcomes');
+    await expect(introductions.locator('.teacher-welcome-card')).toHaveCount(2);
+    const startedAt = await page.evaluate(() => Date.now());
+    for (let round = 1; round <= 3; round++) {
+      for (const status of ['running', 'idle'] as const) {
+        const seq = round * 2 + (status === 'idle' ? 1 : 0);
+        const snapshot = {
+          schemaVersion: 1,
+          conversation: { id: 'conversation-pi-first-chat', projectId: 'project-pi-first-chat', agentId: 'builder', title: '新对话', model: { model: { accountId: 'account-e2e', modelId: 'model-a', thinkingLevel: 'off' }, modelResolution: 'resolved' } },
+          nodes: [], run: { status, mode: 'prompt', runId: `intro-round-${round}`, startedAt,
+            ...(status === 'idle' ? { terminalReason: 'completed', settledAt: startedAt + round } : {}) },
+          worker: { status: 'ready', generation: 1 }, cursor: { workerGeneration: 1, seq },
+          queue: { items: [] }, context: { usedTokens: 0, contextWindow: 4096, compaction: 'idle' }, pendingInteractions: [],
+        };
+        await emitCodingEvent(page, 'snapshot', { type: 'snapshot', conversationId: snapshot.conversation.id, workerGeneration: 1, seq, snapshot });
+        if (round < 3 || status === 'running') await expect(introductions).toBeVisible();
+      }
+    }
+    await expect(introductions).toHaveCount(0);
+    await page.getByRole('button', { name: '与代码智能体聊天', exact: true }).hover();
+    await expect(page.getByTestId('teacher-introduction')).toContainText('一起发现代码里的小奥秘');
+    await page.screenshot({ path: test.info().outputPath('teacher-introduction-after-three-rounds.png') });
+    await page.reload();
+    await expect(page.getByRole('button', { name: '与代码智能体聊天', exact: true })).toBeVisible();
+    await expect(introductions).toHaveCount(0);
+    expect((await readState(electronApp)).captured.filter(item => /\/(agent-topics|messages|teacher-check-in|prompt)$/.test(item.path) && item.method === 'POST')).toHaveLength(0);
+  } finally { await releaseSnapshot(electronApp); }
+});
+
 test('teacher avatar consumes the welcome bubble through close, reopen and reload without a model request', async ({ launchElectronApp }) => {
   const electronApp = await launchElectronApp({ skipSetup: true });
   let page = await getStableWindow(electronApp);
diff --git a/tests/unit/teacher-companion.test.tsx b/tests/unit/teacher-companion.test.tsx
index d070da70..989f8347 100644
--- a/tests/unit/teacher-companion.test.tsx
+++ b/tests/unit/teacher-companion.test.tsx
@@ -4,6 +4,9 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { useTeacherCompanion } from '@/pages/Chat/use-teacher-companion';
 import { TeacherCompanion } from '@/pages/Chat/TeacherCompanion';
 import { TeacherChatPanel } from '@/pages/Chat/TeacherChatPanel';
+import { codingConversationStore } from '@/stores/coding-conversations';
+import type { ConversationRunState } from '@/types/coding-conversation';
+import { createProductSnapshot } from '../fixtures/coding-conversation-product-fixtures';
 import { TEACHER_CHECK_IN_INTERVAL_MS, type TeacherCatalog, type TeacherDefinition, type TeacherTopic } from '../../shared/coding-teacher';
 
 const api = vi.hoisted(() => ({ catalog: vi.fn(), config: vi.fn(), list: vi.fn(), read: vi.fn(), create: vi.fn(), send: vi.fn(), events: vi.fn(), checkIn: vi.fn(), conversation: vi.fn(), sendConversation: vi.fn(), seenConversation: vi.fn() }));
@@ -38,6 +41,7 @@ async function advance(ms = TEACHER_CHECK_IN_INTERVAL_MS) {
 }
 beforeEach(() => {
   vi.resetAllMocks(); vi.useFakeTimers(); localStorage.clear();
+  codingConversationStore.setState({ entriesByConversationId: {}, summariesByConversationId: {} });
   identity.id = 'kid';
   vi.stubGlobal('ResizeObserver', class {
     observe() {}
@@ -60,6 +64,130 @@ describe('individual teacher introductions', () => {
     definition: { ...definition, config_id: `intro-${index}`, name, description: `${name}的自我介绍`, welcome_message: `${name}的聊天欢迎语` },
   }));
 
+  async function operation(runId: string, overrides: Partial<ConversationRunState> = {}, projectId = 'project', sourceId = 'source') {
+    const snapshot = createProductSnapshot(sourceId);
+    snapshot.conversation.projectId = projectId;
+    snapshot.run = { status: 'idle', mode: 'prompt', runId, startedAt: Date.now(), settledAt: Date.now(), terminalReason: 'completed', ...overrides };
+    snapshot.cursor.seq = (codingConversationStore.getState().entriesByConversationId[sourceId]?.reducer.snapshot?.cursor.seq ?? 0) + 1;
+    await act(async () => codingConversationStore.getState().applySnapshotEvent({
+      type: 'snapshot', conversationId: sourceId, workerGeneration: 1, seq: snapshot.cursor.seq, snapshot,
+    }));
+  }
+
+  it('leaves introductions until the third completed operation round and preserves hover and unread receipts', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    localStorage.setItem('makelore-teacher-presence:kid:seen', JSON.stringify(['keep-seen']));
+    await mount();
+    await operation('one');
+    await operation('one'); // A duplicate/recovered completion is still the same round.
+    await operation('two');
+    expect(screen.getByTestId('teacher-welcomes').querySelectorAll('.teacher-welcome-card')).toHaveLength(3);
+    await operation('three', { status: 'running', terminalReason: undefined });
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    await operation('three');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    fireEvent.pointerEnter(screen.getByRole('button', { name: '与方法老师聊天' }), { pointerType: 'mouse' });
+    expect(screen.getByRole('tooltip')).toHaveTextContent('方法老师的自我介绍');
+    expect(JSON.parse(localStorage.getItem('makelore-teacher-presence:kid:seen')!)).toEqual(['keep-seen']);
+    expect(api.sendConversation).not.toHaveBeenCalled();
+    expect(api.checkIn).not.toHaveBeenCalled();
+    expect(api.seenConversation).not.toHaveBeenCalled();
+  });
+
+  it('ignores historical, failed, aborted, tool/retry, compaction and other-project activity', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    await mount();
+    for (let i = 0; i < 3; i++) {
+      await operation(`history-${i}`, { startedAt: Date.now() - 60_000 });
+      await operation(`failed-${i}`, { status: 'error', terminalReason: 'failed' });
+      await operation(`aborted-${i}`, { terminalReason: 'aborted' });
+      await operation(`retry-${i}`, { status: 'retrying', terminalReason: undefined });
+      await operation(`tools-${i}`, { status: 'running', terminalReason: undefined });
+      await operation(`compaction-${i}`, { mode: undefined });
+      await operation(`other-project-${i}`, {}, 'other');
+    }
+    await operation('one');
+    await operation('two');
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    await operation('three');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+  });
+
+  it('continues the count across reload and operation-chat switches, including a completion during reload', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    const first = await mount();
+    await operation('same-run-id');
+    await act(async () => first.rerender(<Harness sourceId="second-source" />));
+    await operation('same-run-id', {}, 'project', 'second-source');
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    first.unmount();
+    const second = await mount({ sourceId: 'second-source' });
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    second.unmount();
+    await operation('third-during-reload', {}, 'project', 'source');
+    const third = await mount();
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    third.unmount();
+    await mount();
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+  });
+
+  it('keeps round windows independent for projects/accounts and newly delivered teachers', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    const view = await mount();
+    await operation('one');
+    await operation('two');
+    await advance(1);
+    await act(async () => view.rerender(<Harness projectId="other" />));
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    await operation('other-one', {}, 'other');
+    await act(async () => view.rerender(<Harness />));
+    await operation('three');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    await act(async () => view.rerender(<Harness projectId="other" />));
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    await operation('other-two', {}, 'other');
+    expect(screen.getByTestId('teacher-welcomes')).toBeVisible();
+    await operation('other-three', {}, 'other');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    await advance(1);
+    identity.id = 'new-kid';
+    await act(async () => view.rerender(<Harness />));
+    expect(screen.getByTestId('teacher-welcomes').querySelectorAll('.teacher-welcome-card')).toHaveLength(3);
+    identity.id = 'kid';
+    await act(async () => view.rerender(<Harness />));
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    const added = { ...agents[0], teacher_id: 'new', definition: { ...agents[0].definition, config_id: 'new', name: '新老师' } };
+    api.catalog.mockResolvedValue({ items: [...agents, added] });
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '刷新智能体' })));
+    expect(screen.getByTestId('teacher-welcomes').querySelectorAll('.teacher-welcome-card')).toHaveLength(1);
+    await operation('new-one');
+    await operation('new-two');
+    expect(screen.getByRole('button', { name: '收起新老师的介绍' })).toBeVisible();
+    await operation('new-three');
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+  });
+
+  it('does not count teacher turns and still collapses the other teachers while consultation is open', async () => {
+    api.catalog.mockResolvedValue({ items: agents });
+    const topic = { ...checkInTopic(), definition: agents[0].definition, requests: [],
+      conversation: { agentId: agents[0].teacher_id, segmentTurns: 0, discussions: {} } };
+    api.sendConversation.mockResolvedValue(topic);
+    await mount();
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '和方法老师聊聊' })));
+    for (let i = 0; i < 3; i++) {
+      fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: `老师问题${i}` } });
+      await act(async () => fireEvent.click(screen.getByRole('button', { name: '提问', exact: true })));
+    }
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '与方法老师聊天' })));
+    expect(screen.getByTestId('teacher-welcomes').querySelectorAll('.teacher-welcome-card')).toHaveLength(2);
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '与方法老师聊天' })));
+    await operation('one'); await operation('two'); await operation('three');
+    await act(async () => fireEvent.click(screen.getByRole('button', { name: '与方法老师聊天' })));
+    expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
+    expect(api.sendConversation).toHaveBeenCalledTimes(3);
+  });
+
   it('introduces every delivered teacher independently of the old shared welcome dismissal without sending requests', async () => {
     localStorage.setItem('makelore-teacher-presence:kid:welcome-dismissed', 'true');
     api.catalog.mockResolvedValue({ items: agents });

From f8a7880da3805aa4e6fea94cdbd6cf48844dbb17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 15:37:37 +0800
Subject: [PATCH 06/19] feat: add creative welcome and external works square
 links

---
 .../20260929-community-welcome-c724e5a1.md    | 61 +++++++++++++
 README.md                                     |  2 +-
 .../community/CommunityInvitation.tsx         |  8 ++
 src/components/community/CommunityLink.tsx    | 24 +++++
 src/components/community/community.css        | 36 ++++++++
 src/components/layout/Sidebar.tsx             |  2 +
 src/lib/community.ts                          |  8 ++
 src/pages/Chat/CodingChatBody.tsx             | 29 ++++++
 src/pages/Chat/CodingChatPanel.tsx            | 10 ++-
 src/pages/Chat/CodingStartHeading.tsx         | 11 +++
 src/pages/Chat/TeacherChatPanel.tsx           |  6 +-
 tests/e2e/community-welcome.spec.ts           | 90 +++++++++++++++++++
 tests/e2e/fixtures/community-welcome.tsx      | 51 +++++++++++
 tests/e2e/pi-coding-first-chat.spec.ts        | 19 +++-
 tests/e2e/teacher-reply-layout.spec.ts        | 10 +--
 tests/unit/coding-chat-panel.test.tsx         | 15 +++-
 tests/unit/coding-teacher-ui.test.tsx         | 54 +++++------
 tests/unit/community.test.tsx                 | 33 +++++++
 18 files changed, 428 insertions(+), 41 deletions(-)
 create mode 100644 .project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
 create mode 100644 src/components/community/CommunityInvitation.tsx
 create mode 100644 src/components/community/CommunityLink.tsx
 create mode 100644 src/components/community/community.css
 create mode 100644 src/lib/community.ts
 create mode 100644 src/pages/Chat/CodingChatBody.tsx
 create mode 100644 src/pages/Chat/CodingStartHeading.tsx
 create mode 100644 tests/e2e/community-welcome.spec.ts
 create mode 100644 tests/e2e/fixtures/community-welcome.tsx
 create mode 100644 tests/unit/community.test.tsx

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
new file mode 100644
index 00000000..5b7bbf65
--- /dev/null
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -0,0 +1,61 @@
+# Task: Add community inspiration to the creative welcome screen and update trial
+
+## Identity
+
+- Task ID: 20260929-community-welcome-c724e5a1
+- Mode: Feature
+- Branch: codex/20260929-community-welcome-c724e5a1-community-welcome
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-community-welcome-c724e5a1
+- Base commit: 4199cadd1e067ce9741d6496196f4d13fed61d12
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Implement a creative empty-state and explicit external Works Square links in the existing temporary application. Latest user correction: do not fetch or surface works from the square, and do not embed the square.
+
+## Intent And Constraints
+
+- User authorizes the previous community design. No subagents, desktop focus changes, cloud publication, paid model calls, formal-app installation or remote push. Preserve project selection, drafts, history and teacher three-round introduction behavior. Public community browsing is explicitly authorized; retired upload/publish and learning flows stay retired.
+
+## Outcome
+
+- Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
+- No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
+- Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
+- Temporary Renderer now loads this checkout's index-SmPpxLeP.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+
+## Verification
+
+- Pinned corepack pnpm: typecheck passed; lint:check has 0 errors and 8 pre-existing warnings; production Renderer/Main/Preload/utility build passed.
+- Final full suite: 2,654 passed, 3 skipped across 265 files including the separate pressure run. Final focused link/composer suite: 33 passed. Help-label preservation suite also passed.
+- Five headless Chrome tests passed: 375/768/1280/1470px layouts, teacher clearance, reduced motion, no square network requests or iframe, click-only external URL, draft/composer preservation and first-send dismissal. Visually inspected desktop and narrow screenshots. Native Electron fixture updated and all 20 cases parse via --list; no headed Electron test or real external-browser launch was performed.
+- Live verification: current asset, sidebar link present, no work cards or iframe, no alert, runtime worker ready/idle, authentication identity/route unchanged, all 13 saved drafts byte-equal. Updates used background loadFile with cache-busting; no app/window activation called. Focus monitor during refresh showed no trial activation.
+- Temporary bundle was missing Info.plist/helper metadata and other resources. Matched local Electron 43.4.0 main/framework SHA-256 hashes, restored 238 missing bundle files and retained the trial bundle identity. Existing conversation hydration recovered; no model prompt was sent. This repaired only temporary bundle files, not repository runtime behavior.
+- Evidence and pre-update manifests/state are in trial community-welcome-20260929/. Project-docs ownership drift and git diff checks passed.
+
+## Follow-ups
+
+- Keep the worktree while the trial references it. Merge/push only when requested.
+
+## Promotion Candidates
+
+- None recorded.
+
+
+## Project Context Loaded
+
+- Feature task `20260929-community-welcome-c724e5a1`; branch/worktree in Identity and base `4199cadd1e067ce9741d6496196f4d13fed61d12` verified by official start/status. App worktree tool returned Not a git repository for the parent chat cwd, so the official skill script created this isolated checkout. Previous trial source remains read-only.
+- Read entry/memory/positioning, own task, current integrated snapshot, decisions, architecture, domain, success criteria, evidence/reflection/commitment indexes and peer task scopes. Existing approved classroom behavior at 4199cad supersedes stale canonical component/welcome wording. Feature ownership prohibits canonical edits.
+- Goal: student-owned creation with a welcoming input and real peer-work inspiration. Main remains the remote data/auth boundary. User approval of public community browsing explicitly covers this new entry despite the earlier general gallery restriction; do not restore publishing, uploads, learning or asset galleries.
+- Peers: prior teacher cleanup/UI task owns the live trial source, formal installation/cloud-agent verification is separately active, and language-skill scope is unfinished. No changes to those checkouts or cloud. New isolated frontend feature uses committed previous UI work as base. No semantic dependency conflict.
+- Evidence: public `/api/projects?limit=100` returns 21 works including runnable apps and videos; existing Main `/api/works/projects` already provides a public safe projection. Root and play-page HEAD responses have no X-Frame-Options/frame-ancestors restriction. Prefer existing public Host API and an isolated, sandboxed community overlay without unmounting the current project.
+- Gate: Passed.
+
+## Final Plan And Scope Correction
+
+1. Keep the approved welcome/composer layout and teacher clearance.
+2. Follow the user's latest correction: only external square links. Remove the proposed feed, recommendation cards, store and in-app viewer completely. Keep project state and drafts mounted and never send a prompt on link clicks.
+3. Verify layout, click behavior, no community requests, drafts, repository checks and the actual temporary Renderer; preserve the concurrent label update and temporary profile.
+
+All three steps completed. Earlier public-feed investigation was feasibility work; no feed fetching or embedded browsing is present in the delivered feature.
diff --git a/README.md b/README.md
index fd4eacfe..8f3d1922 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ Code 会话保存的模型被下架后，会提示重新选择可用模型；用
 Makelore 是一个面向软件、视觉创作、智能机器人与个人云智能体的 AI 桌面工作台。当前版本为 `2.0.0`，源码提供四个模块入口；云智能体需配套配置 WS/Yuxi 服务。模块入口页按 Agents、Code、Canvas、Robot 排列，统一采用横向插画卡片；Agents 标语为“打造你想象中的AI助手”。工作区左上角入口点击后返回模块入口页：
 
 - `Makelore Code｜AI 编程`：管理本地项目、项目智能体、对话、文件上下文、代码变更和运行时。
-  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。
+  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话显示童趣欢迎语、输入框和「去作品广场逛逛」入口；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
 - `Makelore Agents｜AI 智能体`：配置个人云智能体并试聊，发布后正式对话、接入个人微信或创建应用 API Key。支持流式回复、审批、排队请求、附件与产物、自动任务和活动历史；重新进入时恢复最近智能体与对话，未确认操作可按原输入重试。聊天可提出日程建议，由创建者核对能力、时间和费用后启用。知识库上传、替换及导入本人会话附件后自动解析并建立索引；文档卡片区分排队、解析、索引、可用和失败，持续刷新已加载文档，失败可原地重试；零文本内容不会显示为可用，新文档可用后才移除被替换的旧文档。支持删除知识内容；个人 MCP 凭据、Skills、子智能体可自助管理。支持智能体和会话归档、发布版本比较及恢复为草稿。除知识库 embedding 向量化外，模型调用（包括知识处理触发的对话模型调用）仍按原规则由创建者个人词元点数支付，可按智能体设置每次任务和每日上限，费用按时间、来源、应用分页统计；embedding 向量化由平台承担，不计入用户用量、词元点数或智能体费用上限；应用调用者保有自己的内容空间。Main 管理云会话和本机文件，Renderer 通过 Host API 操作。配套服务接入见 [Yuxi MakeLore 说明](https://xerrors.github.io/Yuxi/advanced/makelore-agents.html)。 编辑采用全高桌面分栏，支持拖动调整与展开、独立滚动、小窗口配置/试用切换。首次创建按选用途、说要求、试一试引导，提供科学问答、故事、英语和笔记整理起点；回答方式可多选，特别要求直接编辑，仍以草稿的 system_prompt 保存。新助手预选云端目录的第一个可用模型并明确显示，可自行更换；已有助手不自动换模型。编辑区以“我的要求”和“高级设置”两个 Tab 切换，默认显示基础要求；高级设置包含能力、知识与限制，返回时保留上次分类，切换保留未保存的输入及当前试用。已开始使用的助手在顶部显示“修改已保存，尚未应用”或“已应用最新修改”，并提供显眼的“应用最新修改”按钮；保存只更新草稿，应用沿用同一发布操作，失败重试保留原操作身份。草稿明确保存（Ctrl/⌘+S），保存与切换页面保留当前试用及未发送文字；“保存并重新试用”使用最新保存的要求，保留上次试用供对比，并可复用上次问题，不自动发送。示例问题仅填入输入框；有运行、排队、审批或未确认操作时先处理当前试用。工具确认先展示实际操作说明与参数，完整技术详情可展开。确认“开始使用”会创建仅自己可用的发布版本并进入独立对话，微信渠道与应用接入仍单独配置。费用上限在限制中独立保存。Enter 发送、Shift+Enter 换行，F6 切换面板焦点、Esc 恢复分栏。
 
   云知识库的 embedding 模型只由平台管理员在 Yuxi 后台维护：在「智能体管理 → 模型供应商」启用供应商，按供应商要求填写有效的服务地址和 API Key，添加并启用 embedding 模型并填写实际向量维度；embedding 向量化费用由平台承担，不计入用户用量、词元点数或智能体费用上限；one-api 不参与 embedding 配置，Works Square 只负责其他应计费模型调用的创建者词元点数账本。客户端区分目录加载中、加载失败与无可用模型，空状态提供管理员配置说明；「刷新知识库与模型」保留未提交名称，未确认的创建请求沿用原操作身份。
diff --git a/src/components/community/CommunityInvitation.tsx b/src/components/community/CommunityInvitation.tsx
new file mode 100644
index 00000000..4faf365a
--- /dev/null
+++ b/src/components/community/CommunityInvitation.tsx
@@ -0,0 +1,8 @@
+import { CommunityLink } from './CommunityLink';
+
+export function CommunityInvitation() {
+  return <section className="community-invitation" aria-label="作品广场入口" data-testid="community-invitation">
+    <div><h2>还没想到？去找找灵感吧</h2><p>作品广场里，有小伙伴们用麦洛做出的奇思妙想。</p></div>
+    <CommunityLink />
+  </section>;
+}
diff --git a/src/components/community/CommunityLink.tsx b/src/components/community/CommunityLink.tsx
new file mode 100644
index 00000000..55c34eca
--- /dev/null
+++ b/src/components/community/CommunityLink.tsx
@@ -0,0 +1,24 @@
+import { useState } from 'react';
+import { ArrowUpRight, Compass } from 'lucide-react';
+import { openCommunity } from '@/lib/community';
+import './community.css';
+
+export function CommunityLink({ variant = 'inline', collapsed = false }: {
+  variant?: 'inline' | 'sidebar'; collapsed?: boolean;
+}) {
+  const [opening, setOpening] = useState(false);
+  const [error, setError] = useState(false);
+  return <div>
+    <button type="button" className="community-link" data-variant={variant} data-collapsed={collapsed}
+      aria-label={variant === 'sidebar' ? '作品广场' : '去作品广场逛逛'}
+      title="在浏览器打开作品广场" disabled={opening}
+      onClick={() => {
+        setOpening(true); setError(false);
+        void openCommunity().catch(() => setError(true)).finally(() => setOpening(false));
+      }}>
+      <Compass aria-hidden="true" />
+      {!collapsed && <><span>{variant === 'sidebar' ? '作品广场' : '去作品广场逛逛'}</span><ArrowUpRight className="community-link-arrow" aria-hidden="true" /></>}
+    </button>
+    {error && <span className="community-link-error" role="alert">没能打开作品广场，请再点一次试试。</span>}
+  </div>;
+}
diff --git a/src/components/community/community.css b/src/components/community/community.css
new file mode 100644
index 00000000..0562e3df
--- /dev/null
+++ b/src/components/community/community.css
@@ -0,0 +1,36 @@
+.coding-chat-body { display: flex; flex: 1; flex-direction: column; min-height: 0; min-width: 0; overflow: hidden; }
+.coding-chat-body[hidden] { display: none; }
+.coding-chat-body[data-welcome="true"] { overflow-y: auto; padding: clamp(24px, 4vh, 48px) 24px 28px; background: radial-gradient(ellipse at 45% 18%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
+.coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 0 0 auto; }
+.coding-chat-body[data-welcome="true"] .classroom-composer-view { width: 100%; max-width: 740px; margin: 0 auto; }
+.coding-chat-body[data-welcome="true"] [data-testid="coding-message-composer"] { width: 100%; padding: 0 0 28px; }
+.coding-chat-body[data-welcome="true"] .chat-composer-surface { background: #fff; border-color: #d7dfda; border-radius: 20px; box-shadow: 0 5px 0 #eaf0e8, 0 12px 32px #69774b08; }
+.coding-start-heading { position: relative; width: 100%; max-width: 740px; margin: 0 auto; padding: 0 12px 24px; text-align: center; }
+.coding-start-mark { display: inline-grid; position: relative; place-items: center; width: 57px; height: 59px; border-radius: 18px; border: 1px solid #f2d6a7; background: #fff0d7; box-shadow: 0 4px 0 #eeddbd; transform: rotate(-7deg); animation: community-hello 650ms ease-out both; }
+.coding-start-mark img { width: 35px; height: 35px; }
+.coding-start-mark > svg { position: absolute; width: 17px; height: 17px; right: -24px; top: -2px; color: #c78b36; }
+.coding-start-mark > svg:last-child { width: 12px; height: 12px; left: -23px; top: 39px; color: #83a496; }
+.coding-start-eyebrow { margin: 18px 0 7px; color: #7a7769; font-size: 12px; letter-spacing: .08em; }
+.coding-start-heading h1 { color: #304968; font-size: clamp(24px, 2.5vw, 34px); line-height: 1.45; font-weight: 650; letter-spacing: -.04em; }
+.coding-start-heading h1 span { position: relative; white-space: nowrap; background: linear-gradient(transparent 73%, #ffe6a6 73%, #ffe6a6 94%, transparent 94%); }
+.coding-start-caption { margin-top: 10px; color: #718096; font-size: 13px; line-height: 1.8; }
+.community-invitation { display: flex; align-items: center; justify-content: space-between; gap: 18px; width: 100%; max-width: 740px; margin: 5px auto 0; padding: 21px 23px; border: 1px dashed #e4d9bc; border-radius: 18px; background: #fffaf0; color: #304968; }
+.community-invitation h2 { margin-bottom: 5px; font-size: 15px; font-weight: 600; }
+.community-invitation p { color: #7c806e; font-size: 12px; line-height: 1.7; }
+.community-link { display: inline-flex; align-items: center; justify-content: center; gap: 7px; min-height: 40px; padding: 8px 13px; border: 1px solid #dce5d0; border-radius: 12px; background: #f0f5e8; color: #526b46; font-size: 13px; cursor: pointer; white-space: nowrap; }
+.community-link:hover:not(:disabled) { background: #e5eed9; border-color: #b7c6a4; }
+.community-link:disabled { opacity: .6; cursor: wait; }
+.community-link:focus-visible { outline: 2px solid #547ab0; outline-offset: 3px; }
+.community-link svg { width: 17px; height: 17px; flex-shrink: 0; }
+.community-link .community-link-arrow { width: 14px; height: 14px; }
+.community-link[data-variant="sidebar"] { justify-content: flex-start; width: 100%; margin-top: 12px; border-color: transparent; background: transparent; text-align: left; }
+.community-link[data-variant="sidebar"]:hover { background: #e8f0e7; }
+.community-link[data-collapsed="true"] { justify-content: center; padding-inline: 0; }
+.community-link-error { display: block; margin-top: 6px; color: #965a45; font-size: 12px; line-height: 1.6; }
+@keyframes community-hello { 0% { transform: rotate(-15deg) translateY(5px); opacity: 0; } 70% { transform: rotate(3deg); opacity: 1; } 100% { transform: rotate(-7deg); } }
+@media (max-width: 600px) {
+  .coding-chat-body[data-welcome="true"] { padding: 24px 16px; }
+  .coding-start-caption { max-width: 230px; margin: 9px auto 0; }
+  .community-invitation { flex-direction: column; align-items: flex-start; gap: 13px; padding: 19px; }
+}
+@media (prefers-reduced-motion: reduce) { .coding-start-mark { animation: none; } }
diff --git a/src/components/layout/Sidebar.tsx b/src/components/layout/Sidebar.tsx
index 1a59ef0a..730bb70d 100644
--- a/src/components/layout/Sidebar.tsx
+++ b/src/components/layout/Sidebar.tsx
@@ -53,6 +53,7 @@ import { useProviderStore } from '@/stores/providers';
 import type { CodingProjectSummary } from '@/types/coding-project';
 import { useProjectConfigStore } from '@/stores/project-config';
 import { toast } from 'sonner';
+import { CommunityLink } from '@/components/community/CommunityLink';
 
 type OpenDialogResult = {
   canceled: boolean;
@@ -435,6 +436,7 @@ export function Sidebar({
           <Plus className="h-4 w-4 shrink-0 text-brand" />
           {!sidebarCollapsed && '新建项目'}
         </button>
+        <CommunityLink variant="sidebar" collapsed={sidebarCollapsed} />
         <div className="classroom-projects mt-3">
           <button
             type="button"
diff --git a/src/lib/community.ts b/src/lib/community.ts
new file mode 100644
index 00000000..5faff473
--- /dev/null
+++ b/src/lib/community.ts
@@ -0,0 +1,8 @@
+import { invokeIpc } from './api-client';
+
+export const COMMUNITY_URL = 'https://square.nianxx.cn/#explore';
+
+/** Open only after the student explicitly clicks; no community data is fetched. */
+export async function openCommunity(): Promise<void> {
+  await invokeIpc('shell:openExternal', COMMUNITY_URL);
+}
diff --git a/src/pages/Chat/CodingChatBody.tsx b/src/pages/Chat/CodingChatBody.tsx
new file mode 100644
index 00000000..a54f9588
--- /dev/null
+++ b/src/pages/Chat/CodingChatBody.tsx
@@ -0,0 +1,29 @@
+import { useLayoutEffect, useRef, type ReactNode } from 'react';
+
+/** Keep the same composer mounted while the empty state becomes a conversation. */
+export function CodingChatBody({ welcome, hidden, bubble, children }: {
+  welcome: boolean; hidden: boolean; bubble?: HTMLElement | null; children: ReactNode;
+}) {
+  const ref = useRef<HTMLDivElement>(null);
+  useLayoutEffect(() => {
+    const body = ref.current;
+    if (!body || !welcome || hidden || !bubble) return;
+    const update = () => {
+      const area = body.getBoundingClientRect();
+      const message = bubble.getBoundingClientRect();
+      const overlaps = message.height > 0 && message.right > area.left && message.left < area.right && message.bottom > area.top;
+      // Wide workspaces put the welcome beside the teachers. Compact ones flow below them.
+      body.style.paddingRight = overlaps && area.width >= 1050 ? `${Math.ceil(area.right - message.left + 24)}px` : '';
+      body.style.paddingTop = overlaps && area.width < 1050 ? `${Math.ceil(message.bottom - area.top + 24)}px` : '';
+    };
+    update();
+    const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(update);
+    observer?.observe(body); observer?.observe(bubble);
+    window.addEventListener('resize', update);
+    return () => {
+      observer?.disconnect(); window.removeEventListener('resize', update);
+      body.style.paddingRight = ''; body.style.paddingTop = '';
+    };
+  }, [welcome, hidden, bubble]);
+  return <div ref={ref} className="coding-chat-body" data-welcome={welcome} hidden={hidden}>{children}</div>;
+}
diff --git a/src/pages/Chat/CodingChatPanel.tsx b/src/pages/Chat/CodingChatPanel.tsx
index 7fe9dd00..eda736d0 100644
--- a/src/pages/Chat/CodingChatPanel.tsx
+++ b/src/pages/Chat/CodingChatPanel.tsx
@@ -47,6 +47,9 @@ import { CodingConversationHeader } from './CodingConversationHeader';
 import { CodingConversationTimeline } from './CodingConversationTimeline';
 import { CodingInteractionPanel } from './CodingInteractionPanel';
 import { CodingWelcomeHero } from './CodingWelcomeHero';
+import { CodingStartHeading } from './CodingStartHeading';
+import { CodingChatBody } from './CodingChatBody';
+import { CommunityInvitation } from '@/components/community/CommunityInvitation';
 import { createLocalConversationSnapshot } from './coding-chat-snapshot';
 import { useAuthStore } from '@/stores/auth';
 import { TeacherChatPanel } from './TeacherChatPanel';
@@ -676,6 +679,8 @@ export function CodingChatPanel({
     });
   }, [loginRecovery, activeProject, targetConversationId, entryLoadState, workspaceLoadState, handleRecovery, draftKey, onLoginRecoveryConsumed]);
   const autoCreating = Boolean(selectedAgent && creatingAgentIds[selectedAgent.id]);
+  const showWelcome = editable && !selectedConversation?.archivedAt && !running && runStatus === 'idle'
+    && (!targetConversationId || (entryLoadState === 'live' && snapshot?.nodes.length === 0));
 
   if (!activeProject && workspaceLoadState !== 'loading') {
     return (
@@ -807,6 +812,7 @@ export function CodingChatPanel({
               }
             }} />
         </div>
+        <CodingChatBody welcome={showWelcome} hidden={agentBrowserOpen} bubble={teacherBubble}>
         <div id="classroom-chat-view" role="tabpanel" aria-labelledby="classroom-chat-tab" hidden={agentBrowserOpen} className="classroom-chat-view min-h-0 flex-1 flex-col">
 
         {(workspaceError || conversationMetadataError || connectionError) && (
@@ -829,7 +835,7 @@ export function CodingChatPanel({
           </div>
         )}
 
-        {targetConversationId
+        {showWelcome ? <CodingStartHeading /> : targetConversationId
           ? (
             <CodingConversationTimeline
               key={targetConversationId}
@@ -959,6 +965,8 @@ export function CodingChatPanel({
           }}
         />}
         </div>
+        {showWelcome && <CommunityInvitation />}
+        </CodingChatBody>
       </div>
 
       {consultationOpen && activeProject && (
diff --git a/src/pages/Chat/CodingStartHeading.tsx b/src/pages/Chat/CodingStartHeading.tsx
new file mode 100644
index 00000000..f40c5e70
--- /dev/null
+++ b/src/pages/Chat/CodingStartHeading.tsx
@@ -0,0 +1,11 @@
+import { Sparkles, Star } from 'lucide-react';
+import mark from '@/assets/consultations/mark.svg';
+
+export function CodingStartHeading() {
+  return <div className="coding-start-heading" data-testid="coding-start-heading">
+    <span className="coding-start-mark"><img src={mark} alt="麦洛" /><Sparkles aria-hidden="true" /><Star aria-hidden="true" /></span>
+    <p className="coding-start-eyebrow">小点子，也能变成大惊喜</p>
+    <h1>今天，你想<span>创造什么？</span></h1>
+    <p className="coding-start-caption">一个游戏、一段故事，或是一个天马行空的想法。</p>
+  </div>;
+}
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index 6203fbf7..fb5b20a1 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -471,7 +471,7 @@ export function TeacherChatPanel({
     (request) => request.status === 'preparing' || request.status === 'running'
   );
   const helpUnavailable = busy || !topicEnabled || Boolean(running);
-  const askForSuggestions = () => void send({ text: '不知道问什么，你先帮我看看👀', intent: 'suggestions' });
+  const askForSuggestions = () => void send({ text: '帮我整体看🧠', intent: 'suggestions' });
   const changeText = (next: string) => { setText(next); persistDraft(next, references, pending.current); };
   const removeReferences = () => { setReferences([]); persistDraft(text, [], pending.current); };
   const questions = definition?.suggested_questions ?? [];
@@ -541,7 +541,7 @@ export function TeacherChatPanel({
                   {request.suggestedQuestions?.map((question, index) => <button key={`${request.id}:${index}`} type="button" disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
                 </div>
               </>}
-            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry"><span>不知道问什么，<span className="whitespace-nowrap">你先帮我看看👀</span></span></button>}
+            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">帮我整体看🧠</button>}
           </> : request.response ? <TeacherReply text={request.response} /> : <div className="text-[13px] leading-7">{['running', 'preparing'].includes(request.status) ? <span role="status" className="inline-flex items-center gap-2 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />{label}正在想…</span> : ['cancelled', 'interrupted'].includes(request.status) ? '这次先停在这里。想继续时可以再说说。' : ''}</div>}
           {request.intent !== 'suggestions' && request.status === 'completed' && !request.replyIncomplete && Boolean(request.suggestedQuestions?.length) && <div className="consultation-follow-ups" aria-label="接着聊">
             {request.suggestedQuestions?.map((question, index) => <button type="button" key={`${request.id}:${index}`} disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
@@ -585,7 +585,7 @@ export function TeacherChatPanel({
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
           <div className="mt-2 flex min-h-[68px] items-center justify-between gap-2" data-testid="consultation-composer-actions">
             <div className="min-w-0 flex-1">
-              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint"><span>不知道问什么，<span className="whitespace-nowrap">你先帮我看看👀</span></span></button>}
+              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>}
             </div>
             {running ? <button type="button" className="rounded-lg border px-3 py-2 text-xs" onClick={() => void teacherApi.cancel(topicBase, endpointId, running.id).then(consume).catch(() => setError('暂时无法停止，请稍后重试。'))}>停止回复</button>
             : <button type="submit" aria-label="提问" title={busy ? '正在发送…' : '发送'} disabled={busy || !topicEnabled || !text.trim()} className="consultation-send flex h-8 w-8 items-center justify-center rounded-full text-white disabled:opacity-30"><ArrowUp className="h-4 w-4" /></button>}
diff --git a/tests/e2e/community-welcome.spec.ts b/tests/e2e/community-welcome.spec.ts
new file mode 100644
index 00000000..fe4d0ec7
--- /dev/null
+++ b/tests/e2e/community-welcome.spec.ts
@@ -0,0 +1,90 @@
+import { test, expect } from '@playwright/test';
+import { createServer, type ViteDevServer } from 'vite';
+import { resolve } from 'node:path';
+
+let server: ViteDevServer;
+let baseUrl: string;
+test.use({ headless: true, channel: process.env.MAKELORE_LAYOUT_BROWSER_CHANNEL, video: 'off' });
+test.beforeAll(async () => {
+  server = await createServer({
+    configFile: false, cacheDir: 'node_modules/.vite-community-layout',
+    resolve: { alias: { '@': resolve('src') } }, esbuild: { jsx: 'automatic' },
+    server: { host: '127.0.0.1', port: 0 },
+    plugins: [{
+      name: 'isolated-community', enforce: 'pre',
+      load(id) {
+        if (id.endsWith('/src/lib/host-events.ts')) return 'export function subscribeHostEvent() { return () => {}; }';
+        if (id.endsWith('/src/lib/host-api.ts')) return `
+          export async function createHostEventSource() { return { close() {}, addEventListener() {} }; }
+          export async function ensureHostApiToken() { return 'fixture'; }
+          export function getHostApiBase() { return ''; }
+          export function reportDesktopActivity() {}
+          export function setDesktopBackgroundLease() {}
+          export async function hostApiFetch() { return {}; }
+        `;
+      },
+      configureServer(vite) {
+        vite.middlewares.use((req, res, next) => {
+          if (req.url !== '/' && !req.url?.startsWith('/?')) return next();
+          res.setHeader('Content-Type', 'text/html');
+          res.end('<html><head><meta charset="utf-8"></head><body><div id="root"></div><script type="module" src="/tests/e2e/fixtures/community-welcome.tsx"></script></body></html>');
+        });
+      },
+    }],
+  });
+  await server.listen();
+  baseUrl = server.resolvedUrls!.local[0];
+});
+test.afterAll(async () => { await server?.close(); });
+test.beforeEach(async ({ page }) => {
+  page.on('pageerror', error => { throw error; });
+  await page.addInitScript(() => {
+    const scope = window as typeof window & { __communityCalls: unknown[][] };
+    scope.__communityCalls = [];
+    Object.defineProperty(window, 'electron', { value: { ipcRenderer: {
+      invoke: async (...args: unknown[]) => { scope.__communityCalls.push(args); return undefined; },
+    } } });
+  });
+});
+
+for (const width of [375, 768, 1280, 1470]) {
+  test(`welcome, composer and community link clear teacher introductions at ${width}px`, async ({ page }) => {
+    await page.setViewportSize({ width, height: 850 });
+    await page.emulateMedia({ reducedMotion: 'reduce' });
+    await page.goto(baseUrl + '?teachers');
+    const heading = page.getByTestId('coding-start-heading');
+    const teachers = page.getByTestId('teacher-welcomes');
+    await expect(teachers.locator('.teacher-welcome-card')).toHaveCount(2);
+    await expect.poll(async () => {
+      const a = await heading.boundingBox(), b = await teachers.boundingBox();
+      return !!a && !!b && (a.x + a.width <= b.x || a.y >= b.y + b.height);
+    }).toBe(true);
+    await expect(page.locator('.coding-start-mark')).toHaveCSS('animation-name', 'none');
+    await page.getByTestId('community-invitation').scrollIntoViewIfNeeded();
+    expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(width);
+    await expect(page.getByRole('button', { name: '去作品广场逛逛' })).toBeVisible();
+    await teachers.getByRole('button', { name: '先自己试试' }).click();
+    await heading.scrollIntoViewIfNeeded();
+    await page.screenshot({ path: test.info().outputPath(`community-welcome-${width}.png`) });
+  });
+}
+
+test('the community link opens only on click and leaves the draft mounted', async ({ page }) => {
+  await page.setViewportSize({ width: 1280, height: 850 });
+  const communityRequests: string[] = [];
+  page.on('request', request => { if (request.url().includes('square.nianxx.cn')) communityRequests.push(request.url()); });
+  await page.goto(baseUrl);
+  const composer = page.getByRole('textbox');
+  await composer.fill('我想做一个自己的小镇');
+  await composer.evaluate(node => node.setAttribute('data-mounted', 'same'));
+  await page.getByRole('button', { name: '去作品广场逛逛' }).click();
+  expect(await page.evaluate(() => (window as typeof window & { __communityCalls: unknown[][] }).__communityCalls))
+    .toContainEqual(['shell:openExternal', 'https://square.nianxx.cn/#explore']);
+  expect(communityRequests).toEqual([]);
+  await expect(page.locator('iframe')).toHaveCount(0);
+  await expect(composer).toHaveValue('我想做一个自己的小镇');
+  await expect(composer).toHaveAttribute('data-mounted', 'same');
+  await page.getByRole('button', { name: '发送', exact: true }).click();
+  await expect(page.getByTestId('community-invitation')).toHaveCount(0);
+  await expect(composer).toHaveAttribute('data-mounted', 'same');
+});
diff --git a/tests/e2e/fixtures/community-welcome.tsx b/tests/e2e/fixtures/community-welcome.tsx
new file mode 100644
index 00000000..5f18539e
--- /dev/null
+++ b/tests/e2e/fixtures/community-welcome.tsx
@@ -0,0 +1,51 @@
+import { useState, type ComponentProps } from 'react';
+import { createRoot } from 'react-dom/client';
+import { CodingChatBody } from '../../../src/pages/Chat/CodingChatBody';
+import { CodingStartHeading } from '../../../src/pages/Chat/CodingStartHeading';
+import { CodingComposer } from '../../../src/pages/Chat/CodingComposer';
+import { TeacherCompanion } from '../../../src/pages/Chat/TeacherCompanion';
+import { CommunityInvitation } from '../../../src/components/community/CommunityInvitation';
+import '../../../src/styles/globals.css';
+import '../../../src/pages/Chat/classroom-workspace.css';
+
+export function Layout() {
+  const [bubble, setBubble] = useState<HTMLDivElement | null>(null);
+  const [draft, setDraft] = useState('');
+  const [sent, setSent] = useState(false);
+  const [dismissed, setDismissed] = useState<string[]>([]);
+  const agents = ['架构工程师-陈宗琦', '产品工程师-Alice'].map((name, index) => ({
+    teacher_id: String(index), version: 1, is_default: index === 0,
+    definition: { config_id: String(index), name, avatar_id: 'avatar-06',
+      description: index === 0 ? '有什么编程问题想一起讨论？' : '陪你把天马行空的点子，变成能玩、能用、眼睛一亮的小作品。' },
+  }));
+  const companion = {
+    agents, selectedAgent: agents[0], definition: agents[0].definition, enabled: true,
+    unreadAgentIds: [], invitation: null, welcome: null, loading: false, error: null, checking: false,
+    refreshing: false, refreshStatus: 'idle', refresh: async () => {}, reloadCatalog: async () => {}, dismiss: () => {},
+    welcomes: new URLSearchParams(location.search).has('teachers') ? agents.flatMap((agent, index) => dismissed.includes(agent.teacher_id)
+      ? [] : [{ agentId: agent.teacher_id, definition: agent.definition, text: agent.definition.description, tone: index }]) : [],
+    dismissWelcome: (id: string) => setDismissed(values => [...values, id]),
+    dismissWelcomes: () => setDismissed(['0', '1']),
+  } as ComponentProps<typeof TeacherCompanion>['companion'];
+  return <div className="classroom-workspace flex h-screen flex-col bg-white">
+    <header className="relative z-50 flex h-12 shrink-0 items-center justify-end border-b px-3" data-testid="coding-conversation-header">
+      <span className="mr-auto min-w-0 truncate text-xs">测试项目 › 新对话</span>
+      <TeacherCompanion companion={companion} open={false} onOpen={() => {}} onToggle={() => {}} bubbleRef={setBubble} />
+    </header>
+    <main className="classroom-main flex min-h-0 min-w-0 flex-1 flex-col">
+      <div className="classroom-tabs" role="tablist"><button role="tab" aria-selected="true">操作对话</button><button role="tab">作品</button></div>
+      <CodingChatBody welcome={!sent} hidden={false} bubble={bubble}>
+        <div className="classroom-chat-view min-h-0 flex-1">{!sent ? <CodingStartHeading /> : <p>第一条消息已发送（测试）</p>}</div>
+        <div className="classroom-composer-view shrink-0">
+          <CodingComposer value={draft} editable canSend={Boolean(draft)} preparing={false} recovering={false}
+            runStatus="idle" mode="prompt" queue={{ items: [] }} error={null} recoverableError={false}
+            attachments={[]} submitting={false} placeholder="说说你的想法，接下来想做什么？" onChange={setDraft}
+            onModeChange={() => {}} onSubmit={() => { setSent(true); setDraft(''); }} onRecover={() => {}}
+            onAddFiles={() => {}} onRemoveAttachment={() => {}} />
+        </div>
+        {!sent && <CommunityInvitation />}
+      </CodingChatBody>
+    </main>
+  </div>;
+}
+createRoot(document.getElementById('root')!).render(<Layout />);
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index d2a48c79..fed1943a 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1121,10 +1121,25 @@ test('first PI Conversation is editable under 500 ms and submits before runtime
       buffer: largePng,
     });
     await composer.fill('Build the first PI scene');
+    await electronApp.evaluate(({ shell }) => {
+      const scope = globalThis as typeof globalThis & { __communityOpened?: string[] };
+      scope.__communityOpened = [];
+      shell.openExternal = async url => { scope.__communityOpened!.push(url); };
+    });
+    await page.getByRole('button', { name: '作品广场', exact: true }).click();
+    await page.getByRole('button', { name: '去作品广场逛逛' }).click();
+    await expect.poll(() => electronApp.evaluate(() => (
+      (globalThis as typeof globalThis & { __communityOpened?: string[] }).__communityOpened
+    ))).toEqual(['https://square.nianxx.cn/#explore', 'https://square.nianxx.cn/#explore']);
+    await expect(composer).toHaveValue('Build the first PI scene');
+    await expect(page.getByText('large.png', { exact: true })).toBeVisible();
+    await expect(page.getByRole('dialog')).toHaveCount(0);
+    expect((await readState(electronApp)).captured.filter(item => item.path.endsWith('/prompt') && item.method === 'POST')).toHaveLength(0);
     await expect(page.getByRole('button', { name: '发送' })).toBeEnabled();
     await page.getByTestId('coding-message-composer').evaluate(
       (form: HTMLFormElement) => form.requestSubmit(),
     );
+    await expect(page.getByTestId('community-invitation')).toHaveCount(0);
 
     await expect.poll(async () => {
       const state = await readState(electronApp);
@@ -1869,7 +1884,7 @@ test('project consultations preserve student drafts and switch between work and
     await expect(page.getByRole('button', { name: '与朋友聊天' })).toHaveAttribute('aria-pressed', 'true');
     await expect(page.locator('#coding-consultation-dock')).toHaveCSS('width', '508px');
     await expect(teacher.locator('form .consultation-hint')).toBeVisible();
-    await expect(teacher.locator('form .consultation-hint')).toHaveText('不知道问什么，你先帮我看看👀');
+    await expect(teacher.locator('form .consultation-hint')).toHaveText('帮我整体看🧠');
     await expect(teacher.getByText('把你的困惑说出来就好')).toHaveCount(0);
     await expect(teacher.getByText('当前项目',{exact:true})).toHaveCount(0);
     await expect(teacher.getByRole('button',{name:'解释当前代码',exact:true})).toBeVisible();
@@ -1924,7 +1939,7 @@ test('project consultations preserve student drafts and switch between work and
       expect(request.body).not.toHaveProperty('discussion');
     }
     await expect(teacher).toHaveAccessibleName('朋友咨询');
-    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'不知道问什么，你先帮我看看👀'});
+    expect(consultationRequests[0].body).toMatchObject({intent:'suggestions',text:'帮我整体看🧠'});
     expect(consultationRequests[1].body).toMatchObject({text:'怎样观察别人玩游戏？'});
     expect(consultationRequests[1].body?.intent).toBeUndefined();
     await page.screenshot({path:test.info().outputPath('project-teacher-side-chat.png')});
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index 636775fd..e5680b21 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -29,7 +29,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     const panel = page.getByTestId('teacher-chat-panel');
     const retry = panel.locator('.consultation-retry');
     await expect(retry).toBeEnabled();
-    await expect(retry).toHaveText('不知道问什么，你先帮我看看👀');
+    await expect(retry).toHaveText('帮我整体看🧠');
     expect(await retry.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
     const [panelBounds, retryBounds] = await Promise.all([panel.boundingBox(), retry.boundingBox()]);
     expect(retryBounds!.x).toBeGreaterThanOrEqual(panelBounds!.x);
@@ -41,7 +41,7 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
     await expect(input).toHaveValue('我还有一点自己的想法');
     expect(await page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs)).toEqual([
-      { requestId: expect.any(String), text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
+      { requestId: expect.any(String), text: '帮我整体看🧠', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' },
     ]);
   }
 });
@@ -89,7 +89,7 @@ for (const width of [319, 508]) {
     const send = page.getByRole('button', { name: '提问', exact: true });
     const sent = () => page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs);
     await expect(hint).toBeEnabled();
-    await expect(hint).toHaveText('不知道问什么，你先帮我看看👀');
+    await expect(hint).toHaveText('帮我整体看🧠');
     expect(await hint.evaluate(el => el.scrollWidth <= el.clientWidth && el.scrollHeight <= el.clientHeight)).toBe(true);
     await expect(hint).toHaveCSS('background-color', 'rgb(255, 242, 201)');
     const initialSend = (await send.boundingBox())!;
@@ -110,9 +110,9 @@ for (const width of [319, 508]) {
     expect(await sent()).toEqual([]);
     await hint.click();
     await expect(page.getByText('我们可以先从一个小地方开始。')).toBeVisible();
-    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
+    expect(await sent()).toEqual([{ requestId: expect.any(String), text: '帮我整体看🧠', intent: 'suggestions', references: [], projectId: 'fixture', sourceConversationId: 'source' }]);
     await expect(page.getByRole('button', { name: '我也说不清，你带我看看', exact: true })).toHaveCount(0);
-    await expect(page.locator('.consultation-messages').getByRole('button', { name: '不知道问什么，你先帮我看看👀', exact: true })).toHaveCount(0);
+    await expect(page.locator('.consultation-messages').getByRole('button', { name: '帮我整体看🧠', exact: true })).toHaveCount(0);
     const card = page.getByRole('button', { name: '可以从哪个小地方开始？' });
     await expect(card).toBeVisible();
     await input.fill('留着我自己的草稿');
diff --git a/tests/unit/coding-chat-panel.test.tsx b/tests/unit/coding-chat-panel.test.tsx
index 974d8b7b..b88f3e27 100644
--- a/tests/unit/coding-chat-panel.test.tsx
+++ b/tests/unit/coding-chat-panel.test.tsx
@@ -340,7 +340,7 @@ describe('CodingChatPanel first Conversation', () => {
     await waitFor(() => expect(codingConversationStore.getState().selectedConversationId).toBe(conversation.id));
     fireEvent.keyDown(menu, { key: 'Enter' });
     fireEvent.click(await screen.findByRole('menuitem', { name: '归档（任务继续运行）' }));
-    await screen.findByTestId('coding-conversation-pending');
+    await screen.findByRole('heading', { name: '今天，你想创造什么？' });
     expect(projectApi.create).not.toHaveBeenCalled();
     expect(conversationApi.abort).not.toHaveBeenCalled();
     fireEvent.click(screen.getByRole('button', { name: '查看归档对话' }));
@@ -434,13 +434,15 @@ describe('CodingChatPanel first Conversation', () => {
     expect(onOpenProjectSettings).not.toHaveBeenCalled();
   });
 
-  it('keeps an empty project editable without creating a conversation until first send', async () => {
+  it('keeps an empty project and its draft mounted across community visits until first send', async () => {
     projectApi.list.mockResolvedValue({ projects: [project], activeProjectId: project.id });
     projectApi.config.mockResolvedValue({ project, config });
     projectApi.conversations.mockResolvedValue([]);
     projectApi.create.mockResolvedValue(conversation);
     conversationApi.events.mockResolvedValue(new FakeEventSource() as unknown as EventSource);
     const { CodingChatPanel } = await import('@/pages/Chat/CodingChatPanel');
+    const api = await import('@/lib/api-client');
+    const external = vi.spyOn(api, 'invokeIpc').mockResolvedValue(undefined);
     const { createLocalConversationSnapshot } = await import('@/pages/Chat/coding-chat-snapshot');
     conversationApi.snapshot.mockResolvedValue(createLocalConversationSnapshot(project.id, conversation));
     render(<CodingChatPanel />);
@@ -448,8 +450,17 @@ describe('CodingChatPanel first Conversation', () => {
     expect(projectApi.create).not.toHaveBeenCalled();
     expect(conversationApi.snapshot).not.toHaveBeenCalled();
     fireEvent.change(textbox, {target:{value:'First prompt'}});
+    fireEvent.click(screen.getByRole('button', { name: '去作品广场逛逛' }));
+    await waitFor(() => expect(external).toHaveBeenCalledWith('shell:openExternal', 'https://square.nianxx.cn/#explore'));
+    expect(screen.queryByRole('dialog')).not.toBeInTheDocument();
+    expect(screen.getByRole('textbox')).toBe(textbox);
+    expect(textbox).toHaveValue('First prompt');
+    expect(projectApi.create).not.toHaveBeenCalled();
+    expect(conversationApi.submit).not.toHaveBeenCalled();
     fireEvent.click(screen.getByRole('button',{name:'发送'}));
     await waitFor(()=>expect(projectApi.create).toHaveBeenCalledOnce());
+    await waitFor(() => expect(screen.queryByTestId('community-invitation')).not.toBeInTheDocument());
+    expect(screen.getByRole('textbox')).toBe(textbox);
   });
 
   it('rehydrates a preselected stale Conversation when the programming view mounts', async () => {
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index ff2dc375..608e0a6c 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -496,13 +496,13 @@ describe('teacher side chat', () => {
     }));
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     const input = screen.getByLabelText('向智能体提问');
-    const help = () => screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' });
+    const help = () => screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(help()).toBeEnabled());
     expect(screen.getByTestId('consultation-composer-actions')).toContainElement(help());
-    expect(help()).toHaveAccessibleName('不知道问什么，你先帮我看看👀');
+    expect(help()).toHaveAccessibleName('帮我整体看🧠');
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '我先自己想想' } });
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '   ' } });
     expect(help()).toBeEnabled();
@@ -517,11 +517,11 @@ describe('teacher side chat', () => {
     expect(screen.queryByRole('button', { name: '尚未确认的问题' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(api.send).toHaveBeenCalledWith('p/agent-topics', 'first', expect.objectContaining({
-      intent: 'suggestions', text: '不知道问什么，你先帮我看看👀', sourceConversationId: 'c',
+      intent: 'suggestions', text: '帮我整体看🧠', sourceConversationId: 'c',
     }));
     expect(help()).toBeDisabled();
     fireEvent.change(input, { target: { value: '我自己还想问的另一件事' } });
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     await waitFor(() => expect(streams.has('first')).toBe(true));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify({
@@ -532,7 +532,7 @@ describe('teacher side chat', () => {
     expect(screen.queryByText('我看看你最近做到了哪里…')).not.toBeInTheDocument();
     for (const question of suggestedQuestions) expect(screen.getByRole('button', { name: question })).toBeEnabled();
     expect(screen.queryByRole('button', { name: '我也说不清，你带我看看', exact: true })).not.toBeInTheDocument();
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     expect(input).toHaveValue('我自己还想问的另一件事');
   });
@@ -567,8 +567,8 @@ describe('teacher side chat', () => {
   it('keeps an uncertain suggestions request identity through reopening and draft edits', async () => {
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled());
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我还没写完的问题' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -578,10 +578,10 @@ describe('teacher side chat', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByLabelText('向智能体提问')).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我还没写完的问题');
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     expect(api.send).toHaveBeenCalledTimes(1);
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '' } });
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(api.send.mock.calls[1][2]).toEqual(originalRequest);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -592,16 +592,16 @@ describe('teacher side chat', () => {
     localStorage.setItem('makelore-consultation-draft:signed-out:p:teacher', JSON.stringify({ text: '', references: [], pending: original }));
     api.send.mockRejectedValue(new Error('网络暂不可用'));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[0][2]))).toEqual(original);
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await screen.findByText('网络暂不可用');
     expect(JSON.parse(JSON.stringify(api.send.mock.calls[1][2]))).toEqual(original);
   });
@@ -626,13 +626,13 @@ describe('teacher side chat', () => {
     api.read.mockResolvedValue({ ...first, requests: [suggestionsRequest({ id: original.requestId, text: original.text, status })] });
     api.send.mockResolvedValue({ ...first, revision: 2 });
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled());
     expect(api.send).not.toHaveBeenCalled();
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await waitFor(() => expect(api.send).toHaveBeenCalledTimes(1));
     const sent = api.send.mock.calls[0][2] as TeacherSend;
     expect(sent.requestId).not.toBe(original.requestId);
-    expect(sent).toMatchObject({ text: '不知道问什么，你先帮我看看👀', intent: 'suggestions', references: [], sourceConversationId: 'c' });
+    expect(sent).toMatchObject({ text: '帮我整体看🧠', intent: 'suggestions', references: [], sourceConversationId: 'c' });
   });
 
   it.each(['failed', 'cancelled', 'interrupted'] as const)('retries a %s suggestion request without leaking raw JSON or reusing its accepted request id', async status => {
@@ -645,7 +645,7 @@ describe('teacher side chat', () => {
     await screen.findByText('这次没有看清楚，请再试一次。');
     expect(screen.queryByText('{"intro":"未完成')).not.toBeInTheDocument();
     expect(screen.queryByRole('button', { name: suggestedQuestions[0] })).not.toBeInTheDocument();
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send.mock.calls[0][2]).toMatchObject({ intent: 'suggestions' });
     expect(api.send.mock.calls[0][2].requestId).not.toBe(failed.id);
@@ -657,9 +657,9 @@ describe('teacher side chat', () => {
       ...first, revision: 3, requests: [accepted, suggestionsRequest({ id: input.requestId })],
     }));
     const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled());
     await waitFor(() => expect(streams.has('first')).toBe(true));
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' }));
     await screen.findByText('响应中途断开');
     fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '我的自由提问继续留着' } });
     const originalRequest = api.send.mock.calls[0][2] as TeacherSend;
@@ -673,10 +673,10 @@ describe('teacher side chat', () => {
       act(() => streams.get('first')!.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify(recovered) })));
     }
     await screen.findByText('智能体已接到，但这次回复失败了');
-    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' })).toBeEnabled());
+    await waitFor(() => expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: '.consultation-retry' })).toBeEnabled());
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('我的自由提问继续留着');
     expect(api.send).toHaveBeenCalledTimes(1);
-    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: '.consultation-retry' }));
+    fireEvent.click(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: '.consultation-retry' }));
     await screen.findByText('我们可以从最近遇到的这两个地方聊起。');
     expect(api.send).toHaveBeenCalledTimes(2);
     expect(api.send.mock.calls[1][2].requestId).not.toBe(originalRequest.requestId);
@@ -699,7 +699,7 @@ describe('teacher side chat', () => {
     expect(api.send.mock.calls[0][2].intent).toBeUndefined();
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
     expect(screen.queryByRole('button', { name: '移除引用' })).not.toBeInTheDocument();
-    expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeEnabled();
+    expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeEnabled();
     view.unmount();
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('');
@@ -787,7 +787,7 @@ describe('teacher side chat', () => {
     fireEvent.click(screen.getByRole('button', { name: '运营配置的预览问题' }));
     expect(screen.getByLabelText('向智能体提问')).toHaveValue('运营配置的预览问题');
     expect(api.send).not.toHaveBeenCalled();
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.click(screen.getByRole('button', { name: '智能体新话题' }));
     await waitFor(() => expect(api.create).toHaveBeenCalledWith('preview/sample', 7, '学生的练习代码', undefined));
   });
@@ -911,7 +911,7 @@ describe('merged cloud teacher classroom', () => {
     api.sendConversation.mockRejectedValue(new Error('结果暂未确认'));
     const props = { projectId: 'p', sourceId: 'original-source', selectedAgent: agent };
     const view = render(<TeacherChatPanel {...props} />);
-    const hint = () => screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' });
+    const hint = () => screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(hint()).toBeEnabled());
     expect(api.sendConversation).not.toHaveBeenCalled();
     fireEvent.click(hint());
@@ -984,10 +984,10 @@ describe('merged cloud teacher classroom', () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     await waitFor(() => expect(screen.getByText('智能体暂未开放，历史仍可查看。')).toBeVisible());
     const input = screen.getByLabelText('向智能体提问');
-    expect(screen.getByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).toBeDisabled();
+    expect(screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).toBeDisabled();
     fireEvent.change(input, { target: { value: '继续讨论' } });
     expect(screen.getByRole('button', { name: '提问', exact: true })).toBeDisabled();
-    expect(screen.queryByText((_text, element) => element?.textContent === '不知道问什么，你先帮我看看👀', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
+    expect(screen.queryByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' })).not.toBeInTheDocument();
     fireEvent.keyDown(input, { key: 'Enter' });
     expect(api.send).not.toHaveBeenCalled();
   });
diff --git a/tests/unit/community.test.tsx b/tests/unit/community.test.tsx
new file mode 100644
index 00000000..29257c4d
--- /dev/null
+++ b/tests/unit/community.test.tsx
@@ -0,0 +1,33 @@
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, expect, it, vi } from 'vitest';
+import { invokeIpc } from '@/lib/api-client';
+import { COMMUNITY_URL } from '@/lib/community';
+import { CommunityLink } from '@/components/community/CommunityLink';
+import { CommunityInvitation } from '@/components/community/CommunityInvitation';
+
+vi.mock('@/lib/api-client', () => ({ invokeIpc: vi.fn() }));
+beforeEach(() => { vi.mocked(invokeIpc).mockReset().mockResolvedValue(undefined); });
+afterEach(cleanup);
+
+it('only opens the public explore URL after a click, without fetching or embedding works', async () => {
+  const fetch = vi.spyOn(globalThis, 'fetch');
+  render(<CommunityInvitation />);
+  expect(invokeIpc).not.toHaveBeenCalled();
+  expect(fetch).not.toHaveBeenCalled();
+  expect(document.querySelector('iframe')).toBeNull();
+  fireEvent.click(screen.getByRole('button', { name: '去作品广场逛逛' }));
+  await waitFor(() => expect(invokeIpc).toHaveBeenCalledExactlyOnceWith('shell:openExternal', COMMUNITY_URL));
+  fetch.mockRestore();
+});
+
+it('provides an accessible collapsed sidebar entry and a retry after opening fails', async () => {
+  vi.mocked(invokeIpc).mockRejectedValueOnce(new Error('unavailable'));
+  render(<CommunityLink variant="sidebar" collapsed />);
+  const button = screen.getByRole('button', { name: '作品广场' });
+  fireEvent.click(button);
+  await screen.findByRole('alert');
+  await waitFor(() => expect(button).toBeEnabled());
+  fireEvent.click(button);
+  await waitFor(() => expect(invokeIpc).toHaveBeenCalledTimes(2));
+  expect(screen.queryByRole('alert')).not.toBeInTheDocument();
+});

From e812371973fbfb5a03733c1307116cfef567d0a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 15:50:43 +0800
Subject: [PATCH 07/19] fix: keep the welcome composer at the bottom

---
 .../20260929-community-welcome-c724e5a1.md      | 11 ++++++++++-
 README.md                                       |  2 +-
 src/components/community/community.css          | 14 +++++++-------
 src/pages/Chat/CodingChatBody.tsx               | 11 ++++++-----
 src/pages/Chat/CodingChatPanel.tsx              |  3 +--
 tests/e2e/community-welcome.spec.ts             | 17 +++++++++++++++++
 tests/e2e/fixtures/community-welcome.tsx        |  3 +--
 tests/e2e/pi-coding-first-chat.spec.ts          |  3 +++
 8 files changed, 46 insertions(+), 18 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index 5b7bbf65..cba931d5 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -23,7 +23,7 @@
 - Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
 - No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
 - Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
-- Temporary Renderer now loads this checkout's index-SmPpxLeP.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+- Temporary Renderer now loads this checkout's index-DHC9QT47.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
 
 ## Verification
 
@@ -59,3 +59,12 @@
 3. Verify layout, click behavior, no community requests, drafts, repository checks and the actual temporary Renderer; preserve the concurrent label update and temporary profile.
 
 All three steps completed. Earlier public-feed investigation was feasibility work; no feed fetching or embedded browsing is present in the delivered feature.
+
+## Follow-up: Keep Composer At Bottom
+
+- User asks to move the chat input to the bottom. Continue this owned worktree; latest trial manifest points here and checkout is clean. Existing context/ownership gates remain valid.
+- Move welcome and external square link into the scrolling content area, keep the same composer mounted at the bottom, and reserve teacher clearance only in the content area. Verify desktop/narrow/short windows, preserve drafts, then refresh the trial without activation.
+
+- Completed: composer is anchored below the independently scrolling welcome/link area, keeps its instance and draft, and remains centered while teacher clearance affects only the upper content.
+- Verification: 33 focused unit tests, all 6 headless layout/interaction tests (including a 375×600 viewport), typecheck, scoped ESLint, build:vite, native E2E --list (20 cases) and diff checks passed. Visually reviewed the new desktop layout.
+- Trial now shows the actual welcome screen with index-DHC9QT47.js, input bottom gap 16px, two teacher greetings and the square link; no cards, iframe or alert. Account, route and all 13 saved drafts preserved. Focus monitor recorded only Codex during the refresh. Evidence: trial composer-bottom-20260929/.
diff --git a/README.md b/README.md
index 8f3d1922..da3b72b7 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ Code 会话保存的模型被下架后，会提示重新选择可用模型；用
 Makelore 是一个面向软件、视觉创作、智能机器人与个人云智能体的 AI 桌面工作台。当前版本为 `2.0.0`，源码提供四个模块入口；云智能体需配套配置 WS/Yuxi 服务。模块入口页按 Agents、Code、Canvas、Robot 排列，统一采用横向插画卡片；Agents 标语为“打造你想象中的AI助手”。工作区左上角入口点击后返回模块入口页：
 
 - `Makelore Code｜AI 编程`：管理本地项目、项目智能体、对话、文件上下文、代码变更和运行时。
-  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话显示童趣欢迎语、输入框和「去作品广场逛逛」入口；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
+  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话在上方显示童趣欢迎语和「去作品广场逛逛」入口，输入框固定在内容区域底部，上方内容可独立滚动；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
 - `Makelore Agents｜AI 智能体`：配置个人云智能体并试聊，发布后正式对话、接入个人微信或创建应用 API Key。支持流式回复、审批、排队请求、附件与产物、自动任务和活动历史；重新进入时恢复最近智能体与对话，未确认操作可按原输入重试。聊天可提出日程建议，由创建者核对能力、时间和费用后启用。知识库上传、替换及导入本人会话附件后自动解析并建立索引；文档卡片区分排队、解析、索引、可用和失败，持续刷新已加载文档，失败可原地重试；零文本内容不会显示为可用，新文档可用后才移除被替换的旧文档。支持删除知识内容；个人 MCP 凭据、Skills、子智能体可自助管理。支持智能体和会话归档、发布版本比较及恢复为草稿。除知识库 embedding 向量化外，模型调用（包括知识处理触发的对话模型调用）仍按原规则由创建者个人词元点数支付，可按智能体设置每次任务和每日上限，费用按时间、来源、应用分页统计；embedding 向量化由平台承担，不计入用户用量、词元点数或智能体费用上限；应用调用者保有自己的内容空间。Main 管理云会话和本机文件，Renderer 通过 Host API 操作。配套服务接入见 [Yuxi MakeLore 说明](https://xerrors.github.io/Yuxi/advanced/makelore-agents.html)。 编辑采用全高桌面分栏，支持拖动调整与展开、独立滚动、小窗口配置/试用切换。首次创建按选用途、说要求、试一试引导，提供科学问答、故事、英语和笔记整理起点；回答方式可多选，特别要求直接编辑，仍以草稿的 system_prompt 保存。新助手预选云端目录的第一个可用模型并明确显示，可自行更换；已有助手不自动换模型。编辑区以“我的要求”和“高级设置”两个 Tab 切换，默认显示基础要求；高级设置包含能力、知识与限制，返回时保留上次分类，切换保留未保存的输入及当前试用。已开始使用的助手在顶部显示“修改已保存，尚未应用”或“已应用最新修改”，并提供显眼的“应用最新修改”按钮；保存只更新草稿，应用沿用同一发布操作，失败重试保留原操作身份。草稿明确保存（Ctrl/⌘+S），保存与切换页面保留当前试用及未发送文字；“保存并重新试用”使用最新保存的要求，保留上次试用供对比，并可复用上次问题，不自动发送。示例问题仅填入输入框；有运行、排队、审批或未确认操作时先处理当前试用。工具确认先展示实际操作说明与参数，完整技术详情可展开。确认“开始使用”会创建仅自己可用的发布版本并进入独立对话，微信渠道与应用接入仍单独配置。费用上限在限制中独立保存。Enter 发送、Shift+Enter 换行，F6 切换面板焦点、Esc 恢复分栏。
 
   云知识库的 embedding 模型只由平台管理员在 Yuxi 后台维护：在「智能体管理 → 模型供应商」启用供应商，按供应商要求填写有效的服务地址和 API Key，添加并启用 embedding 模型并填写实际向量维度；embedding 向量化费用由平台承担，不计入用户用量、词元点数或智能体费用上限；one-api 不参与 embedding 配置，Works Square 只负责其他应计费模型调用的创建者词元点数账本。客户端区分目录加载中、加载失败与无可用模型，空状态提供管理员配置说明；「刷新知识库与模型」保留未提交名称，未确认的创建请求沿用原操作身份。
diff --git a/src/components/community/community.css b/src/components/community/community.css
index 0562e3df..1de04eeb 100644
--- a/src/components/community/community.css
+++ b/src/components/community/community.css
@@ -1,11 +1,11 @@
 .coding-chat-body { display: flex; flex: 1; flex-direction: column; min-height: 0; min-width: 0; overflow: hidden; }
 .coding-chat-body[hidden] { display: none; }
-.coding-chat-body[data-welcome="true"] { overflow-y: auto; padding: clamp(24px, 4vh, 48px) 24px 28px; background: radial-gradient(ellipse at 45% 18%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
-.coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 0 0 auto; }
-.coding-chat-body[data-welcome="true"] .classroom-composer-view { width: 100%; max-width: 740px; margin: 0 auto; }
-.coding-chat-body[data-welcome="true"] [data-testid="coding-message-composer"] { width: 100%; padding: 0 0 28px; }
+.coding-chat-body[data-welcome="true"] { padding: 0 24px 16px; background: radial-gradient(ellipse at 45% 18%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
+.coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 1 1 0; overflow-y: auto; padding: clamp(24px, 4vh, 48px) 0 24px; }
+.coding-chat-body[data-welcome="true"] .classroom-composer-view { width: 100%; max-width: 740px; margin: 0 auto; padding-top: 16px; }
+.coding-chat-body[data-welcome="true"] [data-testid="coding-message-composer"] { width: 100%; padding: 0; }
 .coding-chat-body[data-welcome="true"] .chat-composer-surface { background: #fff; border-color: #d7dfda; border-radius: 20px; box-shadow: 0 5px 0 #eaf0e8, 0 12px 32px #69774b08; }
-.coding-start-heading { position: relative; width: 100%; max-width: 740px; margin: 0 auto; padding: 0 12px 24px; text-align: center; }
+.coding-start-heading { position: relative; flex-shrink: 0; width: 100%; max-width: 740px; margin: 0 auto; padding: 0 12px 24px; text-align: center; }
 .coding-start-mark { display: inline-grid; position: relative; place-items: center; width: 57px; height: 59px; border-radius: 18px; border: 1px solid #f2d6a7; background: #fff0d7; box-shadow: 0 4px 0 #eeddbd; transform: rotate(-7deg); animation: community-hello 650ms ease-out both; }
 .coding-start-mark img { width: 35px; height: 35px; }
 .coding-start-mark > svg { position: absolute; width: 17px; height: 17px; right: -24px; top: -2px; color: #c78b36; }
@@ -14,7 +14,7 @@
 .coding-start-heading h1 { color: #304968; font-size: clamp(24px, 2.5vw, 34px); line-height: 1.45; font-weight: 650; letter-spacing: -.04em; }
 .coding-start-heading h1 span { position: relative; white-space: nowrap; background: linear-gradient(transparent 73%, #ffe6a6 73%, #ffe6a6 94%, transparent 94%); }
 .coding-start-caption { margin-top: 10px; color: #718096; font-size: 13px; line-height: 1.8; }
-.community-invitation { display: flex; align-items: center; justify-content: space-between; gap: 18px; width: 100%; max-width: 740px; margin: 5px auto 0; padding: 21px 23px; border: 1px dashed #e4d9bc; border-radius: 18px; background: #fffaf0; color: #304968; }
+.community-invitation { display: flex; flex-shrink: 0; align-items: center; justify-content: space-between; gap: 18px; width: 100%; max-width: 740px; margin: 5px auto 0; padding: 21px 23px; border: 1px dashed #e4d9bc; border-radius: 18px; background: #fffaf0; color: #304968; }
 .community-invitation h2 { margin-bottom: 5px; font-size: 15px; font-weight: 600; }
 .community-invitation p { color: #7c806e; font-size: 12px; line-height: 1.7; }
 .community-link { display: inline-flex; align-items: center; justify-content: center; gap: 7px; min-height: 40px; padding: 8px 13px; border: 1px solid #dce5d0; border-radius: 12px; background: #f0f5e8; color: #526b46; font-size: 13px; cursor: pointer; white-space: nowrap; }
@@ -29,7 +29,7 @@
 .community-link-error { display: block; margin-top: 6px; color: #965a45; font-size: 12px; line-height: 1.6; }
 @keyframes community-hello { 0% { transform: rotate(-15deg) translateY(5px); opacity: 0; } 70% { transform: rotate(3deg); opacity: 1; } 100% { transform: rotate(-7deg); } }
 @media (max-width: 600px) {
-  .coding-chat-body[data-welcome="true"] { padding: 24px 16px; }
+  .coding-chat-body[data-welcome="true"] { padding: 0 16px 16px; }
   .coding-start-caption { max-width: 230px; margin: 9px auto 0; }
   .community-invitation { flex-direction: column; align-items: flex-start; gap: 13px; padding: 19px; }
 }
diff --git a/src/pages/Chat/CodingChatBody.tsx b/src/pages/Chat/CodingChatBody.tsx
index a54f9588..26401ba3 100644
--- a/src/pages/Chat/CodingChatBody.tsx
+++ b/src/pages/Chat/CodingChatBody.tsx
@@ -7,14 +7,15 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
   const ref = useRef<HTMLDivElement>(null);
   useLayoutEffect(() => {
     const body = ref.current;
-    if (!body || !welcome || hidden || !bubble) return;
+    const content = body?.querySelector<HTMLElement>('.classroom-chat-view');
+    if (!body || !content || !welcome || hidden || !bubble) return;
     const update = () => {
-      const area = body.getBoundingClientRect();
+      const area = content.getBoundingClientRect();
       const message = bubble.getBoundingClientRect();
       const overlaps = message.height > 0 && message.right > area.left && message.left < area.right && message.bottom > area.top;
       // Wide workspaces put the welcome beside the teachers. Compact ones flow below them.
-      body.style.paddingRight = overlaps && area.width >= 1050 ? `${Math.ceil(area.right - message.left + 24)}px` : '';
-      body.style.paddingTop = overlaps && area.width < 1050 ? `${Math.ceil(message.bottom - area.top + 24)}px` : '';
+      content.style.paddingRight = overlaps && area.width >= 1050 ? `${Math.ceil(area.right - message.left + 24)}px` : '';
+      content.style.paddingTop = overlaps && area.width < 1050 ? `${Math.ceil(message.bottom - area.top + 24)}px` : '';
     };
     update();
     const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(update);
@@ -22,7 +23,7 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
     window.addEventListener('resize', update);
     return () => {
       observer?.disconnect(); window.removeEventListener('resize', update);
-      body.style.paddingRight = ''; body.style.paddingTop = '';
+      content.style.paddingRight = ''; content.style.paddingTop = '';
     };
   }, [welcome, hidden, bubble]);
   return <div ref={ref} className="coding-chat-body" data-welcome={welcome} hidden={hidden}>{children}</div>;
diff --git a/src/pages/Chat/CodingChatPanel.tsx b/src/pages/Chat/CodingChatPanel.tsx
index eda736d0..2a1db052 100644
--- a/src/pages/Chat/CodingChatPanel.tsx
+++ b/src/pages/Chat/CodingChatPanel.tsx
@@ -835,7 +835,7 @@ export function CodingChatPanel({
           </div>
         )}
 
-        {showWelcome ? <CodingStartHeading /> : targetConversationId
+        {showWelcome ? <><CodingStartHeading /><CommunityInvitation /></> : targetConversationId
           ? (
             <CodingConversationTimeline
               key={targetConversationId}
@@ -965,7 +965,6 @@ export function CodingChatPanel({
           }}
         />}
         </div>
-        {showWelcome && <CommunityInvitation />}
         </CodingChatBody>
       </div>
 
diff --git a/tests/e2e/community-welcome.spec.ts b/tests/e2e/community-welcome.spec.ts
index fe4d0ec7..37089807 100644
--- a/tests/e2e/community-welcome.spec.ts
+++ b/tests/e2e/community-welcome.spec.ts
@@ -65,10 +65,27 @@ for (const width of [375, 768, 1280, 1470]) {
     await expect(page.getByRole('button', { name: '去作品广场逛逛' })).toBeVisible();
     await teachers.getByRole('button', { name: '先自己试试' }).click();
     await heading.scrollIntoViewIfNeeded();
+    const composer = page.getByTestId('coding-message-composer');
+    await expect(composer).toBeInViewport({ ratio: 1 });
+    const box = (await composer.boundingBox())!;
+    expect(850 - box.y - box.height).toBeLessThanOrEqual(40);
+    expect((await page.getByTestId('community-invitation').boundingBox())!.y).toBeLessThan(box.y);
     await page.screenshot({ path: test.info().outputPath(`community-welcome-${width}.png`) });
   });
 }
 
+test('a short window scrolls the welcome while keeping the composer at the bottom', async ({ page }) => {
+  await page.setViewportSize({ width: 375, height: 600 });
+  await page.goto(baseUrl + '?teachers');
+  const composer = page.getByTestId('coding-message-composer');
+  await expect(composer).toBeInViewport({ ratio: 1 });
+  const before = (await composer.boundingBox())!;
+  await page.getByTestId('community-invitation').scrollIntoViewIfNeeded();
+  const after = (await composer.boundingBox())!;
+  expect(after.y).toBeCloseTo(before.y, 0);
+  expect(600 - after.y - after.height).toBeLessThanOrEqual(40);
+});
+
 test('the community link opens only on click and leaves the draft mounted', async ({ page }) => {
   await page.setViewportSize({ width: 1280, height: 850 });
   const communityRequests: string[] = [];
diff --git a/tests/e2e/fixtures/community-welcome.tsx b/tests/e2e/fixtures/community-welcome.tsx
index 5f18539e..e6df5fb2 100644
--- a/tests/e2e/fixtures/community-welcome.tsx
+++ b/tests/e2e/fixtures/community-welcome.tsx
@@ -35,7 +35,7 @@ export function Layout() {
     <main className="classroom-main flex min-h-0 min-w-0 flex-1 flex-col">
       <div className="classroom-tabs" role="tablist"><button role="tab" aria-selected="true">操作对话</button><button role="tab">作品</button></div>
       <CodingChatBody welcome={!sent} hidden={false} bubble={bubble}>
-        <div className="classroom-chat-view min-h-0 flex-1">{!sent ? <CodingStartHeading /> : <p>第一条消息已发送（测试）</p>}</div>
+        <div className="classroom-chat-view min-h-0 flex-1 flex-col">{!sent ? <><CodingStartHeading /><CommunityInvitation /></> : <p>第一条消息已发送（测试）</p>}</div>
         <div className="classroom-composer-view shrink-0">
           <CodingComposer value={draft} editable canSend={Boolean(draft)} preparing={false} recovering={false}
             runStatus="idle" mode="prompt" queue={{ items: [] }} error={null} recoverableError={false}
@@ -43,7 +43,6 @@ export function Layout() {
             onModeChange={() => {}} onSubmit={() => { setSent(true); setDraft(''); }} onRecover={() => {}}
             onAddFiles={() => {}} onRemoveAttachment={() => {}} />
         </div>
-        {!sent && <CommunityInvitation />}
       </CodingChatBody>
     </main>
   </div>;
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index fed1943a..162cb605 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1110,6 +1110,9 @@ test('first PI Conversation is editable under 500 ms and submits before runtime
       await appendFile(performanceFragment, `${JSON.stringify({ editableMs })}\n`);
     }
 
+    await expect(page.getByTestId('coding-message-composer')).toBeInViewport({ ratio: 1 });
+    expect(await page.getByTestId('coding-message-composer').evaluate(el => innerHeight - el.getBoundingClientRect().bottom)).toBeLessThan(40);
+
     const pixelPng = Buffer.from(
       'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=',
       'base64',

From 521e1ee1673487f6b1fd6af3fedb3177bb6cde3c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 16:15:05 +0800
Subject: [PATCH 08/19] fix: center bottom composer between sidebar and
 teachers

---
 .../20260929-community-welcome-c724e5a1.md    | 11 ++++-
 README.md                                     |  2 +-
 src/components/community/community.css        |  3 +-
 src/pages/Chat/CodingChatBody.tsx             | 18 +++++---
 src/pages/Chat/CodingChatPanel.tsx            |  3 +-
 tests/e2e/community-welcome.spec.ts           | 42 ++++++++++++++++++-
 tests/e2e/fixtures/community-welcome.tsx      |  9 ++--
 tests/e2e/pi-coding-first-chat.spec.ts        |  5 +++
 8 files changed, 78 insertions(+), 15 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index cba931d5..408a0b2c 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -23,7 +23,7 @@
 - Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
 - No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
 - Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
-- Temporary Renderer now loads this checkout's index-DHC9QT47.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+- Temporary Renderer now loads this checkout's index-DI57yRAM.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
 
 ## Verification
 
@@ -68,3 +68,12 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 - Completed: composer is anchored below the independently scrolling welcome/link area, keeps its instance and draft, and remains centered while teacher clearance affects only the upper content.
 - Verification: 33 focused unit tests, all 6 headless layout/interaction tests (including a 375×600 viewport), typecheck, scoped ESLint, build:vite, native E2E --list (20 cases) and diff checks passed. Visually reviewed the new desktop layout.
 - Trial now shows the actual welcome screen with index-DHC9QT47.js, input bottom gap 16px, two teacher greetings and the square link; no cards, iframe or alert. Account, route and all 13 saved drafts preserved. Focus monitor recorded only Codex during the refresh. Evidence: trial composer-bottom-20260929/.
+
+## Follow-up: Align Bottom Composer Between Project Sidebar And Teacher Bubble
+
+- Latest user asks for the square invitation directly above the input, both anchored at the bottom and centered between the left project sidebar and the right teacher floating panel. Keep the floating panel at its existing width.
+- Reuse this owned, clean checkout and live trial source after checking its manifest. Existing project context applies; no other task scope changes. Keep 340px teacher welcome width (viewport safety retained), reserve its horizontal space for the main column, group invitation with the composer, test geometry with a left sidebar and short-window fallback, then refresh without focus activation.
+
+- Completed: invitation sits directly above the same mounted composer with a 12px gap. Both stay at the bottom and share the center of the space between the project sidebar and the teacher panel. The teacher panel retains its existing 340px width. Closing the panel or collapsing the sidebar recomputes the center; compact layouts scroll the heading without moving the input offscreen.
+- Verification: typecheck, 77 focused unit tests, all 8 headless layout/interaction tests, lint:check (0 errors, 8 existing warnings), scoped ESLint, build:vite, native E2E --list (20 cases), documentation ownership and diff checks passed. Added desktop geometry assertions for both sidebar widths and dismissal, plus short-window input visibility. Inspected fixture and actual trial screenshots.
+- Live trial: index-DI57yRAM.js, invitation-to-input gap 12px, teacher width 340px, center error 0px, input bottom gap 16px, two teacher greetings, no alert/cards/iframe. Auth identity, route and all 13 saved drafts preserved. Background refresh did not activate the app; focus monitor recorded only Chrome. The user later focused the app and conversation hydration recovered normally. Main PID 62668 remains unchanged. Evidence: trial composer-between-panels-20260929/.
diff --git a/README.md b/README.md
index da3b72b7..ffbc74e3 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ Code 会话保存的模型被下架后，会提示重新选择可用模型；用
 Makelore 是一个面向软件、视觉创作、智能机器人与个人云智能体的 AI 桌面工作台。当前版本为 `2.0.0`，源码提供四个模块入口；云智能体需配套配置 WS/Yuxi 服务。模块入口页按 Agents、Code、Canvas、Robot 排列，统一采用横向插画卡片；Agents 标语为“打造你想象中的AI助手”。工作区左上角入口点击后返回模块入口页：
 
 - `Makelore Code｜AI 编程`：管理本地项目、项目智能体、对话、文件上下文、代码变更和运行时。
-  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话在上方显示童趣欢迎语和「去作品广场逛逛」入口，输入框固定在内容区域底部，上方内容可独立滚动；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
+  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话在上方显示童趣欢迎语；「去作品广场逛逛」入口紧贴输入框上方，两者一起位于底部。桌面布局为老师悬浮窗保留既定宽度，输入区在左侧项目栏和右侧老师悬浮窗之间居中；小窗口的欢迎内容独立滚动；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
 - `Makelore Agents｜AI 智能体`：配置个人云智能体并试聊，发布后正式对话、接入个人微信或创建应用 API Key。支持流式回复、审批、排队请求、附件与产物、自动任务和活动历史；重新进入时恢复最近智能体与对话，未确认操作可按原输入重试。聊天可提出日程建议，由创建者核对能力、时间和费用后启用。知识库上传、替换及导入本人会话附件后自动解析并建立索引；文档卡片区分排队、解析、索引、可用和失败，持续刷新已加载文档，失败可原地重试；零文本内容不会显示为可用，新文档可用后才移除被替换的旧文档。支持删除知识内容；个人 MCP 凭据、Skills、子智能体可自助管理。支持智能体和会话归档、发布版本比较及恢复为草稿。除知识库 embedding 向量化外，模型调用（包括知识处理触发的对话模型调用）仍按原规则由创建者个人词元点数支付，可按智能体设置每次任务和每日上限，费用按时间、来源、应用分页统计；embedding 向量化由平台承担，不计入用户用量、词元点数或智能体费用上限；应用调用者保有自己的内容空间。Main 管理云会话和本机文件，Renderer 通过 Host API 操作。配套服务接入见 [Yuxi MakeLore 说明](https://xerrors.github.io/Yuxi/advanced/makelore-agents.html)。 编辑采用全高桌面分栏，支持拖动调整与展开、独立滚动、小窗口配置/试用切换。首次创建按选用途、说要求、试一试引导，提供科学问答、故事、英语和笔记整理起点；回答方式可多选，特别要求直接编辑，仍以草稿的 system_prompt 保存。新助手预选云端目录的第一个可用模型并明确显示，可自行更换；已有助手不自动换模型。编辑区以“我的要求”和“高级设置”两个 Tab 切换，默认显示基础要求；高级设置包含能力、知识与限制，返回时保留上次分类，切换保留未保存的输入及当前试用。已开始使用的助手在顶部显示“修改已保存，尚未应用”或“已应用最新修改”，并提供显眼的“应用最新修改”按钮；保存只更新草稿，应用沿用同一发布操作，失败重试保留原操作身份。草稿明确保存（Ctrl/⌘+S），保存与切换页面保留当前试用及未发送文字；“保存并重新试用”使用最新保存的要求，保留上次试用供对比，并可复用上次问题，不自动发送。示例问题仅填入输入框；有运行、排队、审批或未确认操作时先处理当前试用。工具确认先展示实际操作说明与参数，完整技术详情可展开。确认“开始使用”会创建仅自己可用的发布版本并进入独立对话，微信渠道与应用接入仍单独配置。费用上限在限制中独立保存。Enter 发送、Shift+Enter 换行，F6 切换面板焦点、Esc 恢复分栏。
 
   云知识库的 embedding 模型只由平台管理员在 Yuxi 后台维护：在「智能体管理 → 模型供应商」启用供应商，按供应商要求填写有效的服务地址和 API Key，添加并启用 embedding 模型并填写实际向量维度；embedding 向量化费用由平台承担，不计入用户用量、词元点数或智能体费用上限；one-api 不参与 embedding 配置，Works Square 只负责其他应计费模型调用的创建者词元点数账本。客户端区分目录加载中、加载失败与无可用模型，空状态提供管理员配置说明；「刷新知识库与模型」保留未提交名称，未确认的创建请求沿用原操作身份。
diff --git a/src/components/community/community.css b/src/components/community/community.css
index 1de04eeb..c36a19f2 100644
--- a/src/components/community/community.css
+++ b/src/components/community/community.css
@@ -3,9 +3,10 @@
 .coding-chat-body[data-welcome="true"] { padding: 0 24px 16px; background: radial-gradient(ellipse at 45% 18%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
 .coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 1 1 0; overflow-y: auto; padding: clamp(24px, 4vh, 48px) 0 24px; }
 .coding-chat-body[data-welcome="true"] .classroom-composer-view { width: 100%; max-width: 740px; margin: 0 auto; padding-top: 16px; }
+.coding-chat-body[data-welcome="true"] .classroom-composer-view > .community-invitation { margin: 0 auto 12px; }
 .coding-chat-body[data-welcome="true"] [data-testid="coding-message-composer"] { width: 100%; padding: 0; }
 .coding-chat-body[data-welcome="true"] .chat-composer-surface { background: #fff; border-color: #d7dfda; border-radius: 20px; box-shadow: 0 5px 0 #eaf0e8, 0 12px 32px #69774b08; }
-.coding-start-heading { position: relative; flex-shrink: 0; width: 100%; max-width: 740px; margin: 0 auto; padding: 0 12px 24px; text-align: center; }
+.coding-start-heading { position: relative; flex-shrink: 0; width: 100%; max-width: 740px; margin: var(--teacher-top-inset, 0px) auto 0; padding: 0 12px 24px; text-align: center; }
 .coding-start-mark { display: inline-grid; position: relative; place-items: center; width: 57px; height: 59px; border-radius: 18px; border: 1px solid #f2d6a7; background: #fff0d7; box-shadow: 0 4px 0 #eeddbd; transform: rotate(-7deg); animation: community-hello 650ms ease-out both; }
 .coding-start-mark img { width: 35px; height: 35px; }
 .coding-start-mark > svg { position: absolute; width: 17px; height: 17px; right: -24px; top: -2px; color: #c78b36; }
diff --git a/src/pages/Chat/CodingChatBody.tsx b/src/pages/Chat/CodingChatBody.tsx
index 26401ba3..0b8cb5c8 100644
--- a/src/pages/Chat/CodingChatBody.tsx
+++ b/src/pages/Chat/CodingChatBody.tsx
@@ -8,14 +8,19 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
   useLayoutEffect(() => {
     const body = ref.current;
     const content = body?.querySelector<HTMLElement>('.classroom-chat-view');
-    if (!body || !content || !welcome || hidden || !bubble) return;
+    if (!body || !content || hidden || !bubble) return;
     const update = () => {
-      const area = content.getBoundingClientRect();
+      const area = body.getBoundingClientRect();
       const message = bubble.getBoundingClientRect();
       const overlaps = message.height > 0 && message.right > area.left && message.left < area.right && message.bottom > area.top;
-      // Wide workspaces put the welcome beside the teachers. Compact ones flow below them.
-      content.style.paddingRight = overlaps && area.width >= 1050 ? `${Math.ceil(area.right - message.left + 24)}px` : '';
-      content.style.paddingTop = overlaps && area.width < 1050 ? `${Math.ceil(message.bottom - area.top + 24)}px` : '';
+      const rightInset = Math.ceil(area.right - message.left + 24);
+      const besideTeacher = overlaps && area.width >= 900 && area.width - rightInset - 24 >= 420;
+      // Reserve the same right rail for the welcome and bottom input. The teacher keeps its own fixed width.
+      body.style.paddingLeft = besideTeacher ? '24px' : '';
+      body.style.paddingRight = besideTeacher ? `${rightInset}px` : '';
+      // Put compact-screen clearance inside the scrolling heading, never around the fixed bottom input.
+      content.style.setProperty('--teacher-top-inset', welcome && overlaps && !besideTeacher
+        ? `${Math.max(0, Math.ceil(message.bottom - content.getBoundingClientRect().top))}px` : '0px');
     };
     update();
     const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(update);
@@ -23,7 +28,8 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
     window.addEventListener('resize', update);
     return () => {
       observer?.disconnect(); window.removeEventListener('resize', update);
-      content.style.paddingRight = ''; content.style.paddingTop = '';
+      body.style.paddingLeft = ''; body.style.paddingRight = '';
+      content.style.removeProperty('--teacher-top-inset');
     };
   }, [welcome, hidden, bubble]);
   return <div ref={ref} className="coding-chat-body" data-welcome={welcome} hidden={hidden}>{children}</div>;
diff --git a/src/pages/Chat/CodingChatPanel.tsx b/src/pages/Chat/CodingChatPanel.tsx
index 2a1db052..e0622ca6 100644
--- a/src/pages/Chat/CodingChatPanel.tsx
+++ b/src/pages/Chat/CodingChatPanel.tsx
@@ -835,7 +835,7 @@ export function CodingChatPanel({
           </div>
         )}
 
-        {showWelcome ? <><CodingStartHeading /><CommunityInvitation /></> : targetConversationId
+        {showWelcome ? <CodingStartHeading /> : targetConversationId
           ? (
             <CodingConversationTimeline
               key={targetConversationId}
@@ -898,6 +898,7 @@ export function CodingChatPanel({
 
         </div>
         <div hidden={agentBrowserOpen} className="classroom-composer-view shrink-0">
+        {showWelcome && <CommunityInvitation />}
         {selectedConversation?.archivedAt ? (
           <div className="m-4 flex items-center justify-between gap-3 rounded-xl border bg-surface-subtle px-4 py-3 text-sm">
             <span>{running ? '此对话已归档，任务仍在运行。' : '此对话已归档，恢复后可继续聊天。'}</span>
diff --git a/tests/e2e/community-welcome.spec.ts b/tests/e2e/community-welcome.spec.ts
index 37089807..219c9904 100644
--- a/tests/e2e/community-welcome.spec.ts
+++ b/tests/e2e/community-welcome.spec.ts
@@ -69,7 +69,8 @@ for (const width of [375, 768, 1280, 1470]) {
     await expect(composer).toBeInViewport({ ratio: 1 });
     const box = (await composer.boundingBox())!;
     expect(850 - box.y - box.height).toBeLessThanOrEqual(40);
-    expect((await page.getByTestId('community-invitation').boundingBox())!.y).toBeLessThan(box.y);
+    const invitation = (await page.getByTestId('community-invitation').boundingBox())!;
+    expect(box.y - invitation.y - invitation.height).toBeCloseTo(12, 0);
     await page.screenshot({ path: test.info().outputPath(`community-welcome-${width}.png`) });
   });
 }
@@ -80,12 +81,49 @@ test('a short window scrolls the welcome while keeping the composer at the botto
   const composer = page.getByTestId('coding-message-composer');
   await expect(composer).toBeInViewport({ ratio: 1 });
   const before = (await composer.boundingBox())!;
-  await page.getByTestId('community-invitation').scrollIntoViewIfNeeded();
+  await page.locator('.classroom-chat-view').evaluate(el => { el.scrollTop = el.scrollHeight; });
   const after = (await composer.boundingBox())!;
   expect(after.y).toBeCloseTo(before.y, 0);
   expect(600 - after.y - after.height).toBeLessThanOrEqual(40);
 });
 
+for (const width of [1280, 1470]) {
+  test(`the bottom input is centered between the project sidebar and fixed teacher panel at ${width}px`, async ({ page }) => {
+    await page.setViewportSize({ width, height: 850 });
+    await page.emulateMedia({ reducedMotion: 'reduce' });
+    await page.goto(baseUrl + '?teachers&sidebar');
+    const teachers = page.getByTestId('teacher-welcomes');
+    const composer = page.getByTestId('coding-message-composer');
+    await expect(teachers).toHaveCSS('width', '340px');
+    await expect.poll(async () => {
+      const [side, teacher, input] = await Promise.all([
+        page.getByTestId('project-sidebar').boundingBox(), teachers.boundingBox(), composer.boundingBox(),
+      ]);
+      return Math.abs((input!.x + input!.width / 2) - (side!.x + side!.width + teacher!.x) / 2);
+    }).toBeLessThan(2);
+    const input = (await composer.boundingBox())!;
+    const invitation = (await page.getByTestId('community-invitation').boundingBox())!;
+    expect(invitation.x).toBeCloseTo(input.x, 0);
+    expect(invitation.width).toBeCloseTo(input.width, 0);
+    expect(input.y - invitation.y - invitation.height).toBeCloseTo(12, 0);
+    await page.screenshot({ path: test.info().outputPath(`composer-between-panels-${width}.png`) });
+    await composer.getByRole('textbox').fill('保留这份草稿');
+    await page.getByTestId('project-sidebar').evaluate(el => { el.style.width = '60px'; });
+    await expect.poll(async () => {
+      const [side, teacher, input] = await Promise.all([
+        page.getByTestId('project-sidebar').boundingBox(), teachers.boundingBox(), composer.boundingBox(),
+      ]);
+      return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + teacher!.x) / 2);
+    }).toBeLessThan(2);
+    await teachers.getByRole('button', { name: '先自己试试' }).click();
+    await expect(composer.getByRole('textbox')).toHaveValue('保留这份草稿');
+    await expect.poll(async () => {
+      const [side, input] = await Promise.all([page.getByTestId('project-sidebar').boundingBox(), composer.boundingBox()]);
+      return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + width) / 2);
+    }).toBeLessThan(2);
+  });
+}
+
 test('the community link opens only on click and leaves the draft mounted', async ({ page }) => {
   await page.setViewportSize({ width: 1280, height: 850 });
   const communityRequests: string[] = [];
diff --git a/tests/e2e/fixtures/community-welcome.tsx b/tests/e2e/fixtures/community-welcome.tsx
index e6df5fb2..71712223 100644
--- a/tests/e2e/fixtures/community-welcome.tsx
+++ b/tests/e2e/fixtures/community-welcome.tsx
@@ -27,7 +27,9 @@ export function Layout() {
     dismissWelcome: (id: string) => setDismissed(values => [...values, id]),
     dismissWelcomes: () => setDismissed(['0', '1']),
   } as ComponentProps<typeof TeacherCompanion>['companion'];
-  return <div className="classroom-workspace flex h-screen flex-col bg-white">
+  return <div className="flex h-screen">
+    {new URLSearchParams(location.search).has('sidebar') && <aside data-testid="project-sidebar" className="shrink-0 border-r p-4 text-sm" style={{ width: 210, background: '#f1f6fc' }}>我的项目</aside>}
+    <div className="classroom-workspace flex min-w-0 flex-1 flex-col bg-white">
     <header className="relative z-50 flex h-12 shrink-0 items-center justify-end border-b px-3" data-testid="coding-conversation-header">
       <span className="mr-auto min-w-0 truncate text-xs">测试项目 › 新对话</span>
       <TeacherCompanion companion={companion} open={false} onOpen={() => {}} onToggle={() => {}} bubbleRef={setBubble} />
@@ -35,8 +37,9 @@ export function Layout() {
     <main className="classroom-main flex min-h-0 min-w-0 flex-1 flex-col">
       <div className="classroom-tabs" role="tablist"><button role="tab" aria-selected="true">操作对话</button><button role="tab">作品</button></div>
       <CodingChatBody welcome={!sent} hidden={false} bubble={bubble}>
-        <div className="classroom-chat-view min-h-0 flex-1 flex-col">{!sent ? <><CodingStartHeading /><CommunityInvitation /></> : <p>第一条消息已发送（测试）</p>}</div>
+        <div className="classroom-chat-view min-h-0 flex-1 flex-col">{!sent ? <CodingStartHeading /> : <p>第一条消息已发送（测试）</p>}</div>
         <div className="classroom-composer-view shrink-0">
+          {!sent && <CommunityInvitation />}
           <CodingComposer value={draft} editable canSend={Boolean(draft)} preparing={false} recovering={false}
             runStatus="idle" mode="prompt" queue={{ items: [] }} error={null} recoverableError={false}
             attachments={[]} submitting={false} placeholder="说说你的想法，接下来想做什么？" onChange={setDraft}
@@ -45,6 +48,6 @@ export function Layout() {
         </div>
       </CodingChatBody>
     </main>
-  </div>;
+  </div></div>;
 }
 createRoot(document.getElementById('root')!).render(<Layout />);
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 162cb605..538aae43 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1112,6 +1112,11 @@ test('first PI Conversation is editable under 500 ms and submits before runtime
 
     await expect(page.getByTestId('coding-message-composer')).toBeInViewport({ ratio: 1 });
     expect(await page.getByTestId('coding-message-composer').evaluate(el => innerHeight - el.getBoundingClientRect().bottom)).toBeLessThan(40);
+    await expect(page.getByTestId('community-invitation')).toBeVisible();
+    expect(await page.getByTestId('community-invitation').evaluate(el => {
+      const composer = document.querySelector('[data-testid="coding-message-composer"]')!;
+      return composer.getBoundingClientRect().top - el.getBoundingClientRect().bottom;
+    })).toBeCloseTo(12, 0);
 
     const pixelPng = Buffer.from(
       'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=',

From 5de8ea823d9e73677658648eee7cc9376a30ebb1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 16:29:19 +0800
Subject: [PATCH 09/19] fix: float teacher introductions above a centered
 welcome

---
 .../20260929-community-welcome-c724e5a1.md    | 12 +++++-
 README.md                                     |  2 +-
 src/components/community/community.css        |  6 +--
 src/pages/Chat/CodingChatBody.tsx             | 18 ++++-----
 tests/e2e/community-welcome.spec.ts           | 38 ++++++++++++-------
 tests/e2e/pi-coding-first-chat.spec.ts        |  5 +++
 6 files changed, 53 insertions(+), 28 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index 408a0b2c..d8b4cf2f 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -23,7 +23,7 @@
 - Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
 - No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
 - Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
-- Temporary Renderer now loads this checkout's index-DI57yRAM.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+- Temporary Renderer now loads this checkout's index-CwqpErpO.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
 
 ## Verification
 
@@ -77,3 +77,13 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 - Completed: invitation sits directly above the same mounted composer with a 12px gap. Both stay at the bottom and share the center of the space between the project sidebar and the teacher panel. The teacher panel retains its existing 340px width. Closing the panel or collapsing the sidebar recomputes the center; compact layouts scroll the heading without moving the input offscreen.
 - Verification: typecheck, 77 focused unit tests, all 8 headless layout/interaction tests, lint:check (0 errors, 8 existing warnings), scoped ESLint, build:vite, native E2E --list (20 cases), documentation ownership and diff checks passed. Added desktop geometry assertions for both sidebar widths and dismissal, plus short-window input visibility. Inspected fixture and actual trial screenshots.
 - Live trial: index-DI57yRAM.js, invitation-to-input gap 12px, teacher width 340px, center error 0px, input bottom gap 16px, two teacher greetings, no alert/cards/iframe. Auth identity, route and all 13 saved drafts preserved. Background refresh did not activate the app; focus monitor recorded only Chrome. The user later focused the app and conversation hydration recovered normally. Main PID 62668 remains unchanged. Evidence: trial composer-between-panels-20260929/.
+
+## Follow-up: Floating Teachers And Centered Welcome
+
+- Same task resumed through the ownership gate on branch/worktree above at 521e1ee; base and ownership remain unchanged. Existing Project Context Loaded still applies. Rechecked peer scopes: the help-label and formal-release work remain separate; preserve the integrated label and use only this trial checkout. No semantic conflict. Planning Gate: Passed.
+- Latest user asks to restore teachers as an overlay, keep the invitation/input bottom grouping, and center the illustrated welcome. Remove teacher horizontal clearance, center the welcome vertically in the remaining area above the footer, and keep compact-screen scroll clearance. Preserve the existing teacher width, introduction lifecycle, input instance and data.
+- Plan: update layout and README, verify centering and unchanged footer bounds when teachers open/close, test narrow/short windows, then refresh the trial in the background.
+
+- Completed: teacher introductions remain fixed-width overlays at the upper right, with no reserved horizontal rail. The welcome is centered horizontally in the whole content page and vertically in the available area above the bottom invitation/composer. Invitation and input sizing and spacing remain unchanged. Desktop teacher dismissal no longer shifts either element; compact content can scroll below the overlay.
+- Validation: typecheck, 77 focused unit tests, 8 headless layout/interaction cases, lint:check (0 errors, 8 existing warnings), scoped E2E ESLint, build:vite, native E2E --list (20 cases), ownership and diff checks passed. Screenshots reviewed with both teachers floating; tests assert horizontal/vertical centering, stable bounds on dismissal, collapsed sidebar alignment, bottom input and preserved drafts. Native headed tests were not run to avoid focus changes.
+- Trial updated to index-CwqpErpO.js in the background. Actual live horizontal and vertical center errors are 0px, invitation gap 12px and input bottom gap 16px. No alerts/cards/iframe; auth identity, route and all 13 saved drafts unchanged. Existing teacher dismissal state was preserved. Background native capture was unavailable (UnknownVizError), so visual review used the headless layout screenshots; live DOM geometry was independently verified. Evidence: trial floating-teachers-centered-welcome-20260929/. Keep this checkout for the live trial; no merge or push.
diff --git a/README.md b/README.md
index ffbc74e3..ef766d75 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ Code 会话保存的模型被下架后，会提示重新选择可用模型；用
 Makelore 是一个面向软件、视觉创作、智能机器人与个人云智能体的 AI 桌面工作台。当前版本为 `2.0.0`，源码提供四个模块入口；云智能体需配套配置 WS/Yuxi 服务。模块入口页按 Agents、Code、Canvas、Robot 排列，统一采用横向插画卡片；Agents 标语为“打造你想象中的AI助手”。工作区左上角入口点击后返回模块入口页：
 
 - `Makelore Code｜AI 编程`：管理本地项目、项目智能体、对话、文件上下文、代码变更和运行时。
-  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话在上方显示童趣欢迎语；「去作品广场逛逛」入口紧贴输入框上方，两者一起位于底部。桌面布局为老师悬浮窗保留既定宽度，输入区在左侧项目栏和右侧老师悬浮窗之间居中；小窗口的欢迎内容独立滚动；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
+  会话工作台采用浅蓝项目栏、彩色通用手柄图标与卡片选中态；中间对话/作品使用圆角标签，右侧智能体咨询使用奶油色标题区。沿用真实项目和会话入口、侧栏伸缩与账户菜单，样式只作用于 Code 会话工作台。可编辑的空对话在输入区上方的可用区域中央显示童趣欢迎语；「去作品广场逛逛」入口紧贴输入框上方，两者一起位于底部。老师介绍以固定宽度浮在右上角，不占用中间布局；欢迎语和底部输入区始终相对项目栏右侧的整个内容区域居中；小窗口的欢迎内容独立滚动；发送首条消息后收起欢迎区。侧栏保留「作品广场」入口，只有点击后才在系统浏览器打开公共广场，不请求、摘取或内嵌展示广场作品。打开广场保留当前项目、对话、草稿和附件，不自动发送消息；老师求助按钮保留临时应用的最新文案「帮我整体看🧠」。
 - `Makelore Agents｜AI 智能体`：配置个人云智能体并试聊，发布后正式对话、接入个人微信或创建应用 API Key。支持流式回复、审批、排队请求、附件与产物、自动任务和活动历史；重新进入时恢复最近智能体与对话，未确认操作可按原输入重试。聊天可提出日程建议，由创建者核对能力、时间和费用后启用。知识库上传、替换及导入本人会话附件后自动解析并建立索引；文档卡片区分排队、解析、索引、可用和失败，持续刷新已加载文档，失败可原地重试；零文本内容不会显示为可用，新文档可用后才移除被替换的旧文档。支持删除知识内容；个人 MCP 凭据、Skills、子智能体可自助管理。支持智能体和会话归档、发布版本比较及恢复为草稿。除知识库 embedding 向量化外，模型调用（包括知识处理触发的对话模型调用）仍按原规则由创建者个人词元点数支付，可按智能体设置每次任务和每日上限，费用按时间、来源、应用分页统计；embedding 向量化由平台承担，不计入用户用量、词元点数或智能体费用上限；应用调用者保有自己的内容空间。Main 管理云会话和本机文件，Renderer 通过 Host API 操作。配套服务接入见 [Yuxi MakeLore 说明](https://xerrors.github.io/Yuxi/advanced/makelore-agents.html)。 编辑采用全高桌面分栏，支持拖动调整与展开、独立滚动、小窗口配置/试用切换。首次创建按选用途、说要求、试一试引导，提供科学问答、故事、英语和笔记整理起点；回答方式可多选，特别要求直接编辑，仍以草稿的 system_prompt 保存。新助手预选云端目录的第一个可用模型并明确显示，可自行更换；已有助手不自动换模型。编辑区以“我的要求”和“高级设置”两个 Tab 切换，默认显示基础要求；高级设置包含能力、知识与限制，返回时保留上次分类，切换保留未保存的输入及当前试用。已开始使用的助手在顶部显示“修改已保存，尚未应用”或“已应用最新修改”，并提供显眼的“应用最新修改”按钮；保存只更新草稿，应用沿用同一发布操作，失败重试保留原操作身份。草稿明确保存（Ctrl/⌘+S），保存与切换页面保留当前试用及未发送文字；“保存并重新试用”使用最新保存的要求，保留上次试用供对比，并可复用上次问题，不自动发送。示例问题仅填入输入框；有运行、排队、审批或未确认操作时先处理当前试用。工具确认先展示实际操作说明与参数，完整技术详情可展开。确认“开始使用”会创建仅自己可用的发布版本并进入独立对话，微信渠道与应用接入仍单独配置。费用上限在限制中独立保存。Enter 发送、Shift+Enter 换行，F6 切换面板焦点、Esc 恢复分栏。
 
   云知识库的 embedding 模型只由平台管理员在 Yuxi 后台维护：在「智能体管理 → 模型供应商」启用供应商，按供应商要求填写有效的服务地址和 API Key，添加并启用 embedding 模型并填写实际向量维度；embedding 向量化费用由平台承担，不计入用户用量、词元点数或智能体费用上限；one-api 不参与 embedding 配置，Works Square 只负责其他应计费模型调用的创建者词元点数账本。客户端区分目录加载中、加载失败与无可用模型，空状态提供管理员配置说明；「刷新知识库与模型」保留未提交名称，未确认的创建请求沿用原操作身份。
diff --git a/src/components/community/community.css b/src/components/community/community.css
index c36a19f2..531c1018 100644
--- a/src/components/community/community.css
+++ b/src/components/community/community.css
@@ -1,12 +1,12 @@
 .coding-chat-body { display: flex; flex: 1; flex-direction: column; min-height: 0; min-width: 0; overflow: hidden; }
 .coding-chat-body[hidden] { display: none; }
-.coding-chat-body[data-welcome="true"] { padding: 0 24px 16px; background: radial-gradient(ellipse at 45% 18%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
-.coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 1 1 0; overflow-y: auto; padding: clamp(24px, 4vh, 48px) 0 24px; }
+.coding-chat-body[data-welcome="true"] { padding: 0 24px 16px; background: radial-gradient(ellipse at 50% 40%, #fff8e8 0%, #fffdf8 28%, #fff 67%); }
+.coding-chat-body[data-welcome="true"] .classroom-chat-view { flex: 1 1 0; overflow-y: auto; padding: 24px 0; }
 .coding-chat-body[data-welcome="true"] .classroom-composer-view { width: 100%; max-width: 740px; margin: 0 auto; padding-top: 16px; }
 .coding-chat-body[data-welcome="true"] .classroom-composer-view > .community-invitation { margin: 0 auto 12px; }
 .coding-chat-body[data-welcome="true"] [data-testid="coding-message-composer"] { width: 100%; padding: 0; }
 .coding-chat-body[data-welcome="true"] .chat-composer-surface { background: #fff; border-color: #d7dfda; border-radius: 20px; box-shadow: 0 5px 0 #eaf0e8, 0 12px 32px #69774b08; }
-.coding-start-heading { position: relative; flex-shrink: 0; width: 100%; max-width: 740px; margin: var(--teacher-top-inset, 0px) auto 0; padding: 0 12px 24px; text-align: center; }
+.coding-start-heading { position: relative; flex-shrink: 0; width: 100%; max-width: 740px; margin: var(--teacher-top-inset, auto) auto auto; padding: 0 12px; text-align: center; }
 .coding-start-mark { display: inline-grid; position: relative; place-items: center; width: 57px; height: 59px; border-radius: 18px; border: 1px solid #f2d6a7; background: #fff0d7; box-shadow: 0 4px 0 #eeddbd; transform: rotate(-7deg); animation: community-hello 650ms ease-out both; }
 .coding-start-mark img { width: 35px; height: 35px; }
 .coding-start-mark > svg { position: absolute; width: 17px; height: 17px; right: -24px; top: -2px; color: #c78b36; }
diff --git a/src/pages/Chat/CodingChatBody.tsx b/src/pages/Chat/CodingChatBody.tsx
index 0b8cb5c8..2e94dfdf 100644
--- a/src/pages/Chat/CodingChatBody.tsx
+++ b/src/pages/Chat/CodingChatBody.tsx
@@ -8,19 +8,18 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
   useLayoutEffect(() => {
     const body = ref.current;
     const content = body?.querySelector<HTMLElement>('.classroom-chat-view');
-    if (!body || !content || hidden || !bubble) return;
+    if (!body || !content || !welcome || hidden || !bubble) return;
     const update = () => {
       const area = body.getBoundingClientRect();
       const message = bubble.getBoundingClientRect();
       const overlaps = message.height > 0 && message.right > area.left && message.left < area.right && message.bottom > area.top;
-      const rightInset = Math.ceil(area.right - message.left + 24);
-      const besideTeacher = overlaps && area.width >= 900 && area.width - rightInset - 24 >= 420;
-      // Reserve the same right rail for the welcome and bottom input. The teacher keeps its own fixed width.
-      body.style.paddingLeft = besideTeacher ? '24px' : '';
-      body.style.paddingRight = besideTeacher ? `${rightInset}px` : '';
-      // Put compact-screen clearance inside the scrolling heading, never around the fixed bottom input.
-      content.style.setProperty('--teacher-top-inset', welcome && overlaps && !besideTeacher
-        ? `${Math.max(0, Math.ceil(message.bottom - content.getBoundingClientRect().top))}px` : '0px');
+      // The teacher floats over the page; it never narrows or shifts the main column.
+      // Only compact screens need scrollable space to reveal the welcome below the overlay.
+      if (overlaps && area.width < 900) {
+        content.style.setProperty('--teacher-top-inset', `${Math.max(0, Math.ceil(message.bottom - content.getBoundingClientRect().top + 24))}px`);
+      } else {
+        content.style.removeProperty('--teacher-top-inset');
+      }
     };
     update();
     const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(update);
@@ -28,7 +27,6 @@ export function CodingChatBody({ welcome, hidden, bubble, children }: {
     window.addEventListener('resize', update);
     return () => {
       observer?.disconnect(); window.removeEventListener('resize', update);
-      body.style.paddingLeft = ''; body.style.paddingRight = '';
       content.style.removeProperty('--teacher-top-inset');
     };
   }, [welcome, hidden, bubble]);
diff --git a/tests/e2e/community-welcome.spec.ts b/tests/e2e/community-welcome.spec.ts
index 219c9904..1623678e 100644
--- a/tests/e2e/community-welcome.spec.ts
+++ b/tests/e2e/community-welcome.spec.ts
@@ -48,17 +48,19 @@ test.beforeEach(async ({ page }) => {
 });
 
 for (const width of [375, 768, 1280, 1470]) {
-  test(`welcome, composer and community link clear teacher introductions at ${width}px`, async ({ page }) => {
+  test(`welcome and bottom controls remain usable with floating teachers at ${width}px`, async ({ page }) => {
     await page.setViewportSize({ width, height: 850 });
     await page.emulateMedia({ reducedMotion: 'reduce' });
     await page.goto(baseUrl + '?teachers');
     const heading = page.getByTestId('coding-start-heading');
     const teachers = page.getByTestId('teacher-welcomes');
     await expect(teachers.locator('.teacher-welcome-card')).toHaveCount(2);
-    await expect.poll(async () => {
-      const a = await heading.boundingBox(), b = await teachers.boundingBox();
-      return !!a && !!b && (a.x + a.width <= b.x || a.y >= b.y + b.height);
-    }).toBe(true);
+    if (width < 900) {
+      await expect.poll(async () => {
+        const a = await heading.boundingBox(), b = await teachers.boundingBox();
+        return !!a && !!b && a.y >= b.y + b.height;
+      }).toBe(true);
+    }
     await expect(page.locator('.coding-start-mark')).toHaveCSS('animation-name', 'none');
     await page.getByTestId('community-invitation').scrollIntoViewIfNeeded();
     expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(width);
@@ -88,7 +90,7 @@ test('a short window scrolls the welcome while keeping the composer at the botto
 });
 
 for (const width of [1280, 1470]) {
-  test(`the bottom input is centered between the project sidebar and fixed teacher panel at ${width}px`, async ({ page }) => {
+  test(`floating teachers leave the welcome and bottom input centered in the page at ${width}px`, async ({ page }) => {
     await page.setViewportSize({ width, height: 850 });
     await page.emulateMedia({ reducedMotion: 'reduce' });
     await page.goto(baseUrl + '?teachers&sidebar');
@@ -96,27 +98,37 @@ for (const width of [1280, 1470]) {
     const composer = page.getByTestId('coding-message-composer');
     await expect(teachers).toHaveCSS('width', '340px');
     await expect.poll(async () => {
-      const [side, teacher, input] = await Promise.all([
-        page.getByTestId('project-sidebar').boundingBox(), teachers.boundingBox(), composer.boundingBox(),
+      const [side, input] = await Promise.all([
+        page.getByTestId('project-sidebar').boundingBox(), composer.boundingBox(),
       ]);
-      return Math.abs((input!.x + input!.width / 2) - (side!.x + side!.width + teacher!.x) / 2);
+      return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + width) / 2);
     }).toBeLessThan(2);
     const input = (await composer.boundingBox())!;
     const invitation = (await page.getByTestId('community-invitation').boundingBox())!;
     expect(invitation.x).toBeCloseTo(input.x, 0);
     expect(invitation.width).toBeCloseTo(input.width, 0);
     expect(input.y - invitation.y - invitation.height).toBeCloseTo(12, 0);
-    await page.screenshot({ path: test.info().outputPath(`composer-between-panels-${width}.png`) });
+    const heading = page.getByTestId('coding-start-heading');
+    await expect.poll(async () => {
+      const [title, content] = await Promise.all([heading.boundingBox(), page.locator('.classroom-chat-view').boundingBox()]);
+      return Math.abs(title!.y + title!.height / 2 - content!.y - content!.height / 2);
+    }).toBeLessThan(2);
+    expect((await heading.boundingBox())!.x + (await heading.boundingBox())!.width / 2).toBeCloseTo(input.x + input.width / 2, 0);
+    await page.screenshot({ path: test.info().outputPath(`floating-teachers-centered-welcome-${width}.png`) });
     await composer.getByRole('textbox').fill('保留这份草稿');
     await page.getByTestId('project-sidebar').evaluate(el => { el.style.width = '60px'; });
     await expect.poll(async () => {
-      const [side, teacher, input] = await Promise.all([
-        page.getByTestId('project-sidebar').boundingBox(), teachers.boundingBox(), composer.boundingBox(),
+      const [side, input] = await Promise.all([
+        page.getByTestId('project-sidebar').boundingBox(), composer.boundingBox(),
       ]);
-      return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + teacher!.x) / 2);
+      return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + width) / 2);
     }).toBeLessThan(2);
+    const inputBeforeDismiss = await composer.boundingBox();
+    const headingBeforeDismiss = await heading.boundingBox();
     await teachers.getByRole('button', { name: '先自己试试' }).click();
     await expect(composer.getByRole('textbox')).toHaveValue('保留这份草稿');
+    expect(await composer.boundingBox()).toEqual(inputBeforeDismiss);
+    expect(await heading.boundingBox()).toEqual(headingBeforeDismiss);
     await expect.poll(async () => {
       const [side, input] = await Promise.all([page.getByTestId('project-sidebar').boundingBox(), composer.boundingBox()]);
       return Math.abs(input!.x + input!.width / 2 - (side!.x + side!.width + width) / 2);
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 538aae43..58ebd3ff 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1113,6 +1113,11 @@ test('first PI Conversation is editable under 500 ms and submits before runtime
     await expect(page.getByTestId('coding-message-composer')).toBeInViewport({ ratio: 1 });
     expect(await page.getByTestId('coding-message-composer').evaluate(el => innerHeight - el.getBoundingClientRect().bottom)).toBeLessThan(40);
     await expect(page.getByTestId('community-invitation')).toBeVisible();
+    expect(await page.getByTestId('coding-message-composer').evaluate(el => {
+      const body = document.querySelector('.coding-chat-body')!.getBoundingClientRect();
+      const input = el.getBoundingClientRect();
+      return Math.abs(input.left + input.width / 2 - body.left - body.width / 2);
+    })).toBeLessThan(2);
     expect(await page.getByTestId('community-invitation').evaluate(el => {
       const composer = document.querySelector('[data-testid="coding-message-composer"]')!;
       return composer.getBoundingClientRect().top - el.getBoundingClientRect().bottom;

From 2922f35e4be4bc3f9d27b596ec4dec3c224416c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 17:00:06 +0800
Subject: [PATCH 10/19] fix: toggle the teacher dock from the conversation
 header

---
 .../20260929-community-welcome-c724e5a1.md    | 14 ++-
 README.md                                     |  2 +-
 src/pages/Chat/CodingChatPanel.tsx            |  5 +-
 src/pages/Chat/CodingConversationHeader.tsx   | 27 +++---
 tests/e2e/pi-coding-first-chat.spec.ts        | 24 +++--
 tests/unit/coding-chat-panel.test.tsx         | 88 +++++++++++++++++++
 6 files changed, 132 insertions(+), 28 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index d8b4cf2f..c1ac784a 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -23,7 +23,7 @@
 - Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
 - No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
 - Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
-- Temporary Renderer now loads this checkout's index-CwqpErpO.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+- Temporary Renderer now loads this checkout's index-Cgp0q7I7.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
 
 ## Verification
 
@@ -87,3 +87,15 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 - Completed: teacher introductions remain fixed-width overlays at the upper right, with no reserved horizontal rail. The welcome is centered horizontally in the whole content page and vertically in the available area above the bottom invitation/composer. Invitation and input sizing and spacing remain unchanged. Desktop teacher dismissal no longer shifts either element; compact content can scroll below the overlay.
 - Validation: typecheck, 77 focused unit tests, 8 headless layout/interaction cases, lint:check (0 errors, 8 existing warnings), scoped E2E ESLint, build:vite, native E2E --list (20 cases), ownership and diff checks passed. Screenshots reviewed with both teachers floating; tests assert horizontal/vertical centering, stable bounds on dismissal, collapsed sidebar alignment, bottom input and preserved drafts. Native headed tests were not run to avoid focus changes.
 - Trial updated to index-CwqpErpO.js in the background. Actual live horizontal and vertical center errors are 0px, invitation gap 12px and input bottom gap 16px. No alerts/cards/iframe; auth identity, route and all 13 saved drafts unchanged. Existing teacher dismissal state was preserved. Background native capture was unavailable (UnknownVizError), so visual review used the headless layout screenshots; live DOM geometry was independently verified. Evidence: trial floating-teachers-centered-welcome-20260929/. Keep this checkout for the live trial; no merge or push.
+
+## Follow-up: Integrate Teacher Dock Toggle Handoff
+
+- User-authorized handoff from 前端-页面修改2 supplies /tmp/makelore-help-label-83a2f67c/teacher-dock-toggle.patch. Continue the owned trial/frontend feature at 5de8ea8; ownership start/status passed, and existing Project Context Loaded still applies. Read the delivering task and new empty-work-preview task records.
+- Cross-check: launch metadata still points to this checkout/5de8ea8. 前端-页面修改3 finalized 0167d36 but explicitly has not updated the running app, so there is no new runtime overlay to preserve. Keep that separately completed Main/preview feature out of this bounded button update. No semantic conflict; Planning Gate: Passed.
+- Apply the narrow two-file button patch and regression, adapt affected native scenarios, validate against the latest layout/help text, and refresh only the trial Renderer. Right header toggle controls consultationOpen with matching accessible labels/state; opening/closing preserves selected teacher, work/chat tab, history and drafts and sends no prompt. No prompt-configuration work, formal installation, cloud change or remote push.
+
+- Integrated the supplied two production-file changes and nonempty-history/draft/no-submit regression without overwriting the latest welcome layout or help label. Updated two affected native scenarios to use the teacher toggle and existing Work/Chat tabs, preserving browser coverage. README records the new header control.
+- Checks: typecheck, 91 relevant unit tests in four files, all 8 headless welcome-layout/interaction cases, lint:check (0 errors, 8 existing warnings), scoped changed-test ESLint, build:vite, native E2E --list (20 cases), documentation ownership and whitespace checks passed. Full headed Electron fixture not run to avoid desktop focus changes.
+- Live Renderer index-Cgp0q7I7.js on unchanged Main PID 62668: background click sequence verified expanded/collapsed labels and aria state, dock removal/reopening, preserved current tab/teacher and both current draft values, unchanged operation history, all 13 stored drafts and 帮我整体看🧠. Current live teacher has no messages; nonempty teacher-history preservation is covered by the integration unit regression. Restored the initial closed dock. Opening the dock only reads existing data; no test prompt was submitted.
+- Native background timers initially delayed the click-verification script. Temporarily disabled webContents background throttling to finish the pending verification, then restored the original throttling setting. No window activation; focus monitor and live checks remained unfocused. Temporary inspector is closed after finalization. Evidence: trial teacher-dock-toggle-integrated-20260929/.
+- Welcome centering remains 0px error on both axes, invitation gap 12px and composer bottom gap 16px; auth identity and route preserved, no page alerts. Empty-work commit 0167d36 remains separate and was not live before this update. Keep this trial worktree; no main merge/push or cloud/prompt edits.
diff --git a/README.md b/README.md
index ef766d75..ebb913b1 100644
--- a/README.md
+++ b/README.md
@@ -169,7 +169,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 本地读取使用连续分页：目录按层展开，默认四层、最多六层，跳过 `.gradle` 等生成目录；条目随页面按需产出，深层目录可单独查询；文件和会话默认每页 120 行、最多 400 行，返回连续原文、起始行列与精确 next 游标，列按 Unicode 字符计数、换行统一为 LF。单个云端结果最多 8 KiB，长行也能继续读取；不受文件 UI 的 256 KiB 预览限制。会话索引保留消息 ID 和摘要，按 ID 读取完整公开原文。每题最多十二批、累计成功结果 64 KiB（包含结果元数据），不足 512 字节时收尾；不上传 Pi 原始日志或思考。云端保留智能体对话及收到的片段，完整工程仍在本机。本地旧版模型仍按自身上下文和六批额度缩小结果。
 
 - Code 课堂左侧项目栏默认宽 171px，可拖动右边缘在 128–256px 间调整，双击恢复默认并在本机记住宽度；标题栏同步对齐。项目名与会话名超长省略并可悬停查看；右侧咨询栏默认宽 508px，可拖动至 640px，紧凑窗口仍使用覆盖式咨询。
-- 客户端没有内置老师／朋友角色。已下发智能体以头像和名称并排显示在标题栏，点击后打开对应智能体的讨论；数量较多时横向滚动，咨询面板不再提供智能体下拉框。名称、头像、简介、欢迎语和推荐问题均由服务端提供。首次使用默认选择运营指定项，各智能体的未发送草稿分别保存，同一账号与同一智能体只有一个持续聊天，跨项目保留消息和文字草稿；不再显示新话题按钮或话题选择。每轮接受时固定项目、操作对话与当前发布版本；旧的未分配项目草稿可展开查看，不自动转给其他智能体。打开或切换只读取配置和历史，不触发模型；咨询栏支持调整宽度和重新打开。
+- 客户端没有内置老师／朋友角色。已下发智能体以头像和名称并排显示在标题栏，点击后打开对应智能体的讨论；数量较多时横向滚动，咨询面板不再提供智能体下拉框。名称、头像、简介、欢迎语和推荐问题均由服务端提供。首次使用默认选择运营指定项，各智能体的未发送草稿分别保存，同一账号与同一智能体只有一个持续聊天，跨项目保留消息和文字草稿；不再显示新话题按钮或话题选择。每轮接受时固定项目、操作对话与当前发布版本；旧的未分配项目草稿可展开查看，不自动转给其他智能体。打开或切换只读取配置和历史，不触发模型；咨询栏支持调整宽度和重新打开。顶栏最右侧面板按钮用于收起／展开老师对话栏，不切换“操作对话／作品”、不改变所选老师，保留历史及两侧输入草稿，也不发送消息。
 - 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 16px、行高 1.8，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
diff --git a/src/pages/Chat/CodingChatPanel.tsx b/src/pages/Chat/CodingChatPanel.tsx
index e0622ca6..2c0c8d13 100644
--- a/src/pages/Chat/CodingChatPanel.tsx
+++ b/src/pages/Chat/CodingChatPanel.tsx
@@ -775,9 +775,8 @@ export function CodingChatPanel({
           onRecover={async () => {
             if (targetConversationId) await handleRecovery(codingRecovery(runtimeError?.code).action, false);
           }}
-          browserOpen={agentBrowserOpen}
-          browserAvailable={Boolean(activeProject)}
-          onToggleBrowser={() => setAgentBrowserOpen((current) => !current)}
+          consultationAvailable={Boolean(activeProject)}
+          onToggleConsultation={() => setConsultationOpen((current) => !current)}
           projectName={activeProject?.name}
           consultationOpen={consultationOpen}
           teacherEntry={activeProject ? <TeacherCompanion companion={teacherCompanion} open={consultationOpen} onOpen={openTeacher} onToggle={toggleTeacher} bubbleRef={setTeacherBubble} introductionRef={setTeacherIntroduction} /> : undefined}
diff --git a/src/pages/Chat/CodingConversationHeader.tsx b/src/pages/Chat/CodingConversationHeader.tsx
index cbb129e2..3e077f17 100644
--- a/src/pages/Chat/CodingConversationHeader.tsx
+++ b/src/pages/Chat/CodingConversationHeader.tsx
@@ -50,12 +50,11 @@ export function CodingConversationHeader({
   onRename,
   onAbort,
   onRecover,
-  browserOpen = false,
-  browserAvailable = false,
-  onToggleBrowser,
+  consultationAvailable = false,
+  onToggleConsultation,
   onAskTeacher,
   teacherEntry,
-  consultationOpen,
+  consultationOpen = false,
   projectName,
 }: {
   conversation: CodingConversationMetadata | null;
@@ -63,9 +62,8 @@ export function CodingConversationHeader({
   onRename(title: string): Promise<void>;
   onAbort(): Promise<void>;
   onRecover(): Promise<void>;
-  browserOpen?: boolean;
-  browserAvailable?: boolean;
-  onToggleBrowser?(): void;
+  consultationAvailable?: boolean;
+  onToggleConsultation?(): void;
   onAskTeacher?(): void;
   teacherEntry?: ReactNode;
   consultationOpen?: boolean;
@@ -134,18 +132,19 @@ export function CodingConversationHeader({
       {teacherEntry}
       {!teacherEntry && onAskTeacher && <button type="button" aria-label="智能体" aria-expanded={consultationOpen} aria-controls="coding-consultation-dock"
         className="no-drag shrink-0 rounded-lg px-2 py-1 text-xs" onClick={onAskTeacher}>智能体</button>}
-      {onToggleBrowser ? (
+      {onToggleConsultation ? (
         <Button
           type="button"
           variant="ghost"
           className={iconButtonClass}
-          disabled={!browserAvailable}
-          aria-label={browserOpen ? '关闭开发浏览器' : '打开开发浏览器'}
-          aria-pressed={browserOpen}
-          title={browserOpen ? '关闭开发浏览器' : '打开开发浏览器'}
-          onClick={onToggleBrowser}
+          disabled={!consultationAvailable}
+          aria-label={consultationOpen ? '收起老师对话栏' : '展开老师对话栏'}
+          aria-expanded={consultationOpen}
+          aria-controls="coding-consultation-dock"
+          title={consultationOpen ? '收起老师对话栏' : '展开老师对话栏'}
+          onClick={onToggleConsultation}
         >
-          {browserOpen
+          {consultationOpen
             ? <PanelRightClose className="h-4 w-4" aria-hidden="true" />
             : <PanelRightOpen className="h-4 w-4" aria-hidden="true" />}
         </Button>
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 58ebd3ff..4259caa4 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -1470,11 +1470,12 @@ test('Windows Code titlebar keeps browser actions clear of the logo and window c
       if (width === 1280 && zoom === 1) {
         await page.screenshot({ path: test.info().outputPath('windows-code-titlebar.png') });
       }
-      await header.getByRole('button', { name: '打开开发浏览器' }).click();
-      await expect(page.getByTestId('agent-browser-panel')).toBeVisible();
+      await header.getByRole('button', { name: '展开老师对话栏' }).click();
+      await expect(page.locator('#coding-consultation-dock')).toBeVisible();
+      await expect(page.getByRole('tab', { name: '操作对话' })).toHaveAttribute('aria-selected', 'true');
       await assertChromeClear();
-      await header.getByRole('button', { name: '关闭开发浏览器' }).click();
-      await expect(page.getByTestId('agent-browser-panel')).toHaveCount(0);
+      await header.getByRole('button', { name: '收起老师对话栏' }).click();
+      await expect(page.locator('#coding-consultation-dock')).toHaveCount(0);
     }
     await page.getByTestId('titlebar-sidebar-toggle').click();
     await assertChromeClear();
@@ -1537,14 +1538,19 @@ test('PI feature UI isolates Conversations and exposes queue, interaction, model
     await expect(conversationHeader.getByRole('button', { name: '归档' })).toHaveCount(0);
     await expect(conversationHeader.getByRole('button', { name: '智能体设置' })).toHaveCount(0);
     await expect(conversationHeader.getByRole('button', { name: '打开编程工具' })).toHaveCount(0);
-    const browserToggle = conversationHeader.getByRole('button', { name: '打开开发浏览器' });
-    await expect(browserToggle).toBeVisible();
+    const teacherToggle = conversationHeader.getByRole('button', { name: '展开老师对话栏' });
+    await expect(teacherToggle).toBeVisible();
     if (process.platform === 'win32') {
-      const browserBounds = await browserToggle.boundingBox();
+      const browserBounds = await teacherToggle.boundingBox();
       expect(browserBounds).not.toBeNull();
       expect(browserBounds!.x + browserBounds!.width).toBeLessThanOrEqual(logoBounds!.x);
     }
-    await browserToggle.click();
+    await teacherToggle.click();
+    await expect(page.locator('#coding-consultation-dock')).toBeVisible();
+    await expect(page.getByRole('tab', { name: '操作对话' })).toHaveAttribute('aria-selected', 'true');
+    await conversationHeader.getByRole('button', { name: '收起老师对话栏' }).click();
+    await expect(page.locator('#coding-consultation-dock')).toHaveCount(0);
+    await page.getByRole('tab', { name: '作品', exact: true }).click();
     await expect(page.getByTestId('agent-browser-panel')).toBeVisible();
     await expect(page.getByTestId('agent-browser-diagnostics')).toHaveCount(0);
     await expect.poll(async () => {
@@ -1554,7 +1560,7 @@ test('PI feature UI isolates Conversations and exposes queue, interaction, model
     expect((await readState(electronApp)).captured.some(
       (request) => request.path === '/api/agent-browser/diagnostics',
     )).toBe(false);
-    await page.getByRole('button', { name: '关闭开发浏览器' }).last().click();
+    await page.getByRole('tab', { name: '操作对话' }).click();
     await expect(page.getByTestId('agent-browser-panel')).toHaveCount(0);
     await expect(page.getByRole('button', { name: '项目设置' })).toHaveCount(1);
     await expect(page.getByTestId('project-conversations')).toBeVisible();
diff --git a/tests/unit/coding-chat-panel.test.tsx b/tests/unit/coding-chat-panel.test.tsx
index b88f3e27..f942ba79 100644
--- a/tests/unit/coding-chat-panel.test.tsx
+++ b/tests/unit/coding-chat-panel.test.tsx
@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { AppError } from '@/lib/error-model';
 import type { ConversationSnapshot } from '@/types/coding-conversation';
+import type { TeacherDefinition, TeacherTopic } from '../../shared/coding-teacher';
 import type {
   CodingConversationMetadata,
   CodingProjectAgent,
@@ -320,6 +321,93 @@ describe('CodingChatPanel first Conversation', () => {
     expect(conversationApi.submit).not.toHaveBeenCalled();
   });
 
+  it('toggles the teacher dock from the header without changing tabs, drafts, history, or sending prompts', async () => {
+    localStorage.clear();
+    projectApi.list.mockResolvedValue({ projects: [project], activeProjectId: project.id });
+    projectApi.config.mockResolvedValue({ project, config });
+    projectApi.conversations.mockResolvedValue([conversation]);
+    conversationApi.events.mockResolvedValue(new FakeEventSource() as unknown as EventSource);
+    const { createLocalConversationSnapshot } = await import('@/pages/Chat/coding-chat-snapshot');
+    conversationApi.snapshot.mockResolvedValue(createLocalConversationSnapshot(project.id, conversation));
+    const definition: TeacherDefinition = {
+      schema_version: 1, config_id: 'teacher-collapse', teacher_id: 'teacher', name: '设计老师',
+      description: '', avatar_id: 'avatar-01', welcome_message: '聊聊吧', suggested_questions: [],
+      system_prompt: '', skills: [], model: { model_id: 'model', reasoning_choice: { mode: 'default' } },
+      limits: { max_input_tokens: 8000, max_output_tokens: 1000 },
+    };
+    const topic: TeacherTopic = {
+      schemaVersion: 1, revision: 1, id: 'teacher-history', accountId: 'signed-out',
+      projectId: project.id, sourceConversationId: conversation.id, definition, version: 1,
+      createdAt: '2026-09-29T00:00:00.000Z', updatedAt: '2026-09-29T00:00:00.000Z',
+      requests: [{
+        id: 'teacher-reply-1', text: '怎样让规则更清楚？', references: [],
+        createdAt: '2026-09-29T00:00:00.000Z', sourceCursor: { seq: 0, workerGeneration: 0 },
+        sourceCapturedAt: '2026-09-29T00:00:00.000Z', includedSourceMessageIds: [], omittedMessages: 0,
+        status: 'completed', response: '先用一句话说明获胜条件。',
+        projectId: project.id, sourceConversationId: conversation.id, teacherVersion: 1,
+      }],
+      conversation: { agentId: 'teacher-collapse', segmentTurns: 1, discussions: {}, seenThrough: 'teacher-reply-1' },
+    };
+    const { teacherApi } = await import('@/lib/coding-teacher');
+    vi.spyOn(teacherApi, 'config').mockResolvedValue({ enabled: true, published_version: 1, revision: 1, definition });
+    vi.spyOn(teacherApi, 'catalog').mockResolvedValue({ items: [{ teacher_id: 'teacher-collapse', version: 1, definition, is_default: true }] });
+    vi.spyOn(teacherApi, 'conversation').mockResolvedValue({ topic, before: null });
+    vi.spyOn(teacherApi, 'events').mockResolvedValue(new FakeEventSource() as unknown as EventSource);
+    const consultationSend = vi.spyOn(teacherApi, 'sendConversation');
+    const legacySend = vi.spyOn(teacherApi, 'send');
+    const consultationCreate = vi.spyOn(teacherApi, 'create');
+    const browserApi = await import('@/lib/agent-browser');
+    const closedBrowser = {
+      browserId: null, projectId: project.id, projectPath: null, state: 'closed' as const,
+      generation: 0, url: '', title: '', visible: false, bounds: null,
+      canGoBack: false, canGoForward: false, eventCursor: 0,
+    };
+    vi.spyOn(browserApi, 'getAgentBrowserState').mockResolvedValue(closedBrowser);
+    vi.spyOn(browserApi, 'closeAgentBrowser').mockResolvedValue(closedBrowser);
+    const { CodingChatPanel } = await import('@/pages/Chat/CodingChatPanel');
+    render(<CodingChatPanel />);
+    const composer = within(await screen.findByTestId('coding-message-composer')).getByRole('textbox');
+    fireEvent.change(composer, { target: { value: '操作对话还没写完' } });
+    await waitFor(() => expect(screen.getByRole('button', { name: '智能体', exact: true })).toHaveTextContent('设计老师'));
+    const chatTab = screen.getByRole('tab', { name: '操作对话' });
+    const workTab = screen.getByRole('tab', { name: '作品', exact: true });
+    const toggle = screen.getByRole('button', { name: '展开老师对话栏' });
+    expect(toggle).toHaveAttribute('aria-expanded', 'false');
+    expect(toggle).toHaveAttribute('aria-controls', 'coding-consultation-dock');
+
+    fireEvent.click(toggle);
+    expect(screen.getByRole('button', { name: '收起老师对话栏' })).toHaveAttribute('aria-expanded', 'true');
+    expect(document.getElementById('coding-consultation-dock')).toBeVisible();
+    expect(chatTab).toHaveAttribute('aria-selected', 'true');
+    expect(composer).toBeVisible();
+    expect(await screen.findByText('先用一句话说明获胜条件。')).toBeVisible();
+    const teacherInput = screen.getByRole('textbox', { name: '向智能体提问' });
+    await waitFor(() => expect(teacherInput).toBeEnabled());
+    fireEvent.change(teacherInput, { target: { value: '老师对话也还没写完' } });
+
+    fireEvent.click(screen.getByRole('button', { name: '收起老师对话栏' }));
+    expect(document.getElementById('coding-consultation-dock')).toBeNull();
+    expect(screen.getByRole('button', { name: '展开老师对话栏' })).toHaveAttribute('aria-expanded', 'false');
+    expect(chatTab).toHaveAttribute('aria-selected', 'true');
+    expect(composer).toHaveValue('操作对话还没写完');
+
+    fireEvent.click(workTab);
+    fireEvent.click(screen.getByRole('button', { name: '展开老师对话栏' }));
+    expect(workTab).toHaveAttribute('aria-selected', 'true');
+    expect(screen.getByRole('tabpanel', { name: '作品', exact: true })).toBeVisible();
+    expect(screen.getByRole('textbox', { name: '向智能体提问' })).toHaveValue('老师对话也还没写完');
+    expect(await screen.findByText('先用一句话说明获胜条件。')).toBeVisible();
+    fireEvent.click(screen.getByRole('button', { name: '收起老师对话栏' }));
+    expect(workTab).toHaveAttribute('aria-selected', 'true');
+    expect(screen.queryByRole('textbox', { name: '向智能体提问' })).not.toBeInTheDocument();
+    fireEvent.click(chatTab);
+    expect(composer).toHaveValue('操作对话还没写完');
+    expect(consultationCreate).not.toHaveBeenCalled();
+    expect(consultationSend).not.toHaveBeenCalled();
+    expect(legacySend).not.toHaveBeenCalled();
+    expect(conversationApi.submit).not.toHaveBeenCalled();
+  });
+
   it('archives the last conversation without creating another, then restores the same running conversation', async () => {
     projectApi.list.mockResolvedValue({ projects: [project], activeProjectId: project.id });
     projectApi.config.mockResolvedValue({ project, config });

From 3a175101c979ee5f76bb9ff0bc7700649160c635 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 17:16:37 +0800
Subject: [PATCH 11/19] fix: show teacher introductions as standalone clickable
 bubbles

---
 .../tasks/20260929-community-welcome-c724e5a1.md | 12 +++++++++++-
 README.md                                        |  2 +-
 src/pages/Chat/TeacherCompanion.tsx              |  3 ---
 src/pages/Chat/classroom-workspace.css           | 14 ++++++--------
 src/pages/Chat/use-teacher-companion.ts          |  2 --
 tests/e2e/community-welcome.spec.ts              |  4 ++--
 tests/e2e/fixtures/community-welcome.tsx         |  1 -
 tests/e2e/fixtures/teacher-preview-layout.tsx    |  1 -
 tests/e2e/pi-coding-first-chat.spec.ts           |  3 +++
 tests/e2e/teacher-preview-layout.spec.ts         | 16 +++++++++++++---
 tests/unit/teacher-companion.test.tsx            | 11 +++++++----
 11 files changed, 43 insertions(+), 26 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index c1ac784a..62a865aa 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -23,7 +23,7 @@
 - Warm welcome heading, existing composer and a compact inspiration invitation share the empty-chat layout. Both the invitation and persistent sidebar button open only https://square.nianxx.cn/#explore in the system browser on explicit click.
 - No public project feed, preview cards, community store or iframe remains in this feature. Existing unrelated Main routes are unchanged. The composer remains mounted across the first send; teacher introductions keep their prior three-successful-operation-round behavior and receive responsive clearance.
 - Preserved the concurrent live help-label overlay (task 20260929-teacher-help-label-83a2f67c): the two buttons and suggestions text remain 帮我整体看🧠. Ported only its three source edits and synchronized existing expectations; peer checkout untouched.
-- Temporary Renderer now loads this checkout's index-Cgp0q7I7.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
+- Temporary Renderer now loads this checkout's index-BmLachPE.js. Existing Main PID 62668 remains running; formal installation, cloud configuration, user history and remote branches unchanged. Kept this worktree for the live trial.
 
 ## Verification
 
@@ -99,3 +99,13 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 - Live Renderer index-Cgp0q7I7.js on unchanged Main PID 62668: background click sequence verified expanded/collapsed labels and aria state, dock removal/reopening, preserved current tab/teacher and both current draft values, unchanged operation history, all 13 stored drafts and 帮我整体看🧠. Current live teacher has no messages; nonempty teacher-history preservation is covered by the integration unit regression. Restored the initial closed dock. Opening the dock only reads existing data; no test prompt was submitted.
 - Native background timers initially delayed the click-verification script. Temporarily disabled webContents background throttling to finish the pending verification, then restored the original throttling setting. No window activation; focus monitor and live checks remained unfocused. Temporary inspector is closed after finalization. Evidence: trial teacher-dock-toggle-integrated-20260929/.
 - Welcome centering remains 0px error on both axes, invitation gap 12px and composer bottom gap 16px; auth identity and route preserved, no page alerts. Empty-work commit 0167d36 remains separate and was not live before this update. Keep this trial worktree; no main merge/push or cloud/prompt edits.
+
+## Follow-up: Standalone Clickable Teacher Bubbles
+
+- Same owned task resumed at 2922f35; ownership start/status verified. Existing project context and peer scope assessment remain applicable; no new dependency or semantic conflict. Planning Gate: Passed.
+- Latest user asks to remove the introduction group's shared background, title and dismiss-all entry. Keep only independent avatar/speech-bubble cards, make the entire bubble open its corresponding teacher, and retain each separate close button. Preserve welcome receipts/three-operation-round lifecycle and current layout.
+- Plan: remove shared chrome and unused dismiss-all callback, put all speech-bubble visuals on the native open button with the close control as a sibling, update click/dismiss/accessibility and native-preview geometry regressions, then refresh the trial without activation.
+
+- Completed: removed shared welcome background/shadow, heading and dismiss-all entry/callback. Each native button owns its entire colored speech-bubble surface (including the tail), while the close button is a separate sibling. Avatar opening, teacher-specific dismissal, persisted introduction receipts and three-operation-round auto-dismiss are retained. Keyboard focus is visible.
+- Verification: 78 related unit tests, 21 headless welcome/teacher-preview layout cases, typecheck, lint:check (0 errors, 8 existing warnings), scoped changed-test ESLint, build:vite, native E2E --list (20 cases), ownership and whitespace checks passed. Tests cover padding clicks opening the correct teacher, close not opening consultation, Enter opening, many-teacher scroll, no shared chrome, individual dismissal persistence and the previous three-round lifecycle. Reviewed the desktop screenshot. Native headed fixture was not run to avoid focus changes.
+- Trial refreshed in the background to index-BmLachPE.js on unchanged Main PID 62668. Live DOM confirms transparent outer container, no shadow/header/dismiss-all, preserved independent close button and hit-testing of bubble padding to the open button. Preserved the already-dismissed introduction receipts (one remaining Alice introduction), login identity, route and all 13 saved drafts. Welcome centering error remains 0px and bottom gap 16px. No alert or focus activation. Background capture was unavailable; visual evidence comes from the headless screenshot plus actual live DOM verification. Original background throttling restored and inspector closed after completion. Evidence: trial standalone-teacher-bubbles-20260929/.
diff --git a/README.md b/README.md
index ebb913b1..c7660c89 100644
--- a/README.md
+++ b/README.md
@@ -173,7 +173,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 16px、行高 1.8，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
-- 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡进入项目即依次出现，不点击时保留到操作 Agent 第 3 轮完整回复结束后自动收起，也可分别关闭或用“先自己试试”整组收起；按账号、项目、智能体保存计数及已介绍状态，刷新与操作对话切换延续进度。旧历史、老师咨询、工具调用、重试中间状态、失败／中止和其他项目不计入，新增智能体单独补上并从零计数。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
+- 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，外层透明，不显示公共底板、标题或整组关闭入口；整张气泡可点击，独立关闭按钮只收起该老师介绍，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡进入项目即依次出现，不点击时保留到操作 Agent 第 3 轮完整回复结束后自动收起，也可分别关闭；按账号、项目、智能体保存计数及已介绍状态，刷新与操作对话切换延续进度。旧历史、老师咨询、工具调用、重试中间状态、失败／中止和其他项目不计入，新增智能体单独补上并从零计数。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
 - 智能体支持自由提问；输入框为空时，底部显示暖黄色小按钮“不知道问什么，你先帮我看看👀”，输入文字后收起，清空后重现，发送按钮保持原位。只有学生点击才调用模型，程序说明学生主动求助且尚未提出具体问题，智能体结合可用上下文按云端配置回应。点击快捷回复会主动开始讨论；回复下方不再附加固定的二次求助链接；失败或中断后，可点暖黄色小按钮“不知道问什么，你先帮我看看👀”重试。这些快捷求助保留已有输入草稿，网络结果不确定时复用请求身份，已确认终态的请求不重复执行；解析失败可重新求助，不用固定问题伪装模型结果。服务端下发的推荐问题只填入草稿，由用户确认发送。界面不提供独立示范页面、“记一下”、共识或自动待办，智能体的回复下不再展示“我去试一试”和“复制”按钮，学生通过已有的操作对话／作品入口继续创作。
 - 老师咨询只展示老师正文和可点击的快捷回复卡片，学生也可在“和老师聊聊”输入框自由输入。点击卡片原样发送该回复，保留当前输入草稿；旧话题的数据不会恢复想法板、结构图、流程图或对照表及其操作。
 - 客户端只提供入口事实、可用上下文和界面协议。讨论切入点、教学方式、是否提问、正文长度、前缀和表达风格由所选智能体的云端配置决定；不在“不知道问什么，你先帮我看看👀”、引导开口或后台检查时附加教学策略。当前新回复允许 0–3 条快捷回复，没有时用空数组，不要求凑满。
diff --git a/src/pages/Chat/TeacherCompanion.tsx b/src/pages/Chat/TeacherCompanion.tsx
index b9d53171..bc6b7188 100644
--- a/src/pages/Chat/TeacherCompanion.tsx
+++ b/src/pages/Chat/TeacherCompanion.tsx
@@ -62,9 +62,6 @@ export function TeacherCompanion({ companion, open, onOpen, onToggle, bubbleRef,
       </button>
       <span className="sr-only" role="status" aria-live="polite">{refreshMessage}</span>
       {!invitation && welcomes.length > 0 && <div ref={bubbleRef} className="teacher-welcome-presence" data-testid="teacher-welcomes" aria-label="认识这里的老师">
-        <div className="teacher-welcome-heading"><span>来认识一下</span>
-          <button type="button" onClick={companion.dismissWelcomes}>先自己试试</button>
-        </div>
         <div className="teacher-welcome-list">
           {welcomes.map((item, index) => <article key={item.agentId} className="teacher-welcome-card" data-agent-id={item.agentId}
             data-tone={item.tone} style={{ '--welcome-delay': `${Math.min(index, 4) * 180}ms` } as CSSProperties}>
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index 267c32d6..0968d8b1 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -113,20 +113,18 @@
 .teacher-companion-actions button:hover { text-decoration: underline; text-underline-offset: 4px; }
 .teacher-companion-speaker { flex-shrink: 0; width: 48px; height: 48px; margin-top: 5px; border-radius: 8px; }
 .teacher-companion-speaker img { width: 100%; height: 100%; object-fit: contain; image-rendering: pixelated; filter: drop-shadow(0 3px 1px #33485820); }
-.teacher-welcome-presence { position: absolute; top: calc(100% + 12px); right: 0; z-index: 90; width: 340px; max-width: calc(100vw - 40px); padding: 6px; border-radius: 18px; background: #fffdf8; box-shadow: 0 8px 24px #30465f12; }
-.teacher-welcome-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 0 8px 4px; color: #6a7463; font-size: 12px; }
-.teacher-welcome-heading button { min-height: 32px; padding: 0 4px; color: #4d663c; border-radius: 8px; cursor: pointer; }
-.teacher-welcome-heading button:hover { background: #eef1e8; }
+.teacher-welcome-presence { position: absolute; top: calc(100% + 12px); right: 0; z-index: 90; width: 340px; max-width: calc(100vw - 40px); }
 .teacher-welcome-list { display: grid; gap: 10px; max-height: min(440px, calc(100vh - 200px)); overflow-y: auto; overscroll-behavior: contain; padding: 4px 6px 8px; scrollbar-width: thin; }
 .teacher-welcome-card { --welcome-fill: #fff3ce; --welcome-edge: #efddb0; display: flex; align-items: flex-start; gap: 10px; min-width: 0; animation: teacher-welcome-arrive 220ms ease-out backwards; animation-delay: var(--welcome-delay, 0ms); }
 .teacher-welcome-card[data-tone="1"] { --welcome-fill: #edf5ff; --welcome-edge: #d7e5f5; }
 .teacher-welcome-card[data-tone="2"] { --welcome-fill: #f3edfc; --welcome-edge: #e5d9f5; }
 .teacher-welcome-avatar { flex-shrink: 0; width: 42px; height: 44px; margin-top: 8px; padding: 2px; border: 1px solid var(--welcome-edge); border-radius: 14px; background: #fff; box-shadow: 0 3px 0 var(--welcome-edge); cursor: pointer; }
 .teacher-welcome-avatar img { width: 100%; height: 100%; object-fit: cover; border-radius: 11px; }
-.teacher-welcome-bubble { position: relative; flex: 1; min-width: 0; border: 1px solid var(--welcome-edge); border-radius: 17px 17px 17px 6px; background: var(--welcome-fill); box-shadow: 0 2px 0 var(--welcome-edge); }
-.teacher-welcome-bubble::before { content: ''; position: absolute; top: 23px; left: -5px; width: 8px; height: 8px; transform: rotate(45deg); border-left: 1px solid var(--welcome-edge); border-bottom: 1px solid var(--welcome-edge); background: var(--welcome-fill); }
-.teacher-welcome-open { display: flex; flex-direction: column; gap: 6px; width: 100%; min-width: 0; padding: 12px; border-radius: inherit; color: #34465c; text-align: left; cursor: pointer; }
-.teacher-welcome-open:hover { background: #ffffff40; }
+.teacher-welcome-bubble { position: relative; flex: 1; min-width: 0; }
+.teacher-welcome-open::before { content: ''; position: absolute; top: 23px; left: -5px; width: 8px; height: 8px; transform: rotate(45deg); border-left: 1px solid var(--welcome-edge); border-bottom: 1px solid var(--welcome-edge); background: var(--welcome-fill); }
+.teacher-welcome-open { position: relative; display: flex; flex-direction: column; gap: 6px; width: 100%; min-width: 0; padding: 12px; border: 1px solid var(--welcome-edge); border-radius: 17px 17px 17px 6px; background: var(--welcome-fill); box-shadow: 0 2px 0 var(--welcome-edge); color: #34465c; text-align: left; cursor: pointer; }
+.teacher-welcome-open:hover { filter: brightness(1.015); }
+.teacher-welcome-open:focus-visible, .teacher-welcome-dismiss:focus-visible, .teacher-welcome-avatar:focus-visible { outline: 2px solid #547ab0; outline-offset: 3px; }
 .teacher-welcome-name { padding-right: 20px; font-size: 13px; font-weight: 600; line-height: 19px; overflow-wrap: anywhere; }
 .teacher-welcome-text { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; overflow-wrap: anywhere; white-space: pre-wrap; font-size: 13px; line-height: 1.6; }
 .teacher-welcome-action { display: inline-flex; align-items: center; gap: 3px; color: #596b55; font-size: 11px; line-height: 18px; }
diff --git a/src/pages/Chat/use-teacher-companion.ts b/src/pages/Chat/use-teacher-companion.ts
index 1e83407a..d49d0426 100644
--- a/src/pages/Chat/use-teacher-companion.ts
+++ b/src/pages/Chat/use-teacher-companion.ts
@@ -358,7 +358,6 @@ export function useTeacherCompanion(options: Options) {
         || `我是${agent.definition.name}，一起聊聊你的想法吧。`,
       tone: index % 3,
     }]) : [];
-  const dismissWelcomes = () => dismissIntroductions(welcomes.map(item => item.agentId));
   const welcome = !visibleState.agents.length && topic?.role !== 'friend' && !options.teacherOpen && !visibleState.loading && visibleState.enabled && !visibleState.welcomeDismissed
     ? selectedDefinition?.welcome_message.trim() || null : null;
   return {
@@ -375,7 +374,6 @@ export function useTeacherCompanion(options: Options) {
     welcome,
     welcomes,
     dismissWelcome,
-    dismissWelcomes,
     bubbleVisible: Boolean(invitation || welcome || welcomes.length),
     checking: last?.intent === 'check-in' && ['preparing', 'running'].includes(last.status),
     dismiss,
diff --git a/tests/e2e/community-welcome.spec.ts b/tests/e2e/community-welcome.spec.ts
index 1623678e..b2a99fd0 100644
--- a/tests/e2e/community-welcome.spec.ts
+++ b/tests/e2e/community-welcome.spec.ts
@@ -65,7 +65,7 @@ for (const width of [375, 768, 1280, 1470]) {
     await page.getByTestId('community-invitation').scrollIntoViewIfNeeded();
     expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(width);
     await expect(page.getByRole('button', { name: '去作品广场逛逛' })).toBeVisible();
-    await teachers.getByRole('button', { name: '先自己试试' }).click();
+    while (await teachers.count()) await teachers.getByRole('button', { name: /^收起.*的介绍$/ }).first().click();
     await heading.scrollIntoViewIfNeeded();
     const composer = page.getByTestId('coding-message-composer');
     await expect(composer).toBeInViewport({ ratio: 1 });
@@ -125,7 +125,7 @@ for (const width of [1280, 1470]) {
     }).toBeLessThan(2);
     const inputBeforeDismiss = await composer.boundingBox();
     const headingBeforeDismiss = await heading.boundingBox();
-    await teachers.getByRole('button', { name: '先自己试试' }).click();
+    while (await teachers.count()) await teachers.getByRole('button', { name: /^收起.*的介绍$/ }).first().click();
     await expect(composer.getByRole('textbox')).toHaveValue('保留这份草稿');
     expect(await composer.boundingBox()).toEqual(inputBeforeDismiss);
     expect(await heading.boundingBox()).toEqual(headingBeforeDismiss);
diff --git a/tests/e2e/fixtures/community-welcome.tsx b/tests/e2e/fixtures/community-welcome.tsx
index 71712223..baf21c41 100644
--- a/tests/e2e/fixtures/community-welcome.tsx
+++ b/tests/e2e/fixtures/community-welcome.tsx
@@ -25,7 +25,6 @@ export function Layout() {
     welcomes: new URLSearchParams(location.search).has('teachers') ? agents.flatMap((agent, index) => dismissed.includes(agent.teacher_id)
       ? [] : [{ agentId: agent.teacher_id, definition: agent.definition, text: agent.definition.description, tone: index }]) : [],
     dismissWelcome: (id: string) => setDismissed(values => [...values, id]),
-    dismissWelcomes: () => setDismissed(['0', '1']),
   } as ComponentProps<typeof TeacherCompanion>['companion'];
   return <div className="flex h-screen">
     {new URLSearchParams(location.search).has('sidebar') && <aside data-testid="project-sidebar" className="shrink-0 border-r p-4 text-sm" style={{ width: 210, background: '#f1f6fc' }}>我的项目</aside>}
diff --git a/tests/e2e/fixtures/teacher-preview-layout.tsx b/tests/e2e/fixtures/teacher-preview-layout.tsx
index 50ebed75..36edd026 100644
--- a/tests/e2e/fixtures/teacher-preview-layout.tsx
+++ b/tests/e2e/fixtures/teacher-preview-layout.tsx
@@ -33,7 +33,6 @@ export function Layout() {
     welcome: null, enabled: true, loading: false, checking: false, error: null,
     welcomes: welcomeMode && !open ? agents.flatMap((agent, index) => dismissed.includes(agent.teacher_id) ? [] : [{ agentId: agent.teacher_id, definition: agent.definition, text: agent.definition.description, tone: index % 3 }]) : [],
     dismissWelcome: (id: string) => setDismissed(ids => [...new Set([...ids, id])]),
-    dismissWelcomes: () => setDismissed(agents.map(agent => agent.teacher_id)),
     refreshing, refreshStatus,
     refresh: async () => {
       setRefreshing(true);
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 4259caa4..75f468bb 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -2221,6 +2221,9 @@ test('teacher introductions collapse after three operation replies and remain av
     await page.evaluate(() => { window.location.hash = '/chat'; });
     const introductions = page.getByTestId('teacher-welcomes');
     await expect(introductions.locator('.teacher-welcome-card')).toHaveCount(2);
+    await expect(introductions).toHaveCSS('background-color', 'rgba(0, 0, 0, 0)');
+    await expect(introductions.getByText('来认识一下')).toHaveCount(0);
+    await expect(introductions.getByRole('button', { name: '先自己试试' })).toHaveCount(0);
     const startedAt = await page.evaluate(() => Date.now());
     for (let round = 1; round <= 3; round++) {
       for (const status of ['running', 'idle'] as const) {
diff --git a/tests/e2e/teacher-preview-layout.spec.ts b/tests/e2e/teacher-preview-layout.spec.ts
index a7850600..5b98549e 100644
--- a/tests/e2e/teacher-preview-layout.spec.ts
+++ b/tests/e2e/teacher-preview-layout.spec.ts
@@ -41,6 +41,10 @@ for (const width of [375, 768, 1280]) {
     await page.goto(baseUrl + '?agents=3&welcomes');
     const group = page.getByTestId('teacher-welcomes');
     await expect(group.locator('.teacher-welcome-card')).toHaveCount(3);
+    await expect(group).toHaveCSS('background-color', 'rgba(0, 0, 0, 0)');
+    await expect(group).toHaveCSS('box-shadow', 'none');
+    await expect(group.getByText('来认识一下')).toHaveCount(0);
+    await expect(group.getByRole('button', { name: '先自己试试' })).toHaveCount(0);
     await expect(group).toBeInViewport({ ratio: 1 });
     for (const card of await group.locator('.teacher-welcome-card').all()) {
       await expect(card).toBeInViewport({ ratio: 1 });
@@ -53,12 +57,13 @@ for (const width of [375, 768, 1280]) {
     await page.screenshot({ path: test.info().outputPath(`teacher-introductions-${width}.png`) });
     await group.getByRole('button', { name: '收起智能体2的介绍' }).click();
     await expect(group.locator('.teacher-welcome-card')).toHaveCount(2);
-    await group.getByRole('button', { name: '和智能体3聊聊' }).click();
+    await expect(page.locator('#coding-consultation-dock')).toHaveCount(0);
+    await group.getByRole('button', { name: '和智能体3聊聊' }).click({ position: { x: 8, y: 8 } });
     await expect(page.getByRole('button', { name: '与智能体3聊天' })).toHaveAttribute('aria-pressed', 'true');
     await expect(group).toHaveCount(0);
     await page.getByRole('button', { name: '关闭智能体栏' }).click();
     await expect(group.locator('.teacher-welcome-card')).toHaveCount(1);
-    await group.getByRole('button', { name: '先自己试试' }).click();
+    while (await group.count()) await group.getByRole('button', { name: /^收起.*的介绍$/ }).first().click();
     await expect(group).toHaveCount(0);
   });
 }
@@ -75,7 +80,12 @@ test('many teacher introductions remain scrollable and honor reduced motion', as
   await last.scrollIntoViewIfNeeded();
   await expect(last).toBeInViewport({ ratio: 1 });
   expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(520);
-  await group.getByRole('button', { name: '先自己试试' }).click();
+  await last.focus();
+  await page.keyboard.press('Enter');
+  await expect(page.getByRole('button', { name: '与智能体8聊天' })).toHaveAttribute('aria-pressed', 'true');
+  await page.getByRole('button', { name: '关闭智能体栏' }).click();
+  await expect(group.locator('.teacher-welcome-card')).toHaveCount(7);
+  while (await group.count()) await group.getByRole('button', { name: /^收起.*的介绍$/ }).first().click();
   await expect(group).toHaveCount(0);
 });
 
diff --git a/tests/unit/teacher-companion.test.tsx b/tests/unit/teacher-companion.test.tsx
index 989f8347..a4bcb953 100644
--- a/tests/unit/teacher-companion.test.tsx
+++ b/tests/unit/teacher-companion.test.tsx
@@ -193,10 +193,13 @@ describe('individual teacher introductions', () => {
     api.catalog.mockResolvedValue({ items: agents });
     await mount();
     const group = screen.getByTestId('teacher-welcomes');
+    expect(within(group).queryByText('来认识一下')).not.toBeInTheDocument();
+    expect(within(group).queryByRole('button', { name: '先自己试试' })).not.toBeInTheDocument();
     for (const agent of agents) expect(within(group).getByText(agent.definition.description)).toBeVisible();
     expect(screen.queryByTestId('teacher-invitation')).not.toBeInTheDocument();
     await act(async () => fireEvent.click(screen.getByRole('button', { name: '收起体验老师的介绍' })));
     expect(within(group).queryByText('体验老师的自我介绍')).not.toBeInTheDocument();
+    expect(screen.queryByTestId('teacher-chat-panel')).not.toBeInTheDocument();
     expect(within(group).getByText('方法老师的自我介绍')).toBeVisible();
     expect(within(group).getByText('故事老师的自我介绍')).toBeVisible();
     await advance();
@@ -217,7 +220,7 @@ describe('individual teacher introductions', () => {
     expect(screen.getByRole('button', { name: '收起体验老师的介绍' })).toBeVisible();
     await act(async () => next.rerender(<Harness projectId="other" />));
     expect(screen.getByRole('button', { name: '收起方法老师的介绍' })).toBeVisible();
-    await act(async () => fireEvent.click(screen.getByRole('button', { name: '先自己试试' })));
+    for (const agent of agents) await act(async () => fireEvent.click(screen.getByRole('button', { name: `收起${agent.definition.name}的介绍` })));
     expect(screen.queryByTestId('teacher-welcomes')).not.toBeInTheDocument();
     await act(async () => next.rerender(<Harness />));
     expect(screen.queryByRole('button', { name: '收起方法老师的介绍' })).not.toBeInTheDocument();
@@ -230,7 +233,7 @@ describe('individual teacher introductions', () => {
   it('opens the clicked teacher and consumes only their introduction, preserving the others for later', async () => {
     api.catalog.mockResolvedValue({ items: agents });
     await mount();
-    await act(async () => fireEvent.click(screen.getByRole('button', { name: '和故事老师聊聊' })));
+    await act(async () => fireEvent.click(within(screen.getByTestId('teacher-welcomes')).getByText('故事老师的自我介绍')));
     expect(screen.getByRole('button', { name: '与故事老师聊天' })).toHaveAttribute('aria-pressed', 'true');
     expect(screen.getByTestId('teacher-chat-panel')).toHaveTextContent('故事老师的聊天欢迎语');
     expect(screen.getByTestId('teacher-chat-panel')).not.toHaveTextContent('故事老师的自我介绍');
@@ -243,11 +246,11 @@ describe('individual teacher introductions', () => {
     expect(api.sendConversation).not.toHaveBeenCalled();
   });
 
-  it('introduces only newly delivered teachers after dismiss-all, without resetting seen replies or existing receipts on refresh', async () => {
+  it('introduces only newly delivered teachers after individually dismissing every introduction, without resetting seen replies or existing receipts on refresh', async () => {
     localStorage.setItem('makelore-teacher-presence:kid:seen', JSON.stringify(['keep-seen']));
     api.catalog.mockResolvedValue({ items: agents });
     await mount();
-    await act(async () => fireEvent.click(screen.getByRole('button', { name: '先自己试试' })));
+    for (const agent of agents) await act(async () => fireEvent.click(screen.getByRole('button', { name: `收起${agent.definition.name}的介绍` })));
     const added = { ...agents[0], teacher_id: 'new', definition: { ...agents[0].definition, config_id: 'new', name: '新老师', description: '', welcome_message: '新老师的云端欢迎语' } };
     api.catalog.mockResolvedValue({ items: [...agents.map(agent => ({ ...agent, version: 2 })), added] });
     await act(async () => fireEvent.click(screen.getByRole('button', { name: '刷新智能体' })));

From ead34078906336492c509ebb616c9cbb1ab9870a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 18:02:54 +0800
Subject: [PATCH 12/19] Show persistent timestamps for operation and teacher
 messages

---
 .../20260929-community-welcome-c724e5a1.md    | 13 ++-
 README.md                                     |  1 +
 electron/coding-runtime/pi/event-projector.ts |  4 +
 electron/coding-runtime/pi/runtime.ts         |  1 +
 .../coding-runtime/pi/session-projector.ts    |  5 ++
 electron/coding-teacher/service.ts            |  3 +-
 shared/coding-conversation-contracts.ts       |  2 +
 shared/coding-teacher.ts                      |  2 +
 shared/message-timestamp.ts                   |  7 ++
 src/lib/message-timestamp.ts                  | 18 +++++
 src/pages/Chat/CodingConversationTimeline.tsx |  3 +
 src/pages/Chat/MessageTimestamp.tsx           | 15 ++++
 src/pages/Chat/TeacherChatPanel.tsx           | 13 +--
 src/stores/coding-conversations.ts            |  1 +
 tests/e2e/fixtures/message-timestamps.tsx     | 27 +++++++
 tests/e2e/message-timestamps.spec.ts          | 79 +++++++++++++++++++
 tests/e2e/pi-coding-first-chat.spec.ts        |  9 ++-
 .../coding-conversation-timeline.test.tsx     | 22 ++++++
 tests/unit/coding-teacher.test.ts             | 29 +++++++
 tests/unit/message-timestamp.test.tsx         | 30 +++++++
 tests/unit/pi-event-projector.test.ts         | 16 ++++
 tests/unit/pi-session-projector.test.ts       | 19 +++++
 .../unit/teacher-conversation-panel.test.tsx  | 30 +++++++
 tests/unit/teacher-conversation.test.ts       | 15 ++++
 24 files changed, 355 insertions(+), 9 deletions(-)
 create mode 100644 shared/message-timestamp.ts
 create mode 100644 src/lib/message-timestamp.ts
 create mode 100644 src/pages/Chat/MessageTimestamp.tsx
 create mode 100644 tests/e2e/fixtures/message-timestamps.tsx
 create mode 100644 tests/e2e/message-timestamps.spec.ts
 create mode 100644 tests/unit/message-timestamp.test.tsx

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index 62a865aa..3a5b56c4 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -8,7 +8,7 @@
 - Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-community-welcome-c724e5a1
 - Base commit: 4199cadd1e067ce9741d6496196f4d13fed61d12
 - Owner: codex
-- Status: Ready for Integration
+- Status: In Progress
 
 ## Scope
 
@@ -109,3 +109,14 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 - Completed: removed shared welcome background/shadow, heading and dismiss-all entry/callback. Each native button owns its entire colored speech-bubble surface (including the tail), while the close button is a separate sibling. Avatar opening, teacher-specific dismissal, persisted introduction receipts and three-operation-round auto-dismiss are retained. Keyboard focus is visible.
 - Verification: 78 related unit tests, 21 headless welcome/teacher-preview layout cases, typecheck, lint:check (0 errors, 8 existing warnings), scoped changed-test ESLint, build:vite, native E2E --list (20 cases), ownership and whitespace checks passed. Tests cover padding clicks opening the correct teacher, close not opening consultation, Enter opening, many-teacher scroll, no shared chrome, individual dismissal persistence and the previous three-round lifecycle. Reviewed the desktop screenshot. Native headed fixture was not run to avoid focus changes.
 - Trial refreshed in the background to index-BmLachPE.js on unchanged Main PID 62668. Live DOM confirms transparent outer container, no shadow/header/dismiss-all, preserved independent close button and hit-testing of bubble padding to the open button. Preserved the already-dismissed introduction receipts (one remaining Alice introduction), login identity, route and all 13 saved drafts. Welcome centering error remains 0px and bottom gap 16px. No alert or focus activation. Background capture was unavailable; visual evidence comes from the headless screenshot plus actual live DOM verification. Original background throttling restored and inspector closed after completion. Evidence: trial standalone-teacher-bubbles-20260929/.
+
+
+## Follow-up: Timestamps For Operation And Teacher Messages
+
+- User approved the timestamp proposal and asks to implement and update the temporary app. Same owned task/worktree resumed at 3a17510; official start/status verified planning ownership. Existing Project Context Loaded and peer scope assessment apply; no new overlap. Planning Gate: Passed.
+- Show unobtrusive local timestamps beneath every visible user/assistant message, including operation commentary and teacher check-ins. Today uses HH:mm, older messages include date, hover gives full date and seconds. Pending replies show a pending label.
+- Operation messages use Pi user send timestamps and persisted assistant message-entry completion timestamps; live completion is observed at message_end and reconciled to durable history on settlement. Teacher questions retain createdAt; all teacher terminal replies persist a new optional finishedAt. Missing historical times remain explicitly unknown, with no backfill from topic/update/current time and no destructive migration.
+- Plan: add shared validation/display, propagate times through Main and Renderer, verify streaming/terminal/reload/legacy paths, then rebuild and restart only the existing trial in the background, preserving account/project/drafts/history. Keep standalone teacher bubbles and other approved UI. No cloud prompts/config edits, model calls, subagents, main merge or push.
+
+- Implemented the approved timestamp data/display flow with no prompt/configuration changes or history migration. The shared display uses semantic time elements, accessible labels, local dates and full hover precision. Terminal teacher replies persist finishedAt before the saved snapshot is emitted. Operation settlement continues to use the existing canonical Pi hydration.
+- Verification before trial restart: 286 focused tests passed; full suite 2,681 passed and 3 skipped across 266 files including the pressure run. After extracting the pure formatter to remove a new lint warning, typecheck and all 41 affected UI/formatter tests passed. lint:check has 0 errors and the same 8 existing warnings; changed E2E files pass scoped ESLint; build:vite passed. All 23 headless Chrome layout/interaction cases passed, including the two new real-component timestamp fixtures (375/1280px, stable times after reload, quick-reply usability). Reviewed both screenshot sizes. Updated native Electron timestamp assertions and all 20 native cases parse via --list; no headed launch or real model calls.
diff --git a/README.md b/README.md
index c7660c89..03151c9e 100644
--- a/README.md
+++ b/README.md
@@ -150,6 +150,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - Conversation 历史按需从 Main-owned Snapshot 读取。Session hydration 沿完整 active branch 投影可见历史；公开 SSE 交付 Snapshot、会话元数据变更通知，以及按 Conversation、worker generation 分组的 `patch-batch`。Renderer 整批校验连续 seq 后在一次状态事务中顺序应用，缺口或畸形批次只恢复目标 Conversation，隐藏 Conversation 的流式更新不会提交选中时间线。Main 发出 `lifecycle:sleep` 时页面关闭旧事件流；视图挂载、项目上下文变化、窗口重新可见或获得焦点时，已选 Conversation 会静默重读权威 Snapshot，从而收敛后台已结束的任务，但绝不重放已接受或状态不确定的 mutation。时间线默认挂载最近 120 个节点，接近顶部时按 100 个节点自动追加更早内容并补偿新增高度，保持当前阅读锚点。
 - 核心时间线按每条用户消息组织为“用户消息、连续处理过程、结论回复”。Pi 的流式 thinking、工具、压缩、重试、通知和 `subagent.v1` 单个/并行/串行子任务共享一条轻量过程轨道；运行时显示“处理中”和活动指示，完成后按耗时（历史缺少计时时按项目数）收纳为可展开的“已处理”摘要。文字层级按结构化事件类型划分，不按文案关键词猜测：助手在工具调用前后直接对用户说的过程正文与最终结论都使用黑色；thinking、工具输入输出、压缩、子任务和运行状态使用浅灰辅助文字，仍在运行的灰色缩略文字带有低对比度 Shimmer 擦拭高光，结束后停止动画；错误状态保持红色。折叠的 thinking、助手过程正文和工具输出固定展示第一个可见块的首个非空行，横向偏移始终为零；尾部流式更新不会替换未变化的首行预览，展开后仍可查看完整内容。两类流式文字均在原位更新且不做位移动画，助手过程正文也不使用 Shimmer。工具调用用一行摘要持续展示工具名称、最新输入或输出和运行状态，并可按流式批次轻量整行轮动。思考、助手过程正文和工具节点均可展开查看完整详情，工具的累计输出和浏览器附件留在对应的二级展开区而不形成独立气泡。结论回复按安全 Markdown 排版标题、列表、引用、代码和表格；可点击的 HTTP/HTTPS 与本地 HTML 链接统一使用无底色的橙色文字。左键通过 Main-owned 系统入口交给默认浏览器打开；右键可打开系统菜单，网页链接可复制地址，本地链接还可在访达或系统文件夹中显示。同一回复已经给出完整 HTML 路径时，对应的相对查看路径也会解析到该文件。内部 `turn-start`/`turn-end` 只维持事件顺序、不呈现在界面。
 - Composer 使用贴底的复合输入面板，支持文字、登录后的语音转写，以及粘贴或选择 PNG/JPEG/WebP/GIF 图片；每条消息最多 16 张图片、最多并行上传 4 张。语音录制通过现有 Main-owned Works Speech Host API 转成文字，并在项目或账号切换时立即停止；当前对话的模型与思考强度组合入口、语音及发送/中止入口保留在底部控制行，模型入口默认使用透明底色。模型与思考强度通过向上展开的分级菜单切换，只列出当前 Provider 或 Makelore 已验证模型档案实际支持的选项；Qwen3.6 Plus 使用混合思考开关，Qwen3.8 Max 暴露低/中/高三档并把产品“高”映射到服务端 `xhigh`。模型仅报告 `off` 时明确显示“不可调”，不伪造未知模型的推理档位。切换完成后静默刷新当前 Snapshot，只有真正恢复 worker 时才显示本地 Agent 重连提示。重复读取 Snapshot 不发布无变化的 worker 状态；Snapshot 与 SSE 批次竞态时，Renderer 会丢弃已覆盖事件并只应用连续的新尾部，避免形成伪重连循环。上下文接近模型限制或发生溢出时由 Pi 自动整理，Composer 不提供手动整理入口；自动整理的进度和结果仍显示在对话过程轨道中。图片在发送前只保留本地预览，点击发送时才经 Main-owned 有界二进制接口上传一次；Main 在落盘前核对 MIME 与最小图片签名，状态与事件只保存 attachment id，时间线按需读取二进制并创建临时 object URL，不保存重复 base64。发送后立即展示图片附件；Pi 实时消息与历史会话恢复都将图片映射到同一附件存储，重复加载复用已有文件。智能体报告 `changed-file.v1` 后，输入框上方会展示当前轮次的文件数与增删行统计，并可展开查看 Main-owned 变更快照中的逐文件差异。
+- 操作 Agent 和所有老师的消息下方显示本地时间：提问记发送时间，回复记完成时间；当天显示时分，较早消息加日期，跨年加年份，悬停显示完整日期和秒。流式回复显示“回复中…”。操作历史读取 Pi 原始用户时间和回复条目落盘时间；实时回复在结束时记录，再由持久化记录校准。老师每次回复（含主动检查、取消与失败）单独保存完成时间；旧记录缺少时间时显示“时间未记录”，不使用当前时间或话题更新时间回填，也不改写用户历史。
 - Makelore 在应用侧按 Session 独立提交、跟踪和隔离运行状态，不使用“当前对话正在回复”的全局界面锁；同一 Session 的后续消息仍按顺序排队。最终产品中的 Pi 运行时会通过受控 Provider-shaped 回环 smoke 验证同一 Agent Server 内多个 Conversation 逻辑线程的重叠执行、状态隔离、凭证引用隔离、单线程关闭和 Server 崩溃后重启，以及独立子 Agent 进程的隔离与回收；真实外部 Provider 的并发、限流、协议兼容和凭证隔离仍是独立风险，未执行真实 Provider 验证时不得标记为 Pass。
 - 首次发送会立即生成稳定的乐观用户消息；HTTP 202 只表示本地 Agent 已接收。后续失败不会删除已接受消息，不确定交付不会自动重发；准备失败可在目标 Conversation 上手动恢复。
 - 运行中的 Conversation 可把新消息作为 steer 引导当前回答或 follow-up 排到下一轮，并显示队列位置；队列正常在 `agent_settled` 后释放，用户可中止当前运行。若 Pi 已终结但该握手丢失，Main 会在 30 秒宽限后仅探测目标线程：权威 idle 状态会补齐持久化最终回复并 exactly-once 释放 ownership，矛盾状态则显式失败该目标，且不会重放已接受请求。select/confirm/input/editor 交互在输入区上方回答，select 除预设选项外支持自由输入；交互提交或取消后立即从输入区移除，失效请求会就地提示并允许重试或取消。
diff --git a/electron/coding-runtime/pi/event-projector.ts b/electron/coding-runtime/pi/event-projector.ts
index f49e5116..5d6d7c54 100644
--- a/electron/coding-runtime/pi/event-projector.ts
+++ b/electron/coding-runtime/pi/event-projector.ts
@@ -1,3 +1,4 @@
+import { messageTimestamp } from '../../../shared/message-timestamp';
 import type {
   ConversationContentBlock,
   ConversationMessageNode,
@@ -529,6 +530,7 @@ export class PiEventProjector {
               ? { clientRequestId: optimistic.clientRequestId }
               : {}),
             role: 'user',
+            timestamp: messageTimestamp(message.timestamp) ?? optimistic?.timestamp ?? this.now(),
             status: 'complete',
             blocks: await liveContentBlocks(
               id,
@@ -723,6 +725,8 @@ export class PiEventProjector {
           kind: 'message',
           id,
           role: 'assistant',
+          // Live observation; settlement hydration replaces it with Pi's durable entry time.
+          timestamp: this.now(),
           status: message.stopReason === 'aborted'
             ? 'aborted'
             : message.stopReason === 'error' ? 'error' : 'complete',
diff --git a/electron/coding-runtime/pi/runtime.ts b/electron/coding-runtime/pi/runtime.ts
index a56cf174..2ed7eed2 100644
--- a/electron/coding-runtime/pi/runtime.ts
+++ b/electron/coding-runtime/pi/runtime.ts
@@ -814,6 +814,7 @@ export class PiConversationRuntime implements CodingConversationRuntime {
         id: messageId,
         clientRequestId: input.clientRequestId,
         role: 'user',
+        timestamp: this.now(),
         status: 'optimistic',
         blocks: [
           ...(input.text.length > 0
diff --git a/electron/coding-runtime/pi/session-projector.ts b/electron/coding-runtime/pi/session-projector.ts
index 9dbf6c6b..b1fbdb44 100644
--- a/electron/coding-runtime/pi/session-projector.ts
+++ b/electron/coding-runtime/pi/session-projector.ts
@@ -1,3 +1,4 @@
+import { messageTimestamp } from '../../../shared/message-timestamp';
 import type {
   CodingRuntimeErrorCode,
   ConversationContentBlock,
@@ -235,6 +236,10 @@ async function projectEntries(
       id: messageId,
       sourceEntryId: entry.id,
       role: message.role,
+      // Pi appends the entry on message_end; assistant.message.timestamp is its start time.
+      timestamp: message.role === 'user'
+        ? messageTimestamp(message.timestamp) ?? messageTimestamp(entry.timestamp)
+        : messageTimestamp(entry.timestamp),
       status: message.stopReason === 'aborted'
         ? 'aborted'
         : message.stopReason === 'error' ? 'error' : 'complete',
diff --git a/electron/coding-teacher/service.ts b/electron/coding-teacher/service.ts
index 01502db7..b255fe80 100644
--- a/electron/coding-teacher/service.ts
+++ b/electron/coding-teacher/service.ts
@@ -671,7 +671,8 @@ export class CodingTeacherService {
             current.response = '';
             delete current.suggestedQuestions;
           }
-          topic.updatedAt = new Date().toISOString();
+          current.finishedAt = new Date().toISOString();
+          topic.updatedAt = current.finishedAt;
           topic.revision++;
           try {
             await store.save(topic, current.id);
diff --git a/shared/coding-conversation-contracts.ts b/shared/coding-conversation-contracts.ts
index 1e52995e..86a5aeee 100644
--- a/shared/coding-conversation-contracts.ts
+++ b/shared/coding-conversation-contracts.ts
@@ -142,6 +142,8 @@ export type ConversationContentBlock =
 export interface ConversationMessageNode {
   kind: 'message';
   id: string;
+  /** Epoch ms: user send time / assistant completion time. Absent for undated history. */
+  timestamp?: number;
   sourceEntryId?: string;
   clientRequestId?: string;
   role: 'user' | 'assistant';
diff --git a/shared/coding-teacher.ts b/shared/coding-teacher.ts
index 95b0f3e5..00b21150 100644
--- a/shared/coding-teacher.ts
+++ b/shared/coding-teacher.ts
@@ -96,6 +96,8 @@ export interface TeacherRequest {
   text: string;
   references: TeacherReference[];
   createdAt: string;
+  /** Actual terminal time, absent in older history; never inferred from topic.updatedAt. */
+  finishedAt?: string;
   sourceCursor: TeacherSourceContext['cursor'];
   sourceCapturedAt: string;
   includedSourceMessageIds: string[];
diff --git a/shared/message-timestamp.ts b/shared/message-timestamp.ts
new file mode 100644
index 00000000..02e8d915
--- /dev/null
+++ b/shared/message-timestamp.ts
@@ -0,0 +1,7 @@
+/** Read only real, valid epoch milliseconds / ISO dates; never invent a history time. */
+export function messageTimestamp(value: unknown): number | undefined {
+  const timestamp = typeof value === 'number' ? value
+    : typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value) ? Date.parse(value) : NaN;
+  return Number.isFinite(timestamp) && timestamp >= 0 && !Number.isNaN(new Date(timestamp).getTime())
+    ? timestamp : undefined;
+}
diff --git a/src/lib/message-timestamp.ts b/src/lib/message-timestamp.ts
new file mode 100644
index 00000000..1e751b03
--- /dev/null
+++ b/src/lib/message-timestamp.ts
@@ -0,0 +1,18 @@
+import { messageTimestamp } from '../../shared/message-timestamp';
+
+export function formatMessageTimestamp(value: unknown, now = new Date()) {
+  const timestamp = messageTimestamp(value);
+  if (timestamp === undefined) return undefined;
+  const date = new Date(timestamp);
+  const pad = (part: number) => String(part).padStart(2, '0');
+  const time = `${pad(date.getHours())}:${pad(date.getMinutes())}`;
+  const sameYear = date.getFullYear() === now.getFullYear();
+  const today = sameYear && date.getMonth() === now.getMonth() && date.getDate() === now.getDate();
+  const day = `${date.getMonth() + 1}月${date.getDate()}日`;
+  return {
+    iso: date.toISOString(),
+    short: today ? time : `${sameYear ? '' : `${date.getFullYear()}年`}${day} ${time}`,
+    full: `${date.getFullYear()}年${day} ${time}:${pad(date.getSeconds())}`,
+  };
+}
+
diff --git a/src/pages/Chat/CodingConversationTimeline.tsx b/src/pages/Chat/CodingConversationTimeline.tsx
index 78105632..8f37f759 100644
--- a/src/pages/Chat/CodingConversationTimeline.tsx
+++ b/src/pages/Chat/CodingConversationTimeline.tsx
@@ -1,5 +1,6 @@
 import { OPEN_WORK_PROMPT } from '../../../shared/coding-work-preview';
 import { CONTINUE_CODING_PROMPT, type CodingRecoveryAction } from '../../../shared/coding-recovery';
+import { MessageTimestamp } from './MessageTimestamp';
 import { CodingRecoveryCard } from './CodingRecoveryCard';
 import {
   memo,
@@ -539,6 +540,7 @@ const MessageNode = memo(function MessageNode({
             </Button>
           )}
         </div>
+        <MessageTimestamp value={node.timestamp} pending={!user && node.status === 'streaming'} label={user ? '发送时间' : '回复完成时间'} className={cn('mt-1', user && 'text-right')} />
         {!user && answerText && (
           <Button
             type="button"
@@ -1330,6 +1332,7 @@ const AssistantCommentary = memo(function AssistantCommentary({
           {blocks.length === 0 && node.status === 'aborted' && <p className="text-muted-foreground">本次处理已中止。</p>}
         </div>
       </CompactProcessText>
+      <MessageTimestamp value={node.timestamp} pending={streaming} className="mt-1" />
     </div>
   );
 });
diff --git a/src/pages/Chat/MessageTimestamp.tsx b/src/pages/Chat/MessageTimestamp.tsx
new file mode 100644
index 00000000..65c161f4
--- /dev/null
+++ b/src/pages/Chat/MessageTimestamp.tsx
@@ -0,0 +1,15 @@
+import { formatMessageTimestamp } from '@/lib/message-timestamp';
+import { cn } from '@/lib/utils';
+
+export function MessageTimestamp({ value, pending = false, label = '回复完成时间', className }: {
+  value?: number | string;
+  pending?: boolean;
+  label?: string;
+  className?: string;
+}) {
+  const formatted = pending ? undefined : formatMessageTimestamp(value);
+  const style = cn('block text-[11px] leading-5 text-muted-foreground tabular-nums', className);
+  return formatted
+    ? <time className={style} dateTime={formatted.iso} title={formatted.full} aria-label={`${label}：${formatted.full}`}>{formatted.short}</time>
+    : <span className={style} data-message-time={pending ? 'pending' : 'unknown'}>{pending ? '回复中…' : '时间未记录'}</span>;
+}
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index fb5b20a1..87e610c8 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -13,6 +13,7 @@ import type {
 } from '../../../shared/coding-teacher';
 import { TeacherAvatar } from './TeacherAvatar';
 import { TeacherReply } from './TeacherReply';
+import { MessageTimestamp } from './MessageTimestamp';
 
 // Preserve loaded pages and the reading anchor while moving between contacts.
 // Durable messages remain Main-owned; this is only the current window's view.
@@ -514,8 +515,8 @@ export function TeacherChatPanel({
         {topic?.requests.map((request, index) => <div key={request.id} className="mb-7 space-y-4">
           {continuous && request.projectId && (index === 0 || request.projectId !== topic.requests[index - 1].projectId) && <p className="text-center text-[10px] text-muted-foreground">{request.projectName || '之前的项目'}</p>}
           {request.intent === 'check-in'
-            ? <p className="text-[11px] text-muted-foreground">智能体来看看你的进展</p>
-            : <div className="flex justify-end"><p className="consultation-user max-w-[92%] whitespace-pre-wrap break-words rounded-2xl rounded-br-sm px-4 py-3 text-[13px] leading-7">{request.text}</p></div>}
+            ? <div className="space-y-1"><p className="text-[11px] text-muted-foreground">智能体来看看你的进展</p><MessageTimestamp value={request.createdAt} label="主动检查时间" /></div>
+            : <div className="flex flex-col items-end gap-1"><p className="consultation-user max-w-[92%] whitespace-pre-wrap break-words rounded-2xl rounded-br-sm px-4 py-3 text-[13px] leading-7">{request.text}</p><MessageTimestamp value={request.createdAt} label="发送时间" className="text-right" /></div>}
           {request.references.length > 0 && <details className="text-xs text-muted-foreground"><summary>本轮引用 {request.references.length} 项</summary>{request.references.map((ref, index) => <pre className="whitespace-pre-wrap" key={index}>{ref.text}</pre>)}</details>}
           <div className="flex items-center gap-2 text-[11px] text-muted-foreground"><TeacherAvatar definition={definition} className="h-6 w-6 rounded-lg" />{definition?.name ?? label}</div>
           {!!request.toolActivity?.length && <details className="text-xs text-muted-foreground">
@@ -528,6 +529,7 @@ export function TeacherChatPanel({
               </li>)}
             </ul>
           </details>}
+          <div className="space-y-1.5">
           {request.status === 'completed' && request.replyIncomplete ? <div className="space-y-3">
             <p role="status" className="text-[13px] leading-7 text-muted-foreground">这次回复未能完整显示</p>
             {request.intent !== 'check-in' && request.text.trim() && <button type="button" disabled={helpUnavailable || !retryScopeMatches(request)} onClick={() => void send({ text: request.text, intent: request.intent }, request)} className="consultation-retry">重新回答</button>}
@@ -537,13 +539,12 @@ export function TeacherChatPanel({
               ? <p role="status" className="flex items-center gap-2 text-[13px] leading-7 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />我看看你最近做到了哪里…</p>
               : request.status === 'completed' && <>
                 <TeacherReply text={request.response} />
-                <div className="consultation-follow-ups" aria-label="可以和智能体聊的问题">
-                  {request.suggestedQuestions?.map((question, index) => <button key={`${request.id}:${index}`} type="button" disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
-                </div>
               </>}
             {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">帮我整体看🧠</button>}
           </> : request.response ? <TeacherReply text={request.response} /> : <div className="text-[13px] leading-7">{['running', 'preparing'].includes(request.status) ? <span role="status" className="inline-flex items-center gap-2 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />{label}正在想…</span> : ['cancelled', 'interrupted'].includes(request.status) ? '这次先停在这里。想继续时可以再说说。' : ''}</div>}
-          {request.intent !== 'suggestions' && request.status === 'completed' && !request.replyIncomplete && Boolean(request.suggestedQuestions?.length) && <div className="consultation-follow-ups" aria-label="接着聊">
+          <MessageTimestamp value={request.finishedAt} pending={['running', 'preparing'].includes(request.status)} />
+          </div>
+          {request.status === 'completed' && !request.replyIncomplete && Boolean(request.suggestedQuestions?.length) && <div className="consultation-follow-ups" aria-label={request.intent === 'suggestions' ? '可以和智能体聊的问题' : '接着聊'}>
             {request.suggestedQuestions?.map((question, index) => <button type="button" key={`${request.id}:${index}`} disabled={helpUnavailable} onClick={() => void send({ text: question })} className="consultation-follow-up"><span className="min-w-0 flex-1">{question}</span><ChevronRight className="h-4 w-4 shrink-0 opacity-70" aria-hidden="true" /></button>)}
           </div>}
           {request.status === 'completed' && !request.replyIncomplete && request.replyParseError && <p role="status" className="text-xs text-muted-foreground">回答正文已保留，部分附加内容未能显示。</p>}
diff --git a/src/stores/coding-conversations.ts b/src/stores/coding-conversations.ts
index 706f2955..5e6d565e 100644
--- a/src/stores/coding-conversations.ts
+++ b/src/stores/coding-conversations.ts
@@ -227,6 +227,7 @@ function optimisticNode(
     id: nodeId,
     clientRequestId,
     role: 'user',
+    timestamp: Date.now(),
     status: 'optimistic',
     blocks: [
       ...(draft.text ? [{
diff --git a/tests/e2e/fixtures/message-timestamps.tsx b/tests/e2e/fixtures/message-timestamps.tsx
new file mode 100644
index 00000000..a841c268
--- /dev/null
+++ b/tests/e2e/fixtures/message-timestamps.tsx
@@ -0,0 +1,27 @@
+import { createRoot } from 'react-dom/client';
+import { CodingConversationTimeline } from '../../../src/pages/Chat/CodingConversationTimeline';
+import { TeacherChatPanel } from '../../../src/pages/Chat/TeacherChatPanel';
+import { codingConversationStore } from '../../../src/stores/coding-conversations';
+import { createProductSnapshot } from '../../fixtures/coding-conversation-product-fixtures';
+import type { TeacherDefinition, TeacherTopic } from '../../../shared/coding-teacher';
+import '../../../src/styles/globals.css';
+import '../../../src/pages/Chat/classroom-workspace.css';
+
+const sent = '2026-09-28T08:01:02.000Z', finished = '2026-09-28T08:01:42.000Z';
+const snapshot = createProductSnapshot('timestamp-fixture', 1);
+snapshot.run = { status: 'idle' };
+snapshot.nodes = [
+  { kind: 'message', id: 'u', role: 'user', status: 'complete', timestamp: Date.parse(sent), blocks: [{ kind: 'text', id: 'ut', status: 'complete', text: '我想做一个会长大的小宠物。' }] },
+  { kind: 'message', id: 'a', role: 'assistant', status: 'complete', timestamp: Date.parse(finished), blocks: [{ kind: 'text', id: 'at', status: 'complete', text: '小宠物的家搭好啦。你可以试着点一下喂食按钮，看看它的变化。' }] },
+];
+codingConversationStore.getState().primeConversation(snapshot);
+const definition: TeacherDefinition = { schema_version: 1, config_id: 'teacher-fixture', teacher_id: 'teacher-fixture', name: '设计老师', description: '', avatar_id: 'avatar-06', welcome_message: '', suggested_questions: [], system_prompt: '', skills: [], model: { model_id: 'fixture', reasoning_choice: { mode: 'default' } }, limits: { max_input_tokens: 8000, max_output_tokens: 1000 } };
+const topic: TeacherTopic = { schemaVersion: 1, revision: 1, id: 'teacher-fixture', accountId: 'fixture', projectId: 'fixture', sourceConversationId: 'timestamp-fixture', definition, version: 1, conversation: { agentId: 'teacher-fixture', segmentTurns: 1, discussions: {} }, createdAt: sent, updatedAt: finished, requests: [{ id: 'r', createdAt: sent, finishedAt: finished, text: '我想让它长大以后变得很特别。', response: '先想一个你最希望它学会的小本领吧。你希望它会帮你做什么？', suggestedQuestions: ['我想让它陪我讲故事。', '我想让它记住我的习惯。'], references: [], sourceCursor: { workerGeneration: 1, seq: 1 }, sourceCapturedAt: sent, includedSourceMessageIds: [], omittedMessages: 0, status: 'completed' }] };
+(window as typeof window & { __timestampTopic: TeacherTopic }).__timestampTopic = topic;
+const agent = { teacher_id: definition.config_id!, version: 1, is_default: true, definition };
+createRoot(document.getElementById('root')!).render(
+  <div className="classroom-workspace min-h-screen bg-white" style={{ display: 'grid', gridTemplateColumns: innerWidth >= 768 ? 'minmax(0, 1fr) 420px' : 'minmax(0, 1fr)' }}>
+    <main className="min-w-0 p-6" aria-label="操作对话"><h1 className="mb-8 text-lg">操作对话</h1><CodingConversationTimeline conversationId="timestamp-fixture" /></main>
+    <div className="consultation-pane h-[850px] border-l"><TeacherChatPanel projectId="fixture" sourceId="timestamp-fixture" selectedAgent={agent} catalogState={{ config: { enabled: true, definition }, catalog: { items: [agent] } }} /></div>
+  </div>,
+);
diff --git a/tests/e2e/message-timestamps.spec.ts b/tests/e2e/message-timestamps.spec.ts
new file mode 100644
index 00000000..946c45c7
--- /dev/null
+++ b/tests/e2e/message-timestamps.spec.ts
@@ -0,0 +1,79 @@
+import { test, expect } from '@playwright/test';
+import { createServer, type ViteDevServer } from 'vite';
+import { resolve } from 'node:path';
+
+let server: ViteDevServer;
+let baseUrl: string;
+test.use({ headless: true, channel: process.env.MAKELORE_LAYOUT_BROWSER_CHANNEL, video: 'off' });
+test.beforeAll(async () => {
+  server = await createServer({
+    configFile: false, cacheDir: 'node_modules/.vite-message-timestamps',
+    resolve: { alias: { '@': resolve('src') } }, esbuild: { jsx: 'automatic' },
+    server: { host: '127.0.0.1', port: 0 },
+    plugins: [{
+      name: 'isolated-message-timestamps', enforce: 'pre',
+      load(id) {
+        if (id.endsWith('/src/lib/coding-teacher.ts')) return `
+          export function teacherTopicsPath() { return '/fixture'; }
+          export function legacyTopicBase(base) { return base; }
+          export const teacherApi = {
+            conversation: async () => ({ topic: window.__timestampTopic, before: null }),
+            seenConversation: async () => window.__timestampTopic,
+            events: async () => ({ close() {}, addEventListener() {} }),
+          };
+        `;
+        if (id.endsWith('/src/lib/host-events.ts')) return 'export function subscribeHostEvent() { return () => {}; }';
+        if (id.endsWith('/src/lib/host-api.ts')) return `
+          export async function createHostEventSource() { return { close() {}, addEventListener() {} }; }
+          export async function ensureHostApiToken() { return 'fixture'; }
+          export function getHostApiBase() { return ''; }
+          export function reportDesktopActivity() {}
+          export function setDesktopBackgroundLease() {}
+          export async function hostApiFetch() { return {}; }
+          export async function hostApiFetchBytes() { return new Uint8Array(); }
+        `;
+      },
+      configureServer(vite) {
+        vite.middlewares.use((req, res, next) => {
+          if (req.url !== '/' && !req.url?.startsWith('/?')) return next();
+          res.setHeader('Content-Type', 'text/html');
+          res.end('<html><head><meta charset="utf-8"></head><body><div id="root"></div><script type="module" src="/tests/e2e/fixtures/message-timestamps.tsx"></script></body></html>');
+        });
+      },
+    }],
+  });
+  await server.listen();
+  baseUrl = server.resolvedUrls!.local[0];
+});
+test.afterAll(async () => { await server?.close(); });
+test.beforeEach(async ({ page }) => {
+  page.on('pageerror', error => { throw error; });
+  await page.addInitScript(() => {
+    const scope = window as typeof window & { __communityCalls: unknown[][] };
+    scope.__communityCalls = [];
+    Object.defineProperty(window, 'electron', { value: { ipcRenderer: {
+      invoke: async (...args: unknown[]) => { scope.__communityCalls.push(args); return undefined; },
+    } } });
+  });
+});
+
+for (const width of [375, 1280]) {
+  test(`both chat surfaces show stable local times at ${width}px`, async ({ page }) => {
+    await page.setViewportSize({ width, height: 900 });
+    await page.goto(baseUrl);
+    await expect(page.locator('time')).toHaveCount(4);
+    const times = await page.locator('time').evaluateAll(elements => elements.map(element => ({ time: element.getAttribute('datetime'), title: element.getAttribute('title') })));
+    expect(times.map(item => item.time)).toEqual(['2026-09-28T08:01:02.000Z', '2026-09-28T08:01:42.000Z', '2026-09-28T08:01:02.000Z', '2026-09-28T08:01:42.000Z']);
+    for (const item of times) expect(item.title).toMatch(/^2026年9月28日 \d{2}:\d{2}:(02|42)$/);
+    for (const time of await page.locator('time').all()) {
+      await expect(time).toHaveCSS('font-size', '11px');
+      expect(await time.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
+    }
+    await expect(page.getByRole('button', { name: '我想让它陪我讲故事。' })).toBeEnabled();
+    expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(width);
+    await page.screenshot({ path: test.info().outputPath(`message-timestamps-${width}.png`), fullPage: true });
+    await page.reload();
+    await expect(page.locator('time')).toHaveCount(4);
+    expect(await page.locator('time').evaluateAll(elements => elements.map(element => ({ time: element.getAttribute('datetime'), title: element.getAttribute('title') })))).toEqual(times);
+  });
+}
diff --git a/tests/e2e/pi-coding-first-chat.spec.ts b/tests/e2e/pi-coding-first-chat.spec.ts
index 75f468bb..99e14a72 100644
--- a/tests/e2e/pi-coding-first-chat.spec.ts
+++ b/tests/e2e/pi-coding-first-chat.spec.ts
@@ -226,6 +226,7 @@ async function installCodingFirstChatHost(
           kind: 'message',
           id: 'message-user-e2e',
           sourceEntryId: 'entry-user-e2e',
+          timestamp: Date.parse(now),
           role: 'user',
           status: 'complete',
           blocks: [{ kind: 'text', id: 'message-user-e2e:content:0', text: 'Durable user fork source', status: 'complete' }],
@@ -582,7 +583,7 @@ async function installCodingFirstChatHost(
         if (action === 'messages' && method === 'POST') {
           const suggestions = body!.intent === 'suggestions';
           const response = suggestions ? '我们可以从你最近试过的地方聊起。' : body!.intent === 'guided-help' ? '你最近做的哪一步，让你停下来想了一会儿？' : '先理解状态如何随点击变化，再修改代码。';
-          consultationTopics[agentId] = {...current,revision:Number(current.revision)+1,requests:[...(current.requests as unknown[]),{id:body!.requestId,projectId:body!.projectId,sourceConversationId:body!.sourceConversationId,text:body!.text,intent:body!.intent,references:body!.references??[],createdAt:new Date().toISOString(),sourceCursor:{workerGeneration:1,seq:1},sourceCapturedAt:now,includedSourceMessageIds:[],omittedMessages:0,truncatedMessages:1,status:'completed',response,...(suggestions?{suggestedQuestions:['怎样观察别人玩游戏？','我该先试哪个想法？']}:{})}]};
+          consultationTopics[agentId] = {...current,revision:Number(current.revision)+1,requests:[...(current.requests as unknown[]),{id:body!.requestId,projectId:body!.projectId,sourceConversationId:body!.sourceConversationId,text:body!.text,intent:body!.intent,references:body!.references??[],createdAt:now,finishedAt:new Date(Date.parse(now)+40000).toISOString(),sourceCursor:{workerGeneration:1,seq:1},sourceCapturedAt:now,includedSourceMessageIds:[],omittedMessages:0,truncatedMessages:1,status:'completed',response,...(suggestions?{suggestedQuestions:['怎样观察别人玩游戏？','我该先试哪个想法？']}:{})}]};
           const last = (consultationTopics[agentId].requests as Record<string, unknown>[]).at(-1)!;
           Object.assign(last, consultationReply);
           if (state.nextTeacherReplyIncomplete) {
@@ -1914,6 +1915,11 @@ test('project consultations preserve student drafts and switch between work and
     await teacher.getByRole('textbox',{name:'向智能体提问'}).fill('');
     await teacher.locator('form .consultation-hint').click();
     await expect(teacher.getByText('我们可以从你最近试过的地方聊起。')).toBeVisible();
+    const sentTime = teacher.locator('time').nth(0), replyTime = teacher.locator('time').nth(1);
+    await expect(sentTime).toHaveAttribute('aria-label', /^发送时间：/);
+    await expect(replyTime).toHaveAttribute('aria-label', /^回复完成时间：/);
+    const originalReplyTime = await replyTime.getAttribute('datetime');
+    expect(Date.parse(originalReplyTime!) - Date.parse((await sentTime.getAttribute('datetime'))!)).toBe(40000);
     await expect(teacher.getByTestId('teacher-discussion')).toHaveCount(0);
     await teacher.getByRole('textbox',{name:'向智能体提问'}).fill('还没说完的困惑');
     await expect(teacher.locator('form .consultation-hint')).toHaveCount(0);
@@ -1965,6 +1971,7 @@ test('project consultations preserve student drafts and switch between work and
     await page.getByRole('button',{name:'与朋友聊天',exact:true}).click();await expect(teacher).toHaveCount(0);
     await page.getByRole('button',{name:'与朋友聊天',exact:true}).click();
     await expect(page.getByText('先理解状态如何随点击变化，再修改代码。',{exact:true})).toBeVisible();
+    await expect(teacher.locator('time').nth(1)).toHaveAttribute('datetime', originalReplyTime!);
     await expect(teacher.getByRole('textbox',{name:'向智能体提问'})).toHaveValue('还没说完的困惑');
   } finally {await releaseSnapshot(electronApp);}
 });
diff --git a/tests/unit/coding-conversation-timeline.test.tsx b/tests/unit/coding-conversation-timeline.test.tsx
index cc228f38..14d794ae 100644
--- a/tests/unit/coding-conversation-timeline.test.tsx
+++ b/tests/unit/coding-conversation-timeline.test.tsx
@@ -11,6 +11,28 @@ vi.mock('@/lib/coding-attachments', () => ({
 }));
 
 describe('CodingConversationTimeline', () => {
+  it('shows stable timestamps beneath both sides without changing message content', async () => {
+    const { codingConversationStore } = await import('@/stores/coding-conversations');
+    const { CodingConversationTimeline } = await import('@/pages/Chat/CodingConversationTimeline');
+    const snapshot = createProductSnapshot('message-times', 1);
+    snapshot.run = { status: 'idle' };
+    const sent = Date.parse('2026-09-28T08:01:02Z'), finished = sent + 40000;
+    snapshot.nodes = [
+      { kind: 'message', id: 'u', role: 'user', status: 'complete', timestamp: sent, blocks: [{ kind: 'text', id: 'ut', status: 'complete', text: '时间问题' }] },
+      { kind: 'message', id: 'a', role: 'assistant', status: 'complete', timestamp: finished, blocks: [{ kind: 'text', id: 'at', status: 'complete', text: '时间回答' }] },
+    ];
+    codingConversationStore.getState().primeConversation(snapshot);
+    const view = render(<CodingConversationTimeline conversationId="message-times" />);
+    const userTime = view.container.querySelector('[data-node-id="u"] time');
+    const agentTime = view.container.querySelector('[data-node-id="a"] time');
+    expect(userTime).toHaveAttribute('datetime', new Date(sent).toISOString());
+    expect(userTime).toHaveClass('text-right');
+    expect(agentTime).toHaveAttribute('datetime', new Date(finished).toISOString());
+    act(() => codingConversationStore.getState().primeConversation(structuredClone(snapshot)));
+    expect(view.container.querySelector('[data-node-id="a"] time')).toHaveAttribute('datetime', new Date(finished).toISOString());
+    expect(screen.getByText('时间回答')).toBeVisible();
+  });
+
   it('gives the failed hidden work action one login recovery and removes it when work is ready', async () => {
     const { codingConversationStore } = await import('@/stores/coding-conversations');
     const { CodingConversationTimeline } = await import('@/pages/Chat/CodingConversationTimeline');
diff --git a/tests/unit/coding-teacher.test.ts b/tests/unit/coding-teacher.test.ts
index bb290b47..34df5a95 100644
--- a/tests/unit/coding-teacher.test.ts
+++ b/tests/unit/coding-teacher.test.ts
@@ -164,6 +164,35 @@ async function fixture({ durableSource = false, sourceContext = context, liveMod
   };
 }
 describe('cloud coding teacher', () => {
+  it.each([false, true])('persists terminal times for local/cloud=%s replies across restart', async cloudTeacher => {
+    const f = await fixture({ cloudTeacher, mockCloud: cloudTeacher });
+    const topic = await f.service.create(f.scope, undefined, undefined, cloudTeacher ? 9 : undefined);
+    const id = '22222222-2222-4222-8222-222222222222';
+    await f.service.send(f.scope, topic.id, { requestId: id, text: '解释一下' });
+    const running = (await f.service.read(f.scope, topic.id)).requests[0];
+    expect(running.finishedAt).toBeUndefined();
+    const endingAfter = Date.now();
+    f.finish();
+    await vi.waitFor(async () => expect((await f.service.read(f.scope, topic.id)).requests[0].finishedAt).toBeTruthy());
+    const saved = (await f.service.read(f.scope, topic.id)).requests[0];
+    expect(saved.createdAt).toBe(running.createdAt);
+    expect(Date.parse(saved.finishedAt!)).toBeGreaterThanOrEqual(endingAfter);
+    expect(Date.parse(saved.finishedAt!)).toBeLessThanOrEqual(Date.now());
+    const restarted = await f.restart();
+    expect((await restarted.read(f.scope, topic.id)).requests[0]).toEqual(saved);
+  });
+  it.each(['cancelled', 'failed'] as const)('also saves the actual terminal time for %s replies', async status => {
+    const f = await fixture();
+    if (status === 'failed') f.run.mockRejectedValueOnce(new Error('failure'));
+    const topic = await f.service.create(f.scope);
+    const id = '22222222-2222-4222-8222-222222222222';
+    await f.service.send(f.scope, topic.id, { requestId: id, text: '解释一下' });
+    if (status === 'cancelled') await f.service.cancel(f.scope, topic.id, id);
+    await vi.waitFor(async () => expect((await f.service.read(f.scope, topic.id)).requests[0]).toMatchObject({ status, finishedAt: expect.any(String) }));
+    const saved = (await f.service.read(f.scope, topic.id)).requests[0];
+    expect((await (await f.restart()).read(f.scope, topic.id)).requests[0].finishedAt).toBe(saved.finishedAt);
+  });
+
   it('does not change the selected discussion when the companion polls an older topic', async () => {
     const f = await fixture();
     const old = await f.service.create(f.scope);
diff --git a/tests/unit/message-timestamp.test.tsx b/tests/unit/message-timestamp.test.tsx
new file mode 100644
index 00000000..9c52da4d
--- /dev/null
+++ b/tests/unit/message-timestamp.test.tsx
@@ -0,0 +1,30 @@
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it } from 'vitest';
+import { MessageTimestamp } from '@/pages/Chat/MessageTimestamp';
+import { formatMessageTimestamp } from '@/lib/message-timestamp';
+import { messageTimestamp } from '../../shared/message-timestamp';
+
+const now = new Date(2026, 8, 29, 17, 8, 9);
+describe('message timestamps', () => {
+  it('uses local dates, distinguishes older years, and exposes full precision without a ticking clock', () => {
+    expect(formatMessageTimestamp(now.getTime(), now)).toEqual({ iso: now.toISOString(), short: '17:08', full: '2026年9月29日 17:08:09' });
+    expect(formatMessageTimestamp(new Date(2026, 8, 28, 23, 59).toISOString(), now)?.short).toBe('9月28日 23:59');
+    expect(formatMessageTimestamp(new Date(2025, 8, 29, 17, 8).getTime(), now)?.short).toBe('2025年9月29日 17:08');
+    expect(formatMessageTimestamp(new Date(2026, 8, 30, 0, 1).getTime(), now)?.short).toBe('9月30日 00:01');
+  });
+  it.each([undefined, null, '', 'now', '1', NaN, Infinity, -1, 1e20, '2026-99-99T00:00:00Z'])('does not invent a date for %s', value => {
+    expect(messageTimestamp(value)).toBeUndefined();
+    expect(formatMessageTimestamp(value, now)).toBeUndefined();
+  });
+  it('renders a semantic time with full hover text; pending and legacy replies do not get fabricated times', () => {
+    const view = render(<MessageTimestamp value={now.toISOString()} pending />);
+    expect(screen.getByText('回复中…')).toHaveAttribute('data-message-time', 'pending');
+    expect(view.container.querySelector('time')).toBeNull();
+    view.rerender(<MessageTimestamp value={now.toISOString()} label="发送时间" />);
+    expect(view.container.querySelector('time')).toHaveAttribute('datetime', now.toISOString());
+    expect(view.container.querySelector('time')).toHaveAttribute('title', '2026年9月29日 17:08:09');
+    view.rerender(<MessageTimestamp />);
+    expect(screen.getByText('时间未记录')).toBeVisible();
+    expect(view.container.querySelector('time')).toBeNull();
+  });
+});
diff --git a/tests/unit/pi-event-projector.test.ts b/tests/unit/pi-event-projector.test.ts
index 4cbd9fa9..036457fa 100644
--- a/tests/unit/pi-event-projector.test.ts
+++ b/tests/unit/pi-event-projector.test.ts
@@ -58,6 +58,19 @@ function apply(
 }
 
 describe('Pi event projector', () => {
+  it.each(['stop', 'error', 'aborted'])('uses send time and terminal time for %s, never the assistant start time', async stopReason => {
+    let now = 2000;
+    const projector = new PiEventProjector({ createId: () => 'live-message', now: () => now });
+    let snapshot = emptySnapshot();
+    snapshot = apply(snapshot, await projector.project(snapshot, { type: 'message_start', message: { role: 'user', timestamp: 1000, content: [{ type: 'text', text: '你好' }] } }));
+    expect(snapshot.nodes[0]).toMatchObject({ role: 'user', timestamp: 1000 });
+    snapshot = apply(snapshot, await projector.project(snapshot, { type: 'message_start', message: { role: 'assistant', timestamp: 2000, content: [] } }));
+    expect(snapshot.nodes.at(-1)).not.toHaveProperty('timestamp');
+    now = 9000;
+    snapshot = apply(snapshot, await projector.project(snapshot, { type: 'message_end', message: { role: 'assistant', timestamp: 2000, stopReason, content: [{ type: 'text', text: '你好呀' }] } }));
+    expect(snapshot.nodes.at(-1)).toMatchObject({ role: 'assistant', timestamp: 9000 });
+  });
+
   it('projects only subagent.v1 details and never exposes unknown raw details', async () => {
     const projector = new PiEventProjector({ createId: () => 'unused' });
     let snapshot = emptySnapshot();
@@ -157,6 +170,7 @@ describe('Pi event projector', () => {
   it('keeps one assistant UI identity while content-index deltas become an authoritative message', async () => {
     const projector = new PiEventProjector({
       createId: () => 'assistant-ui-a',
+      now: () => 9000,
     });
     let snapshot = emptySnapshot();
     const initialAssistant = {
@@ -217,6 +231,7 @@ describe('Pi event projector', () => {
       kind: 'message',
       id: 'assistant-ui-a',
       role: 'assistant',
+      timestamp: 9000,
       status: 'complete',
       blocks: [{
         kind: 'text',
@@ -624,6 +639,7 @@ describe('Pi event projector', () => {
       kind: 'message',
       id: 'user-ui-a',
       clientRequestId: 'request-a',
+      timestamp: 20,
       role: 'user',
       status: 'complete',
       blocks: [
diff --git a/tests/unit/pi-session-projector.test.ts b/tests/unit/pi-session-projector.test.ts
index d93020b9..4c30dddf 100644
--- a/tests/unit/pi-session-projector.test.ts
+++ b/tests/unit/pi-session-projector.test.ts
@@ -33,6 +33,25 @@ function baseSnapshot(): ConversationSnapshot {
 const zeroCost = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };
 
 describe('Pi session projector', () => {
+  it('restores send and completion times from durable entries and leaves undated history unknown', async () => {
+    const sent = '2026-09-28T08:01:02.000Z', finished = '2026-09-28T08:01:42.000Z';
+    const input = { snapshot: baseSnapshot(), workerGeneration: 1,
+      state: { sessionId: 'times', isStreaming: false, isCompacting: false },
+      entries: { leafId: 'old', entries: [
+        { type: 'message', id: 'u', parentId: null, timestamp: finished, message: { role: 'user', timestamp: Date.parse(sent), content: '你好' } },
+        { type: 'message', id: 'a', parentId: 'u', timestamp: finished, message: { role: 'assistant', timestamp: Date.parse(sent), stopReason: 'stop', content: [{ type: 'text', text: '你好呀' }] } },
+        { type: 'message', id: 'fallback', parentId: 'a', timestamp: sent, message: { role: 'user', timestamp: 'invalid', content: '较早问题' } },
+        { type: 'message', id: 'old', parentId: 'fallback', timestamp: 'invalid', message: { role: 'assistant', timestamp: Date.parse(sent), stopReason: 'stop', content: [{ type: 'text', text: '无完成时间' }] } },
+      ] } };
+    const snapshot = await projectPiSessionSnapshot(input);
+    expect(snapshot.nodes).toMatchObject([
+      { role: 'user', timestamp: Date.parse(sent) }, { role: 'assistant', timestamp: Date.parse(finished) },
+      { role: 'user', timestamp: Date.parse(sent) }, { role: 'assistant', timestamp: undefined },
+    ]);
+    expect((await projectPiSessionSnapshot({ ...input, snapshot })).nodes).toEqual(snapshot.nodes);
+    expect(input.entries.entries[3].timestamp).toBe('invalid');
+  });
+
   it('restores the observed expired Works Square session as a safe login recovery notice', async () => {
     const snapshot = await projectPiSessionSnapshot({
       snapshot: baseSnapshot(), workerGeneration: 1,
diff --git a/tests/unit/teacher-conversation-panel.test.tsx b/tests/unit/teacher-conversation-panel.test.tsx
index 272cbf65..88093f22 100644
--- a/tests/unit/teacher-conversation-panel.test.tsx
+++ b/tests/unit/teacher-conversation-panel.test.tsx
@@ -41,6 +41,36 @@ const props = { projectId: 'project-a', projectName: '天气', sourceId: 'source
 async function mount() { let view!: ReturnType<typeof render>; await act(async () => { view = render(<TeacherChatPanel {...props} />); }); return view; }
 
 describe('continuous agent panel', () => {
+  it.each([undefined, 'suggestions', 'check-in'] as const)('shows question/check-in and reply times for %s across teacher reloads', async intent => {
+    const current = { ...request('timestamped'), createdAt: '2026-09-28T08:01:02Z', finishedAt: '2026-09-28T08:01:42Z', intent,
+      suggestedQuestions: ['接着聊'], response: '这一轮的回答' };
+    const saved = topic([current, request('legacy')]);
+    api.conversation.mockResolvedValue({ topic: saved, before: null });
+    api.seenConversation.mockImplementation(async () => saved);
+    const view = await mount();
+    expect(view.container.querySelectorAll('time')).toHaveLength(2);
+    expect(view.container.querySelectorAll('time')[0]).toHaveAttribute('datetime', '2026-09-28T08:01:02.000Z');
+    expect(view.container.querySelectorAll('time')[1]).toHaveAttribute('datetime', '2026-09-28T08:01:42.000Z');
+    expect(screen.getAllByText('时间未记录')).toHaveLength(2);
+    expect(screen.getByRole('button', { name: '接着聊' })).toBeVisible();
+    view.unmount();
+    const reloaded = await mount();
+    expect(reloaded.container.querySelectorAll('time')[1]).toHaveAttribute('datetime', '2026-09-28T08:01:42.000Z');
+    expect(api.sendConversation).not.toHaveBeenCalled();
+  });
+  it('waits for the terminal reply timestamp while preserving the question time', async () => {
+    const current = { ...request('streaming'), status: 'running' as const, createdAt: '2026-09-28T08:01:02Z' };
+    const saved = topic([current]);
+    api.conversation.mockResolvedValue({ topic: saved, before: null });
+    api.seenConversation.mockImplementation(async () => saved);
+    const view = await mount();
+    expect(view.container.querySelectorAll('time')).toHaveLength(1);
+    expect(view.container.querySelector('[data-message-time="pending"]')).toBeVisible();
+    await act(async () => stream.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify({ ...saved, revision: 2, requests: [{ ...current, status: 'completed', finishedAt: '2026-09-28T08:01:42Z' }] }) })));
+    expect(view.container.querySelectorAll('time')).toHaveLength(2);
+    expect(view.container.querySelector('[data-message-time="pending"]')).toBeNull();
+  });
+
   it('retries incomplete prose only in its original project/source and keeps current drafts and one send identity', async () => {
     const original = { ...request('broken', '现在项目是什么阶段？'), response: '它早就不是', replyIncomplete: true,
       references: [{ kind: 'code' as const, text: '原项目代码' }] };
diff --git a/tests/unit/teacher-conversation.test.ts b/tests/unit/teacher-conversation.test.ts
index 82ed96b5..6d346a91 100644
--- a/tests/unit/teacher-conversation.test.ts
+++ b/tests/unit/teacher-conversation.test.ts
@@ -37,6 +37,21 @@ function turn(index: number): TeacherRequest {
     omittedMessages: 0, status: 'completed', response: '回答 ' + index };
 }
 describe('continuous conversation persistence', () => {
+  it('preserves individual completion times and reads older replies without backfilling or rewriting them', async () => {
+    const dir = await root();
+    const store = new TeacherConversationStore(dir, 'account', 'agent-a');
+    const topic = await store.ensure(definition, 1);
+    const old = turn(1), recent = { ...turn(2), finishedAt: '2026-09-29T08:01:42.000Z' };
+    topic.requests = [old, recent];
+    await store.save(topic);
+    const first = await new TeacherConversationStore(dir, 'account', 'agent-a').read();
+    expect(first.requests[0]).not.toHaveProperty('finishedAt');
+    expect(first.requests[1].finishedAt).toBe(recent.finishedAt);
+    const second = await new TeacherConversationStore(dir, 'account', 'agent-a').read();
+    expect(second.requests).toEqual(first.requests);
+    expect(second.requests[0].createdAt).toBe(old.createdAt);
+  });
+
   it('repairs retained replies on every page without rewriting their files during restart recovery', async () => {
     const dir = await root();
     const store = new TeacherConversationStore(dir, 'account', 'agent-a');

From cd1ba41e214ebe4a1f698be0dde14591bb7b87df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 18:16:47 +0800
Subject: [PATCH 13/19] Record timestamp trial verification

---
 .../30-worklog/tasks/20260929-community-welcome-c724e5a1.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
index 3a5b56c4..f97f019d 100644
--- a/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
+++ b/.project-docs/30-worklog/tasks/20260929-community-welcome-c724e5a1.md
@@ -8,7 +8,7 @@
 - Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-community-welcome-c724e5a1
 - Base commit: 4199cadd1e067ce9741d6496196f4d13fed61d12
 - Owner: codex
-- Status: In Progress
+- Status: Ready for Integration
 
 ## Scope
 
@@ -120,3 +120,7 @@ All three steps completed. Earlier public-feed investigation was feasibility wor
 
 - Implemented the approved timestamp data/display flow with no prompt/configuration changes or history migration. The shared display uses semantic time elements, accessible labels, local dates and full hover precision. Terminal teacher replies persist finishedAt before the saved snapshot is emitted. Operation settlement continues to use the existing canonical Pi hydration.
 - Verification before trial restart: 286 focused tests passed; full suite 2,681 passed and 3 skipped across 266 files including the pressure run. After extracting the pure formatter to remove a new lint warning, typecheck and all 41 affected UI/formatter tests passed. lint:check has 0 errors and the same 8 existing warnings; changed E2E files pass scoped ESLint; build:vite passed. All 23 headless Chrome layout/interaction cases passed, including the two new real-component timestamp fixtures (375/1280px, stable times after reload, quick-reply usability). Reviewed both screenshot sizes. Updated native Electron timestamp assertions and all 20 native cases parse via --list; no headed launch or real model calls.
+
+- Trial backend and Renderer updated in the background to code commit ead34078906336492c509ebb616c9cbb1ab9870a, Main PID 19053, asset index-BiMeMtQo.js. The previously running Main's source differs only by this timestamp change in Main/shared code. Existing temporary profile, formal app and remote branches retained. The old process quit gracefully after checking no active request and capturing the current state; the bootstrap suppressed show/focus and restored bounds/zoom.
+- Live verification recovered 14 genuine operation message times and the current teacher question time; the older teacher reply correctly displays unknown. Operation text, teacher history and selected teacher match the pre-restart view, the verified Main account was restored to Renderer through its normal auth init, route is unchanged and all 13 saved drafts are byte-equal. The consultation dock is restored. The central pane is left on operation chat for timestamp review: restoring the former Work tab after a Main restart could automatically request a model to reopen its lost native preview, so no work-opening request was made.
+- Focus monitor observed only Codex during restart; trial remained unfocused throughout later checks. Background throttling restored and temporary inspector closed. No actual model prompt, cloud configuration publication, main merge or push. Evidence/manifests/check logs: trial message-timestamps-20260929/. Retain this worktree because the running trial uses it.

From 78cfde67340aaccea8e8edc2505136cfcf865eda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 19:43:45 +0800
Subject: [PATCH 14/19] Add teacher microphone and per-question model selection

---
 .../20260929-teacher-composer-4f829ac1.md     |  56 ++++++++
 README.md                                     |   1 +
 electron/api/routes/coding-teacher.ts         |  11 +-
 electron/coding-teacher/cloud-runner.ts       |   1 +
 electron/coding-teacher/model-catalog.ts      |  38 +++++
 electron/coding-teacher/service.ts            |  20 ++-
 shared/coding-teacher.ts                      |   8 ++
 src/hooks/use-teacher-model-choice.ts         |  20 +++
 src/lib/coding-teacher.ts                     |   2 +
 src/pages/Chat/CodingComposer.tsx             |  27 +---
 src/pages/Chat/ComposerVoiceButton.tsx        |  17 +++
 src/pages/Chat/TeacherChatPanel.tsx           |  51 +++++--
 src/pages/Chat/TeacherModelSelect.tsx         |  60 ++++++++
 tests/e2e/fixtures/teacher-reply-api.ts       |   1 +
 tests/e2e/teacher-reply-layout.spec.ts        |  17 +++
 tests/unit/coding-teacher-cloud.test.ts       |  16 +++
 .../unit/coding-teacher-model-catalog.test.ts |  40 ++++++
 tests/unit/coding-teacher-ui.test.tsx         |  18 +++
 tests/unit/coding-teacher.test.ts             |  20 +++
 tests/unit/teacher-composer-voice.test.tsx    | 130 ++++++++++++++++++
 20 files changed, 517 insertions(+), 37 deletions(-)
 create mode 100644 .project-docs/30-worklog/tasks/20260929-teacher-composer-4f829ac1.md
 create mode 100644 electron/coding-teacher/model-catalog.ts
 create mode 100644 src/hooks/use-teacher-model-choice.ts
 create mode 100644 src/pages/Chat/ComposerVoiceButton.tsx
 create mode 100644 src/pages/Chat/TeacherModelSelect.tsx
 create mode 100644 tests/unit/coding-teacher-model-catalog.test.ts
 create mode 100644 tests/unit/teacher-composer-voice.test.tsx

diff --git a/.project-docs/30-worklog/tasks/20260929-teacher-composer-4f829ac1.md b/.project-docs/30-worklog/tasks/20260929-teacher-composer-4f829ac1.md
new file mode 100644
index 00000000..860db9cf
--- /dev/null
+++ b/.project-docs/30-worklog/tasks/20260929-teacher-composer-4f829ac1.md
@@ -0,0 +1,56 @@
+# Task: Add teacher voice input and model selection
+
+## Identity
+
+- Task ID: 20260929-teacher-composer-4f829ac1
+- Mode: Feature
+- Branch: codex/20260929-teacher-composer-4f829ac1-teacher-composer
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-teacher-composer-4f829ac1
+- Base commit: cd1ba41e214ebe4a1f698be0dde14591bb7b87df
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Add microphone transcription and model selection to every teacher composer using operation-composer patterns. Explicit selection uses the chosen model's default thinking settings; no new reasoning override protocol.
+
+## Intent And Constraints
+
+- Preserve account/teacher history, drafts, timestamps, per-turn published configuration and student billing; no subagents, paid test prompts, cloud publishing, main merge/push or desktop activation.
+
+## Outcome
+
+- Shared operation/teacher microphone button and voice hook; transcripts append to the latest draft and never auto-send. Scope/account changes and unmount cancel late results. Toolbar wraps at narrow widths.
+- Main exposes a credential-free catalog intersecting cloud capability and account text models; each send revalidates the choice. Per-account/teacher selection is remembered, and requests freeze modelId with existing retry identity. Default follows the published teacher; persona, resources, history, versions and billing remain intact. Automatic check-ins keep their cloud configuration.
+- Paired Yuxi commit 489549c and WS commit 0509e0ba implement optional model_id, immutable run snapshots, idempotency and signed teacher_model_id billing. They are not merged, pushed or deployed. Old cloud/gateway capability is explicit and never silently ignores a choice.
+- Trial updated in the background, PID 32583, preserving its existing empty-work overlay 0167d36 in a separate build artifact. Peer worktrees remain unchanged. Live API reports selection unsupported until cloud rollout; microphone and selector UI are present. No real recording, paid prompt, cloud configuration publishing or desktop activation performed.
+
+## Verification
+
+- Typecheck, full lint (0 errors / 8 existing warnings), production Vite/Main build passed. Full suite: 267 files / 2694 tests passed / 3 skipped, followed by 1 pressure test passed. After the final toolbar wrap adjustment and one extra model-catalog filter test: 83 focused tests and both 319px/508px browser layout cases passed. No new full-suite failures remain.
+- Trial artifact including the already-running empty-work overlay: typecheck/build and 65 preview regressions passed. Same account, selected teacher, route, 14 operation messages, teacher history and 14 draft entries verified; no desktop focus acquisition during monitored restart. Browser screenshots and live composer screenshot inspected.
+- Server verification: Yuxi 26 relevant unit/HTTP/SDK tests, engineering gate and 62 validator tests; WS 79 relevant tests passed / 1 PostgreSQL-environment case skipped. Complete PostgreSQL/Redis/worker integration and paid provider calls are not run. No independent subagent review, per user instruction.
+
+## Follow-ups
+
+- Cloud rollout needs separate authorization beyond the temporary app: WS API first, then Yuxi API/worker. Complete service-environment integration before production release. No teacher republish or history migration is needed. Keep the running trial source and profile.
+
+## Promotion Candidates
+
+- Target: teacher/model capability ADR and architecture. Proposal: explicit per-question teacher model with cloud capability gating, unchanged persona/resources/version/payer; voice is draft-only. Evidence: service/UI/billing tests above. Future impact: three-part rollout and immutable retry choice. Earlier cloud-only model ownership is extended by this user's explicit selection request; canonical promotion belongs to integration.
+
+
+## Project Context Loaded
+
+- Task 20260929-teacher-composer-4f829ac1, feature, owns this worktree and branch per Identity at base cd1ba41. App worktree creation returned Not a git repository for the parent chat directory; official task_context isolated from the verified previous trial source. Start/status passed.
+- Read entry/memory index, active task, positioning, current integrated snapshot, decision index and teacher/model-capability ADRs, system overview/module map/data flow, domain/success criteria and evidence/reflection/commitment indexes. Read every peer scope/constraints/promotion record through status registry. Current source includes newer approved timestamp/bubble/community changes than the integrated snapshot.
+- Teacher capability/persona is cloud-owned, with per-account/teacher local history, student-paid runs and per-question version/project/read-only context. The user now explicitly wants client model selection, extending the earlier cloud-only model choice while preserving cloud persona/resources and billing. Main remains the validation and credential boundary.
+- Peers: earlier trial/community work retained for running app; teacher-help-label and formal application release work remain separate; empty-work-preview and operation language work are not in this baseline. No identified semantic conflict; retain all current labels/UI and leave peer checkouts unchanged.
+- Unknown dependency: current cloud /questions client has no model override field; inspect the committed Yuxi contract before deciding server support. No cosmetic model dropdown that silently keeps another model.
+- Gate: Passed for client work and dependency investigation.
+
+## Plan
+
+1. Reuse the operation voice hook/button and input safeguards, scoped to account/teacher/context; keep transcription as an editable draft.
+2. Trace cloud model capability/override support and implement an authoritative model selection contract, preserving request identity, version binding, student billing and history; selected models use their defaults.
+3. Verify account/teacher switches, requests/retries, unavailable models and responsive composer layout; run required checks and update the trial in the background when the working integration is ready.
diff --git a/README.md b/README.md
index 03151c9e..9ae8fe05 100644
--- a/README.md
+++ b/README.md
@@ -188,6 +188,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 智能体输入裁剪区分两种计量：本地模型以约每 2 个 UTF-8 字节估算 1 Token，并计入工具与读取预留；这不是精确分词或扣费依据，模型上限与实际 usage 仍由服务端拥有。云端沿用 query 字节上限，以完整 JSON 转义后的大小裁剪来源节选。智能体指令、当前问题和明确引用不会被静默裁掉；固定配置或回复协议超限时明确提示调整配置，避免让学生反复缩短短问题或新建话题。完整来源仍可由只读工具按需读取。
 - `tests/fixtures/teacher-guidance-examples.json` 保留人工样例作为旧回复的读取兼容资料，仅验证正文和快捷回复投影，不加载到运行时，也不代表真实模型教学效果已验收。云端定义由 Yuxi 维护并由运营显式同步下发；本地代码修改不会自动改写云端配置或学生已接受问题的固定发布版本。
 - 下发智能体的图标随发布版本保存，顶栏、咨询面板、欢迎区和消息使用定义中的 `icon_url`；未设置或图片加载失败时使用内置头像。运营在 Yuxi 更换图标后需同步下发配置，联系人使用当前下发的名称和图标；每轮执行仍记录实际发布版本。相对图片地址由服务端使用 Yuxi 公网入口补全。
+- 老师输入框复用操作 Agent 的麦克风，语音识别只追加当前草稿，不自动发送；切换账号、老师、项目或来源、关闭面板时丢弃过期识别。模型选择按账号和老师记忆，默认跟随老师配置；显式模型仅用于后续手动提问，思考使用模型默认设置。每轮冻结选择及幂等身份，保留发布人设、资源、版本与学生计费；主动检查继续遵循云端老师配置。模型目录与准入由 Main/云端验证，旧云服务显示待更新，不静默忽略选择。需先更新 WS 模型授权接口，再更新 Yuxi API/worker，客户端不会修改或发布云端配置。
 - 咨询聊天和文字草稿按当前云端账号、已下发智能体保存；切换项目或操作对话仍延续同一个聊天，每轮发送冻结当时的项目、来源和发布版本并检查启停。引用保留原项目/来源，切换后必须移除失配引用再发送；旧组件仅保留原始归档，不恢复交互。历史按50轮分页，流式事件只传当前轮；本机每轮独立原子落盘，索引保存消息摘要，旧轮次可通过只读工具按ID读取。可确认归属的旧话题按来源ID幂等迁入，原文件保留；“旧记录”入口只读查看升级前项目/来源话题。项目、Pi来源或版本变化，以及首次从旧组件协议升级时，切换内部云线程并带入有预算的近期正文和快捷回复，同一段由Yuxi原生历史压缩管理上下文。此版聊天历史在本机保存，不提供跨设备同步。关闭面板或切换会话不取消已接受的问题，退出账号会中止。请求先落盘再调用模型，同一请求标识不重复发送，重启后未完成请求标记中断。云端断线按游标和持久状态恢复；停止或退出账号会取消原云端问题，下次提问先停止旧的未完成问题再绑定新上下文。只接收云端主线程回答，子智能体文本不混入正文。没有操作对话时也可咨询，但无操作文本上下文。
 - 删除操作对话会停止正在使用该来源的回复，保留项目级咨询历史；归档来源需先恢复后才能引用。原有来源会话级智能体 API 与存储保持兼容，原路径历史不自动迁移到新项目级咨询栏。运营草稿试聊仍使用 `niancode://coding-teacher/preview?draft_revision=N` 打开独立示例上下文，不读取学生项目，要求桌面当前账号具有运营权限。
 
diff --git a/electron/api/routes/coding-teacher.ts b/electron/api/routes/coding-teacher.ts
index 23bd9de0..f45777dd 100644
--- a/electron/api/routes/coding-teacher.ts
+++ b/electron/api/routes/coding-teacher.ts
@@ -32,10 +32,11 @@ export async function handleCodingTeacherRoutes(
   const role = projectTopics?.[2] === 'friend' ? 'friend' : undefined;
   const config = url.pathname === '/api/coding/teacher/config' || url.pathname === '/api/coding/friend/config';
   const catalog = url.pathname === '/api/coding/teacher/teachers';
+  const models = url.pathname === '/api/coding/teacher/models';
   const draft = url.pathname === '/api/coding/teacher-preview';
   const pending = url.pathname === '/api/coding/teacher-preview/pending-link';
-  if (!legacy && !conversation && !source && !preview && !projectTopics && !checkIn && !config && !catalog && !draft && !pending) return false;
-  if ((config || catalog || draft || pending) && req.method !== 'GET') {
+  if (!legacy && !conversation && !source && !preview && !projectTopics && !checkIn && !config && !catalog && !models && !draft && !pending) return false;
+  if ((config || catalog || models || draft || pending) && req.method !== 'GET') {
     sendJson(res, 405, { error: '不支持此操作。' });
     return true;
   }
@@ -78,6 +79,12 @@ export async function handleCodingTeacherRoutes(
       ));
       return true;
     }
+    if (models) {
+      const runtime = url.searchParams.get('runtime');
+      if (runtime !== 'local' && runtime !== 'yuxi') throw new TeacherError(422, 'teacher_runtime_invalid', '模型来源无效。');
+      sendJson(res, 200, await service.models(runtime));
+      return true;
+    }
     if (catalog) {
       sendJson(res, 200, await service.catalog());
       return true;
diff --git a/electron/coding-teacher/cloud-runner.ts b/electron/coding-teacher/cloud-runner.ts
index 3958ff05..5c213b10 100644
--- a/electron/coding-teacher/cloud-runner.ts
+++ b/electron/coding-teacher/cloud-runner.ts
@@ -251,6 +251,7 @@ export function prepareCloudTeacher(
           '/questions',
           {
             teacher_version: currentRequest?.teacherVersion ?? topic.version,
+            ...(currentRequest?.modelId ? { model_id: currentRequest.modelId } : {}),
             thread_id: currentRequest?.runtimeThreadId ?? topic.id,
             request_id: requestId,
             query,
diff --git a/electron/coding-teacher/model-catalog.ts b/electron/coding-teacher/model-catalog.ts
new file mode 100644
index 00000000..7a592dd0
--- /dev/null
+++ b/electron/coding-teacher/model-catalog.ts
@@ -0,0 +1,38 @@
+import type { TeacherModelCatalog } from '../../shared/coding-teacher';
+import { normalizeManagedModelCatalog } from '../../shared/managed-model-capabilities';
+import { teacherCloudRequest, assertTeacherAccount, TeacherError, type TeacherAccount } from './config-client';
+import { teacherCloudTransport } from './cloud-runner';
+
+export function validateTeacherModelId(value: unknown): string | undefined {
+  if (value === undefined) return undefined;
+  if (typeof value !== 'string' || !value.trim() || value.length > 200 || value !== value.trim())
+    throw new TeacherError(422, 'teacher_model_invalid', '请选择有效的模型。');
+  return value;
+}
+
+/** Main strips credentials; each selected model is revalidated when the question is accepted. */
+export async function teacherModelCatalog(account: TeacherAccount, runtime: 'local' | 'yuxi'): Promise<TeacherModelCatalog> {
+  if (runtime === 'yuxi') {
+    let result;
+    try { result = await teacherCloudTransport(account).json('/models'); }
+    catch (error) {
+      if (error instanceof TeacherError && error.status === 404) return {
+        supported: false, models: [], message: '老师服务更新后即可切换模型，目前使用老师配置。',
+      };
+      throw error;
+    }
+    assertTeacherAccount(account);
+    if (result.model_selection === false) return { supported: false, models: [], message: '老师服务更新后即可切换模型，目前使用老师配置。' };
+    if (result.model_selection !== true || !Array.isArray(result.models)
+      || result.models.some(item => !item || typeof item !== 'object' || typeof item.id !== 'string' || !item.id || item.id.length > 200))
+      throw new TeacherError(502, 'teacher_models_invalid', '模型列表暂不可用，请重试。');
+    const local = await teacherModelCatalog(account, 'local');
+    const textModels = new Set(local.models.map(item => item.id));
+    return { supported: true, models: result.models.filter(item => textModels.has(item.id)).map(item => ({ id: item.id as string })) };
+  }
+  const config = await teacherCloudRequest<{ models: string[]; model_capabilities_v2: unknown }>(account, '/api/auth/me/model-config');
+  const catalog = normalizeManagedModelCatalog(config.model_capabilities_v2, config.models);
+  assertTeacherAccount(account);
+  return { supported: true, models: config.models.filter(id => catalog?.models[id]?.inputModalities?.includes('text')
+    && catalog.models[id]?.outputModalities?.includes('text')).map(id => ({ id })) };
+}
diff --git a/electron/coding-teacher/service.ts b/electron/coding-teacher/service.ts
index b255fe80..fd34da2d 100644
--- a/electron/coding-teacher/service.ts
+++ b/electron/coding-teacher/service.ts
@@ -32,6 +32,7 @@ import { TeacherConversationStore } from './conversation-store';
 import { readJsonFile } from '../coding-projects/atomic-json';
 import { compileTeacherContext } from './context';
 import { prepareTeacherModel } from './model-runner';
+import { teacherModelCatalog, validateTeacherModelId } from './model-catalog';
 import { prepareCloudTeacher } from './cloud-runner';
 import { readTeacherSource } from './source-reader';
 import { applyTeacherReply, teacherReplyInstructions } from './reply';
@@ -59,6 +60,7 @@ export interface TeacherServiceOptions {
   prepareModel?: typeof prepareTeacherModel;
   prepareCloud?: typeof prepareCloudTeacher;
   catalog?: typeof teacherCatalog;
+  models?: typeof teacherModelCatalog;
   readSource?(scope: TeacherScope): Promise<TeacherSourceContext>;
 }
 export class CodingTeacherService {
@@ -100,6 +102,9 @@ export class CodingTeacherService {
       : null;
     return { ...status, definition: published?.payload ?? null };
   }
+  async models(runtime: 'local' | 'yuxi') {
+    return (this.options.models ?? teacherModelCatalog)(await this.account(), runtime);
+  }
   async catalog() {
     return (this.options.catalog ?? teacherCatalog)(await this.account());
   }
@@ -415,6 +420,7 @@ export class CodingTeacherService {
     checkIn?: { source: TeacherSourceContext; fingerprint: string }
   ): Promise<TeacherTopic> {
     teacherTopicId(input.requestId);
+    const modelId = validateTeacherModelId(input.modelId);
     const intent = input.intent === undefined ? 'question' : input.intent;
     const structuredReply = intent !== 'check-in';
     if (!['question', 'suggestions', 'guided-help', 'check-in'].includes(intent) || (intent === 'check-in' && !checkIn))
@@ -452,6 +458,7 @@ export class CodingTeacherService {
       if (existing) {
         if (
           existing.text !== input.text ||
+          existing.modelId !== modelId ||
           (scope.agentId && existing.projectId !== scope.projectId) ||
           (existing.intent ?? 'question') !== intent ||
           JSON.stringify(existing.references) !== JSON.stringify(refs) ||
@@ -479,6 +486,7 @@ export class CodingTeacherService {
         const previous = topic.requests.at(-1);
         const reuse = previous && !previous.origin && previous.projectId === scope.projectId
           && previous.sourceConversationId === input.sourceConversationId
+          && previous.modelId === modelId
           && previous.presentation === 'reply-v1'
           && previous.teacherVersion === selected.version && previous.runtimeThreadId;
         newConversationSegment = !reuse;
@@ -545,6 +553,15 @@ export class CodingTeacherService {
         return structuredClone(ref);
       });
       const isCloud = topic.definition.runtime === 'yuxi';
+      if (modelId) {
+        const models = await (this.options.models ?? teacherModelCatalog)(account, isCloud ? 'yuxi' : 'local');
+        if (!models.supported || !models.models.some(item => item.id === modelId))
+          throw new TeacherError(422, 'teacher_model_unavailable', models.message ?? '这个模型暂不可用，请重新选择。');
+        this.assertAccount(account);
+      }
+      const modelDefinition = modelId
+        ? { ...topic.definition, model: { model_id: modelId, reasoning_choice: { mode: 'default' as const } } }
+        : topic.definition;
       if (!isCloud && !topic.definition.system_prompt.trim())
         throw new TeacherError(422, 'teacher_definition_invalid', '请先配置智能体的系统提示词。');
       const access = scope.projectId === 'preview' ? undefined : {
@@ -573,7 +590,7 @@ export class CodingTeacherService {
             topic.revision++;
             this.events.emit(key, structuredClone(topic));
           })
-        : await (this.options.prepareModel ?? prepareTeacherModel)(account, topic.definition,
+        : await (this.options.prepareModel ?? prepareTeacherModel)(account, modelDefinition,
           access,
           { finalOnly: structuredReply });
       if (checkIn) this.assertAccount(account);
@@ -614,6 +631,7 @@ export class CodingTeacherService {
         text: input.text,
         references,
         createdAt: new Date().toISOString(),
+        ...(modelId ? { modelId } : {}),
         sourceCursor: source.cursor,
         sourceCapturedAt: source.capturedAt,
         includedSourceMessageIds: compiled.includedSourceMessageIds,
diff --git a/shared/coding-teacher.ts b/shared/coding-teacher.ts
index 00b21150..46f6cde3 100644
--- a/shared/coding-teacher.ts
+++ b/shared/coding-teacher.ts
@@ -71,6 +71,8 @@ export interface TeacherRequest {
   projectId?: string;
   projectName?: string;
   teacherVersion?: number;
+  /** Explicit per-question model; absent follows the published teacher configuration. */
+  modelId?: string;
   runtimeThreadId?: string;
   origin?: { projectId: string; topicId: string; requestId: string };
   /** discussion-v1 is retained only to identify historical replies. */
@@ -147,7 +149,13 @@ export interface TeacherTopicList {
   items: Array<{ id: string; title: string; updatedAt: string; version: number; teacherId?: string; legacyRole?: 'friend'; legacySourceId?: string }>;
   lastSelectedTopicId: string | null;
 }
+export interface TeacherModelCatalog {
+  supported: boolean;
+  models: Array<{ id: string }>;
+  message?: string;
+}
 export interface TeacherSend {
+  modelId?: string;
   projectId?: string;
   intent?: TeacherRequestIntent;
   sourceConversationId?: string;
diff --git a/src/hooks/use-teacher-model-choice.ts b/src/hooks/use-teacher-model-choice.ts
new file mode 100644
index 00000000..8b280cc1
--- /dev/null
+++ b/src/hooks/use-teacher-model-choice.ts
@@ -0,0 +1,20 @@
+import { useState } from 'react';
+
+function readModel(key: string): string | undefined {
+  try {
+    const value = localStorage.getItem(key);
+    return value && value.length <= 200 ? value : undefined;
+  } catch { return undefined; }
+}
+
+export function useTeacherModelChoice(scope: string) {
+  const key = 'makelore-teacher-model:' + scope;
+  const [choice, setChoice] = useState(() => ({ key, modelId: readModel(key) }));
+  const modelId = choice.key === key ? choice.modelId : readModel(key);
+  const select = (id: string | undefined) => {
+    setChoice({ key, modelId: id });
+    try { if (id) localStorage.setItem(key, id); else localStorage.removeItem(key); } catch { /* Current window retains the choice. */ }
+  };
+  return { modelId, select };
+}
+
diff --git a/src/lib/coding-teacher.ts b/src/lib/coding-teacher.ts
index a543bcac..2d1267c7 100644
--- a/src/lib/coding-teacher.ts
+++ b/src/lib/coding-teacher.ts
@@ -1,5 +1,6 @@
 import { hostApiFetch, createHostEventSource, ensureHostApiToken } from './host-api';
 import type {
+  TeacherModelCatalog,
   TeacherAvailability,
   TeacherCheckInInput,
   TeacherCheckInResult,
@@ -24,6 +25,7 @@ export function legacyTopicBase(base: string, legacyFriend: boolean) {
   return legacyFriend ? base.replace(/agent-topics$/, 'friend-topics') : base;
 }
 export const teacherApi = {
+  models: (runtime: 'local' | 'yuxi') => hostApiFetch<TeacherModelCatalog>('/api/coding/teacher/models?runtime=' + runtime),
   legacyHistory: (projectId: string) => hostApiFetch<TeacherTopicList>(`/api/coding/projects/${encodeURIComponent(projectId)}/agent-history`),
   legacyRead: (projectId: string, item: TeacherTopicList['items'][number]) => hostApiFetch<TeacherTopic>(
     `/api/coding/projects/${encodeURIComponent(projectId)}/agent-history/${encodeURIComponent(item.id)}?source=${encodeURIComponent(item.legacySourceId ?? 'project')}&friend=${item.legacyRole === 'friend'}`),
diff --git a/src/pages/Chat/CodingComposer.tsx b/src/pages/Chat/CodingComposer.tsx
index 4c65f534..b9ed8023 100644
--- a/src/pages/Chat/CodingComposer.tsx
+++ b/src/pages/Chat/CodingComposer.tsx
@@ -1,4 +1,4 @@
-import { LoaderCircle, Mic, Plus, RotateCcw, Send, Square, X } from 'lucide-react';
+import { LoaderCircle, Plus, RotateCcw, Send, Square, X } from 'lucide-react';
 import { useEffect, useRef } from 'react';
 import { useProviderStore } from '@/stores/providers';
 import { Button } from '@/components/ui/button';
@@ -14,6 +14,7 @@ import type {
 } from '@/types/coding-conversation';
 import type { CodingConversationMetadata } from '@/types/coding-project';
 import { CodingComposerRuntimeControls } from './CodingComposerRuntimeControls';
+import { ComposerVoiceButton } from './ComposerVoiceButton';
 
 export interface CodingComposerProps {
   value: string;
@@ -236,29 +237,7 @@ export function CodingComposer({
                 onRefresh={onRefreshRuntime}
               />
             )}
-            <Button
-              type="button"
-              variant="ghost"
-              className={cn(
-                'h-8 w-8 shrink-0 rounded-full bg-transparent p-0 text-muted-foreground shadow-none hover:bg-surface-subtle hover:text-foreground',
-                voiceInput.state !== 'idle' && 'bg-surface-subtle text-foreground',
-              )}
-              disabled={!voiceInput.canToggle}
-              aria-busy={voiceInput.state === 'transcribing'}
-              aria-label={voiceInput.state === 'recording'
-                ? '停止语音输入'
-                : voiceInput.state === 'transcribing'
-                  ? '正在识别语音'
-                  : '语音输入'}
-              title={voiceInput.supported ? '语音输入' : '当前环境不支持语音输入'}
-              onClick={() => void voiceInput.toggle()}
-            >
-              {voiceInput.state === 'transcribing'
-                ? <LoaderCircle className="h-4 w-4 animate-spin" aria-hidden="true" />
-                : voiceInput.state === 'recording'
-                  ? <Square className="h-3.5 w-3.5 fill-current" aria-hidden="true" />
-                  : <Mic className="h-4 w-4" aria-hidden="true" />}
-            </Button>
+            <ComposerVoiceButton voiceInput={voiceInput} />
             <Button
               type={showAbort ? 'button' : 'submit'}
               className={cn(
diff --git a/src/pages/Chat/ComposerVoiceButton.tsx b/src/pages/Chat/ComposerVoiceButton.tsx
new file mode 100644
index 00000000..22c6adac
--- /dev/null
+++ b/src/pages/Chat/ComposerVoiceButton.tsx
@@ -0,0 +1,17 @@
+import { LoaderCircle, Mic, Square } from 'lucide-react';
+import { Button } from '@/components/ui/button';
+import { cn } from '@/lib/utils';
+import type { useWorksVoiceInput } from '@/hooks/use-works-voice-input';
+
+export function ComposerVoiceButton({ voiceInput }: { voiceInput: ReturnType<typeof useWorksVoiceInput> }) {
+  return <Button type="button" variant="ghost"
+    className={cn('h-8 w-8 shrink-0 rounded-full bg-transparent p-0 text-muted-foreground shadow-none hover:bg-surface-subtle hover:text-foreground',
+      voiceInput.state !== 'idle' && 'bg-surface-subtle text-foreground')}
+    disabled={!voiceInput.canToggle} aria-busy={voiceInput.state === 'transcribing'}
+    aria-label={voiceInput.state === 'recording' ? '停止语音输入' : voiceInput.state === 'transcribing' ? '正在识别语音' : '语音输入'}
+    title={voiceInput.supported ? '语音输入' : '当前环境不支持语音输入'} onClick={() => void voiceInput.toggle()}>
+    {voiceInput.state === 'transcribing' ? <LoaderCircle className="h-4 w-4 animate-spin" aria-hidden="true" />
+      : voiceInput.state === 'recording' ? <Square className="h-3.5 w-3.5 fill-current" aria-hidden="true" />
+        : <Mic className="h-4 w-4" aria-hidden="true" />}
+  </Button>;
+}
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index 87e610c8..ea6301a3 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -14,6 +14,10 @@ import type {
 import { TeacherAvatar } from './TeacherAvatar';
 import { TeacherReply } from './TeacherReply';
 import { MessageTimestamp } from './MessageTimestamp';
+import { ComposerVoiceButton } from './ComposerVoiceButton';
+import { useWorksVoiceInput } from '@/hooks/use-works-voice-input';
+import { TeacherModelSelect } from './TeacherModelSelect';
+import { useTeacherModelChoice } from '@/hooks/use-teacher-model-choice';
 
 // Preserve loaded pages and the reading anchor while moving between contacts.
 // Durable messages remain Main-owned; this is only the current window's view.
@@ -24,8 +28,8 @@ const messageOrderKey = (request: TeacherTopic['requests'][number]) => request.o
 function restorePendingSend(saved?: TeacherSend, legacyProjectId?: string): TeacherSend | null {
   if (!saved) return null;
   // Keep an interrupted send retryable without restoring retired UI protocol fields.
-  const { requestId, text, references, intent, sourceConversationId, projectId } = saved;
-  return { requestId, text, references, intent, sourceConversationId, ...(projectId || legacyProjectId ? { projectId: projectId ?? legacyProjectId } : {}) };
+  const { requestId, text, references, intent, sourceConversationId, projectId, modelId } = saved;
+  return { requestId, text, references, intent, sourceConversationId, ...(modelId ? { modelId } : {}), ...(projectId || legacyProjectId ? { projectId: projectId ?? legacyProjectId } : {}) };
 }
 
 export function TeacherChatPanel({
@@ -131,6 +135,8 @@ export function TeacherChatPanel({
     ? selectedTeacher?.definition ?? selectedAgent?.definition ?? localDefinition
     : topic?.definition ?? (catalogState
     ? selectedTeacher?.definition ?? selectedAgent?.definition ?? catalogState.config.definition : localDefinition);
+  const modelScope = `${account}:${selectedAgentId ?? definition?.config_id ?? definition?.teacher_id ?? 'teacher'}:${draftRevision ?? 'published'}`;
+  const modelChoice = useTeacherModelChoice(modelScope);
   const topicEnabled = legacyFriend || legacyView ? false : !topic ? enabled
     : topic.definition.config_id
       ? teachers.some((item) => item.teacher_id === topic.definition.config_id)
@@ -394,7 +400,7 @@ export function TeacherChatPanel({
     const questionSourceId = retry
       ? retry.sourceConversationId ?? (continuous || topic?.sourceConversationId === 'project' ? undefined : topic?.sourceConversationId)
       : sourceId;
-    if (!question.trim() || busy || sendInFlight.current || !topicEnabled || topicRef.current?.requests.some((request) => ['preparing', 'running'].includes(request.status))) return;
+    if (voiceInput.state !== 'idle' || !question.trim() || busy || sendInFlight.current || !topicEnabled || topicRef.current?.requests.some((request) => ['preparing', 'running'].includes(request.status))) return;
     if (continuous && !retry && questionReferences.length && (referenceScope.projectId !== projectId || referenceScope.sourceId !== sourceId)) {
       setError('引用来自另一个项目或操作对话，请切回来源，或移除引用后再提问。'); return;
     }
@@ -441,6 +447,7 @@ export function TeacherChatPanel({
           ? previous
           : {
             requestId: crypto.randomUUID(), text: question, references: questionReferences,
+            ...((retry ? retry.modelId : modelChoice.modelId) ? { modelId: retry ? retry.modelId : modelChoice.modelId } : {}),
             ...(continuous ? { projectId } : {}),
             ...(action?.intent ? { intent: action.intent } : {}),
             ...(questionSourceId ? { sourceConversationId: questionSourceId } : {}),
@@ -461,8 +468,16 @@ export function TeacherChatPanel({
       }
       if (!continuous) setTopics(await teacherApi.list(base));
     } catch (e) {
-      if (version === generation.current)
+      if (version === generation.current) {
+        const code = (e as { details?: { backendCode?: string } } | null)?.details?.backendCode;
+        // These Main validation failures precede acceptance; allow correcting the selection.
+        // Uncertain transport failures retain the original request and model to avoid double charging.
+        if (code === 'teacher_model_unavailable' || code === 'teacher_model_invalid') {
+          pending.current = null;
+          persistDraft(draftRef.current.text, draftRef.current.references);
+        }
         setError(e instanceof Error ? e.message : '提问失败，请保留问题后重试');
+      }
     } finally {
       sendInFlight.current = false;
       if (version === generation.current) setBusy(false);
@@ -473,7 +488,18 @@ export function TeacherChatPanel({
   );
   const helpUnavailable = busy || !topicEnabled || Boolean(running);
   const askForSuggestions = () => void send({ text: '帮我整体看🧠', intent: 'suggestions' });
-  const changeText = (next: string) => { setText(next); persistDraft(next, references, pending.current); };
+  const changeText = (next: string) => { draftRef.current.text = next; setText(next); persistDraft(next, references, pending.current); };
+  const voiceInput = useWorksVoiceInput({
+    enabled: !busy && topicEnabled && !running,
+    scopeKey: `${modelScope}:${projectId}:${sourceId}:${topic?.id ?? 'new'}:${modelChoice.modelId ?? 'default'}`,
+    onTranscript: transcript => {
+      const current = draftRef.current.text;
+      const next = current.trim() ? `${current.trimEnd()}\n${transcript}` : transcript;
+      if (next.length > 6000) { setError('文字超过 6000 字，请缩短输入后重新录音。'); return; }
+      changeText(next);
+    },
+  });
+
   const removeReferences = () => { setReferences([]); persistDraft(text, [], pending.current); };
   const questions = definition?.suggested_questions ?? [];
   return (
@@ -540,7 +566,7 @@ export function TeacherChatPanel({
               : request.status === 'completed' && <>
                 <TeacherReply text={request.response} />
               </>}
-            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-retry">帮我整体看🧠</button>}
+            {['failed', 'cancelled', 'interrupted'].includes(request.status) && <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-retry">帮我整体看🧠</button>}
           </> : request.response ? <TeacherReply text={request.response} /> : <div className="text-[13px] leading-7">{['running', 'preparing'].includes(request.status) ? <span role="status" className="inline-flex items-center gap-2 text-muted-foreground"><Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />{label}正在想…</span> : ['cancelled', 'interrupted'].includes(request.status) ? '这次先停在这里。想继续时可以再说说。' : ''}</div>}
           <MessageTimestamp value={request.finishedAt} pending={['running', 'preparing'].includes(request.status)} />
           </div>
@@ -584,12 +610,17 @@ export function TeacherChatPanel({
           <textarea ref={inputRef} aria-label={`向${label}提问`} value={text} disabled={busy} maxLength={6000} onChange={(e) => changeText(e.target.value)} placeholder="和老师聊聊" rows={2}
             onKeyDown={(e) => { if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) { e.preventDefault(); void send(); } }}
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
-          <div className="mt-2 flex min-h-[68px] items-center justify-between gap-2" data-testid="consultation-composer-actions">
-            <div className="min-w-0 flex-1">
-              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>}
+          <div className="mt-2 flex min-h-[68px] flex-wrap items-center justify-between gap-x-2 gap-y-2" data-testid="consultation-composer-actions">
+            <div className="min-w-0 grow">
+              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>}
             </div>
+            <div className="ml-auto flex min-w-0 max-w-full items-center gap-1" data-testid="teacher-composer-runtime-controls">
+              <TeacherModelSelect key={modelScope + (definition?.runtime ?? 'local')} runtime={definition?.runtime ?? 'local'} scope={modelScope} defaultModel={definition?.model.model_id}
+                modelId={modelChoice.modelId} onChange={modelChoice.select} disabled={busy || !topicEnabled || Boolean(running)} />
+              <ComposerVoiceButton voiceInput={voiceInput} />
             {running ? <button type="button" className="rounded-lg border px-3 py-2 text-xs" onClick={() => void teacherApi.cancel(topicBase, endpointId, running.id).then(consume).catch(() => setError('暂时无法停止，请稍后重试。'))}>停止回复</button>
-            : <button type="submit" aria-label="提问" title={busy ? '正在发送…' : '发送'} disabled={busy || !topicEnabled || !text.trim()} className="consultation-send flex h-8 w-8 items-center justify-center rounded-full text-white disabled:opacity-30"><ArrowUp className="h-4 w-4" /></button>}
+            : <button type="submit" aria-label="提问" title={busy ? '正在发送…' : '发送'} disabled={busy || !topicEnabled || !text.trim() || voiceInput.state !== 'idle'} className="consultation-send flex h-8 w-8 shrink-0 items-center justify-center rounded-full text-white disabled:opacity-30"><ArrowUp className="h-4 w-4" /></button>}
+            </div>
           </div>
         </div>
       </form>
diff --git a/src/pages/Chat/TeacherModelSelect.tsx b/src/pages/Chat/TeacherModelSelect.tsx
new file mode 100644
index 00000000..8963a89e
--- /dev/null
+++ b/src/pages/Chat/TeacherModelSelect.tsx
@@ -0,0 +1,60 @@
+import { useEffect, useState } from 'react';
+import * as DropdownMenu from '@radix-ui/react-dropdown-menu';
+import { Check, ChevronDown, LoaderCircle } from 'lucide-react';
+import { Button } from '@/components/ui/button';
+import { teacherApi } from '@/lib/coding-teacher';
+import type { TeacherModelCatalog } from '../../../shared/coding-teacher';
+
+export function TeacherModelSelect({ runtime, scope, defaultModel, modelId, disabled, onChange }: {
+  runtime: 'local' | 'yuxi'; scope: string; defaultModel?: string | null;
+  modelId?: string; disabled: boolean; onChange(id: string | undefined): void;
+}) {
+  const [open, setOpen] = useState(false);
+  const [result, setResult] = useState<TeacherModelCatalog | null>(null);
+  const [error, setError] = useState('');
+  const [loading, setLoading] = useState(false);
+  // Fetch on opening so account changes, availability and a newly deployed service are respected.
+  useEffect(() => {
+    if (!open) return;
+    let alive = true;
+    void teacherApi.models(runtime).then(value => { if (alive) setResult(value); })
+      .catch(() => { if (alive) setError('模型列表暂不可用，请关闭后重试。'); })
+      .finally(() => { if (alive) setLoading(false); });
+    return () => { alive = false; };
+  }, [open, runtime, scope]);
+  const label = modelId ?? defaultModel ?? '老师配置';
+  const itemClass = 'relative flex min-h-8 cursor-default select-none items-center rounded-xl px-2.5 pr-9 outline-none data-[highlighted]:bg-surface-subtle';
+  return <DropdownMenu.Root open={open} onOpenChange={value => {
+    if (value) { setLoading(true); setResult(null); setError(''); }
+    setOpen(value);
+  }}>
+    <DropdownMenu.Trigger asChild>
+      <Button type="button" variant="ghost" disabled={disabled}
+        className="h-8 min-w-0 max-w-48 gap-1 rounded-full bg-transparent px-2 text-xs font-normal shadow-none hover:bg-surface-subtle"
+        aria-label={`老师模型：${label}${modelId ? '' : '，跟随老师配置'}`} title={label}>
+        <span className="min-w-0 truncate text-foreground/85">{label}</span>
+        <span className="shrink-0 text-brand">{modelId ? '模型默认' : '老师配置'}</span>
+        <ChevronDown className="h-3.5 w-3.5 shrink-0 text-muted-foreground" aria-hidden="true" />
+      </Button>
+    </DropdownMenu.Trigger>
+    <DropdownMenu.Portal>
+      <DropdownMenu.Content side="top" align="end" sideOffset={8} collisionPadding={12} aria-label="选择老师模型"
+        className="z-[101] max-h-[min(24rem,var(--radix-dropdown-menu-content-available-height))] w-64 max-w-[calc(100vw-24px)] overflow-y-auto rounded-[18px] border border-border/80 bg-background p-1.5 text-sm shadow-[0_18px_50px_rgba(26,31,42,0.16)] outline-none">
+        <DropdownMenu.Label className="px-2.5 py-2 text-xs text-muted-foreground">用于接下来的老师提问</DropdownMenu.Label>
+        <DropdownMenu.RadioGroup value={modelId ?? ''} onValueChange={value => onChange(value || undefined)}>
+          <DropdownMenu.RadioItem value="" className={itemClass}>跟随老师配置
+            <DropdownMenu.ItemIndicator className="absolute right-2.5"><Check className="h-4 w-4" /></DropdownMenu.ItemIndicator>
+          </DropdownMenu.RadioItem>
+          {result?.supported && result.models.map(model => <DropdownMenu.RadioItem key={model.id} value={model.id} className={itemClass} title={model.id}>
+            <span className="min-w-0 truncate">{model.id}</span>
+            <DropdownMenu.ItemIndicator className="absolute right-2.5"><Check className="h-4 w-4" /></DropdownMenu.ItemIndicator>
+          </DropdownMenu.RadioItem>)}
+        </DropdownMenu.RadioGroup>
+        {loading && <div role="status" className="flex items-center gap-2 px-2.5 py-2 text-xs text-muted-foreground"><LoaderCircle className="h-3.5 w-3.5 animate-spin" />正在读取模型…</div>}
+        {result?.supported && !result.models.length && <p role="status" className="px-2.5 py-2 text-xs text-muted-foreground">暂无可切换的模型，可以继续使用老师配置。</p>}
+        {(error || result?.message || (result?.supported && modelId && !result.models.some(model => model.id === modelId))) &&
+          <p role="status" className="px-2.5 py-2 text-xs leading-5 text-muted-foreground">{error || result?.message || '已选模型暂不可用，请重新选择后再提问。'}</p>}
+      </DropdownMenu.Content>
+    </DropdownMenu.Portal>
+  </DropdownMenu.Root>;
+}
diff --git a/tests/e2e/fixtures/teacher-reply-api.ts b/tests/e2e/fixtures/teacher-reply-api.ts
index 8b4e9084..cc3b446e 100644
--- a/tests/e2e/fixtures/teacher-reply-api.ts
+++ b/tests/e2e/fixtures/teacher-reply-api.ts
@@ -45,6 +45,7 @@ const sentInputs: TeacherSend[] = [];
 Object.defineProperty(window, '__teacherReplyInputs', { value: sentInputs });
 const snapshot = () => { current.revision++; stream.dispatchEvent(new MessageEvent('snapshot', { data: JSON.stringify(current) })); };
 export const teacherApi = {
+  models: async () => ({ supported: true, models: [{ id: 'deepseek-flash' }, { id: 'test-second-model' }] }),
   conversation: async () => ({ topic: structuredClone(current), before: null }),
   seenConversation: async (_agentId: string, requestId: string) => {
     if (current.conversation) current.conversation.seenThrough = requestId;
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index e5680b21..e6fbebe1 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -189,3 +189,20 @@ for (const width of [319, 508]) for (const kind of ['ordinary', 'ideas', 'struct
     expect(errors).toEqual([]);
   });
 }
+
+for (const width of [319, 508]) test(`teacher model selector and microphone fit the composer at ${width}px`, async ({ page }) => {
+  await page.goto(`${url}?kind=rich-text&width=${width}`);
+  const panel = page.getByTestId('teacher-chat-panel');
+  const input = page.getByRole('textbox', { name: '向智能体提问' });
+  await input.fill('语音和选模测试草稿');
+  await panel.getByRole('button', { name: /老师模型/ }).click();
+  await page.getByRole('menuitemradio', { name: 'test-second-model' }).click();
+  await expect(input).toHaveValue('语音和选模测试草稿');
+  await expect(panel.getByRole('button', { name: '语音输入' })).toBeVisible();
+  expect(await panel.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
+  const controls = panel.getByTestId('teacher-composer-runtime-controls');
+  expect(await controls.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
+  await panel.screenshot({ path: test.info().outputPath(`teacher-composer-${width}.png`) });
+  await panel.getByRole('button', { name: '提问', exact: true }).click();
+  expect(await page.evaluate(() => (window as unknown as { __teacherReplyInputs: Array<{modelId?: string}> }).__teacherReplyInputs.at(-1)?.modelId)).toBe('test-second-model');
+});
diff --git a/tests/unit/coding-teacher-cloud.test.ts b/tests/unit/coding-teacher-cloud.test.ts
index a27cfb2f..473b2c21 100644
--- a/tests/unit/coding-teacher-cloud.test.ts
+++ b/tests/unit/coding-teacher-cloud.test.ts
@@ -870,3 +870,19 @@ it('keeps only the cloud main-thread answer while advancing past child events on
   expect(transport.events).toHaveBeenCalledTimes(2);
   expect(streamUrls[1]).toContain('after_seq=2-0');
 });
+
+it('transmits the frozen per-question model while retaining the teacher version', async () => {
+  const f = await fixture();
+  f.topic.requests.push({ id: requestId, modelId: 'selected-model', teacherVersion: 9, text: '问题', references: [], status: 'running',
+    createdAt: 'now', sourceCapturedAt: 'now', sourceCursor: f.access.source.cursor,
+    includedSourceMessageIds: [], omittedMessages: 0, response: '' });
+  const transport: TeacherCloudTransport = {
+    json: vi.fn(async url => url === '/questions'
+      ? { request_id: requestId, run_id: 'run' } : { status: 'completed', output: '已回复' }),
+    events: vi.fn(),
+  };
+  const model = prepareCloudTeacher(f.account, f.topic, requestId, f.access, f.progress, f.saveRequest, transport);
+  await model.run([{ role: 'user', content: '问题' }], new AbortController().signal, vi.fn());
+  expect(transport.json).toHaveBeenCalledWith('/questions', expect.objectContaining({ model_id: 'selected-model', teacher_version: f.topic.version }), expect.anything());
+  expect(f.topic.definition.model.model_id).toBe('deepseek-flash');
+});
diff --git a/tests/unit/coding-teacher-model-catalog.test.ts b/tests/unit/coding-teacher-model-catalog.test.ts
new file mode 100644
index 00000000..2cd18783
--- /dev/null
+++ b/tests/unit/coding-teacher-model-catalog.test.ts
@@ -0,0 +1,40 @@
+// @vitest-environment node
+import { beforeEach, expect, it, vi } from 'vitest';
+import { teacherModelCatalog, validateTeacherModelId } from '../../electron/coding-teacher/model-catalog';
+import { TeacherError } from '../../electron/coding-teacher/config-client';
+const mocks = vi.hoisted(() => ({ json: vi.fn(), request: vi.fn(), assert: vi.fn() }));
+vi.mock('../../electron/coding-teacher/cloud-runner', () => ({ teacherCloudTransport: () => ({ json: mocks.json }) }));
+vi.mock('../../electron/coding-teacher/config-client', async importOriginal => ({
+  ...await importOriginal<typeof import('../../electron/coding-teacher/config-client')>(),
+  teacherCloudRequest: mocks.request, assertTeacherAccount: mocks.assert,
+}));
+const account = { id: 'student', binding: { accountKey: 'student', epoch: 1 } };
+beforeEach(() => { vi.resetAllMocks(); });
+it.each([false, undefined])('does not advertise selection on an older cloud or gateway (%s)', async flag => {
+  if (flag === undefined) mocks.json.mockRejectedValue(new TeacherError(404, 'not_found', 'Not Found'));
+  else mocks.json.mockResolvedValue({ model_selection: flag, models: [] });
+  expect(await teacherModelCatalog(account, 'yuxi')).toMatchObject({ supported: false, models: [] });
+  expect(mocks.request).not.toHaveBeenCalled();
+});
+it('does not turn authentication or transient failures into unsupported capability', async () => {
+  const error = new TeacherError(401, 'expired', '请登录');
+  mocks.json.mockRejectedValue(error);
+  await expect(teacherModelCatalog(account, 'yuxi')).rejects.toBe(error);
+});
+it.each([null, '', ' model ', 123, 'x'.repeat(201)])('rejects malformed explicit model %s', value => {
+  expect(() => validateTeacherModelId(value)).toThrow(TeacherError);
+});
+it('preserves absent model and exact provider ids', () => {
+  expect(validateTeacherModelId(undefined)).toBeUndefined();
+  expect(validateTeacherModelId('provider/model')).toBe('provider/model');
+});
+
+it('returns only shared text models and never exposes gateway credentials', async () => {
+  mocks.json.mockResolvedValue({ model_selection: true, models: [{ id: 'text-model' }, { id: 'image-model' }, { id: 'unlisted' }] });
+  mocks.request.mockResolvedValue({ api_key: 'private', base_url: 'https://private.invalid',
+    models: ['text-model', 'image-model'], model_capabilities_v2: { schema_version: 2, models: {
+      'text-model': { input_modalities: ['text'], output_modalities: ['text'], reasoning: { supported: false, can_disable: false, default_enabled: false, effort_values: [], control_format: 'none' } },
+      'image-model': { input_modalities: ['text'], output_modalities: ['image'], reasoning: { supported: false, can_disable: false, default_enabled: false, effort_values: [], control_format: 'none' } },
+    } } });
+  expect(await teacherModelCatalog(account, 'yuxi')).toEqual({ supported: true, models: [{ id: 'text-model' }] });
+});
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index 608e0a6c..86d6e345 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -3,6 +3,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { TeacherChatPanel } from '@/pages/Chat/TeacherChatPanel';
 import type { TeacherDefinition, TeacherRequest, TeacherSend, TeacherTopic } from '../../shared/coding-teacher';
 const api = vi.hoisted(() => ({
+  models: vi.fn(),
   catalog: vi.fn(),
   config: vi.fn(),
   preview: vi.fn(),
@@ -70,6 +71,7 @@ beforeEach(() => {
   vi.resetAllMocks();
   localStorage.clear();
   streams = new Map();
+  api.models.mockResolvedValue({ supported: true, models: [{ id: 'qwen' }, { id: 'other-model' }] });
   api.config.mockResolvedValue({ enabled: true, published_version: 1, revision: 1, definition });
   api.catalog.mockResolvedValue({ items: [{ teacher_id: 'one', version: 1, definition, is_default: true }] });
   api.conversation.mockResolvedValue({ topic: null, before: null });
@@ -1008,3 +1010,19 @@ describe('merged cloud teacher classroom', () => {
     expect(screen.getByRole('button', { name: '智能体新话题' })).toBeEnabled();
   });
 });
+
+ it('selects a teacher model for the next send and retains it after remount', async () => {
+   const view = render(<TeacherChatPanel projectId="p" sourceId="c" />);
+   await ready();
+   const trigger = screen.getByRole('button', { name: /老师模型/ });
+   fireEvent.keyDown(trigger, { key: 'Enter' });
+   fireEvent.click(await screen.findByRole('menuitemradio', { name: 'other-model' }));
+   fireEvent.change(screen.getByRole('textbox', { name: '向智能体提问' }), { target: { value: '我的想法' } });
+   api.send.mockResolvedValue(first);
+   fireEvent.click(screen.getByRole('button', { name: '提问' }));
+   await waitFor(() => expect(api.send).toHaveBeenCalledWith('p/agent-topics', 'first', expect.objectContaining({ modelId: 'other-model', text: '我的想法' })));
+   view.unmount();
+   render(<TeacherChatPanel projectId="p" sourceId="c" />);
+   await screen.findByRole('button', { name: /老师模型：other-model/ });
+   expect(screen.getByRole('button', { name: '语音输入' })).toBeInTheDocument();
+ });
diff --git a/tests/unit/coding-teacher.test.ts b/tests/unit/coding-teacher.test.ts
index 34df5a95..def75591 100644
--- a/tests/unit/coding-teacher.test.ts
+++ b/tests/unit/coding-teacher.test.ts
@@ -103,6 +103,7 @@ async function fixture({ durableSource = false, sourceContext = context, liveMod
   const prepareCloud = vi.fn((..._args: unknown[]) => ({ inputLimit: 8000, run }));
   const createService = () => new CodingTeacherService({
     projects,
+    models: async () => ({ supported: true, models: [{ id: 'qwen' }, { id: 'other-model' }] }),
     runtime: new InMemoryConversationRuntime(),
     userDataDir: root,
     account: async () => account,
@@ -1659,3 +1660,22 @@ describe('project consultations with selected cloud teachers', () => {
     await vi.waitFor(async () => expect((await f.service.read(scope, topic.id)).requests[0].status).toBe('completed'));
   });
 });
+
+ it.each([false, true])('freezes explicit model without changing teacher definition (cloud=%s)', async cloudTeacher => {
+    const f = await fixture({ cloudTeacher, mockCloud: cloudTeacher });
+    const t = await f.service.create(f.scope, undefined, undefined, cloudTeacher ? 9 : undefined);
+    const input = { requestId: '22222222-2222-4222-8222-222222222222', text: '帮我理解', modelId: 'other-model' };
+    const accepted = await f.service.send(f.scope, t.id, input);
+    expect(accepted.requests[0].modelId).toBe('other-model');
+    expect(accepted.definition.model.model_id).toBe('qwen');
+    if (!cloudTeacher) expect(f.prepareModel.mock.calls[0][1].model).toEqual({ model_id: 'other-model', reasoning_choice: { mode: 'default' } });
+    await expect(f.service.send(f.scope, t.id, { ...input, modelId: 'qwen' })).rejects.toMatchObject({ code: 'teacher_request_conflict' });
+    await f.service.send(f.scope, t.id, input);
+    expect(f.run).toHaveBeenCalledTimes(1);
+    f.finish();
+    await vi.waitFor(async () => expect((await f.service.read(f.scope, t.id)).requests[0].status).toBe('completed'));
+    const restarted = await f.restart();
+    expect((await restarted.read(f.scope, t.id)).requests[0].modelId).toBe('other-model');
+    await expect(restarted.send(f.scope, t.id, { ...input, requestId: '33333333-3333-4333-8333-333333333333', modelId: 'unavailable' })).rejects.toMatchObject({ code: 'teacher_model_unavailable' });
+    expect(f.run).toHaveBeenCalledTimes(1);
+ });
diff --git a/tests/unit/teacher-composer-voice.test.tsx b/tests/unit/teacher-composer-voice.test.tsx
new file mode 100644
index 00000000..4aa31e5b
--- /dev/null
+++ b/tests/unit/teacher-composer-voice.test.tsx
@@ -0,0 +1,130 @@
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { TeacherChatPanel } from '@/pages/Chat/TeacherChatPanel';
+import { useAuthStore } from '@/stores/auth';
+
+const voiceApi = vi.hoisted(() => ({
+  blobToBase64: vi.fn(),
+  convertAudioBlobTo16kMonoWav: vi.fn(),
+  transcribeWorksSpeech: vi.fn(),
+}));
+
+vi.mock('@/lib/voice-recording', () => ({
+  blobToBase64: (...args: unknown[]) => voiceApi.blobToBase64(...args),
+  convertAudioBlobTo16kMonoWav: (...args: unknown[]) => (
+    voiceApi.convertAudioBlobTo16kMonoWav(...args)
+  ),
+}));
+
+vi.mock('@/lib/works-square', async (importOriginal) => ({
+  ...await importOriginal<typeof import('@/lib/works-square')>(),
+  transcribeWorksSpeech: (...args: unknown[]) => voiceApi.transcribeWorksSpeech(...args),
+}));
+
+const api = vi.hoisted(() => ({ send: vi.fn() }));
+vi.mock('@/lib/coding-teacher', () => ({
+  teacherTopicsPath: () => '/teacher', legacyTopicBase: (base: string) => base,
+  teacherApi: {
+    config: async () => ({ enabled: true, definition: { schema_version: 1, teacher_id: 'teacher', name: '老师',
+      description: '', avatar_id: 'avatar-01', welcome_message: '欢迎', suggested_questions: [],
+      system_prompt: '你是老师', skills: [], model: { model_id: 'qwen', reasoning_choice: { mode: 'default' } },
+      limits: { max_input_tokens: 8000, max_output_tokens: 1500 } } }),
+    catalog: async () => ({ items: [] }), list: async () => ({ items: [], lastSelectedTopicId: null }),
+    send: api.send,
+  },
+}));
+const initialAuthState = useAuthStore.getState();
+const initialMediaRecorder = window.MediaRecorder;
+const initialMediaDevices = navigator.mediaDevices;
+
+class MockMediaRecorder {
+  static latest: MockMediaRecorder | null = null;
+  static isTypeSupported(): boolean { return true; }
+  ondataavailable: ((event: { data: Blob }) => void) | null = null;
+  onstop: (() => void) | null = null;
+  state: RecordingState = 'inactive';
+  mimeType = 'audio/webm';
+
+  constructor() {
+    MockMediaRecorder.latest = this;
+  }
+
+  start(): void {
+    this.state = 'recording';
+  }
+
+  stop(): void {
+    this.state = 'inactive';
+    this.ondataavailable?.({ data: new Blob(['voice bytes'], { type: 'audio/webm' }) });
+    this.onstop?.();
+  }
+}
+
+describe('Teacher composer voice input', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    MockMediaRecorder.latest = null;
+    voiceApi.convertAudioBlobTo16kMonoWav.mockResolvedValue(
+      new Blob(['wav bytes'], { type: 'audio/wav' }),
+    );
+    voiceApi.blobToBase64.mockResolvedValue('voice-base64');
+    voiceApi.transcribeWorksSpeech.mockResolvedValue({
+      text: '补充单元测试',
+      model: 'gpt-4o-mini-transcribe',
+    });
+    useAuthStore.setState({
+      initialized: true,
+      loading: false,
+      error: null,
+      accessToken: 'voice-access-token',
+      tokenType: 'Bearer',
+      expiresAt: Date.now() + 60_000,
+      lastActiveAt: Date.now(),
+      canRefresh: true,
+      legacyRefreshToken: null,
+      user: {
+        username: 'coder',
+        userId: 'coder-1',
+        tenantId: null,
+        deptId: null,
+        authorities: [],
+      },
+    });
+  });
+
+  afterEach(() => {
+    useAuthStore.setState(initialAuthState);
+    Object.defineProperty(window, 'MediaRecorder', {
+      configurable: true,
+      value: initialMediaRecorder,
+    });
+    Object.defineProperty(navigator, 'mediaDevices', {
+      configurable: true,
+      value: initialMediaDevices,
+    });
+  });
+
+  it('transcribes into the latest teacher draft without sending, then cancels on source change', async () => {
+    const stopTrack = vi.fn();
+    Object.defineProperty(navigator, 'mediaDevices', { configurable: true,
+      value: { getUserMedia: vi.fn().mockResolvedValue({ getTracks: () => [{ stop: stopTrack }] }) } });
+    Object.defineProperty(window, 'MediaRecorder', { configurable: true, value: MockMediaRecorder });
+    const view = render(<TeacherChatPanel projectId="p" sourceId="source-one" />);
+    const input = await screen.findByRole('textbox', { name: '向智能体提问' });
+    await waitFor(() => expect(screen.getByRole('button', { name: '语音输入' })).toBeEnabled());
+    fireEvent.change(input, { target: { value: '原来的草稿' } });
+    fireEvent.click(screen.getByRole('button', { name: '语音输入' }));
+    await screen.findByRole('button', { name: '停止语音输入' });
+    fireEvent.change(input, { target: { value: '录音时继续写' } });
+    fireEvent.click(screen.getByRole('button', { name: '停止语音输入' }));
+    await waitFor(() => expect(input).toHaveValue('录音时继续写\n补充单元测试'));
+    expect(api.send).not.toHaveBeenCalled();
+    expect(stopTrack).toHaveBeenCalledOnce();
+    fireEvent.click(screen.getByRole('button', { name: '语音输入' }));
+    await screen.findByRole('button', { name: '停止语音输入' });
+    view.rerender(<TeacherChatPanel projectId="p" sourceId="source-two" />);
+    await waitFor(() => expect(stopTrack).toHaveBeenCalledTimes(2));
+    expect(voiceApi.transcribeWorksSpeech).toHaveBeenCalledTimes(1);
+    expect(api.send).not.toHaveBeenCalled();
+  });
+});

From bb96941461a9c355cec28a29ad2125df3addb456 Mon Sep 17 00:00:00 2001
From: brother7 <7brother7@gmail.com>
Date: Tue, 29 Sep 2026 17:04:55 +0800
Subject: [PATCH 15/19] =?UTF-8?q?feat:=20=E6=8C=89=E8=80=81=E5=B8=88?=
 =?UTF-8?q?=E5=8F=91=E5=B8=83=E9=85=8D=E7=BD=AE=E6=B8=B2=E6=9F=93=E5=BF=AB?=
 =?UTF-8?q?=E6=8D=B7=E6=8F=90=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                               |  1 +
 shared/coding-teacher.ts                |  6 +++
 src/pages/Chat/TeacherChatPanel.tsx     | 10 ++++-
 tests/e2e/fixtures/teacher-reply-api.ts |  6 +++
 tests/e2e/teacher-reply-layout.spec.ts  | 29 ++++++++++++++
 tests/unit/coding-teacher-ui.test.tsx   | 50 +++++++++++++++++++++++++
 6 files changed, 100 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 9ae8fe05..7c348439 100644
--- a/README.md
+++ b/README.md
@@ -183,6 +183,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
 - 云端咨询在 local_context 声明 read_protocol=2；需先部署配套 Yuxi API 和 worker，再升级客户端。云端持久累计读取字节及批次，每轮告知模型剩余额度；预算耗尽后消费最后一批结果，并以 tool_choice=none 要求根据现有证据形成答案和说明缺口。Main 限制实际返回量并拒绝第十三批读取，区分读取达到上限、上下文失效及格式无效。服务端对未声明协议的已安装旧客户端保留原工具参数与六批边界。
 - 智能体人设、职责、提示词和 Skills 由发布配置决定。Main 不追加固定教学基线、不生成“小麦”、不清空所选智能体的 Skills，只添加真实工具能力、上下文边界和本轮界面协议。智能体名称叫“老师”“朋友”或“代码顾问”不改变调用路径或权限。
+- 输入框为空时显示当前老师已发布的快捷提示，按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“继续看看👀”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
 - `reply.ts` 只声明正文与快捷回复的输出格式，语言、长度、前缀与表达风格由所选智能体的云端配置决定。客户端不再发送选择、生成、转换或维护展示组件的指令。旧话题内的组件状态、快照和解析诊断作为不透明历史数据原样保留，不校验删除、不恢复交互；旧组件修改路由已移除。
 - 当前输入是按预算截取的所选操作对话已完成分支文本、明确引用、咨询正文和快捷回复，并支持上述只读原文恢复；旧组件状态、快照和未解析原文不加入模型上下文或咨询历史读取结果。没有跨全部操作会话自动读取，也未向操作 Agent 注入咨询共识。提示词不声称看过未提供的画面或试玩过作品。Yuxi 话题经云端原生执行，旧版本地智能体由 Main 调用计费网关；均不创建本地 Pi 编程 worker。
 - 智能体输入裁剪区分两种计量：本地模型以约每 2 个 UTF-8 字节估算 1 Token，并计入工具与读取预留；这不是精确分词或扣费依据，模型上限与实际 usage 仍由服务端拥有。云端沿用 query 字节上限，以完整 JSON 转义后的大小裁剪来源节选。智能体指令、当前问题和明确引用不会被静默裁掉；固定配置或回复协议超限时明确提示调整配置，避免让学生反复缩短短问题或新建话题。完整来源仍可由只读工具按需读取。
diff --git a/shared/coding-teacher.ts b/shared/coding-teacher.ts
index 46f6cde3..ffdd641a 100644
--- a/shared/coding-teacher.ts
+++ b/shared/coding-teacher.ts
@@ -6,6 +6,11 @@ export const TEACHER_CHECK_IN_INTERVAL_MS = 5 * 60 * 1000;
 export const TEACHER_UNCHANGED_CHECK_IN_INTERVAL_MS = 15 * 60 * 1000;
 export type TeacherRequestIntent = 'question' | 'suggestions' | 'guided-help' | 'check-in';
 
+export interface TeacherShortcut {
+  label: string;
+  prompt: string;
+}
+
 export interface TeacherDefinition {
   config_id?: string;
   runtime?: 'local' | 'yuxi';
@@ -18,6 +23,7 @@ export interface TeacherDefinition {
   icon_url?: string | null;
   welcome_message: string;
   suggested_questions: string[];
+  shortcuts?: TeacherShortcut[] | null;
   system_prompt: string;
   skills: Array<{
     id: string;
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index ea6301a3..cd989b21 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -611,8 +611,14 @@ export function TeacherChatPanel({
             onKeyDown={(e) => { if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) { e.preventDefault(); void send(); } }}
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
           <div className="mt-2 flex min-h-[68px] flex-wrap items-center justify-between gap-x-2 gap-y-2" data-testid="consultation-composer-actions">
-            <div className="min-w-0 grow">
-              {!draftRevision && !text.trim() && <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>}
+            <div className="flex max-h-48 min-w-0 grow flex-wrap gap-2 overflow-y-auto pb-1">
+              {!draftRevision && !text.trim() && (definition?.shortcuts == null
+                ? <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>
+                : definition.shortcuts.map((shortcut, index) => <button
+                  key={index} type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'}
+                  onClick={() => void send({ text: shortcut.prompt })}
+                  className="consultation-hint max-w-full whitespace-normal break-words text-left"
+                >{shortcut.label}</button>))}
             </div>
             <div className="ml-auto flex min-w-0 max-w-full items-center gap-1" data-testid="teacher-composer-runtime-controls">
               <TeacherModelSelect key={modelScope + (definition?.runtime ?? 'local')} runtime={definition?.runtime ?? 'local'} scope={modelScope} defaultModel={definition?.model.model_id}
diff --git a/tests/e2e/fixtures/teacher-reply-api.ts b/tests/e2e/fixtures/teacher-reply-api.ts
index cc3b446e..9694f4fb 100644
--- a/tests/e2e/fixtures/teacher-reply-api.ts
+++ b/tests/e2e/fixtures/teacher-reply-api.ts
@@ -9,6 +9,12 @@ const samples: Record<string, unknown> = {
   comparison: { kind: 'comparison', title: '哪一种更像你想要的小狗？', columns: [{ id: 'click', label: '点了才回应' }, { id: 'active', label: '会主动找我' }], rows: [{ id: 'home', label: '刚回到家的时候', cells: [{ columnId: 'click', text: '等我点一下，才跳起来。' }, { columnId: 'active', text: '看见我就跑过来，还带着玩具。' }] }, { id: 'busy', label: '我忙着种东西的时候', cells: [{ columnId: 'click', text: '安静等着，不打扰我。' }, { columnId: 'active', text: '有时来蹭一蹭，可能也会打断我。' }] }] },
 };
 const scenario = new URLSearchParams(location.search).get('kind') ?? 'ideas';
+if (scenario === 'shortcuts') definition.shortcuts = [
+  { label: '看看进展', prompt: '请结合当前项目，分析我最近完成的工作。' },
+  { label: '解释代码', prompt: '请解释当前项目最近的代码改动，用一个具体例子帮助我理解。' },
+  ...Array.from({ length: 6 }, (_, i) => ({ label: `入口${i + 3}：看看我的项目进展，帮我理解当前代码并提出下一步的编程建议`, prompt: `请讨论第 ${i + 3} 个主题。` })),
+];
+if (scenario === 'shortcuts-empty') definition.shortcuts = [];
 export const fixtureAgent = { teacher_id: definition.teacher_id, version: 1, is_default: true, definition };
 const continuous = new URLSearchParams(location.search).get('chat') !== 'legacy';
 let current: TeacherTopic = { schemaVersion: 1, revision: 1, id: 'discussion-fixture', accountId: 'fixture', projectId: 'fixture', sourceConversationId: 'project', definition, version: 1, createdAt: 'now', updatedAt: 'now', requests: Array.from({ length: 8 }, (_, i) => ({ id: `r${i}`, text: i === 7 ? '我还没想好，我们边聊边想。' : '我希望这个游戏更有意思。', references: [], projectId: 'fixture', sourceConversationId: 'source', teacherVersion: 1, createdAt: `2026-09-28T10:00:${String(i).padStart(2, '0')}Z`, sourceCursor: { workerGeneration: 0, seq: i }, sourceCapturedAt: 'now', includedSourceMessageIds: [], omittedMessages: 0, status: 'completed', response: i === 7 ? '可以，我们先把已经想到的放在一起。哪里还不确定，就留着继续聊。' : '先从你最在意的一个小地方开始想。', ...(i === 7 ? { suggestedQuestions: ['有什么好玩的想法？'] } : {}) })), ...(samples[scenario] ? { discussion: { id: 'tool', revision: 1, status: 'active', content: structuredClone(samples[scenario]) } } : {}) };
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index e6fbebe1..2668402d 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -47,6 +47,35 @@ test('retry stickers stay readable and preserve drafts in a 319px consultation',
 });
 
 for (const width of [319, 508]) {
+  test(`published shortcuts send their prompts and keep eight long labels scrollable at ${width}px`, async ({ page }) => {
+    await page.setViewportSize({ width: 1180, height: 800 });
+    await page.goto(`${url}?kind=shortcuts&width=${width}`);
+    const panel = page.getByTestId('teacher-chat-panel');
+    const shortcuts = page.locator('form .consultation-hint');
+    await expect(shortcuts).toHaveCount(8);
+    await expect(shortcuts.first()).toHaveText('看看进展');
+    await expect(shortcuts.nth(1)).toHaveText('解释代码');
+    await expect(shortcuts.nth(1)).toBeEnabled();
+    const form = (await panel.locator('form').boundingBox())!;
+    expect(form.y + form.height).toBeLessThanOrEqual(800);
+    expect(await panel.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
+    await shortcuts.last().scrollIntoViewIfNeeded();
+    await panel.screenshot({ path: test.info().outputPath(`shortcuts-${width}.png`) });
+    await shortcuts.last().click();
+    await expect(page.getByText('请讨论第 8 个主题。', { exact: true })).toBeVisible();
+    await expect(page.getByText('好，我们就从这一个问题聊起。')).toBeVisible();
+    await shortcuts.nth(1).click();
+    await expect(page.getByText('请解释当前项目最近的代码改动，用一个具体例子帮助我理解。', { exact: true })).toBeVisible();
+    const inputs = await page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs);
+    expect(inputs).toEqual([
+      { requestId: expect.any(String), text: '请讨论第 8 个主题。', references: [], projectId: 'fixture', sourceConversationId: 'source' },
+      { requestId: expect.any(String), text: '请解释当前项目最近的代码改动，用一个具体例子帮助我理解。', references: [], projectId: 'fixture', sourceConversationId: 'source' },
+    ]);
+    await page.goto(`${url}?kind=shortcuts-empty&width=${width}`);
+    await expect(page.getByRole('textbox', { name: '向智能体提问' })).toBeEnabled();
+    await expect(page.locator('form .consultation-hint')).toHaveCount(0);
+  });
+
   for (const chat of ['legacy', 'continuous']) test(`quoted ${chat} replies recover fully and incomplete replies retry without losing the draft at ${width}px`, async ({ page }) => {
     await page.setViewportSize({ width: 1180, height: 800 });
     const sent = () => page.evaluate(() => (window as unknown as { __teacherReplyInputs: unknown[] }).__teacherReplyInputs);
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index 86d6e345..1a233c5a 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -101,6 +101,56 @@ async function ready() {
   await waitFor(() => expect(streams.has('first')).toBe(true));
 }
 describe('teacher side chat', () => {
+  it('renders published shortcut labels in order and sends each actual prompt with independent retry identity', async () => {
+    const shortcuts = [{ label: '看看进展', prompt: '请分析当前项目的进展。' }, { label: '解释代码', prompt: '请解释刚才的代码改动。' }];
+    const agent = { teacher_id: 'shortcuts', version: 1, is_default: true, definition: { ...definition, config_id: 'shortcuts', shortcuts } };
+    api.catalog.mockResolvedValue({ items: [agent] });
+    api.sendConversation.mockRejectedValue(new Error('结果暂未确认'));
+    render(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={agent} />);
+    await waitFor(() => expect(screen.getByRole('button', { name: '看看进展' })).toBeEnabled());
+    expect([...screen.getByTestId('consultation-composer-actions').querySelectorAll('.consultation-hint')].map(el => el.textContent)).toEqual(shortcuts.map(item => item.label));
+    expect(screen.queryByRole('button', { name: '继续看看👀' })).not.toBeInTheDocument();
+    expect(screen.queryByText(shortcuts[0].prompt)).not.toBeInTheDocument();
+    fireEvent.click(screen.getByRole('button', { name: '看看进展' }));
+    await screen.findByText('结果暂未确认');
+    const original = api.sendConversation.mock.calls[0][2];
+    expect(original).toMatchObject({ text: shortcuts[0].prompt, projectId: 'p', sourceConversationId: 'c', references: [] });
+    expect(original.intent).toBeUndefined();
+    fireEvent.click(screen.getByRole('button', { name: '看看进展' }));
+    await waitFor(() => expect(api.sendConversation).toHaveBeenCalledTimes(2));
+    await waitFor(() => expect(screen.getByRole('button', { name: '解释代码' })).toBeEnabled());
+    expect(api.sendConversation.mock.calls[1][2]).toEqual(original);
+    fireEvent.click(screen.getByRole('button', { name: '解释代码' }));
+    await waitFor(() => expect(api.sendConversation).toHaveBeenCalledTimes(3));
+    expect(api.sendConversation.mock.calls[2][2].text).toBe(shortcuts[1].prompt);
+    expect(api.sendConversation.mock.calls[2][2].requestId).not.toBe(original.requestId);
+  });
+
+  it('updates published shortcuts without replacing chat history or a composed draft, and supports clearing the list', async () => {
+    const old = { teacher_id: 'shortcut-refresh', version: 1, is_default: true, definition: { ...definition, config_id: 'shortcut-refresh', shortcuts: [{ label: '旧入口', prompt: '旧提示词' }] } };
+    const conversation = { ...topic('shortcut-chat'), definition: old.definition,
+      conversation: { agentId: old.teacher_id, segmentTurns: 1, discussions: {}, seenThrough: 'past' },
+      requests: [request({ id: 'past', text: '之前的问题', response: '之前的回答' })] };
+    api.conversation.mockResolvedValue({ topic: conversation, before: null });
+    const state = (agent: typeof old) => ({ catalog: { revision: agent.version, items: [agent] }, config: { enabled: true, published_version: agent.version, revision: agent.version, definition: agent.definition } });
+    const view = render(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={old} catalogState={state(old)} />);
+    await screen.findByText('之前的回答');
+    await waitFor(() => expect(screen.getByRole('button', { name: '旧入口' })).toBeEnabled());
+    fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '尚未发出的草稿' } });
+    const updated = { ...old, version: 2, definition: { ...old.definition, shortcuts: [{ label: '新入口', prompt: '新的实际提示词' }] } };
+    view.rerender(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={updated} catalogState={state(updated)} />);
+    expect(screen.getByLabelText('向智能体提问')).toHaveValue('尚未发出的草稿');
+    expect(screen.queryByRole('button', { name: '新入口' })).not.toBeInTheDocument();
+    fireEvent.change(screen.getByLabelText('向智能体提问'), { target: { value: '' } });
+    expect(screen.getByRole('button', { name: '新入口' })).toBeVisible();
+    expect(screen.queryByRole('button', { name: '旧入口' })).not.toBeInTheDocument();
+    const cleared = { ...updated, version: 3, definition: { ...updated.definition, shortcuts: [] } };
+    view.rerender(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={cleared} catalogState={state(cleared)} />);
+    expect(screen.getByTestId('consultation-composer-actions').querySelectorAll('.consultation-hint')).toHaveLength(0);
+    expect(screen.getByText('之前的回答')).toBeVisible();
+    expect(api.sendConversation).not.toHaveBeenCalled();
+  });
+
   it('opens directly into the consultation and puts new topics inside expanded history', async () => {
     render(<TeacherChatPanel projectId="p" sourceId="c" />);
     const history = await screen.findByRole('button', { name: '以往讨论' });

From efd18942693309feb454f99c45a8b1cf7f8fc563 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 20:06:31 +0800
Subject: [PATCH 16/19] Place teacher prompt buttons above the composer

---
 ...0260929-teacher-prompt-buttons-a682d30f.md | 56 +++++++++++++++++++
 README.md                                     |  2 +-
 src/pages/Chat/TeacherChatPanel.tsx           | 19 ++++---
 src/pages/Chat/classroom-workspace.css        | 11 +++-
 tests/e2e/teacher-reply-layout.spec.ts        | 15 ++++-
 tests/unit/coding-teacher-ui.test.tsx         | 17 +++---
 6 files changed, 96 insertions(+), 24 deletions(-)
 create mode 100644 .project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md

diff --git a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
new file mode 100644
index 00000000..84cbc959
--- /dev/null
+++ b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
@@ -0,0 +1,56 @@
+# Task: Move configured teacher prompts above composer
+
+## Identity
+
+- Task ID: 20260929-teacher-prompt-buttons-a682d30f
+- Mode: Feature
+- Branch: codex/20260929-teacher-prompt-buttons-a682d30f-teacher-prompt-buttons
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20260929-teacher-prompt-buttons-a682d30f
+- Base commit: 78cfde67340aaccea8e8edc2505136cfcf865eda
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Move Yuxi-configured teacher shortcuts above the composer as small, flat pastel buttons; preserve exact configured label/prompt and existing send/voice/model behavior.
+
+## Intent And Constraints
+
+- User authorized code and background trial update. No subagents, cloud deployment, paid prompts, main merge/push, focus changes or history deletion.
+
+## Outcome
+
+- Configured teacher shortcuts now sit outside and directly above the composer. Buttons use 13px normal text (same as reply body), pale cream fill, light border and no shadow; wrapping/overflow/keyboard focus supported.
+- Adapted product/tests dependency from main 53d5b6b (bb96941); original source task record remains in its source commit, excluded from this feature boundary. Explicit empty arrays hide prompts; absent historical field retains approved fallback. Published label and prompt are unchanged.
+- Trial Renderer updated in place in PID 32583; Main and empty-work preview overlay remain intact. Live Alice cloud v53 supplies “继续看看咯”.
+
+## Verification
+
+- Typecheck, lint (0 errors / 8 existing warnings), production build passed. 75 focused unit tests and 23 headless browser scenarios passed, including 319/508px overflow, keyboard focus, exact configured prompt sends, preserved drafts, cloud refresh/empty list and voice/model controls.
+- First test pass exposed two stale assertions in the imported tests (send argument position and old toolbar ownership); adapted them. One rerun hit the existing old-topic stream timing test; serial rerun passed all 75 with no product changes.
+- Trial screenshot confirms 13px, weight 400, no shadow, buttons above composer, no horizontal overflow. Same account/storage/drafts/teacher/tab; focus monitor reports no trial activation.
+- Operation hydration initially collided with the existing E2E trial 250ms background-sleep timer while the desktop was at loginwindow. Read-only inspector diagnosis traced stop to BackgroundLifecycleController.sleepIfIdle (same failures present at 11:28Z before this update). A temporary Main-owned snapshot-verification lease allowed normal selectConversation hydration; then released it. No runtime code or user files changed. Final comparison: all 14 operation messages, teacher turns, drafts, selected teacher, route/tab unchanged; 15 timestamps visible. No live prompt or microphone call. All inspector breakpoints were removed.
+
+## Follow-ups
+
+- Feature branch awaits separate integration; no main merge/push or cloud deployment in this task. Prior model-selection cloud rollout remains pending.
+
+## Promotion Candidates
+
+- Target: integrated classroom UI documentation. Proposal: configured prompts live above the composer as flat body-size buttons; exact cloud labels/prompts, absent/empty compatibility and send guards retained. Evidence: user approval, 75 unit / 23 browser tests and live trial comparison. No product-policy conflict; canonical promotion belongs to integration.
+
+## Project Context Loaded
+
+- Task ID/mode/branch/worktree/base: matching official reservation and owner verified; feature task at 78cfde67340aaccea8e8edc2505136cfcf865eda in the isolated path above.
+- Read: AGENTS; entry, memory index, active task, positioning, current state, decisions/teacher ADR, architecture, domain rules, success criteria, evidence/commitment indexes and all registered peer Scope/Intent/Promotion sections.
+- Goal: child-friendly creation with cloud-defined teachers and Main-owned auth/model access. Current code and README supersede stale canonical mentions of retired discussion components.
+- Active peers: window-close (native lifecycle, explicitly excludes trial), help-label/replies-release, child-language (undefined scope), and completed teacher/composer/community/empty-preview tasks. No concrete semantic conflict; preserve their committed behavior and do not modify peer checkouts.
+- Relevant dependencies: main 53d5b6b adds configured shortcuts; current trial has 78cfde6 microphone/models and empty-preview 0167d36 overlay. Only shortcut support and presentation are brought into this task.
+- Files: TeacherChatPanel, classroom-workspace.css, shared definition and focused UI/layout fixtures, README. Existing single light palette and body font remain; design skill recommendations subordinate to approved layout.
+- Gate: Passed.
+
+## Plan
+
+1. Reconcile committed Yuxi shortcuts support with trial composer, preserving empty-array versus absent compatibility.
+2. Move controls above composer and give them body-size, normal-weight, pale rounded styling with keyboard focus and wrapping.
+3. Verify UI behavior/layout, typecheck/lint/build; update current trial in background preserving source overlays and user state; document evidence.
diff --git a/README.md b/README.md
index 7c348439..4c9b95ee 100644
--- a/README.md
+++ b/README.md
@@ -183,7 +183,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
 - 云端咨询在 local_context 声明 read_protocol=2；需先部署配套 Yuxi API 和 worker，再升级客户端。云端持久累计读取字节及批次，每轮告知模型剩余额度；预算耗尽后消费最后一批结果，并以 tool_choice=none 要求根据现有证据形成答案和说明缺口。Main 限制实际返回量并拒绝第十三批读取，区分读取达到上限、上下文失效及格式无效。服务端对未声明协议的已安装旧客户端保留原工具参数与六批边界。
 - 智能体人设、职责、提示词和 Skills 由发布配置决定。Main 不追加固定教学基线、不生成“小麦”、不清空所选智能体的 Skills，只添加真实工具能力、上下文边界和本轮界面协议。智能体名称叫“老师”“朋友”或“代码顾问”不改变调用路径或权限。
-- 输入框为空时显示当前老师已发布的快捷提示，按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“继续看看👀”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
+- 输入框为空时，在输入框外上方显示当前老师已发布的快捷提示；采用与回复正文一致的 13px 常规字重、浅色圆角按钮，横向排列并自动换行。按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“帮我整体看🧠”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
 - `reply.ts` 只声明正文与快捷回复的输出格式，语言、长度、前缀与表达风格由所选智能体的云端配置决定。客户端不再发送选择、生成、转换或维护展示组件的指令。旧话题内的组件状态、快照和解析诊断作为不透明历史数据原样保留，不校验删除、不恢复交互；旧组件修改路由已移除。
 - 当前输入是按预算截取的所选操作对话已完成分支文本、明确引用、咨询正文和快捷回复，并支持上述只读原文恢复；旧组件状态、快照和未解析原文不加入模型上下文或咨询历史读取结果。没有跨全部操作会话自动读取，也未向操作 Agent 注入咨询共识。提示词不声称看过未提供的画面或试玩过作品。Yuxi 话题经云端原生执行，旧版本地智能体由 Main 调用计费网关；均不创建本地 Pi 编程 worker。
 - 智能体输入裁剪区分两种计量：本地模型以约每 2 个 UTF-8 字节估算 1 Token，并计入工具与读取预留；这不是精确分词或扣费依据，模型上限与实际 usage 仍由服务端拥有。云端沿用 query 字节上限，以完整 JSON 转义后的大小裁剪来源节选。智能体指令、当前问题和明确引用不会被静默裁掉；固定配置或回复协议超限时明确提示调整配置，避免让学生反复缩短短问题或新建话题。完整来源仍可由只读工具按需读取。
diff --git a/src/pages/Chat/TeacherChatPanel.tsx b/src/pages/Chat/TeacherChatPanel.tsx
index cd989b21..28adfe55 100644
--- a/src/pages/Chat/TeacherChatPanel.tsx
+++ b/src/pages/Chat/TeacherChatPanel.tsx
@@ -606,20 +606,21 @@ export function TeacherChatPanel({
           </div>
         </details>}
         {references.length > 0 && <div className="mb-2 rounded-lg bg-white p-3 text-xs"><p className="line-clamp-3 whitespace-pre-wrap">{references.map((ref) => ref.text).join('\n')}</p><button type="button" className="mt-1 underline" onClick={removeReferences}>移除引用</button></div>}
+        {!draftRevision && !text.trim() && (definition?.shortcuts == null || definition.shortcuts.length > 0) &&
+          <div className="consultation-shortcuts" role="group" aria-label="快捷提问" data-testid="consultation-shortcuts">
+            {definition?.shortcuts == null
+              ? <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>
+              : definition.shortcuts.map((shortcut, index) => <button
+                key={index} type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'}
+                onClick={() => void send({ text: shortcut.prompt })}
+                className="consultation-hint"
+              >{shortcut.label}</button>)}
+          </div>}
         <div className="consultation-composer rounded-2xl border bg-white p-3 focus-within:ring-2 focus-within:ring-black/5">
           <textarea ref={inputRef} aria-label={`向${label}提问`} value={text} disabled={busy} maxLength={6000} onChange={(e) => changeText(e.target.value)} placeholder="和老师聊聊" rows={2}
             onKeyDown={(e) => { if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) { e.preventDefault(); void send(); } }}
             className="min-h-[60px] w-full resize-none border-0 bg-transparent text-[13px] leading-6 outline-none placeholder:text-muted-foreground/65" />
           <div className="mt-2 flex min-h-[68px] flex-wrap items-center justify-between gap-x-2 gap-y-2" data-testid="consultation-composer-actions">
-            <div className="flex max-h-48 min-w-0 grow flex-wrap gap-2 overflow-y-auto pb-1">
-              {!draftRevision && !text.trim() && (definition?.shortcuts == null
-                ? <button type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'} onClick={askForSuggestions} className="consultation-hint">帮我整体看🧠</button>
-                : definition.shortcuts.map((shortcut, index) => <button
-                  key={index} type="button" disabled={helpUnavailable || voiceInput.state !== 'idle'}
-                  onClick={() => void send({ text: shortcut.prompt })}
-                  className="consultation-hint max-w-full whitespace-normal break-words text-left"
-                >{shortcut.label}</button>))}
-            </div>
             <div className="ml-auto flex min-w-0 max-w-full items-center gap-1" data-testid="teacher-composer-runtime-controls">
               <TeacherModelSelect key={modelScope + (definition?.runtime ?? 'local')} runtime={definition?.runtime ?? 'local'} scope={modelScope} defaultModel={definition?.model.model_id}
                 modelId={modelChoice.modelId} onChange={modelChoice.select} disabled={busy || !topicEnabled || Boolean(running)} />
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index 0968d8b1..a8ad4978 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -49,9 +49,14 @@
 .classroom-consultation-resizer { position: absolute; inset: 0 auto 0 -4px; width: 8px; z-index: 2; cursor: col-resize; }
 .classroom-consultation-resizer:hover, .classroom-consultation-resizer:focus-visible { background: #7994b533; }
 .consultation-pane { background: #fffdf8; color: #30465f; }
-.consultation-hint, .consultation-retry { display: inline-flex; align-items: center; justify-content: center; align-self: flex-start; min-height: 44px; max-width: 100%; padding: 8px 16px; border: 1.5px solid #e3ce8f; border-radius: 16px 16px 16px 6px; background: #fff2c9; color: #6f5127; box-shadow: 0 3px 0 #e7d7a6, inset 0 1px 0 #fff9e8; font-size: 14px; font-weight: 600; line-height: 24px; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease, box-shadow 160ms ease, transform 160ms ease; }
-.consultation-hint:hover:not(:disabled), .consultation-retry:hover:not(:disabled) { background: #ffe9a9; border-color: #d6b76f; }
-.consultation-hint:active:not(:disabled), .consultation-retry:active:not(:disabled) { transform: translateY(2px); box-shadow: 0 1px 0 #e7d7a6, inset 0 1px 0 #fff9e8; }
+.consultation-retry { display: inline-flex; align-items: center; justify-content: center; align-self: flex-start; min-height: 44px; max-width: 100%; padding: 8px 16px; border: 1.5px solid #e3ce8f; border-radius: 16px 16px 16px 6px; background: #fff2c9; color: #6f5127; box-shadow: 0 3px 0 #e7d7a6, inset 0 1px 0 #fff9e8; font-size: 14px; font-weight: 600; line-height: 24px; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease, box-shadow 160ms ease, transform 160ms ease; }
+.consultation-retry:hover:not(:disabled) { background: #ffe9a9; border-color: #d6b76f; }
+.consultation-retry:active:not(:disabled) { transform: translateY(2px); box-shadow: 0 1px 0 #e7d7a6, inset 0 1px 0 #fff9e8; }
+.consultation-shortcuts { display: flex; flex-wrap: wrap; align-items: flex-start; gap: 8px; max-height: min(192px, 24vh); overflow-y: auto; margin-bottom: 10px; padding: 3px; }
+.consultation-hint { display: inline-flex; align-items: center; max-width: 100%; min-height: 36px; padding: 6px 12px; border: 1px solid #e5ddc7; border-radius: 12px; background: #faf5e8; color: #5b503b; font-size: 13px; font-weight: 400; line-height: 22px; text-align: left; white-space: normal; overflow-wrap: anywhere; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease; }
+.consultation-hint:hover:not(:disabled) { background: #f4ecd6; border-color: #d7c9a5; }
+.consultation-hint:active:not(:disabled) { background: #eee3c7; }
+.consultation-hint:focus-visible { outline: 2px solid #7891af; outline-offset: 2px; }
 .consultation-hint:disabled, .consultation-retry:disabled { cursor: not-allowed; opacity: 0.5; }
 @media (prefers-reduced-motion: reduce) { .consultation-hint, .consultation-retry { transition: none; } .consultation-hint:active:not(:disabled), .consultation-retry:active:not(:disabled) { transform: none; } }
 .consultation-pane button:focus-visible { outline: 2px solid #71845f; outline-offset: 3px; }
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index 2668402d..ad246a20 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -56,6 +56,15 @@ for (const width of [319, 508]) {
     await expect(shortcuts.first()).toHaveText('看看进展');
     await expect(shortcuts.nth(1)).toHaveText('解释代码');
     await expect(shortcuts.nth(1)).toBeEnabled();
+    const row = panel.getByRole('group', { name: '快捷提问' });
+    const composer = panel.locator('.consultation-composer');
+    await expect(composer.locator('.consultation-hint')).toHaveCount(0);
+    await expect(shortcuts.first()).toHaveCSS('font-size', await panel.getByTestId('teacher-reply').first().evaluate(el => getComputedStyle(el).fontSize));
+    await expect(shortcuts.first()).toHaveCSS('font-weight', '400');
+    await expect(shortcuts.first()).toHaveCSS('box-shadow', 'none');
+    expect((await row.boundingBox())!.y + (await row.boundingBox())!.height).toBeLessThan((await composer.boundingBox())!.y);
+    await shortcuts.first().focus();
+    await expect(shortcuts.first()).toHaveCSS('outline-style', 'solid');
     const form = (await panel.locator('form').boundingBox())!;
     expect(form.y + form.height).toBeLessThanOrEqual(800);
     expect(await panel.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
@@ -120,12 +129,12 @@ for (const width of [319, 508]) {
     await expect(hint).toBeEnabled();
     await expect(hint).toHaveText('帮我整体看🧠');
     expect(await hint.evaluate(el => el.scrollWidth <= el.clientWidth && el.scrollHeight <= el.clientHeight)).toBe(true);
-    await expect(hint).toHaveCSS('background-color', 'rgb(255, 242, 201)');
+    await expect(hint).toHaveCSS('background-color', 'rgb(250, 245, 232)');
     const initialSend = (await send.boundingBox())!;
     const hintBounds = (await hint.boundingBox())!;
     expect(hintBounds.x).toBeLessThan(initialSend.x);
-    expect(hintBounds.height).toBeGreaterThanOrEqual(44);
-    expect(hintBounds.x + hintBounds.width).toBeLessThanOrEqual(initialSend.x);
+    expect(hintBounds.height).toBeGreaterThanOrEqual(36);
+    expect(hintBounds.y + hintBounds.height).toBeLessThan((await page.locator('.consultation-composer').boundingBox())!.y);
     await page.getByTestId('teacher-chat-panel').screenshot({ path: test.info().outputPath(`composer-hint-${width}.png`) });
     expect(await sent()).toEqual([]);
     await input.fill('我想先自己说说');
diff --git a/tests/unit/coding-teacher-ui.test.tsx b/tests/unit/coding-teacher-ui.test.tsx
index 1a233c5a..04e71fa1 100644
--- a/tests/unit/coding-teacher-ui.test.tsx
+++ b/tests/unit/coding-teacher-ui.test.tsx
@@ -108,22 +108,22 @@ describe('teacher side chat', () => {
     api.sendConversation.mockRejectedValue(new Error('结果暂未确认'));
     render(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={agent} />);
     await waitFor(() => expect(screen.getByRole('button', { name: '看看进展' })).toBeEnabled());
-    expect([...screen.getByTestId('consultation-composer-actions').querySelectorAll('.consultation-hint')].map(el => el.textContent)).toEqual(shortcuts.map(item => item.label));
-    expect(screen.queryByRole('button', { name: '继续看看👀' })).not.toBeInTheDocument();
+    expect([...screen.getByTestId('consultation-shortcuts').querySelectorAll('.consultation-hint')].map(el => el.textContent)).toEqual(shortcuts.map(item => item.label));
+    expect(screen.queryByRole('button', { name: '帮我整体看🧠' })).not.toBeInTheDocument();
     expect(screen.queryByText(shortcuts[0].prompt)).not.toBeInTheDocument();
     fireEvent.click(screen.getByRole('button', { name: '看看进展' }));
     await screen.findByText('结果暂未确认');
-    const original = api.sendConversation.mock.calls[0][2];
+    const original = api.sendConversation.mock.calls[0][1];
     expect(original).toMatchObject({ text: shortcuts[0].prompt, projectId: 'p', sourceConversationId: 'c', references: [] });
     expect(original.intent).toBeUndefined();
     fireEvent.click(screen.getByRole('button', { name: '看看进展' }));
     await waitFor(() => expect(api.sendConversation).toHaveBeenCalledTimes(2));
     await waitFor(() => expect(screen.getByRole('button', { name: '解释代码' })).toBeEnabled());
-    expect(api.sendConversation.mock.calls[1][2]).toEqual(original);
+    expect(api.sendConversation.mock.calls[1][1]).toEqual(original);
     fireEvent.click(screen.getByRole('button', { name: '解释代码' }));
     await waitFor(() => expect(api.sendConversation).toHaveBeenCalledTimes(3));
-    expect(api.sendConversation.mock.calls[2][2].text).toBe(shortcuts[1].prompt);
-    expect(api.sendConversation.mock.calls[2][2].requestId).not.toBe(original.requestId);
+    expect(api.sendConversation.mock.calls[2][1].text).toBe(shortcuts[1].prompt);
+    expect(api.sendConversation.mock.calls[2][1].requestId).not.toBe(original.requestId);
   });
 
   it('updates published shortcuts without replacing chat history or a composed draft, and supports clearing the list', async () => {
@@ -146,7 +146,7 @@ describe('teacher side chat', () => {
     expect(screen.queryByRole('button', { name: '旧入口' })).not.toBeInTheDocument();
     const cleared = { ...updated, version: 3, definition: { ...updated.definition, shortcuts: [] } };
     view.rerender(<TeacherChatPanel projectId="p" sourceId="c" selectedAgent={cleared} catalogState={state(cleared)} />);
-    expect(screen.getByTestId('consultation-composer-actions').querySelectorAll('.consultation-hint')).toHaveLength(0);
+    expect(screen.queryByTestId('consultation-shortcuts')).not.toBeInTheDocument();
     expect(screen.getByText('之前的回答')).toBeVisible();
     expect(api.sendConversation).not.toHaveBeenCalled();
   });
@@ -550,7 +550,8 @@ describe('teacher side chat', () => {
     const input = screen.getByLabelText('向智能体提问');
     const help = () => screen.getByText((_text, element) => element?.textContent === '帮我整体看🧠', { selector: 'form .consultation-hint' });
     await waitFor(() => expect(help()).toBeEnabled());
-    expect(screen.getByTestId('consultation-composer-actions')).toContainElement(help());
+    expect(screen.getByTestId('consultation-shortcuts')).toContainElement(help());
+    expect(screen.getByTestId('consultation-composer-actions')).not.toContainElement(help());
     expect(help()).toHaveAccessibleName('帮我整体看🧠');
     expect(api.send).not.toHaveBeenCalled();
     fireEvent.change(input, { target: { value: '我先自己想想' } });

From dc8f766a774852e69009907a9f94590bf0656cab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 20:12:44 +0800
Subject: [PATCH 17/19] Make teacher prompt buttons compact and softly raised

---
 .../20260929-teacher-prompt-buttons-a682d30f.md  | 16 +++++++++++++---
 README.md                                        |  2 +-
 src/pages/Chat/classroom-workspace.css           |  4 ++--
 tests/e2e/teacher-reply-layout.spec.ts           |  7 ++++---
 4 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
index 84cbc959..9f0b366e 100644
--- a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
+++ b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
@@ -12,7 +12,7 @@
 
 ## Scope
 
-- Move Yuxi-configured teacher shortcuts above the composer as small, flat pastel buttons; preserve exact configured label/prompt and existing send/voice/model behavior.
+- Move Yuxi-configured teacher shortcuts above the composer as small pastel buttons with soft shadows; preserve exact configured label/prompt and existing send/voice/model behavior.
 
 ## Intent And Constraints
 
@@ -20,7 +20,7 @@
 
 ## Outcome
 
-- Configured teacher shortcuts now sit outside and directly above the composer. Buttons use 13px normal text (same as reply body), pale cream fill, light border and no shadow; wrapping/overflow/keyboard focus supported.
+- Configured teacher shortcuts now sit outside and directly above the composer. Buttons use 13px normal text (same as reply body), pale cream fill, no border and soft shadow; wrapping/overflow/keyboard focus supported.
 - Adapted product/tests dependency from main 53d5b6b (bb96941); original source task record remains in its source commit, excluded from this feature boundary. Explicit empty arrays hide prompts; absent historical field retains approved fallback. Published label and prompt are unchanged.
 - Trial Renderer updated in place in PID 32583; Main and empty-work preview overlay remain intact. Live Alice cloud v53 supplies “继续看看咯”.
 
@@ -37,7 +37,7 @@
 
 ## Promotion Candidates
 
-- Target: integrated classroom UI documentation. Proposal: configured prompts live above the composer as flat body-size buttons; exact cloud labels/prompts, absent/empty compatibility and send guards retained. Evidence: user approval, 75 unit / 23 browser tests and live trial comparison. No product-policy conflict; canonical promotion belongs to integration.
+- Target: integrated classroom UI documentation. Proposal: configured prompts live above the composer as borderless body-size buttons with soft shadows; exact cloud labels/prompts, absent/empty compatibility and send guards retained. Evidence: user approval, 75 unit / 23 browser tests and live trial comparison. No product-policy conflict; canonical promotion belongs to integration.
 
 ## Project Context Loaded
 
@@ -54,3 +54,13 @@
 1. Reconcile committed Yuxi shortcuts support with trial composer, preserving empty-array versus absent compatibility.
 2. Move controls above composer and give them body-size, normal-weight, pale rounded styling with keyboard focus and wrapping.
 3. Verify UI behavior/layout, typecheck/lint/build; update current trial in background preserving source overlays and user state; document evidence.
+
+## Compact Shadow Follow-up
+
+- Same-task ownership resumed and verified at efd1894. Reused the unchanged planning context above and reread current peer scopes; no new conflict. Gate passed.
+- User now wants smaller buttons without a visible border, using background and soft shadow. Keep 13px text for readability, reduce minimum height from 36px to 30px and padding to 4px/10px, soften corners.
+- Plan: update only prompt CSS, existing layout assertions and product/task documentation; verify targeted layouts and build. Refresh the built stylesheet in the running trial without remounting conversations or activating the window.
+
+- Completed: prompt button minimum height 30px (was 36px), padding 4px/10px, 8px corners, no border, soft 2px/6px shadow and pale cream background. Font remains 13px/400.
+- Verification: typecheck, lint (0 errors, 8 existing warnings), source/staged production builds and six 319/508px prompt/model/microphone layout scenarios passed. Existing checks now assert no border, a shadow and 30px height.
+- Updated the production stylesheet link in the live trial, with new built assets/index installed for subsequent reload. No Renderer remount or Main restart; live JS behavior is unchanged. Native capture confirms 30px, zero border and soft shadow. All localStorage, input text, operation messages, teacher turn text and route remained byte-identical; window stayed unfocused.
diff --git a/README.md b/README.md
index 4c9b95ee..f3290699 100644
--- a/README.md
+++ b/README.md
@@ -183,7 +183,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
 - 云端咨询在 local_context 声明 read_protocol=2；需先部署配套 Yuxi API 和 worker，再升级客户端。云端持久累计读取字节及批次，每轮告知模型剩余额度；预算耗尽后消费最后一批结果，并以 tool_choice=none 要求根据现有证据形成答案和说明缺口。Main 限制实际返回量并拒绝第十三批读取，区分读取达到上限、上下文失效及格式无效。服务端对未声明协议的已安装旧客户端保留原工具参数与六批边界。
 - 智能体人设、职责、提示词和 Skills 由发布配置决定。Main 不追加固定教学基线、不生成“小麦”、不清空所选智能体的 Skills，只添加真实工具能力、上下文边界和本轮界面协议。智能体名称叫“老师”“朋友”或“代码顾问”不改变调用路径或权限。
-- 输入框为空时，在输入框外上方显示当前老师已发布的快捷提示；采用与回复正文一致的 13px 常规字重、浅色圆角按钮，横向排列并自动换行。按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“帮我整体看🧠”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
+- 输入框为空时，在输入框外上方显示当前老师已发布的快捷提示；采用与回复正文一致的 13px 常规字重、无边框、浅色底与柔和阴影的小巧圆角按钮，横向排列并自动换行。按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“帮我整体看🧠”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
 - `reply.ts` 只声明正文与快捷回复的输出格式，语言、长度、前缀与表达风格由所选智能体的云端配置决定。客户端不再发送选择、生成、转换或维护展示组件的指令。旧话题内的组件状态、快照和解析诊断作为不透明历史数据原样保留，不校验删除、不恢复交互；旧组件修改路由已移除。
 - 当前输入是按预算截取的所选操作对话已完成分支文本、明确引用、咨询正文和快捷回复，并支持上述只读原文恢复；旧组件状态、快照和未解析原文不加入模型上下文或咨询历史读取结果。没有跨全部操作会话自动读取，也未向操作 Agent 注入咨询共识。提示词不声称看过未提供的画面或试玩过作品。Yuxi 话题经云端原生执行，旧版本地智能体由 Main 调用计费网关；均不创建本地 Pi 编程 worker。
 - 智能体输入裁剪区分两种计量：本地模型以约每 2 个 UTF-8 字节估算 1 Token，并计入工具与读取预留；这不是精确分词或扣费依据，模型上限与实际 usage 仍由服务端拥有。云端沿用 query 字节上限，以完整 JSON 转义后的大小裁剪来源节选。智能体指令、当前问题和明确引用不会被静默裁掉；固定配置或回复协议超限时明确提示调整配置，避免让学生反复缩短短问题或新建话题。完整来源仍可由只读工具按需读取。
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index a8ad4978..7545eebb 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -53,8 +53,8 @@
 .consultation-retry:hover:not(:disabled) { background: #ffe9a9; border-color: #d6b76f; }
 .consultation-retry:active:not(:disabled) { transform: translateY(2px); box-shadow: 0 1px 0 #e7d7a6, inset 0 1px 0 #fff9e8; }
 .consultation-shortcuts { display: flex; flex-wrap: wrap; align-items: flex-start; gap: 8px; max-height: min(192px, 24vh); overflow-y: auto; margin-bottom: 10px; padding: 3px; }
-.consultation-hint { display: inline-flex; align-items: center; max-width: 100%; min-height: 36px; padding: 6px 12px; border: 1px solid #e5ddc7; border-radius: 12px; background: #faf5e8; color: #5b503b; font-size: 13px; font-weight: 400; line-height: 22px; text-align: left; white-space: normal; overflow-wrap: anywhere; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease; }
-.consultation-hint:hover:not(:disabled) { background: #f4ecd6; border-color: #d7c9a5; }
+.consultation-hint { display: inline-flex; align-items: center; max-width: 100%; min-height: 30px; padding: 4px 10px; border: 0; border-radius: 8px; background: #f8f1e2; box-shadow: 0 2px 6px #8b75491a; color: #5b503b; font-size: 13px; font-weight: 400; line-height: 22px; text-align: left; white-space: normal; overflow-wrap: anywhere; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease; }
+.consultation-hint:hover:not(:disabled) { background: #f2e8d2; box-shadow: 0 3px 8px #8b754924; }
 .consultation-hint:active:not(:disabled) { background: #eee3c7; }
 .consultation-hint:focus-visible { outline: 2px solid #7891af; outline-offset: 2px; }
 .consultation-hint:disabled, .consultation-retry:disabled { cursor: not-allowed; opacity: 0.5; }
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index ad246a20..2e1da537 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -61,7 +61,8 @@ for (const width of [319, 508]) {
     await expect(composer.locator('.consultation-hint')).toHaveCount(0);
     await expect(shortcuts.first()).toHaveCSS('font-size', await panel.getByTestId('teacher-reply').first().evaluate(el => getComputedStyle(el).fontSize));
     await expect(shortcuts.first()).toHaveCSS('font-weight', '400');
-    await expect(shortcuts.first()).toHaveCSS('box-shadow', 'none');
+    await expect(shortcuts.first()).toHaveCSS('border-top-width', '0px');
+    await expect(shortcuts.first()).not.toHaveCSS('box-shadow', 'none');
     expect((await row.boundingBox())!.y + (await row.boundingBox())!.height).toBeLessThan((await composer.boundingBox())!.y);
     await shortcuts.first().focus();
     await expect(shortcuts.first()).toHaveCSS('outline-style', 'solid');
@@ -129,11 +130,11 @@ for (const width of [319, 508]) {
     await expect(hint).toBeEnabled();
     await expect(hint).toHaveText('帮我整体看🧠');
     expect(await hint.evaluate(el => el.scrollWidth <= el.clientWidth && el.scrollHeight <= el.clientHeight)).toBe(true);
-    await expect(hint).toHaveCSS('background-color', 'rgb(250, 245, 232)');
+    await expect(hint).toHaveCSS('background-color', 'rgb(248, 241, 226)');
     const initialSend = (await send.boundingBox())!;
     const hintBounds = (await hint.boundingBox())!;
     expect(hintBounds.x).toBeLessThan(initialSend.x);
-    expect(hintBounds.height).toBeGreaterThanOrEqual(36);
+    expect(hintBounds.height).toBe(30);
     expect(hintBounds.y + hintBounds.height).toBeLessThan((await page.locator('.consultation-composer').boundingBox())!.y);
     await page.getByTestId('teacher-chat-panel').screenshot({ path: test.info().outputPath(`composer-hint-${width}.png`) });
     expect(await sent()).toEqual([]);

From 79b1dc189250cab5ddb303e53e43c47ab48ba4cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 20:20:58 +0800
Subject: [PATCH 18/19] Clarify teacher prompt button click affordance

---
 .../20260929-teacher-prompt-buttons-a682d30f.md    |  9 +++++++++
 README.md                                          |  2 +-
 src/pages/Chat/classroom-workspace.css             | 11 ++++++-----
 tests/e2e/teacher-reply-layout.spec.ts             | 14 +++++++++++++-
 4 files changed, 29 insertions(+), 7 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
index 9f0b366e..19f496f4 100644
--- a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
+++ b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
@@ -64,3 +64,12 @@
 - Completed: prompt button minimum height 30px (was 36px), padding 4px/10px, 8px corners, no border, soft 2px/6px shadow and pale cream background. Font remains 13px/400.
 - Verification: typecheck, lint (0 errors, 8 existing warnings), source/staged production builds and six 319/508px prompt/model/microphone layout scenarios passed. Existing checks now assert no border, a shadow and 30px height.
 - Updated the production stylesheet link in the live trial, with new built assets/index installed for subsequent reload. No Renderer remount or Main restart; live JS behavior is unchanged. Native capture confirms 30px, zero border and soft shadow. All localStorage, input text, operation messages, teacher turn text and route remained byte-identical; window stayed unfocused.
+
+## Click Affordance Follow-up
+
+- Same-task ownership and existing planning context verified again at dc8f766; peer scope decisions remain compatible. Gate passed. User wants the compact borderless prompts to look unmistakably clickable.
+- Plan: retain 30px/13px sizing, strengthen the warm fill and bottom shadow, add a small decorative chevron, and provide hover/pressed depth feedback with reduced-motion support. Update existing layout checks and hot-swap the built stylesheet in the trial, preserving live conversations.
+
+- Completed: 30px borderless buttons now have a warmer pale-yellow fill, 2px bottom shadow and decorative chevron. Hover raises 1px and pressed state lowers 1px; reduced-motion keeps position stable. Exact configured text and accessible name unchanged.
+- Verification: typecheck, lint (0 errors / 8 existing warnings), source and combined-stage production builds, and six focused browser cases passed. Existing cases now exercise hover, pressed and reduced-motion feedback as well as 319/508px layout and exact prompt sends.
+- Trial stylesheet index-ydJGBX8O.css installed and activated without reload. Native screenshot inspected; computed height 30px, font 13px, border 0 and raised shadow confirmed. All storage, inputs, 14 operation messages, teacher message text and route unchanged; focused=false before/after. No cloud changes or live messages sent.
diff --git a/README.md b/README.md
index f3290699..d88b14c5 100644
--- a/README.md
+++ b/README.md
@@ -183,7 +183,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 - 咨询正文支持 Markdown 标题、列表、表格、代码围栏、HTTP(S) 链接／图片和数学公式，长代码与表格在栏内横向滚动，不执行 HTML。云端正文维持 string 合同，未知对象不会猜测转成回答。工具活动只从云端主线程的类型化工具事件及 Main 本地读取过程获得，按本次问题／工具调用身份合并名称和状态，跨云端暂停、续接仍只计一次；暂停读取不算失败，状态以实际读取结果或问题终态为准，单独折叠显示；参数、结果原文和内部错误不混入回复，思考内容不作为正文。客户端仅保存自己实际收到的工具状态，不能补回旧历史或断线期间已经过期的事件。
 - 云端咨询在 local_context 声明 read_protocol=2；需先部署配套 Yuxi API 和 worker，再升级客户端。云端持久累计读取字节及批次，每轮告知模型剩余额度；预算耗尽后消费最后一批结果，并以 tool_choice=none 要求根据现有证据形成答案和说明缺口。Main 限制实际返回量并拒绝第十三批读取，区分读取达到上限、上下文失效及格式无效。服务端对未声明协议的已安装旧客户端保留原工具参数与六批边界。
 - 智能体人设、职责、提示词和 Skills 由发布配置决定。Main 不追加固定教学基线、不生成“小麦”、不清空所选智能体的 Skills，只添加真实工具能力、上下文边界和本轮界面协议。智能体名称叫“老师”“朋友”或“代码顾问”不改变调用路径或权限。
-- 输入框为空时，在输入框外上方显示当前老师已发布的快捷提示；采用与回复正文一致的 13px 常规字重、无边框、浅色底与柔和阴影的小巧圆角按钮，横向排列并自动换行。按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“帮我整体看🧠”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
+- 输入框为空时，在输入框外上方显示当前老师已发布的快捷提示；采用与回复正文一致的 13px 常规字重、无边框、浅色底与底部立体阴影的小巧圆角按钮，配有小箭头和悬停／按下反馈，横向排列并自动换行。按 Yuxi 中配置的顺序展示文案，点击直接发送该项实际提示词。Yuxi“编辑 → 快捷提示”支持最多 8 项，每项文案最多 40 字、提示词最多 6000 字；保存并发布后，目录更新即可生效，历史和未发送草稿保留。明确发布空列表隐藏全部按钮；缺少字段的历史版本保留“帮我整体看🧠”。多个长文案在限定高度内滚动，运行中禁止重复发送。上线需先更新 WS 登记接口，再更新 Yuxi 和客户端。
 - `reply.ts` 只声明正文与快捷回复的输出格式，语言、长度、前缀与表达风格由所选智能体的云端配置决定。客户端不再发送选择、生成、转换或维护展示组件的指令。旧话题内的组件状态、快照和解析诊断作为不透明历史数据原样保留，不校验删除、不恢复交互；旧组件修改路由已移除。
 - 当前输入是按预算截取的所选操作对话已完成分支文本、明确引用、咨询正文和快捷回复，并支持上述只读原文恢复；旧组件状态、快照和未解析原文不加入模型上下文或咨询历史读取结果。没有跨全部操作会话自动读取，也未向操作 Agent 注入咨询共识。提示词不声称看过未提供的画面或试玩过作品。Yuxi 话题经云端原生执行，旧版本地智能体由 Main 调用计费网关；均不创建本地 Pi 编程 worker。
 - 智能体输入裁剪区分两种计量：本地模型以约每 2 个 UTF-8 字节估算 1 Token，并计入工具与读取预留；这不是精确分词或扣费依据，模型上限与实际 usage 仍由服务端拥有。云端沿用 query 字节上限，以完整 JSON 转义后的大小裁剪来源节选。智能体指令、当前问题和明确引用不会被静默裁掉；固定配置或回复协议超限时明确提示调整配置，避免让学生反复缩短短问题或新建话题。完整来源仍可由只读工具按需读取。
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index 7545eebb..149ccb18 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -52,13 +52,14 @@
 .consultation-retry { display: inline-flex; align-items: center; justify-content: center; align-self: flex-start; min-height: 44px; max-width: 100%; padding: 8px 16px; border: 1.5px solid #e3ce8f; border-radius: 16px 16px 16px 6px; background: #fff2c9; color: #6f5127; box-shadow: 0 3px 0 #e7d7a6, inset 0 1px 0 #fff9e8; font-size: 14px; font-weight: 600; line-height: 24px; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease, box-shadow 160ms ease, transform 160ms ease; }
 .consultation-retry:hover:not(:disabled) { background: #ffe9a9; border-color: #d6b76f; }
 .consultation-retry:active:not(:disabled) { transform: translateY(2px); box-shadow: 0 1px 0 #e7d7a6, inset 0 1px 0 #fff9e8; }
-.consultation-shortcuts { display: flex; flex-wrap: wrap; align-items: flex-start; gap: 8px; max-height: min(192px, 24vh); overflow-y: auto; margin-bottom: 10px; padding: 3px; }
-.consultation-hint { display: inline-flex; align-items: center; max-width: 100%; min-height: 30px; padding: 4px 10px; border: 0; border-radius: 8px; background: #f8f1e2; box-shadow: 0 2px 6px #8b75491a; color: #5b503b; font-size: 13px; font-weight: 400; line-height: 22px; text-align: left; white-space: normal; overflow-wrap: anywhere; cursor: pointer; transition: background-color 160ms ease, border-color 160ms ease; }
-.consultation-hint:hover:not(:disabled) { background: #f2e8d2; box-shadow: 0 3px 8px #8b754924; }
-.consultation-hint:active:not(:disabled) { background: #eee3c7; }
+.consultation-shortcuts { display: flex; flex-wrap: wrap; align-items: flex-start; gap: 8px; max-height: min(192px, 24vh); overflow-y: auto; margin-bottom: 10px; padding: 3px 4px 6px; }
+.consultation-hint { display: inline-flex; align-items: center; gap: 8px; max-width: 100%; min-height: 30px; padding: 4px 10px; border: 0; border-radius: 8px; background: #f8e6b7; box-shadow: 0 2px 0 #d8c492, 0 3px 6px #8b75491a; color: #65491f; font-size: 13px; font-weight: 400; line-height: 22px; text-align: left; white-space: normal; overflow-wrap: anywhere; cursor: pointer; transition: background-color 140ms ease, box-shadow 140ms ease, transform 140ms ease; }
+.consultation-hint::after { content: ''; width: 5px; height: 5px; flex-shrink: 0; border-right: 1.5px solid currentColor; border-bottom: 1.5px solid currentColor; transform: rotate(-45deg); opacity: 0.7; }
+.consultation-hint:hover:not(:disabled) { background: #f7dfa0; box-shadow: 0 3px 0 #d1b979, 0 5px 8px #8b754924; transform: translateY(-1px); }
+.consultation-hint:active:not(:disabled) { background: #efd28b; box-shadow: 0 1px 0 #c7ad70; transform: translateY(1px); }
 .consultation-hint:focus-visible { outline: 2px solid #7891af; outline-offset: 2px; }
 .consultation-hint:disabled, .consultation-retry:disabled { cursor: not-allowed; opacity: 0.5; }
-@media (prefers-reduced-motion: reduce) { .consultation-hint, .consultation-retry { transition: none; } .consultation-hint:active:not(:disabled), .consultation-retry:active:not(:disabled) { transform: none; } }
+@media (prefers-reduced-motion: reduce) { .consultation-hint, .consultation-retry { transition: none; } .consultation-hint:hover:not(:disabled), .consultation-hint:active:not(:disabled), .consultation-retry:active:not(:disabled) { transform: none; } }
 .consultation-pane button:focus-visible { outline: 2px solid #71845f; outline-offset: 3px; }
 .consultation-suggestion { border-color: #e0e6d6; color: #718163; }
 .consultation-suggestion:hover { border-color: #bac9aa; background: #f4f7ee; }
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index 2e1da537..c052fbfc 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -66,6 +66,18 @@ for (const width of [319, 508]) {
     expect((await row.boundingBox())!.y + (await row.boundingBox())!.height).toBeLessThan((await composer.boundingBox())!.y);
     await shortcuts.first().focus();
     await expect(shortcuts.first()).toHaveCSS('outline-style', 'solid');
+    await expect(shortcuts.first()).toHaveCSS('cursor', 'pointer');
+    await shortcuts.first().hover();
+    await expect(shortcuts.first()).toHaveCSS('transform', 'matrix(1, 0, 0, 1, 0, -1)');
+    await page.mouse.down();
+    await expect(shortcuts.first()).toHaveCSS('transform', 'matrix(1, 0, 0, 1, 0, 1)');
+    await page.mouse.move(0, 0);
+    await page.mouse.up();
+    await page.emulateMedia({ reducedMotion: 'reduce' });
+    await shortcuts.first().hover();
+    await expect(shortcuts.first()).toHaveCSS('transform', 'none');
+    await page.mouse.move(0, 0);
+    await page.emulateMedia({ reducedMotion: 'no-preference' });
     const form = (await panel.locator('form').boundingBox())!;
     expect(form.y + form.height).toBeLessThanOrEqual(800);
     expect(await panel.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
@@ -130,7 +142,7 @@ for (const width of [319, 508]) {
     await expect(hint).toBeEnabled();
     await expect(hint).toHaveText('帮我整体看🧠');
     expect(await hint.evaluate(el => el.scrollWidth <= el.clientWidth && el.scrollHeight <= el.clientHeight)).toBe(true);
-    await expect(hint).toHaveCSS('background-color', 'rgb(248, 241, 226)');
+    await expect(hint).toHaveCSS('background-color', 'rgb(248, 230, 183)');
     const initialSend = (await send.boundingBox())!;
     const hintBounds = (await hint.boundingBox())!;
     expect(hintBounds.x).toBeLessThan(initialSend.x);

From fef3b3aa9bc048a42f5f7b6c0a936c2519afe7dc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?=
 <chillishark@shayulajiaodeMacBook-Air.local>
Date: Tue, 29 Sep 2026 20:25:40 +0800
Subject: [PATCH 19/19] Reduce teacher quick reply card size

---
 .../tasks/20260929-teacher-prompt-buttons-a682d30f.md  | 10 ++++++++++
 README.md                                              |  2 +-
 src/pages/Chat/classroom-workspace.css                 |  5 +++--
 tests/e2e/teacher-reply-layout.spec.ts                 |  4 ++++
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
index 19f496f4..f55adfc8 100644
--- a/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
+++ b/.project-docs/30-worklog/tasks/20260929-teacher-prompt-buttons-a682d30f.md
@@ -73,3 +73,13 @@
 - Completed: 30px borderless buttons now have a warmer pale-yellow fill, 2px bottom shadow and decorative chevron. Hover raises 1px and pressed state lowers 1px; reduced-motion keeps position stable. Exact configured text and accessible name unchanged.
 - Verification: typecheck, lint (0 errors / 8 existing warnings), source and combined-stage production builds, and six focused browser cases passed. Existing cases now exercise hover, pressed and reduced-motion feedback as well as 319/508px layout and exact prompt sends.
 - Trial stylesheet index-ydJGBX8O.css installed and activated without reload. Native screenshot inspected; computed height 30px, font 13px, border 0 and raised shadow confirmed. All storage, inputs, 14 operation messages, teacher message text and route unchanged; focused=false before/after. No cloud changes or live messages sent.
+
+## Smaller Reply Cards Follow-up
+
+- Resumed the same visual refinement task at 79b1dc1; verified ownership, existing planning context and peer registry against the last reviewed state. No new overlap. Gate passed.
+- User identifies the generated three-color reply cards, separate from the configured prompt buttons. Reduce one size: text 16px to 14px, padding 14px/16px to 10px/12px, radius 16px to 12px, gap 10px to 8px, arrow 16px to 14px. Keep full row width and at least a 44px target, colors and click/send behavior.
+- Plan: change scoped CSS, existing browser assertions and docs; build and swap the current trial stylesheet without remounting conversations or changing focus.
+
+- Completed the requested size step for generated reply cards only: 14px text, 10px/12px padding, 12px radius, 8px row gap, 14px chevron and 44px minimum target. Three colors, full-width layout and click behavior unchanged; configured prompt buttons retain their previously approved size/style.
+- Verification: typecheck, full lint (0 errors / 8 existing warnings), source/combined-stage builds and 10 browser reply-history/card interaction cases passed at 319px and 508px.
+- Hot-swapped trial stylesheet index-CZpr_a7Y.css without reload or focus acquisition. Actual three screenshot cards now measure 45.8px high with 14px text. Native image inspected; storage, current text inputs, operation messages, teacher history and route match before the update. No live model calls.
diff --git a/README.md b/README.md
index d88b14c5..437bcae8 100644
--- a/README.md
+++ b/README.md
@@ -171,7 +171,7 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p
 
 - Code 课堂左侧项目栏默认宽 171px，可拖动右边缘在 128–256px 间调整，双击恢复默认并在本机记住宽度；标题栏同步对齐。项目名与会话名超长省略并可悬停查看；右侧咨询栏默认宽 508px，可拖动至 640px，紧凑窗口仍使用覆盖式咨询。
 - 客户端没有内置老师／朋友角色。已下发智能体以头像和名称并排显示在标题栏，点击后打开对应智能体的讨论；数量较多时横向滚动，咨询面板不再提供智能体下拉框。名称、头像、简介、欢迎语和推荐问题均由服务端提供。首次使用默认选择运营指定项，各智能体的未发送草稿分别保存，同一账号与同一智能体只有一个持续聊天，跨项目保留消息和文字草稿；不再显示新话题按钮或话题选择。每轮接受时固定项目、操作对话与当前发布版本；旧的未分配项目草稿可展开查看，不自动转给其他智能体。打开或切换只读取配置和历史，不触发模型；咨询栏支持调整宽度和重新打开。顶栏最右侧面板按钮用于收起／展开老师对话栏，不切换“操作对话／作品”、不改变所选老师，保留历史及两侧输入草稿，也不发送消息。
-- 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 16px、行高 1.8，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
+- 鼠标悬停或键盘聚焦顶部智能体入口时，以奶油色圆角卡片显示该智能体的发布介绍；离开、Escape 或点击入口后收起，没有介绍则不显示空卡片。咨询栏不再显示重复的头像、名称标题条，也不显示介绍及新话题、展开、关闭三个图标；老师身份保留在顶部入口及消息署名中。智能体生成的追加问题以淡蓝、奶油黄、淡紫卡片依次承载，正文 14px、行高 1.7，使用更紧凑的内边距和圆角，保留整卡点击发送与忙碌时禁用。回复下方不再显示重复的输入引导或省略早期消息条数；输入框提示为“和老师聊聊”。再次点击当前入口或在咨询栏按 Escape 可收起，切换其他入口仍直接打开对应讨论；拖动边缘调宽保留，已下发智能体仅保留只读旧记录入口。悬浮介绍不会创建话题、调用模型或确认未读消息，作品原生预览同时避让介绍卡和真实主动气泡。
 - 主动发言采用紧贴小头像的短气泡；只有存在真实主动消息或运营欢迎语时才显示这组浮层，收起消息时头像和气泡一起消失，顶部入口仍保留。长消息在气泡中最多显示三行，点击接回原智能体对话查看全文。不提供“智能体偶尔来看看”开关或本地模拟巡看控制，既有自动跟进与真实消息接收逻辑保留。作品原生预览对整组气泡和头像测量避让，避免图片被原生页面遮住。
 - 新的单会话入口停止旧版前端定时跟进派发；项目主动观察由独立功能衔接，不能重新创建可见话题。未下发目录的旧版入口仍保留原跟进合同：前端每 5 分钟请求一次智能体跟进；窗口隐藏、来源归档、主对话正在执行、智能体正在回复或学生正在智能体栏写草稿时延后。Main 再检查在线启停、来源归属、项目级冷却和已完成文本指纹，未变上下文按下述十五分钟冷却处理。跟进沿用运营模型、已发布 Skills 与当前智能体话题，生成符合所选配置的具体建议或引导；以主动智能体发言持久化，不伪造学生消息。模型调用沿用智能体计费规则。
 - 进入项目时，每位已下发智能体各显示一个浅色自我介绍气泡，外层透明，不显示公共底板、标题或整组关闭入口；整张气泡可点击，独立关闭按钮只收起该老师介绍，优先使用云端介绍，缺省使用发布欢迎语；不调用模型、不声称已检查项目。气泡进入项目即依次出现，不点击时保留到操作 Agent 第 3 轮完整回复结束后自动收起，也可分别关闭；按账号、项目、智能体保存计数及已介绍状态，刷新与操作对话切换延续进度。旧历史、老师咨询、工具调用、重试中间状态、失败／中止和其他项目不计入，新增智能体单独补上并从零计数。点击气泡或头像进入对应咨询，只记住这一位已介绍；咨询期间收起介绍组，关闭后其余未查看介绍仍可见，悬停头像仍可查看完整介绍。没有下发目录的旧入口保留原欢迎语展示兼容。真实的未读主动建议优先替换欢迎语，打开咨询不会自动将这些消息标为已读。主动发言在头像旁直接显示气泡，不抢焦点、不盖住作品；作品区按气泡与原生预览的实际交叠范围避让，已有工具栏高度计入计算，气泡位于独立智能体栏时不额外留白，窗口／分栏尺寸变化和收起气泡时实时归还空间；“和智能体聊聊”接回同一段咨询，“等会儿聊”收起并保留历史。已有未处理气泡时不堆叠新邀请；咨询已展开时仍显示真实未读主动消息气泡，直到学生主动点击查看或收起，期间的其他回复不会吞掉未读邀请。五分钟检查计时在刷新和项目切换后保留；智能体咨询里的新讨论也算进展，即使操作对话没有变化也会继续跟进；上下文完全未变时放缓到十五分钟一次，不永久停止。事件连接丢失时，每十五秒只读同步未完成回复，收到结果后停止轮询，不重复调用模型。失败如实提示，不以本地文案替代模型回复。已接受请求恢复使用原身份，退出账号和来源删除仍沿用 Main 中止边界。
diff --git a/src/pages/Chat/classroom-workspace.css b/src/pages/Chat/classroom-workspace.css
index 149ccb18..4dffb08f 100644
--- a/src/pages/Chat/classroom-workspace.css
+++ b/src/pages/Chat/classroom-workspace.css
@@ -63,8 +63,9 @@
 .consultation-pane button:focus-visible { outline: 2px solid #71845f; outline-offset: 3px; }
 .consultation-suggestion { border-color: #e0e6d6; color: #718163; }
 .consultation-suggestion:hover { border-color: #bac9aa; background: #f4f7ee; }
-.consultation-follow-ups { display: flex; flex-direction: column; gap: 10px; }
-.consultation-follow-up { --card-background: #eef5ff; --card-hover: #e2edfc; --card-border: #d3e3f7; display: flex; width: 100%; min-height: 48px; align-items: center; justify-content: space-between; gap: 12px; padding: 14px 16px; border: 1px solid var(--card-border); border-radius: 16px; background: var(--card-background); color: #344963; font-size: 16px; line-height: 1.8; text-align: left; overflow-wrap: anywhere; cursor: pointer; transition: background-color 150ms ease, border-color 150ms ease; }
+.consultation-follow-ups { display: flex; flex-direction: column; gap: 8px; }
+.consultation-follow-up { --card-background: #eef5ff; --card-hover: #e2edfc; --card-border: #d3e3f7; display: flex; width: 100%; min-height: 44px; align-items: center; justify-content: space-between; gap: 10px; padding: 10px 12px; border: 1px solid var(--card-border); border-radius: 12px; background: var(--card-background); color: #344963; font-size: 14px; line-height: 1.7; text-align: left; overflow-wrap: anywhere; cursor: pointer; transition: background-color 150ms ease, border-color 150ms ease; }
+.consultation-follow-up > svg { width: 14px; height: 14px; }
 .consultation-follow-up:nth-child(3n + 2) { --card-background: #fff4dc; --card-hover: #ffedc5; --card-border: #eeddb5; }
 .consultation-follow-up:nth-child(3n + 3) { --card-background: #f3edfc; --card-hover: #eae0f8; --card-border: #e2d7f2; }
 .consultation-follow-up:hover:not(:disabled) { background: var(--card-hover); }
diff --git a/tests/e2e/teacher-reply-layout.spec.ts b/tests/e2e/teacher-reply-layout.spec.ts
index c052fbfc..7ddfa5dd 100644
--- a/tests/e2e/teacher-reply-layout.spec.ts
+++ b/tests/e2e/teacher-reply-layout.spec.ts
@@ -223,6 +223,10 @@ for (const width of [319, 508]) for (const kind of ['ordinary', 'ideas', 'struct
     await input.fill('保留我的草稿');
     const card = page.getByRole('button', { name: '有什么好玩的想法？' });
     await expect(card).toBeVisible();
+    await expect(card).toHaveCSS('font-size', '14px');
+    await expect(card).toHaveCSS('padding', '10px 12px');
+    await expect(card.locator('svg')).toHaveCSS('width', '14px');
+    expect((await card.boundingBox())!.height).toBeGreaterThanOrEqual(44);
     expect(await card.evaluate(el => el.scrollWidth <= el.clientWidth)).toBe(true);
     await card.click();
     await expect(page.getByText('好，我们就从这一个问题聊起。')).toBeVisible();