前言¶
在 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 里系统练西语，可按上文命令安装，从侧栏「西语」进入面板即可。
