Merge single ongoing agent conversations into main

This commit is contained in:
2026-09-28 14:35:49 +08:00
32 changed files with 1442 additions and 149 deletions

View File

@@ -1,6 +1,6 @@
# ADR: 官方编程老师与项目会话导航
- Status: Accepted / implemented, paged reads amended 2026-09-27
- Status: Accepted / implemented, single ongoing chat amended 2026-09-28
- Date: 2026-09-22
- Approval: 用户确认项目默认 Agent、项目下会话、多老师列表与移除试聊;随后确认使用 Yuxi 原生智能体、客户端提供三个只读工具、沿用学生账号付费,并要求实施及合并。2026-09-24 明确取消客户端固定老师/朋友分类,统一使用后端下发智能体,并要求合并上下文预算修复。
@@ -10,17 +10,19 @@
## Decision
- 2026-09-28 用户确认像微信联系人一样,每个账号与每个下发智能体只有一个持续聊天,并授权实施与合入主分支。以稳定 config_id 标识智能体,不按名称、默认标记、项目或版本创建第二个可见聊天;本次范围为本机持久化,不含跨设备同步。
- 新项目创建内部默认编程 Agent 并保存 defaultAgentId,会话直接列在项目下。打开项目不自动创建空会话,首次发送或显式新建才创建;历史 Agent ID、配置和 Pi 会话绑定保留。
- Yuxi 拥有老师提示词、模型和所选 Skills、知识库、MCP、子智能体。Works Square 运营菜单首先展示下发列表,添加时从 Yuxi 选择并发布当前配置,支持多位、默认选择与启停,不维护第二份提示词编辑器或试聊界面。
- 运营显式同步 Yuxi 配置产生不可变下发版本。新话题可选择已下发老师,默认使用运营指定老师;已有话题固定原版本。配置与资源绑定固定,Skill 按问题建立运行快照,知识内容和远端工具仍由各自服务拥有;资源撤销可能阻止执行,版本不表示复制全部外部资源。
- 运营显式同步 Yuxi 配置产生不可变下发版本。每次接受新问题使用当前已下发版本,运行中的问题保持原版本;版本变化不另建可见聊天。配置与资源绑定固定,Skill 按问题建立运行快照,知识内容和远端工具仍由各自服务拥有;资源撤销可能阻止执行,版本不表示复制全部外部资源。
- Yuxi 原生 Request/Run、PostgreSQL checkpoint 和 Redis 事件拥有云执行。Main 冻结本次账号、项目、来源 Pi 已完成分支的公开消息及老师话题,通过三个只读工具提供目录、UTF-8 文件行段和会话原文。文件按读取时内容提供,会话按本轮快照读取,不上传完整工程、Pi 原始日志或思考。
- 本地工具只交给老师主线程:云端持久中断完整批次,Main 主动回传配对结果,关联 Run 续接同一问题。用户于 2026-09-27 授权改造读取工具:声明 read_protocol=2 的客户端支持按层目录与连续原文分页,每问题最多 12 批、成功结果累计 64 KiB、单页 8 KiB,剩余不足 512 字节时收尾;旧客户端保持六批。最后结果消费后显式禁止继续选工具并要求基于已有证据回答。保留原付款人、版本、上下文和截止时间;读取限当前项目,允许 .makelore/project.json,排除其余内部记录与 Git 数据,不提供本地写入或命令。
- Works Square 验证学生编程资格,使用专用短期老师凭据;聊天模型费用记入学生 ai_programming / coding_teacher 账本。老师资源仍归 Yuxi 创建者,个人 Agents 模块继续创建者付费,老师问题不占创建者个人智能体金额上限。
- 云端保存老师消息、执行和收到的片段;Main 按账号、项目和来源会话保存话题索引与展示历史。旧本地老师话题保留原路径。停用阻止后续调用,历史仍可查看;断线按游标和持久状态恢复,重启后中断旧问题,下次提问先停止旧问题再绑定新上下文。
- Code 咨询统一使用服务端下发智能体,不内置老师/朋友角色、本地教学人设或按名称分配的工具权限。名称、头像、简介、欢迎语和推荐问题均来自发布定义;新话题使用用户选择或运营默认项,已有话题继续固定原定义和版本。所有下发项共享上述只读工具边界,通用讨论组件协议不定义智能体人格。
- 右侧咨询保留已实现的结构化讨论和主动跟进:自动检查在隐藏窗口、操作会话运行、来源归档、智能体回复或咨询草稿编辑期间延后,Main 再校验来源、启停和冷却。跟进使用同一发布定义与学生计费,不伪造学生消息。正文、保存历史和带回草稿仅接收云端主线程文本;子线程事件仍推进续传游标。带回回答只追加草稿,不自动发送。Code/Pi 执行和项目 Plugin 生命周期保持各自边界。
- 所有下发智能体以头像和名称在顶栏并排展示,点击直接切换,移除面板内的新话题智能体下拉框;数量多时在顶栏内横向滚动,不挤占窗口控件。切换恢复所选智能体的历史或空输入框,不创建话题、不发起模型调用;新话题使用所选项的当前发布版本,旧话题仍固定原版本。历史菜单保留,查看其他智能体的话题时同步顶栏选中项。
- 当前咨询历史按账号、项目保存,每轮绑定当时的操作会话;未发送草稿按账号、项目及服务端智能体 ID 分别保存。旧项目级未归属草稿折叠保留供查看,不猜测归属或自动填入其他智能体。旧客户端生成的朋友话题及草稿只读保留,不再继续调用,也不自动绑定云端智能体;旧来源会话级历史不自动迁移。现有云端 `coding-teacher` 契约与存储名保留为实现兼容,不构成角色分类。
- 云端保存执行线程、消息和收到的片段。Main 在 userData/agent-conversations/<account>/<agent> 保存轻量聊天索引和独立轮文件;每页50轮,流事件只更新当前轮。轮文件先于索引原子保存,恢复不重发模型。停用阻止后续调用,历史仍可查看;重启将未完成问题标为中断,下次提问先停止旧问题。
- 每轮冻结项目、Pi 来源、发布版本及只读范围。相同项目/来源/版本沿用内部 Yuxi 线程,任一改变都开启内部执行段,携带有预算的公开近期交流;可见聊天保持连续。历史消息可按 ID 读取,读到另一项目的旧交流不授予其文件权限。Pi 与项目配置仍归项目所有。
- Code 咨询统一使用服务端下发智能体,不内置老师/朋友角色、本地教学人设或按名称分配的工具权限。名称、头像、简介、欢迎语和推荐问题来自发布定义。所有下发项共享上述只读工具边界,通用讨论组件协议不定义智能体人格。
- 结构化讨论在聊天内按项目保存,历史轮保留原卡片快照。正文、历史和带回草稿仅接收云端主线程文本;子线程事件仍推进续传游标。带回回答只追加原项目/Pi 来源的草稿,不自动发送或改写当前其他来源。已下发智能体的旧 Renderer 定时跟进停止派发;新的 Main 主动观察由独立任务实施,本次未接入建议投递,后续必须并入同一聊天,不能恢复项目话题入口。
- 所有下发智能体以头像和名称在顶栏并排展示,溢出横向滚动。点击恢复唯一聊天或空态、独立草稿和未读,不调用模型;移除新话题加号和话题下拉框。旧原始记录保留单独只读入口。最近50轮先加载,历史分页与流事件按请求身份合并;切换智能体保留窗口内阅读位置,已读位置由 Main 持久保存。
- 未发送文字草稿按账号/智能体保存;明确引用仍携带项目/Pi 来源,来源切换后须移除旧引用或恢复原上下文才能发送。只导入已登记项目中能证明当前账号与 config_id 归属的旧话题,以项目/话题/请求来源身份去重,原文件保留;重复正文不去重,失联目录稍后重试。无法证明归属的朋友/旧老师历史及旧草稿只读保留,不猜测身份。移除项目不删除账号级聊天;现有云端 coding-teacher 名称不构成角色分类。
- 输入预算在编译时计入完整执行请求。本地旧模型路径按约 2 UTF-8 字节估算 1 Token,工具定义、调用和读取预留纳入同一计量;估算不替代模型上限或实际 usage。云端以完整 JSON 转义后的 query 字节数裁剪来源节选,原文仍可按 ID 读取。固定配置/当前讨论超限与用户问题/引用超限分别提示,不静默修改发布预算、问题、明确引用或话题版本。
- 咨询回答以 Markdown 渲染标题、列表、表格、代码、HTTP(S) 链接/图片和公式,代码与表格在栏内滚动;普通 JSON、Markdown 链接与代码中的字面转义保持原义。discussion-v1 仅由顶层 reply/quickReplies/tool 或专用围栏识别,组件仍遵循既有生命周期。解析失败保留原讨论卡与可恢复正文,完整 unparsedResponse 单独持久保存并默认折叠,不再次注入后续会话上下文。
@@ -28,6 +30,7 @@
## Evidence And Release Boundary
- 2026-09-28 单会话源 `7aa81da616449dead25557476cf4f1433edf84b5` 已纳入本地 main。源365项相关单测、Renderer typecheck、变更文件 lint、Vite构建和真实 Electron 夹具交互通过;扩展 Main 检查与基线同为66项既有诊断。合并保持产品/测试与源一致,不重跑相同验证。未推送、打包、部署或进行真实付费模型验收;主动观察组合验收另行完成。见[源任务](../30-worklog/tasks/20260928-agent-single-chat-27da516b.md)及[集成记录](../30-worklog/tasks/20260928-merge-agent-single-chat-9911c6df.md)。下方旧话题交互证据仅记录当时版本。
- 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 确定性模型测试通过。浏览器接口为替身,不代表安装版或线上模型已验收;旧版已覆盖的失败原文无法恢复。

View File

@@ -2,7 +2,7 @@
- 2026-09-26 已确认[老师 Agent 产品定位](../00-brief/project-positioning.md#老师-agent-的产品定位):某一领域杰出人物的能力转化而成的智能体,供平台学生使用;蒸馏属于实现方法,以真实案例验证领域能力;补充下方既有咨询技术决定。
- [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-24 amended / implemented;取消固定老师/朋友分类,运营下发 Yuxi 智能体并指定默认,发布定义拥有人设与显示资料,Main 提供一致的项目/会话只读工具。旧合成朋友话题与草稿只读保留;学生计费、版本固定与主线程正文路由保持,输入预算区分近似 Token 与精确 JSON 字节。
- [下发智能体咨询与项目会话导航](ADR-2026-09-22-coding-teacher.md):2026-09-28 amended / implemented;每个账号与下发智能体使用唯一持续聊天,跨项目保留历史,移除新话题和话题选择。项目/Pi 来源/发布版本在每轮接受时冻结,变化时只轮转内部线程。Main 持久化分页历史与已读,草稿按账号/智能体隔离;可证明归属的旧话题导入且原文件保留,其余只读。学生计费、统一只读工具和主线程正文保持;主动观察建议接入由独立任务继续。
## Active Decisions

View File

@@ -0,0 +1,147 @@
# 用户与下发智能体的单一持续会话
- 日期:2026-09-28
- 状态:待采纳设计;尚未修改产品代码或已接受 ADR。
- 任务:20260928-agent-single-chat-27da516b
- 代码基线:b26e25c9ed26bf30f4d0bc03869c223f0fe34386
- 用户要求:像微信联系人聊天,一个用户与一个智能体只有一个可见会话。
- 范围解释:按用户+智能体理解为跨项目连续聊天;先保持现有本机历史持久化范围,不承诺跨设备同步。
## 1. 用户体验
顶栏继续显示所有已下发智能体。点头像直接恢复这个用户与该智能体的唯一聊天、草稿、未读和阅读位置。移除学生面板的“新话题”加号和“以往讨论/选择话题”下拉框。向上滚动加载更早消息。
切换项目或 Pi 会话不另建可见会话。输入区显示本轮上下文,例如“当前项目:天气 App · 操作对话:我要做个天气 App”;上下文变化时在下一轮提问旁显示来源。已开始的问题仍绑定原项目,切页不会改走它的文件读取路径。
不同智能体各有自己的聊天;昵称、头像、默认项、发布版本变化不会变成另一个联系人。保留已有 Markdown、工具活动和结构化讨论渲染,不顺带增加附件、搜索或聊天删除系统。
## 2. 已确认现状与改造位置
| 源码 | 已确认事实 | 影响 |
| --- | --- | --- |
| electron/coding-teacher/service.ts | scopedStore 在项目 .makelore/teacher-conversations/账号/范围下存历史;create 每次生成 UUID;topic 固定项目和版本 | 会话身份与本轮上下文分离 |
| shared/coding-teacher.ts | TeacherTopic 持有 projectId、version、definition;TeacherRequest 只有可选 sourceConversationId | 项目与发布版本下沉到请求 |
| electron/coding-teacher/cloud-runner.ts | thread_id = topic.id;teacher_version = topic.version;local_context.scope 使用 topic.projectId | 可见聊天 ID 和云执行线程 ID 解耦 |
| electron/coding-teacher/store.ts | topic 文件包含全部 requests;list 读取各 topic 文件 | 改为分页读取,避免永久聊天全量加载 |
| electron/api/routes/coding-teacher.ts | 项目级 agent-topics 路由;SSE 发送完整 topic | 按联系人读写,事件只更新目标轮次 |
| src/pages/Chat/TeacherChatPanel.tsx、use-teacher-companion.ts | 话题选择和显式新建;状态、草稿以 account/project/agent 组织 | 归属改为 account/agent,项目只作上下文 |
这些结论来自本地源码和老师 ADR,不代表部署验收。本轮未检查 Yuxi 服务端线程绑定与压缩实现;实施前必须核实。
## 3. 数据结构
### AgentConversation:唯一可见聊天
- 唯一键:accountId + agentId。agentId 使用目录稳定 teacher_id,对应 definition.config_id,不使用名称、版本或默认标记。
- 保存 conversationId、创建/更新时间、最后消息、未读游标、阅读位置及当前执行段。
- 首次真正保存消息时由 Main 串行获取或创建;多窗口并发不能生成两个聊天。打开空面板不触发模型。
- 运营同步同一个配置沿用身份;删除后重新创建得到新配置 ID,视作另一智能体,不按同名合并。
- 当前展示资料使用已下发配置;历史保留执行版本及必要显示快照。
### ConversationTurn:每轮请求
在现有 TeacherRequest 上明确保存:
- requestId、conversationId、问题/引用/回答、状态、工具活动、用量。
- projectId、项目名称快照、sourceConversationId、来源游标和采集时间。
- teacherVersion、runtimeThreadId、云 request/run ID。
- 用户提问或主动建议来源、结构化讨论引用。
Main 接受时冻结项目、来源和版本,使用现有项目服务校验 Pi 会话归属并解析路径。Renderer 不传任意本地路径。流式回调按 requestId 更新目标轮,不能继续假设数组最后一项就是当前请求,因为主动建议可能同时到达。
### RuntimeSegment:内部执行段
建议同项目、同发布版本连续提问复用当前 Yuxi 线程。下一次发送发现项目或版本改变时,创建内部线程,带入有预算的近期交流及相关状态;旧消息仍显示在同一时间线。A → B → A 可以产生新执行段,不需要后台线程池。只切换页面或头像不建线程、不收费。
历史过长优先使用已验证的 Yuxi 压缩能力;若该能力不满足合同,可使用相同执行段机制轮转,并带入有界上下文。实施前验证服务端能力,不假定已有压缩,也不把全部历史不断追加到 query。摘要若调用模型,必须沿用学生计费链并明确触发,不新增定时总结调用。
这可利用现有 thread_id 参数;初步判断客户端为主要改动。Yuxi 是否需要补充压缩或恢复接口,在实施时依据其源码与测试确定。Works 继续负责目录、版本和学生身份,无需为此新增运营会话管理。
## 4. 发送与恢复
建议 Host API(名称在实施时按项目风格收敛):
- GET /api/coding/agents/:agentId/conversation:读取唯一聊天或空态。
- GET /api/coding/agent-conversations/:id/messages?before=...&limit=50:历史页。
- POST /api/coding/agents/:agentId/messages:幂等创建聊天、冻结上下文并接受问题。
- GET /api/coding/agent-conversations/:id/events:活动轮、未读和状态事件。
- POST /api/coding/agent-conversations/:id/requests/:requestId/cancel:取消精确请求。
断网、切页、重开只查询/订阅原状态,不重放计费问题。重复提交沿用 requestId。同一用户与智能体一次接受一轮主动问答;运行时可编辑草稿、等待或停止,先不引入消息队列。不同智能体沿用现有总运行约束。
历史页与事件按消息序号/revision 合并,避免分页覆盖流式结果;先显示最近 50 轮,向上加载,保持阅读锚点,阅读较早消息时不强制滚到底部。
每轮只读工具仍使用冻结 projectPath、Pi 消息快照、账号与取消状态;现有分页、预算和最终回答规则保持。其他项目的历史聊天文本不授予读取那些项目文件的权限。
草稿文字归用户+智能体,代码/消息引用携带项目与 Pi 来源。切项目后若草稿有旧引用,发送前明确保留旧上下文或移除引用,不能静默解释成新项目资料。“带回操作对话”定位消息原目标,不写入碰巧打开的另一会话。无有效项目时保留历史与草稿;普通无项目聊天需核对云合同,第一版可继续要求选择项目,不伪造上下文。
## 5. 配置与结构化讨论
版本改为“每轮接受时固定”:下一轮使用当前已下发版本;已运行轮次保持原版本;必要时切内部执行段,聊天不重建。停用禁止新调用,历史可读;同 ID 重启下发继续原聊天。运行中停用、取消和结算遵守原服务端规则。
现有 topic.discussion 不能直接合并成一个跨项目对象。卡片保留独立 ID、projectId、revision 与历史快照,当前只激活对应项目的讨论对象。操作旧项目卡片应明确恢复其来源上下文,不能套用当前项目卡片。
## 6. 持久化与旧历史
建议使用现有 app userData 根下新增账号隔离的 agent-conversations 目录,不改变全局路径配置。项目源文件和 Pi 会话继续在项目目录。移除项目不会连带删除用户与智能体的全部聊天。
使用轻量聊天索引加每轮独立文件,复用现有原子写文件能力,不新增数据库依赖。仅写当前轮和必要元数据;验证轮文件/索引在退出中断时可恢复,不能重发模型问题。
旧记录接入:
1. 只扫描应用已登记项目的既有老师历史目录、当前账号;不扫描整块磁盘。
2. 相同 definition.config_id 的旧话题归入同一聊天,按发生时间展示,保存 originProjectId/originTopicId/originRequestId;同时间用来源 ID 稳定排序。
3. 使用来源 ID 判定是否已接入,不按正文去重;重复问同一句话仍是两条消息。
4. 原文件保留,新结构写入成功才记录进度,重启可继续,不原地覆盖。
5. 无法证明身份的旧合成朋友/旧老师记录继续只读,通过单独旧记录入口查看,不按名字猜归属。
6. 失联项目稍后重新打开时再接入;不宣称已收集所有磁盘历史。
7. 不合并云端 checkpoint;旧运行结束或取消后启用新发送。只带入必要公开交流,不重新执行旧问题或上传完整工程。
8. 多份草稿只选择身份明确的一份恢复,其余保留供恢复,不用最后写入覆盖所有内容。
本方案先保持本机持久化。若需要同账号跨设备共享记录,必须增加服务端唯一会话与同步游标,文件读取仍绑定发起设备;各机器独立 UUID 无法保证跨设备唯一。
## 7. 并行主动观察任务
20260928-agent-observer-design-9c41a872 的记录显示正在实施项目选择观察者及轮数/空闲/冷却触发。其代码尚不属于本方案基线。建议由 Main 提供幂等的“向 accountId + agentId 聊天追加观察结果”操作,带 originatingProjectId 和 observationId。
观察调度仍按项目,无建议不制造空消息,有建议进入同一个聊天并产生对应头像未读。观察运行不能复用或挤占正在运行的主动问答线程。先前提到的按 requestId 更新可防止结果写错轮次。
实施前刷新该任务与 20260928-consultation-scope-83fa19c2 的记录;后者目前为模板、范围未知。明确 shared DTO、service、hook 和面板的文件所有权后再写产品代码。本轮仅写独立方案,不干扰并行实现。
## 8. 实施顺序与验收
1. 确认数据合同、云端线程/版本约束与并行接口,完成 Main 唯一存储和幂等发送。
2. 接入旧历史,冻结每轮项目/版本,验证执行段与云端恢复。
3. 替换话题 UI,接分页、上下文提示、草稿/阅读位置/未读。
4. 主动建议通过统一消息入口接入,完成联调。
实施必须验证:
- 双窗口、重试和重启只产生一个聊天和一次模型调用。
- 同智能体跨项目保留历史;A 请求运行中切 B,工具仍只读 A。
- 不同账号、智能体的消息/草稿/未读隔离。
- 下一轮采用新发布版本,运行中轮次不被切换。
- 重复正文、同时间旧消息、中断接入及失联项目不丢记录、不复制调用。
- 数千轮历史分页,流式结果不被翻页覆盖,阅读位置不跳动。
- 断网/关闭/取消/退出恢复不重发,不留假运行状态。
- 原项目或 Pi 来源删除后历史仍可读,旧引用/卡片不能误操作新项目。
- 主动建议和问答同时返回,分别更新正确记录,未读只追加一次。
- 顶栏打开即持续聊天,无学生新话题加号及话题下拉框。
设计阶段未运行产品测试、构建、真实收费模型或云端验收。实施时应做聚焦 Store/Service/API/Renderer 回归、Electron 切项目与分页流程、类型检查和生产构建。
## 9. 采纳与规范
待实施批准并验证后,在集成阶段更新老师 ADR、system-overview、data-flow、business-rules、README:
- 账号+项目+话题改为账号+智能体;
- 项目/Pi 来源改为每轮冻结上下文;
- 话题固定版本改为每轮接受时固定版本;
- 建议/讨论/问答共用联系人时间线,各自保留项目来源。
当前已接受决策保持不变。本提案不会把尚未实现的行为写成现状。
## 10. 实施结果(2026-09-28)
用户已批准实施和既有主动观察任务协调。单会话客户端已实现;具体数据、路由、验证和集成边界以[任务记录](../../30-worklog/tasks/20260928-agent-single-chat-27da516b.md)为准。
实际采用 `/api/coding/agent-conversations/:agentId` 系列接口;Main 原子保存轻量索引和独立轮文件,每页50轮,流事件仅传当前轮。云端源码协调结果显示线程同时绑定项目和Pi来源,故项目、Pi来源或版本改变都会切换内部线程;同段沿用现有Yuxi压缩,新段只携带有预算的公开历史。本机长历史可由只读工具按消息ID取回。
正文草稿、已读位置和旧记录已处理;滚动位置和已加载页的缓存只维持当前窗口生命周期。未进行跨设备同步或生产付费模型验收。旧原始记录全部保留,可从只读入口查看。
主动观察实现仍在另一任务独立审查中,尚未进入本分支。其“继续讨论”仍创建项目话题,必须在两项集成时改为同一聊天的幂等建议投递/定位;不能把接口协调记为组合功能已实现。单会话方向已经用户批准,共享规范的正式更新留给集成任务。

View File

@@ -4,11 +4,11 @@
目录式创建 → Main 保存项目与 defaultAgentId → 项目直接列出会话 → 首次发送或显式新建创建 Conversation → 原 Pi 执行链。历史会话继续使用原 Agent 绑定;切换项目丢弃旧读取。
统一智能体入口/选择已下发项 → Main 获取 WS 专用凭据,以所选或运营默认智能体创建项目级话题并固定版本 → 保存问题身份及当前账号/项目/本轮 Pi 公开消息快照 → Yuxi 原生 Request/Run。名称、人设和展示资料来自发布定义,不叠加本地老师/朋友人格。持久读取中断 → Main 校验绑定与取消状态 → 列目录/读取文件/读取会话原文 → 主动 POST 完整配对结果 → checkpoint 关联 Run 续接。所有下发项均遵守相同工具边界。最多六批读取,保留原问题时限与学生付款人;文件使用读取时内容,会话使用本轮快照。云端保存消息和收到的片段,完整工程与 Pi 原始日志保留本机。
顶栏选择下发智能体 → Main 读取账号/智能体唯一聊天与最近50轮,打开本身不调用模型 → 学生发送时幂等获取聊天,冻结项目/Pi 来源/当前发布版本 → 获取WS专用凭据 → Yuxi原生Request/Run。同项目/Pi/版本沿用内部线程,改变时新建执行段并携带有预算的公开交流,不创建第二个可见聊天。名称、人设和资料来自发布定义。读取中断 → Main校验本轮绑定、取消与额度 → 列目录/读取文件/读取会话原文 → 主动回传配对结果 → 原问题关联Run续接。协议2为12批/64KiB累计成功结果/8KiB单页,旧协议六批;最后一批消费后要求最终回答。保留原问题时限与学生付款人;文件使用读取时内容,会话使用本轮快照。云端只保存消息和收到的片段,完整工程与Pi原始日志保留本机。
云端事件 → Main 先推进游标,再仅转发云端主线程文本 → Host SSE/本机历史 → 右侧面板。子智能体文本不混入正文或带回草稿;断线按游标与持久状态恢复。关闭面板不取消已接受问题,停止/退出请求取消原问题;重启后下次提问先停止旧问题。带回回答只追加草稿,不自动发送,旧本地老师话题保留原执行路径。见[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
编译完整请求 → 本地路径按近似 Token 预算、云端路径按实际 JSON query 字节预算裁剪来源节选 → 提交前按同一计量复核。问题、明确引用及固定讨论指令保持完整;真正的固定配置超限单独提示。旧合成朋友历史和草稿只读展示,不创建新调用或自动绑定;现有结构化讨论、主动跟进和项目草稿继续使用统一咨询身份。
编译完整请求 → 本地路径按近似Token预算、云端路径按实际JSON query字节预算裁剪来源节选 → 提交前按同一计量复核。问题、明确引用及固定讨论指令保持完整;真正的固定配置超限单独提示。明确引用绑定旧项目/Pi时须移除引用或恢复原来源。聊天轮文件原子写入后更新轻量索引;恢复与旧记录导入按原始身份去重,不重发模型。历史页和SSE按请求ID合并,已读归Main,文字草稿按账号/智能体保存;讨论状态仍按项目隔离。旧不明归属历史/草稿仅查看。现代聊天停止旧定时跟进,独立主动观察后续接入同一聊天。
## Permanent wallet and recharge

View File

@@ -4,7 +4,7 @@
| Path | Responsibility | Owner Notes |
|---|---|---|
| `electron/coding-teacher/**`, `electron/api/routes/coding-teacher.ts`, `shared/coding-teacher.ts`, and `src/pages/Chat/Teacher*.tsx` | Main-owned 下发智能体目录与选择、云凭据、项目/Pi 快照、三个只读工具、Yuxi 续接、项目级咨询和讨论 | 服务端发布定义提供人设与显示资料,无本地老师/朋友分类或名称工具限制;旧合成朋友话题/草稿只读。`context.ts` 按执行路径测量完整请求,`model-runner.ts` 使用近似 Token 预算,`cloud-runner.ts` 使用精确 JSON 字节并仅路由云端主线程正文。账号/项目/本轮来源隔离,无本机写入或命令。见 [咨询 ADR](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 |
| `electron/coding-teacher/**`, `electron/api/routes/coding-teacher.ts`, `shared/coding-teacher.ts`, and `src/pages/Chat/Teacher*.tsx` | Main-owned下发目录、账号/智能体唯一聊天、每轮项目/Pi/版本快照、三个只读工具及Yuxi续接 | `conversation-store.ts` 持有轻量索引、独立轮文件、历史分页、旧记录导入和已读;`service.ts` 按请求ID更新、冻结范围并轮转内部线程。Renderer只保存草稿/窗口阅读锚点,无新话题入口。服务端定义人设与资料;不明归属旧记录只读。context按执行路径计量,cloud-runner仅路由主线程正文,无本机写入或命令。主动观察后续接入同一聊天。见[咨询ADR](../10-decisions/ADR-2026-09-22-coding-teacher.md)。 |
| `electron/coding-projects/project-config.ts`, `src/pages/Chat/CodingProjectConversations.tsx`, and `src/components/layout/Sidebar.tsx` | 内部默认 Agent 与项目下会话导航 | 旧绑定保留;首次发送或显式新建创建会话,打开项目不创建。 |
| `electron/coding-plugins/manifest.ts`, `release-descriptor.ts`, `signature-verifier.ts`, and `trusted-keys.ts` | Closed Plugin package/descriptor parsing, fixed code-owned resource roots, compatibility checks, canonical archive validation, and Ed25519 trust | Data Service plus exact Game Resource, Game Audio and Project Scaffold roots are code-owned. Other schema-2 packages still pass descriptor/signature/archive validation; downloadable P0 Skill assets remain text/image-only. Hosted Web Search is not a current Plugin root. |
| `electron/coding-plugins/account-plugin-cache.ts`, `marketplace-client.ts`, and `package-store.ts` | Main-owned Account Library cache, authenticated server client, and atomic immutable device installation store | Account acquisition and device installation are separate. Package bytes switch atomically only after descriptor, signature, archive, client-range, and provenance checks; failed updates preserve the prior current release. |

View File

@@ -2,10 +2,12 @@
云端咨询的 Main 声明 `read_protocol=2`:目录按层分页(默认深度 4、最多 6,跳过生成缓存),文件与捕获会话返回连续文本及准确的下一页行/Unicode 字符列。文件增量解码,不受 UI 预览大小限制。每问题最多 12 批、累计成功结果 64 KiB、单页 8 KiB;剩余不足 512 字节时停止读取。Yuxi 消费最后一批结果后通过 `tool_choice: none` 请求最终答案,保留原身份、版本、时限与幂等续接;未声明新协议的旧客户端保持六批。工具活动以问题与逻辑 tool_call_id 合并跨 Run 重放,原始 interrupt 工具错误不单独判为失败。Main 区分读取额度、上下文失效与协议错误;失败问题不自动重试。须先更新 Yuxi API/worker,再更新客户端;生产供应商与安装版验收仍待完成。
智能体图标跟随发布定义:Yuxi 将原生 `icon` 固定到发布快照,Works Square 转为公开地址 `icon_url` 下发。Makelore 顶栏、邀请、面板标题、欢迎区和消息行统一读取该字段;缺失或加载失败时回退到既有 `avatar_id`。新话题取当前发布定义,旧话题保持原版本;自定义图标使用正常图像渲染,内置像素头像保持像素样式。
智能体图标跟随发布定义:Yuxi 将原生 `icon` 固定到发布快照,Works Square 转为公开地址 `icon_url` 下发。Makelore 顶栏、邀请、面板标题、欢迎区和消息行统一读取该字段;缺失或加载失败时回退到既有 `avatar_id`。每个新问题取当前发布定义,已接受问题保持原版本;自定义图标使用正常图像渲染,内置像素头像保持像素样式。
详见[图标集成记录](../30-worklog/tasks/20260926-merge-agent-avatar-ml-92dc837e.md)。
Code 咨询由 Works Square 运营下发的 Yuxi 智能体执行,客户端不内置老师/朋友角色;发布定义提供名称、头像、人设、欢迎语和推荐问题。Main 按账号/项目管理本机话题,Renderer 按账号/项目/服务端智能体 ID 保存未发送草稿。每轮绑定当前操作会话和已完成 Pi 公开消息,执行云端请求的三个只读工具后主动回传结果;Yuxi 保存云端消息和收到的片段。学生支付咨询模型费用,个人 Agents 保持创建者付费。全部下发智能体在顶栏以头像和名称直接选择,溢出横向滚动;面板不再提供智能体下拉框。选择恢复对应历史或空输入框,不创建话题或调用模型。新话题使用所选或默认项,旧话题固定版本;旧未归属项目草稿、合成朋友历史及草稿仅查看。结构化讨论和现有主动跟进协议保留。正文只接收云端主线程文本,子线程事件仍推进续传游标。Code 默认 Agent、项目下会话和 Pi 执行保持原边界。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
Code 咨询由 Works Square 运营下发的 Yuxi 智能体执行,不内置老师/朋友分类。Main 按账号/稳定智能体 ID 保存唯一持续聊天,Renderer 按同一身份保存文字草稿。顶栏直接选择智能体,恢复历史/空态与未读;没有新话题加号或话题下拉框。每次接受问题固定当前项目、Pi 公开消息及发布版本;项目、Pi 来源或版本变化时只轮转内部 Yuxi 线程,带入有预算的公开近期交流。历史聊天文本不能扩大本轮文件范围。Main 执行三个只读工具并回传结果;学生支付咨询模型费用,个人 Agents 保持创建者付费。正文只接收云端主线程文本,其他线程事件仍推进游标。Code 默认 Agent、项目下操作会话及 Pi 执行保持项目边界。
TeacherConversationStore 在 userData/agent-conversations/<account>/<agent> 保存轻量索引和独立轮文件,每页50轮;SSE只发送当前轮与元数据,Renderer 按请求身份合并分页和流。Main 持久保存已读,阅读锚点只缓存在当前窗口。已登记项目的旧话题仅在账号和config_id明确时按来源身份导入,保留原文件;不明身份记录单独只读。讨论卡按项目保存,引用与带回操作核对原项目/Pi 来源。新下发聊天停止旧Renderer定时跟进;独立主动观察任务尚未纳入,未来建议须幂等投递同一聊天。详见[已接受决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)。
## Current Architecture

View File

@@ -4,6 +4,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
## Integrated Through
- 2026-09-28:无冲突合入单会话源 `7aa81da616449dead25557476cf4f1433edf84b5`(含方案 `e54f3d2`)。每个账号与下发智能体使用唯一持续聊天,移除新话题入口,跨项目分页历史、独立草稿与持久已读;项目/Pi/发布版本下沉到每轮冻结,变化时只轮转内部Yuxi线程。旧记录按可证明的账号/配置身份导入,原文件保留。已按用户批准更新咨询ADR、架构和领域规则,取代下方历史条目的项目/版本可见话题规则。产品/测试与已验证源一致,沿用365项相关单测、Renderer typecheck、scoped lint、Vite构建及1项Electron交互;扩展Main仍为66项基线诊断。三份外来文档原样保留;未推送、打包、部署或调用真实收费模型。主动观察仍在独立任务,建议投递必须在其后续合并时衔接唯一聊天。见[源记录](tasks/20260928-agent-single-chat-27da516b.md)和[集成记录](tasks/20260928-merge-agent-single-chat-9911c6df.md)。
- 2026-09-28:无冲突快进合入诊断记录 `3779f33`,客户端产品及测试无变化。确认现有咨询按账号/项目保存,每个问题绑定当前 Pi 来源;配套 Yuxi 修复 `e96d8cf` 将话题准入与每问题上下文分开,允许同项目切换编程会话后继续原话题,旧历史无需删除。Yuxi 2260 项 unit(1 skipped)、10 项真实 HTTP/PostgreSQL/worker 集成及独立审查通过;本仓不为诊断文档重跑客户端构建。三份外来文档原样保留;未推送、打包、安装或部署,线上需更新 Yuxi API。见[源记录](tasks/20260928-consultation-scope-83fa19c2.md)和[集成](tasks/20260928-merge-consultation-scope-ml-7b56cbe4.md)。
- 2026-09-27:从 `0eed70fa637f70b22be5eda7af400a702ee4a7f2` 无冲突快进合入 Design 客户端源 `bbea6eba82a625f3d8b34ecb3d2747e7a19766e3`。未保存视频时长不再显示默认 6 秒,参数保存失败恢复已接受值;缺少内部分镜改为 AI 准备动作引导,保留其他阻断与确认边界。产品/测试与已验证源一致,沿用 71 项相关测试、3 项跨前后端离线流程、2 项 Electron 交互及 typecheck、lint、构建证据。三份外来文档原样保留;未推送、打包、安装或调用收费生成。本次无需数据库或环境变更,不包含独立服务端 Reasoner 修复。见[源任务](tasks/20260927-design-video-form-d2b96e41.md)和[集成记录](tasks/20260927-merge-design-video-form-9af51c63.md)。

View File

@@ -0,0 +1,74 @@
# Task: Design one ongoing conversation per user and cloud agent
## Identity
- Task ID: 20260928-agent-single-chat-27da516b
- Mode: Feature
- Branch: codex/20260928-agent-single-chat-27da516b-agent-single-chat
- Worktree: D:\Datas\OthersProjects\.codex-worktrees\makelore\20260928-agent-single-chat-27da516b
- Base commit: b26e25c9ed26bf30f4d0bc03869c223f0fe34386
- Owner: codex
- Status: Ready for Integration
## Scope
- User approved the proposed account + delivered-agent single ongoing chat and implementation.
- Client store, per-turn scope/version, Host API, paged UI, legacy history, drafts, read receipts and focused regressions.
- Coordination with the existing proactive-observer task was explicitly authorized. This task does not own its uncommitted implementation or its Reviewer.
- No main merge, push, deployment, real paid model call, new subagent or worktree cleanup.
## Intent And Constraints
- Concurrent Task Gate and Planning Gate Passed on initial design and implementation resume; official start/status confirmed this task's feature ownership.
- Refreshed 128 peer records, read only their task records; consultation-scope client task is read-only diagnosis. Observer code remains in a separately owned worktree.
- Stable delivered config ID, account isolation, student payer and three readonly tools remain. Pi/project files stay project-owned.
- Every accepted question freezes project, Pi source and released version. Switching UI never changes an accepted read scope.
- Existing main foreign documents and unrelated worktrees remained untouched. Only this task record/proposal are changed in project memory; canonical promotion remains integration work.
## Outcome
- Main stores one account-agent chat under userData/agent-conversations/<account>/<agent>. A small message index and separate atomic turn files avoid rewriting every historical answer.
- First question ensures the chat; repeated request IDs are idempotent, including older pages. One active manual question per account-agent. Snapshot progress/completion updates by request ID.
- Latest 50 turns initially; older history pages remain available. SSE sends the current turn and metadata. Renderer merges delayed pages without overwriting newer streamed replies, preserves reading position while switching agents, and keeps account-agent text drafts.
- Removed student new-topic plus and normal topic dropdown for delivered agents. Current project/source are shown. Cross-project/Pi references block sending until removed or the source is reopened; old reply actions cannot target another Pi session.
- Contacts retain distinct unread state; read position is persisted in Main. Last selected disabled agent can reopen readonly history. Loaded-page/scroll cache is window-local; durable messages and read receipts survive restart.
- Next question uses the current released definition. Same project/Pi/version reuses its internal thread; changing any starts an internal segment carrying bounded public history. Old imported cloud questions retain original cloudRequestId for cancellation.
- Readonly conversation tool can retrieve older completed chat messages by ID through the frozen index without loading all bodies each question; prior-project message text does not grant prior-project file access.
- Legacy topics are imported only on proven account/config identity, deduplicated by project/topic/request origin, and original files are retained. Body-before-index interruption recovers without duplicate import, including retry in the same process. Missing project directories can be retried later. Historical project and source topics, including unassigned/friend records, remain readonly via the old-records endpoint.
- Discussion state is per project inside the chat; imported old cards retain their turn snapshots and newest project card. Legacy originals remain separately viewable.
- README updated for the implemented client behavior. Accepted teacher ADR/domain/architecture changes are proposed, not promoted.
## Verification
- Relevant unit suite: 12 files, 365 tests passed. Includes Store/Service/actual HTTP + SSE/paging/legacy source archive/account isolation/concurrent duplicate acceptance/versions/Pi switching/frozen file roots/older message tool reads/import failure recovery/read receipts/UI delayed pages/old-record readonly/disabled history/independent agent drafts.
- pnpm run typecheck: passed.
- Focused ESLint over every changed TS/TSX file and new files: passed.
- pnpm run build:vite: passed; existing chunk-size/dynamic-import/Browserslist warnings retained.
- Real Electron test with deterministic Host fixtures: project consultations preserve student drafts and switch between work and chat without submitting advice, 1/1 passed. Screenshot manually inspected: topbar agents, one chat, no new-topic plus/select, project label, separate drafts, work tab preserved. Not a live cloud/model acceptance claim.
- Expanded Main tsc: 66 diagnostics. Temporarily replayed original committed source inside this owned worktree under try/finally restoration; baseline also has the same 66 diagnostics (line positions normalized). No new diagnostics, but global Main typecheck is not clean.
- Reproduced existing coding-teacher.test tool activity ID failure on original base: test expected parent run ID, existing implementation uses stable context/request ID. Corrected that assertion to the existing contract; the full related suite then passed.
- No dependency lock/package change. Build output, local reports, runtimes and temporary checks are ignored and not committed.
## Coordination And Integration Dependency
- Authorized messages sent to existing thread 01a0dc9a-9b4e-7fa3-bb19-aea80abaaac4, task 20260928-agent-observer-design-9c41a872.
- That task confirmed its Main suggestion contract in its own record: stable suggestion ID survives replacements; state.json is durably saved before advice delivery. Use projectId + suggestion.id for idempotent delivery; do not call sendConversation to invent a student message.
- Actual manual APIs: GET /api/coding/agent-conversations/:agentId?before=...; POST /messages; /seen; /discussion; /save; /requests/:id/cancel; GET /events. service.conversation(agentId,before?) and service.sendConversation(agentId,input) own the unique chat.
- Observer review was still in progress at this handoff; no observer code is in this branch. The combined integration MUST replace its discussObservation project-topic creation with inserting/opening this chat, plus delivery replay/read receipts. Its independent observation thread and Main project scheduler remain separate. Do not claim automatic advice has already been wired or combine branches without this adaptation and joint tests.
- Observer coordinator source inspection confirmed Yuxi scope binds both project and Pi source, and native YuxiSummarizationMiddleware exists. This justified Pi-aware segment rotation; neither cloud deployment nor compression quality was independently exercised here.
## Follow-ups
- User-requested main merge is not yet authorized for this implementation.
- During integration reconcile observer suggestions as above, and promote the approved account-agent/per-turn semantics; retain unrelated docs.
- Validate configured Yuxi deployment against current client; no real cloud/paid-model run occurred. Cross-device history synchronization is outside this increment.
- Retained worktree belongs to this completed feature; no cleanup requested.
## Promotion Candidates
- Targets: ADR-2026-09-22-coding-teacher.md, system-overview.md, data-flow.md, business-rules.md and current state.
- Proposal: replace visible project/version topic identity with account-agent chat; bind project/Pi/version to individual execution turns; account-agent drafts/read receipts, paged files/index, retained source archives.
- Evidence: approved user request, implementation, 365 related tests, Electron UI and cloud request contract tests.
- Future impact: history lifecycle, cloud scope rotation/summary, old-context actions, observation delivery.
- Semantic conflicts: accepted project-topic/version policy is intentionally revised by user approval; observer project-topic creation must be adapted at joint integration.
- Human confirmation: single-chat direction and implementation approved. Main merge/deployment require their own corresponding user request.

View File

@@ -0,0 +1,46 @@
# Task: Integrate one ongoing conversation per delivered agent
## Identity
- Task ID: 20260928-merge-agent-single-chat-9911c6df
- Mode: Integration
- Branch: main
- Worktree: D:\Datas\OthersProjects\makelore
- Base commit: a1d52c60d841dc451545805af5fe91b0ca8839d3
- Owner: codex
- Status: Ready for Integration
## Scope
- Merge source e54f3d2 and 7aa81da into local main; promote the approved account-agent ongoing conversation contract.
## Intent And Constraints
- Concurrent and Planning Gates Passed. Official start/status match Identity and exclusive integration ownership. Loaded required entry, own/source tasks, relevant accepted ADR, architecture/domain/evidence/reflection/commitments and peer task scopes. Historical placeholder scopes remain unknown but have no concrete dependency on this merge.
- User authorized main merge and explicitly approved releasing completed 20260928-merge-consultation-scope-ml-7b56cbe4 and adopting three known foreign task documents. Preserve them unchanged and exclude them from commits. Source task/proposal remain read-only.
- Registered the exact unchanged source task/proposal imported by the authorized merge before committing, following the documented source-record adoption procedure. Same-task official resume/status and refreshed Planning Gate passed with unchanged base and scope.
- Approved account-agent chat replaces visible project/version topics; each accepted execution still freezes project/Pi/version, student payer and readonly tool scope. No changes to Pi project ownership.
- Observer task 20260928-agent-observer-design-9c41a872 remains uncommitted and separate; authorized coordination sent. Its later merge must adapt durable suggestion delivery/discussObservation to this chat and jointly test idempotency, unread state, scope and focus. Do not import its unfinished code here.
- Plan: merge exact source without rewriting product files, reconcile accepted canonical rules, verify source product/history preservation and documentation boundaries, then commit/complete. Reuse source verification if product/test tree is identical; rerun only checks justified by integration changes.
- No new subagents, push, deployment, packaging, paid model calls or cleanup.
## Outcome
- Source 7aa81da (including design e54f3d2) merged conflict-free into local main. Product, tests, README and source records are byte-identical to the verified source; main's separate consultation-scope diagnosis remains preserved.
- Promoted approved account-agent conversation identity, per-turn project/Pi/version scope, paged persistence, read receipts, drafts and retained legacy archives into the teacher ADR, architecture, domain rules, decision/evidence indexes and Integrated Through.
- Explicitly recorded that legacy Renderer check-ins stop for delivered-agent chats and the independent observation implementation is not part of this merge. Its later integration must adapt durable advice delivery rather than creating project topics.
- Three adopted foreign documents remain unchanged and excluded. No push, packaging, installation, deployment or cleanup.
## Verification
- Source verification reused because integration changes only canonical/task documentation beyond the exact source: 365 related tests, Renderer typecheck, changed-file ESLint, Vite build and one real Electron interaction with deterministic Host fixture passed. Expanded Main has the same 66 pre-existing diagnostics; no live paid-model claim.
- Conflict-free merge, exact product/test/source-record preservation, git diff --check and task-aware documentation drift checks passed. The official gate also verifies the three adopted external records retain their original bytes/index state. Main's earlier diagnosis commits are retained as the first-parent history.
## Follow-ups
- Observer task 20260928-agent-observer-design-9c41a872 must consume this main and complete same-chat suggestion delivery/read receipts/idempotency/scope/focus tests before its own merge. Existing thread coordination is user-authorized.
- Production/installed-client acceptance and optional task worktree cleanup are separate. No cross-device history synchronization is implemented.
## Promotion Candidates
- Accepted and promoted the source account-agent/per-turn contract under the user's implementation and merge approval; no unresolved product-direction choice. Source task/proposal remain unchanged historical records.

View File

@@ -4,11 +4,11 @@
- 每个新项目创建内部默认 Agent,普通界面无 Agent 创建步骤或分组列。defaultAgentId 选取已存默认、置顶或首个可用 Agent;历史 Agent 与会话绑定不重写,不重新启用停用/归档 Agent。
- 项目直接显示会话并保留归档、改名、未读、运行状态;打开项目不创建空会话。首次发送或显式新建才创建。项目设置编辑默认配置,历史会话仍能定位原绑定配置。
- 老师使用 Yuxi 原生配置和云资源,新话题可选择运营下发的老师,旧话题固定版本。Main 只提供当前项目和本轮捕获的 Pi 公开消息/老师话题的三个只读工具,允许 `.makelore/project.json`,无本机写入或命令,不进入其他账号/来源记录;每次读取与续接检查绑定及取消状态。Yuxi 保存老师消息与收到的片段,完整本地工程不全量上传。
- 同 requestId 相同输入读取已有请求结果,不同输入冲突;重启中的请求标记中断,账号退出中止,来源删除清理相关话题。带回回答追加草稿且不自动发送;已归档来源必须先恢复。
- 每个账号与稳定下发智能体ID只有一个可见聊天,跨项目保留历史。每个问题使用接受时的当前发布版本,并冻结项目、Pi来源及公开消息;相同作用域复用内部线程,任一变化只开启内部执行段。Main三个只读工具仍限本轮项目,允许 `.makelore/project.json`,无本机写入或命令。可读同一聊天较早消息,但不能据此读取旧项目文件;每次读取与续接检查绑定及取消状态。完整工程不全量上传。
- 同requestId相同输入读取已有结果(包括更早历史页),不同输入冲突;同一账号/智能体一次接受一轮人工问答。重启将未完成问题标为中断,账号退出中止;移除项目不删除账号级聊天。带回回答核对原项目/Pi来源,只追加草稿且不自动发送;已归档来源必须先恢复。
- 运营只管理下发、同步、默认与启停,无重复提示词编辑器或试聊。老师聊天模型由学生账号付费,个人 Agents 保持创建者付费。正文、历史及带回草稿只接收云端主线程文本;忽略子线程文本仍推进游标。
- 客户端不内置老师/朋友角色:名称、头像、简介、欢迎语、推荐问题及人格由服务端发布定义决定,通用讨论协议不定义人格。任意名称的下发智能体都遵守同一只读工具边界;不再按角色限制项目读取。
- 当前咨询按账号、项目保存,每轮绑定所选操作会话;新话题选择下发项或运营默认项,旧话题固定原定义与版本。旧合成朋友话题及未发送草稿仅查看,不继续调用、不自动重绑定或提交;兼容路由/存储名不定义新角色。
- 顶栏点击直接恢复唯一聊天,没有新话题加号和话题下拉框。历史分页,已读由Main持久保存;草稿按账号/智能体隔离,引用仍绑定原项目/Pi。只导入已登记项目中当前账号与config_id可证明一致的旧记录,按项目/话题/请求来源去重,原文件保留;不明身份记录及旧草稿单独只读,不按名称猜归属。讨论状态按项目保存。旧Renderer定时跟进不再向现代聊天派发;独立主动观察的建议接入尚待完成。
- 输入预算区分近似模型 Token 与精确云端 JSON 字节,编译和提交使用同一完整请求计量。保留当前问题、明确引用和固定指令,按需缩减来源节选;固定配置/讨论超限不误报为用户短问题过长,不静默提升预算或迁移旧话题。
依据:[老师决定](../10-decisions/ADR-2026-09-22-coding-teacher.md)及 [ADR-008](../10-decisions/adr-008-interactive-ai-app-scaffold.md)。

View File

@@ -1,5 +1,7 @@
# Evidence Index
2026-09-28 [单会话源任务](../30-worklog/tasks/20260928-agent-single-chat-27da516b.md) `7aa81da` 已合入本地main:365项相关单测、Renderer typecheck、变更文件lint、Vite构建与1项真实Electron夹具交互通过,覆盖存储恢复、分页/事件合并、旧记录归属、每轮范围/版本、历史原文读取、草稿与已读。集成产品/测试与源一致,沿用其证据;扩展Main仍有相同66项基线诊断。未验证线上付费模型、跨设备同步或独立主动观察与单聊天的组合交付。
Use this index for searchable, traceable evidence records.
| Date | Topic | Status | Source | Detail |