从"收藏吃灰"到知识沉淀：用 Codex 手搓笔记工作台项目

1. 这是什么项目

简单来说，

是一个专注于个人学习、研究和知识管理的本地内容处理工具。它不是什么颠覆性的平台，更像是一个“内容消化流水线”。

它处理的对象很明确：B站和抖音上的视频、本地的课程录像和录音，以及PDF、Word、PowerPoint这些常见文档。资料丢进去之后，会自动走完一套流程：转录（如果是音视频）或解析（如果是文档）、原文归档、生成结构化笔记，最后经过质量审核，写入飞书。

之所以这么折腾，是因为一个很直接的痛点：获取视频、录音和文档本身并不难，难的是怎么让这些内容真正“留下来”——变成以后能找得到、能核对、能继续用的东西，而不是收藏夹里吃灰的链接。

需要说明的是，这目前是一个面向个人的本地工具MVP，不是那种多人协作的生产级平台。它不替人做事实判断，但能把那些重复、耗时的整理步骤，收进一条可追溯、可回顾的流程里。

工作台页面，支持四大场景输入

支持配置笔记内容生成提示词

支持所有转化记录查询与原文下载，记录闭环跟踪

支持预览平台操作手册

2. 它适合用在哪些场景

如果你经常遇到下面这些情况，那么“先收藏，等有空再整理”这个老办法，可能真的不如这个工具来得实在。

你手上的资料	常见卡点	工作台如何处理
一段教程、访谈或公开课视频	看完只记住个大概，想回找重点时又得从头再看一遍	提取音频并转录，保留原文，再生成带结论、方法步骤和复习问题的学习笔记
本地课程录像、讲座回放或屏幕录制	文件大、内容长，手动整理太费时间，容易放弃	上传后处理音频与转录稿，整理为可回看的飞书笔记，并关联后续待办事项
录音、访谈或会议音频	关键结论和行动项都散落在语音里，事后很难追踪	将音频转为文本，按学习笔记或会议纪要模板整理，并保留原始来源依据
PDF、报告、课件和培训资料	文件一堆，内容容易混，后来想不起某个观点到底出自哪份资料	解析文档并保留来源文件边界，支持多文件融合整理，方便回溯和复核

3. 一次资料处理，会经历这 6 步

1. **提交资料。** 粘贴一个B站或抖音链接，或者直接上传本地视频、录音、PDF、Word、PowerPoint文件。
2. **检查与提取。** 系统会先检查本机依赖环境，并识别资料类型。视频和录音会进入音频处理流程，文档则进行解析。
3. **保留原文。** 转录稿或者文档解析结果会先被完整归档。这一步很重要，它保证了后续生成的每一条结论，都有个可以回看的“原文入口”。
4. **生成结构化笔记。** 系统会按照你已发布的笔记模板，自动整理出核心结论、知识结构、方法步骤、行动清单和复习问题。
5. **做一次质量审核。** 系统会强制要求生成结果必须基于原文。对于内容不足或无法确认的部分，必须保留，留待人工核验。
6. **归档并继续跟进。** 处理完成后，笔记会写入飞书，同时记录转换历史，并可以关联到待处理事项，确保后续行动不会脱节。

这条流程看起来并不复杂，但它精准地解决了最常遇到的“断点”：资料看完了，内容却仿佛没留下；即使留下了，也说不清结论到底来自哪里。

4. 我为什么会做这个项目

有一段时间，我一直被一个问题困扰：学习资料越积越多，但真正沉淀下来、能被自己复用的东西却少得可怜。

B站收藏夹里堆满了各类课程、访谈和教程。听完一段录音，当下觉得很有启发，过几天却很难清晰地复述出重点。工作中看到一份不错的报告，保存下来后，大概率再也不会打开。

问题不在于资料本身没价值，而在于把它们整理成“以后还能用”的状态，成本实在太高了。

手工整理的流程大家都很熟悉：看资料、记重点、回找原文、补充背景、写笔记、归档，再把待办记到另一个地方。每一步单独看都不难，但连在一起，就很容易让人产生拖延症。

后来我意识到，我不缺一个能把内容写得更长的编辑工具。我缺的是一条顺畅的“处理路径”：一段课程视频，最终不应该只留下一段模糊的记忆，而应该产出一套可追溯的成果——有原文、有笔记，还有后续行动的提醒。

于是，这个项目从“视频转学习笔记”这个起点开始。后来逐步支持了本地视频、录音和常见文档，但主线始终没变：

5. 当前已经实现的能力

目前，工作台支持以下这些资料类型和处理方式：

资料类型	处理方式	主要产出
平台视频	下载音频、本地转录、整理	原文归档、学习笔记、待办
本地视频与录音	提取音频、本地转录、整理	原文归档、学习笔记、待办
PDF、Word、PowerPoint	文档解析、来源识别、整理	原文归档、学习笔记、待办

处理完成后，你可以在飞书中直接打开原文和学习笔记；也可以在转换历史中，查看每条资料的来源、任务状态、当时使用的提示词快照和处理结果。

对于新生成的笔记，系统还可以自动关联当天的飞书待处理事项，避免笔记生成后又沉到角落里，被遗忘。

6. 我没有把它做成"自动写一篇完整总结"

最开始，最省事的方案其实很简单：把视频或文档丢给模型，让它生成一篇看起来“完整”的总结。

但很快发现，这条路不太对。模型很容易把几句话扩写成“方法论”，也可能为了凑结构，凭空补出资料里没有的案例。读的时候感觉挺好，但真正要复习或引用时，就会出大问题。

所以，我把重心放在了下面这三件事上。

1. **原文要留住。** 视频和录音会保留完整的转录稿；文档处理时会记录来源文件、文件边界和解析质量。多份文件一起处理时，也尽量不让内容来源混在一起。
2. **提示词要有版本。** 项目提供了“学习笔记”和“会议纪要”两类模板。模板修改后需要明确发布才能生效，每次任务都会记录实际使用的提示词快照，方便以后解释旧笔记为什么会采用某种结构。
3. **不知道的内容要承认不知道。** 资料里没有讲到的部分，绝对不会为了凑齐结构而硬写出来。扫描PDF、专业术语、数字和代码，这些都需要人工复核。

7. 项目是在问题里慢慢长出来的

B站会遇到HTTP 412错误，抖音又有分享短链、网页链接和登录状态失效等不同情况。早期如果把这些都简单地归为“下载失败”，用户根本不知道该从哪里排查。

后来，我把链接归一化、平台识别和登录态提示这三个环节拆开处理。系统会优先尝试匿名下载；确有需要时，用户可以选择从本机浏览器读取Cookie，项目本身不会保存Cookie。

这个调整让我明白，链接格式、内容访问权限和下载工具故障，其实是三个不同层面的问题，错误提示也应该分开说清楚。

本地课程录像往往体积很大。上传时如果没有进度提示，用户很容易以为页面卡死了。项目后来增加了分片上传、字节级进度提示和本机环境检查。

这些功能看起来不算起眼，但它们决定了一个工具到底能不能被用户耐心地使用下去。

第一版模板追求章节齐全，结果把课程介绍、福利信息和一些空泛的补充说明也塞进了正文。

后来，我保留了“知识总览、核心结论、方法步骤、易错点、行动清单和复习问题”这几个核心模块，同时把边界写得更明确：原文没有展开的部分，就明确标注“本视频未展开”。

这不会让AI的输出自动变成可靠的事实，但能有效减少“看起来完整，实际不可靠”的内容。

8. 当前成果与边界

目前，项目已经具备了多媒体资料处理、多文件文档融合、原文归档、提示词版本管理、质量审核、知识框架图、转换历史和飞书待办关联等能力。

在代码层面，现有13个测试套件、52个测试已通过，TypeScript类型检查和静态检查也已通过。

这表明相关输入校验、工具函数和部分流程逻辑通过了当前的断言；

需要同时说明的是，当前任务状态保存在服务内存中，服务重启后不能恢复；没有任务队列、阶段重试和完整的并发控制。长视频和大文件需要较长的处理时间。

飞书能力依赖当前机器的登录身份，AI输出、转录质量和解析结果仍然需要人工核对。

9. 这次实践留给我的几点认识

1. **先把来源留住，再谈生成质量。** 如果最后只剩一篇笔记，很多问题都无法回答。保留原文、来源文件、提示词版本和处理记录后，内容才有复盘的可能。
2. **自动化不等于替代判断。** 转录、归档和整理这些重复动作很适合交给工具。但事实核验、引用判断和后续行动，仍然应该由人来完成。
3. **先做一个真实能用的闭环。** 没有一开始就追求大而全，而是先让资料能进入、笔记能生成、原文能回看、待办能继续跟。这个闭环跑顺了，再去扩展其他能力才有意义。
4. **把限制写出来，项目才更好维护。** 任务不支持重启恢复、外部依赖需要本机环境、复杂资料可能需要人工复核——这些边界条件，都不该藏在文档的角落里。

10. 接下来准备做什么

下一步，会继续补充真实资料的端到端验收，完善任务历史、失败原因记录和重试能力，也会改进文档解析与图片处理。

自动化程度会继续提高，但人工核验这一层，还是会保留下来。

Media Notes Workbench现在还不算是一个成熟的内容平台。它更像是我为自己搭的一张工作台：把散落在视频、录音和文档里的内容，放进一条能回看、能检查、能继续往下做的路径里。

对我来说，这已经很有价值了。