前言¶
在 DeepSeek Harness（DSH）裏做語言學習，常見做法是整段對話讓模型出題、再讓模型判對錯。變位、陰陽性、複數這類題答案唯一，每次走模型既慢又耗 token，前端改答案還難防作弊。若你已經在用 DSH，又需要可離線、可重複的西語機械練習，同時保留「自由造句」由模型批改，下面介紹社區插件 dsh-spanish-tutor（維護者 liuyize-CHE）。它在 DSH 生態裏歸類爲「模型推理」：判分與出題規則在宿主側本地完成，模型主要負責講解、情景批改和查表輔助。
這是什麼¶
dsh-spanish-tutor 是面向 DSH 的西語練習插件（當前 package 版本 0.2.0，MIT 許可證）。一句話定位：六類本地判分的練習 + 情景造句（模型批改），覆蓋從認詞、變形到整句與表達的路徑。詞庫與規則層按西語編寫（11 個時態、不規則動詞、陰陽性與複數例外等），不是套用英語詞庫改幾個詞。
核心功能¶
七類練習與判分分工¶
| 題型 | 練什麼 | 判分 |
|---|---|---|
| 動詞變位 | 11 個時態 × 6 人稱 | 本地引擎 |
| 名詞陰陽性 | 陽性/陰性（含 mano、día 等特例） | 本地引擎 |
| 名詞複數 | 含 luz→luces、joven→jóvenes | 本地引擎 |
| 認詞 | 詞義選擇（西→中、中→西） | 本地引擎 |
| 句子填空 | 挖變位/冠詞/介詞/形容詞的整句 | 本地引擎 |
| 語法專項 | ser/estar、虛擬式、por/para 等 | 本地引擎 + 自帶規則說明 |
| 情景造句 | 給場景寫一句西語 | 模型批改 |
機械練習由本地規則引擎（詞庫）出題、毫秒級響應、可離線、零 token；自由表達與「爲什麼錯」交給模型；判分在 host 端重算，/session 不下發 answer，改前端無法作弊。情景造句的參考答案用 refToken 暫存服務端（TTL 30 分鐘），批改時再取回。
學習與講解¶
「學」和「練」分開設計，不是隻有做題：
- 先學一下：模型講知識點 + 例句 + 易錯點，再作答。
- 看答案：卡住時直接揭曉，不燒 token。
- 先練：直接做，答錯時模型講原因。
進度頁可切換學習方式：先學後練 / 只給最短答案 / 關閉講解。選「關閉」後完全不調模型（情景造句隨之不可用）。語法題每道帶一句本地 rule（如 ser/estar 用法），答錯時規則先顯示，不依賴模型是否在線；模型不可用時會降級，仍給答案，只是沒有講解。
間隔重複與其它能力¶
內置 8 級 SRS：答對升級、答錯退兩級；只差重音不升不降。難度可選 A1 / A2 / B1（B2/C1 已從選項下架，詞庫中無對應詞）。進度頁正確率爲完全正確率（重音錯不算對），並單獨統計「只差重音」題數。
面板四個頁籤：練習、情景造句、查表（動詞變位全表或名詞陰陽性/複數/冠詞）、進度（統計與設置）。對話裏還可通過模型工具 spanish_conjugate、spanish_noun、spanish_quiz、spanish_progress 查變位、查名詞、出題或看進度。
學習進度寫入 ~/.dsh/spanish-tutor/progress.json（或 $DSH_HOME/spanish-tutor/），與插件目錄分離，更新插件不丟進度。
安裝與啓用¶
從 GitHub 安裝（命令來自項目 README）：
dsh plugin --profile web add github:liuyize-CHE/dsh-spanish-tutor
也可在插件管理面板「瀏覽更多插件」中搜索 spanish 安裝。
若 DSH 只有 desktop 一個 profile，不要用 --profile desktop 裝（CLI 會拒絕）；此時用插件管理面板安裝。裝完後必須完全退出 DSH 再打開——客戶端模塊清單在啓動時掃描並緩存，僅刷新頁面不會加載新插件。
運行環境要求（見 package.json）：Node >=20，DSH >=0.2.0-rc.1；客戶端注入面向 web profile。
典型用法¶
圖形界面¶
- 在左側欄找到 「西語」 一行，點任意位置在中間欄打開練習面板。
- 面板右上角 ✕ 回到會話。
- 在 練習 頁作答；需要時用 先學一下 或 看答案。
- 在 進度 頁調整難度、題型、時態、學習方式，以及可選的「講解用哪個模型」（默認可跟隨 DSH 主對話模型，也可指定更便宜的小模型講題）。
鍵盤：Enter 提交或下一題；選擇題可用 1–9 或 a–i 選對應選項。
對話裏¶
可直接說例如「考考我西語」「tener 的虛擬式怎麼變」「mano 是陽性還是陰性」，由上述四個 spanish_* 工具響應。
適用場景與注意¶
適合誰：已在 DSH 裏日常用模型、又希望西語基礎題（變位、名詞、認詞、填空、語法辨析）穩定、可離線、少 token 的學習者或開發者自測。
安全與權限：插件以當前 DSH 進程的權限運行，會讀寫 $DSH_HOME 下進度文件並調用你配置的模型做講解與情景批改。安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認符合你的環境策略。
生態說明：DSH 社區插件目錄（如 SkillHub 上的條目）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；本文事實以倉庫 README 與 package.json 爲準。
結尾¶
dsh-spanish-tutor 把「可規則化的西語練習」放在本地引擎，把「需要理解的講解與造句」留給模型，並在 host 端統一判分與進度口徑。若你要在 DSH 裏系統練西語，可按上文命令安裝，從側欄「西語」進入面板即可。
