我想把 Vox 做成一个自己愿意用、也能讲清楚技术取舍的项目。VPS 负责接收请求,家里的 Mac 或其他计算设备负责干重活。转写出来的内容还能查词、看总结、回放原文。
这组笔记按 2026 年 9 月 17 日的本地工作区整理,包含未提交修改。代码里有什么、设计上准备做什么、线上是否验证过,是三件不同的事。 第 01 篇记录现状,其余是准备实施的方案,不是完工报告。
要解决什么
我不缺可以加的功能,缺的是一条能走通的实施顺序。每次同时改数据库、队列和模型,出了问题很难知道是哪一层错了。
有哪些走法
一种是先堆功能,词汇、翻译、总结一起接上。另一种是先造通用工作流平台。我选第三种:保留现在能跑的流程,每轮只解决一个具体问题,并留下验证记录。
按什么顺序做
| 顺序 | 文章 | 做完应留下什么 |
|---|---|---|
| 01 | 现有代码到底做了什么 | 一次真实任务的完整记录 |
| 02 | VPS 和边缘机器怎么分工 | 两台机器跑通同一个任务 |
| 03 | 任务为什么需要拆成步骤 | 步骤状态和产物约定 |
| 04 | 任务入库了,消息没发出去怎么办 | 可恢复的消息投递 |
| 05 | 机器断网后,谁能提交结果 | 租约、重试、过期结果验证 |
| 06 | 快机器怎样多干活 | 两种性能节点的分配记录 |
| 07 | 文件怎样到达边缘节点 | 可续期的文件访问与产物追踪 |
| 08 | 用 ECDICT 做词汇标注 | 能回到原句的词表 |
| 09 | 词典释义和句子翻译怎么分开 | 按需翻译与缓存 |
| 10 | 总结怎样让人核对 | 带原文引用的总结 |
| 11 | 一个任务慢在哪儿 | 能定位问题的时间记录 |
| 12 | 怎么证明边缘计算值得做 | 可复现实验与原始数据 |
| 13 | 怎样交付一个别人能跑的项目 | 启动说明、测试、演示 |
阅读按表走,实际动手可以穿插:先完成 01 的现状检查,再做 02 的最小部署;从第一轮就记录 11、12 里的基础耗时。03—07 是可靠性主线,08—10 是产品主线。
每轮怎么收尾
先写一句本轮要解决的问题,做一个最小改动,再制造一次失败。记录输入、操作、实际结果和没解决的限制。通过本篇的验收后再往下走。
不用把全部文章一次实现。第一轮只拿一段音频,从浏览器一直追到对象存储里的转写结果。看不懂的字段就在这条链上查,不急着加新服务。
本组文件按独立文章准备了固定路径和互相跳转的链接;本地创建文件不等于已经发布到网站。