From 07f009cd88d1e38fb135e95fed7274394858c4d1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=B2=A8=E9=B1=BC=E8=BE=A3=E6=A4=92?= Date: Thu, 8 Oct 2026 17:51:44 +0800 Subject: [PATCH] docs: require students to articulate adopted teacher advice --- .project-docs/00-brief/project-positioning.md | 12 +++++++++++- .../10-decisions/ADR-2026-09-22-coding-teacher.md | 1 + .project-docs/10-decisions/decision-index.md | 2 ++ .project-docs/30-worklog/current-state.md | 2 ++ ...0261008-teacher-consensus-integration-a9c2d7e1.md | 5 +++++ README.md | 2 ++ 6 files changed, 23 insertions(+), 1 deletion(-) diff --git a/.project-docs/00-brief/project-positioning.md b/.project-docs/00-brief/project-positioning.md index 8cbb36b2..136ca495 100644 --- a/.project-docs/00-brief/project-positioning.md +++ b/.project-docs/00-brief/project-positioning.md @@ -48,6 +48,16 @@ A good solution should {quality bar}. “连接”应在真实问题和持续协作中体现，不能只依靠头像、姓名或一次相似回答来证明。Agent 的回答也不自动等同于真人老师对这次问题作出的即时答复或承诺。 +### 学生理解与执行表达 + +用户于 2026-10-08 补充确认：老师给出判断或建议后，学生需要自行理解、决定是否采纳，并用自己的表达向操作 Agent 提出目标与执行要求。学生的理解、选择和表达是建议进入执行过程的必要环节。 + +交互过程为：**老师提出判断与建议 → 学生理解并选择是否采纳 → 学生用自己的话向操作 Agent 表述 → 操作 Agent 根据学生表述执行 → 查看作品结果 → 老师基于可获得的结果继续判断。** + +老师或系统不能通过直接转发建议、自动下发指令或一键采纳执行，替代学生自己的表述；仅点击“采纳／确认”也不能替代这一过程。学生仍可向老师追问、澄清和讨论，再形成自己的表达。 + +保留学生如何理解、转化和运用建议的表达，才能为判断学生是否理解提供依据。学生自己表述并不自动证明已经理解，作品执行成功也不能代替对理解的观察。具体观察与反馈方式待讨论。 + ### 显性知识、隐性知识与上下文知识库 建设同时关注能明确表达的知识，以及体现在实践中的经验、识别线索、判断和习惯。隐性知识并不都能完整转成文字；需要结合真实行为、案例、过程与结果，检验提炼出的描述能否在新情境中发挥作用。语言学、行为学、心理学和专家知识提取方法可以作为分析视角，具体方法尚待选择与验证。 @@ -76,7 +86,7 @@ A good solution should {quality bar}. ### 已确认方向与后续方法论 -以上确认了真人映射、见解与经验、用户连接、上下文知识库和本人参与验收的方向。下一步围绕一位具体老师及其明确职责，讨论材料采样、提炼流程、证据核对、知识组织、校准和验收方法，再通过试验验证。老师建议与操作 Agent 的交接及执行反馈如何形成闭环，也属于后续方案。 +以上确认了真人映射、见解与经验、用户连接、上下文知识库、本人参与验收，以及由学生理解并向操作 Agent 表述执行要求的方向。下一步围绕一位具体老师及其明确职责，讨论材料采样、提炼流程、证据核对、知识组织、校准和验收方法，再通过试验验证。后续协作与结果反馈设计须保留学生理解、转化并表达建议的过程，不设计老师建议直接交给操作 Agent 执行的路径。 本节记录产品共识，不表示现有下发智能体已经完成真人映射、知识提炼或上述验收。提示词、Skills、案例、知识和模型配置是候选承载方式，具体组合尚待验证。现有云端管理、运营下发、项目连续聊天、版本绑定与只读工具边界保持；客户端统一承载发布配置，不按“老师”“朋友”等名称另设角色权限，也不增加固定教学基线。 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 3a64e141..35da9c33 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 @@ -10,6 +10,7 @@ ## Decision +- 2026-10-08 用户补充确认产品交互边界：老师给出建议后，由学生理解、决定是否采纳，并用自己的表达向操作 Agent 提出目标和执行要求；老师或系统不得以直接转发建议、自动下发或一键采纳执行替代学生表达。查看作品结果后，老师再基于可获得的事实继续判断。学生表达是观察理解的依据，不能仅凭采纳或执行成功认定已理解；具体观察方法待讨论。本条为产品共识更新，未改动运行代码或既有历史记录。 - 2026-09-29 远程输入区改动与本地流式回复合并：麦克风识别只追加当前草稿，不自动发送，账号／项目／老师／来源切换或关闭时取消过期结果。默认模型沿用老师发布配置；学生可在 Main 与云端能力允许时为后续手动问题显式选择模型，按账号／老师记忆。每轮固定 modelId 与请求身份，重试保持原选择；人设、资源、发布版本、项目边界和学生计费不变，主动检查仍使用云端配置。旧服务能力不足时明确不可用，不忽略选择；配套 WS/Yuxi 上线仍为独立发布工作。 - 快捷提示放在输入框上方，云端文案／实际提示词及空列表兼容规则保持；回复卡片采用紧凑样式，普通问题和求助均在完成时间之后只显示一次。发送时间与完成时间来自真实记录，运行中显示状态，未知时间不伪造。默认求助兼容文案更新为“帮我整体看🧠”。 - 每位下发老师分别显示介绍气泡，按账号／项目／老师保存已介绍状态和操作 Agent 的完整回复轮数。进入对应咨询或显式关闭仅消费这一位；未操作时于第三轮成功操作回复后收起，旧历史、老师咨询、失败或中间工具事件不计数。咨询期间介绍组收起，真实未读主动建议继续使用独立已读边界；没有目录的旧入口保留欢迎语兼容。 diff --git a/.project-docs/10-decisions/decision-index.md b/.project-docs/10-decisions/decision-index.md index 586b6142..4b9d3a4b 100644 --- a/.project-docs/10-decisions/decision-index.md +++ b/.project-docs/10-decisions/decision-index.md @@ -1,5 +1,7 @@ # Decision Index +- 2026-10-08 补充确认[学生理解与执行表达](../00-brief/project-positioning.md#学生理解与执行表达)：学生采纳老师建议后，须自己理解并向操作 Agent 表述目标与要求，老师或系统不直接交接建议触发执行；保留学生表达作为观察理解的依据，具体观察方法待讨论。 + - [老师思考与回答流式展示](ADR-2026-09-22-coding-teacher.md)：2026-09-29 已合并；主线程思考独立保存与折叠展示，正文逐步投影并由最终回复确认，快捷回复仅完成后显示；思考不进入后续模型上下文、工具活动或带回草稿。 - [老师可配置快捷提示](ADR-2026-09-22-coding-teacher.md)：2026-09-29 已合并；Yuxi 有序展示文案/实际提示词，显式发布冻结，WS 版本化下发，客户端普通提问；空列表隐藏入口，历史缺字段保持旧入口。 diff --git a/.project-docs/30-worklog/current-state.md b/.project-docs/30-worklog/current-state.md index eb204c78..294c6d6f 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-10-08 补充：用户明确纠正老师建议进入执行的方式。老师建议后，学生须自己理解、决定是否采纳并向操作 Agent 表述目标与执行要求；不通过老师／系统直接转发、自动下发或一键采纳执行替代学生表达。随后查看作品结果，老师再基于可获得的事实继续判断。学生表达为观察理解提供依据，不等于自动证明理解；具体观察方法待讨论。本次基于共识提交 `00db469` 同步[产品定位](../00-brief/project-positioning.md#学生理解与执行表达)、README、老师 ADR 和决策索引，替换原先将老师建议与操作 Agent 交接留待设计的表述；仅更新文档，未改动运行代码、配置或发布。见[同一集成记录](tasks/20261008-teacher-consensus-integration-a9c2d7e1.md)。 + - 2026-10-08：按用户明确授权更新[老师 Agent 产品共识](../00-brief/project-positioning.md#老师-agent-的产品定位)。老师 Agent 为具体真人量身打造的赛博老师，核心是见解、经验与判断，用户通过 Agent 建立连接；不同老师可承担不同职责，映射包含语言、思维、习惯与专长。上下文知识库保留情境、来源与老师确认状态；由老师本人通过题库、问答或任务参与映射验收，用户实际价值另行评估。新共识更新下方 2026-09-26 的旧定位，具体蒸馏流程、题库和评分门槛待讨论。基于主线 `753eb6ca7e743433d2fc55ee47a9bcbe2b6447c5`，核对提案源提交 `5506922ba9e6528895eab965ef9beae3d7528ebe` 后同步产品定位、README、ADR 与决策索引；仅文档更新，未读取个人 Codex 记录、实现真人映射、修改运行配置或发布服务。见[集成记录](tasks/20261008-teacher-consensus-integration-a9c2d7e1.md)。 - 2026-09-29：续接用户已授权的老师流式集成任务，将远程 `a77ddbd6813bb71d490544edfef6e1f35240070f` 与本地 `6dee9ea62c42b98a747352378fe1c74ab77f48a5` 合并。保留独立思考／正文流，接入按请求固定的模型选择、语音草稿、真实时间戳、紧凑快捷回复和各老师独立介绍；完成态正文及卡片各显示一次。同步纳入本地空作品检测、社区外部链接和 macOS 主窗口重建。582 项相关单测、47 项浏览器场景、9 项 Electron 场景、标准类型检查、变更文件 lint 与生产构建通过；修正一处仍假设单欢迎气泡的旧布局断言。Windows 夹具不代表原生 macOS、真实模型或云端模型覆盖能力已上线。失效源工作树通过保留残留目录、官方 release-missing/start 恢复登记；三份原有未跟踪文档及远程来源记录保持原样。未推送、部署、打包或更新安装版。见[续接记录](tasks/20260929-merge-teacher-stream-1e4177fe.md#remote-merge-resume)。 diff --git a/.project-docs/30-worklog/tasks/20261008-teacher-consensus-integration-a9c2d7e1.md b/.project-docs/30-worklog/tasks/20261008-teacher-consensus-integration-a9c2d7e1.md index f95b4938..c23255c3 100644 --- a/.project-docs/30-worklog/tasks/20261008-teacher-consensus-integration-a9c2d7e1.md +++ b/.project-docs/30-worklog/tasks/20261008-teacher-consensus-integration-a9c2d7e1.md @@ -13,6 +13,7 @@ ## Scope - Integrate the explicitly approved teacher Agent consensus into product positioning, README, the teacher ADR, decision index and current integrated state. +- Resume the same consensus task for the user's correction requiring student understanding and self-expression before operation Agent execution. ## Intent And Constraints @@ -20,6 +21,7 @@ - Documentation only. Preserve current runtime, published configurations and permissions. No personal Codex history access or distillation implementation. - Concurrent and Planning Gates passed. Required project memory, evidence/reflection/commitment indexes and peer scopes were read; related runtime tasks have no dependency on this prose change. One older child-language task has incomplete scope and is not a source for this integration. - Source proposal `5506922ba9e6528895eab965ef9beae3d7528ebe` exists in the shared Git repository; its completed source task record was reviewed read-only. Its exceptional-person positioning conflict is resolved by the user's explicit new direction. The source branch is retained without merging its administrative record. +- The user explicitly rejects direct teacher-to-operation execution handoff. Do not infer an exam, automatic understanding score, execution gate or a ban on sharing project facts from this correction. Resumed ownership and Planning Gates passed; peer records were re-read without changes. ## Outcome @@ -27,12 +29,15 @@ - Recorded explicit/tacit knowledge and contextual evidence direction, candidate elicitation sources, primary research limits, and teacher participation in independent held-out mapping acceptance. - Kept user value separate from mapping fidelity and left concrete distillation, representation, scoring and release thresholds open for the next discussion. - Synchronized current product summaries without asserting runtime implementation or changing technical decisions. +- Added the required student-owned step: understand the advice, decide whether to adopt it, and articulate the goal and execution requirements to the operation Agent. Direct forwarding, automatic dispatch or one-click adoption cannot replace this expression. Student expression is evidence for observing understanding, not proof of understanding. +- Replaced the open-ended direct handoff proposal with this explicit boundary; retained result review and further teacher judgment based on available evidence. Updated the same five canonical documents, with no runtime changes. ## Verification - Independent review passed: all confirmed points covered; detailed methodology remains open; research and implementation boundaries are explicit. - Project documentation structure check, task-aware integration drift check and `git diff --check` passed. Six consensus references resolve to existing local files and the stable positioning heading. - Inspected the complete positioning diff and all changed paths: five canonical documents plus this integration record, with no runtime changes. No runtime tests applicable to this prose-only update. +- Resumed correction: independent semantic-boundary review, documentation structure, task-aware drift and whitespace checks passed. New student-expression references resolve and the superseded open handoff proposal is removed. Reviewed the complete canonical diff; only the same five documents and this own task record changed. ## Follow-ups diff --git a/README.md b/README.md index b0a88033..d5d030ac 100644 --- a/README.md +++ b/README.md @@ -168,6 +168,8 @@ Pi 正式包必须继续运行 `pnpm run verify:artifact:pi`、`pnpm run smoke:p 老师 Agent 的产品共识是为现实中每位具体老师量身打造赛博版本，保留其见解、经验、语言风格、判断方式、工作习惯与专长，让用户通过 Agent 与这位老师建立持续连接。不同老师可以承担不同职责。后续由老师本人通过题库、问答或情境任务验收映射质量，并另行评估用户实际价值；上下文知识库与具体蒸馏方法仍待设计、验证，不表示现有下发智能体已经完成真人映射。完整共识见[老师 Agent 产品定位](.project-docs/00-brief/project-positioning.md#老师-agent-的产品定位)。 +产品交互原则：学生采纳老师建议后，需要自己理解并用自己的话向操作 Agent 表述目标和执行要求，再由操作 Agent 执行；老师或系统不能直接转发建议、自动下发指令或以一键采纳执行替代学生表达。这段表达为观察学生是否理解提供依据，不能仅凭点击采纳、自己表述或作品执行成功就认定已理解；具体观察与反馈方法待讨论。 + - 可在顶栏选择运营下发的 Yuxi 智能体，首次默认使用指定智能体；提示词、Skills、知识库和模型配置由 Yuxi 管理，运营同步后生成新版本，每轮接受问题时固定当前版本，历史轮次保留原版本。Yuxi 智能体模型费用由当前学生的编程词元点数支付，个人 Agents 模块仍由创建者付费；不要求学生开通个人云智能体模块。停用的智能体仍可查看历史，不能借另一位智能体的可用状态继续提问。 - Main 为智能体每轮请求绑定当前账号、项目和所选操作会话，提供 `list_project_files`、`read_project_file`、`read_conversation` 三个只读工具。云端通过持久中断请求整批读取，Main 返回配对结果并续接同一问题；若原运行仍在释放资源，保留同一批读取结果等待续接，等待期间仍支持取消并受原问题时限约束。本地旧版智能体也支持相同读取边界。可读当前项目源码及 `.makelore/project.json`，拒绝其他 `.makelore` 历史、Git 内部数据和越界路径；不提供写文件或命令执行。这些能力不按名称或人设区分。 - 本地读取使用连续分页：目录按层展开，默认四层、最多六层，跳过 `.gradle` 等生成目录；条目随页面按需产出，深层目录可单独查询；文件和会话默认每页 120 行、最多 400 行，返回连续原文、起始行列与精确 next 游标，列按 Unicode 字符计数、换行统一为 LF。单个云端结果最多 8 KiB，长行也能继续读取；不受文件 UI 的 256 KiB 预览限制。会话索引保留消息 ID 和摘要，按 ID 读取完整公开原文。每题最多十二批、累计成功结果 64 KiB（包含结果元数据），不足 512 字节时收尾；不上传 Pi 原始日志或思考。云端保留智能体对话及收到的片段，完整工程仍在本机。本地旧版模型仍按自身上下文和六批额度缩小结果。