dsh-increasing-my-english

DSH PLUGIN视觉与多模态

仓库 LeeKai233/dsh-increasing-my-english · npm dsh-increasing-my-english

视觉与多模态 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

DSH 英语精读插件:用百炼 CLI 把播客转写为分角色文稿,在右侧边栏阅读并按 Ctrl 划词查词、自动收录生词本。

一句话选型结论

按资料字段整理

dsh-increasing-my-english 是视觉与多模态类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类视觉与多模态 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-11-11
README 31.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:LeeKai233/dsh-increasing-my-english
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-increasing-my-english可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-increasing-my-english:DeepSeek Harness 里的英语精读侧边栏

  • 播客音频转写为分角色文稿
  • 右侧边栏沉浸式精读
  • Ctrl 划词查词与例句
  • 生词本自动收录与导出
  • 环境自检与 PDF 导入

上游标签

deepseek-harnessdshdsh-pluginenglish-readingtranscriptvocabulary

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-12): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在视觉与多模态场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-increasing-my-english当前 L4 · 沙盒安装通过 低风险 0 未标注 有
open-design L4 · 沙盒安装通过 低风险 10.0 万 未标注 有
awesome-gpt-image-2 L3 · 安装规范通过 低风险 3.4 万 未标注 无
PicGo L3 · 安装规范通过 低风险 2.7 万 未标注 无
iPolloWork L4 · 沙盒安装通过 低风险 6,775 未标注 有
modlens L5 · 运行验证通过 低风险 4,207 0.2.0-rc.2 等 13 个 有

仓库档案

视觉与多模态
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方LeeKai233仓库 dsh-increasing-my-english · 默认分支 main
分类视觉与多模态media
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-11 · 2026-11-11最后推送 2026-11-13
本站收录2026-11-12首次进入本站目录的时间

README 全文

31.8 KB
作者原文,中文版优先;只做安全转义,不改内容

英语精读(dsh-increasing-my-english)

English · 更新日志 · MIT 许可证

把播客录音用百炼 bl speech recognize 转成分角色文稿,在 DSH 右侧边栏精读;选中单词或句子按 Ctrl 查词,点一下收进带音标、释义、例句、词形与词源的生词本;生词本会在插件空闲时自动对比全部文稿补全多义(同一个词在别的文稿里的其它意思也会收进来);再打开第三个视图「背记」,每天按掌握度做一轮主动回忆;第四个视图「图谱」把文稿、单词以及单词之间的联系画成关系图。



需要 DSH >= 0.2.0(Web 界面:桌面版或 dsh web 均可)。转写需要已登录的百炼 CLI,PDF 导入需要本机 poppler。

让 Agent 带你跑起来(推荐)

把下面这段话原样粘贴到一个新的 DSH 对话里发送(工作区选你想放英语材料的文件夹)。助手会读详细引导,做完不需要你动手的部分,最后只回你:它做了什么、只剩什么要你做、现在 10 分钟读哪一段。

你是我在 DSH 里的英语精读搭子。先读详细引导
https://raw.githubusercontent.com/LeeKai233/dsh-increasing-my-english/main/AGENT_ONBOARDING.zh.md (如果当前仓库里有
AGENT_ONBOARDING.zh.md,就直接读本地文件),然后照它执行。不需要我动手的你全做;必须我动手时才停。
最后只回三段:你完成了什么、只有我能做什么(写清点哪里)、现在 10 分钟读哪一段。
不要删改我的数据,除了百炼 ASR 和插件查词别外传,不要回显凭据。读不到引导就让我把文件挂载给你。

想自己动手?下面的「三步用起来」就是同一套步骤。

三步用起来

  1. 安装 DSH 桌面版(DeepSeek 官方):。
  2. 装插件:侧栏「插件」→「添加插件」→ 输入 dsh-increasing-my-english → 安装并启用。
  3. 准备百炼:注册阿里云百炼,按下一节「百炼 CLI 安装与登录(图文)」装好 bl 并登录。

之后打开右侧边栏的「英语精读」面板,等空状态里的「环境自检」全绿(需要 bl 已登录、Poppler 与工作区都就绪;已有文稿时,打开「转写录音」面板也能看到这张卡),就可以把录音放进 recordings/ 开始转写了。查词收进生词本后,再打开面板第三个视图「背记」,每天做一轮主动回忆并把生词真正记住;想看看这些词和文稿怎么连在一起,就打开第四个视图「图谱」。

百炼 CLI 安装与登录(图文)

> 截图来自阿里云百炼控制台的 CLI 页(中国站:)。控制台界面会随版本更新,按钮位置如有微调,以页面实际内容为准。

1. 打开 CLI 页,让 Agent 帮你安装(推荐)

打开 ,在「安装 CLI」里点「让 Agent 安装(推荐)」→ 点「复制给 Agent」,把复制的提示词原样粘贴到 DSH 的新对话里,让助手识别系统、执行官方安装命令并回报真实的 bl --version 校验结果。提示词原文:

请阅读官方安装文档 https://bailian.aliyun.com/cli/install.md,为我安装阿里云百炼 CLI。
先识别操作系统与 Node.js/npm 环境,再按官方文档选择并执行对应的安装命令。
安装后自动执行 bl --version,向我返回真实的版本号和检查结果;若失败,请说明错误原因,不要虚报安装成功。

同一页还折叠着「手动安装」,想自己敲命令可以展开对照。

2. 复制快捷登录命令

切到「鉴权配置」→ 在「快捷登录(推荐)」里点「复制」,得到:

bl auth login --console

另一条路是「API Key 配置」(自己把 Key 写进环境变量);本插件只要求 CLI 已登录,推荐用快捷登录。

3. 打开 PowerShell 7

按 Windows 开始菜单,搜索 powershell,打开 PowerShell 或 PowerShell Preview:

  • 优先用 PowerShell 7(Windows Terminal 里的 PowerShell);
  • 不要用旧版 Windows PowerShell 5.1(搜索结果里带 "Windows PowerShell" / "ISE 5.1" 的那几个);
  • 没装 PowerShell 7 就去微软商店装一个。终端背景是黑色还是蓝色无所谓。

4. 粘贴命令并回车

在 PowerShell 窗口里粘贴第 2 步复制的 bl auth login --console,按回车。

5. 浏览器登录 / 注册

回车后会自动弹出浏览器让你登录阿里云账号(没有账号就先注册)。登录/注册成功后会自动创建 API Key;新用户有免费额度,只要不充值,额度用完后模型会自动停止使用,不会自动扣费。

6. 同意授权

已登录的账号会看到授权页,点「同意授权 CLI 登录」。

7. 登录成功

终端里出现「CLI 登录成功!」,并把登录凭据保存到 …\.bailian\config.json(Windows 下即 %USERPROFILE%\.bailian\config.json)。

8. 查看免费额度

在终端运行 bl usage free 查看各模型的免费额度(bl usage free --all 看全部)。本插件转写默认用 qwen-audio-3.1-asr-flash-filetrans,转写前可以先在这里确认额度。

零命令行路径

不想碰终端也可以:开一个新对话,对助手说「帮我安装百炼 CLI」「帮我登录百炼 CLI」。助手会用后台终端跑官方安装与 bl auth login --console,等浏览器弹出后你只负责完成登录与「同意授权」,最后让助手回报 bl --version 与登录状态即可。面板的「环境自检」也会复核结果。

国内网络

环节 建议
安装 DSH 插件 插件页会自动在 registry.npmjs.org 与 registry.npmmirror.com 之间挑更快的源。新发布的包在 npmmirror 首次同步可能有 5–10 分钟延迟;刚发布就提示找不到时,等几分钟再装即可。
百炼 CLI bl 用百炼中国站的官方安装文档/脚本(),不要走第三方镜像。
poppler(PDF 导入) 推荐 winget install -e --id oschwartz10612.Poppler;已经装过 poppler 的,可以用环境变量 DSH_ENGLISH_PDFTOPPM / DSH_ENGLISH_PDFTOTEXT 指向已有的 pdftoppm.exe / pdftotext.exe。
GitHub 只有开发者需要用(源码、Issues、Release 说明);普通用户装插件与登录 CLI 都不依赖直连 GitHub。

功能

跨项目共享(顶部开关)

  • 面板顶部工具栏有一个「跨项目」开关,默认关闭。打开后,当前项目成为共享库:数据仍留在这个项目目录里,不复制、不搬移;其它项目打开同一面板会直接看到它的文稿、生词本、背记进度、查词缓存、录音与 PDF 页。
  • 关闭开关后,各项目立即回到自己的数据;共享库里的文件保持不变。换库方式:先关闭,再到目标项目重新打开。
  • 共享期间所有项目共用共享库的 .dsh-english/config.json(转写模型、查词后端等设置以它为准);有转写任务进行中时不能切换;共享库目录不可用时数据操作会报错,但开关仍可关闭。
  • 开关保存在用户目录的 .dsh/english-practice.json(存在 DSH_HOME 时用 DSH_HOME/english-practice.json),内容为 { "version": 1, "sharedRoot": "<绝对路径>" };删除该文件等于关闭并回到各项目自己的数据。多个 DSH 实例同时写同一共享库为 best-effort。
  • 共享期间「转写录音」列的是共享库的 recordings/;要转写本项目里的音频,用「选择文件夹」或直接粘贴绝对路径。
  • 共享库项目不要删除或移动;共享库路径失效后,先关掉开关回到本项目数据,再修复或重新指定。

转写录音

  • 把音频放进工作区的 recordings/(mp3 / m4a / wav / aac / flac / ogg / opus / amr / wma / mp4 / webm)。
  • 面板「转写录音」里选文件:默认列出 recordings/;也可以粘贴任意文件夹或音频文件的绝对路径后点「扫描」,或用「选择文件夹…」调系统目录选择器;再选「模型」(默认 qwen-audio-3.1-asr-flash-filetrans,列表由 Host 提供)、可选填说话人数(始终启用说话人分离),点「开始转写」。转写在后台运行,通常 1–3 分钟,完成后文稿自动出现。
  • 也可以直接在对话里说「转写 recordings/xxx.m4a」或给出绝对路径,助手会调用 english_transcribe 工具并等它完成。
  • 默认模型 qwen-audio-3.1-asr-flash-filetrans,失败会自动回退 fun-asr,回退信息记录在文稿的 warnings 里。

阅读文稿

  • 打开方式:会话头部工具条上的耳机按钮(悬停提示「打开英语精读」),或右侧栏 guide 里的「英语精读」卡片。面板顶部是「文稿 / 生词本 / 背记 / 图谱」四个视图切换和字号 A− / A+(12–20px,「文稿」「生词本」「背记」各自记住上次的值;图谱是画布,不跟随字号)。
  • 打开面板时默认回到上次看的那一篇(记在浏览器本地,刷新页面、切换会话都保留);只有这一篇被删除或不在当前工作区时,才退回最新转写的一篇。
  • 有文稿时,顶部下拉框(「选择文稿」)可切换;文稿按说话人分段、每段带时间戳。
  • 导入的文稿没有说话人和时间戳,也不显示「合并短句」;PDF 文稿顶部还有缩放(+ / −,记住上次比例)与「DSH 预览」按钮,可在 DSH 里打开原 PDF。

划词查词

  • 在文稿里选中单词/短语(≤4 个词)或句子,按 Ctrl(macOS 用 ⌘):
  • 单词/短语:浮窗显示音标 + 1–3 条中文释义(词形与词源在加入生词本后的词条卡片里查看);
  • 句子:浮窗只显示中文翻译。
  • 已收进生词本的词/短语在文稿中带虚线标记;再次选中时浮窗直接使用生词本里的音标与释义(句子用已保存的翻译),不再调用模型。新词的查询结果会写入 .dsh-english/lookup-cache.json,下次命中缓存。

生词本

  • 点浮窗右上角按钮加入生词本,重复内容不会重复入库;查词失败的条目以「待补全」入库,稍后可以补。
  • 单词条目会自动带上:
  • 词形:不同词性(名词/动词/形容词/副词…)与不规则形式(过去式、过去分词、复数、比较级、最高级、现在分词、第三人称单数等),最多 8 条;
  • 词源:来源语言 + 词根/词缀拆解(例如 nostalgia = 希腊语 nostos「返乡」+ algos「痛苦」)+ 一段中文词源说明。
  • 老词条没有这些字段时,卡片上会出现「补全词形/词源」按钮,点一下重新查询并补全(对应 HTTP action vocab.enrich 与工具 action=enrich)。
  • 多义自动补全:当用户没有使用插件(面板关闭 / 隐藏,最近约 3 分钟没有面板请求)时,后台会逐批把生词本里的单词放到当前工作区全部文稿里找真实用法,调用查词后端把「别的文稿里出现过的其它意思」追加进词条。新义项带语境例句与来源文稿证据,已有释义只补证据、不覆盖,最多保留 8 条;上下文不足 2 条的词只标记「没有更多上下文」,不会调用模型。只有语料 / 词形 / 原例句变化或失败重试窗口到期才会重新分析,不会反复消耗模型;卡片上会显示「多义分析:N 处 · M 篇文稿」,也可点「分析多义」立即分析这一个词(HTTP vocab.analyze、工具 action=analyze)。
  • 重复释义自动合并:词典释义与多义分析给出的近义条目会按中文片段折叠成一条(例如 v. 介入;干预;调停 与 v. 介入;干预 合并、n. 丑闻 与 n. 丑闻(尤指性丑闻) 合并),保留更完整的写法与原例句/来源;跨词性只在一条严格包含另一条时合并,n. 增加 与 v. 增加 这类同词不同性的义项保持独立。词卡、背记卡、图谱详情、查词浮窗、vocab/生词本.md 与助手看到的列表都按同一规则展示,历史重复会在下次改写该词条时落盘收敛。
  • 生词本视图支持搜索、按「单词 / 句子」过滤、按文稿筛选、排序(时间 / A–Z)、详情「全 / 简」与删除;有「待补全」条目时顶部会出现提示条和「复制补全提示」按钮——把提示词粘贴到对话里,助手就会用 english_vocab 读 pending 条目并写回音标、释义与例句翻译。
  • vocab/生词本.md 是每次变更后自动重写的可读导出。

背记

  • 面板顶部第三个视图「背记」把生词本里的单词做成主动回忆练习:英→中(给英文单词和音标,写出中文意思)、中→英(给中文释义,写出英文单词)、混合(同一轮里两种方式交替)。句子条目不会进入背记,没有中文释义的单词也不出题。
  • 每个单词有掌握度 0–5(生疏 / 初识 / 初记 / 熟悉 / 掌握 / 精通)。提交答案后显示自动判断(正确 / 接近 / 不正确,仅供参考)和正确答案,再按 忘记 / 模糊 / 记得 / 熟练 自评(按钮可点,快捷键 1–4,Enter 采用自动判断的推荐档);掌握度随之升降,下次复习间隔按 1 / 1 / 2 / 4 / 7 / 15 天 安排(答错的词最早明天再来,不会当天重复出题)。
  • 每天首次打开背记时自动生成当天固定一轮:先取到期该复习的词(按到期日、掌握度排序),再用每日新词上限补新词,总题量有上限;当天反复进入不重排、不追加;当天已有轮次后再加入生词本的词,明天才进入。
  • 不记得可以点「不会,直接看答案」。答题卡上还有「显示例句」按钮:点开显示包含这个词的例句(中→英时把目标词挖空成等长下划线,不直接给答案),没有例句时会提示去生词本补全;提交后揭示区也会带例句与翻译。答完显示今日完成情况与答对数、连续复习天数、最近 14 天记录。「掌握情况」是独立页面:点顶部「今日复习 / 掌握情况」标签切换进入,不再堆在练习卡下面;表格按掌握度排序列出单词 / 掌握度进度条 / 等级 / 下次复习 / 操作(各列左对齐),每个词可单独重置,页面底部可重置全部进度。
  • 删除生词本里的词条后,对应的背记进度会在下次读取时自动清理;进度保存在 .dsh-english/recall.json,删掉这个文件等于从零开始。
  • 练习方式可随时切换,选择记在浏览器本地;Host 配置里的 recall.mode 只是首次打开的默认方式。

图谱

  • 面板第四个视图「图谱」把材料之间的关系画出来:文稿节点(播客转写与导入的文档)和单词节点(生词本里的单词),四种联系全部由本地数据现算,不调用模型、不写任何文件:
  • 出现 / 来源(文稿 ↔ 单词):这个词(含词形;忽略大小写,撇号与连字符归一)确实出现在这篇文稿里。单词被收录时所在的那篇标为来源,并带上当时的例句;其它文稿只显示出现次数。
  • 同句共现(单词 ↔ 单词):两个词在同一篇文稿的同一句里一起被用到。
  • 同根 / 同族(单词 ↔ 单词):共享有意义的词源词根(ad- / in- 这类词缀不算),或一个词形出现在另一词条的词形表里。
  • 近义(单词 ↔ 单词):两个词的中文义项里有相同片段。
  • 交互:拖动节点,滚轮或 + / − 缩放,复位视图把整张图放进画布;顶部分段控件可在「全部 / 文稿-单词 / 单词-单词」之间筛选;搜索框找到单词或文稿并居中;点击节点打开详情面板(释义、掌握度弧环、例句、关联文稿与单词),面板里可「打开文稿」跳到文稿视图,也可「只看这篇文稿」把图缩小到一篇文稿的词。
  • 图谱是只读派生:每次进入都从 transcripts/、vocab/vocabulary.json 与背记进度现算,不新增数据文件;删词条或删文稿后下次进入即消失。词或文稿很多时按关联度保留最相关的一部分,并在面板里提示截断数量。

PDF 导入

  • 「导入文稿」支持 .txt / .text / .md / .markdown / .html / .htm / .tex / .rst / .log(≤3MB)和 .pdf(≤20MB,默认最多渲染 120 页)。
  • HTML 去标签、Markdown 去标记、TeX 去命令但保留 $…$ 公式(侧边栏渲染上下标、分数、根号)。
  • PDF 在侧边栏按页显示:本机 pdftoppm 渲染页面图 + pdftotext -bbox 生成词坐标文本层,可以像普通文稿一样划词按 Ctrl 查词,已收录词同样有虚线标记。
  • PDF 导入依赖 poppler(pdftoppm / pdftotext)。没装时导入会失败,「环境自检」卡会提示 winget install -e --id oschwartz10612.Poppler。

合并短句 / 删除

  • 「合并短句」(仅转写稿):同一说话人、停顿不超过 asr.mergeGapMs(默认 4000ms)的相邻短句合并成段;转写时也会自动应用。
  • 「删除」需要再点一次「确认」;只删 transcripts/.json、对应的任务记录与 PDF 页缓存,不会删除你的录音文件。

环境自检

  • 在没有文稿的空状态或打开「转写录音」面板时会出现「环境自检」卡(数据来自 env.check,不做本机探测)。卡片默认折叠,只有检测到问题时才自动展开一次;点标题可手动展开/收起。
  • 状态 chip:bl(正常 / 未安装 / 未登录,展开后显示版本号)、PDF(正常 / 未安装,即 Poppler)、工作区(正常 / 不可写);启用「跨项目」时再加一个 共享库(正常 / 不可用)。
  • 展开后显示 bl、PDF 工具 (Poppler)、工作区 详情,transcripts / vocab / recordings 三个目录状态与可写性;启用共享时还会显示共享库路径与同样的目录/可写性检查。「提示」(warnings)列表,以及「重新检测」按钮。
  • 命令按缺失项给出、可一键复制(不缺失就不显示):bl 未安装 → npm i -g bailian-cli --registry=https://registry.npmmirror.com;bl 未登录 → bl auth login --console;Poppler 缺失 → winget install -e --id oschwartz10612.Poppler(Linux / macOS 用 brew install poppler / sudo apt install poppler-utils)。装好后点「重新检测」。注意:Poppler 只影响 PDF 导入——没装 Poppler 时转写与查词照常可用,但自检不会全绿(PDF chip 显示「未安装」)。

工作区数据布局

<工作区>/
recordings/                     你放外部录音(插件只读)
transcripts/.json         归一化文稿(分段 + 毫秒时间戳)
transcripts/.jobs/.json     转写任务状态(每 15s 心跳,超 90s 未更新视为中断)
transcripts/.jobs/.raw.json 原始 ASR 结果
vocab/vocabulary.json           生词本数据源(单词 + 句子两种条目)
vocab/生词本.md                 每次变更后自动重写导出
.dsh-english/config.json        可选:覆盖默认配置(见下)
.dsh-english/lookup-cache.json  查词缓存
.dsh-english/recall.json        背记进度(掌握度、每日轮次;删词条后自动清理)
.dsh-english/pdfs//       PDF 导入缓存(source.pdf / page-XX.png / words.xml)

数据格式为 version: 1 并保持冻结(只允许新增可选字段);背记进度 .dsh-english/recall.json 是独立的新数据文件,同样为 version: 1。JSON 损坏时会备份成 *.corrupt-<时间戳> 再按默认值继续。

开启「跨项目」开关后,以上目录都位于共享库(打开开关时所在的项目);关闭后各项目重新使用自己的目录。共享库目录本身不会被复制或移动。

配置

.dsh-english/config.json 可选,不存在时使用默认值:

{
"asr": {
"model": "qwen-audio-3.1-asr-flash-filetrans",
"fallbackModel": "fun-asr",
"language": "en",
"maxJobMinutes": 30,
"pollIntervalSeconds": 2,
"mergeGapMs": 4000,
"toolTimeoutMinutes": 32
},
"lookup": {
"backend": "ds",
"provider": null,
"model": null,
"timeoutMs": 20000
},
"import": {
"maxPdfPages": 120,
"dpi": 100
},
"dirs": {
"recordings": "recordings",
"transcripts": "transcripts"
},
"recall": {
"newPerDay": 10,
"dailyLimit": 30,
"mode": "mix"
},
"analysis": {
"enabled": true,
"idleMinutes": 3,
"batchWords": 2,
"maxContexts": 6,
"maxContextChars": 240,
"timeoutMs": 30000,
"retryMinutes": 10
}
}

配置由 Host 缓存约 2 秒:保存后稍等片刻即生效,不需要重启 DSH。

键 默认 说明
asr.model qwen-audio-3.1-asr-flash-filetrans 默认转写模型
asr.fallbackModel fun-asr 主模型失败后回退;空字符串表示不回退
asr.language en 语言提示(如 zh)
asr.maxJobMinutes 30 单个转写任务的最长运行时间
asr.pollIntervalSeconds 2 bl speech recognize 的轮询间隔
asr.mergeGapMs 4000 同说话人相邻短句的自动合并阈值
asr.toolTimeoutMinutes 32 english_transcribe 工具的整体超时,必须大于 maxJobMinutes
lookup.backend ds ds(DSH 当前模型,快、不占百炼文本额度)/ bl(bl text chat)/ off
lookup.provider / lookup.model null 覆盖查词使用的模型;null 表示跟随 DSH 当前默认模型
lookup.timeoutMs 20000 单次查词超时(毫秒)
import.maxPdfPages 120 PDF 导入最多渲染的页数
import.dpi 100 PDF 页面渲染分辨率
dirs.recordings / dirs.transcripts recordings / transcripts 工作区内的相对目录
recall.newPerDay 10 每天引入的新词上限;0 表示只复习到期词
recall.dailyLimit 30 每天一轮的总题量上限
recall.mode mix 首次打开的练习方式:mix(混合)/ en-zh(英→中)/ zh-en(中→英);面板里切换后记在浏览器本地
analysis.enabled true 是否运行后台自动多义分析;false 只停后台,面板「分析多义」与 action=analyze 仍可用
analysis.idleMinutes 3 工作区多久没有插件请求后开始后台批次(0.5–120)
analysis.batchWords 2 每批最多分析几个词(1–20);批间 20s
analysis.maxContexts / analysis.maxContextChars 6 / 240 每个词送给模型的上下文条数 / 单条最大长度
analysis.timeoutMs 30000 单次多义分析模型调用超时(5000–120000)
analysis.retryMinutes 10 分析失败后多久重试(1–1440)

可执行路径不进配置文件。 config.json 在工作区里、可被写工作区的进程修改,为避免把配置变成执行入口,bl、pdftoppm、pdftotext 只能通过只读环境变量覆盖(值必须是绝对路径或纯命令名,不允许空格、参数或 shell 元字符):

环境变量 默认命令 说明
DSH_ENGLISH_BL bl 百炼 CLI
DSH_ENGLISH_PDFTOPPM pdftoppm PDF 页图渲染(poppler)
DSH_ENGLISH_PDFTOTEXT pdftotext PDF 词坐标文本层(poppler)

旧版的 blPath、import.pdfToPpmPath、import.pdfToTextPath 已移除:出现时会被忽略,并在环境自检的 warnings 里提示改用对应环境变量。未知键一律忽略;非法值回退默认值并给出 warning。Linux / macOS 上 poppler 可用 brew install poppler 或 sudo apt install poppler-utils。

助手工具

  • english_transcribe { audio, speakers?, model?, language? }:转写并等待完成,返回 {ok,jobId,transcript,segments,speakers,durationMs,model,warnings,state,error?}。audio 用当前工作区或共享库的相对路径,或绝对路径;失败时给出可操作信息(bl 缺失/未登录时附安装或登录命令)。
  • english_vocab { action, ... }:action 取 list(默认只列待补全条目)/ lookup / add / update / enrich / analyze / remove / export。
  • list 默认列 pending;update 用于助手自己补全音标/释义/例句翻译;enrich 按 id 重新查询词形与词源;analyze 对比全部文稿补全多义(可传 id 只分析一个词;不带 id 时每次最多分析 analysis.batchWords 个过期词,默认 2 个,按返回的 remaining 继续调用直到 0;返回 {analyzed,updated,added,skipped,failed,remaining,entries});export 重写 vocab/生词本.md。
  • 面板与助手走同一套 Host 实现:面板的动作(文稿列表、转写、查词、生词本等)走插件自建的 POST /dsh-english/api(只接受回环地址,要求 x-english-practice: 1 请求头;浏览器带 Origin 时必须为本地来源),文稿正文、生词本 JSON 与 PDF 页图经插件自己的 transcripts.read / vocab.read / pdf.page 读取(共享库在别的项目时也能读);助手通过上面两个工具调用。

FAQ

转写报错找不到 bl / 提示未登录怎么办?
错误码是 bl/missing 或 bl/not-authenticated。「环境自检」卡(没有文稿时的空状态,或打开「转写录音」面板时可见)会指出具体缺哪一步。手动修复:npm i -g bailian-cli --registry=https://registry.npmmirror.com 安装,bl auth login --console 登录,bl auth status 复查。装完新命令后重启 DSH,让进程拿到新的 PATH。其他常见错误码:pdf/poppler-missing(缺 poppler)、http/rate-limited(操作太频繁)、config/invalid(配置读不了)。

PDF 导入报 pdf/poppler-missing?
安装 poppler:winget install -e --id oschwartz10612.Poppler;已装在非默认目录就设置 DSH_ENGLISH_PDFTOPPM / DSH_ENGLISH_PDFTOTEXT。装完重启 DSH。

Windows 上路径怎么写?
用绝对路径,例如 D:\Podcasts\ep12.m4a。带空格的路径直接粘贴到「扫描」输入框即可,不需要加引号,反斜杠也不用转义。

会花多少钱?
转写调用百炼语音识别,按其价格计费;音频会先上传到百炼临时存储(保留 48h)。新用户可用 bl usage free 查看免费额度,不充值则额度用完后自动停用。默认查词走 DSH 当前模型(ctx.llm),不额外消耗百炼文本额度;只有 lookup.backend = "bl" 时查词才走百炼文本模型。

为什么有的词查词/生词本没有释义?
查词失败时会以「待补全」入库。点卡片上的「补全词形/词源」,或在对话里说「补全生词本」让助手补。

多义分析什么时候跑?会额外花钱吗?
默认在插件空闲约 3 分钟后自动在后台跑,不需要打开面板;也可以在卡片上点「分析多义」或让助手调用 action=analyze 立即跑。它用的是和查词相同的后端(默认 DSH 当前模型,lookup.backend = "bl" 时走百炼文本模型),一次只分析有变化的词,语料没变不会重复调用;也可以在 .dsh-english/config.json 的 analysis 里停掉后台自动分析(enabled: false;手动「分析多义」仍可用)或调整 idleMinutes / batchWords。

插件、数据、隐私?
不收集任何遥测。文稿、生词本、缓存都在你当前工作区(或你主动开启的共享库项目)的普通文件里,可随时备份或搬走。HTTP 接口只监听回环地址、要求自定义请求头;浏览器带 Origin 时必须为本地来源。共享库开关只保存一个绝对路径在 ~/.dsh/english-practice.json,不会上传任何内容。

卸载 / 换源?
桌面版的插件行由 Electron profile 独占:在插件页「移除」再「添加」即可,不要手工改插件 manifest;移除插件不会删你的工作区数据。

仓库结构

路径 说明
index.js 插件入口:name / inject / apply(ctx) 只做组装(约 22 行)
host/ Host 半,16 个模块:analysis / api / asr / config / env / graph / json-store / lookup / paths / pdf / recall / senses / text / tools / transcript / vocab
client.js Client 半,单文件 window.__ModuleLoader__.load bundle(§0–§9 分区)
cordis.patch.yml 插件 bundle patch(insert id english-practice)
locale/{zh,en}.json 插件页展示元数据(标题 / 描述)
icon.svg 插件页图标
assets/bailian-cli/ README 图文(8 张 PNG)
tests/ node --test 单测 + 契约 + 集成测试(14 个 *.test.mjs)
AGENTS.md 维护者契约:架构决策、冻结接口、发布流程
README.md / README.zh.md 英文 / 中文文档
CHANGELOG.md 更新日志(Keep a Changelog)
LICENSE MIT
whalepicks.json 鲸选(whale-picks)商店清单,schemaVersion 1.1
.github/workflows/ci.yml CI:node --check 两个入口 + node --test(Node 22,无需 npm install)

npm 发布内容以 package.json#files 为准:index.js、host/、client.js、cordis.patch.yml、locale/*.json、icon.svg、assets/、README.md、README.zh.md、CHANGELOG.md(package.json 与 LICENSE 由 npm 自动附带;tests/、AGENTS.md、whalepicks.json、.github/ 不随包发布)。

开发备注

  • 零构建:Host 半是 Node ESM(index.js 只做组装 + host/ 下 16 个模块),Client 半是手写的单文件 client.js(window.__ModuleLoader__.load bundle,§0–§9 分区)。没有 TypeScript、没有打包器、没有运行时依赖。
  • 改 Host:DSH 重启后生效(桌面版退出重开;CLI / dsh web 重启进程)。
  • 改 Client:刷新页面即可(bundle 按包解析,内容变化后页面会重新拉取)。
  • 改 package.json 的 dsh 清单或 cordis.patch.yml:需要重启 DSH。
  • 自检:npm run check(node --check index.js + node --check client.js + node --test 自动发现 tests/*.test.mjs),需要 Node 20+;当前 15 个测试文件(单测 + 契约 + 集成)全绿。
  • 本地开发:包名是 dsh-increasing-my-english,桌面 profile 以 link: 安装本目录;改名必须同步 package.json、cordis.patch.yml、client.js 的 PKG 与 loader id、locale meta。
  • 稳定标识(不要改):.dsh-english/、/dsh-english/api、x-english-practice 请求头、工具名 english_transcribe / english_vocab、tab kind english-reader、locale NS englishPractice、patch 行 id english-practice、背记数据文件 .dsh-english/recall.json(version: 1)。

许可证

MIT © 2026 LeeKai233

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
dsh-increasing-my-english 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:LeeKai233/dsh-increasing-my-english` 即可。对应的 npm 包名是 `dsh-increasing-my-english`。

dsh-increasing-my-english 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-increasing-my-english 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-increasing-my-english 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-increasing-my-english 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-increasing-my-english 有哪些功能?

播客音频转写为分角色文稿、右侧边栏沉浸式精读、Ctrl 划词查词与例句、生词本自动收录与导出、环境自检与 PDF 导入。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

视觉与多模态
按星标排序,可作替代方案

open-design

open-design

L4 · 沙盒安装通过 10.0 万 星

awesome-gpt-image-2

awesome-gpt-image-2

GPT Image 2 / 2.5 提示词与案例库,530+ 个案例、20+ 套工业级模板与可复用 Skills,新增 2.5 同提示词对比

L3 · 安装规范通过 3.4 万 星

PicGo

PicGo

L3 · 安装规范通过 2.7 万 星

iPolloWork

iPolloWork

L4 · 沙盒安装通过 6,775 星

modlens

modlens

ModLens 是 DeepSeek Harness 的视觉插件,为纯文本模型外挂视觉能力,粘贴图片即得结构化 JSON 证据(OCR、版面

L5 · 运行验证通过 4,207 星

OpenBiliClaw

OpenBiliClaw

本地私有、开源的自进化跨平台 AI 内容发现 Agent:先理解你,再主动从 B站、小红书、抖音、YouTube、X、知乎、Reddit、微

L4 · 沙盒安装通过 3,398 星

LeeKai233 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-12。