把技术长文改写成小红书笔记，我用 435 行 Python 写了个离线工具

一篇几千字的技术实测文，直接发小红书没人看。把 Markdown 技术文自动改写成笔记体草稿：自动起标题、抽标签、生成封面文案，还带违禁词自检。18 个测试全绿，转一篇 287 行的文章只要 2 毫秒出头。

为什么要做这个工具

• 技术文和小红书笔记是两种文体：前者讲推导，后者讲结论和坑
• 直接搬运没人看，手动改写又慢，还容易踩平台的标题、标签、外链规则
• 我想要一个可重复、可离线、不依赖大模型的实现，结果要能复现

工具长什么样

• 单文件 note_forge.py，435 行，零第三方依赖，Python 3.8 以上直接跑
• 输入一篇 Markdown 技术文，输出小红书笔记草稿：标题候选、正文、标签、封面文案
• 核心函数 forge(source) 是纯函数，没有随机源，同一篇输入永远得到同一篇输出

它具体做对了几件事

• 标题：从二级标题、关键结论句、文档标题里挑素材，截到 20 字以内，一次给多个候选
• 标签：自带一个小领域词表（前端、Redis、MySQL、Git、Node、Python 等），命中就扩成平台标签，兜底也有
• 正文：把原文的关键结论句和坑位句抽出来，重排成短段落；代码块、表格行、URL 都不当成数据句
• 封面文案：取最扎眼的那条结论，截 12 字

实测数字（当天重跑）

• 源码 435 行，零第三方依赖
• 18 个 unittest 用例，全部通过，单次运行 0.032 秒
• 拿一篇 287 行、7080 字的技术实测文做样例：连续转换 50 次，中位耗时 2.358 毫秒，最快 1.781，最慢 3.009
• forge 是确定性函数，所以结果可复现，测试里也专门有确定性断言

自带的检查清单

• 绝对化用词（最好、最强、唯一、100%）会被标出来，但技术语境里的「唯一 ID」这类不算
• 正文里的 URL 会标出来，方便你决定要不要去掉外链
• 正文超长（默认上限 1000 字）会提醒，毕竟笔记不是论文

怎么用

python note_forge.py 你的技术文.md -o 笔记草稿.md

• 不传 -o 就打印到终端
• --json 还能拿到结构化结果
• 全程纯标准库，断网也能跑

一点体会

• 改写不是删内容，是把结论和坑提前，让读者三秒决定要不要看
• 标题和标签尽量贴平台已有词表，比自造词更容易被搜到
• 工具只负责出草稿，最终语气和配图还是人定，别全交给机器