前言¶
在 DeepSeek Harness（DSH）里写智能体、调模型，往往占满整块时间；想练口语表达，又要单独开 App 或网页，和当前工作环境脱节。社区插件 dsh-english-break（界面名「英语空档」）把短时段英语练习嵌进 DSH 原生侧栏与右侧面板：日常口语、工作场景、造句反馈与间隔复习都在本地进度里完成，模型调用走 DSH 已配置的 LLM，不混入工作会话。
下面介绍插件定位、能力、安装方式与典型用法；事实均来自项目 README 与 package 声明。
这是什么¶
dsh-english-break 是 qiufengsir 独立维护的开源 DSH 社区插件，MIT 许可。定位是：在休息空档做日常对话与工作英语练习，含 AI 随机话题预览、造句反馈、连续对话与纠错追问、表达收藏与间隔复习、草稿与 JSON 导入导出。
分类上属于模型推理类插件：提交反馈、追问或生成随机话题时会调用所选模型，可能产生服务用量。插件不读取工作对话、源码或剪贴板；学习数据保存在 DSH home 的 storages/dsh-english-break（默认 state.json）。
兼容 DSH 0.2.1-rc.3（package.json 中 engines.dsh 与 peer 依赖一致）；其他 DSH 版本尚未在资料中验证。
核心功能¶
练习内容与模式¶
- 练习页「全部 / 日常口语 / 工作英语」决定下一个话题类型，不会切换当前正在做的练习。
- 内置场景：资料写明侧栏入口包含 6 个日常、6 个工作场景，渐进提示、造句反馈、再次表达、收藏与到期复习；未配置模型时仍可用参考句练习。
- 「AI 随机话题」由所选模型即时生成情境与开场白，不是联网新闻检索；生成前需已选模型。换题两步：先生成预览，再点「开始这个话题」；可「返回上一话题」在最近一对话题间切换，预览与上一话题随学习记录持久化。
对话与反馈¶
- 对话不再在第 3 次回应后强制结束；由用户点击「结束本轮」。完整历史在本地；模型侧只带最近 6 次回应，避免单次请求无限膨胀。
- 每条造句反馈下可「追问这条反馈」（可用中文质疑、要原因或例子），连续追问，不占造句轮次；每条反馈最多追问 20 次。追问走后台任务与进度查询，支持取消；重新表达会替换该次反馈及讨论。
- 收藏句子保留当前对话，可继续输入；首次收藏次日复习。收藏不代表已掌握。
模型与界面¶
- 默认「跟随 DSH 系统默认模型」，每次请求读取
agentDefaultModel.currentSelection()（含思考档位）；系统默认变更在下一次练习生效。设置里可手动选插件专用模型。 - 单次输出预算上限 16384 tokens，服务端最多等待 180 秒；追问正文最多保存 32000 字符。
- 原生主面板与右侧面板，适配小窗口滚动。左侧「英语空档」或会话右侧「英语空档」均可打开；设置里选好 DSH 已配置的模型后，可点「练两分钟」。
当前仅支持文字表达，不提供语音识别或发音评分。
安装与启用¶
这是非官方社区插件，安装前建议自行查看 GitHub 源码与 LICENSE。插件以当前 DSH 进程权限运行。
预构建包（推荐）¶
从 Releases 下载最新 .tgz，在 DSH 插件安装入口选文件，或完全退出桌面版后执行：
dsh plugin --profile desktop add ./dsh-english-break-0.3.0-alpha.2.tgz
预构建包无需授权源码构建脚本。资料中示例版本为 0.3.0-alpha.2；安装请以 Releases 页最新包名为准。
从 GitHub 源码安装¶
dsh plugin --profile desktop add github:qiufengsir/dsh-english-break#v0.3.0-alpha.2
包内 prepare 会执行构建。pnpm 10+ 首次可能拒绝构建；按终端提示，将打印的确切包键写入该 profile 的 pnpm-workspace.yaml，例如：
allowBuilds:
dsh-english-break: true
只为可信源码授权；建议将版本标签换成本次发布的固定提交 SHA。无需改 DSH 安装目录，dsh.bundle.patch 会注册插件。
插件市场索引（可选）¶
在 DSH 启用「实验性插件 → 自定义插件市场」，于「插件 → 发现 → 添加索引源」填写：
https://qiufengsir.github.io/dsh-english-break/index.json
此为项目自维护源，非 DSH 官方默认收录。Pages 不可用时可用：
https://raw.githubusercontent.com/qiufengsir/dsh-english-break/main/docs/index.json
Git 来源安装仍可能需要上述 allowBuilds 授权。
首次启用后，在侧栏打开「英语空档」即可。打包安装与本地开发补丁（node scripts/desktop-local.mjs install）不要同时启用。
典型用法¶
- 在插件设置中选择 DSH 已配置的模型（或保持跟随系统默认）。
- 从左侧「英语空档」或会话右侧入口打开面板，点击「练两分钟」开始。
- 按情境用英语回应，查看造句反馈；需要时对某条反馈「追问」，或「再次表达」替换该轮反馈。
- 满意表达可收藏；到期条目会进入复习流程。草稿约 400ms 防抖保存，切换面板后仍保留。
- 想换情境：选分类后使用「AI 随机话题」或内置换题流程，预览确认后再「开始这个话题」。
- 备份与迁移：在设置中 JSON 导出；导入会替换当前进度，操作前请先导出备份。
模型调用会将练习内容发给 DSH 所配置的模型服务；费用与速度取决于所选服务，资料中的自动化测试未测量真实服务用量。
适用场景与注意¶
适合：已在 DSH 桌面版（profile desktop）工作、希望把 English break 留在同一客户端里的开发者或知识工作者；需要结构化反馈、收藏与间隔复习而非单纯背词 App 的用户。
注意：
- 仅验证与 0.2.1-rc.3 的兼容；升级 DSH 前请对照仓库
engines与 issue。 - 所有 LLM 相关操作可能计费；无模型时仅能参考句静态练习。
- 学习记录位于用户 DSH home，卸载插件前请导出 JSON。
- 真实模型反馈质量、Electron 全量交互与 README 中的固定响应测试不等同；自行评估是否满足学习目标。
结尾¶
dsh-english-break 把日常与工作英语练习做成 DSH 内的原生面板：短会话、可追问的反馈、本地进度与可选市场索引安装，适合在写 Harness 的间隙练表达。社区目录与 GitHub 如下，安装命令以 README 为准。
- 目录页：https://www.skillhub.cn/plugins/qiufengsir/dsh-english-break
- 仓库：https://github.com/qiufengsir/dsh-english-break
