跳转到主内容
全部文档

本地引擎·活水模型

42md 默认把 AI 处理交给云端,按用量计费。接上本机的活水模型(42model)后,这四类处理改在你自己的电脑上跑:

  • 扫描件与图片识别(OCR)
  • 录音转录
  • 翻译
  • 摘要

本机处理零计费,内容不离开你的电脑。命令照旧,什么都不用改。

改写润色(tools improve)和带自定义提示词的摘要(--prompt)暂时只在云端跑,花点数,接上本地引擎也一样。

活水模型可以免费下载、独立离线使用。把它接为 42md 的本地引擎是 42md Pro / Pro+ 的功能;没有 Pro / Pro+ 时会提示你,默认引擎保持不变。套餐见 。

一行切过去

先到 下载安装活水模型,然后:

bash
42md engine use 42model

之后 42md 扫描件.pdf --ocr=force、42md 会议录音.m4a、42md tools translate 笔记.md 这些命令都会自动走本机。

切回云端也是一行:

bash
42md engine use cloud

扫描件、录音分开设,或者每次问我

不带 --for 时,扫描件与图片、录音、AI 生成三样一起改。只想改其中一样,加 --for:

bash
42md engine use 42model --for audio   # 录音走本机42md engine use ask --for scan        # 扫描件与图片:每次问我42md engine use cloud --for ai        # AI 生成(翻译、摘要、改写)走云端

ask(每次问我)只用于扫描件与图片、录音。设成它以后,每次转换开始前会问你一次:这一批走本地引擎,还是走云端引擎(会写明预计花多少点数)。选云端就算确认过用量,不会再问第二遍;直接回车就是取消,什么都不转。

在脚本里、或者没法回答的场合(比如带了 -y),命令会直接停下,并提示你加 --engine local 或 --engine cloud。它不会替你选,也不会悄悄改走云端。

看现在走本地还是云端

bash
42md engine status

它列出每类任务当前走本地还是云端、本地引擎连上没有。这条命令只读,零计费,不调用 AI。

看本地引擎(活水模型)里装了哪些模型:

bash
42md engine models

只这一次换个引擎

不改默认设置,只让某一条命令走本地或云端,加 --engine:

bash
42md tools translate 笔记.md --engine local42md tools summarize 报告.md --engine cloud42md 扫描件.pdf --ocr=force --engine local
  • --engine local:强制本机。没连上本地引擎就直接报错,不会改用云端。
  • --engine cloud:强制云端,按用量计费。
  • 不写就按你的默认设置。设过本地引擎,没连上时同样报错,不会悄悄走云端。

只有本地引擎才有的选项

这些转录和识别选项只在本地引擎下生效:

bash
42md 会议录音.m4a --hotwords @术语表.txt42md 会议录音.m4a --timestamps word42md 会议录音.m4a --punctuate --language zh42md 会议录音.m4a --asr-model qwen3-asr-plus:1.7b42md 扫描件.pdf --ocr=force --ocr-dpi 300
  • --hotwords:给专名和术语加权,减少错字。@文件 形式每行一个词。
  • --timestamps word:逐句时间戳,更细,耗时更长。
  • --punctuate:给转写补标点。
  • --language:指定转写语言,不写由引擎自己判断。
  • --asr-model:指定用哪个语音模型转写(带 --speaker 时分离也用它),填模型 id(42md engine models「语音转写」一栏每行第一列)。本机没有这个模型就报错退出。
  • --ocr-dpi:扫描件转图的清晰度(72 到 400,默认 200),截图里的小字调高到 300 往往更准。
  • --ocr-model:指定用哪个识别模型(图片和扫描件),填模型 id(42md engine models「识别」一栏每行第一列)。录音要用 --asr-model。
  • --ocr-long-doc:长文档模式,逐页识别时把前一页的情况带给下一页,跨页的标题层级更连贯。目前只有 Logics-Parsing-V3 支持,用别的模型时照常逐页识别。

多人录音的说话人分离(--speaker)接了本地引擎时也在本机跑,人数自动判断。详见 。

活水模型没启动怎么办

活水模型已经装好但没在运行时,42md 会自动帮你启动它,等几秒再继续你的命令。

启动后还是连不上,通常是活水模型还没允许本机接入。在活水模型里打开:

bash
42model engine allow on

或者确认活水模型已经登录、模型已经下载完。

切换或重启活水模型后提示「端口被占」,清一下残留的本地引擎连接,下次运行会自动重建:

bash
42md engine reset

和其他功能的关系

  • 本地引擎管的是「在哪处理」。命令行的处理结果本来就只留本机,要放进云端知识库时用 42md kb put,见 。
  • 本地引擎下跑 也一样:翻译、摘要、转写那几步在本机完成,零计费。

下一步

  • 哪些功能本来就纯本地、免费:
  • 数据放在哪、什么时候会上传: