fitten code配置失效主因是格式陷阱：json需小写布尔值、无引号数值、禁用末尾逗号、路径不加斜杠；yaml须空格缩进、锚点前置、注释后加空格；环境变量须全大写下划线命名并用fitten-cli doctor验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要修改Fitten Code的配置文件来调整模型行为、API密钥或环境变量，但改完后参数不生效、报错或被静默跳过——这往往不是代码问题，而是JSON或YAML格式细节踩了坑。
JSON配置中键名与数据类型的硬性校验
JSON配置在Fitten Code中执行严格schema匹配：任意字段名拼写错误、布尔值大小写混乱、数值加引号，都会导致整块配置被跳过，不会报错也不会降级使用默认值。
第一步：所有布尔字段必须用小写true/false，禁止写成"true"、True、1或YES。
第二步：数值型字段（如timeout、max_tokens）绝对不可包裹双引号，"timeout": "30"必须改为"timeout": 30。否则该字段直接失效。
第三步：检查嵌套对象末尾是否有多余逗号，尤其多行书写时最后一项后加了逗号——JSON解析器会直接拒绝加载整个文件。
第四步：路径类字段统一用正斜杠且不以/结尾，"model_path": "models/llama3/"是非法的，必须写成"models/llama3"。
YAML配置中缩进与锚点复用的关键规则
YAML靠缩进来表达层级，Fitten Code解析器严格遵循YAML 1.2标准，缩进错误会导致嵌套关系错乱甚至解析失败。
方法一：统一用两个空格缩进，禁用Tab键。混合使用空格与Tab会触发解析中断，且错误提示极不明确。
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
方法二：使用锚点(&)复用配置片段时，必须确保锚点定义在引用之前。例如先定义&default_api { timeout: 30, retries: 3 }，再在service下写api_config: *default_api。
方法三：布尔值推荐全用小写true/false，避免混用True/False造成部分字段识别失败。YAML虽允许大写形式，但Fitten Code某些版本存在兼容性偏差。
【注意：YAML注释#后必须跟一个空格，#timeout: 30会引发解析错误】
环境变量注入的安全写法与验证方式
Fitten Code支持${VAR_NAME}语法注入系统级环境变量，这是管理API密钥等敏感信息的唯一推荐方式。
在操作系统中导出变量必须全大写且仅含字母与下划线：export FITTEN_API_KEY="sk-abc123"。
YAML或JSON中对应位置写成auth: { api_key: "${FITTEN_API_KEY}" }，小写变量名（如fitten_api_key）或含短横线（FITTEN-API-KEY）将无法被识别。
启动前运行fitten-cli doctor --env-check，它会批量扫描所有${}占位符并报告缺失变量，避免运行时才暴露密钥为空的问题。
