docs: 补充麦洛产品介绍与老师 Agent 定位

This commit is contained in:
2026-09-26 15:53:59 +08:00
parent 4b79e6784d
commit c8e9a24a04
2 changed files with 278 additions and 0 deletions

View File

@@ -12,12 +12,16 @@
## Scope
- 产品介绍扩展(2026-09-26):依据用户要求,将已确认的老师 Agent 定位扩展为三项目客观产品介绍,交付 `docs/product-introduction.md`。覆盖客户端四模块、平台作品/运营服务、Yuxi 能力平台、老师能力定义与当前交付边界;仅文档。
- 产品定位后续(2026-09-26):依据用户确认及进一步澄清,在 Makelore 产品文档记录“老师 Agent 是某一领域杰出人物的能力转化而成的智能体,供平台学生使用”。定义以人的领域能力为中心,蒸馏归入实现方法;仅更新文档。
- 工具续接后续集成(2026-09-24):合入已验证源 79914e1d06a66f78239ebe57f816acc98dc1eaae,修复同一 interrupted 父 Run 清理资源期间返回 run_busy 导致客户端取消问题。当前主线为源基线 0e22e0545d6f58a17a8c85805570a550d1c14c43。
- Merge reviewed source 97837cef90baf6bb02cfda0cef7b938081f3c5f7 (20260924-agent-rendering-a8c2d419) into local main; promote accepted consultation rendering and protocol facts. Paired Yuxi source: 02f27f33a8b816589036503f0720d446418c28aa.
## Intent And Constraints
- 产品介绍后续:官方 check/start/status 与 Identity 和 integration 所有权匹配,Concurrent/Planning Gates Passed。重读三仓入口、自身记录、定位、状态、决定、架构、领域与相关产品说明;复用此前未变 peer 范围,刷新近期 20 份注册记录,当前三仓分别有 117/271/48 个 peer。头像同步和加权定价另有隔离任务,不作为已实现主线能力。历史模板记录仍未知只读,无本次具体依赖。计划:按真实入口核对功能,编写独立 Markdown,检查事实、结构、差异及文档写边界后交付;保留已 adopted 文档,不创建子智能体、不执行模型/线上调用。
- 用户进一步明确重点是老师 Agent 的定义“某领域杰出的人的能力变成一个 agent”。官方同任务续接核验与 Concurrent/Planning/Integration Gates 再次通过,重读本轮六份产品记录,复用未变的 116 个 peer 范围。计划:统一定义、能力内涵、学生价值和方法层次;核对文档差异、边界门禁后提交,不把蒸馏流程作为产品核心,也不收窄为单一聊天或判断技巧。
- 定位记录的 Concurrent/Planning/Integration Gates Passed:官方同任务续接与所有权核验完成,重读入口、自身记录、产品定位、当前状态、老师 ADR、README 与相关规范;此前 116 个 peer 范围复用,登记在上次集成之后无活动。用户 2026-09-26 的纠正及“记录下这个定位和理念”已授权本次产品定位确认。计划:在 project-positioning 集中记录能力来源、蒸馏内容、学生价值、建设路径及真实案例标准,以 README/ADR 链接引用,同步当前状态并完成文档检查。保留客户端不固化老师/朋友分类、云端配置及三个只读工具的既有边界;不修改代码、线上配置或宣称现有智能体已通过领域能力验收。
- 本轮继续既有智能体集成任务;官方 same-task start/status 与独占 integration lock、Identity 匹配。Concurrent/Planning/Integration Gates Passed;重读 entry、自身/源记录、当前集成状态及老师决定/架构/领域/证据等上下文,复用未变的 115 个 peer 范围,刷新本次已完成源。历史模板记录没有本次具体语义依赖。3 份既有 adopted 文档保持原样。计划:精确快进、核对源字节与提交祖先、接受 current-state 提议、通过文档门禁、提交完成并询问源工作树清理。产品字节一致时沿用源测试,不重复已完成检查;不推送、打包、安装、部署或创建子智能体。
@@ -28,6 +32,8 @@
## Outcome
- 产品介绍交付:Makelore `docs/product-introduction.md` 包含整体分工、四个客户端模块、老师 Agent 定义与学生价值、三个只读工具、Works Square 网页及运营模块、Yuxi 资源/执行功能和典型流程。理念严格采用用户最新定义;蒸馏属于方法。核对后未将网页历史 AI 讲解文案、旧周额度、独立桌面 Learning 入口、待合入头像/计价和默认关闭的移动 Feed 写为现有常规能力。没有产品行为、部署或计费变更。
- 产品定位后续(2026-09-26):按用户进一步澄清,project-positioning、README、老师 ADR、决定索引和 current-state 已统一为“某一领域杰出人物的能力转化而成的智能体,供平台学生使用”。重点回到能力来源、所承载的领域能力及学生价值,蒸馏移到实现方法层;学生仍可获得领域理解、判断和解决问题的方法。既有交互和云端能力边界保持,未修改任何运行代码或线上定义。
- 工具续接后续:main 从 0e22e0545d6f58a17a8c85805570a550d1c14c43 无冲突快进至 79914e1d06a66f78239ebe57f816acc98dc1eaae。产品、测试、README 与源一致;源任务记录原样导入,仅在本集成记录和 current-state 收录结果。接受原 Run 清理期间复用原工具批次、保留截止时间与取消的提议,不改变云端互斥或计费。
- Source merge committed as 98559e32a75dfbada12a737d7ff0ffda55aa346a. Before the merge commit the drift checker could not recognize the staged foreign source record; exact source-record equality was confirmed, then the unchanged source import was committed and the official drift check passed. No foreign record was edited/adopted to bypass this gate.
@@ -36,6 +42,10 @@
## Verification
- 产品介绍文档检查已通过:三仓官方 task-aware drift 与 git diff --check 均通过,既有 adopted 文档保持原状态。Markdown 的 UTF-8、表格列数、七个主章节、末尾换行和老师 Agent 定义核对通过;本轮仅新增介绍文件及三份自身记录,无运行代码变化。未执行产品测试、站点构建或生产验收;Yuxi 只变更私有任务记录,不改公开文档站。
- 本轮依据:Makelore README、`src/lib/ai-modules.ts`、AIHardware/CloudAgents 页面、项目提交入口和老师 ADR;Works Square Operations 菜单、CodingTeacherOperations/ObservationAgentOperations、Education 当前视图及平台已接受决定;Yuxi ARCHITECTURE、路由、AgentManage/Extensions 页面与原生老师决定。验证限定于本地主线文档/源码事实,不代表线上功能或领域能力验收。正式文档门禁、空白与本轮精确提交范围检查在交付前执行;不重复运行与纯介绍文档无关的模型或产品回归。
- 定义澄清后再次检查六份文档差异,git diff --check 和官方文档门禁通过。原链接路径与标题锚点保持,3 份 adopted 外来文档未变。纯文字修订未运行应用测试或构建。
- 定位记录:检查六个文档的差异与新增链接/标题目标,git diff --check 和官方 task-aware documentation drift 均通过;3 份 adopted 外来文档保持原样、未纳入提交。此次只有产品文档变更,未运行与内容记录无关的应用测试或构建,也未把理念确认表述为已下发智能体的能力验收结果。
- 工具续接后续:source ancestry、全部产品文件/source-record 精确相等、无 unmerged 路径检查通过。复用已验证源 183 项相关测试、最终 29 项聚焦回归、Renderer typecheck、scoped ESLint 与 Vite 全目标构建;配套 Yuxi 控制验证证明清理前 409、清理后相同批次 200 并完成回答。验证结果未被表述为新的重复测试或生产验收。官方文档门禁及 git diff --check 通过,3 份已 adopted 外来文档仍为原始状态;未改变产品或测试 oracle。