前言¶
DeepSeek Harness(DSH)的核心理念是「一切皆插件」。在构建垂直领域的智能体时,从零开始设计 Prompt 和逻辑往往耗时且容易出错。针对高中数学辅导这一具体场景,构建一个能够诊断学生思维路径、而非单纯提供解题步骤的 Agent 是一个常见需求。
ningbonb/dsh-math-thinking-teacher 插件为 DSH 提供了一个现成的「AI 高中数学思维老师」Agent 预设 Shell。它解决了如何在 DSH 中快速集成一个具备诊断优先、教学干预记录和可视化停靠栏功能的数学辅导能力的问题。
插件定位¶
这是一个为 DeepSeek Harness 提供可选的高中数学教师 Agent 预设 shell 的插件。
- 核心价值:提供一套经过结构化设计的数学教学流程,包括诊断、干预和反思。
- 维护者:ningbonb
- 许可证:MIT
核心功能¶
该插件主要实现了以下能力:
- 诊断优先的辅导指南:Agent 的核心逻辑是先诊断学生的认知状态,再进行教学干预。
- 灵活的问题接入:支持「从题库选择」或「上传自定义题目」两种模式。在题目选择模式下,仅显示题目陈述,不泄露答案或解析。
- 教学干预记录:在 Agent 进行实质性的教学干预后,会记录一条面向学生的学习笔记。
- 数学停靠栏:在对话界面侧边栏显示当前的观察、训练目标、下一步行动和可选提示。
安装与启用¶
安装后,DSH 会生成 math-thinking-teacher 预设文件。
- 执行安装命令:
dsh plugin --profile web add dsh-math-thinking-teacher
- 安装完成后需要重启 DSH Web 以加载新预设。
- 在 DSH 的原生「新建会话」页面选择
AI 高中数学思维老师预设即可开始使用。
配置方式¶
插件管理自身的预设文件。建议通过配置文件覆盖核心规则,而非直接修改生成的预设文件。
在 Web Profile 的 cordis.patch.yml 中添加以下配置项:
- id: dsh-math-thinking-teacher
config:
presetId: math-thinking-teacher
teacherName: AI 高中数学思维老师
teacherRole: You are a one-to-one high-school mathematics thinking teacher.
teachingObjective: Help learners practise mathematical representation, strategy selection, verification, and reflection.
gradeLevel: High school
teacherTone: Patient, specific, and respectful of the learner's attempt.
hintStrength: minimal
diagnosticDimensions:
- Whether the learner identifies the givens and target correctly
- Whether the learner chooses a useful mathematical representation
interventionRules:
- Advance one smallest reasoning step per response
- Ask an answerable question before giving a hint
questionBank:
- source: Functions and derivatives
title: Function monotonicity
statement: 'Given $f(x)=x^3-3x+2$, study its monotonicity.'
此外,在 DSH 设置对话框的 数学思维老师 页面,也可以调整学习者阶段、教师语气和提示强度。这些设置会覆盖配置文件中的默认值,用于下一次数学模式响应。
注意事项¶
- 普通会话不受影响:普通会话保持
standard预设,该插件不会修改用户的默认预设。 - 题库与规则管理:题库和核心教学规则完全由配置文件管理。
- 权限与安全:由于插件以当前 DSH 进程的权限运行,建议在安装前检查源码与许可证(MIT)。