配置文件
DSCC 会从多个位置读取 JSON 配置与 Markdown 指令文件并合并。
配置优先级
自低到高(冲突时高优先级生效),来自
crates/runtime/src/config.rs:197–259:
| # | 路径 | 范围 |
|---|---|---|
| 1 | ~/.dscc.json |
用户,旧版 |
| 2 | ~/.dscc/settings.json |
用户,新版 |
| 3 | ./.dscc.json |
项目,旧版 |
| 4 | ./.dscc/settings.json |
项目,新版 |
| 5 | ./.dscc/settings.local.json |
本地覆盖(最高) |
指令文件
合并进系统 prompt 的实现在
crates/runtime/src/prompt.rs:202–223,从 cwd
向上递归查找。识别的文件名:
DSCC.mdDSCC.local.md.dscc/DSCC.md.dscc/instructions.md
| 限制 | 数值 | 来源 |
|---|---|---|
| 单文件上限 | 4000 字符 | prompt.rs:40–41 |
| 总上限 | 12000 字符 | prompt.rs:40–41 |
| 去重 | 按内容哈希 | prompt.rs |
顶层配置键
| 键 | 作用 |
|---|---|
model |
默认模型 id |
env |
注入工具调用的环境变量 |
hooks |
PreToolUse / PostToolUse 命令数组 |
permissions |
defaultMode 与每工具规则 |
permissionMode |
默认模式的简写 |
mcpServers |
具名 MCP 服务器定义 |
plugins |
插件定义 |
enabledPlugins |
启用的插件列表 |
sandbox |
沙箱开关 |
oauth |
OAuth 客户端配置 |
完整 schema 见 docs/reference/config-schema.md。
相关
- hooks.md
hooks语义。 - mcp-servers.md
mcpServers。