前言¶
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）。
