Fitten Code参数配置详解：如何通过settings.json自定义Prompt规则

想让 VS Code 里的 Fitten Code 严格按照你的套路生成代码、写注释，而不是它自己“自由发挥”？那就得钻进 settings.json 文件里动手脚了——图形界面可没这选项。别慌，操作起来不难，关键是步骤别走错，尤其注意配置的语法和键名，错一个字母就白忙活。

确认Fitten Code已正确安装并登录

先确保插件装好了且能用。打开 VS Code，左侧扩展栏搜“Fitten Code”，确认状态是“已启用”，右下角也没有“请登录”的提示。如果还没登录，那得先注册账号并登录——这一步跳过的话，后面在 settings.json 里改再多字段都会被插件无视，等于没改。

找到并打开VS Code的settings.json文件

按下 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）打开设置界面，然后点右上角的“打开设置(JSON)”图标。这就直接打开了用户级的 settings.json 文件。注意：千万别进到工作区级的 settings.json（路径里带 .vscode/settings.json 的那个），Fitten Code 的全局 Prompt 规则只认用户级配置。

添加Fitten Code专属配置块

在 settings.json 最外层大括号 {} 里，添加下面这个结构（记得用逗号跟其他配置隔开）：

"fitten.code.promptRules": {
  "codeGeneration": {
    "languagePreference": "python",
    "maxTokens": 512,
    "temperature": 0.3
  },
  "commentGeneration": {
    "style": "google",
    "includeComplexityNotes": true
  },
  "bugDetection": {
    "severityLevel": "high"
  }
}

这段配置的作用很直接：让 Fitten Code 生成代码时优先用 Python 风格，写注释用 Google Docstring 格式，而且只报告高危级别的 Bug。每个键名必须跟最新文档的定义完全一致，拼错一个字母整段规则就失效了。

远程开发环境下的特殊处理

如果用的是 SSH 或 Dev Container 连远程服务器，得再多做一步。

在 settings.json 里额外加一行：

"remote.extensionKind": {
  "FittenTech.Fitten-Code": ["ui"]
}

如果远程环境连不上网，那就把本地 settings.json 中所有 fitten.code.* 相关的字段复制到远程服务器的 $HOME/.vscode-server/data/Machine/settings.json 文件末尾，然后重启 VS Code Server 进程。

这里要特别提醒：双引号和逗号一个都不能少。JSON 语法死板得很，少一个引号或逗号，整个 settings.json 就解析失败，VS Code 会默默回退到默认设置，不报错也不提示。

验证配置是否生效

第一步：保存 settings.json 文件 → 关闭所有代码文件 → 重启 VS Code。
第二步：新建一个 .py 文件，输入 def hello():，然后按 Tab 触发补全，看生成的代码是不是符合 languagePreference 指定的 Python 风格。
第三步：选中这个函数，右键 → “Fitten Code – 生成注释”，检查输出有没有用 Google 格式（含 Args、Returns 等字段）。

如果都符合预期，那恭喜，配置成功了。如果没生效，回头检查一下逗号、引号和键名拼写。