第七章：国产大模型入门——用AI帮你写Markdown

7.1 AI + Markdown，写作效率提升十倍

AI 时代，写作已经变了。原来你写一篇博客要一天，现在 AI 帮你写初稿，你改改就能用，一小时搞定，效率提升十倍。这一节我们说说，AI 为什么能帮你写 Markdown，什么时候用，怎么用不踩坑。

传统写作痛点，AI 正好能解决

痛点一：坐在电脑前，半天写不出一个字——灵感枯竭

你想写一篇技术文章，打开空白文档，盯了两小时，不知道怎么开头。

AI 说： 帮你写个大纲，给你开个头，你顺着往下写就行了，分分钟进入状态。

痛点二：写得太慢，一篇文章改好几天——速度慢

写一篇技术博客：查资料三小时，搭结构两小时，写内容四小时，改一改两小时，一共十一个小时，一周才能写一篇。

AI 说： 十分钟给你生成初稿，你改一个小时就能发，总耗时一小时十分，效率提升十倍。

痛点三：想说的话表达不清楚——词不达意

你心里明白这个功能是什么，但写出来绕半天，读者看不懂。

AI 说： 你把大概意思给我，我帮你整理得清清楚楚，干干净净，读者一看就懂。

痛点四：天天写周报、会议纪要，烦都烦死了——重复劳动

都是套路话，换个日期换个内容，你还要重新写，天天干这个，浪费时间。

AI 说： 你把要点给我，两分钟给你写好，排版也给你弄好，直接用。

AI + Markdown，为什么是绝配

优势MarkdownAI
简单易学，五分钟就会✅–
纯文本，结构清晰，标题列表代码分的清清楚楚✅–
天生就是结构化，AI 特别擅长生成结构化内容–✅
AI 能看懂 Markdown 语法，生成直接就能用–✅
生成完就能发布，不用转格式✅–

实际效果对比：

任务传统写法AI + Markdown提升倍数
写一篇博客11 小时1 小时10 倍
写技术文档8 小时1 小时8 倍
写会议纪要30 分钟3 分钟10 倍
写 API 文档6 小时1 小时6 倍
写周报15 分钟2 分钟7.5 倍

就是这么夸张，AI + Markdown，写作效率真的能提升好几倍。

什么时候用 AI，什么时候不用

✅ 适合用 AI 的场景

  1. 生成初稿：你有想法，不知道怎么写，让 AI 先写个初稿，你再改，快很多
  2. 规划结构：你要写长文，不知道怎么分章节，让 AI 帮你搭结构
  3. 补充内容：你写了一半，某一块不知道怎么展开，让 AI 帮你补充例子和说明
  4. 优化语言：你写的话绕来绕去，让 AI 帮你改得清楚明白
  5. 格式转换：你有 Word 文档，想转成 Markdown，让 AI 帮你转

❌ 不适合用 AI 的场景

  1. 完全原创的个人内容：你的个人经历、你的独家观点、你的专业判断，这些还是你自己写，AI 写不出来你的味道
  2. 保密内容：公司机密、没公开的项目，别发给 AI，保密重要
  3. 简单复制粘贴：就改几个字，不用麻烦 AI 了

几个常见误区，别踩坑

误区一：AI 能直接帮我写出一篇完美的文章，我什么都不用干

错了。

AI 擅长：生成初稿、补充内容、优化语言，这些它做得很好 AI 不擅长：原创思考、深度分析、你的独家观点，这些它不行

正确姿势：

 AI 写初稿 → 你加原创思考 → 你加独家见解 → 你润色 → 完成

结果：你花四个小时，写出一流文章。对比：完全 AI 写，十分钟，质量一般；完全自己写，八个小时，质量不错。AI+你，又快又好。

误区二：AI 什么都懂，说的都对

错了。

AI 的知识有截止日期，最新技术它不知道，专业深度它不够。它给你的内容，你要核对，要补充，错的要改，对的留着，你负责最终准确性。

误区三：AI 能代替你思考，你不用想了

错了。

你负责想： 我要写什么，核心观点是什么，结构怎么安排，哪些要重点讲，这都是你的事。 AI 负责做： 把你想的，整理成通顺的文字，补全例子，写好代码块，帮你节省时间。

AI 是你的助手，不是你的老板，你掌舵，AI划船。

AI 写作最佳实践，照着做就对了

一，需求说清楚，别模糊

不好： “帮我写一篇文章”

好： “帮我写一篇 Python 异步编程入门文章，面向初学者，两千字，结构要包含引言、基本概念、例子、常见问题，要有示例代码”

越具体，AI 写得越合你意。

二，给够背景信息

不好： “帮我写一篇 API 文档”

好： “帮我写电商平台 API 文档，目标用户前端开发，用 Token 认证，主要包含商品、订单、支付三个模块，给每个接口写清楚参数和示例”

三，一步一步来，别一口吃个胖子

不好： “帮我写一本两百页的技术书”

好： “第一步：先帮我规划整体目录结构 → 第二步：写第一章初稿 → 第三步：补充示例 → 第四步：调整格式”

分步来，质量好控制。

四，不满意就改，迭代几次

AI 第一次写的不一定满意，你告诉它哪里不满意，让它改，改几次就好了。

五，保留你自己的风格

AI 写好了，你加进去你自己的例子，你自己的比喻，你自己的观点，让文章有你的味道，别全抄 AI 的。

几个常用场景提示词例子，直接拿去用

写技术博客：

 你是技术博客作者，精通 Markdown。
 ​
 帮我写一篇"Python 异步编程入门"博客：
 - 目标读者：有 Python 基础的开发者
 - 结构：引言 → 核心概念 → 实战案例 → 常见错误 → 总结
 - 格式：用 Markdown，代码块标语言，重点加粗
 - 先写引言部分

写技术文档：

 你是技术文档专家，精通 Markdown。
 ​
 帮我写 Redis 缓存技术文档：
 - 结构：简介 → 安装 → 快速开始 → 核心概念 → 常用命令 → 持久化 → 应用场景 → 常见问题
 - 每个章节要有示例，讲清楚参数，说一下注意事项
 - 面向初学者，语气友好清楚
 - 先写第一章简介

写 API 文档：

 你是 API 文档专家，精通 Markdown RESTful 规范。
 ​
 帮我写电商 API 文档，包含这几个接口：
 1. 用户注册 POST /api/user/register
 2. 用户登录 POST /api/user/login
 3. 商品列表 GET /api/product/list
 4. 创建订单 POST /api/order/create
 5. 支付 POST /api/payment
 ​
 每个接口要包含：接口说明、请求参数（表格）、请求示例、响应参数、响应示例、错误码。
 格式用 Markdown，JSON 放代码块。先写 API 概述。

写会议纪要：

 你是会议纪要专家，擅长结构化整理。
 ​
 根据下面要点生成会议纪要：
 - 时间：2026-03-15 14:00-16:00
 - 参会：张三、李四、王五
 - 主题：新项目启动讨论
 - 要点：
   1. 确认需求：电商平台开发
   2. 技术栈：后端 Python，前端 Vue
   3. 工期：三个月
   4. 分工：张三后端，李四前端
   5. 下次会议：2026-03-22
 ​
 格式：Markdown，分：会议信息 → 决议 → 行动事项 → 下次会议。直接生成。

7.2 智谱 AI：国产大模型里最适合中文写作

智谱 AI 的 GLM 系列模型，是国产大模型里非常优秀的一个，特别适合中文写作，我推荐你试试。

为什么我推荐智谱 AI？

优势一：中文优化做得好，表达自然

很多大模型写中文，翻译腔很重，读着别扭。智谱 AI 中文训练足，表达更符合我们说话习惯，成语用得准，句式也自然，读着舒服。

比如给你举个例子，让它用比喻解释异步和多线程区别：

想象一下：

  • 同步编程：餐厅点餐，服务员下单后站在厨房门口等菜，这期间不能去服务其他客人
  • 异步编程：点外卖，下单后服务员继续服务别的客人，菜做好了会通知你
  • 多线程：餐厅有多个服务员，可以同时服务好几桌客人

比喻准确，生动，符合中文表达习惯，一下子就能懂，这就是智谱 AI 的优势。

优势二：理解能力强，能听懂你的需求

你说要”用通俗比喻给初学者解释清楚”，它真的能做到，不会给你一堆干巴巴的术语，例子也接地气，初学者能看懂。

优势三：免费额度够用，日常写作不用花钱

每天免费额度足够你写几篇文章，日常写作够用了，不用一开始就充值，你可以先试试，好用再考虑付费。

优势四：响应快，不怎么卡住

平均 1-2 秒就能回复你，比很多模型快，你改几次 prompt 也不用等半天，体验好。

优势五：Markdown 支持完美，生成直接能用

不管是代码块、表格、标题层级，智谱 AI 都能给你写对格式，生成完你直接就能用，很少需要你调格式，省很多事。

比如让它写个参数表格：

参数名类型必填说明
idInteger是用户 ID
nameString是用户名
emailString否邮箱

格式完全正确，直接能用，不用你改。

怎么用智谱 AI，三种方法

方法一：网页直接用（推荐新手）

  1. 打开 https://chatglm.cn ，手机号注册
  2. 登录进去，直接开对话框
  3. 输入你的提示词，发送，等着收结果就行了

优点：不用装东西，浏览器打开就能用，跨平台，多轮对话方便，新手选这个。

方法二：API 调用（开发者）

  1. 官网注册，拿到 API Key
  2. 代码里调用，OpenAI 兼容接口，直接用：
 import openai
 ​
 client = openai.OpenAI(
     api_key="你的 API Key",
     base_url="https://open.bigmodel.cn/api/paas/v4/"
 )
 ​
 response = client.chat.completions.create(
     model="glm-4",
     messages=[
         {"role": "user", "content": "帮我写一篇 Markdown 格式的技术文档"}
     ]
 )
 ​
 print(response.choices[0].message.content)

优点：你可以集成到自己工具里，批量处理，适合开发者。

方法三：编辑器插件（进阶用户）

VS Code、Typora 都有插件，装完配置 API Key，在编辑器里直接调用，不用切来切去，方便。

写 Markdown，提示词这么写，AI 输出一次就对

技巧一：先告诉 AI 它是什么角色

不好：”帮我写一篇文档”

好：”你是技术文档专家，精通 Markdown，擅长把复杂概念讲清楚，帮我写一篇关于 Redis 缓存的技术文档”

告诉 AI 它是谁，擅长什么，它就会按那个路子写。

技巧二：给够上下文

不好：”帮我写函数这一章”

好：”我正在写 Python 入门教程，前面写完了基础语法、列表字典，现在写函数这一章，目标读者是编程初学者，重点讲 def 关键字、参数、返回值，要用简单比喻，要有可运行例子，要讲常见错误，格式用 Markdown。现在开始写第一小节。”

把背景、目标、要求说清楚，AI 写出来更合你意。

技巧三：结构说清楚

你要什么结构，直接列出来：

 任务：写 Redis 技术文档
 ​
 结构要求：
 - 第一章：Redis 简介
   - 1.1 什么是 Redis
   - 1.2 Redis 特点
   - 1.3 应用场景
 - 第二章：安装配置
   - 2.1 安装步骤
   - 2.2 配置说明
   - 2.3 启动验证
 ​
 要求：每章 300-500 字，Markdown 格式，要有示例代码，要讲注意事项。
 ​
 现在写第一章。

结构清楚，AI 不会写错，不用回来改结构。

技巧四：格式要求说清楚

你要什么格式，直接说：

 格式要求：
 - 章节标题：## 二级标题
 - 小节：### 三级标题
 - 代码块：三个反引号，指定语言
 - 表格：对齐正确，要有表头
 - 重点内容：加粗

AI 按你要求生成，格式对，你不用改，省时间。

技巧五：一步一步来，别一口吃个胖子

不好：”帮我写整本十章的技术书”

好：”第一步：先帮我规划全书目录结构 → 确认结构 → 第二步：写第一章 → 改一改 → 第三步：写下一章”

一步一步验证，不对及时改，比一次性写完一大堆，全不对，好很多。

实战例子，直接照着抄

例子一：生成技术文档大纲

提示词：

 你是技术文档规划专家。
 ​
 帮我规划《Python 异步编程入门》结构：
 - 面向有 Python 基础的开发者
 - 目标：让读者真的能学会用异步
 - 分成 4-6 章，每章 3-5 小节
 - 逻辑递进，要有实战案例
 - 输出用 Markdown 列表
 ​
 现在开始。

AI 会给你完整大纲，你觉得不对，直接说，”把第五章进阶内容合并到第四章”，它会改，很快就能搞定结构。

例子二：写具体章节

提示词：

 你是技术作者，精通 Python 和 Markdown。
 ​
 现在写第一章"基础概念"：
 - 1.1 什么是异步编程（500 字）
 - 1.2 同步 vs 异步对比（800 字）
 - 1.3 为什么需要异步（400 字）
 ​
 要求：
 - 用比喻解释，初学者能懂
 - 要有简单可运行的例子
 - 要讲清楚核心概念
 - 语气友好专业
 - 格式用 Markdown，代码块标 python，重点加粗。
 ​
 现在写 1.1 小节。

AI 会按照你的要求写，比喻、例子、格式全对，直接就能用，你改一改措辞就行了。

智谱 AI 也有局限，你要知道

一，知识有截止日期

它的知识是截止到某个时间的，最新技术、最新新闻它不知道，你要写最新内容，你得把最新信息给它，它帮你组织语言就行了。

二，特别专业的领域，深度不够

比如医学、法律这种特别专业的，它只能帮你搭结构，组织语言，专业内容还是得你自己写，它做不了你的专业判断。

三，免费额度有限

日常写作够用，你要是一天写几万字，可能不够，那你得升级付费版。

四，长对话记得住前面有限

对话太长了，它会忘了前面说了什么，所以长文章一章一章写，写完一章再写下一章，重要信息重复说一下，就没问题。

7.3 其他国产模型，不同场景选不同

除了智谱 AI，国产还有几个不错的大模型，不同场景有不同选择，我给你整理好了。

文心一言（百度）

百度推出的，基于飞桨训练，中文理解不错，知识增强做得好。

优势：

  • ✅ 中文理解好，语境拿捏准确
  • ✅ 能整合搜索结果，给你最新信息
  • ✅ 支持多模态，文本、图片、视频都能处理
  • ✅ 免费额度够用

适合：

  • 写作：⭐⭐⭐⭐
  • 内容优化：⭐⭐⭐⭐
  • 信息检索：⭐⭐⭐⭐⭐
  • 多模态：⭐⭐⭐⭐

怎么用： 网页 https://yiyan.baidu.com 直接用，也能 API 调用。

通义千问（阿里）

阿里云推出的，有不同大小模型，企业级支持做得好，和阿里云生态整合很好。

优势：

  • ✅ 模型大小可选，从 1.8B 到 72B 都有
  • ✅ 企业级支持，稳定性好，数据安全有保障
  • ✅ 多模态能力强，文本图片都能搞
  • ✅ 阿里云生态集成方便

适合：

  • 企业应用：⭐⭐⭐⭐⭐
  • 多模态任务：⭐⭐⭐⭐⭐
  • 云服务集成：⭐⭐⭐⭐⭐
  • 大规模部署：⭐⭐⭐⭐⭐

怎么用： 网页 https://tongyi.aliyun.com 直接用，企业可以自己部署。

KIMI（月之暗面）

专门优化长文本处理，最长支持 20 万字上下文，处理长文档特别厉害。

优势：

  • ✅ 长文本真的强，一整本扔进去，它能读懂
  • ✅ 支持上传文件，PDF、Word 都能分析
  • ✅ 写长文档上下文连贯，不会忘前面说什么

适合：

  • 长文档处理：⭐⭐⭐⭐⭐
  • 文档总结分析：⭐⭐⭐⭐⭐
  • 整本书处理：⭐⭐⭐⭐
  • 技术文档写作：⭐⭐⭐⭐

怎么用： 网页 https://kimi.moonshot.cn 直接用，支持上传文件。

怎么选，一句话给你总结

模型中文Markdown免费额度特色适合场景
智谱 AI⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐充足中文好，响应快日常写作
文心一言⭐⭐⭐⭐⭐⭐⭐⭐中等知识增强，能搜最新信息需要找最新资料
通义千问⭐⭐⭐⭐⭐⭐⭐⭐较少企业级，多模态企业应用
KIMI⭐⭐⭐⭐⭐⭐⭐⭐充足长文本处理强长文档、整书分析

直接给你选择建议：

  • 日常写文章、写笔记、写博客 → 选智谱 AI，中文好，额度够，快
  • 企业用，要稳定安全 → 选通义千问，阿里生态支持好
  • 需要找最新信息 → 选文心一言，能搜索，信息新
  • 处理长文档、整本书分析 → 选 KIMI，长文本真的强
  • 免费日常用 → 智谱 AI、KIMI 免费额度都够，够用

都是国产，对中文支持都不错，你可以每个都试试，选一个你用着顺手的。

7.4 提示词基础：写清楚，AI 才能听懂

提示词就是你给 AI 的指令，指令写清楚，AI 才能给你想要的结果。这一节讲最实用的基础技巧，看完你就会写了。

好提示词，记住三要素就够了

公式很简单：目标 + 背景 + 格式

一，目标明确：告诉 AI 你到底想要什么

❌ 不好：帮我写个东西 ✅ 好：帮我写一篇"AI 辅助 Markdown 写作"的文章大纲

二，给够背景：告诉 AI 写给谁，用在哪

❌ 不好：帮我写项目介绍 ✅ 好：帮我写项目介绍，放在 GitHub 首页，给开发者看，要简洁，控制在两百字内

三，指定格式：一定要说清楚，输出用 Markdown

❌ 不好：帮我生成一个表格 ✅ 好：请用 Markdown 格式生成一个表格，表头是姓名、年龄、职业，数据这里...

就这么简单，三要素说清楚，AI 输出八九不离十。

几个现成模板，直接拿去用

模板一：生成文章大纲

 请帮我生成一篇关于"[你的主题]"的 Markdown 文章大纲，分章节，用正确的标题层级。

模板二：生成表格

 请帮我生成 Markdown 表格：
 - 表头：姓名、年龄、职业
 - 数据：
   - 张三，25，程序员
   - 李四，30，产品经理

模板三：完善现有内容

 请帮我完善这段 Markdown，让表达更流畅，保持原有结构和格式不变：
 ​
 [把你写的内容粘在这]

模板四：检查改错

 请帮我检查这段文字的错别字和不通顺的地方，修正，保持原文意思不变：
 ​
 [把你写的内容粘在这]

模板五：改写风格

 请帮我把这段文字改得更通俗，适合初学者看，保持 Markdown 格式不变：
 ​
 [内容]

几个实用技巧，让结果更好

一，一步一步来，别一口吃个胖子

❌ 不好：”帮我写完整本十章的书” ✅ 好：”第一步，先帮我规划全书目录 → 确认目录 → 第二步，写第一章 → …”

一步一步验证，不对及时改，比一次性写完一大堆，结果不对，好太多。

二，不满意就迭代，别将就

  1. AI 输出第一版 → 你看看哪里不对 → 告诉 AI “这里改成…，那里改成…” → AI 再改一遍 → 直到满意

多迭代两次，结果就很好了，别一次不满意就扔了。

三，让 AI 给你几个选择

 请给我写三个不同的开头，我选一个。

一次写一个，不如一次给三个，你挑一个最喜欢的，效率更高。

四，永远别忘了说：用 Markdown 格式输出

很多人忘了说，AI 输出格式错了，你还要自己改，提前说一声，省得后面改。

常见错误，别踩坑

  1. ❌ 目标模糊 → ✅ 说清楚你到底要什么
  2. ❌ 背景不说 → ✅ 告诉 AI 写给谁，用在哪
  3. ❌ 一次性要太多 → ✅ 一步一步来
  4. ❌ 忘了说格式 → ✅ 一定要说”用 Markdown 输出”

7.5 常见问题与实用技巧

这一节整理了大家问得最多的问题，还有一些进阶技巧，看完你用 AI 写作会更顺手。

常见问题解答

问题一：智谱 AI 收费吗？

回答： 免费就能用，日常写作足够了。

  • 网页访问每天有免费额度，日常写几篇文章够用
  • 高频使用、企业用、需要 API 集成，再考虑付费
  • 具体额度看官网，经常有调整，以官网为准

问题二：智谱和 ChatGLM 是一回事吗？

回答： 是一回事，ChatGLM 就是智谱 AI 家的模型，同一个东西，不同叫法，用法一样。

问题三：我能同时用好几个 AI 吗？

当然可以！不同 AI 有不同优势，不同任务用不同的，效率更高：

  • 日常中文写作 → 智谱 AI（中文好，快）
  • 写代码 → 通义千问（代码能力不错）
  • 分析长文档 → KIMI（长文本强）
  • 查最新信息 → 文心一言（能搜索）

组合用，各发挥所长，结果更好。

问题四：AI 写的都对吗？

回答： 不一定，你一定要检查。

为什么？

  • AI 知识有截止日期，最新信息它不知道
  • AI 会”幻觉”，胡说八道一本正经
  • 专业领域深度不够，需要你补充

你要做这几步：

  1. 事实核查：重要数据、时间、版本号，一定要核对
  2. 代码验证：AI 写的代码，复制下来跑一遍，对了再用
  3. 补充最新信息：AI 不知道近两年的新东西，你要补上
  4. 专业内容审查：医学、法律这种专业内容，一定要专业人士审查

问题五：提示词是不是越长越好？

回答： 不是，清楚比长重要。

不好的提示词： 啰啰嗦嗦一大堆，说半天没说清楚要什么。

好的提示词： 说清楚目标、背景、格式，结构化，干净清楚，AI 一看就懂。

记住：明确 > 冗长。

问题六：AI 生成的代码能直接用吗？

回答： 不能直接用，一定要验证。

步骤：

  1. 复制代码到编辑器
  2. 运行测试，看结果对不对
  3. 测一下边缘情况（空输入、错误输入），看处理对不对
  4. 没问题了再用

别偷懒，AI 偶尔会写出能编译但是逻辑错的代码，一定要跑一遍。

问题七：怎么让 AI 记得住前面说过的内容？

长文章，写到后面，AI 容易忘前面说了什么，给你几个解决办法：

  1. 写一章，开一个新对话，分开写，上下文不会爆
  2. 每开新章，把前面核心内容简单总结一下，告诉 AI “前面我们说了 xxx，现在写 xxx，要呼应前面”
  3. 长对话就用 KIMI，它长文本本来就强

实用技巧，提升你的效率

技巧一：把好用的提示词存起来，重复用

你用着好的提示词，存一个 prompts.md，以后用直接复制，改几个关键词就能用，不用每次重新写：

 # 我的提示词库
 ​
 ## 技术文档 - 生成大纲
 ​

你是技术文档规划专家。

帮我规划《{主题}》结构：

  • 目标读者：{读者}
  • 分成 {章节数} 章，每章 3-5 小节
  • 逻辑递进，要有实战案例
  • 输出用 Markdown 列表。现在开始。
 ​
 ## 技术文档 - 写章节
 ​

你是技术文档专家，精通 Markdown。

任务：写《{章节名}》 背景：{上下文} 要求：

  • 用比喻讲清楚概念
  • 要有可运行示例
  • 要讲常见错误
  • 格式 Markdown。现在开始写 {小节名}。
 ​

以后用，替换占位符 {xxx} 就行了，快很多，风格也一致。

技巧二：迭代改进，一次不好，改几次

别指望一次写完美：

  1. AI 出第一版 → 你看看，说清楚哪里不好 → AI 改 → 再看 → 再改 → 满意了停止

多改两次，质量就上去了，很简单。

技巧三：一次要多个结果，你挑最喜欢的

 "给我写三个不同的开头，我选一个。"

一次写一个，不如一次给三个，你挑一个最喜欢的，省得你改来改去。

技巧四：多个 AI 一起用，组合起来更好

每个 AI 有自己擅长的：

  • 智谱写初稿（中文好）→ 通义千问改代码（代码好）→ Kimi 整体通读总结（长文本好）

每个 AI 干它擅长的，结果比一个 AI 从头写到尾好。

或者，同一个需求，两个 AI 各写一遍，你挑好的拼起来，也比一个好。

技巧五：一定要做质量检查

AI 写完，你照着检查一遍：

  • 所有章节都有内容，没遗漏
  • Markdown 格式对不对，代码块、表格对不对
  • 事实对不对，数据、版本、日期对不对
  • 代码能跑吗，结果对不对
  • 通顺不通顺，有没有语病

检查完，没问题了，这才算完。

进阶技巧

技巧一：自动化，重复工作让脚本帮你干

如果你会点 Python，能把重复工作自动化，比如批量生成 API 文档：

 import openai
 ​
 client = openai.OpenAI(
     api_key="你的密钥",
     base_url="https://open.bigmodel.cn/api/paas/v4/"
 )
 ​
 def generate_chapter(title, context=""):
     prompt = f"""
     你是技术文档专家，精通 Markdown。
     任务：写 {title} 这一章
     背景：{context}
     要求：
     - 语气友好专业
     - 格式 Markdown
     - 每章 300-500 字
     现在开始写
     """
     resp = client.chat.completions.create(
         model="glm-4",
         messages=[{"role": "user", "content": prompt}]
     )
     return resp.choices[0].message.content
 ​
 # 批量生成章节
 chapters = [
     "第一章：Redis 简介",
     "第二章：安装指南",
     "第三章：快速开始"
 ]
 ​
 for chapter in chapters:
     print(f"## {chapter}\n{generate_chapter(chapter)}\n")

一下子生成所有章节大纲，你再改，省超多时间。

技巧二：定制微调，适合长期固定风格写作

如果你长期写固定风格的内容，比如一直写技术博客，可以微调模型，让它更符合你的风格：

  1. 准备你写好的几十篇范文
  2. 上传到智谱，启动微调
  3. 训练完用微调后的模型写，风格更像你，更符合你的习惯

缺点：要花钱，需要准备数据，适合长期用，偶尔写不用折腾。

技巧三：实时协作，你想，AI 写

你出想法和结构，AI 帮你整理语言，补充例子，你改，这样最快：

  • 你：搭好结构，写下要点
  • AI：帮你把要点展开，写成通顺的文章
  • 你：审查修改，不满意让 AI 再改

这样，你省了打字组织语言的时间，还保持你的想法和风格，效率最高。

7.6 实战练习：动手练一遍

做完这几个练习，AI 辅助写作你就真的会了。

练习一：生成技术文档大纲

要求：

  1. 选一个你熟悉的技术主题
  2. 说清楚目标读者是谁
  3. 用智谱 AI 生成大纲
  4. 你自己审查一下好不好

例子，你照着来：

提示词：

 你是技术文档规划专家。
 ​
 帮我规划《Redis 缓存入门》结构：
 - 面向 Redis 初学者
 - 文档类型：技术教程
 - 目标：学完就能用 Redis
 - 分成 5-8 章，每章 3-5 小节
 - 从入门到实战，要有案例，要有常见问题
 - 输出 Markdown 列表
 ​
 现在开始。

AI 输出大概是这样：

 ## 《Redis 缓存入门》大纲
 ​
 ### 第一章：Redis 简介
 - 1.1 什么是 Redis
 - 1.2 Redis 特点
 - 1.3 能用在什么地方
 - 1.4 为什么要用 Redis
 ​
 ### 第二章：安装配置
 - 2.1 安装步骤
 - 2.2 配置文件说明
 - 2.3 启动验证
 - 2.4 常用配置
 ​
 ...

自己检查：

  • 章节数量对不对，逻辑递进对不对
  • 每个章节标题清楚不清楚
  • 有没有实战案例，有没有常见问题
  • 你觉得结构舒服吗

练习二：写具体章节

要求：

  1. 用练习一生成的大纲
  2. 选第一章，让 AI 帮你写内容
  3. 你审查，改一改

例子提示词：

 你是技术文档作者，精通 Redis 和 Markdown。
 ​
 现在写第一章"Redis 简介"：
 - 1.1 什么是 Redis（300-500 字）
 - 1.2 Redis 特点（400-600 字）
 - 1.3 应用场景（500-700 字）
 - 1.4 为什么要用 Redis（300-500 字）
 ​
 要求：
 - 用比喻解释，初学者能懂
 - 要有简单例子
 - 语气友好专业
 - 格式 Markdown，代码块标对语言，重点加粗
 ​
 现在写 1.1 小节。

AI 会按照你的要求写，写完你看看：

  • 标题对不对，字数差不多吗
  • 比喻清楚吗，初学者能懂吗
  • 格式对吗，Markdown 对吗
  • 有错误你改一改

没问题了，再写下一小节，一章一章来，很轻松。

练习三：生成 API 文档

要求：

  1. 说清楚你的 API 有哪些接口
  2. 让 AI 给你生成完整 Markdown 格式的 API 文档
  3. 你看看完整不完整

例子提示词：

 你是 API 文档专家，精通 Markdown RESTful API。
 ​
 帮我写电商用户模块 API 文档：
 ​
 接口列表：
 1. 用户注册 POST /api/user/register
 2. 用户登录 POST /api/user/login
 3. 获取用户信息 GET /api/user/info
 4. 更新用户信息 PUT /api/user/info
 5. 删除用户 DELETE /api/user
 ​
 结构要求：
 1. API 概述
 2. 通用说明（状态码、认证）
 3. 每个接口：名称、方法、路径、参数表格、请求示例、响应示例、错误码
 ​
 格式：Markdown，JSON 放代码块。
 ​
 现在从概述开始写。

AI 生成完，你检查：

  • 每个接口信息完整吗
  • 参数表格对吗
  • 请求响应示例对吗
  • 错误码全吗

练习四：优化你的提示词

要求：

对比三个版本提示词，看看哪个输出好，体会提示词怎么写更好：

版本一（不好）：

 帮我写一篇文章。

版本二（还行）：

 你是技术博客作者，精通 Markdown。
 ​
 帮我写一篇"Python 异步编程入门"文章。
 ​
 要求：
 - 面向有 Python 基础的开发者
 - 结构：引言 → 核心概念 → 实例 → 常见错误 → 总结
 - 格式 Markdown，代码块标 python，重点加粗。
 ​
 现在开始写引言。

版本三（更好）：

 你是技术博客作者，精通 Python 异步编程 Markdown。
 ​
 任务：写《Python 异步编程入门》文章。
 ​
 背景：
 - 目标读者：有 1-2 年 Python 基础
 - 目标：学完能上手写异步代码
 ​
 结构要求：
 1. 标题（一级）：吸引人，有关键词
 2. 引言（二级）：讲同步痛点，引入异步
 3. 核心概念（二级）：
    - 什么是异步（三级）
    - 同步 vs 异步对比（三级）
    - async/await 语法（三级）
    - 事件循环（三级）
 4. 实战案例（二级）：每个案例完整可运行代码
    - 异步文件操作（三级）
    - 异步网络请求（三级）
    - 并发处理（三级）
 5. 常见错误（二级）：列出五个典型错误，说清楚怎么避免
 6. 总结（二级）：归纳要点，推荐延伸阅读
 ​
 格式要求：
 - 标题层级清楚（H1 H2 H3）
 - 代码块：```python```，加注释
 - 重点：加粗
 - 列表：用对项目符号
 - 比喻：生活化例子，初学者懂
 ​
 风格：友好专业，从浅入深，别太学术。
 ​
 现在从引言开始写。

自己试试，生成一次，看看三个版本输出区别，你就明白提示词为什么要写具体了。

练习五：多个 AI 一起协作

要求：

  • 主 AI 写大纲和初稿
  • 辅助 AI 补充例子、优化比喻
  • 你拼起来，得到最终文档

例子：

步骤一：智谱 AI 生成大纲 → 没问题，搞定

步骤二：智谱 AI 写第一章内容 → 结构对，就是比喻有点干

步骤三：把这段交给通义千问，让它帮你补充生动比喻 → 通义千问给你一个餐厅柜台 vs 自助点餐的比喻，很生动

步骤四：你把比喻整合到第一章 → 搞定，比一个 AI 写得更好

这样，每个 AI 干它擅长的，结果更好。