dsh-tingdong 0.3.1 → 0.4.0

package/README.md

@@ -5,7 +5,16 @@
 
 ## 它做什么
 
-1. **导入**：选一个 MP3（或整个文件夹），本机识别出每一句英文和它的起止时间。
+首页有两个入口：**导入音频**（有声书、讲座、引导音频）和**导入文档**（文章、手册、书）。
+
+**导入文档**：把整理好的英文纯文本粘贴进来，或选 .txt / .md 文件。格式很简单——每章一行 `# 章节标题`（每章做成一课），`## 小标题` 也会读出来，段落之间空一行。
+PDF、电子书、网页先交给别的 AI（ChatGPT、DeepSeek、Kimi……）整理：界面上有现成的「整理要求」可以一键复制，连同材料一起发过去。
+在 DSH 对话里更省事：把 PDF 发给 AI，说「按听懂的格式整理后导入听懂」，它会整理好直接导入（AI 工具 `tingdong_import_text`）。
+导入后用 **微软 Edge** 的英文语音朗读（默认 Andrew，14 种美式 / 英式男女声，可调语速；也可选离线的 Kokoro），句与句之间停 0.6 秒、换段 1.2 秒，再逐句翻译讲解。之后和音频课一样学：精听、复习、磨耳朵、连续听、导出中文配音和字幕。
+
+**导入音频**：
+
+1. **识别**：选一个 MP3（或整个文件夹），本机识别出每一句英文和它的起止时间。
    识别用的是 DSH 自带语音输入的同一套模型（SenseVoice + Silero VAD），音频不上传；用过 DSH 语音输入就不用再下载。
 2. **讲解**：用你在 DSH 里选的大模型逐句校对英文（修正识别错误，如 "resna tuning" → "resonant tuning"）、
    翻成口语化中文、挑出生词（带音标）、写一句「听音提示」（哪里连读、弱读、吞音），再写全篇概述和关键术语表。
@@ -46,9 +55,9 @@
 
 电脑快捷键：空格 重听 · 回车 下一步 · 1/2/3 评分 · ←/→ 上一句/下一句 · S 变速（1× / 0.85× / 0.7×）· L 单句循环
 
-在 DSH 对话里也可以直接说：「把 /Volumes/…/CD4 导入听懂」「我这课哪些句子总听不懂？给我讲讲」——插件给 AI 注册了 `tingdong_import`、`tingdong_lessons`、`tingdong_sentences` 三个工具。
+在 DSH 对话里也可以直接说：「把 /Volumes/…/CD4 导入听懂」「把这份 PDF 整理后导入听懂」「我这课哪些句子总听不懂？给我讲讲」——插件给 AI 注册了 `tingdong_import`、`tingdong_import_text`、`tingdong_lessons`、`tingdong_sentences` 四个工具。
 
-**更新 / 卸载**：首页标题旁显示版本号，打开时自动查 npm 上有没有新版本；有就出现「更新到 vX」，点一下由 DSH 的插件管理器装好（和插件市场同一套机制），重启 DSH 生效。「卸载」只移除插件，课程和学习进度留在 `~/.dsh/dsh-tingdong`。
+**更新 / 卸载**：在 DSH 的「设置 → 听懂」里。打开时自动查 npm 上有没有新版本；有就出现「更新到 vX」，点一下由 DSH 的插件管理器装好（和插件市场同一套机制），重启 DSH 生效。「卸载」会先确认，只移除插件，课程和学习进度留在 `~/.dsh/dsh-tingdong`。学习面板首页标题旁显示版本号，有新版本时会提醒。
 
 ## 安装
 
@@ -92,6 +101,7 @@ dsh plugin --profile desktop add /path/to/dsh-go
 ```bash
 node bin/dsh-tingdong.js import "/Volumes/kuozhan/门罗/CD4"     # 整个文件夹，每个音频一课
 node bin/dsh-tingdong.js serve                                   # 打开 http://127.0.0.1:4810
+node bin/dsh-tingdong.js import-doc 手册.md --voice en-US-AndrewNeural   # 导入整理好的英文文档
 node bin/dsh-tingdong.js list
 node bin/dsh-tingdong.js voices all --track kokoro --voice am_michael   # 批量生成声音轨
 ```
@@ -120,7 +130,7 @@ npm test
 - `lib/translate.js` 校对 + 翻译 + 生词 + 听音提示；缺句自动缩小批次重试，失败的留空，之后可「补全翻译」
 - `lib/tracks.js` 声音轨：原声按句截取拼接；朗读交给 `lib/tts-worker.js` 子进程（Kokoro / macOS say），`lib/pcm.js` 统一拼接编码并出时间表
 - `lib/srs.js` 间隔复习；`lib/store.js` 原子写入的 JSON 存储；`lib/today.js` 今日学习（按用户时区算日期）
-- `lib/export.js` 文字导出；`lib/edge.js` Edge 语音组件（edge-tts）的安装和调用
+- `lib/doc.js` 文档：切句、分章、整理要求；`lib/export.js` 文字导出；`lib/edge.js` Edge 语音组件（edge-tts）的安装和调用
 - `lib/drill.js` 磨耳朵音频；`lib/lookup.js` 点词查意思、重新讲解；`lib/vps.js` 经 SSH 发送到 VPS
 - `plugin/` DSH 宿主端（路由、AI 工具）和界面入口（右侧栏、设置）；路由先过 DSH 的 `connection.requestRejection()` 登录校验
 - `web/` 学习面板（原生 JS 模块，无构建）：`panel.js` 路由和首页 · `study.js` 精听、复习、今日学习 · `listen.js` 连续听、磨耳朵、词汇 · `edit.js` 改句子、查词 · `core.js` 播放器和公共状态

package/bin/dsh-tingdong.js

@@ -4,6 +4,7 @@
 //   dsh-tingdong import <文件或文件夹> [--title 标题]   识别 + 翻译，做成课
 //   dsh-tingdong serve [--port 4810]                    在浏览器里打开学习面板
 //   dsh-tingdong list                                   看有哪些课
+//   dsh-tingdong import-doc <整理好的 .txt / .md>        导入英文文档（# 章节 分课），Edge 朗读 + 翻译
 //   dsh-tingdong voices <课程id|all> [--track clean,cleannr,say,kokoro] [--voice 名字] [--speed 0.9]
 //                                                       生成声音轨（去空白原声 / 压背景 / 系统朗读 / Kokoro）
 //
@@ -50,6 +51,32 @@ async function main() {
     return
   }
 
+  if (cmd === 'import-doc') {
+    if (!rest[0]) throw new Error('用法：dsh-tingdong import-doc <整理好的 .txt / .md> [--title 标题] [--voice en-US-AndrewNeural] [--engine edge|kokoro]')
+    const { readFile } = await import('node:fs/promises')
+    const text = await readFile(rest[0], 'utf8')
+    const llm = await cliLlm(flags)
+    console.log(llm ? `翻译模型：${llm.label()}（${llm.via}）` : '没有可用的大模型：只朗读英文')
+    const importer = new Importer({ llm: () => llm, options, log: m => console.error(m) })
+    let last = ''
+    importer.onChange(() => {
+      for (const j of importer.list()) {
+        if (j.state !== 'running') continue
+        const key = `${j.id}|${j.stage}|${j.total ? Math.floor(j.done / j.total * 4) : 0}`
+        if (key !== last) { last = key; console.log(`${j.title}：${j.stage}${j.total ? ` ${j.done}/${j.total}` : ''}`) }
+      }
+    })
+    const r = await importer.importDoc(text, { title: typeof flags.title === 'string' ? flags.title : '', engine: flags.engine === 'kokoro' ? 'kokoro' : 'edge', voice: typeof flags.voice === 'string' ? flags.voice : undefined })
+    console.log(`《${r.title}》分成 ${r.items.length} 课：${r.items.map(x => `${x.title}（${x.sentences || '已有'} 句）`).join('、')}`)
+    await new Promise(resolve => {
+      const check = () => { if (!importer.running && !importer.jobs.some(j => j.state === 'queued')) resolve() }
+      importer.onChange(() => setImmediate(check))
+      check()
+    })
+    for (const j of importer.list()) console.log(`${j.state === 'done' ? '✓' : '✗'} ${j.title}${j.error ? '：' + j.error : ''}`)
+    return
+  }
+
   if (cmd === 'voices') {
     const which = rest[0]
     if (!which) throw new Error('用法：dsh-tingdong voices <课程id|all> [--track clean,cleannr,say,kokoro]')
@@ -132,6 +159,7 @@ async function main() {
   dsh-tingdong import <文件或文件夹> [--title 标题]
   dsh-tingdong serve [--port 4810]
   dsh-tingdong list
+  dsh-tingdong import-doc <整理好的 .txt / .md> [--title 标题] [--voice en-US-AndrewNeural]
   dsh-tingdong voices <课程id|all> [--track clean,cleannr,say,kokoro] [--voice 名字] [--speed 0.9]
 
   模型：--base-url URL --api-key KEY --model ID（或 TINGDONG_BASE_URL / TINGDONG_API_KEY / TINGDONG_MODEL）

package/lib/doc.js

@@ -0,0 +1,132 @@
+// lib/doc.js — 导入英文文档：整理好的纯文本 → 一章一课，每课是一句一句的英文
+//
+// 约定的格式（让别的 AI 先整理好，界面上有现成的整理指令可以复制）：
+//   # 章节标题        一行「# 」开头：新的一章，做成一课
+//   ## 小标题         小标题也读出来，算一句
+//   段落之间空一行；段落内部的换行会被接起来（硬换行、断词的连字符都能处理）
+// 没有任何「# 」时整篇算一章；一章太长（超过 MAX_SENTENCES 句）就按段落拆成几课。
+
+export const MAX_CHARS = 400000
+export const MAX_SENTENCES = 160
+
+// 句点后面不算句子结束的缩写
+const ABBR = new Set(['mr', 'mrs', 'ms', 'dr', 'prof', 'sr', 'jr', 'st', 'vs', 'etc', 'e.g', 'i.e', 'fig', 'no', 'vol', 'p', 'pp', 'ch', 'u.s', 'u.k', 'a.m', 'p.m', 'inc', 'ltd', 'co', 'approx', 'dept', 'est', 'mt', 'jan', 'feb', 'mar', 'apr', 'jun', 'jul', 'aug', 'sep', 'sept', 'oct', 'nov', 'dec'])
+
+/** 文本清理：统一换行、去掉不可见字符、接上断词 */
+export function normalize(text) {
+  return String(text || '')
+    .replace(/\r\n?/g, '\n')
+    .replace(/[­​]/g, '')
+    .replace(/‐|‑/g, '-')
+    .replace(/(\w)-\n(\w)/g, '$1$2') // 行尾断词
+    .replace(/[ \t]+/g, ' ')
+}
+
+/** 一段文字切成句子 */
+export function splitSentences(paragraph) {
+  const p = paragraph.replace(/\s*\n\s*/g, ' ').replace(/\s+/g, ' ').trim()
+  if (!p) return []
+  const out = []
+  let start = 0
+  const re = /([.!?…]+)(["'”’)\]]*)(\s+)(?=["'“‘(\[]?[A-Z0-9])/g
+  let m
+  while ((m = re.exec(p))) {
+    const end = m.index + m[1].length + m[2].length
+    const before = p.slice(start, m.index)
+    const lastWord = (/([A-Za-z.]+)$/.exec(before) || [])[1] || ''
+    // 缩写（Mr. / e.g.）和单个大写字母（A. Monroe）后面的句点不断句
+    if (m[1] === '.' && (ABBR.has(lastWord.toLowerCase().replace(/\.$/, '')) || /^[A-Z]$/.test(lastWord))) continue
+    out.push(p.slice(start, end).trim())
+    start = end + m[3].length
+  }
+  out.push(p.slice(start).trim())
+  return out.filter(Boolean).flatMap(splitLong)
+}
+
+/** 太长的句子听起来累：超过 220 个字符的，在分号、冒号、破折号处拆开 */
+function splitLong(s) {
+  if (s.length <= 220) return [s]
+  const parts = s.split(/(?<=[;:])\s+|\s+[—–]\s+|(?<=—)/).map(x => x.trim()).filter(Boolean)
+  if (parts.length < 2) return [s]
+  // 拆得太碎的再并回去
+  const merged = []
+  for (const x of parts) {
+    const last = merged[merged.length - 1]
+    if (last && (last.length < 60 || x.length < 40)) merged[merged.length - 1] = `${last} ${x}`
+    else merged.push(x)
+  }
+  return merged
+}
+
+/**
+ * @returns {{title:string, chapters:{title:string, sentences:{text:string, heading?:boolean, para:number}[]}[]}}
+ */
+export function parseDoc(text, { title = '' } = {}) {
+  const src = normalize(text)
+  if (!src.trim()) throw Object.assign(new Error('没有内容'), { status: 400 })
+  if (src.length > MAX_CHARS) throw Object.assign(new Error(`太长了（${src.length} 字符）：一次最多 ${MAX_CHARS} 字符，拆成几份导入`), { status: 400 })
+  if (/[一-鿿]/.test(src) && (src.match(/[一-鿿]/g) || []).length > src.length * 0.2) {
+    throw Object.assign(new Error('看起来大部分是中文：这里导入英文原文，中文由 AI 翻译'), { status: 400 })
+  }
+  const chapters = []
+  let cur = null
+  let para = 0
+  const newChapter = t => { cur = { title: t, sentences: [] }; chapters.push(cur) }
+  for (const block of src.split(/\n\s*\n/)) {
+    const lines = block.split('\n')
+    let buf = []
+    const flush = () => {
+      if (!buf.length) return
+      if (!cur) newChapter('')
+      para++
+      for (const s of splitSentences(buf.join('\n'))) cur.sentences.push({ text: s, para })
+      buf = []
+    }
+    for (const raw of lines) {
+      const line = raw.trim()
+      const h1 = /^#\s+(.+)$/.exec(line)
+      const h2 = /^#{2,6}\s+(.+)$/.exec(line)
+      if (h1) { flush(); newChapter(h1[1].trim()); continue }
+      if (h2) {
+        flush()
+        if (!cur) newChapter('')
+        para++
+        cur.sentences.push({ text: h2[1].trim().replace(/[*_`]/g, ''), heading: true, para })
+        continue
+      }
+      // Markdown 的列表符号、强调符号不读
+      buf.push(line.replace(/^[-*+]\s+|^\d+[.)]\s+/, '').replace(/[*_`]+/g, ''))
+    }
+    flush()
+  }
+  const docTitle = title.trim() || (chapters[0] && chapters[0].title) || firstWords(chapters)
+  // 去掉空章；没标题的章用文档标题；太长的章按段落拆开
+  const out = []
+  for (const [k, c] of chapters.filter(c => c.sentences.length).entries()) {
+    const t = c.title || (chapters.length > 1 ? `${docTitle} · 第 ${k + 1} 部分` : docTitle)
+    if (c.sentences.length <= MAX_SENTENCES) { out.push({ title: t, sentences: c.sentences }); continue }
+    let part = []
+    let n = 1
+    for (const [j, s] of c.sentences.entries()) {
+      part.push(s)
+      const paraEnds = !c.sentences[j + 1] || c.sentences[j + 1].para !== s.para
+      if (part.length >= MAX_SENTENCES * 0.8 && paraEnds) { out.push({ title: `${t}（${n++}）`, sentences: part }); part = [] }
+    }
+    if (part.length) out.push({ title: n > 1 ? `${t}（${n}）` : t, sentences: part })
+  }
+  if (!out.length) throw Object.assign(new Error('没找到英文句子'), { status: 400 })
+  return { title: docTitle, chapters: out }
+}
+
+function firstWords(chapters) {
+  const s = chapters[0] && chapters[0].sentences[0]
+  return s ? s.text.split(/\s+/).slice(0, 6).join(' ') : '英文文档'
+}
+
+/** 给别的 AI 的整理指令：用户复制过去，连同 PDF / 网页 / 电子书一起发给它 */
+export const PREP_PROMPT = `请把我发给你的英文材料整理成纯文本，用来导入英语听力学习软件。要求：
+1. 只保留正文英文，删掉页眉、页脚、页码、目录、脚注编号、图片说明、网址和联系方式。
+2. 修好因为换行断开的单词（比如 "resonant-" 换行接 "tuning"），段落内部不要硬换行；每个段落一行，段落之间空一行。
+3. 每一章单独起一行「# 章节标题」。原文没有章节的，按内容大约每 800–1500 个英文单词分一章，自己起个简短的英文标题。章里的小标题用「## 小标题」。
+4. 不要翻译、不要改写、不要总结，原文一个字都不要改；也不要加任何说明。
+5. 直接输出整理好的文本（Markdown 纯文本），我会保存成 .txt 或 .md 文件导入。`

package/lib/edge.js

@@ -29,6 +29,25 @@ export const EDGE_ZH_VOICES = [
 ]
 export const edgeVoice = id => EDGE_ZH_VOICES.find(v => v.id === id) || EDGE_ZH_VOICES[0]
 
+/** 英文（导入文档时朗读用；默认 Andrew） */
+export const EDGE_EN_VOICES = [
+  { id: 'en-US-AndrewNeural', label: 'Andrew（美式男声 · 温和）', gender: 'm' },
+  { id: 'en-US-BrianNeural', label: 'Brian（美式男声 · 随和）', gender: 'm' },
+  { id: 'en-US-ChristopherNeural', label: 'Christopher（美式男声 · 沉稳）', gender: 'm' },
+  { id: 'en-US-GuyNeural', label: 'Guy（美式男声）', gender: 'm' },
+  { id: 'en-US-EricNeural', label: 'Eric（美式男声）', gender: 'm' },
+  { id: 'en-GB-RyanNeural', label: 'Ryan（英式男声）', gender: 'm' },
+  { id: 'en-GB-ThomasNeural', label: 'Thomas（英式男声）', gender: 'm' },
+  { id: 'en-US-AvaNeural', label: 'Ava（美式女声 · 亲切）', gender: 'f' },
+  { id: 'en-US-EmmaNeural', label: 'Emma（美式女声 · 清晰）', gender: 'f' },
+  { id: 'en-US-JennyNeural', label: 'Jenny（美式女声）', gender: 'f' },
+  { id: 'en-US-AriaNeural', label: 'Aria（美式女声 · 播音）', gender: 'f' },
+  { id: 'en-US-MichelleNeural', label: 'Michelle（美式女声）', gender: 'f' },
+  { id: 'en-GB-SoniaNeural', label: 'Sonia（英式女声）', gender: 'f' },
+  { id: 'en-GB-LibbyNeural', label: 'Libby（英式女声）', gender: 'f' },
+]
+export const edgeEnVoice = id => EDGE_EN_VOICES.find(v => v.id === id) || EDGE_EN_VOICES[0]
+
 export const edgeDir = () => join(dataRoot(), 'edge-tts')
 const win = process.platform === 'win32'
 const venvBin = name => join(edgeDir(), win ? 'Scripts' : 'bin', win ? `${name}.exe` : name)

package/lib/importer.js

@@ -10,7 +10,9 @@ import { compactAudio, mergeSegments, transcribe } from './asr.js'
 import { ensureModels } from './models.js'
 import { audioPath, getLesson, makeId, saveLesson, titleFromFile } from './store.js'
 import { summarizeLesson, translateSentences } from './translate.js'
-import { buildTrack, TRACKS } from './tracks.js'
+import { buildDocAudio, buildTrack, TRACKS } from './tracks.js'
+import { parseDoc } from './doc.js'
+import { createHash } from 'node:crypto'
 import { getVpsConfig, sendLesson } from './vps.js'
 
 export const AUDIO_EXT = ['.mp3', '.m4a', '.aac', '.wav', '.flac', '.ogg', '.opus', '.wma', '.m4b', '.mp4', '.webm']
@@ -106,12 +108,42 @@ export class Importer {
     return out
   }
 
+  /**
+   * 导入英文文档：一章一课；每课排一个任务：朗读 → 翻译讲解 → 概述
+   * @param {string} text 整理好的纯文本（# 章节标题 分章）
+   * @param {{title?:string, engine?:'edge'|'kokoro', voice?:string, speed?:number}} o
+   */
+  async importDoc(text, o = {}) {
+    const doc = parseDoc(text, { title: o.title || '' })
+    const hash = createHash('sha1').update(text).digest('hex').slice(0, 6)
+    const slug = t => String(t).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'doc'
+    const out = []
+    for (const [k, c] of doc.chapters.entries()) {
+      const id = `${slug(c.title)}-${hash}${doc.chapters.length > 1 ? `-${k + 1}` : ''}`.replace(/^-+/, '')
+      const existing = await getLesson(id)
+      if (existing && existing.status === 'ready') { out.push({ lessonId: id, existed: true, title: existing.title }); continue }
+      const lesson = existing || {
+        id, version: 1, kind: 'doc',
+        title: c.title, group: doc.chapters.length > 1 ? doc.title : (o.group || '文档'), order: k,
+        source: { type: 'doc', name: doc.title, chars: text.length },
+        status: 'queued', createdAt: Date.now(),
+        sentences: c.sentences.map((s, i) => ({ i, start: 0, end: 0, text: s.text, en: s.text, zh: '', words: [], sound: '', skip: false, para: s.para, ...(s.heading ? { heading: true } : {}) })),
+      }
+      if (!existing) await saveLesson(lesson)
+      this.enqueue({ kind: 'doc', lessonId: id, title: lesson.title, engine: o.engine, voice: o.voice, speed: o.speed })
+      out.push({ lessonId: id, existed: false, title: lesson.title, sentences: lesson.sentences.length })
+    }
+    return { title: doc.title, items: out }
+  }
+
   /** 补全翻译（缺翻译的句子、缺概述） */
   async resume(lessonId) {
     const l = await getLesson(lessonId)
     if (!l) throw Object.assign(new Error('没有这节课'), { status: 404 })
     if (this.jobs.some(j => j.lessonId === lessonId && (j.state === 'queued' || j.state === 'running'))) return
-    if (!l.sentences || !l.sentences.length) {
+    if (l.kind === 'doc' && !existsSync(audioPath(lessonId))) {
+      this.enqueue({ kind: 'doc', lessonId, title: l.title, engine: l.engine, voice: l.voice, speed: l.speed })
+    } else if (!l.sentences || !l.sentences.length) {
       const file = l.source && l.source.file
       if (!file || !existsSync(file)) throw Object.assign(new Error('原音频文件不在了，删掉这节课重新导入'), { status: 400 })
       this.enqueue({ kind: 'import', lessonId, title: l.title, file })
@@ -207,6 +239,24 @@ export class Importer {
   async run(job) {
     const signal = job.abort.signal
     const opt = this.opts()
+    if (job.kind === 'doc') {
+      if (!existsSync(audioPath(job.lessonId))) {
+        const l = await getLesson(job.lessonId)
+        l.status = 'transcribing'; l.error = ''
+        await saveLesson(l)
+        const r = await buildDocAudio(l, {
+          ffmpeg: opt.ffmpeg, engine: job.engine, voice: job.voice, speed: job.speed, signal,
+          onStage: (stage, done, total, unit) => this.stage(job, stage, done, total, unit),
+        })
+        const fresh = await getLesson(job.lessonId)
+        for (const s of fresh.sentences) { const t = r.items[s.i]; if (t) { s.start = t[0]; s.end = t[1] } }
+        Object.assign(fresh, { duration: r.duration, engine: r.engine, voice: r.voice, voiceLabel: r.voiceLabel, speed: r.speed, status: 'translating' })
+        await saveLesson(fresh)
+      }
+      await this.translate(job, await getLesson(job.lessonId), signal)
+      return
+    }
+
     if (job.kind === 'send') {
       const cfg = await getVpsConfig()
       for (const [k, id] of job.ids.entries()) {
@@ -298,7 +348,7 @@ export class Importer {
     const total = l.sentences.filter(s => !s.zh && !s.skip).length
     this.stage(job, '翻译讲解', 0, total, '句')
     const res = await translateSentences(llm, l.sentences, {
-      hint, signal, concurrency: this.opts().concurrency || 3,
+      hint, signal, concurrency: this.opts().concurrency || 3, doc: l.kind === 'doc',
       onProgress: (d, t) => this.stage(job, '翻译讲解', d, t, '句'),
       onBatch: () => (signal.aborted ? null : saveLesson(l)),
     })
@@ -321,4 +371,3 @@ export class Importer {
     await saveLesson(l)
   }
 }
-

package/lib/server.js

@@ -8,6 +8,8 @@
 //   GET  <prefix>/voices                         能用的朗读声音（系统语音、Kokoro）
 //   GET  <prefix>/jobs                           导入任务
 //   POST <prefix>/import   {path, title?}        导入本机的文件或文件夹
+//   POST <prefix>/import-doc {text, title?, engine?, voice?, speed?}   导入整理好的英文文档（# 章节 分课），AI 朗读
+//   GET  <prefix>/doc-help                       导入文档的格式要求、给别的 AI 的整理指令
 //   POST <prefix>/upload?name=                   上传音频（请求体就是文件）
 //   POST <prefix>/grade    {id, i, g}            给一句评分（0 没懂 / 1 半懂 / 2 懂了）
 //   POST <prefix>/resume | retranslate | reset | delete  {id}
@@ -39,7 +41,8 @@ import { buildDrill, DRILL_RE } from './drill.js'
 import { explainSentences, lookupWord } from './lookup.js'
 import { today } from './today.js'
 import { exportText, FORMATS } from './export.js'
-import { EDGE_ZH_VOICES, edgeStatus, installEdge } from './edge.js'
+import { EDGE_EN_VOICES, EDGE_ZH_VOICES, edgeStatus, installEdge } from './edge.js'
+import { MAX_CHARS, PREP_PROMPT } from './doc.js'
 import { detect, getVpsConfig, panelUrl, saveVpsConfig, sshHosts } from './vps.js'
 import { KOKORO_VOICES, kokoroReady, kokoroZhReady, SAY_HINT, sayVoices, ZH_VOICES } from './voices.js'
 import { checkId, deleteLesson, editSentence, getLesson, getProgress, gradeSentence, listLessons, mergeWithNext, resetProgress, setProgressFields, setStar, splitSentence, summary } from './store.js'
@@ -161,7 +164,7 @@ export function createHandler(o) {
             say: await sayVoices(), sayHint: SAY_HINT,
             kokoro: { ready: await kokoroReady(), voices: KOKORO_VOICES },
             zh: { ready: await kokoroZhReady(), voices: ZH_VOICES.map(({ id, label, gender }) => ({ id, label, gender })) },
-            edge: { ...(await edgeStatus()), voices: EDGE_ZH_VOICES },
+            edge: { ...(await edgeStatus()), voices: EDGE_ZH_VOICES, en: EDGE_EN_VOICES },
           })
         }
         if (path === '/export') {
@@ -180,6 +183,7 @@ export function createHandler(o) {
           return res.end(out.text)
         }
         if (path === '/formats') return send(res, 200, { formats: FORMATS })
+        if (path === '/doc-help') return send(res, 200, { prompt: PREP_PROMPT, maxChars: MAX_CHARS })
         if (path === '/update') {
           if (!o.manage) return send(res, 200, { managed: false })
           return send(res, 200, { managed: true, ...(await o.manage.info(q.get('force') === '1')) })
@@ -213,7 +217,19 @@ export function createHandler(o) {
         return send(res, 200, { ok: true, items })
       }
 
-      const body = await readJson(req)
+      // 导入文档的请求体是整篇文字，放宽到 2 MB；其余都是小参数
+      const body = await readJson(req, path === '/import-doc' ? 2 * 1024 * 1024 : 64 * 1024)
+      if (path === '/import-doc') {
+        if (typeof body.text !== 'string' || !body.text.trim()) return send(res, 400, { error: '没有文字：粘贴进来，或选一个 .txt / .md 文件' })
+        const speed = Number(body.speed)
+        const r = await o.importer.importDoc(body.text, {
+          title: typeof body.title === 'string' ? body.title.slice(0, 120) : '',
+          engine: body.engine === 'kokoro' ? 'kokoro' : 'edge',
+          voice: typeof body.voice === 'string' ? body.voice.slice(0, 60) : undefined,
+          speed: Number.isFinite(speed) && speed >= 0.6 && speed <= 1.4 ? speed : 1,
+        })
+        return send(res, 200, { ok: true, ...r })
+      }
       if (path === '/import') {
         if (typeof body.path !== 'string' || !body.path.trim()) return send(res, 400, { error: '请填音频文件或文件夹的路径' })
         const items = await o.importer.importPath(body.path, { title: typeof body.title === 'string' ? body.title.trim() : '' })

package/lib/store.js

@@ -215,6 +215,8 @@ export function summary(l, p) {
   const translated = (l.sentences || []).filter(s => s.zh || s.skip).length
   return {
     id: l.id,
+    kind: l.kind || 'audio',
+    voiceLabel: l.voiceLabel || '',
     title: l.title,
     titleZh: l.titleZh || '',
     group: l.group || '',

package/lib/tracks.js

@@ -17,7 +17,7 @@ import { fileURLToPath } from 'node:url'
 import { createEncoder, RATE } from './pcm.js'
 import { dataRoot, findFfmpeg, FFMPEG_HINT, lessonDir } from './paths.js'
 import { ensureKokoro, ensureKokoroZh, sayVoices, zhVoice } from './voices.js'
-import { edgeBin, edgeVoice } from './edge.js'
+import { edgeBin, edgeEnVoice, edgeVoice } from './edge.js'
 
 const WORKER = fileURLToPath(new URL('./tts-worker.js', import.meta.url))
 
@@ -218,6 +218,43 @@ async function buildZh(lesson, o) {
   return { flac: true, items: res.items, duration: res.duration, engine, voice: voice.id, voiceLabel: `${engine === 'edge' ? 'Edge ' : ''}${voice.label}`, speed: args.speed, align, squeezed: res.squeezed || 0 }
 }
 
+/**
+ * 文档课：把整课英文念成这一课的主音频（audio.mp3，相当于音频课的「原声」），并得出每句的时间
+ * engine：'edge'（默认，微软在线语音）或 'kokoro'（离线）
+ * @returns {Promise<{items, duration, engine, voice, voiceLabel, speed}>}
+ */
+export async function buildDocAudio(lesson, o = {}) {
+  const ffmpeg = findFfmpeg(o.ffmpeg)
+  if (!ffmpeg) throw new Error(FFMPEG_HINT)
+  const engine = o.engine === 'kokoro' ? 'kokoro' : 'edge'
+  let voice
+  let voiceLabel
+  let kokoroDir
+  if (engine === 'edge') {
+    if (!edgeBin()) throw Object.assign(new Error('还没装 Edge 语音组件：在导入文档的地方点「安装 Edge 语音组件」，或者改用 Kokoro'), { status: 400 })
+    const v = edgeEnVoice(o.voice)
+    voice = v.id
+    voiceLabel = `Edge ${v.label.replace(/（.*）/, '')}`
+  } else {
+    kokoroDir = await ensureKokoro({ signal: o.signal, onProgress: (g, t) => o.onStage && o.onStage('下载 Kokoro 语音模型', Math.round(g / 1048576), Math.round(t / 1048576), 'MB') })
+    voice = o.voice && !/^en-/.test(o.voice) ? o.voice : 'am_michael'
+    voiceLabel = `Kokoro ${voice}`
+  }
+  // 停顿：句与句之间 0.6 秒，换段 1.2 秒，小标题后 1 秒
+  const list = lesson.sentences
+  const sentences = list.map((s, k) => {
+    const prev = list[k - 1]
+    const pause = !prev ? 0 : prev.heading ? 1 : prev.para !== s.para ? 1.2 : 0.6
+    return { i: s.i, text: s.en || s.text, pause }
+  })
+  await mkdir(lessonDir(lesson.id), { recursive: true })
+  const out = join(lessonDir(lesson.id), 'audio.part.mp3')
+  const args = { engine: engine === 'edge' ? 'edge-en' : 'kokoro', mode: 'reading', voice, speed: o.speed || 1, sentences, kokoroDir, ffmpeg, out, threads: o.threads || 2, bitrate: '64k' }
+  const res = await runWorker(args, o, `朗读（${voiceLabel}）`)
+  await rename(out, trackAudio(lesson.id, 'full'))
+  return { items: res.items, duration: res.duration, engine, voice, voiceLabel, speed: args.speed }
+}
+
 /** 试听一个中文音色：同一句话，生成一次缓存起来 */
 const ZH_SAMPLE = '现在进入你的准备流程。首先，用你的能量转换盒，接着做共振调音。'
 export async function zhSample(voiceId, o = {}) {

package/lib/translate.js

@@ -48,9 +48,10 @@ export function cleanItem(raw) {
   }
 }
 
-function batchPrompt(context, items, hint) {
+function batchPrompt(context, items, hint, doc) {
   const lines = []
   if (hint) lines.push(`材料：${hint}`)
+  if (doc) lines.push('注意：这是书面文档（会用 AI 朗读给学生听），英文是准确的原文，不是语音识别：en 照抄原句，不要改；skip 一律 false。')
   if (context.length) {
     lines.push('前文（仅供参考，不用输出）：')
     for (const c of context) lines.push(`- ${c}`)
@@ -61,8 +62,8 @@ function batchPrompt(context, items, hint) {
 }
 
 /** 跑一批；返回 Map<i, item>（可能缺一些） */
-async function runBatch(llm, items, context, hint, signal) {
-  const text = await llm.complete({ system: SYSTEM, user: batchPrompt(context, items, hint), maxTokens: 16000, signal })
+async function runBatch(llm, items, context, hint, signal, doc) {
+  const text = await llm.complete({ system: SYSTEM, user: batchPrompt(context, items, hint, doc), maxTokens: 16000, signal })
   const json = extractJson(text)
   const got = new Map()
   for (const raw of Array.isArray(json.items) ? json.items : []) {
@@ -97,12 +98,13 @@ export async function translateSentences(llm, sentences, opt = {}) {
   const batches = []
   for (let k = 0; k < todo.length; k += size) batches.push(todo.slice(k, k + size))
 
+  // 文档课：英文是准确的书面原文，不让模型改；也没有「非讲话」
   const apply = (s, item) => {
-    s.en = item.en || s.text
+    s.en = opt.doc ? s.text : (item.en || s.text)
     s.zh = item.zh
     s.words = item.words
     s.sound = item.sound
-    s.skip = item.skip
+    s.skip = opt.doc ? false : item.skip
   }
   const contextFor = first => {
     const idx = sentences.indexOf(first)
@@ -118,7 +120,7 @@ export async function translateSentences(llm, sentences, opt = {}) {
       for (const part of parts) {
         if (opt.signal && opt.signal.aborted) throw new Error('已取消')
         try {
-          const got = await runBatch(llm, part, contextFor(part[0]), opt.hint, opt.signal)
+          const got = await runBatch(llm, part, contextFor(part[0]), opt.hint, opt.signal, opt.doc)
           for (const s of part) {
             const item = got.get(s.i)
             if (item && (item.zh || item.skip)) { apply(s, item); done++ } else still.push(s)

package/lib/tts-worker.js

@@ -152,10 +152,35 @@ async function timeline(opt, speak) {
   emit({ type: 'done', ...res, squeezed })
 }
 
+/**
+ * 文档朗读：一句接一句，停顿由每句的 pause（这句之前停几秒）决定——
+ * 句与句之间短、段落之间长，小标题后面也停一下，听起来像人在念书
+ */
+async function reading(opt, speak) {
+  const enc = createEncoder({ ffmpeg: opt.ffmpeg, out: opt.out, gap: 0, bitrate: opt.bitrate })
+  const list = (opt.sentences || []).map(s => ({ ...s, text: tidy(s.text) })).filter(s => s.text)
+  const AHEAD = opt.engine === 'edge-en' ? 4 : 1
+  const pending = []
+  let next = 0
+  const fill = () => { while (next < list.length && pending.length < AHEAD) { const p = speak(list[next++].text); p.catch(() => {}); pending.push(p) } }
+  fill()
+  for (const [k, s] of list.entries()) {
+    const pcm = await pending.shift()
+    fill()
+    if (k) await enc.pad(s.pause ?? 0.6)
+    await enc.write(s.i, pcm)
+    emit({ type: 'progress', done: k + 1, total: list.length })
+  }
+  const res = await enc.finish()
+  emit({ type: 'done', ...res })
+}
+
 async function main() {
   const opt = JSON.parse(process.argv[2] || '{}')
   if (opt.engine === 'kokoro-zh') return timeline(opt, kokoroZhEngine(opt))
   if (opt.engine === 'edge-zh') return timeline(opt, edgeEngine(opt))
+  if (opt.engine === 'edge-en') return reading(opt, edgeEngine(opt))
+  if (opt.mode === 'reading') return reading(opt, kokoroEngine(opt))
   const speak = opt.engine === 'kokoro' ? kokoroEngine(opt) : sayEngine(opt)
   const enc = createEncoder({ ffmpeg: opt.ffmpeg, out: opt.out, gap: opt.gap ?? 0.7 })
   const list = (opt.sentences || []).map(s => ({ i: s.i, text: tidy(s.text) })).filter(s => s.text)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-tingdong",
-  "version": "0.3.1",
-  "description": "听懂：把英文有声读物 MP3 变成听力课。本地识别每一句英文、AI 翻译讲解，再用盲听、精听、间隔复习把它练到「一听就懂」。DeepSeek Harness (dsh) 插件。",
+  "version": "0.4.0",
+  "description": "听懂：把英文有声读物（MP3）或英文文档变成听力课。本地识别 / AI 朗读每一句英文、AI 翻译讲解，再用盲听、精听、间隔复习把它练到「一听就懂」。DeepSeek Harness (dsh) 插件。",
   "keywords": [
     "dsh-plugin",
     "dsh-plugins",

package/plugin/client.js

@@ -3,7 +3,7 @@
 //
 // 手写单文件 bundle，没有构建链：由 dsh web 客户端的 ModuleLoader 注入（写法照 dsh-pick）。挂两处：
 //   - 对话页右侧栏的一个页签：整个学习面板（iframe 指向宿主路由 /api-dsh-tingdong/panel）
-//   - 「设置 → 听懂」：状态（ffmpeg、识别模型、翻译模型）和用法
+//   - 「设置 → 听懂」：版本、更新、卸载，状态（ffmpeg、识别模型、翻译模型）和用法
 // 面板本身是独立调好的页面（dsh-tingdong serve 也能直接打开），这里原样复用。
 // 硬约束：界面崩了不能影响 dsh，注册一律包在 try/catch 里。
 
@@ -25,18 +25,115 @@ window.__ModuleLoader__.load({
       border: 'var(--dsw-alias-border-l3, rgba(127,127,127,.25))',
       good: '#1f9d55',
       warn: '#c98a12',
+      accent: 'var(--dsw-alias-link, #2f6bff)',
+      danger: '#c94040',
     }
 
-    function Btn({ onClick, children }) {
+    function Btn({ onClick, disabled, primary, danger, title, children }) {
       return h('button', {
-        type: 'button', onClick,
+        type: 'button', onClick, disabled, title,
         style: {
           appearance: 'none', fontFamily: 'inherit', fontSize: 12, lineHeight: '18px', padding: '2px 10px',
-          borderRadius: 6, cursor: 'pointer', border: '1px solid ' + C.border, background: 'transparent', color: C.text,
+          borderRadius: 6, cursor: disabled ? 'default' : 'pointer', opacity: disabled ? 0.6 : 1, whiteSpace: 'nowrap',
+          border: '1px solid ' + (danger ? C.danger : primary ? C.accent : C.border),
+          background: primary ? C.accent : 'transparent',
+          color: primary ? '#fff' : danger ? C.danger : C.text,
         },
       }, children)
     }
 
+    async function api(path, method = 'GET') {
+      const r = await fetch('/api-dsh-tingdong/' + path, {
+        method, credentials: 'same-origin',
+        headers: method === 'POST' ? { 'content-type': 'application/json', 'x-tingdong': '1' } : undefined,
+        body: method === 'POST' ? '{}' : undefined,
+      })
+      return r.json()
+    }
+
+    /** 给用户自己在终端执行的命令：等宽显示，旁边一个「复制」 */
+    function CommandLine({ command }) {
+      const [copied, setCopied] = useState(false)
+      const copy = async () => {
+        try { await navigator.clipboard.writeText(command) } catch {
+          const ta = document.createElement('textarea')
+          ta.value = command
+          ta.style.position = 'fixed'
+          ta.style.opacity = '0'
+          document.body.appendChild(ta)
+          ta.select()
+          try { document.execCommand('copy') } catch { /* 实在不行用户还能手动选 */ }
+          ta.remove()
+        }
+        setCopied(true)
+        setTimeout(() => setCopied(false), 2000)
+      }
+      return h('div', { style: { display: 'flex', alignItems: 'center', gap: 6, marginTop: 6, flexWrap: 'wrap' } },
+        h('code', { style: { flex: '1 1 auto', minWidth: 0, padding: '4px 8px', borderRadius: 6, fontSize: 12, color: C.text, border: '1px solid ' + C.border, userSelect: 'all', overflowWrap: 'anywhere' } }, command),
+        h(Btn, { onClick: copy }, copied ? '已复制' : '复制'))
+    }
+
+    /**
+     * 标题行：听懂 · 版本号 · 更新 ……（最右）卸载
+     * 打开设置页时自动去 npm 查新版本；更新、卸载交给 DSH 的插件管理器（宿主路由 /update、/uninstall）
+     */
+    function HeaderBar() {
+      const [info, setInfo] = useState(null)
+      const [phase, setPhase] = useState('checking') // checking | idle | updating | updated | removing | removed
+      const [confirm, setConfirm] = useState(false)
+      const [msg, setMsg] = useState(null) // { text, command?, ok? }
+      const check = (force) => {
+        setPhase('checking')
+        api('update' + (force ? '?force=1' : '')).then(j => { setInfo(j); setPhase('idle') }).catch(() => setPhase('idle'))
+      }
+      useEffect(() => { check(false) }, [])
+      const update = async () => {
+        setPhase('updating'); setMsg(null)
+        try {
+          const j = await api('update', 'POST')
+          setMsg({ text: j.message, command: j.command, ok: j.ok })
+          if (j.ok) { setPhase('updated'); return }
+        } catch (e) { setMsg({ text: '更新请求失败：' + e.message }) }
+        setPhase('idle')
+      }
+      const uninstall = async () => {
+        setConfirm(false); setPhase('removing'); setMsg(null)
+        try {
+          const j = await api('uninstall', 'POST')
+          setMsg({ text: j.message, command: j.command, ok: j.ok })
+          setPhase(j.ok ? 'removed' : 'idle')
+        } catch {
+          // 卸下插件时它自己的接口也随之消失，请求多半就是这么断的
+          setPhase('removed')
+        }
+      }
+      let upd
+      if (phase === 'updating') upd = { label: '正在更新…', disabled: true }
+      else if (phase === 'updated') upd = { label: '已更新，重启 DSH 生效', disabled: true }
+      else if (info && info.restartPending) upd = { label: `v${info.restartPending} 已装好，重启 DSH 生效`, disabled: true }
+      else if (info && info.available) upd = { label: `更新到 v${info.latest}`, primary: true, onClick: update }
+      else if (phase === 'checking') upd = { label: '检查更新…', disabled: true }
+      else upd = { label: info && info.latest ? '已是最新' : '检查更新', onClick: () => check(true), title: '点一下重新检查' }
+      const busy = phase === 'updating' || phase === 'removing' || phase === 'removed'
+      const managed = !info || info.managed !== false
+      return h('div', { style: { marginBottom: 8 } },
+        h('div', { style: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' } },
+          h('span', { style: { fontSize: 15, fontWeight: 650 } }, '听懂'),
+          info && info.running ? h('span', { style: { fontSize: 12, color: C.sub, fontVariantNumeric: 'tabular-nums' } }, 'v' + info.running) : null,
+          managed ? h(Btn, { onClick: upd.onClick, disabled: upd.disabled || busy, primary: upd.primary, title: upd.title }, upd.label) : null,
+          h('span', { style: { flex: 1 } }),
+          !managed ? null
+            : phase === 'removed' ? h('span', { style: { fontSize: 12, color: C.sub } }, '已卸载，重启 DSH 后彻底移除')
+            : phase === 'removing' ? h('span', { style: { fontSize: 12, color: C.sub } }, '正在卸载…')
+            : confirm ? h('span', { style: { display: 'inline-flex', gap: 6, alignItems: 'center' } },
+                h('span', { style: { fontSize: 12, color: C.sub } }, '确定卸载？课程和进度会保留'),
+                h(Btn, { danger: true, onClick: uninstall }, '确认卸载'),
+                h(Btn, { onClick: () => setConfirm(false) }, '取消'))
+            : h(Btn, { danger: true, disabled: busy, onClick: () => setConfirm(true) }, '卸载')),
+        msg ? h('div', { style: { fontSize: 12, color: msg.ok ? C.sub : C.danger, marginTop: 6, lineHeight: 1.6 } },
+          msg.text, msg.command ? h(CommandLine, { command: msg.command }) : null) : null)
+    }
+
     /** 右侧栏：占满栏高的 iframe */
     function Panel() {
       return h('div', { style: { height: '100%', display: 'flex', flexDirection: 'column', boxSizing: 'border-box' } },
@@ -68,9 +165,7 @@ window.__ModuleLoader__.load({
         catch { setMsg('先回到一个对话，再从右侧栏打开') }
       }
       return h('div', { style: { color: C.text } },
-        h('div', { style: { display: 'flex', alignItems: 'center', gap: 8 } },
-          h('span', { style: { fontSize: 15, fontWeight: 650 } }, '听懂'),
-          st && st.version ? h('span', { style: { fontSize: 12, color: C.sub } }, 'v' + st.version) : null),
+        h(HeaderBar),
         h('div', { style: { fontSize: 12.5, color: C.sub, lineHeight: 1.7, marginTop: 6 } },
           '把英文有声读物（MP3）变成听力课：本机识别每一句英文，AI 翻译讲解，再用盲听、精听、间隔复习练到一听就懂。'),
         h('div', { style: { marginTop: 14 } },

package/plugin/tools.js

@@ -7,6 +7,8 @@
 
 import { isMastered } from '../lib/srs.js'
 import { checkId, getLesson, getProgress, listLessons } from '../lib/store.js'
+import { PREP_PROMPT } from '../lib/doc.js'
+import { EDGE_EN_VOICES } from '../lib/edge.js'
 
 const ANY_OBJECT = { type: 'object' }
 
@@ -62,6 +64,33 @@ export async function buildToolDefinitions({ importer }) {
       },
     },
 
+    {
+      name: 'tingdong_import_text',
+      description: '把一篇英文文档导入「听懂」做成听力课：AI 朗读成音频，再逐句翻译讲解。用户给了 PDF、网页、电子书或一段英文，想用来练听力时用。' +
+        '调用前先把材料整理好：' + PREP_PROMPT.split('\n').slice(1, 4).join(' '),
+      parameters: params({
+        text: { type: 'string', required: true, description: '整理好的英文纯文本：每章一行「# 章节标题」开头（每章做成一课），段落之间空一行，只留正文、原文不改不译' },
+        title: { type: 'string', description: '文档标题（可省略）' },
+        voice: { type: 'string', enum: EDGE_EN_VOICES.map(v => v.id), description: '朗读的声音（微软 Edge），默认 en-US-AndrewNeural（美式男声）' },
+      }),
+      output: {
+        schema: ANY_OBJECT,
+        render: (_a, v) => [{
+          type: 'text',
+          text: `《${v.title}》分成 ${v.items.length} 课：${v.items.map(it => `${it.title}${it.existed ? '（已导入过）' : `（${it.sentences} 句）`}`).join('、')}。` +
+            `正在后台朗读和翻译，几分钟后就能学。${OPEN_HINT}`,
+        }],
+      },
+      async execute(args) {
+        const r = await importer.importDoc(String(args.text || ''), {
+          title: typeof args.title === 'string' ? args.title : '',
+          engine: 'edge',
+          voice: typeof args.voice === 'string' ? args.voice : undefined,
+        })
+        return plain(r)
+      },
+    },
+
     {
       name: 'tingdong_lessons',
       description: '列出「听懂」里的听力课和学习进度（掌握多少句、待复习多少句），以及正在处理的导入任务。',

package/web/core.js

@@ -184,7 +184,9 @@ export function useTrack(t) {
   loadAudio()
 }
 
-export const trackLabel = t => (S.cur.trackDefs[t] && S.cur.trackDefs[t].label) || t
+export const isDoc = (c = S.cur) => Boolean(c && c.lesson.kind === 'doc')
+/** 声音的名字；文档课的「原声」其实是导入时的朗读 */
+export const trackLabel = t => (t === 'full' && isDoc() ? `朗读（${S.cur.lesson.voiceLabel || 'AI'}）` : (S.cur.trackDefs[t] && S.cur.trackDefs[t].label) || t)
 
 /** 学到第几句：存服务器（防抖），换设备接着学 */
 let posTimer

package/web/listen.js

@@ -1,7 +1,7 @@
 // web/listen.js — 连续听、磨耳朵、词汇
 
 import {
-  $, api, audio, clearMediaControls, curTrack, esc, fmt, getPos, keys, mediaControls, player, playSentence, S, store, tm,
+  $, api, audio, clearMediaControls, curTrack, esc, fmt, getPos, isDoc, keys, mediaControls, player, playSentence, S, store, tm,
   toast, trackLabel, usable,
 } from './core.js'
 
@@ -17,10 +17,10 @@ export function paneText(pane, l) {
       <button class="btn primary" id="playAll">▶ 连续播放</button>
       <button class="btn ${opt.en ? 'on' : ''}" id="tEn">英文</button>
       <button class="btn ${opt.zh ? 'on' : ''}" id="tZh">中文</button>
-      ${full ? `<button class="btn ${opt.skip ? 'on' : ''}" id="tSkip" title="跳过句子之间较长的空白和音乐">跳过空白</button>` : ''}
+      ${full && !isDoc() ? `<button class="btn ${opt.skip ? 'on' : ''}" id="tSkip" title="跳过句子之间较长的空白和音乐">跳过空白</button>` : ''}
       <button class="btn speed" id="speed">${player.rate}×</button>
       <a class="btn ghost" href="audio?id=${encodeURIComponent(l.id)}&track=${curTrack()}&download=1" download title="存成 MP3，放到手机或播放器上听">下载 MP3</a>
-    </div>${full ? '<div class="faint" style="margin-top:4px">现在是完整原声（含音乐和空白）。上面「声音」选「原声·去空白」或朗读，就能不停顿地连续听。</div>' : ''}</div>
+    </div>${full && !isDoc() ? '<div class="faint" style="margin-top:4px">现在是完整原声（含音乐和空白）。上面「声音」选「原声·去空白」或朗读，就能不停顿地连续听。</div>' : ''}</div>
     <div class="card" id="sents" style="padding:6px">${list.map(s => {
       const t = tm(s)
       return `<div class="sent ${opt.en ? '' : 'hide-e'} ${opt.zh ? '' : 'hide-z'}" data-i="${s.i}">

package/web/panel.css

@@ -308,3 +308,28 @@ textarea:focus { border-color: var(--accent); }
 .btn.small { padding: 2px 9px; font-size: 12px; line-height: 18px; }
 code.cmd { font: 12px ui-monospace, SFMono-Regular, Menlo, monospace; padding: 6px 8px; border: 1px solid var(--line); border-radius: 6px; user-select: all; overflow-wrap: anywhere; }
 @media (max-width: 640px) { .btn.small { padding: 4px 10px; font-size: 13px; } .top { flex-wrap: wrap; } }
+
+/* —— 首页：新建课程 —— */
+.section-title { font-size: 13px; font-weight: 600; color: var(--sub); margin: 18px 2px 8px; }
+.new-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
+.new-card {
+  appearance: none; cursor: pointer; text-align: left; font: inherit; color: var(--text);
+  background: var(--card); border: 1.5px solid var(--line); border-radius: var(--radius);
+  padding: 14px; display: flex; flex-direction: column; gap: 4px;
+}
+.new-card:hover { border-color: var(--accent); }
+.new-card.on { border-color: var(--accent); background: var(--accent-soft); }
+.new-card b { font-size: 15px; }
+.new-card .faint { line-height: 1.5; }
+.new-ico { font-size: 22px; }
+#newPanel .card { margin-top: 10px; }
+.doc-new .step { display: flex; gap: 10px; margin: 12px 0; }
+.doc-new .num {
+  flex: none; width: 22px; height: 22px; border-radius: 50%; background: var(--accent); color: #fff;
+  font-size: 12px; font-weight: 700; display: grid; place-items: center; margin-top: 1px;
+}
+.doc-new textarea { margin-top: 6px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 12.5px; }
+.prompt { white-space: pre-wrap; font: 12px/1.6 ui-monospace, SFMono-Regular, Menlo, monospace; background: var(--bg); border-radius: 8px; padding: 8px 10px; margin: 6px 0 0; color: var(--sub); }
+.kind { font-size: 11px; font-weight: 600; padding: 0 6px; border-radius: 4px; margin-right: 6px; vertical-align: 1px; background: var(--accent-soft); color: var(--accent); }
+.kind.doc { background: rgba(201, 138, 18, .14); color: var(--mid); }
+@media (max-width: 640px) { .new-grid { grid-template-columns: 1fr; } }

package/web/panel.js

@@ -6,7 +6,7 @@
 
 import { stats } from './srs.js'
 import {
-  $, api, app, clearMediaControls, curTrack, esc, fmt, fmtDur, getPos, keys, loadAudio, loadLesson, loop, nav, player,
+  $, api, app, clearMediaControls, curTrack, esc, fmt, fmtDur, getPos, isDoc, keys, loadAudio, loadLesson, loop, nav, player,
   playSentence, S, TRACK_ORDER, trackLabel, store, tm, toast, usable, useTrack, when,
 } from './core.js'
 import { paneDrill, paneText, paneWords } from './listen.js'
@@ -137,36 +137,35 @@ async function render(soft = false) {
 function renderLibrary() {
   const st = S.status || {}
   const canImport = !S.status || st.ffmpeg
-  const warn = []
-  if (S.status && !st.models && canImport) warn.push('第一次导入会先下载语音识别模型（约 240 MB），之后都在本机识别。')
-  if (S.status && !st.llm && canImport) warn.push('没找到可用的大模型：只能识别英文，翻译讲解要等配置好模型后点「补全翻译」。')
-
   const groups = new Map()
   for (const l of S.lessons) {
     const g = l.group || ''
     if (!groups.has(g)) groups.set(g, [])
     groups.get(g).push(l)
   }
+  const type = store.get('newType', '')
 
   app.innerHTML = `
     <div id="todayCard">${todayCard(S.today)}</div>
-    ${warn.length ? `<div class="card small">${warn.map(w => `<div>⚠ ${w}</div>`).join('')}</div>` : ''}
-    ${S.lessons.length ? '' : `<div class="empty">还没有课。导入一个英文 MP3：本机识别出每一句英文，AI 翻译讲解，然后一句一句练到一听就懂。</div>`}
+    ${canImport ? `
+      <div class="section-title">新建课程</div>
+      <div class="new-grid">
+        <button class="new-card ${type === 'audio' ? 'on' : ''}" data-new="audio">
+          <span class="new-ico">🎧</span><b>导入音频</b>
+          <span class="faint">有声书、讲座、引导音频……MP3 / M4A / WAV / FLAC。本机识别出每一句英文，AI 翻译讲解。</span>
+        </button>
+        <button class="new-card ${type === 'doc' ? 'on' : ''}" data-new="doc">
+          <span class="new-ico">📄</span><b>导入文档</b>
+          <span class="faint">文章、手册、书……整理好的英文文字（粘贴或 TXT / Markdown）。AI 朗读成音频，再翻译讲解。</span>
+        </button>
+      </div>
+      <div id="newPanel"></div>
+      <div id="jobs"></div>` : `<div class="card small muted">这里只用来学习：在电脑上导入、做好课，再用电脑上的「发送到 VPS」发过来。<div id="jobs"></div></div>`}
+    <div class="section-title">我的课程</div>
+    ${S.lessons.length ? '' : `<div class="empty">还没有课。上面选一种：导入英文音频，或导入英文文档。</div>`}
     ${[...groups].map(([g, ls]) => `
       ${g ? `<div class="group-title">${esc(g)}</div>` : (groups.size > 1 ? '<div class="group-title">其他</div>' : '')}
       ${ls.map(lessonCard).join('')}`).join('')}
-    ${canImport ? `<div class="card">
-      <h3>导入英文音频</h3>
-      <div class="drop" id="drop">
-        <div class="row">
-          <input type="text" class="grow" id="path" placeholder="粘贴 MP3 文件或文件夹的路径" style="flex:1 1 200px">
-          <button class="btn primary" id="importBtn">导入</button>
-        </div>
-        <div class="faint" style="margin-top:8px">也可以把音频拖到这里，或 <a href="#" class="link" id="pick">选择文件</a>。文件夹会把里面的每个音频各做成一课。</div>
-        <input type="file" id="file" accept="audio/*,.mp3,.m4a,.m4b,.wav,.flac,.ogg,.opus,.aac" multiple hidden>
-      </div>
-      <div id="jobs"></div>
-    </div>` : `<div class="card small muted">这里只用来学习：在电脑上导入、做好课，再用电脑上的「发送到 VPS」发过来。<div id="jobs"></div></div>`}
     <div id="vpsCard"></div>
   `
   renderJobs()
@@ -174,7 +173,41 @@ function renderLibrary() {
   renderVps()
   app.querySelectorAll('.lesson').forEach(el => { el.onclick = () => go(`#/l/${el.dataset.id}`) })
   if (!canImport) return
+  app.querySelectorAll('[data-new]').forEach(b => {
+    b.onclick = () => {
+      const t = store.get('newType', '') === b.dataset.new ? '' : b.dataset.new // 再点一次收起
+      store.set('newType', t)
+      app.querySelectorAll('[data-new]').forEach(x => x.classList.toggle('on', x.dataset.new === t))
+      renderNewPanel(t)
+    }
+  })
+  renderNewPanel(type)
+}
+
+/** 新建课程：展开所选的那种 */
+function renderNewPanel(type) {
+  const box = $('#newPanel')
+  if (!box) return
+  if (type === 'audio') return newAudioPanel(box)
+  if (type === 'doc') return newDocPanel(box)
+  box.innerHTML = ''
+}
 
+function newAudioPanel(box) {
+  const st = S.status || {}
+  box.innerHTML = `<div class="card">
+    <h3>导入英文音频</h3>
+    ${!st.models ? '<div class="faint">第一次导入会先下载语音识别模型（约 240 MB），之后都在本机识别，音频不上传。</div>' : ''}
+    ${!st.llm ? '<div class="small" style="color:var(--mid)">没找到可用的大模型：只能识别英文，翻译讲解要等配置好模型后点「补全翻译」。</div>' : ''}
+    <div class="drop" id="drop" style="margin-top:8px">
+      <div class="row">
+        <input type="text" class="grow" id="path" placeholder="粘贴音频文件或文件夹的路径" style="flex:1 1 200px">
+        <button class="btn primary" id="importBtn">导入</button>
+      </div>
+      <div class="faint" style="margin-top:8px">也可以把音频拖到这里，或 <a href="#" class="link" id="pick">选择文件</a>。文件夹会把里面的每个音频各做成一课。</div>
+      <input type="file" id="file" accept="audio/*,.mp3,.m4a,.m4b,.wav,.flac,.ogg,.opus,.aac" multiple hidden>
+    </div>
+  </div>`
   const input = $('#path')
   input.value = store.get('lastPath', '')
   const doImport = async () => {
@@ -200,6 +233,104 @@ function renderLibrary() {
   drop.ondrop = e => { e.preventDefault(); drop.classList.remove('over'); uploadFiles([...e.dataTransfer.files]) }
 }
 
+let docHelp = null
+async function newDocPanel(box) {
+  box.innerHTML = '<div class="card"><div class="faint">…</div></div>'
+  try {
+    if (!docHelp) docHelp = await api('doc-help')
+    if (!S.voices) S.voices = await api('voices')
+  } catch (e) { box.innerHTML = `<div class="card small" style="color:var(--bad)">${esc(e.message)}</div>`; return }
+  const V = S.voices
+  const edgeReady = V.edge && V.edge.ready
+  const engine = store.get('docEngine', 'edge')
+  const list = engine === 'edge' ? ((V.edge && V.edge.en) || []) : ((V.kokoro && V.kokoro.voices) || []).map(v => ({ ...v, gender: v.id[1] === 'm' ? 'm' : 'f' }))
+  const voice = store.get(engine === 'edge' ? 'docVoiceEdge' : 'docVoiceKokoro', engine === 'edge' ? 'en-US-AndrewNeural' : 'am_michael')
+  const speed = store.get('docSpeed', 1)
+  const group = (g, name) => `<optgroup label="${name}">${list.filter(x => x.gender === g).map(x => `<option value="${esc(x.id)}" ${x.id === voice ? 'selected' : ''}>${esc(x.label)}</option>`).join('')}</optgroup>`
+  box.innerHTML = `<div class="card doc-new">
+    <h3>导入英文文档</h3>
+    <div class="step"><span class="num">1</span><div class="grow">
+      <b>先让 AI 把材料整理好</b>
+      <div class="faint">PDF、电子书、网页都行：把下面这段话连同材料一起发给 ChatGPT、DeepSeek、Kimi 等，它会整理成能直接导入的英文文字（只留正文、修好断行、按章节分好）。扫描版 PDF 也可以，让它先识别文字。</div>
+      ${S.status && S.status.host === 'dsh' ? '<div class="faint" style="margin-top:4px">💡 更省事：在 DSH 的对话里把 PDF 发给 AI，说「按听懂的格式整理后导入听懂」，它会整理好直接导入，不用复制粘贴。</div>' : ''}
+      <details style="margin-top:6px"><summary class="link">查看整理要求</summary><pre class="prompt">${esc(docHelp.prompt)}</pre></details>
+      <button class="btn" id="copyPrompt" style="margin-top:6px">复制整理要求</button>
+    </div></div>
+    <div class="step"><span class="num">2</span><div class="grow">
+      <b>把整理好的文字粘贴进来</b>
+      <textarea id="docText" rows="8" placeholder="# 第一章标题&#10;&#10;First paragraph of the chapter...&#10;&#10;Second paragraph...&#10;&#10;# 第二章标题&#10;&#10;..."></textarea>
+      <div class="row" style="margin-top:4px">
+        <span class="faint grow" id="docCount">每个「# 标题」开始一课；没有标题就整篇一课</span>
+        <a href="#" class="link" id="docPick">或选择 .txt / .md 文件</a>
+        <input type="file" id="docFile" accept=".txt,.md,.markdown,text/plain,text/markdown" hidden>
+      </div>
+      <input type="text" id="docTitle" placeholder="文档标题（可不填，用第一章的标题）" style="margin-top:6px">
+    </div></div>
+    <div class="step"><span class="num">3</span><div class="grow">
+      <b>选朗读的声音</b>
+      <div class="chips" style="margin-top:4px">
+        <button class="chip ${engine === 'edge' ? 'on' : ''}" data-docengine="edge">微软 Edge（最自然，要联网）</button>
+        <button class="chip ${engine === 'kokoro' ? 'on' : ''}" data-docengine="kokoro">Kokoro（离线）</button>
+      </div>
+      ${engine === 'edge' && !edgeReady ? `<div class="faint">Edge 语音要先装一个小组件（edge-tts，约 15 MB，装在插件自己的目录里，需要电脑上有 Python 3）。文字会发到微软的服务器朗读。</div>
+        <button class="btn" id="docEdgeInstall" style="margin-top:6px">安装 Edge 语音组件</button>` : `
+        <div class="row" style="margin-top:4px"><select id="docVoice">${group('m', '男声')}${group('f', '女声')}</select></div>
+        <div class="chips" style="margin-top:6px">${[0.85, 1, 1.15].map(x => `<button class="chip ${x === speed ? 'on' : ''}" data-docspeed="${x}">${x === 1 ? '正常语速' : x < 1 ? '慢一点' : '快一点'}</button>`).join('')}</div>`}
+    </div></div>
+    <button class="btn primary big" id="docGo" ${engine === 'edge' && !edgeReady ? 'disabled' : ''}>开始导入</button>
+  </div>`
+  const ta = $('#docText')
+  ta.value = store.get('docDraft', '')
+  const count = () => {
+    const t = ta.value
+    const chapters = (t.match(/^#\s+\S/gm) || []).length
+    const words = (t.match(/[A-Za-z']+/g) || []).length
+    $('#docCount').textContent = t.trim() ? `${words.toLocaleString()} 个英文单词 · ${chapters ? `${chapters} 章（每章一课）` : '没有「# 标题」：整篇一课'}` : '每个「# 标题」开始一课；没有标题就整篇一课'
+  }
+  ta.oninput = () => { count(); try { store.set('docDraft', ta.value.slice(0, 200000)) } catch { /* 太大就不存草稿 */ } }
+  count()
+  $('#copyPrompt').onclick = () => copy(docHelp.prompt)
+  $('#docPick').onclick = e => { e.preventDefault(); $('#docFile').click() }
+  $('#docFile').onchange = async e => {
+    const f = e.target.files[0]
+    if (!f) return
+    ta.value = await f.text()
+    if (!$('#docTitle').value) $('#docTitle').value = f.name.replace(/\.(txt|md|markdown)$/i, '')
+    ta.oninput()
+  }
+  box.querySelectorAll('[data-docengine]').forEach(b => { b.onclick = () => { store.set('docEngine', b.dataset.docengine); newDocPanel(box) } })
+  box.querySelectorAll('[data-docspeed]').forEach(b => {
+    b.onclick = () => { store.set('docSpeed', Number(b.dataset.docspeed)); box.querySelectorAll('[data-docspeed]').forEach(x => x.classList.toggle('on', x === b)) }
+  })
+  const vs = $('#docVoice')
+  if (vs) vs.onchange = () => store.set(engine === 'edge' ? 'docVoiceEdge' : 'docVoiceKokoro', vs.value)
+  const inst = $('#docEdgeInstall')
+  if (inst) inst.onclick = async () => {
+    inst.disabled = true
+    inst.textContent = '正在安装…（第一次要一两分钟）'
+    try {
+      const r = await api('edge/install', {})
+      toast(r.ready ? `Edge 语音组件已装好（${r.version}）` : '安装没成功')
+      S.voices = null
+      newDocPanel(box)
+    } catch (e) { toast(e.message); inst.disabled = false; inst.textContent = '安装 Edge 语音组件' }
+  }
+  $('#docGo').onclick = async () => {
+    const btn = $('#docGo')
+    btn.disabled = true
+    try {
+      const r = await api('import-doc', { text: ta.value, title: $('#docTitle').value.trim(), engine, voice: vs ? vs.value : undefined, speed: store.get('docSpeed', 1) })
+      const fresh = r.items.filter(x => !x.existed)
+      toast(fresh.length ? `《${r.title}》分成 ${r.items.length} 课，正在朗读和翻译` : '这份文档导入过了')
+      store.set('docDraft', '')
+      ta.value = ''
+      count()
+      pollJobsNow()
+    } catch (e) { toast(e.message) }
+    btn.disabled = false
+  }
+}
+
 // —— 今日学习卡片 ——
 async function loadToday() {
   try {
@@ -243,7 +374,7 @@ function lessonCard(l) {
     error: '<span class="badge err">出错</span>',
   }[l.status] || (s.due ? `<span class="badge">待复习 ${s.due}</span>` : (s.total && s.mastered === s.total ? '<span class="badge ok">已掌握</span>' : ''))
   return `<div class="card lesson" data-id="${esc(l.id)}">
-    <div class="row"><div class="grow"><div class="t">${esc(l.titleZh || l.title)}</div>${l.titleZh ? `<div class="en">${esc(l.title)}</div>` : ''}</div>${badge}</div>
+    <div class="row"><div class="grow"><div class="t"><span class="kind ${l.kind === 'doc' ? 'doc' : ''}">${l.kind === 'doc' ? '文档' : '音频'}</span>${esc(l.titleZh || l.title)}</div>${l.titleZh ? `<div class="en">${esc(l.title)}</div>` : ''}</div>${badge}</div>
     <div class="faint" style="margin:6px 0">${fmtDur(l.duration)} · ${l.sentences} 句${l.translated < l.sentences ? ` · 已翻译 ${l.translated}` : ''} · 学过 ${s.seen} · 掌握 ${s.mastered}/${s.total}${s.nextDue && !s.due ? ` · 下次复习 ${when(s.nextDue)}` : ''}</div>
     <div class="bar two"><i class="seen" style="width:${seenPct}%"></i><i style="width:${pct}%"></i></div>
     ${l.error ? `<div class="small" style="color:var(--bad);margin-top:6px">${esc(l.error)}</div>` : ''}
@@ -440,7 +571,7 @@ function paneOverview(pane, l, st) {
   pane.innerHTML = `
     <div class="card">
       ${l.titleZh ? `<div style="font-weight:600">${esc(l.titleZh)}</div><div class="faint">${esc(l.title)}</div>` : `<div style="font-weight:600">${esc(l.title)}</div>`}
-      <div class="faint" style="margin-top:2px">${fmtDur(l.duration)} · ${l.sentences.length} 句${l.model ? ` · 翻译：${esc(l.model)}` : ''}</div>
+      <div class="faint" style="margin-top:2px">${l.kind === 'doc' ? `文档 · 朗读：${esc(l.voiceLabel || 'AI')} · ` : ''}${fmtDur(l.duration)} · ${l.sentences.length} 句${l.model ? ` · 翻译：${esc(l.model)}` : ''}</div>
       ${l.summaryZh ? `<p class="summary">${esc(l.summaryZh)}</p>` : ''}
       ${l.note ? `<div class="small" style="color:var(--mid)">${esc(l.note)}</div>` : ''}
       ${l.status === 'error' ? `<div class="small" style="color:var(--bad)">${esc(l.error)}</div>` : ''}
@@ -504,6 +635,8 @@ function voicesCard(l) {
   const opts = (list, sel) => list.map(x => `<option value="${esc(x.id)}" ${x.id === sel ? 'selected' : ''}>${esc(x.label)}</option>`).join('')
   const speeds = sel => [0.8, 0.9, 1].map(x => `<option value="${x}" ${x === sel ? 'selected' : ''}>${x === 1 ? '正常语速' : x + ' 倍语速'}</option>`).join('')
   const row = name => {
+    // 文档课没有真实录音：「去空白」「压背景」没意义
+    if (isDoc() && (name === 'clean' || name === 'cleannr')) return ''
     const meta = name === 'full' ? { duration: l.duration } : S.cur.tracks[name]
     if (!meta && !canMake) return ''
     const job = busy(name)
@@ -518,7 +651,7 @@ function voicesCard(l) {
     return `<div class="track ${name === t ? 'on' : ''}">
       <div class="row"><b class="grow">${esc(trackLabel(name))}</b>
         ${meta ? `<span class="faint">${fmt(meta.duration)}${meta.voice ? ' · ' + esc(meta.voice) : ''}</span>` : '<span class="faint">未生成</span>'}</div>
-      <div class="faint">${TRACK_NOTES[name]}${name === 'kokoro' && v.kokoro && !v.kokoro.ready && canMake ? '；第一次生成会下载约 103 MB 语音模型' : ''}</div>
+      <div class="faint">${name === 'full' && isDoc() ? '导入文档时 AI 朗读生成的音频' : TRACK_NOTES[name]}${name === 'kokoro' && v.kokoro && !v.kokoro.ready && canMake ? '；第一次生成会下载约 103 MB 语音模型' : ''}</div>
       ${stale ? '<div class="small" style="color:var(--mid)">句子改过了，这条声音对不上了，建议重新生成</div>' : ''}
       ${job ? `<div class="small muted" style="margin-top:4px">${job.state === 'queued' ? '排队中' : esc(job.stage)}${job.total ? ` ${job.done}/${job.total}` : ''}…</div>` : `
       <div class="row" style="margin-top:6px">
@@ -699,68 +832,20 @@ function bindZh(root, l) {
   }
 }
 
-// ———————————————————— 版本、更新、卸载（首页标题旁） ————————————————————
-// 打开首页时自动去 npm 查新版本；有就亮出「更新到 vX」，点一下交给 DSH 的插件管理器装好。
+// ———————————————————— 版本号（首页标题旁） ————————————————————
+// 更新、卸载在 DSH 的「设置 → 听懂」里；这里只显示版本，有新版本时提醒一句。
 let manageInfo = null
-let managePhase = '' // updating | updated | removing | removed
-async function renderManage(force = false) {
+async function renderManage() {
   const box = $('#manage')
-  if (!manageInfo || force) {
-    try { manageInfo = await api(`update${force ? '?force=1' : ''}`) } catch { manageInfo = null }
+  if (!manageInfo) {
+    try { manageInfo = await api('update') } catch { manageInfo = null }
   }
   const m = manageInfo
   if (!m || !m.managed) { box.hidden = true; return }
   box.hidden = route().view !== 'library'
-  let upd
-  if (managePhase === 'updating') upd = '<button class="btn small" disabled>正在更新…</button>'
-  else if (managePhase === 'updated' || m.restartPending) upd = `<button class="btn small" id="mRestart">v${esc(m.restartPending || m.latest)} 已装好，重启 DSH 生效</button>`
-  else if (m.available) upd = `<button class="btn small primary" id="mUpdate">更新到 v${esc(m.latest)}</button>`
-  else upd = `<button class="btn small ghost" id="mCheck" title="点一下重新检查">${m.latest ? '已是最新' : '检查更新'}</button>`
-  box.innerHTML = managePhase === 'removed' ? '<span class="faint">已卸载，重启 DSH 后移除</span>'
-    : `<span class="faint ver">v${esc(m.running)}</span>${upd}<button class="btn small ghost danger" id="mRemove" ${managePhase ? 'disabled' : ''}>卸载</button>`
-  const on = (sel, fn) => { const el = box.querySelector(sel); if (el) el.onclick = fn }
-  on('#mCheck', async () => { box.querySelector('#mCheck').textContent = '检查中…'; await renderManage(true); if (!manageInfo.available) toast(manageInfo.latest ? `已是最新版 v${manageInfo.running}` : '查不到 npm 上的版本，检查网络') })
-  on('#mRestart', () => manageNote({ message: m.restartHint }))
-  on('#mUpdate', async () => {
-    managePhase = 'updating'
-    renderManage()
-    try {
-      const r = await api('update', {})
-      managePhase = r.ok ? 'updated' : ''
-      if (r.ok) manageInfo.latest = r.version
-      manageNote(r)
-    } catch (e) { managePhase = ''; toast(e.message) }
-    renderManage()
-  })
-  on('#mRemove', async () => {
-    if (!confirm('从 DSH 卸载「听懂」插件？\n课程和学习进度会留在电脑上（~/.dsh/dsh-tingdong），重新装上就回来。')) return
-    managePhase = 'removing'
-    renderManage()
-    try {
-      const r = await api('uninstall', {})
-      managePhase = r.ok ? 'removed' : ''
-      manageNote(r)
-    } catch {
-      // 卸下插件时它自己的接口也随之消失，请求多半就是这么断的
-      managePhase = 'removed'
-    }
-    renderManage()
-  })
-}
-
-/** 更新 / 卸载的结果：一段说明，失败时附上可以自己在终端执行的命令 */
-function manageNote(r) {
-  const sheet = document.createElement('div')
-  sheet.className = 'sheet-wrap'
-  sheet.innerHTML = `<div class="sheet">
-    <div class="row"><b class="grow">${r.ok ? '完成' : r.ok === false ? '没有完成' : '提示'}</b><button class="icon-btn" data-close aria-label="关闭">×</button></div>
-    <div style="margin:8px 0;line-height:1.7">${esc(r.message || '')}</div>
-    ${r.command ? `<div class="row"><code class="cmd grow">${esc(r.command)}</code><button class="btn" id="copyCmd">复制</button></div>` : ''}
-  </div>`
-  document.body.appendChild(sheet)
-  sheet.addEventListener('click', e => { if (e.target === sheet || e.target.closest('[data-close]')) sheet.remove() })
-  const c = sheet.querySelector('#copyCmd')
-  if (c) c.onclick = () => copy(r.command)
+  box.innerHTML = `<span class="faint ver">v${esc(m.running)}</span>${m.restartPending
+    ? `<span class="badge warn">v${esc(m.restartPending)} 已装好，重启 DSH 生效</span>`
+    : m.available ? `<span class="badge" title="在 DSH 的「设置 → 听懂」里点更新">有新版本 v${esc(m.latest)} · 设置 → 听懂 里更新</span>` : ''}`
 }
 
 // ———————————————————— 启动 ————————————————————