让 AI 助手用 42md
给 AI 助手装上 42md 技能（Skill）后，它知道什么时候该用 42md、该跑哪条命令、哪些免费哪些要花点数。你只管说要什么，比如「把这份 PDF 转成中文 Word」，命令由它来跑。
一行装好
还没装过 42plugin（活水插件，给 AI 助手装技能的工具）的，先装它，详见 ：
-
默认装进当前项目；想对所有项目生效，加
-g： -
默认装给 Claude Code；用 Codex 的加
--platform codex：
助手机器上也要装好 42md 命令行，见 。技能会让助手先确认 42md 装好没有，没装会给你对应系统的安装命令。
装好之后，助手会怎么做
- 先探一探再动手：不确定某条命令怎么用，先跑
42md tools list、--help看当前版本的真实用法。 - 能本地办的就本地办：转换、排版、导出、合并拆分都在本机完成，免费。
- 花点数前先说清楚：翻译、优化、摘要这类花点数的步骤，会先告诉你大概要花多少，你同意再跑。
- 先查你的知识库：动手前先
kb search看看你攒下的素材和卡片里有没有现成的。
用知识库给助手供料
你在 42md 云端知识库里攒下的素材、卡片、专题，助手可以直接检索取用。云端知识库仅限 Pro / Pro+，到期后已有内容仍可查看、取回；检索、取用、入库不花点数，只有把取回的内容再拿去翻译、优化时才扣点数。
一个常见的循环：搜出相关的 → 取到本地 → 助手据此写作或整理 → 成果再存回库里，下次还能用。加 --json 是给助手解析用的。
想让助手成批改你的卡片，把整库导出成本地 Markdown 文件夹，改完校验，再推回去：
推回时每张改动的卡片存成新版本，旧版本保留。详见 。
kb 命令需要登录。没网或没登录时，助手会跳过这一步，用本地文件把事办完。
让助手按你的要求排版和改写
你说「要像学术论文那样的 PDF」「翻译得口语一点」，助手会把要求写成样式文件或一句风格说明，交给 42md：
--style管样子，用在导出类工具上，收内置样式名、样式文件，或你在网页上存好的样式。--prompt管语气：translate收一句话；improve只收模板名。
网页上存好的样式和提示词，用 42md config list 列出来，命令行按序号或短标识引用（样式还能按名字）。详见 。
把编排交给助手
多步的活儿，可以让助手写成一条编排，存进 ~/.42md/recipes/，以后一条命令复用。叫它照这个顺序做：
-
先列出当前能调的动作：
-
写好 YAML 后，跑前校验，再预演一遍：
-
确认计划后正式运行。含计费步骤的编排开跑前会再确认一次：
只有在你已经同意花点数时，才让助手加 -y 跳过确认。编排的写法见 。
无人值守的场景
服务器、CI 这类没有浏览器的环境，到网页版「工具箱 → 我的 CLI → API 密钥」生成一把密钥，放进环境变量 MD42_TOKEN，42md 会用它登录。密钥别写进代码，也别贴进对话。免费版只有 1 个密钥（命令行登录时自动占用），Pro / Pro+ 最多 10 个，可以给每台设备或程序单独一个。
下一步
- 让 AI 处理也留在本机：
- 所有命令一览：