设置
Droid 的 settings.json 位置、本地覆盖与常用设置项。
settings.json 是个人 CLI 配置文件。在 droid 里输入 /settings 可以交互地调整,改动立即生效并保存到设置文件。位置:macOS/Linux 为 ~/.factory/settings.json,Windows 为 %USERPROFILE%\.factory\settings.json,不存在时首次运行会按默认值创建。本地覆盖:在任何 .factory/ 文件夹里与 settings.json 并列放 settings.local.json(用户级 ~/.factory/ 或项目级 <project>/.factory/),它在同一级别的 settings.json 之上合并,遵循同样的层级优先;想把机器特有的偏好排除在版本控制外,就把它加进 .gitignore。组织通常托管的设置(模型策略、网络限制等)见企业控制文档。旧的 .droid.yaml 已被取代:偏好用 settings 文件,仓库指令用 AGENTS.md,集成和自动化用 MCP、hooks、skills。
| 设置 | 选项 |
|---|---|
model | 任何可用的模型 ID(以官方 Models 页为准) |
reasoningEffort | 取决于模型:none、dynamic、off、minimal、low、medium、high、xhigh、max |
outputStyle | default、concise 或自定义样式 |
sessionDefaultSettings.interactionMode | auto、spec |
sessionDefaultSettings.autonomyLevel | off、low、medium、high |
cloudSessionSync | true、false |
diffMode | github、unified |
completionSound、awaitingInputSound、soundFocusMode | 提示音与何时播放 |
permissionRules | 带版本的对象,含 rules 数组(见「权限规则」) |
commandAllowlist / commandDenylist / commandBlocklist | 已弃用但仍被尊重,新策略请用 permissionRules |
includeCoAuthoredByDroid | 提交里是否加 Droid 共同作者 |
enableDroidShield | 是否启用 Droid Shield(密钥泄露防护) |
hooksDisabled、disabledSkills、ideAutoConnect、showThinkingInMainView | 关闭 hooks、禁用技能、IDE 自动连接、主视图显示思考 |