先说重点:想让 Fitten Code 在 VS Code、PyCharm、JetBrains 全家桶乃至远程 Dev Container 中使用同一套 Prompt 规则和偏好设置,必须打通账号级别的配置同步链路,而不是逐台设备单独配置。否则,你需要在每个 IDE 中手动编写一遍规则,不仅效率低下,还容易出现规则不一致的情况。
必须开启账号级同步,才能跨 IDE 统一 Prompt 规则。具体做法是:先登录 GitHub 或 GitLab 账号,然后在用户级 settings.json 中添加一个顶级键 fitten.code.syncEnabled: true,再通过 Fitten Code 侧边栏开启同步,或者手动将配置推送到 PyCharm、Dev Container 中。下面详细介绍每一步操作。

确认账号已统一登录并激活同步能力
随意打开一个已安装 Fitten Code 的 IDE(例如 VS Code),点击左侧 Fitten Code 图标,观察右下角状态栏是否显示“已登录”以及你的账号邮箱。如果显示“请登录”,必须先完成 GitHub 或 GitLab 账户绑定——这一步未完成,后续所有同步操作均无效,因为未登录状态下修改 settings.json 时,插件会静默忽略,根本不会响应。
登录成功后,在 Fitten Code 侧边栏点击“设置”,滚动到底部查看“同步状态”。如果状态显示为灰色或提示“未连接”,说明当前环境尚未获得同步授权,请继续往下阅读。
在用户级 settings.json 中注入同步标识
按下 Ctrl + ,(Windows/Linux)或 Cmd + ,(macOS) → 右上角点击“打开设置(JSON)”图标。注意:务必确保打开的是用户级 settings.json,路径中不应出现 .vscode/,而应是类似 %APPDATA%\Code\User\settings.json(Windows)或 ~/.config/Code/User/settings.json(Linux/macOS)的路径。
在此文件最外层大括号 {} 内部,插入以下一行内容:
"fitten.code.syncEnabled": true,
注意:如果前方已存在其他配置项,此行末尾需添加英文逗号。而且不能放在任何嵌套对象内部,必须是顶级键值对,否则同步开关完全不会生效。
跨平台多端配置同步实操
方法一:VS Code → PyCharm 自动同步(推荐)
第一步:在 VS Code 中配置好所有 Prompt 规则(例如 fitten.code.promptRules 对象),保存 settings.json;
第二步:启动 PyCharm → File > Settings > Plugins → 确认 Fitten Code 已启用 → 点击右下角 Fitten Code 图标 → 选择“同步配置”,等待进度条完成;
第三步:重启 PyCharm,随便打开一个 Python 文件,输入 # 触发注释生成,查看生成的是否是在 VS Code 中设定的 Google 风格 Docstring。如果无误,则同步成功。
方法二:远程 Dev Container 手动拉取
如果远程环境无法直接连接 Fitten 服务器,也无需慌张。将本地配好的 settings.json 中所有以 fitten.code. 开头的字段(包括 syncEnabled 和 promptRules)完整复制出来;然后粘贴到远程服务器的 $HOME/.vscode-server/data/Machine/settings.json 文件末尾(注意补全逗号,确保 JSON 结构合法)。切勿覆盖原文件,仅追加字段,随后执行 killall -u $USER code-server 重启服务进程,再打开 IDE 即可看到同步过来的配置。
