English | 简体中文

dsh-explain — DSH 学习模式插件

✅ 状态：M6 已完全在 Explain 内实现并通过 DSH 0.1.0-rc.6 验收；无需修改或依赖其他插件。 产品需求见 docs/PRD.md；技术方案见 docs/ARCHITECTURE.md。

一句话定位：把多个 DSH 工作会话中值得学习的内容汇入用户唯一的全局学习线程，为每个来源会话保留至多一个活跃讲解，并用全局学习上下文持续适配用户的知识水平和讲解偏好。

核心形态

• 一个 $DSH_HOME 只有一条本地学习线程；工作会话、恢复和 fork 不复制学习状态。
• 每个顶层来源会话可以有一个等待反馈的讲解，也可以没有；同一来源未反馈时不再生成第二条，其他来源仍可继续。
• 用户可在任意已建立或空白工作 Session 的 composer 输入 /explain ，主动要求 explain agent 生成一条讲解；管理命令 /explain on|off|status 保持不变。
• 用户可选中可见文字后使用 composer 工具行中的 Explain 快捷入口，也可在任意已完成 assistant 回答上选择「学习这个回答」；两者只创建可编辑草稿，绝不自动提交。
• 主动讲解、自主讲解、重讲和压缩共享全局调度器，任何时刻最多一个辅助模型请求；主动请求优先于后台工作，但不打断已在途的主动请求或重讲。
• 自主判断默认最多发送 50 次/滚动 24 小时；占额跨重启保留，失败和重试计数，用户触发的主动讲解、重讲与压缩豁免。
• explain 维护私有的全局 ExplainContext，汇总对话偏好、知识概况和学习进展；它只进入辅助模型，不注入主 Agent。
• 有新的结构化观察或已关闭讲解且用户连续 30 分钟未操作 explain，或预计辅助请求占所选模型上下文 50% 以上时，自动压缩辅助模型历史；用户可见原始记录不删除。
• 主模型不知道 explain 存在；explain 不写主 Session 日志、不注入主模型上下文、不阻塞主 turn。
• 学习历史、来源活跃状态、压缩检查点和 ExplainContext 持久化到 $DSH_HOME/dsh-explain/v1/thread.sqlite；开关与模型设置走 $DSH_HOME/settings.yaml。
• 首个讲解 entry 保存最多 2,000 字符的受限来源摘要供后续重讲；来源 Session 删除不影响重讲，摘要不向学习视图返回。
• 学习线程使用 DSH 第一方 conversation.view 槽位中的「学习」Tab；普通配置与运行诊断使用第一方 settings.section，不引入外部 UI 宿主。
• 「学习」是 Session-scoped 视图入口，但业务数据来自同一个全局 client store 和 typed Remote；不同工作 Session 看到同一条学习线程。
• 设置页和学习视图复用同一个 browser store；用户可在设置中选择辅助模型、启用学习模式、调整滚动 24 小时自主额度，并查看路由、额度恢复、上下文压力和最近压缩。
• 讲解来源仍在当前 Session inventory 时可直接打开；来源被删除后历史保持可读并显示不可用。
• P0 不自动切换视图。空白 Session 的 Hero 阶段不显示视图 Tab；进入学习视图后，当前工作 Session 的 composer 仍然保留。
• P0 没有外部 UI 依赖，不携带或要求安装 better-sidebar。

动机

• DSH 能完成复杂工作，但用户通常只看到结果，不一定理解过程中用到的概念、取舍和常见误区。
• 学习模式把工作会话变成学习素材来源，不要求用户先知道应该问什么。
• 用户的学习事实和进度需要跨工作会话保持一致，因此所有内容进入一条全局线程；按来源保留的活跃讲解让用户回到相关工作时继续反馈。

当前进展

• 需求查重：产品目标无直接重复，相关插件可提供局部实现参考。