dsh-tingdong 0.3.0 → 0.3.1

package/README.md

@@ -20,9 +20,9 @@
 | 连续听 | 一句接一句不停地播，英文 / 中文字幕分别开关；最后关掉字幕整篇听 |
 | 词汇 | 全篇关键术语、每句的生词、你查过的词，点一下听原句 |
 
-**导出**（每课「概览 → 导出」）：
+**导出**（每课的「导出」页签）：
 
-- **中文配音（音频）**：把英文换成中文配音，只有中文、没有背景音，每句中文从对应英文开始的时刻开始说，总长和原音频一样（也可以对齐「原声·去空白」）。比空档长的句子自动读快一点（最快 1.6 倍），不会挤到下一句。两种语音可选：
+- **中文配音（音频）**：可以下载 **MP3** 或无损 **FLAC**（44.1 kHz / 16 位，和合成出来的原始音频同源，不是 MP3 转的）。把英文换成中文配音，只有中文、没有背景音，每句中文从对应英文开始的时刻开始说，总长和原音频一样（也可以对齐「原声·去空白」）。比空档长的句子自动读快一点（最快 1.6 倍），不会挤到下一句。两种语音可选：
   - **本地 Kokoro**：离线，55 个普通话女声、45 个普通话男声，每个都能先试听；第一次用时下载约 147 MB 模型
   - **微软 Edge**：晓晓、云希、云扬等 14 种（含台湾、粤语、方言），要联网。插件调用开源工具 [edge-tts](https://github.com/rany2/edge-tts)，点「安装 Edge 语音组件」会装进插件自己的 Python 虚拟环境（需要电脑上有 Python 3）。文字会发到微软的服务器；这不是微软公开的正式接口，可能失效
 - **文字**：双语 / 英文 / 中文字幕（SRT）、双语歌词 LRC（Walkman 等播放器滚动显示）、**录音稿**（每句的开始时间、英文时长、可用时长和中英对照，照着自己录中文配音）、表格 CSV。时间可按原音频或「原声·去空白」
@@ -48,6 +48,8 @@
 
 在 DSH 对话里也可以直接说：「把 /Volumes/…/CD4 导入听懂」「我这课哪些句子总听不懂？给我讲讲」——插件给 AI 注册了 `tingdong_import`、`tingdong_lessons`、`tingdong_sentences` 三个工具。
 
+**更新 / 卸载**：首页标题旁显示版本号，打开时自动查 npm 上有没有新版本；有就出现「更新到 vX」，点一下由 DSH 的插件管理器装好（和插件市场同一套机制），重启 DSH 生效。「卸载」只移除插件，课程和学习进度留在 `~/.dsh/dsh-tingdong`。
+
 ## 安装
 
 需要 [ffmpeg](https://ffmpeg.org)（解码 MP3）：Mac 上 `brew install ffmpeg`。

package/lib/importer.js

@@ -62,7 +62,7 @@ export class Importer {
   /** 给界面看的任务列表 */
   list() {
     return this.jobs.map(j => ({
-      id: j.id, lessonId: j.lessonId, title: j.title, kind: j.kind, state: j.state, stage: j.stage,
+      id: j.id, lessonId: j.lessonId, title: j.title, kind: j.kind, track: j.track, state: j.state, stage: j.stage,
       done: j.done, total: j.total, message: j.message, error: j.error, startedAt: j.startedAt, finishedAt: j.finishedAt,
     }))
   }

package/lib/pcm.js

@@ -50,12 +50,15 @@ export function trimSilence(samples, rate = RATE, keep = 0.05) {
 
 /**
  * 一边收句子一边编码：write(i, samples) 按顺序调用，finish() 返回时间表
- * @param {object} o { ffmpeg, out, gap=0.7, bitrate='64k', signal }
+ * @param {object} o { ffmpeg, out, flac?（同时出一份 FLAC 的路径）, gap=0.7, bitrate='64k', signal }
  */
 export function createEncoder(o) {
   const gap = o.gap ?? 0.7
-  const ff = spawn(o.ffmpeg, ['-hide_banner', '-nostdin', '-y', '-f', 'f32le', '-ar', String(RATE), '-ac', '1', '-i', 'pipe:0',
-    '-codec:a', 'libmp3lame', '-b:a', o.bitrate || '64k', o.out], { stdio: ['pipe', 'ignore', 'pipe'] })
+  const args = ['-hide_banner', '-nostdin', '-y', '-f', 'f32le', '-ar', String(RATE), '-ac', '1', '-i', 'pipe:0',
+    '-codec:a', 'libmp3lame', '-b:a', o.bitrate || '64k', o.out]
+  // 同时出一份无损 FLAC（44.1 kHz / 16 位，和 CD 一样，播放器都认）：从同一份原始音频编码，不是拿 MP3 转的
+  if (o.flac) args.push('-ar', '44100', '-sample_fmt', 's16', '-codec:a', 'flac', o.flac)
+  const ff = spawn(o.ffmpeg, args, { stdio: ['pipe', 'ignore', 'pipe'] })
   let stderr = ''
   ff.stderr.on('data', d => { stderr = (stderr + d).slice(-3000) })
   let broken = null

package/lib/server.js

@@ -21,6 +21,7 @@
 //   POST <prefix>/lookup   {id, i, word}         点词查意思
 //   POST <prefix>/drill    {id, track, repeat, pause, scope, from}   生成「磨耳朵」音频
 //   GET  <prefix>/vps | POST /vps/detect {host} | /vps/config {...} | /vps/send {ids}  发送到 VPS
+//   GET  <prefix>/update[?force=1] · POST /update · POST /uninstall   插件自己的版本、更新、卸载（只在 DSH 里）
 //   GET  <prefix>/export?id=&format=&align=     导出文字：字幕 SRT、歌词 LRC、录音稿、表格
 //   POST <prefix>/voice-sample {engine, voice}   试听一个中文音色 · POST /edge/install 装 / 更新 Edge 语音组件
 //
@@ -33,7 +34,7 @@ import { pipeline } from 'node:stream/promises'
 import { findModels } from './models.js'
 import { findFfmpeg, uploadsDir } from './paths.js'
 import { AUDIO_EXT } from './importer.js'
-import { listTracks, trackAudio, TRACKS, zhSample } from './tracks.js'
+import { listTracks, trackAudio, trackFlac, TRACKS, zhSample } from './tracks.js'
 import { buildDrill, DRILL_RE } from './drill.js'
 import { explainSentences, lookupWord } from './lookup.js'
 import { today } from './today.js'
@@ -75,14 +76,14 @@ function safePost(req) {
   try { return new URL(origin).host === req.headers.host } catch { return false }
 }
 
-async function serveAudio(req, res, file, filename) {
+async function serveAudio(req, res, file, filename, type = 'audio/mpeg') {
   let st
   try { st = await stat(file) } catch { return send(res, 404, { error: '这条声音还没有生成' }) }
   const size = st.size
   const m = /^bytes=(\d*)-(\d*)$/.exec(String(req.headers.range || ''))
   // 重新生成后文件会变：用修改时间做 ETag，别让浏览器拿旧的缓存配新的时间表
-  const head = { 'content-type': 'audio/mpeg', 'accept-ranges': 'bytes', 'cache-control': 'private, no-cache', etag: `"${st.size}-${Math.round(st.mtimeMs)}"` }
-  if (filename) head['content-disposition'] = `attachment; filename="audio.mp3"; filename*=UTF-8''${encodeURIComponent(filename)}`
+  const head = { 'content-type': type, 'accept-ranges': 'bytes', 'cache-control': 'private, no-cache', etag: `"${st.size}-${Math.round(st.mtimeMs)}"` }
+  if (filename) head['content-disposition'] = `attachment; filename="audio${filename.slice(filename.lastIndexOf('.'))}"; filename*=UTF-8''${encodeURIComponent(filename)}`
   if (!m || (!m[1] && !m[2])) {
     res.writeHead(200, { ...head, 'content-length': size })
     if (req.method === 'HEAD') return res.end()
@@ -142,13 +143,17 @@ export function createHandler(o) {
           const id = checkId(q.get('id'))
           const track = q.get('track') || 'full'
           if (!TRACKS[track] && !DRILL_RE.test(track)) return send(res, 400, { error: '没有这种声音' })
+          // fmt=flac：无损版（只有中文配音生成时同时出了 FLAC）
+          const flac = q.get('fmt') === 'flac'
+          if (flac && track !== 'zh') return send(res, 400, { error: '只有中文配音有 FLAC' })
           let filename = ''
           if (q.get('download')) {
             const l = await getLesson(id)
             const meta = TRACKS[track] ? (await listTracks(id))[track] : null
             const label = TRACKS[track] ? TRACKS[track].label + (meta && meta.voiceLabel ? `（${meta.voiceLabel}）` : '') : '磨耳朵'
-            filename = `${(l && (l.titleZh || l.title)) || id} - ${label}.mp3`.replace(/[\\/:*?"<>|]/g, '_')
+            filename = `${(l && (l.titleZh || l.title)) || id} - ${label}.${flac ? 'flac' : 'mp3'}`.replace(/[\\/:*?"<>|]/g, '_')
           }
+          if (flac) return serveAudio(req, res, trackFlac(id, track), filename, 'audio/flac')
           return serveAudio(req, res, trackAudio(id, track), filename)
         }
         if (path === '/voices') {
@@ -175,6 +180,10 @@ export function createHandler(o) {
           return res.end(out.text)
         }
         if (path === '/formats') return send(res, 200, { formats: FORMATS })
+        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')) })
+        }
         if (path === '/jobs') return send(res, 200, { jobs: o.importer.list() })
         if (path === '/today') return send(res, 200, await today({ tz: Number(q.get('tz')) || 0 }))
         if (path === '/vps') {
@@ -265,6 +274,8 @@ export function createHandler(o) {
         const file = await zhSample(String(body.voice || ''), { ffmpeg: opts().ffmpeg, engine: body.engine === 'edge' ? 'edge' : 'kokoro' })
         return serveAudio(req, res, file)
       }
+      if (path === '/update' && o.manage) return send(res, 200, await o.manage.update())
+      if (path === '/uninstall' && o.manage) return send(res, 200, await o.manage.uninstall())
       if (path === '/edge/install') return send(res, 200, { ok: true, ...(await installEdge()) })
       if (path === '/vps/detect') return send(res, 200, { ok: true, ...(await detect(String(body.host || ''))) })
       if (path === '/vps/config') {

package/lib/tracks.js

@@ -33,6 +33,8 @@ export const TRACK_NAMES = Object.keys(TRACKS)
 
 const tracksDir = id => join(lessonDir(id), 'tracks')
 export const trackAudio = (id, name) => (name === 'full' ? join(lessonDir(id), 'audio.mp3') : join(tracksDir(id), `${name}.mp3`))
+/** 无损版（目前只有中文配音有） */
+export const trackFlac = (id, name) => join(tracksDir(id), `${name}.flac`)
 
 /** 已生成的声音轨（不含 full） */
 export async function listTracks(id) {
@@ -206,11 +208,14 @@ async function buildZh(lesson, o) {
     ? await ensureKokoroZh({ signal: o.signal, onProgress: (g, t) => o.onStage && o.onStage('下载中文语音模型', Math.round(g / 1048576), Math.round(t / 1048576), 'MB') })
     : undefined
   const out = join(tracksDir(lesson.id), 'zh.part.mp3')
-  const args = { engine: `${engine}-zh`, sid: voice.sid, voice: voice.id, speed: o.speed || 1, sentences, total, kokoroDir, ffmpeg, out, threads: o.threads || 2, bitrate: '48k' }
+  const flac = join(tracksDir(lesson.id), 'zh.part.flac')
+  const args = { flac, engine: `${engine}-zh`, sid: voice.sid, voice: voice.id, speed: o.speed || 1, sentences, total, kokoroDir, ffmpeg, out, threads: o.threads || 2, bitrate: '48k' }
   o.onStage && o.onStage(`中文对译（${voice.label}）`, 0, sentences.length, '句')
-  const res = await runWorker(args, o, `中文对译（${voice.label}）`)
+  let res
+  try { res = await runWorker(args, o, `中文对译（${voice.label}）`) } catch (e) { await rm(flac, { force: true }); throw e }
   await rename(out, trackAudio(lesson.id, 'zh'))
-  return { items: res.items, duration: res.duration, engine, voice: voice.id, voiceLabel: `${engine === 'edge' ? 'Edge ' : ''}${voice.label}`, speed: args.speed, align, squeezed: res.squeezed || 0 }
+  await rename(flac, trackFlac(lesson.id, 'zh'))
+  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 }
 }
 
 /** 试听一个中文音色：同一句话，生成一次缓存起来 */

package/lib/tts-worker.js

@@ -124,7 +124,7 @@ function sayEngine(opt) {
 
 /** 按时间表放（中文对译）：每句放在 start；比空档长就读快一点，最快 1.6 倍 */
 async function timeline(opt, speak) {
-  const enc = createEncoder({ ffmpeg: opt.ffmpeg, out: opt.out, gap: 0, bitrate: opt.bitrate })
+  const enc = createEncoder({ ffmpeg: opt.ffmpeg, out: opt.out, flac: opt.flac, gap: 0, bitrate: opt.bitrate })
   const list = (opt.sentences || []).map(s => ({ ...s, text: tidyZh(s.text) })).filter(s => s.text).sort((a, b) => a.start - b.start)
   const base = opt.speed || 1
   let squeezed = 0

package/package.json

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

package/plugin/index.js

@@ -21,6 +21,7 @@ import { Importer } from '../lib/importer.js'
 import { dshLlm } from '../lib/llm.js'
 import { createHandler } from '../lib/server.js'
 import { registerTools } from './tools.js'
+import { createManager } from './manage.js'
 
 const PKG_ROOT = fileURLToPath(new URL('..', import.meta.url))
 export const PREFIX = '/api-dsh-tingdong'
@@ -77,7 +78,20 @@ export function apply(ctx, config = {}) {
   if (typeof ctx.effect === 'function') ctx.effect(() => stopAll)
   else if (typeof ctx.on === 'function') ctx.on('dispose', stopAll)
 
+  // DSH 自己的插件管理器（更新 / 卸载按钮用；老版本 DSH 没有）
+  let pluginManager
+  ctx.inject(['pluginManager'], (c) => {
+    c.effect(() => {
+      pluginManager = c.pluginManager || (c.get && c.get('pluginManager'))
+      return () => { pluginManager = undefined }
+    })
+  })
+  let profile
+  try { profile = ctx.get && ctx.get('profileContext') && ctx.get('profileContext').name } catch { profile = undefined }
+  const manage = createManager({ pkgRoot: PKG_ROOT, pluginManager: () => pluginManager, profile: () => profile })
+
   const handle = createHandler({
+    manage,
     prefix: PREFIX,
     pkgRoot: PKG_ROOT,
     importer,

package/plugin/manage.js

@@ -0,0 +1,129 @@
+// plugin/manage.js — 插件自己的版本、更新、卸载（首页标题旁的按钮）
+//
+// 更新、卸载交给 DSH 自己的插件管理器（pluginManager.installBundle / removeBundle，和 DSH「插件」页同一套：
+// 带锁跑 pnpm、失败自动还原）。写法照 dsh-pick。拿不到插件管理器（老版本 DSH）或它拒绝时，
+// 给出用户可以自己在终端执行的命令。装完要重启 DSH 才生效。
+
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+export const PACKAGE = 'dsh-tingdong'
+// npm 官方源连不上（国内常见）就问镜像
+const REGISTRIES = ['https://registry.npmjs.org', 'https://registry.npmmirror.com']
+const VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/
+
+/** a 比 b 新返回正数（x.y.z，预发布版比同号正式版旧） */
+export function compareVersions(a, b) {
+  const parse = v => {
+    const [core, pre = ''] = String(v || '').replace(/^v/, '').split('-', 2)
+    return { nums: core.split('.').map(n => parseInt(n, 10) || 0), pre }
+  }
+  const x = parse(a), y = parse(b)
+  for (let i = 0; i < 3; i++) {
+    const d = (x.nums[i] || 0) - (y.nums[i] || 0)
+    if (d) return d
+  }
+  if (x.pre === y.pre) return 0
+  if (!x.pre) return 1
+  if (!y.pre) return -1
+  return x.pre < y.pre ? -1 : 1
+}
+
+/** 插件管理器的失败结果 → 错误码 / 一行人话 */
+function managerCode(result) {
+  if (!(result && (result.application === 'failed' || result.application === 'cancelled' || result.error))) return ''
+  return (result.error && result.error.code) || result.application || 'failed'
+}
+function managerError(result) {
+  const code = managerCode(result)
+  if (!code) return ''
+  const detail = String((result.error && result.error.diagnostic) || (result.packageResult && result.packageResult.output) || '')
+    .trim().split('\n').slice(-3).join(' ').slice(-300)
+  return detail ? `${code}：${detail}` : code
+}
+
+const RESTART = 'DSH 要重启才用上新版本：电脑上完全退出 DSH（Mac 按 Cmd+Q，不是关窗口）再打开；VPS 上在「设置 → VPS 部署」里重启。'
+const ALREADY = '这个版本的 DSH 不能在运行中升级已装的插件。完全退出 DSH（Mac 上按 Cmd+Q）后在终端执行下面的命令，再打开 DSH。'
+
+/**
+ * @param {object} o
+ * @param {string} o.pkgRoot 本包根目录
+ * @param {() => any} o.pluginManager 拿 DSH 的插件管理器（可能没有）
+ * @param {() => string|undefined} o.profile 当前 profile 名（拼命令用）
+ */
+export function createManager(o) {
+  let running = ''
+  const readPkg = async () => { try { return JSON.parse(await readFile(join(o.pkgRoot, 'package.json'), 'utf8')) } catch { return {} } }
+  readPkg().then(p => { running = p.version || '' })
+
+  let cache = null
+  async function latest(force) {
+    if (!force && cache && Date.now() - cache.at < 10 * 60 * 1000) return cache.version
+    for (const r of REGISTRIES) {
+      try {
+        const res = await fetch(`${r}/${PACKAGE}/latest`, { signal: AbortSignal.timeout(6000) })
+        if (!res.ok) continue
+        const { version } = await res.json()
+        if (VERSION_RE.test(String(version || ''))) { cache = { version, at: Date.now() }; return version }
+      } catch { /* 换下一个源 */ }
+    }
+    return ''
+  }
+
+  const command = args => {
+    const p = o.profile()
+    return /^[A-Za-z0-9._-]+$/.test(p || '') ? `dsh plugin --profile ${p} ${args}` : `dsh plugin ${args}`
+  }
+  const pm = () => { try { return o.pluginManager() } catch { return null } }
+
+  return {
+    /** 版本信息：正在运行的、磁盘上装好的、npm 上最新的 */
+    async info(force) {
+      const [pkg, newest] = await Promise.all([readPkg(), latest(force)])
+      const installed = pkg.version || ''
+      const current = compareVersions(installed, running) > 0 ? installed : running
+      const m = pm()
+      return {
+        running,
+        restartPending: installed && running && compareVersions(installed, running) > 0 ? installed : '',
+        latest: newest,
+        available: Boolean(newest) && compareVersions(newest, current) > 0,
+        canInstall: Boolean(m && typeof m.installBundle === 'function'),
+        canRemove: Boolean(m && typeof m.removeBundle === 'function'),
+        command: command(`add ${PACKAGE}@${newest || 'latest'}`),
+        removeCommand: command(`remove ${PACKAGE}`),
+        restartHint: RESTART,
+      }
+    },
+    async update() {
+      const newest = await latest(true)
+      const cmd = command(`add ${PACKAGE}@${newest || 'latest'}`)
+      if (!newest) return { ok: false, message: '查不到 npm 上的最新版本，检查网络后再试', command: cmd }
+      if (compareVersions(newest, running) <= 0) return { ok: false, message: `已经是最新版 v${running}` }
+      const m = pm()
+      if (!m || typeof m.installBundle !== 'function') return { ok: false, message: '这个版本的 DSH 不能在这里装插件，请在终端执行命令', command: cmd }
+      try {
+        const result = await m.installBundle(`${PACKAGE}@${newest}`, { enabled: true })
+        if (managerCode(result) === 'already-installed') return { ok: false, message: ALREADY, command: cmd }
+        const err = managerError(result)
+        if (err) return { ok: false, message: `更新失败（${err}）`, command: cmd }
+        return { ok: true, version: newest, message: RESTART }
+      } catch (e) {
+        if (e && e.code === 'already-installed') return { ok: false, message: ALREADY, command: cmd }
+        return { ok: false, message: `更新失败：${e.message}`, command: cmd }
+      }
+    },
+    async uninstall() {
+      const cmd = command(`remove ${PACKAGE}`)
+      const m = pm()
+      if (!m || typeof m.removeBundle !== 'function') return { ok: false, message: '这里没法直接卸载：完全退出 DSH 后在终端执行命令', command: cmd }
+      try {
+        const err = managerError(await m.removeBundle(PACKAGE))
+        if (err) return { ok: false, message: `卸载失败（${err}），可完全退出 DSH 后在终端执行命令`, command: cmd }
+        return { ok: true, message: '已卸载，重启 DSH 后彻底移除。课程和学习进度还留在 ~/.dsh/dsh-tingdong，重新装上就回来。' }
+      } catch (e) {
+        return { ok: false, message: `卸载失败：${e.message}`, command: cmd }
+      }
+    },
+  }
+}

package/web/panel.css

@@ -301,3 +301,10 @@ textarea:focus { border-color: var(--accent); }
 /* —— 导出 —— */
 .sub-h { font-size: 13px; font-weight: 600; margin: 4px 0 2px; }
 .row.wrap { flex-wrap: wrap; }
+
+/* —— 标题旁的版本、更新、卸载 —— */
+.manage { display: inline-flex; align-items: center; gap: 6px; margin-left: 4px; flex-wrap: wrap; }
+.manage .ver { font-variant-numeric: tabular-nums; }
+.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; } }

package/web/panel.html

@@ -15,6 +15,7 @@
 <header class="top">
   <button class="icon-btn" id="back" hidden title="返回课程列表" aria-label="返回">‹</button>
   <div class="brand" id="brand">听懂</div>
+  <span class="manage" id="manage" hidden></span>
   <div class="spacer"></div>
   <a class="link" id="popout" href="panel" target="_blank" rel="noopener" hidden>新窗口打开</a>
 </header>

package/web/panel.js

@@ -98,9 +98,11 @@ async function render(soft = false) {
   const r = route()
   $('#back').hidden = r.view === 'library'
   if (!soft) { keys.handler = null; loop.on = false; clearMediaControls() }
+  $('#manage').hidden = r.view !== 'library'
   if (r.view === 'library') {
     if (!soft) player.stop()
     $('#brand').textContent = '听懂 · 英文听力'
+    if (!soft) renderManage()
     rendered = 'library'
     renderLibrary()
     // 从课程页回来：进度变了，后台重新拉一次课程列表
@@ -359,7 +361,7 @@ async function copy(text) {
 
 // ———————————————————— 一节课 ————————————————————
 
-const TABS = [['overview', '概览'], ['study', '精听'], ['review', '复习'], ['text', '连续听'], ['drill', '磨耳朵'], ['words', '词汇']]
+const TABS = [['overview', '概览'], ['study', '精听'], ['review', '复习'], ['text', '连续听'], ['drill', '磨耳朵'], ['words', '词汇'], ['export', '导出']]
 
 function renderLesson(tab) {
   const l = S.cur.lesson
@@ -381,7 +383,7 @@ function renderLesson(tab) {
     bindManage(pane, l)
     return
   }
-  ;({ overview: paneOverview, study: paneStudy, review: paneReview, text: paneText, drill: paneDrill, words: paneWords }[tab] || paneOverview)(pane, l, st)
+  ;({ overview: paneOverview, study: paneStudy, review: paneReview, text: paneText, drill: paneDrill, words: paneWords, export: paneExport }[tab] || paneOverview)(pane, l, st)
 }
 
 /** 课程页上方的「声音」选择条 */
@@ -460,7 +462,10 @@ function paneOverview(pane, l, st) {
       ${stars ? `<div class="faint" style="margin-top:6px">难句本：收藏了 ${stars} 句，在「复习」或「磨耳朵」里选「收藏」专门练。</div>` : ''}
     </div>
     ${voicesCard(l)}
-    ${zhCard(l)}
+    <div class="card row">
+      <div class="grow"><b>导出</b><div class="faint">中文配音（MP3）、双语字幕、LRC 歌词、录音稿</div></div>
+      <button class="btn" id="goExport">去导出 ›</button>
+    </div>
     <div class="card">
       <h3>怎么练到「一听就懂」</h3>
       <ol class="steps">
@@ -474,7 +479,7 @@ function paneOverview(pane, l, st) {
     </div>
     <div class="card"><h3>管理</h3>${manageButtons(l)}</div>`
   bindVoices(pane, l)
-  bindZh(pane, l)
+  $('#goExport').onclick = () => go(`#/l/${l.id}/export`)
   $('#goStudy').onclick = () => go(`#/l/${l.id}/study`)
   $('#goReview').onclick = () => go(`#/l/${l.id}/review`)
   $('#goDrill').onclick = () => go(`#/l/${l.id}/drill`)
@@ -564,6 +569,12 @@ let zhAudio = null // 试听用的独立播放器，不打扰课程的播放器
 function stopZhAudio() { if (zhAudio) { zhAudio.pause(); zhAudio = null } }
 window.addEventListener('hashchange', stopZhAudio)
 
+/** 「导出」页签 */
+function paneExport(pane, l) {
+  pane.innerHTML = zhCard(l)
+  bindZh(pane, l)
+}
+
 const TEXT_FORMATS = [['srt-bi', '双语字幕'], ['srt-en', '英文字幕'], ['srt-zh', '中文字幕'], ['lrc', '歌词 LRC'], ['script', '录音稿'], ['csv', '表格']]
 
 function zhCard(l) {
@@ -590,6 +601,7 @@ function zhCard(l) {
       <div class="row" style="margin-top:6px">
         <button class="btn" id="zhPlay">▶ 试听</button>
         <a class="btn primary" href="audio?id=${encodeURIComponent(l.id)}&track=zh&download=1" download>下载 MP3</a>
+        ${meta.flac ? `<a class="btn primary" href="audio?id=${encodeURIComponent(l.id)}&track=zh&fmt=flac&download=1" download>下载 FLAC（无损）</a>` : '<span class="faint">要 FLAC：重新生成一次</span>'}
       </div>` : ''}
     ${job ? `<div class="small muted" style="margin-top:8px">${job.state === 'queued' ? '排队中' : esc(job.stage)}${job.total ? ` ${job.done}/${job.total}` : ''}…</div>` : canMake ? `
       <div class="form">
@@ -687,6 +699,70 @@ function bindZh(root, l) {
   }
 }
 
+// ———————————————————— 版本、更新、卸载（首页标题旁） ————————————————————
+// 打开首页时自动去 npm 查新版本；有就亮出「更新到 vX」，点一下交给 DSH 的插件管理器装好。
+let manageInfo = null
+let managePhase = '' // updating | updated | removing | removed
+async function renderManage(force = false) {
+  const box = $('#manage')
+  if (!manageInfo || force) {
+    try { manageInfo = await api(`update${force ? '?force=1' : ''}`) } 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)
+}
+
 // ———————————————————— 启动 ————————————————————
 
 ;(async () => {