跳转到主内容
全部文档

编排:一条命令跑完多步

很多活儿要好几步:外文 PDF 想读中文,得先转成 Markdown,再翻译;一段会议录音,得先转写,再整理成纪要。每一步都有现成命令,但一条条敲,还要记住上一步的产物叫什么。

编排(recipe)把这样一套固定流程写成一份清单,一条命令从头跑完:

bash
42md recipe run pdf2zh 论文.pdf

这一条等于先转换、再翻译,最后把中文 Markdown 放到当前目录。

有哪些现成的编排

先看看手边有什么:

bash
42md recipe list

内置的这几条装好就能用:

名称做什么计费
pdf2bookPDF → 干净的 EPUB 电子书免费
notes2pdf一个目录的零散 Markdown 笔记 → 合并成一份 PDF 讲义免费
doc2wechatWord / PDF → 公众号排版 HTML免费
pdf2zh外文 PDF → 中文 Markdown 速读含计费步骤
pdf2digest外文论文 → 中文要点摘要(原文、译文、摘要都留下)含计费步骤
web2zh外文网页正文 → 中文 Markdown 笔记含计费步骤
audio2notes录音 / 播客 → 转写稿 + 精修录音稿 + 会议纪要含计费步骤
audio2safe-notes录音 → 转写 → 本地脱敏 → 版式清洗含计费步骤

你自己写的、在网页上存的编排也会出现在这个列表里。

跑之前看一眼

想知道某条编排分几步、哪一步花钱、能传什么参数:

bash
42md recipe info pdf2digest

常见用法

免费的编排全程在本机跑,不花点数:

bash
42md recipe run pdf2book 报告.pdf42md recipe run notes2pdf 笔记目录/42md recipe run doc2wechat 稿子.docx

翻译类编排默认译成中文,用 --set 换目标语言:

bash
42md recipe run pdf2zh 论文.pdf --set lang=English42md recipe run web2zh https://example.com/article

录音出纪要:

bash
42md recipe run audio2notes 会议录音.m4a

隐私敏感的录音,先准备一份映射表(真名 → 代号),再跑带脱敏的版本。映射表写绝对路径或 ~/ 开头的路径:

bash
42md recipe run audio2safe-notes 会议录音.m4a --set map=~/脱敏映射表.md

脱敏的写法见 。

产物放在哪

  • 默认把最后一步的产物放到当前目录;用 -o 指定路径。那个位置已经有文件或文件夹时会停下,不覆盖:

    bash
    42md recipe run pdf2book 报告.pdf -o 报告.epub
  • 只想指定放进哪个文件夹、名字照默认的取,用 --output-dir。文件夹里已有同名的,新产物另起一个名字,原来的不动:

    bash
    42md recipe run pdf2book 报告.pdf --output-dir ~/Desktop
  • 产物带图片时,会整理成一个目录交给你,图片和正文放在一起。

  • pdf2digest、audio2notes 这类每一步都值得留的编排,会把全部产物放进一个 _output/<时间戳>/ 目录。

  • 你的原文件不会被改动,编排在临时目录里处理副本。

计费

  • 免费编排:全部在本机完成,免费。

  • 含计费步骤的编排:开跑前把整条计划列出来一次,写明哪几步花钱,你确认才开始。翻译、摘要、优化、扫描件识别、录音转写都花点数。失败不扣。

  • 只想看计划、不真跑:

    bash
    42md recipe run pdf2zh 论文.pdf --dry-run
  • 脚本里已经确认过要花点数,可以加 -y 跳过确认。

  • 接了 时,翻译、摘要、转写等步骤在本机跑,零计费。

网页版

网页版侧栏「工具箱 → 我的编排」里能看到内置模板,也能新建自己的编排。运行统一在命令行:存好的编排用 42md recipe run <名称> <输入> 按名字跑。

下一步

  • 内置的不够用,自己写一条:
  • 把编排交给 AI 助手去跑:
  • 单步工具各自怎么用: