dsh-podwave 0.11.24 → 0.11.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,516 @@
1
+ ## 0.11.26 — 2026-11-16
2
+
3
+ 发布物清理个人隐私,并修掉 Windows CI 里 `windows-runtime` 那个跑红的 job。
4
+
5
+ - **截图全部重做**:删掉 10 张没人引用的截图(`screenshot.png`、`screenshot-setup.png`、`screenshot-player-detail.png`、`screenshot-dark.png`、`screenshot-light.png`、`screenshot-collapsed.png`、`screenshot-tasks.png`、`screenshot-xyz.png`、`screenshot-xyz-public.png`、`screenshot-0.2.png`),保留的 7 张裁掉 DSH 侧栏(`screenshot-live.png` 侧栏本来就收起了,无需裁)。之前的截图泄露了 DSH 侧栏里的会话标题、工作区名、账号昵称与头像,其中 `screenshot-setup.png` 和 `screenshot-player-detail.png` 还带着真实的 `/Users/<用户名>` 路径。**这些图此前已随公开仓库和 npm 包分发过**,本次只是止血:git 历史里的旧图仍在。
6
+ - 保留的截图统一重新导出为真 PNG:其中 `screenshot-detail.png`、`screenshot-notes.png` 之前后缀是 `.png`、内容其实是 JPEG(顺带解决了小字发糊)。
7
+ - `docs/ARCHITECTURE.md`、`docs/RELEASING.md` 里的本机绝对路径改成 `<本仓库路径>`、`<DSH profile>` 占位。
8
+ - 新增 `test/privacy.test.mjs`(5 个用例):源码与文档里不得出现具体本机家目录(`/Users/<名字>`、`/home/<名字>`、`C:\Users\<名字>`,`tom`/`someone` 等明显占位除外)、文档引用的图必须存在、`docs/` 不得留没人引用的截图、`screenshots.json` 条目必须存在、随包分发的截图必须是真 PNG(校验文件头)。
9
+ - 修 Windows CI 的 `windows-runtime` job:模型默认目录改到项目/工作区下的 `models/` 之后,workflow 仍写死 `$env:USERPROFILE\.podwave\models\...`,模型下到了新位置、sherpa 去老位置找,报 `Load model ... failed. File doesn't exist`。现在改为用 `node --input-type=module` 调 `modelsDir()` 现算路径。同两处写死已修:`test/ci/llama-check.mjs` 改用 `modelsDir()`,`src/transcribe.js` 的「模型未下载」提示不再点名 `~/.podwave/models`。
10
+ - 新增 `test/ci-model-path.test.mjs`(4 个用例)守住模型路径不再被写死。
11
+ - 顺带修掉 `api/health` 返回的版本号落后一版(一直是 `0.11.24`)。
12
+ - 测试总数 120(117 通过、3 个 Windows 专用跳过)。
13
+
14
+ ## 0.11.25 — 2026-11-16
15
+
16
+ 发布包补齐 DSH 插件展示元数据:装上之后在插件列表里显示中文名和图标,详情页有自己的介绍和配图。
17
+
18
+ - 新增 `locale/en.json`、`locale/zh.json`:`meta.title` / `meta.description` 中英文各一份。以前列表里显示的是包名 `dsh-podwave` 加 `package.json` 的 description,现在中文环境显示「播客」。
19
+ - 新增 `icon.svg`(754 字节,36×36,取插件主色 `#E6A54A` → `#B26A12` 的渐变波形)。`package.json` 加了 `icon` 字段。
20
+ - 新增 `docs/DETAIL.md` / `docs/DETAIL.zh.md`:详情页不再回退整篇 README,只显示一句介绍加一张截图(复用 `docs/screenshot-detail.png`)。
21
+ - `package.json` 的 `exports` 补 `"./locale/*.json"`。DSH 通过这个 subpath 读 locale,不声明就静默拿不到(退回包名兜底),本地开发看不出来。
22
+ - `files` 白名单补 `locale`、`icon.svg`、两份 `DETAIL.md`、`docs/ARCHITECTURE.md`、`docs/screenshot-detail.png`、`CHANGELOG.md`;`scripts` 收窄成 `scripts/*.py`,不再把 `release.mjs` 和 `__pycache__` 打进包里。
23
+ - 修掉 README 引用的 `docs/screenshot-detail.png` 和 `docs/ARCHITECTURE.md` 不在包内的问题——之前从 npm 装的用户,详情页图片是断的。
24
+ - 新增 `test/package-metadata.test.mjs`(6 个用例):校验 exports / files 白名单、每个 locale 的字段与 detail 文件、详情文档与 README 的图片都在包内、icon 类型与 256 KiB 上限。测试总数 111(108 通过、3 跳过)。
25
+
26
+ ## 0.11.24 — 2026-11-16
27
+
28
+ 发布版(从 npm 装的)也默认把模型下载到项目文件夹,不再一律塞进 `~/.podwave/models`。
29
+
30
+ - 发布版没有源码工作树,装进 `node_modules` 的目录升级时会被整个替换,不能放模型。所以「项目文件夹」在发布版里指**你正在用的工作区**:默认下载到 `<工作区>/models`。
31
+ - 当前工作区怎么来的:优先认会话真正开在的目录(监听 `session/created` 拿 `header.cwd`);还没拿到时退化成「最近更新的工作区」(读 `workspaceRegistry`)。
32
+ - 开发工作树和 `file:` 安装的行为不变,仍然默认落在插件仓库自己的 `models/`。
33
+ - 老位置 `~/.podwave/models` 里已经有模型的,继续沿用,不悄悄搬 5 GB;新位置一旦有模型就切过去。
34
+ - 设置页文案按位置区分「项目文件夹 / 工作区文件夹 / 原有的 ~/.podwave/models」,一键按钮也跟着变成「用工作区文件夹」;改目录的方式不变(输入框 + 迁移,或「恢复默认位置」)。
35
+ - 切工作区不会让已下载的模型「凭空消失」:其他工作区的 `models/` 也在候选里,按「最近用过」排序,切回来接着用原来的模型。
36
+ - 新增 5 个测试(发布版默认落到工作区、项目工作树优先于工作区、非法工作区路径被忽略、切工作区沿用旧模型、host 从 workspaceRegistry 学当前工作区),总数 105(102 通过、3 跳过)。
37
+
38
+ ## 0.11.23 — 2026-11-16
39
+
40
+ 模型默认下载位置改成「跟着项目走」,不再一律塞进家目录的隐藏文件夹。
41
+
42
+ - 从本地路径安装(profile 里是 `file:/path/to/dsh-podwave`)或直接在仓库里跑时,默认下载到项目下的 `models/`;npm 安装仍然落在 `~/.podwave/models`。
43
+ - 家目录里已经存过模型的老用户不会被搬家:只有项目目录里已经有模型时才切过去,避免升级后突然要重下 5 GB。
44
+ - `.gitignore` 增加 `models/`,模型不会进版本库。
45
+ - 设置页文案说明「从本地路径安装时默认就是项目里的 models/」,位置照样可以改,改完会把已有模型一起搬过去。
46
+ - 新增 6 个测试(默认位置解析、`file:` 安装识别、老位置沿用、显式配置优先),总数 100(97 通过、3 跳过)。
47
+
48
+ ## 0.11.22 — 2026-11-14
49
+
50
+ 模型存放位置改成可配置,并且「装在哪」这件事在界面上说清楚。之前模型目录写死在 `~/.podwave/models`,5 GB 的家目录占用没法挪,装完也只在小字里提一句。
51
+
52
+ - 模型目录可配置:设置页新增「模型存放位置」,可改成任意绝对路径(支持 `~` 和 `%VAR%`),换完自动把已有模型搬过去。同卷用 rename 秒完成,跨卷会真复制并显示进度;原目录空了会自动删掉。
53
+ - 默认位置保持不变(`~/.podwave/models`),老用户升级后行为不变;配置里写了非法路径会退回默认,不会让插件起不来。
54
+ - 新增模型清单:列出每个模型的体积、用途(转写 / 翻译 / 说话人分离)、是否正在使用、是否就绪,按体积从大到小排。
55
+ - 新增「删除」按钮:可以清掉不再使用的模型(正在用的会被拦住并说明原因),配合上面的清单能直接回收几个 GB。
56
+ - 新增「在文件管理器中打开」:一键定位到模型目录(macOS 访达 / Windows 资源管理器 / Linux xdg-open)。
57
+ - 安装结束时明确告知落盘位置:一键安装完成的任务里会写出「模型已装在 <路径>」,不再是只提一句默认目录。
58
+ - 下载器、引擎判定、说话人分离改为每次现算模型路径(不再在模块顶层固化常量),换目录后无需重启即可生效。
59
+ - 修复下载路径与运行时路径的混用:llama.cpp 的下载缓存原来拼的是 `models/../runtime`,现在直接用运行时目录。
60
+ - 修复设置页整体加载失败:`/api/update` 路由调用了 `checkUpdate` 但从未 import 进 host,导致设置页每次打开都报「checkUpdate is not defined」,界面上历史记录、模型、安装状态全是空的(该问题从 v0.11.10 加版本检查起就存在)。
61
+ - 顺带修两处显示问题:说话人分离模型装好了却一直显示「未就绪」(只认 safetensors/int8/gguf,不认裸 onnx);本地版本比 npm 新时错误地显示「已是最新版本」。
62
+ - 新增 8 个回归测试(本次共 94 个):模型目录的默认位置 / 换目录 / 迁移 / 拒绝相对路径与嵌套目录 / 体积用途统计 / 删除保护 / 非法配置回退,外加一条「设置页会拉的 8 个接口必须全部 200」的冒烟测试。
63
+
64
+ ## 0.11.21 — 2026-11-13
65
+
66
+ Windows 兼容性修复(对应 Issue #1 的 8 条)。之前插件在 Windows 上能跑通大部分功能,但「检测环境」会给错结论,安装最后一步可能整次失败。
67
+
68
+ - 修复首启把 Mac 专用 MLX 模型写进配置:默认模型现在按平台计算(Apple Silicon → MLX;Windows/Linux → SenseVoice + GGUF),不再写死 `qwen3-asr-1.7b-8bit` 那套只有 Apple Silicon 装得了的模型。
69
+ - 修复配置缓存覆写安装结果:宿主进程常驻,而「一键安装」是另一个进程写盘;原来保存任何无关设置都会把内存里的旧快照整份写回,把刚装好的模型名吞掉。现在每次保存前比对磁盘指纹,外部改动会先被读进来再合并。
70
+ - 修复「安装检查」形同虚设:之前只判断模型名非空,Mac 专用名、甚至瞎编的名字都会亮绿,用户看到「全部通过」却在转写时报「运行环境未安装」。现在比对当前平台真正应有的模型,不一致时明确写出「转写模型应为 X,当前 Y」。
71
+ - 修复引擎判定靠正则猜:改成查 catalog 元数据(`artifactByDir`),换模型名不会再掉进 MLX 分支。
72
+ - 修复 Windows 上「运行环境未安装」误报:虚拟环境路径统一走 `venvBin()` / `venvPython()`,Windows 正确拼 `Scripts\`,不再是 macOS 的 `bin/`。
73
+ - 修复 Git-Bash / MSYS / Cygwin 环境下 tar 解压失败:GNU tar 会把 `C:/...` 当成远程主机(`Cannot connect to C: resolve failed`,exit 128)。现在 .tar.bz2 / .tar.gz 有四个候选(裸 tar → `--force-local` → System32 自带 bsdtar → python tarfile),列目录也走同样的兜底,安全路径检查不再被静默跳过。
74
+ - 修复可选组件拖垮整次安装:说话人分离模型(可选)解压失败时不再让「已下载 1.6 GB」被判定成安装失败,而是跳过并给出「可选组件失败,核心功能已就绪」的提示。
75
+ - 修复 `scripts/diarize.py` 硬编码 `/opt/homebrew/bin/ffmpeg`(Windows 报 `[WinError 2]`):默认改为走 PATH。
76
+ - 修复 Windows 上结束子进程等于硬杀:统一走 `killTree()`,Windows 用 `taskkill /T` 连子孙进程一起收,其它平台仍是优雅 SIGTERM,避免 ffmpeg/llama-server 残留。
77
+ - 文件夹路径支持 Windows 环境变量:`%USERPROFILE%\Music` 这类路径现在能正确展开,`~\Music` 也可以。
78
+ - 小宇宙「一键连接」在非 macOS 上给出明确提示:以前点下去会变成 500 服务器错误,现在返回 400 +「仅支持 macOS 上的小宇宙 App」,前端能直接显示原因。
79
+ - 修复 CI 在 Linux / Windows 上一直红:小宇宙登录态相关测试默认假设「运行在 macOS 且本机有小宇宙 App」,在 CI 上必然失败。现在平台通过参数注入,测试在任何系统上都能跑,同时新增「非 macOS 上必须如实报不支持」的断言。
80
+ - 新增 12 个 Windows 兼容回归测试(本次共 86 个),以及两个只在 CI 的 `windows-latest` 真机上跑的校验脚本(真实平台默认模型 / 真实 tar.bz2 解压)。
81
+
82
+ ## 0.11.20 — 2026-11-13
83
+
84
+ - 修复「取消转写」点了没反应:转写任务原本只认内存里的进程句柄,一旦宿主重载过插件(或换过一次模块实例),新实例手里没有任何句柄,点取消只会在内存里空找一圈然后静静返回。现在把子进程 pid 写进持久任务,取消时先按内存找、找不到就按 pid 杀,实在没有进程可杀也把任务收尾成「已取消」,不会一直转圈。
85
+ - 修复重载后任务变僵尸:插件重载时正在跑的转写现在会在磁盘上收尾成「已取消(插件重新加载)」,而不是留下一条永远不会结束的 running 记录。
86
+ - 修复旧实例覆盖新状态:取消后旧实例的进度 tick 会把磁盘上的 `cancelling` 覆写回 `transcribing`,看起来像取消失败。现在 tick 每轮读一次磁盘,看到取消意图就停止写进度并终止子进程;收尾阶段同样以磁盘状态为准。
87
+ - 取消/中断的错误信息更准确:进程被信号杀掉(重载、手动 kill)不再报「转写进程退出码 null」+ 一屏 `MallocStackLogging` 噪声,改为「转写进程被中断,已完成的分块保留,可以点重试继续」。
88
+ - 修复任务面板背景透明:`.jobs-panel` 用的 CSS 变量 `--panel` 从未定义,导致面板整块透明,下层字幕文字直接透上来叠成一团。改用与其它浮层一致的 `--elev`。
89
+ - 新增 6 个取消相关测试(无内存态也能按 pid 杀掉、worker 已退出时直接收尾、interrupted 任务可取消、已完成任务不受影响、未知 id 返回 none、重载后活进程任务保持 running 不被改成 interrupted)。测试总数 74(71 通过、3 个 Windows 专用跳过)。
90
+
91
+ ## 0.11.19 — 2026-11-13
92
+
93
+ - 连接小宇宙变成一键:新增「读取小宇宙 App 的登录态」。只要在这台 Mac 的小宇宙 App 里登录过,点一下就把登录态搬进来,不用再开网页、按 F12、抄 header。登录态只写到本机 `~/.podwave/xyz.json`(0600)。
94
+ - 手动连接整体折叠进「手动连接」里(网页版复制 token、验证码登录),平时看不到这些步骤。
95
+ - 修复「从剪贴板粘贴」按钮点了报错的问题:之前 `pasteToken` 压根没定义,点了必抛 ReferenceError。
96
+ - 修复订阅列表一直拉不到:接口从 `/v1/subscription` 变成了 `POST /v1/subscription/list`,且必须带 `sortBy`。现在按 `loadMoreKey.skip` 翻完所有页(实测 85 个订阅全部取回)。
97
+ - 修复单集详情失效:`POST /v1/episode/get` 已废弃,改回 `GET /v1/episode/get?eid=`。之前在线播放、封面回退会踩到 404。
98
+ - 修复 token 刷新一直失败:小宇宙要求刷新时同时带上 refresh token 和 access token,之前只带了 access token,所以永远 401。
99
+ - 订阅项补上真实订阅数与集数(`subscriptionCount` / `episodeCount`)。
100
+ - 新增 10 个小宇宙测试:本机登录态读取(无 plist / 未登录 / 正常 / refresh 失败回退 / 登录失效)、宿主路由一键连接、订阅分页、单集 GET、模块加载即读登录态、刷新服务抖动时保留登录态。测试总数 62(59 通过、3 个 Windows 专用跳过)。
101
+ - 登录态不再被一次 401 清空:以前任何一个请求返回 401(可能只是瞬时被网关挡下)就会把本地 token 抹掉,用户只看到「登录已失效」。现在只有 refresh 接口明确拒绝才算过期,瞬时 401 只提示重试、保留登录态;过期文案也改为引导「打开小宇宙 App 重新登录后点一键连接」,不再要求手抄 token。导入失败同样不会覆盖原来还能用的登录态。
102
+ - `src/xyz.js` 改为模块加载时就读取本机登录态。之前依赖宿主启动时调用 `loadXyz()`,脚本、测试或任何没调用的路径都会以空 token 发请求,一次 401 就顺手把磁盘上还能用的登录态覆盖成空——这也是「刚才还能播、过一会就失效」的成因之一;401 分支遇到内存里没有 refresh token 时也会先补读磁盘,再判断是不是真过期。
103
+ - 旧字幕不再因为文件改名/移动而丢失:单集 id 是按文件绝对路径算的,路径一变,历史字幕就变成按新 id 找不到的「孤儿」,界面上看起来像从来没有转写过。现在读不到字幕时会按标题 + 时长在 `transcripts/` 里找唯一匹配的历史字幕并认领回当前单集(原文件保留作备份,认领记录在 `claimedFrom` 字段)。多候选时放弃并写日志,不会把别的单集字幕错挂过来。
104
+ - 点侧栏文件夹只看这个文件夹里的内容:本地单集新增 `root` 字段(归属到最具体的已添加文件夹),点文件夹即筛选、再点一次取消;顶栏「全部单集 / 继续收听 / 已播完 / 小宇宙」会清掉文件夹筛选;移除文件夹时自动清除对应筛选。小宇宙等远端条目不属于任何本地文件夹,筛选时不会混进来。新增 6 个字幕认领测试,测试总数 68(65 通过、3 个 Windows 专用跳过)。
105
+
106
+ ## 0.11.18 — 2026-11-13
107
+
108
+ - 修复 API 翻译失败的核心问题:原来要等所有批次都成功才一次性落盘,中途任何一批失败会把前面已翻好的行全部丢掉。现在每 20 行一批、每批成功立刻写入字幕文件,失败时保留已完成的译文。
109
+ - 翻译失败不再静默:后端把完整错误(含 HTTP 状态码与接口返回片段)写进持久任务并打到控制台,前端能看到具体报错,不再是「翻译不了」四个字。
110
+ - 新增「部分完成」状态:字幕已有一半译文时不再假装完成。面板会显示「已翻 X/Y 行,还缺 Z 行」,并给出「补翻缺失部分」按钮,只重翻缺的行。
111
+ - 切换「中文对照 / English」不再自动发起(计费的)翻译请求,只读取后端持久状态。之前只要选一下对照语言就会自动开翻译,是重复计费的主要来源。
112
+ - 重新加载页面或切换单集后,能恢复上次的翻译错误与进度;同一集正在翻译时重复点击不会另起任务。
113
+ - API 返回缺号、格式不对、限流/5xx 都会给出明确提示,超时与限流仍保留自动重试。
114
+ - 新增 7 个翻译回归测试(全部用 mock fetch,不请求真实 API):分批落盘、失败保留、缺号检测、格式异常、状态区分、错误保留、不重复开任务。测试 50 个(47 通过、3 个 Windows 专用跳过)。
115
+
116
+ ## 0.11.17 — 2026-11-13
117
+
118
+ - 修复「任务」面板在收起侧栏的网格布局里被挤成 46px 竖条的问题:改为固定宽度的悬浮卡片,定位在顶栏右下方。
119
+ - 任务列表内部滚动,不再撑开或压扁主内容。
120
+
121
+ ## 0.11.16 — 2026-11-13
122
+
123
+ - 顶栏「任务」「选择」按钮与侧栏「添加文件夹」的 + 按钮改为白色主文字色,暗色主题下更易辨认。
124
+
125
+ ## 0.11.15 — 2026-11-13
126
+
127
+ - 修复暗色主题下进度条圆点与已播放进度不可见:`--accent` 等主题变量在暗色默认值里写成自引用(`--accent: var(--accent)`),浏览器按循环依赖丢弃,导致圆点/填充色透明。
128
+ - 一并修正 `--hover`、`--text`、`--line-soft`、`--line-strong`、`--accent-ink`、`--danger` 的暗色取值,浅色主题不受影响。
129
+ - 新增回归测试:CSS 中不得出现自定义属性自引用。
130
+
131
+ ## 0.11.14 — 2026-11-13
132
+
133
+ - 统一节目适配器架构:新增 `src/providers.js` + `src/providers/local.js` + `src/providers/xyz.js`,媒体列表、封面/音频、搜索、历史记录走同一套查找;以后新增 RSS 等来源只需加一个适配器文件。
134
+ - 小宇宙单集补齐与本地一致的待遇:播放进度持久化、字幕编辑/拆分/合并/撤销、字幕翻译、已下载单集补跑说话人分离、历史记录显示。
135
+ - 修复字幕搜索漏读 transcript 目录(补 `readdir`):本地与小宇宙台词都能搜到并跳转秒数。
136
+ - 设置页模型识别支持 `.gguf` / `.onnx`:备用模型不再被误判为未就绪。
137
+ - 适配器兜底顺序加固:显式来源优先于 local 兜底,方便后续扩展。
138
+ - 测试 42 个(39 通过、3 个 Windows 专用跳过),构建可复现。
139
+
140
+ ## 0.11.13 — 2026-11-13
141
+
142
+ - 公开播客支持粘贴单集链接(/episode/…):直接解析并播放该单集,无需先浏览整个播客。
143
+ - 单集解析复用公开页 __NEXT_DATA__,未登录可用。
144
+ - 测试 41 个(38 通过、3 个 Windows 跳过)。
145
+
146
+ ## 0.11.12 — 2026-11-13
147
+
148
+ - 播放器新增睡眠定时:15/30/45/60 分钟后自动暂停,或「本集结束」暂停;激活时按钮显示剩余时间。
149
+ - 定时菜单跟随主题样式,支持 Esc/点击外部关闭。
150
+ - 测试 40 个(37 通过、3 个 Windows 跳过),ego 实测菜单与倒计时正常。
151
+
152
+ ## 0.11.11 — 2026-11-13
153
+
154
+ - 登录框新增「从剪贴板粘贴」:复制小宇宙请求头后一键填入,不用手动裁剪。
155
+ - 单集详情新增「在浏览器打开」:跳转该单集的小宇宙网页;open-web 接口只允许 xiaoyuzhoufm.com 链接(其它域名返回 400)。
156
+ - 测试 40 个、37 通过、3 个 Windows 专用跳过。
157
+
158
+ ## 0.11.10 — 2026-11-13
159
+
160
+ - 设置页新增「版本与更新」:显示当前/最新版本,可手动检查更新(读取 npm registry,缓存 1 小时);离线或网络失败时提示但不影响使用。
161
+ - 新增 GET /api/update?force=1 接口与版本比较单元测试。
162
+ - 测试 40 个、37 通过、3 个 Windows 专用跳过。
163
+
164
+ ## 0.11.9 — 2026-11-13
165
+
166
+ - 单集详情新增「单集介绍」(shownotes):公开播客与登录单集都会带出节目简介/时间轴,默认收起、可展开;长文本自动截断渐隐。
167
+ - 修复公开单集 `shownotes` 字段可能是对象导致内容为空的问题(现在优先取字符串,否则回退 description)。
168
+ - 测试 37 个、34 通过、3 个 Windows 专用跳过;新增 docs/screenshot-notes.png。
169
+
170
+ ## 0.11.8 — 2026-11-13
171
+
172
+ - token 输入归一化:支持直接粘贴 `x-jike-refresh-token: …` 请求头、JSON(单层或 headers 嵌套)、`Bearer xxx`、纯 token;自动去引号与空白。粘贴整段请求头即可登录。
173
+ - 新增 `docs/TOKEN.md`:Chrome/Edge/Safari 取 token 的分步教程、支持格式与安全说明。
174
+ - 测试 37 个、34 通过、3 个 Windows 专用跳过。
175
+
176
+ ## 0.11.7 — 2026-11-13
177
+
178
+ - 新增宿主路由冒烟测试:用假 ctx 拉起真实 HTTP handler,覆盖小宇宙公开播客(页面解析、播放、媒体列表、跨站写拒绝)与 health/status;CI 三平台自动执行,Windows/macOS 路由层也有持续验证。
179
+ - 测试 36 个、33 通过、3 个 Windows 专用跳过。
180
+
181
+ ## 0.11.6 — 2026-11-13
182
+
183
+ - 订阅列表本地缓存 10 分钟:再次打开小宇宙面板更快、也少打接口;新增「刷新订阅」按钮强制更新。
184
+ - 状态接口返回订阅缓存时间,方便判断数据新旧。
185
+ - Windows CI 增加小宇宙工具函数可移植性冒烟(链接解析、id 转换、登录状态读取)。
186
+ - 测试 35 个、32 通过、3 个 Windows 专用跳过。
187
+
188
+ ## 0.11.5 — 2026-11-13
189
+
190
+ - token 失效处理:refresh token 与 access token 都被小宇宙判定失效时,自动清空本机 token 并提示重新粘贴,不再反复报 HTTP 401。
191
+ - 登录态失效后订阅与单集列表自动清空,避免展示过期内容。
192
+ - 新增「token 过期」单元测试;33 个测试中 31 个通过,2 个是 Windows 专用跳过。
193
+
194
+ ## 0.11.4 — 2026-11-13
195
+
196
+ - 登录更宽容:粘贴 access token 也能直接登录(refresh 失败时自动把它当 access token 验证一次)。
197
+ - 公开播客短单集完成端到端实测:212 秒单集下载约 3.4MB、转写约 53 秒、36 行字幕,说明「浏览 → 播放 → 下载并转写」全链路可用。
198
+ - 新增登录回退的单元测试;目前 32 个测试中 30 个通过,其余 2 个是 Windows 专有用例。
199
+ ## 0.11.3 — 2026-11-13
200
+
201
+ - 小宇宙登录/订阅/单集接口增加单元测试(mock 接口,Windows 与 macOS 的 CI 都会跑)。
202
+ - 公开播客遇到付费单集会明确提示,不再尝试播放。
203
+ - 小宇宙相关代码在 Windows CI 上照常通过(依赖 Node 内置 fetch,无平台专属路径)。
204
+
205
+ ## 0.11.2 — 2026-11-13
206
+
207
+ - 小宇宙新增「公开播客」:不用登录,粘贴任意小宇宙播客链接就能浏览单集、在线播放并下载转写。
208
+ - 修复从播放器点开小宇宙单集时进不了详情页的问题(详情视图优先于小宇宙面板)。
209
+ - 转写现在在「准备音频」阶段也能取消,长音频不用等切块完成。
210
+ - 新增小宇宙工具函数单元测试(链接解析、id 转换)。
211
+
212
+ ## 0.11.1 — 2026-11-13
213
+
214
+ - 小宇宙在线单集支持「下载并转写」:先把音频下载到本机 `~/.podwave/xyz-media`,再走本地 ASR 出字幕。
215
+ - 任务面板显示下载进度;下载失败可重试。
216
+ - 小宇宙音频代理与下载统一带浏览器 UA,避免 CDN 拒绝请求。
217
+
218
+ ## 0.11.0 — 2026-11-13
219
+
220
+ - 新增「小宇宙」入口:用 refresh token 登录后,可浏览订阅、查看播客单集并在线播放。
221
+ - 小宇宙音频通过插件内置的回环媒体服务代理(支持 Range),进度条可正常拖动。
222
+ - 界面对短信验证码登录做降级提示(小宇宙已要求新版客户端验证,成功率低),默认引导从网页版复制 refresh token。
223
+ - 在线单集暂不支持本地转写;后续版本补下载与转写。
224
+
225
+ ## v0.10.18
226
+
227
+ - 底部播放器的封面与标题现在可以点,直接打开当前单集的详情界面。
228
+
229
+ ## v0.10.17
230
+
231
+ - 修复浅色主题下插件根节点仍是深色底的问题(根背景改用主题变量)。
232
+ - 字幕面板、字幕行、字段说明等残余硬编码颜色改为变量,浅色下对比度正常。
233
+
234
+ ## v0.10.16
235
+
236
+ - 侧边栏收起后改成 46px 窄栏,展开按钮不再压住「全部单集」标题。
237
+ - 跟随 DSH 的亮/暗外观:采样页面背景亮度,自动切换浅色/深色配色;设置页同步适配。
238
+ - 模型/环境设置、播放器、字幕面板等界面在浅色下使用新的中性色板。
239
+
240
+ ## v0.10.15
241
+
242
+ - 播放速度改为点开菜单选择(0.5× / 0.75× / 1× / 1.25× / 1.5× / 1.75× / 2×),不再点一下循环切换。
243
+ - 菜单支持点击外部或 Esc 关闭,当前倍速高亮。
244
+
245
+ ## v0.10.14
246
+
247
+ - 桌面端音频改由插件自带的回环媒体服务提供(带 Range 支持),修复 dsh-app:// 代理下进度条拖动回起点、字幕点击不跳转的问题。
248
+ - 媒体服务只监听 127.0.0.1,路径带随机密钥,不对外网开放。
249
+
250
+ # Changelog
251
+
252
+ ## v0.10.21
253
+ - 性能:播放时界面刷新降到约 2.5 次/秒,空闲时不再每 2.5 秒请求任务列表(改 20 秒,打开任务面板时仍实时)。
254
+ - 修复:文件夹监听补上实现(之前调用了一个不存在的函数,自动刷新从未生效);有 fs.watch 时不再跑 60 秒轮询,只用轮询兜底。
255
+
256
+ ## v0.10.20
257
+ - 字幕按句子切分:分块优先切在静音处,跨块不再强制断句,句末标点优先,超长句只在逗号处或 90 字 / 15 秒才拆。
258
+ - 字幕搜索:搜索框现在会检索字幕内容,点结果直接跳到那一集并定位到该句。
259
+ - 移除单集时清理本地字幕、封面和播放进度,不再只隐藏索引。
260
+ - 文件夹自动监听:新增/删除音频后约 2 秒自动刷新;`fs.watch` 不可用时用 60 秒轮询兜底。
261
+
262
+ ## v0.10.19
263
+ - 安全:下载后校验哈希(GitHub Release 用官方 digest,HF 模型用 LFS sha256),校验失败直接丢弃。
264
+ - 安全:解压前检查压缩包条目,拒绝 `..` 与绝对路径,防止 zip-slip。
265
+ - 安装:macOS 一键安装可通过 Homebrew 自动装 ffmpeg;没有 Homebrew 时给出明确提示。
266
+ - 稳定:翻译 API 增加 120 秒超时与 3 次重试(429 / 5xx / 网络错误)。
267
+ - 兼容:engines.dsh 覆盖 0.2.2–0.2.4 的 rc 版本。
268
+ - 说明:Windows / Linux 的 SenseVoice 引擎不支持热词,设置页已注明。
269
+ - 发版恢复 npm 同步。
270
+
271
+ ## 0.10.13
272
+
273
+ - 播放进度条改成自绘的指针控件:22px 命中区、滑块常显,拖动/点击都按指针位置计算,不再依赖原生 range 的浏览器行为。
274
+ - 字幕行点击跳转保留,并支持键盘 Enter/Space;行上增加跳转提示。
275
+ - 音频元数据还没就绪时设置 currentTime 不再抛错,先记录待跳转位置。
276
+ - 进度条样式加大:4px 轨道、12px 滑块、焦点环。
277
+
278
+ ## 0.10.12 — 2026-11-13
279
+
280
+ Windows 运行时冒烟再补一环:llama.cpp 的下载、解压与可执行性。
281
+
282
+ - 新增 `test/ci/llama-check.mjs`:按平台资产从 gh-proxy 下载 llama.cpp 包,走插件自己的 extractArchive 解压,递归找到 `llama-server.exe`,执行 `--version` 并断言退出码为 0。
283
+ - 覆盖 Windows 上最容易坏的两件事:zip 解压回退链、二进制依赖是否齐全。
284
+ - 说明:GGUF 推理本身仍在 macOS 上验证;Windows 侧验证到「可启动」这一层。
285
+
286
+ ## 0.10.11 — 2026-11-13
287
+
288
+ Windows 运行时 CI 立刻抓到一个真实安装 bug:`sherpa-onnx` 在 Windows 上不会自动带 `numpy`,首次安装后转写会 `ModuleNotFoundError: numpy`。
289
+
290
+ - 安装依赖改为显式 `sherpa-onnx numpy`(macOS 仍追加 mlx 组件)。
291
+ - CI 的运行时任务同步显式安装 numpy。
292
+ - 说明:这类「安装时看不见、第一次转写才炸」的问题,正是 Windows 运行时冒烟要覆盖的。
293
+
294
+ ## 0.10.10 — 2026-11-13
295
+
296
+ Windows 运行时冒烟:CI 在 windows-latest 上真正跑一次转写。
297
+
298
+ - 新增 `windows-runtime` 任务:用插件自己的下载器(cn 线路 / hf-mirror)拉 SenseVoice int8;用 Windows SAPI 生成一段 16k 单声道英文语音;调用 `scripts/asr_sherpa_batch.py` 真实推理;校验 JSON 里的文本与 token 时间戳。
299
+ - 覆盖的不只是「逻辑能跑」,而是 Windows + Python + sherpa-onnx + 镜像下载 + 音频解码 + 推理的整条链路。
300
+ - 若镜像不可达或识别结果为空,CI 会失败,不再依赖人工在 Windows 上试。
301
+
302
+ ## 0.10.9 — 2026-11-13
303
+
304
+ Windows 冒烟用例自身修正(首版跑出来的问题都出在测试假设上)。
305
+
306
+ - `platform.key` 不存在 → 改用 `platform.isWindows`;`scan()` 组件字段是 `ready` 而不是 `ok`。
307
+ - 这两处正好证明冒烟用例有效:它在真实 Windows runner 上跑出了只在 Windows 才会暴露的断言错误。
308
+ - 本地 22 个用例:20 通过、2 个 Windows 用例跳过;Windows CI 上应为 22 全过。
309
+
310
+ ## 0.10.8 — 2026-11-13
311
+
312
+ CI 增加 Windows 冒烟用例,把「只在 Windows 会走到的路径」纳入持续验证。
313
+
314
+ - `test/windows-smoke.test.mjs`:在 windows-latest 上验证平台检测(win32、venv 用 `Scripts\python.exe`)、推荐引擎(ONNX + llama.cpp)、`scan()` 组件结构、`plan()` 的预计体积与来源,并断言计划里不出现 macOS 专用路径、不推荐 1.25bit。
315
+ - 其他平台自动跳过;同一份测试在 ubuntu / macOS 上仍跑完整套。
316
+ - 效果:Windows 上的安装前逻辑(平台/引擎/路径/体积)不再是「只在本地 Mac 上想过」,每次 push 都由真实 Windows runner 复验。
317
+
318
+ ## 0.10.7 — 2026-11-13
319
+
320
+ Windows CI 修复:三个失败用例都源于测试假设了 POSIX 家目录。
321
+
322
+ - `~/.podwave` 现在支持 `PODWAVE_DATA_DIR` 覆盖(测试、便携安装、自定义数据目录都用得上)。
323
+ - config 测试改用 `PODWAVE_DATA_DIR`,不再依赖 Windows 上无效的 `HOME`。
324
+ - library 测试在 Windows 同时设置 `USERPROFILE`,并把 `/abs` 的期望值改为 `path.resolve('/abs')`。
325
+ - 结果:test 矩阵 20/20 在 ubuntu、macOS 通过;Windows 由 CI 复验。
326
+
327
+ ## 0.10.6 — 2026-11-13
328
+
329
+ 安装后可自检,CI 覆盖三大平台。
330
+
331
+ - **检查安装**:设置页新增按钮,逐项验证 ffmpeg/ffprobe 可执行、Python 与 sherpa-onnx 可导入、MLX 组件(Apple Silicon)、llama-server 可执行、三个模型目录就绪、模型配置已写入;任何一项失败会标红并给出路径或原因。
332
+ - **接口**:`GET /api/setup/verify` 返回平台、引擎与 `checks[]`,便于 Windows 用户装完后直接确认。
333
+ - **CI 矩阵**:测试任务在 ubuntu / windows / macos 三个 runner 上跑,Windows 路径与资产逻辑进入持续验证;构建任务仍在 ubuntu。
334
+ - 说明:Windows 真机功能验证仍需人工按 `docs/windows-test.md` 走一遍。
335
+
336
+ ## 0.10.5 — 2026-11-13
337
+
338
+ 国内线路修正:hf-mirror 的 API 实际会 302 到 huggingface.co,国内直连取不到文件列表。
339
+
340
+ - **cn 线路不再依赖 HF API**:为 Qwen3-ASR 与 Hy-MT2-4bit 增加固定文件清单,国内下载直接用 `hf-mirror.com` 的 `resolve` 地址逐个文件 HEAD + 下载;国际线路仍走 API,失败时同样回退到固定清单。
341
+ - **空清单报错**:没有配置固定清单、API 又不可用时,明确报错而不是静默失败。
342
+ - 实测:经 hf-mirror 下载 SenseVoice 的 `tokens.txt` 成功(315,894 字节),确认 cn 链路可用。
343
+ - 说明:HEAD 在镜像上可能拿不到 content-length,进度总量仍以安装计划的估算值为准。
344
+
345
+ ## 0.10.4 — 2026-11-13
346
+
347
+ 安装计划预览与国内镜像修正。
348
+
349
+ - **先看后装**:设置页新增「将下载」清单,列出每个组件的体积与可用线路,总计一目了然;接口 `GET /api/setup/plan?source=auto|intl|cn`。
350
+ - **ModelScope 修正**:Hy-MT2 的魔搭仓库改为 `Tencent-Hunyuan/...`(Q4 实测 1.13GB 可访问);SenseVoice 的 `iic/SenseVoiceSmall` 不含 sherpa-onnx 文件,已移除该无效镜像,国内统一走 hf-mirror。
351
+ - **单文件模型修复**:hf-file 类型走 ModelScope 时之前会把整个仓库都拉下来,现在只下载目标 `.gguf`。
352
+ - **下载防护**:镜像返回空文件列表时报错并提示换线路,不再静默成功。
353
+ - **体积校准**:Hy-MT2 2bit 601MB、Q4_K_M 1.13GB,计划与扫描的数字与真实文件一致。
354
+ - 引擎标签在缺少 osLabel 时增加回退,避免设置页出现「推荐:undefined」。
355
+
356
+ ## 0.10.3 — 2026-11-13
357
+
358
+ Windows 安装链路继续补齐,并增加可复制的诊断信息。
359
+
360
+ - **uv 安装修复**:Windows 上 uv 发布包是 `.zip` 而不是 `.tar.gz`,之前按 tar.gz 下载会在 Windows 直接失败;现在按平台选择扩展名,并在「自动」线路下依次尝试国际与 gh-proxy 两条线。
361
+ - **诊断接口**:新增 `GET /api/setup/diagnose`,返回平台、推荐引擎、ffmpeg/Python/llama 路径、组件扫描结果与最近一次安装摘要;设置页加「复制诊断信息」按钮,一键复制 JSON,方便远程排查 Windows 问题。
362
+ - **Windows 验收清单**:新增 `docs/windows-test.md`,列出安装、转写、翻译、说话人、拖拽导入的逐项检查与预期结果。
363
+ - 说明:Windows 真机仍未验证;本版修掉了会导致安装立即失败的 uv 扩展名问题。
364
+
365
+ ## 0.10.2 — 2026-11-12
366
+
367
+ - **修正模型推荐**:Hy-MT2 的 1.25bit 是腾讯自定义量化,主线 llama.cpp 无法加载;Windows / Linux 最低改为推荐 2bit(572 MB),24 GB 以上内存推荐 Q4_K_M(1.1 GB)。macOS 仍推荐 MLX 4bit。
368
+ - 新增回归测试:低内存非 MLX 机器不会选中 1.25bit。
369
+
370
+ ## 0.10.1 — 2026-11-12
371
+
372
+ Windows 安装链路补齐:ffmpeg、选择器与解压回退。
373
+
374
+ - **ffmpeg 自动安装**:Windows / Linux 缺少 ffmpeg 时,安装中心会下载 BtbN 静态构建(Windows 约 202 MB,Linux 约 157 MB)并解压到 `~/.podwave/runtime/ffmpeg`;macOS 仍优先使用 Homebrew,不重复下载。
375
+ - **平台路径**:转写与说话人分离不再写死 `/opt/homebrew/bin/ffmpeg`,统一用平台探测(环境变量 → PATH → 插件 runtime 目录);Windows 虚拟环境走 `Scripts\python.exe`。
376
+ - **文件夹选择器**:macOS 用 osascript,Windows 用 PowerShell 的 FolderBrowserDialog,Linux 用 zenity;取消与找不到选择器都有明确提示。
377
+ - **解压回退**:zip 依次尝试 `unzip` → Windows `tar` → PowerShell `Expand-Archive` → Python `zipfile`,避免 Windows 上没有 unzip 时安装失败。
378
+ - **测试**:新增平台与资产测试(win32/darwin/linux 的 llama.cpp 与 ffmpeg 资产、虚拟环境路径),共 17 个用例。
379
+ - Windows 真机验证仍待进行;当前 macOS 安装与转写链路回归通过。
380
+
381
+ ## 0.10.0 — 2026-11-12
382
+
383
+ 环境与模型安装中心:换电脑或换系统时,先扫描再一键装。
384
+
385
+ - **本机扫描**:设置页新增「环境与模型」卡片,显示系统、架构、内存、GPU、ffmpeg、Python 运行时、llama.cpp 与各模型的就绪状态,并给出推荐引擎与预计下载体积。
386
+ - **自动选型**:Apple Silicon 用 MLX(Qwen3-ASR-1.7B-8bit + Hy-MT2-1.8B-4bit);Windows / Linux / Intel Mac 用 sherpa-onnx(SenseVoiceSmall)+ llama.cpp(Hy-MT2-1.8B-Q4_K_M)。
387
+ - **双源下载**:国际(Hugging Face / GitHub)与国内(hf-mirror / gh-proxy / ModelScope)两条线路,可自动测速或手动指定;下载支持断点续传。
388
+ - **一键安装**:自动准备 uv + Python 虚拟环境、sherpa-onnx(MLX 平台加 mlx-qwen3-asr / mlx-lm)、llama.cpp 预编译包与缺失模型,完成后列出每项下载内容与体积。
389
+ - **跨平台引擎**:新增 SenseVoice 转写与 llama.cpp 翻译适配;ffmpeg、虚拟环境路径、文件夹选择器按平台探测(macOS 用 osascript,Windows 用 PowerShell)。
390
+ - **说明**:Hy-MT2 1.25bit 是自定义量化,主线 llama.cpp 加载失败,因此非 MLX 平台默认 Q4_K_M(约 1.1 GB)。
391
+ - 已知限制:Windows / Linux 尚未在真机验证;安装进度与引擎切换先以 macOS 实测为准。
392
+
393
+ ## 0.9.1 — 2026-11-12
394
+
395
+ 本地翻译换成小模型 Hy-MT2-1.8B,旧的 8B 已删除。
396
+
397
+ - **本地翻译模型**:默认从 Qwen3-8B-4bit(4.3 GB)改为腾讯混元 Hy-MT2-1.8B-4bit(974 MB,Apache-2.0,33 语);磁盘上的旧模型已删除。
398
+ - **速度**:4 行英文实测 3.0 秒(含加载),单行约 0.2 秒;15 行一批的编号提示词保持不变。
399
+ - **模型选择**:设置页只列出真正就绪的模型,未下载完或目录里没有权重的条目不再出现在下拉框。
400
+ - **配置**:默认 `models.translateModel` 同步改为 `hy-mt2-1.8b-4bit`,已有配置会被保留并可直接切换。
401
+
402
+ ## 0.9.0 — 2026-11-12
403
+
404
+ 实时字幕预览:转写过程中按块出字,不用等整集。
405
+
406
+ - **分块转写改为单进程顺序处理**:所有音频块交给同一个 CLI 进程,模型只加载一次;每完成一块就合并进字幕草稿,面板顶部显示「已出 N 行」。
407
+ - **默认 1 分钟一块**:M4 Air 实测 5.5 分钟音频约 12 秒出第一批行,之后每 15–20 秒追加一批;可在设置里调到 10–20 分钟换取更少切块。
408
+ - **运行中的进度条**:百分比、第 n/total 块、已出行数、取消按钮;说话人分离阶段显示「正在分离说话人…」。
409
+ - **增量字幕可交互**:转写中打开详情页就能滚动、点击跳转、导出(导出的是当前已出的行);刷新或重开面板会接着显示。
410
+ - **旧字幕保护**:重转期间旧字幕备份为 `<id>.json.previous`,取消或失败自动还原。
411
+ - 修复:拆分后的 Cover / TranscriptPanel 缺少 API 常量,详情页(有封面或有字幕时)会白屏。
412
+ - 修复:同一集已有任务在跑时再点转写,错误返回「已完成」;现在优先返回运行状态。
413
+
414
+ ## 0.8.0 — 2026-11-12
415
+
416
+ P6:工程化(拆分前端、单元测试、发布脚本、CI)。
417
+
418
+ - **前端拆分**:Icon / Cover / TranscriptPanel 拆到 `client/src/components/`,格式化与任务文案拆到 `client/src/lib/`;App.jsx 从 1466 行降到约 1340 行。
419
+ - **单元测试**:`npm test`(node:test)覆盖格式化、旧字幕迁移与 SRT/Markdown 导出、配置迁移与持久化、episodeId 与音频扩展名,共 12 个用例。
420
+ - **发布脚本**:`node scripts/release.mjs <version>` 自动改版本号(package.json / host health / 界面 brand)、跑测试与构建、打包 tgz、提交、打 tag、推送并创建 GitHub Release(说明取自 CHANGELOG)。
421
+ - **CI**:GitHub Actions 增加 test job(npm ci + npm test),与 build job 并行。
422
+
423
+ ## 0.7.0 — 2026-11-12
424
+
425
+ P4:媒体库管理(收藏、筛选、移除索引、导入策略、重复检测、清理)。
426
+
427
+ - **收藏**:列表每行右侧 ★,点一下收藏/取消;筛选条新增「收藏」。
428
+ - **筛选**:全部 / 未听 / 有字幕 / 收藏;和左侧「全部单集 / 继续收听 / 已播完」叠加生效。
429
+ - **移除索引**:单集详情页「从播放器移除」或批量栏「移除选中」——只从媒体库隐藏该集,不动源文件。
430
+ - **导入策略**:设置 → 播客 → 导入与清理,可选「复制到 imports/」(默认,拖拽与路径导入都复制)或「原地引用」(只引用文件所在目录)。
431
+ - **重复检测**:路径导入时按真实路径、文件名 + 大小去重,重复项跳过并在返回的 `skipped` 里标注。
432
+ - **孤儿清理**:删掉导入文件夹后,`imports/` 下不再被引用的批次可在设置页一键清理(显示批次与占用体积)。
433
+ - 新接口:`PUT /api/episodes/:id/favorite`、`DELETE /api/episodes/:id`(仅隐藏索引)、`GET/PUT /api/import/settings`、`GET/DELETE /api/imports/orphans`;`health` 版本 0.7.0。
434
+ - 新截图:`docs/screenshot-library.png`。
435
+
436
+ ## 0.6.0 — 2026-11-12
437
+
438
+ P3:说话人分离(自动识别 + 彩色标签)。
439
+
440
+ - 新增本地说话人分离:sherpa-onnx(pyannote segmentation + 3D-Speaker 声纹),完全离线,不需要 HF token。
441
+ - 转写完成后自动把说话人分配到字幕行(按时间重叠投票),同一说话人颜色一致;字幕头部显示「N 位说话人」。
442
+ - 设置 → 播客 → 转写新增「自动识别说话人」开关;分离失败不影响转写结果。
443
+ - 新接口:`POST /api/episodes/:id/diarize`(对已有字幕补跑说话人);`transcribe/settings` 支持 `diarize`;`health` 版本 0.6.0 返回 diarize 就绪状态。
444
+ - 运行时新增依赖 `sherpa-onnx`;模型放 `~/.podwave/models/diarization/`(约 34MB,下载命令见 README)。
445
+ - 新截图:`docs/screenshot-speakers.png`。
446
+
447
+ ## 0.5.0 — 2026-11-12
448
+
449
+ P2:字幕编辑(改文本、拆分/合并、撤销、导出前校验)。
450
+
451
+ - 行内编辑:字幕面板每一行悬停出现 ✎,点开就地改文本;⌘/Ctrl+Enter 保存、Esc 取消。改过文本的行会清空旧译文,避免译文和原文对不上。
452
+ - 拆分与合并:编辑时按光标位置「拆分」成两行(时间戳按字符比例分配);行尾 ⇣ 与下一行合并(英文之间自动补空格,译文一起合并)。
453
+ - 撤销:字幕面板右上「撤销」,每个单集保留最近 20 步修改(服务端内存栈,重启后清空)。
454
+ - 校验:导出前「校验」检查空行、无效时间戳、行间时间重叠;面板顶部列出问题。
455
+ - 新接口:`PUT /api/episodes/:id/transcript/lines/:lineId`、`POST .../lines/:lineId/split`、`POST .../lines/:lineId/merge`、`POST .../transcript/undo`、`GET .../transcript/validate`;`health` 版本 0.5.0。
456
+ - 新截图:`docs/screenshot-editing.png`。
457
+
458
+ ## 0.4.0 — 2026-11-12
459
+
460
+ P1:转写体验(任务面板、进度、取消/续跑、批量、热词)。
461
+
462
+ - 新增任务面板:队列、阶段(准备 / 转写 / 合并)、百分比、分块进度与耗时;支持取消、重试、清除;2.5 秒自动刷新。
463
+ - 进度与分块:长音频按 `chunkMinutes`(默认 15 分钟)用 ffmpeg 切块,逐块转写后合并时间戳;块级结果落盘。
464
+ - 取消与续跑:详情页或任务面板可取消;再次启动时从已完成块继续,失败只重跑当前块。
465
+ - 批量转写:列表页「选择」进入多选,批量排队;已有字幕的单集自动跳过。
466
+ - 热词:设置 → 播客 → 转写,热词表会作为 `--context` 传给模型;分块时长可调(1–60 分钟)。
467
+ - 新接口:`POST /api/episodes/:id/transcribe/cancel`、`POST /api/transcribe/batch`、`GET/PUT /api/transcribe/settings`、`DELETE /api/jobs`;`health` 版本 0.4.0。
468
+
469
+ ## 0.3.0 — 2026-11-12
470
+
471
+ P0:把配置、任务、字幕数据收成一套骨架(详见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md))。
472
+
473
+ - 新增统一配置 `~/.podwave/config.json`(`ui` / `translate` / `models` / `transcribe` 四个分节);首次启动自动把旧的 `ui.json`、`translate.json`、`models.json` 迁入并改名为 `*.bak`。
474
+ - 新增 `~/.podwave/jobs.json`:转写、翻译任务落盘;进程重启后未完成的任务标为 `interrupted`(“进程重启,任务已中断”),不再静默丢失。
475
+ - transcript 升级为 v2:`lines[]`(行级时间戳 + 每行译文 `line.translations`)与 `providers{}`(每个目标语言的翻译来源);旧格式首次读取/启动时自动迁移,原文件保留为 `<id>.json.v1.bak`。
476
+ - 字幕面板改为按行渲染译文;设置页历史列表改为按行数/已翻译行显示。
477
+ - 新增 `GET /api/jobs`,供后续任务面板使用。
478
+ - `health` 版本号改为 0.3.0。
479
+
480
+ ## 0.2.9 — 2026-11-12
481
+
482
+ - 「添加文件夹」支持系统文件夹选择器(macOS 原生对话框);保留手动输入路径。
483
+ - 支持把音频文件直接拖进面板:读取路径(可用时)或上传到 `~/.podwave/imports/` 后自动加入媒体库。
484
+
485
+ ## 0.2.8 — 2026-11-12
486
+
487
+ - 播客自己的左侧栏可收起 / 展开,并记住状态;窄面板自动隐藏侧栏,详情页改为上下堆叠。
488
+
489
+ ## 0.2.7 — 2026-11-12
490
+
491
+ - 设置页配色对齐 DSH 内置设置(透明背景、细分隔线、中性色),去掉琥珀强调。
492
+
493
+ ## 0.2.6 — 2026-11-12
494
+
495
+ - 设置页「界面」分组:可以开关主界面侧栏的「播客」入口。
496
+
497
+ ## 0.2.5 — 2026-11-12
498
+
499
+ - 新增设置页(`settings.section`):历史记录、DeepSeek API 配置、ASR / 翻译模型选择。
500
+
501
+ ## 0.2.4 — 2026-11-12
502
+
503
+ - 单集详情页:点播客行进入,左侧大封面,右侧并排字幕。
504
+
505
+ ## 0.2.3 — 2026-11-12
506
+
507
+ - 转写(Qwen3-ASR-1.7B-8bit,MLX)、双语字幕、SRT / Markdown 导出。
508
+ - 字幕翻译支持 DeepSeek API 与本地 Qwen3-8B-4bit。
509
+
510
+ ## 0.2.0–0.2.2 — 2026-11-12
511
+
512
+ - 转写任务、字幕面板、翻译设置的迭代版本。
513
+
514
+ ## 0.1.0 — 2026-11-12
515
+
516
+ - 首个版本:DSH 插件形态的本地播客播放器(媒体库、播放进度、续播)。