Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

设置

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
outputStyledefault、concise 或自定义样式
sessionDefaultSettings.interactionModeauto、spec
sessionDefaultSettings.autonomyLeveloff、low、medium、high
cloudSessionSynctrue、false
diffModegithub、unified
completionSound、awaitingInputSound、soundFocusMode提示音与何时播放
permissionRules带版本的对象,含 rules 数组(见「权限规则」)
commandAllowlist / commandDenylist / commandBlocklist已弃用但仍被尊重,新策略请用 permissionRules
includeCoAuthoredByDroid提交里是否加 Droid 共同作者
enableDroidShield是否启用 Droid Shield(密钥泄露防护)
hooksDisabled、disabledSkills、ideAutoConnect、showThinkingInMainView关闭 hooks、禁用技能、IDE 自动连接、主视图显示思考