dsh-tingdong 0.3.0 → 0.4.0

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

@@ -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
@@ -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.0",
-  "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/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/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

@@ -301,3 +301,35 @@ 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; } }
+
+/* —— 首页：新建课程 —— */
+.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.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>