1. 为什么我放弃了手动画图改用 DeepSeek Mermaid写技术博客最烦的环节不是敲代码而是配图。一张流程图在 draw.io 里拖十分钟改个分支又要重新对齐箭头最后导出 PNG 还糊。更别提文档迭代时图里的文字和正文对不上读者一眼就看出你没更新。Mermaid 解决的是「用文本描述图表」这件事。它是一套基于文本的图表语法支持流程图、时序图、类图、甘特图、饼图、状态图等写起来像 Markdown 一样简单渲染出来却是矢量图。你只要把结构写清楚剩下的布局交给渲染器。但真正让我把这条链路跑顺的是让 DeepSeek 来生成 Mermaid 语法。我只需要用中文描述「用户下单后先校验库存库存不足就通知补货充足则扣减库存并生成订单」DeepSeek 就能吐出可直接渲染的 Mermaid 代码。问题在于如果每次调用模型都要切换不同的 Key、不同的接口地址写作节奏会被打断。所以我用 TaoToken 的统一 Key 把模型调用固定下来config.toml 和 settings.json 各配一份DeepSeek 生成语法、Mermaid 负责渲染整条链路就闭环了。这篇面向的是技术博客写作和文档配图场景适合已经在用 Markdown 写文档、但被画图拖慢节奏的人。下面给出可复制的配置骨架以及一次从文本到图表的端到端验证。2. TaoToken 统一 Key 的前置准备TaoToken 在这里的角色是统一模型接入层。你不需要为 DeepSeek 单独维护一套鉴权逻辑拿到一个 Key 之后在配置文件里填好 base_url 和 model 就能调用。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时别把推广参数拼进去。你需要提前做两件事。第一在控制台创建一个 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 只在创建时完整显示一次复制后妥善保存。第二确认你要用的模型名称DeepSeek 系列在模型列表里可以直接选具体以控制台展示为准。提示Key 不要硬编码进脚本提交到 Git用环境变量或本地配置文件承载配置文件记得加进 .gitignore。如果你还没创建 Key先去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 生成一个。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例遇到参数疑问优先查文档。3. config.toml 与 settings.json 可复制配置骨架不同工具读的配置文件不一样。命令行工具和部分 CLI 客户端习惯读 config.toml而一些编辑器插件和桌面端读 settings.json。我把两份都给你按你实际用的工具选一份填。3.1 config.toml 配置骨架# TaoToken 统一接入配置 # 官网: https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content # API : https://taotoken.net/api [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 [model] # DeepSeek 模型名以控制台模型列表为准 name deepseek-chat temperature 0.3 max_tokens 2048 [request] timeout 60 retry 2temperature 设 0.3 是有意的。生成 Mermaid 语法属于结构化输出温度太高容易在节点命名和箭头方向上发散0.3 左右既保留一点表达灵活性又能让语法稳定。max_tokens 给 2048 足够覆盖大多数流程图和时序图如果你的图节点特别多可以往上调。3.2 settings.json 配置骨架{ taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key粘贴在这里, model: deepseek-chat, temperature: 0.3, maxTokens: 2048, timeout: 60000 }, mermaid: { theme: default, securityLevel: loose, flowchart: { curve: basis, htmlLabels: true } } }settings.json 里我额外挂了 mermaid 的渲染配置。securityLevel 设 loose 是为了让 htmlLabels 生效节点里可以放简单的 HTML 标签比如加粗或换行。如果你渲染环境对安全要求高把它改回 strict代价是部分标签样式失效。注意两份配置里的 base_url 都必须是 https://taotoken.net/api 不要带任何查询参数。带参数会导致部分客户端签名校验失败报 401 或 404。4. 端到端验证从一句中文到一张流程图配置填好之后先别急着写复杂图。用最小闭环验证一次确认 Key、模型、渲染三段都通。4.1 用 curl 验证模型调用curl -s https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -d { model: deepseek-chat, temperature: 0.3, messages: [ { role: system, content: 你是 Mermaid 语法生成器。只输出 Mermaid 代码块不要解释不要多余文字。 }, { role: user, content: 画一个用户登录流程图开始后输入账号密码校验通过则进入首页校验失败则提示重新输入并回到输入步骤。 } ] }把 $TAOTOKEN_API_KEY 换成你环境变量里的 Key。返回体里 choices[0].message.content 应该是一段以 mermaid 开头的代码块。如果返回的是纯文本解释说明 system 提示没压住把「只输出 Mermaid 代码块」再强调一遍。4.2 把返回的语法贴进 Markdown假设模型返回如下内容flowchart TD A[开始] -- B[输入账号密码] B -- C{校验是否通过} C --|通过| D[进入首页] C --|失败| E[提示重新输入] E -- B把它放进任何支持 Mermaid 的 Markdown 渲染器比如 Typora、VS Code 的 Markdown Preview Enhanced或者直接贴到在线编辑器里就能看到图形。节点文字、判断分支、回环箭头都按你描述的结构出来了。4.3 加主题让图更耐看默认主题偏灰放进博客里不够醒目。在代码块第一行加 init 指令切换主题%%{init: {theme: forest}}%% flowchart TD A[开始] -- B[输入账号密码] B -- C{校验是否通过} C --|通过| D[进入首页] C --|失败| E[提示重新输入] E -- Bforest 是绿色系适合技术文档dark 适合深色主题的博客neutral 是中性灰打印友好。你也可以用 themeVariables 单独改某个颜色比如把主节点改成品牌色%%{init: {theme: base, themeVariables: {primaryColor: #2f6fed, primaryTextColor: #ffffff}}}%% flowchart LR A[文本描述] -- B[DeepSeek 生成语法] B -- C[Mermaid 渲染] C -- D[导出配图]这套组合下来一张图的产出时间从十分钟压到一分钟以内而且改结构只需要改文字描述重新生成即可。5. 本篇常见报错与排查5.1 401 Unauthorized最常见的原因是 Key 没带上或者 base_url 写成了带 UTM 参数的地址。检查 Authorization 头是不是 Bearer 加空格加 Key检查 base_url 是不是干净的 https://taotoken.net/api 。另外确认 Key 没有多余空格从控制台复制时容易带上换行。5.2 模型返回解释文字而不是代码system 提示不够强硬。把 system 改成「你只输出 Mermaid 代码块禁止输出任何解释、前言、后记」并在 user 消息末尾加一句「直接给代码」。如果还是不行把 temperature 降到 0.1。5.3 Mermaid 渲染报语法错误多数是节点文字里带了特殊字符比如括号、引号、冒号。Mermaid 对节点文本里的符号敏感遇到报错先把节点文字里的标点去掉或转义。另一个高频原因是箭头方向写错flowchart 里用 --时序图里用 -混用会直接解析失败。5.4 图渲染出来但布局很乱节点太多时布局会挤。可以换方向把 flowchart TD 改成 flowchart LR横向排布通常更宽松。也可以用 subgraph 把相关节点分组渲染器会按组布局。如果还是乱考虑拆成两张图一张主流程一张异常分支。5.5 配置文件改了但不生效确认工具读的是哪份配置。有些 CLI 优先读项目根目录的 config.toml有些读用户目录下的。改完配置后重启工具或者用工具的 config 查看命令确认当前生效值。settings.json 如果被编辑器缓存重启编辑器再试。6. 把这条链路固定成你的写作习惯我现在写文档的流程是先用中文把结构口述一遍丢给 DeepSeek 生成 Mermaid贴进 Markdown 看渲染效果不满意就改描述重新生成。整个过程不离开编辑器也不用打开任何画图软件。如果你主要做长期编码和 Agent 类任务可以把模型调用固定到 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合高频调用场景。如果只是想先验证模型输出质量用模型对话页面快速试几次入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中遇到参数问题优先翻接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 大部分报错在里面都有对应说明。一个实用技巧把常用的 Mermaid 主题和样式配置存成一个片段每次生成新图时直接拼在代码块开头省去重复调样式的时间。图多了之后你会发现真正花时间的不是画图而是想清楚结构而这件事 DeepSeek 帮你把表达成本降到了最低。
