From f7b2063dfe2ca44b0c5d17d90a2a58e0c44ff2a1 Mon Sep 17 00:00:00 2001 From: brother7 <7brother7@gmail.com> Date: Thu, 24 Sep 2026 15:45:18 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E9=A1=B6=E6=A0=8F?= =?UTF-8?q?=E6=99=BA=E8=83=BD=E4=BD=93=E5=88=87=E6=8D=A2=E9=9B=86=E6=88=90?= =?UTF-8?q?=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../10-decisions/ADR-2026-09-22-coding-teacher.md | 5 ++++- .project-docs/20-architecture/system-overview.md | 2 +- .project-docs/30-worklog/current-state.md | 2 ++ .../20260924-merge-agent-rendering-ml-4efb196c.md | 10 ++++++++++ 4 files changed, 17 insertions(+), 2 deletions(-) diff --git a/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md b/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md index e83e75cc..2237c265 100644 --- a/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md +++ b/.project-docs/10-decisions/ADR-2026-09-22-coding-teacher.md @@ -15,7 +15,8 @@ - 云端保存老师消息、执行和收到的片段；Main 按账号、项目和来源会话保存话题索引与展示历史。旧本地老师话题保留原路径。停用阻止后续调用，历史仍可查看；断线按游标和持久状态恢复，重启后中断旧问题，下次提问先停止旧问题再绑定新上下文。 - Code 咨询统一使用服务端下发智能体，不内置老师／朋友角色、本地教学人设或按名称分配的工具权限。名称、头像、简介、欢迎语和推荐问题均来自发布定义；新话题使用用户选择或运营默认项，已有话题继续固定原定义和版本。所有下发项共享上述只读工具边界，通用讨论组件协议不定义智能体人格。 - 右侧咨询保留已实现的结构化讨论和主动跟进：自动检查在隐藏窗口、操作会话运行、来源归档、智能体回复或咨询草稿编辑期间延后，Main 再校验来源、启停和冷却。跟进使用同一发布定义与学生计费，不伪造学生消息。正文、保存历史和带回草稿仅接收云端主线程文本；子线程事件仍推进续传游标。带回回答只追加草稿，不自动发送。Code/Pi 执行和项目 Plugin 生命周期保持各自边界。 -- 当前咨询与草稿按账号、项目保存，每轮绑定当时的操作会话。旧客户端生成的朋友话题及草稿只读保留，不再继续调用，也不自动绑定云端智能体；旧来源会话级历史不自动迁移。现有云端 `coding-teacher` 契约与存储名保留为实现兼容，不构成角色分类。 +- 所有下发智能体以头像和名称在顶栏并排展示，点击直接切换，移除面板内的新话题智能体下拉框；数量多时在顶栏内横向滚动，不挤占窗口控件。切换恢复所选智能体的历史或空输入框，不创建话题、不发起模型调用；新话题使用所选项的当前发布版本，旧话题仍固定原版本。历史菜单保留，查看其他智能体的话题时同步顶栏选中项。 +- 当前咨询历史按账号、项目保存，每轮绑定当时的操作会话；未发送草稿按账号、项目及服务端智能体 ID 分别保存。旧项目级未归属草稿折叠保留供查看，不猜测归属或自动填入其他智能体。旧客户端生成的朋友话题及草稿只读保留，不再继续调用，也不自动绑定云端智能体；旧来源会话级历史不自动迁移。现有云端 `coding-teacher` 契约与存储名保留为实现兼容，不构成角色分类。 - 输入预算在编译时计入完整执行请求。本地旧模型路径按约 2 UTF-8 字节估算 1 Token，工具定义、调用和读取预留纳入同一计量；估算不替代模型上限或实际 usage。云端以完整 JSON 转义后的 query 字节数裁剪来源节选，原文仍可按 ID 读取。固定配置／当前讨论超限与用户问题／引用超限分别提示，不静默修改发布预算、问题、明确引用或话题版本。 - 咨询回答以 Markdown 渲染标题、列表、表格、代码、HTTP(S) 链接/图片和公式，代码与表格在栏内滚动；普通 JSON、Markdown 链接与代码中的字面转义保持原义。discussion-v1 仅由顶层 reply/quickReplies/tool 或专用围栏识别，组件仍遵循既有生命周期。解析失败保留原讨论卡与可恢复正文，完整 unparsedResponse 单独持久保存并默认折叠，不再次注入后续会话上下文。 @@ -23,6 +24,8 @@ ## Evidence And Release Boundary +- 2026-09-24 用户明确要求多智能体在顶栏铺开并授权合并，客户端源 `a10cf000157a1a3edcfad43705e0824f19568a33` 已快进纳入本地 `main`。源相关单测、17 项浏览器布局和 1 项 Electron 夹具交互、类型／lint／构建通过，具体分批验证见[源记录](../30-worklog/tasks/20260924-consultation-topbar-22717e99.md)。合并未改变已测产品字节；不代表已更新安装版或真实供应商验收。 + - 2026-09-24 渲染源 `97837cef90baf6bb02cfda0cef7b938081f3c5f7` 与 Yuxi 配套源 `02f27f33a8b816589036503f0720d446418c28aa` 已纳入本地主分支集成。客户端源 287 项单测、12 项真实浏览器布局用例及独立审查通过；Yuxi 82 项相关协议回归与真实 LangGraph 确定性模型测试通过。浏览器接口为替身，不代表安装版或线上模型已验收；旧版已覆盖的失败原文无法恢复。 - 2026-09-24 客户端源 `8a157be4f62d073744164318e02185aebeaadc09` 包含预算修复 `de72b1cd945df373d09402a1cf3a0e9b34832f03`。预算修复通过 289 项相关测试；统一智能体覆盖 323 项相关用例、类型／lint／生产构建、2 项 Electron 交互和 13 项布局测试。扩展 Main 类型检查仍有基线 66 项诊断，无新增；不代表真实收费模型、已安装客户端或生产整链验收。详见两份源任务记录。 diff --git a/.project-docs/20-architecture/system-overview.md b/.project-docs/20-architecture/system-overview.md index 6b6782ff..0d2b09bc 100644 --- a/.project-docs/20-architecture/system-overview.md +++ b/.project-docs/20-architecture/system-overview.md @@ -1,6 +1,6 @@ # System Overview -Code 咨询由 Works Square 运营下发的 Yuxi 智能体执行，客户端不内置老师／朋友角色；发布定义提供名称、头像、人设、欢迎语和推荐问题。Main 按账号／项目管理本机话题与草稿，每轮绑定当前操作会话和已完成 Pi 公开消息，执行云端请求的三个只读工具后主动回传结果；Yuxi 保存云端消息和收到的片段。学生支付咨询模型费用，个人 Agents 保持创建者付费。新话题使用所选或默认项，旧话题固定版本；旧合成朋友历史及草稿仅查看。结构化讨论和现有主动跟进协议保留。正文只接收云端主线程文本，子线程事件仍推进续传游标。Code 默认 Agent、项目下会话和 Pi 执行保持原边界。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 +Code 咨询由 Works Square 运营下发的 Yuxi 智能体执行，客户端不内置老师／朋友角色；发布定义提供名称、头像、人设、欢迎语和推荐问题。Main 按账号／项目管理本机话题，Renderer 按账号／项目／服务端智能体 ID 保存未发送草稿。每轮绑定当前操作会话和已完成 Pi 公开消息，执行云端请求的三个只读工具后主动回传结果；Yuxi 保存云端消息和收到的片段。学生支付咨询模型费用，个人 Agents 保持创建者付费。全部下发智能体在顶栏以头像和名称直接选择，溢出横向滚动；面板不再提供智能体下拉框。选择恢复对应历史或空输入框，不创建话题或调用模型。新话题使用所选或默认项，旧话题固定版本；旧未归属项目草稿、合成朋友历史及草稿仅查看。结构化讨论和现有主动跟进协议保留。正文只接收云端主线程文本，子线程事件仍推进续传游标。Code 默认 Agent、项目下会话和 Pi 执行保持原边界。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 ## Current Architecture diff --git a/.project-docs/30-worklog/current-state.md b/.project-docs/30-worklog/current-state.md index 38f421a5..1a85daee 100644 --- a/.project-docs/30-worklog/current-state.md +++ b/.project-docs/30-worklog/current-state.md @@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre ## Integrated Through +- 2026-09-24：从 `39b03a1628bcdbc9c6bcf82b874e2814bf1780d0` 无冲突快进合入客户端源 `a10cf000157a1a3edcfad43705e0824f19568a33`。所有下发智能体在顶栏并排显示头像与名称，点击恢复对应历史或空输入框，数量多时横向滚动；移除面板智能体下拉框。草稿按账号／项目／智能体分别保存，旧未归属草稿只读折叠保留；旧话题版本、学生计费和三个只读工具保持。产品与测试文件和源完全一致，沿用源相关单测、17 项浏览器布局、1 项 Electron 交互及类型／lint／构建证据；本次只追加集成文档。3 份原有未提交文档保持，未推送、打包、安装或部署。详见[源记录](tasks/20260924-consultation-topbar-22717e99.md)、[集成记录](tasks/20260924-merge-agent-rendering-ml-4efb196c.md)和[咨询决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 + - 2026-09-24：在 `d2150ce5de5cec541f65eba9260d3cdc5172a66d` 上无冲突集成源 `97837cef90baf6bb02cfda0cef7b938081f3c5f7`，保留主线工作台样式。咨询支持 Markdown/表格/代码/公式/图片，普通 JSON 与代码不再被误判为讨论协议；格式失败原文独立折叠留存，工具名称/状态独立展示，修复多余数字 0。配套 Yuxi 源 `02f27f33a8b816589036503f0720d446418c28aa` 在主分支保证 AI 角色投影。合并树重新通过 287 项相关单测、12 项 319/508px 浏览器布局、Renderer typecheck、scoped lint 和 Vite 全目标构建。未推送、打包或部署，真实模型整链验收未执行。旧版已覆盖的原文不能恢复。详见[源任务](tasks/20260924-agent-rendering-a8c2d419.md)、[集成记录](tasks/20260924-merge-agent-rendering-ml-4efb196c.md)及[咨询决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。用户批准释放旧集成登记，并以当前主线为基线重新登记；原三份未提交文档仍原样保留，不修改历史来源记录。 - 2026-09-24：将客户端源 `8a157be4f62d073744164318e02185aebeaadc09` 从 `eb3dc85a2f0ed8457b7f24684c2da3ab192c2e46` 无冲突快进合入本地 `main`，包括预算修复 `de72b1cd945df373d09402a1cf3a0e9b34832f03` 及其源记录 `248776d8550d67de7ce30802a9f827d432c42a99`。 diff --git a/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md b/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md index 4ef56b2b..46324dec 100644 --- a/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md +++ b/.project-docs/30-worklog/tasks/20260924-merge-agent-rendering-ml-4efb196c.md @@ -42,3 +42,13 @@ ## Promotion Candidates - Accepted source candidates promoted in integration mode to the teacher ADR, system overview and current-state. No product direction, billing, version or file-permission conflict remains. + +## Follow-up: Distributed Agent Titlebar + +- User authorized integration of source a10cf000157a1a3edcfad43705e0824f19568a33 after accepting direct topbar agent entries. Current main is source base 39b03a1628bcdbc9c6bcf82b874e2814bf1780d0; source is clean and ready. +- Concurrent/Planning/Integration Gates Passed on same-task resume. Official ownership, reservation and integration lock match Identity. Read own/source outcomes and candidates, current accepted documents; reused unchanged 115 peer scopes, with source completion re-read. No concrete dependency on historical placeholder records and no semantic conflict. Existing three adopted untracked documents remain unchanged. +- Plan: fast-forward the tested source; verify product and source-record equality; promote approved topbar/history/draft facts; pass documentation drift and complete. Exact source bytes reuse recorded verification rather than rerunning unchanged tests. No push, package, installation, deployment or new reviewer. +- Outcome: main fast-forwarded from 39b03a1628bcdbc9c6bcf82b874e2814bf1780d0 to a10cf000157a1a3edcfad43705e0824f19568a33 without conflicts. Product, tests, README and the imported source task record exactly match source. Only this integration record, teacher ADR, system overview and current-state were updated afterward; source records remain read-only. +- Verification: source ancestry and exact product/source-record diff passed. Reused source 305 related unit tests, later 53 affected hook/UI tests and 1 newly added focused draft regression, 17 browser layout cases, 1 real Electron fixture interaction, Renderer typecheck, scoped ESLint and Vite all-target build. These are separate runs, not a claim that the final 306-case suite was rerun. No production provider or installed-client acceptance; existing Main strict-typecheck baseline is not changed. +- Accepted promotions: direct server-agent titlebar entries, per-agent draft/history selection, horizontal overflow and removal of the agent dropdown. Historical topic versions, student billing and local read tools unchanged. No new semantic conflict. +- Follow-up: source checkout remains pending separate cleanup consent; branch and commit must be preserved if retired. Earlier rendering-checkout cleanup remains pending. No push, packaging, installation or deployment performed.- Final gate: official task-aware documentation drift and git diff --check passed; the three adopted foreign documents remain unchanged and excluded from staging.