我想把 Vox 做成一个自己愿意用、也能讲清楚技术取舍的项目。VPS 负责接收请求,家里的 Mac 或其他计算设备负责干重活。转写出来的内容还能查词、看总结、回放原文。

这组笔记按 2026 年 9 月 17 日的本地工作区整理,包含未提交修改。代码里有什么、设计上准备做什么、线上是否验证过,是三件不同的事。 第 01 篇记录现状,其余是准备实施的方案,不是完工报告。

要解决什么

我不缺可以加的功能,缺的是一条能走通的实施顺序。每次同时改数据库、队列和模型,出了问题很难知道是哪一层错了。

有哪些走法

一种是先堆功能,词汇、翻译、总结一起接上。另一种是先造通用工作流平台。我选第三种:保留现在能跑的流程,每轮只解决一个具体问题,并留下验证记录。

按什么顺序做

顺序文章做完应留下什么
01现有代码到底做了什么一次真实任务的完整记录
02VPS 和边缘机器怎么分工两台机器跑通同一个任务
03任务为什么需要拆成步骤步骤状态和产物约定
04任务入库了,消息没发出去怎么办可恢复的消息投递
05机器断网后,谁能提交结果租约、重试、过期结果验证
06快机器怎样多干活两种性能节点的分配记录
07文件怎样到达边缘节点可续期的文件访问与产物追踪
08用 ECDICT 做词汇标注能回到原句的词表
09词典释义和句子翻译怎么分开按需翻译与缓存
10总结怎样让人核对带原文引用的总结
11一个任务慢在哪儿能定位问题的时间记录
12怎么证明边缘计算值得做可复现实验与原始数据
13怎样交付一个别人能跑的项目启动说明、测试、演示

阅读按表走,实际动手可以穿插:先完成 01 的现状检查,再做 02 的最小部署;从第一轮就记录 11、12 里的基础耗时。03—07 是可靠性主线,08—10 是产品主线。

每轮怎么收尾

先写一句本轮要解决的问题,做一个最小改动,再制造一次失败。记录输入、操作、实际结果和没解决的限制。通过本篇的验收后再往下走。

不用把全部文章一次实现。第一轮只拿一段音频,从浏览器一直追到对象存储里的转写结果。看不懂的字段就在这条链上查,不急着加新服务。

本组文件按独立文章准备了固定路径和互相跳转的链接;本地创建文件不等于已经发布到网站。