写石墨ai技术博客需用具体错误、真实文件名、截图标注、失败路径和带量纲参数替代抽象描述，如贴出终端报错原文、写明“把_config.yaml复制到~/shimo-ai-plugins/v0.3.1/contexts/”、指出“点击⚡+圆圈图标而非⚙️”、说明“跳过npm install会导致loading model…卡超90秒”，并明确“temperature=0.3（0.1～0.5稳定）”“max_tokens=512处理1200字不截断”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
写石墨AI技术博客时，提示词设计稍有偏差，就会让教程变成“打开App→点击设置→选择AI功能→搞定”的空泛流水账。读者照着做却跑不通，因为缺了环境差异、权限限制、参数边界这些真实场景里卡住人的细节。
用具体错误替代抽象描述
第一步：复现你截图里那个报错——不是写“可能遇到报错”，而是把终端里实际弹出的红色文字完整贴进来，包括行号和堆栈最顶那行。
第二步：在提示词里直接嵌入这个错误原文，格式为：“当执行【xxx命令】时，终端返回：【Error: Cannot find module 'fs-extra'】，请检查依赖安装路径。”
第三步：删掉所有“常见问题”“一般情况”“建议尝试”这类模糊表述，每句指令必须绑定一个可验证结果，比如“执行后应看到package.json中出现fs-extra条目，而非仅显示‘added 1 package’”。
绑定真实操作对象
方法一：用真实文件名代替占位符
把“将配置文件放入指定目录”改成“把_config.yaml复制到~/shimo-ai-plugins/v0.3.1/contexts/下，注意v0.3.1是当前插件版本号，不是你的本地路径名”。
方法二：截图标注不可跳过的界面元素
在描述按钮位置时，不写“点击右上角图标”，而写“点击编辑区右上角第三个图标（图标为⚡+圆圈，非⚙️或?）”。
【误点⚙️会进入全局设置，导致后续AI指令无法加载上下文】
暴露失败路径
写清楚哪一步做错会导致什么后果，而不是只说“正确操作是……”。
例如：如果跳过npm install --no-save @shimo/ai-core这步，后续调用shimo-ai init时会卡在Loading model…状态超过90秒，且无任何错误提示——此时需强制终止进程并删除node_modules/.cache/shimo-ai目录才能重试。
再如：在石墨文档内粘贴提示词时，若开头多了一个空行，AI会将第一行识别为标题而非指令，直接忽略全部后续内容。
参数值带量纲和边界
不要写“调整temperature值”，要写：“temperature设为0.3（0.1～0.5区间内效果稳定；超过0.7时生成内容开始出现事实性错误，如将‘石墨AI 2.4.0’误标为‘2.5.0’）”。
max_tokens不能只说“合理设置”，而要给出实测数据：“处理1200字技术文档时，max_tokens=512可完整输出摘要；若设为256，末尾3段必被截断，且不会提示截断警告”。
