项目配置 Reference

NOTE

targets.<adapter> 的 artifact、enabled 与 scope 参与 apply 选择流程。 scope 只包含 project | user；CLI --scope 优先于 target 配置，默认 project。Adapter 必须显式声明支持 user 才能获得用户目录写入权限。

项目唯一配置文件是根目录 ai.config.js。它选择 Preset、Extension 和 Target，并提供项目最高优先级覆盖；Preset 包的 package.json#ai 是另一种容器，见 Preset Manifest。

export default {
  presets: ["base", "team"],
  capabilities: {},
  extensions: ["ai-jue-adapter-openclaw"],
  targets: {
    claude: { artifact: "project", scope: "user" },
    codex: { artifact: "auto", scope: "project" }
  },
  context: { global: "Project-specific constraints." },
  skills: {},
  agents: {},
  commands: {},
  rules: {},
  hooks: {},
  mcp: { servers: {} },
  tools: { codex: {}, openclaw: {} },
  language: "zh"
};

顶层字段

字段	类型	默认值	含义
`presets`	`string[]`	`[]`	有序 Preset 引用
`capabilities`	`Record<string, CapabilityRef>`	`{}`	外部 Capability 叶子
`extensions`	`string[]`	`[]`	显式信任并加载的 Extension 包
`targets`	`Record<string, TargetSelection>`	`{}`	目标与 Artifact 选择
`context.global`	`string`	`""`	项目最高优先级上下文
`skills`	`Record<string, Skill>`	`{}`	内联 skill 覆盖
`agents`	`Record<string, Agent>`	`{}`	内联 agent 覆盖
`commands`	`Record<string, Command>`	`{}`	内联 command 覆盖
`rules`	`Record<string, Rule>`	`{}`	内联 rule 覆盖
`hooks`	`Record<string, Hook>`	`{}`	内联 hook 覆盖
`mcp.servers`	`Record<string, McpServer>`	`{}`	MCP server
`tools`	`Record<string, unknown>`	`{}`	target-specific settings
`language`	`"zh" \| "en"`	`"en"`	生成内容语言

未知字段失败。

`TargetSelection`

字段	类型	默认值	规则
`enabled`	`boolean`	`true`	`false` 时跳过自动发现与 `--all`；显式 `--adapter` 仍按用户选择执行
`artifact`	`string \| "auto"`	`"auto"`	必须由 Adapter 声明
`scope`	`"project" \| "user"`	`"project"`	选择项目或用户 Artifact 根；Adapter 不支持时在写入前失败

auto 选择 Adapter 的稳定默认 Artifact。非默认 Artifact 通过 artifact 或 --artifact 显式选择；该选择进入 Artifact 转换环境，不进入 Canonical DSL。

配置发现根与 Artifact 根彼此独立。scope: "user" 仍从当前项目加载 Preset、 Capability 和 lock，但 Core 将获授权 Artifact 根解析为用户家目录。Plugin、 compatible-bundle 与 skill-plugin 不能和 user scope 组合。

Extension 加载

安装依赖不等于信任。只有 extensions 显式列出的包才加载可执行入口。Adapter 内置于 Jue 发行包时不需要重复声明。Extension 请求的实际副作用由 apply 在执行前逐项展示和授权。

合并顺序

低到高：

presets 按数组顺序递归展开；
项目 capabilities；
项目 .ai/；
根 AGENTS.md；
项目内联 Canonical 字段；
将 tools.<target> 作为当前目标的独立 Adapter 配置。

context.global 分层追加；结构化能力按 ID 深合并；类型冲突失败；每次覆盖记录 provenance。Target、Extension、Artifact 选择和 tools.<target> 不进入 Canonical DSL。

配置发现与错误

Core 只从 --config 或 <cwd>/ai.config.js 加载项目配置。配置加载失败、未知字段、重复 ID、无效 Target、Extension API 不兼容均退出 1，且不得部分执行 apply。

项目配置 Reference ​

顶层字段 ​

TargetSelection ​

Extension 加载 ​

合并顺序 ​

配置发现与错误 ​