火龙果写作通过问题场景卡片、操作流模板、术语注释三大功能提升技术文档可读性：以真实问题切入，拆解为可点击步骤链，并将术语自动转为悬停式口语解释。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
把技术文档写得既准确又让人愿意读，是很多工程师和文档工程师的真实痛点——术语堆砌、逻辑断层、用户看完还是不知道怎么操作。
用“问题场景”代替“功能列表”开头
打开火龙果写作网页或客户端，新建文档后，先不急着写标题，点顶部菜单栏【插入】→【自定义模块】→【问题场景卡片】。
卡片会自动插入一个带灰色边框的文本块，里面预置三行提示文字：“用户在什么情况下会遇到这个问题？”“当前最常卡住的一步是什么？”“ta真正想达成的结果是什么？”——这三行不是装饰，而是强制你切换视角的触发器。删掉提示文字前，必须填满其中至少两行，否则无法继续编辑正文。
这一步卡住很多人：直接写“支持OAuth2.0登录”，不如写“用户用微信扫码后页面卡在‘正在验证身份’3秒不动”。前者是功能说明，后者才是真实问题切口。
把长流程拆成可点击的步骤链
方法一：用内置「操作流」模板
光标定位到需要描述流程的位置→点击工具栏【模板】→选择【操作流（带编号）】→输入第一步动作，比如“点击右上角头像”。
第二步：在该行末尾按Tab键，自动缩进并生成编号2，接着输入“在下拉菜单中选择【账号设置】”。【注意：不能用空格或回车手动换行来模拟缩进，否则编号会断掉】
第三步：连续按Tab可逐级嵌套子步骤，比如在“账号设置”后按Tab，再输入“滚动到底部 → 点击【重置API密钥】按钮”。
方法二：手动构建但保留跳转锚点
对每个关键操作句末尾加#号+关键词，如“点击【导出配置】#export-config”，全文所有#号标记会自动生成侧边导航目录，读者点击即可跳转，避免在长文档里反复滚动找上下文。
术语自动转口语解释
选中文档中任意技术词，比如“JWT token”或“幂等性”，右键→【添加术语注释】。
弹窗里第一行填标准定义（供审核用），第二行必须用大白话重写，例如“JWT token”对应“一串加密过的电子身份证，服务器靠它认出你是谁，但不像密码那样能被反向破解”。
保存后，这个词在正文中会变成浅蓝色下划线，鼠标悬停即显示第二行解释——读者不需要离开当前段落就能理解，也不用翻到文末术语表。
这一步不可逆：一旦开启术语注释，全文所有同类词都会同步启用悬停提示，无法单独关闭某一个。
