把技术文档写得既准确又让人愿意读，这确实是很多工程师和文档工程师的真实痛点——枯燥的术语堆砌、跳跃的逻辑断层，用户看完文档依然一头雾水，还是不知道怎么操作。火龙果写作的解决方案，其实就藏在这三个核心功能里：问题场景卡片、操作流模板，以及术语注释。

用“问题场景”代替“功能列表”开头

打开火龙果写作网页或客户端，新建文档后，先别急着写标题。点顶部菜单栏【插入】→【自定义模块】→【问题场景卡片】。卡片会自动插入一个带灰色边框的文本块，里面预置了三行提示文字：“用户在什么情况下会遇到这个问题？”“当前最常卡住的一步是什么？”“ta真正想达成的结果是什么？”——这三行不是摆设，而是强制你切换视角的触发器。在删掉提示文字之前，必须填满其中至少两行，否则无法继续编辑正文。

这一步卡住很多人：直接写“支持OAuth2.0登录”，远不如写“用户用微信扫码后页面卡在‘正在验证身份’3秒不动”来得有价值。前者是功能说明，后者才是真实的问题切口。

把长流程拆成可点击的步骤链

方法一：用内置「操作流」模板。光标定位到需要描述流程的位置，点击工具栏【模板】，选择【操作流（带编号）】，输入第一步动作，比如“点击右上角头像”。第二步：在该行末尾按Tab键，自动缩进并生成编号2，接着输入“在下拉菜单中选择【账号设置】”。【注意：不能用空格或回车手动换行来模拟缩进，否则编号会断掉】第三步：连续按Tab可逐级嵌套子步骤，比如在“账号设置”后按Tab，再输入“滚动到底部 → 点击【重置API密钥】按钮”。

方法二：手动构建但保留跳转锚点。对每个关键操作句末尾加#号+关键词，如“点击【导出配置】#export-config”。全文所有#号标记会自动生成侧边导航目录，读者点击即可跳转，避免在长文档里反复滚动找上下文。

术语自动转口语解释

选中文档中任意技术词，比如“JWT token”或“幂等性”，右键点击【添加术语注释】。弹窗里第一行填标准定义（供审核用），第二行必须用大白话重写，例如“JWT token”对应“一串加密过的电子身份证，服务器靠它认出你是谁，但不像密码那样能被反向破解”。

保存后，这个词在正文中会变成浅蓝色下划线，鼠标悬停即显示第二行解释——读者不需要离开当前段落就能理解，也不用翻到文末术语表。这个设计很巧妙，因为它让读者在脑海中建立了一个类比，而不是单纯背诵定义。

需要注意的是，这一步不可逆：一旦开启术语注释，全文所有同类词都会同步启用悬停提示，无法单独关闭某一个。