配置字段
权威来源：assets/config/config.example.yaml。
所有字段都可用 MISTER_MORPH_... 环境变量覆盖，映射规则见环境变量。
Web Settings
Console Settings 覆盖本页所有仍受支持的公开字段。浏览器只提交发生变化的字段；文件 revision 已变化时返回冲突，不覆盖外部编辑。Secret 明文不会返回浏览器，只能替换或清除。环境变量和命令行参数管理的字段只读。每个字段会说明它是立即生效、对新任务生效、需要重启 runtime，还是需要重启进程。编辑远程 endpoint 时，配置写入由选中的 Morph 执行。
全局
| 字段 | 含义 |
|---|---|
user_agent | 全局 HTTP User-Agent，作用于 url_fetch、web_search 等外联工具。 |
LLM
| 字段 | 含义 |
|---|---|
llm.inference_provider | 面向用户的推理供应商；会派生协议层 provider 和 API Base。 |
llm.provider | 协议层 provider，通常由 llm.inference_provider 派生；保留给旧配置和高级覆盖。 |
llm.model | 主循环默认模型名。 |
llm.endpoint | API Base；只有 *_compatible 这类推理供应商必须显式填写。 |
llm.api_key | 提供方 API Key。建议写成 ${ENV_VAR}。 |
llm.headers.<name> | 可选的自定义 LLM 请求头。 |
llm.cache_ttl | Provider cache 提示或 duration。 |
llm.cache_key_prefix | Prompt cache key 前缀。 |
llm.request_timeout | 单次 LLM 请求超时时间。 |
llm.temperature | 可选的默认采样温度；未设置时不强制传给提供方。 |
llm.reasoning_effort | 可选推理强度（none/minimal/low/medium/high/max/xhigh）。 |
llm.reasoning_budget_tokens | 可选推理预算 token；openai_resp 下会忽略并记录 warning。 |
llm.pricing_file | 可选的本地价格表路径。 |
llm.tools_emulation_mode | 工具调用仿真策略（off/fallback/force）。 |
llm.azure.deployment | Azure OpenAI 的 deployment 名称。 |
llm.bedrock.aws_key | Bedrock 的 AWS Access Key。 |
llm.bedrock.aws_secret | Bedrock 的 AWS Secret Key。 |
llm.bedrock.aws_session_token | Bedrock 临时凭证的 session token。 |
llm.bedrock.aws_profile | Bedrock 使用的 AWS profile。 |
llm.bedrock.region | Bedrock 区域。 |
llm.bedrock.model_arn | Bedrock 模型 ARN。 |
llm.cloudflare.account_id | Cloudflare Workers AI 账号 ID。 |
llm.cloudflare.api_token | Cloudflare Workers AI API Token。 |
llm.image.provider | 图像模型提供方；为空时可继承部分主 LLM 配置。 |
llm.image.endpoint | 图像模型 API 基础地址。 |
llm.image.api_key | 图像模型 API Key。 |
llm.image.model | image_generate 和 image_edit 使用的图像模型名。 |
llm.image.request_timeout | 图像模型请求超时。 |
llm.image.options.openai | OpenAI 图像模型的额外 provider options。 |
llm.image.options.gemini | Gemini 图像模型的额外 provider options。 |
llm.image.options.cloudflare | Cloudflare 图像模型的额外 provider options。 |
llm.profiles.<profile>.* | 命名 LLM 配置档；可覆盖 inference_provider、model、key 等，用于路由不同任务。 |
llm.profiles.<profile>.supports_image_parts | 命名 profile 是否支持图片消息部分的显式覆盖。 |
llm.profiles.<profile>.headers.<name> | profile 级自定义请求头；同名 header 会覆盖顶层 llm.headers。 |
llm.routes.<purpose> | route 定义；purpose 支持 main_loop/addressing/awareness/heartbeat/think/plan_create。 |
llm.routes.<purpose>.profile | 固定把该 route 绑定到一个 profile。 |
llm.routes.<purpose>.candidates[].profile | 该 route 参与分流的 profile。 |
llm.routes.<purpose>.candidates[].weight | 该候选 profile 的权重；当前 run 内只会选中一个主候选。 |
llm.routes.<purpose>.fallback_profiles[] | 该 route 的本地回退链；主候选失败后按顺序尝试。 |
Logging
| 字段 | 含义 |
|---|---|
logging.level | 日志级别（debug/info/warn/error）。 |
logging.format | 日志格式（text/json）。 |
logging.add_source | 是否在日志中附带源码位置（文件:行）。 |
logging.file.dir | JSONL 日志目录。 |
logging.file.max_age | 日志文件保留时间。 |
logging.include_thoughts | 是否输出模型 thoughts（可能包含敏感信息）。 |
logging.include_tool_params | 是否记录工具调用参数（会脱敏/截断）。 |
logging.include_skill_contents | 是否记录已加载 SKILL.md 内容（截断后）。 |
logging.max_thought_chars | thoughts 日志最大字符数。 |
logging.max_json_bytes | 参数 JSON 日志最大字节数。 |
logging.max_string_value_chars | 日志中单个字符串值的最大长度。 |
logging.max_skill_content_chars | SKILL.md 记录时最大字符数。 |
logging.redact_keys | 额外脱敏键名列表。 |
Secrets 与 Auth Profiles
| 字段 | 含义 |
|---|---|
secrets.allow_profiles | 允许运行时使用的认证 profile 白名单。 |
secrets.aws_secrets_manager.region | AWS Secrets Manager 区域。 |
secrets.aws_secrets_manager.profile | AWS Secrets Manager 使用的 AWS profile。 |
auth_profiles.<id>.credential.kind | 凭证类型（如 api key/bearer）。 |
auth_profiles.<id>.credential.secret | 实际密钥内容，建议 ${ENV_VAR}。 |
auth_profiles.<id>.allow.url_prefixes | 允许访问的 URL 前缀白名单。 |
auth_profiles.<id>.allow.methods | 允许的 HTTP 方法白名单。 |
auth_profiles.<id>.allow.follow_redirects | 是否允许跟随重定向。 |
auth_profiles.<id>.allow.allow_proxy | 是否允许走系统代理。 |
auth_profiles.<id>.allow.deny_private_ips | 是否禁止私网/本地地址。 |
auth_profiles.<id>.bindings.url_fetch.inject.location | 凭证注入位置（例如 header/query）。 |
auth_profiles.<id>.bindings.url_fetch.inject.name | 注入字段名（例如 Authorization）。 |
auth_profiles.<id>.bindings.url_fetch.inject.format | 注入格式（例如 bearer）。 |
auth_profiles.<id>.bindings.url_fetch.allow_user_headers | 是否允许用户再额外传 header。 |
auth_profiles.<id>.bindings.url_fetch.user_header_allowlist | 允许用户自带的 header 白名单。 |
Guard
| 字段 | 含义 |
|---|---|
guard.enabled | 是否启用 Guard 安全层。 |
guard.dir_name | Guard 状态目录名（位于 file_state_dir 下）。 |
guard.network.url_fetch.allowed_url_prefixes | url_fetch 可访问目的地前缀白名单。 |
guard.network.url_fetch.deny_private_ips | 是否拒绝私网/本地 IP 目标。 |
guard.network.url_fetch.follow_redirects | url_fetch 是否允许重定向。 |
guard.network.url_fetch.allow_proxy | url_fetch 是否允许代理。 |
guard.redaction.enabled | 是否启用输出脱敏。 |
guard.redaction.patterns | 自定义脱敏正则模式。 |
guard.audit.jsonl_path | 审计日志 JSONL 路径（空则使用默认目录）。 |
guard.audit.rotate_max_bytes | 审计日志滚动大小阈值。 |
guard.approvals.enabled | 是否启用审批流程。 |
Tools
Console 的 Setup / Settings 页面，以及 /api/settings/agent，复用同一套 tools.<name>.enabled 嵌套结构。
Shell 默认值按平台区分：
- Linux / macOS：
tools.bash.enabled=true，tools.powershell.enabled=false - Windows：
tools.bash.enabled=false，tools.powershell.enabled=true - 两者都可以继续显式覆盖。
| 字段 | 含义 |
|---|---|
tools.read_file.max_bytes | read_file 单次最大读取字节数。 |
tools.read_file.deny_paths | read_file 拒绝读取的路径/文件名列表。 |
tools.write_file.enabled | 是否启用 write_file。 |
tools.write_file.max_bytes | write_file 单次最大写入字节数。 |
tools.spawn.enabled | 是否启用 spawn 工具。它只控制显式 spawn 入口，不影响 subtask 运行机制本身。 |
tools.coder.enabled | 是否启用 coder 工具。默认关闭，因为 Codex / Claude Code 子进程会绕过 approval 和 permission prompt。 |
tools.coder.path_extra | 只给 coder 启动 codex / claude 时追加的 PATH 目录列表。 |
tools.contacts_send.enabled | 是否启用 contacts_send。 |
tools.todo_update.enabled | 是否启用 todo_update。 |
tools.plan_create.enabled | 是否启用 plan_create。 |
tools.plan_create.max_steps | plan_create 默认最大步骤数。 |
tools.image_generate.enabled | 是否启用 image_generate。工具仍只会在图像模型已配置且当前任务有图像意图时注册。 |
tools.image_edit.enabled | 是否启用 image_edit。工具仍只会在图像模型已配置且当前任务有图像编辑意图或保留图像状态时注册。 |
tools.url_fetch.enabled | 是否启用 url_fetch。 |
tools.url_fetch.timeout | url_fetch 请求超时。 |
tools.url_fetch.max_bytes | url_fetch 直接返回时的最大读取字节数。 |
tools.url_fetch.max_bytes_download | url_fetch 下载到文件时的最大读取字节数。 |
tools.web_search.enabled | 是否启用 web_search。 |
tools.web_search.base_url | 搜索后端地址（当前默认 DuckDuckGo HTML）。 |
tools.web_search.timeout | web_search 请求超时。 |
tools.web_search.max_results | web_search 默认返回条数上限。 |
tools.bash.enabled | 是否启用 bash（高风险能力）。 |
tools.bash.timeout | bash 单次执行超时。 |
tools.bash.max_output_bytes | bash 每个输出流最大保留字节数。 |
tools.bash.deny_paths | bash 命令中禁止引用的路径列表。 |
tools.bash.injected_env_vars | 额外注入给 bash 子进程的环境变量。可为变量名字符串（配置加载时从父进程解析为固定 name=value），或 {name, value} 对象（注入字面量；配置文件中的 ${ENV_VAR} 会在读取时展开）。 |
tools.powershell.enabled | 是否启用 powershell（高风险能力）。 |
tools.powershell.timeout | powershell 单次执行超时。 |
tools.powershell.max_output_bytes | powershell 每个输出流最大保留字节数。 |
tools.powershell.deny_paths | powershell 命令中禁止引用的路径列表。 |
tools.powershell.injected_env_vars | 额外注入给 powershell 子进程的环境变量；格式同 tools.bash.injected_env_vars。 |
MCP
| 字段 | 含义 |
|---|---|
mcp.servers[].name | MCP 服务器标识名；会参与工具命名空间。 |
mcp.servers[].enable | 是否启用该 MCP 服务器配置。 |
mcp.servers[].type | 传输类型（stdio 或 http）。 |
mcp.servers[].command | stdio 模式下的启动命令。 |
mcp.servers[].args | stdio 模式命令参数。 |
mcp.servers[].env | stdio 模式传给子进程的环境变量。 |
mcp.servers[].url | http 模式 MCP Endpoint。 |
mcp.servers[].headers | http 模式自定义请求头（支持 ${ENV_VAR}）。 |
mcp.servers[].allowed_tools | 该服务器允许暴露的工具白名单；空表示全部。 |
ACP
| 字段 | 含义 |
|---|---|
acp.agents[].name | ACP agent 名称。 |
acp.agents[].command | 启动命令。 |
acp.agents[].args | 命令参数。 |
acp.agents[].env | 子进程环境变量。 |
acp.agents[].cwd | 默认工作目录。 |
acp.agents[].read_roots | 允许读取的根目录。 |
acp.agents[].write_roots | 允许写入的根目录。 |
acp.agents[].session_options | 传给 ACP session 的额外配置。 |
Bus / Contacts / Tasks / Skills
| 字段 | 含义 |
|---|---|
bus.max_inflight | 进程内消息总线最大并发在途数。 |
contacts.dir_name | 联系人业务状态目录名。 |
contacts.proactive.failure_cooldown | 主动发送失败后的冷却时长。 |
tasks.dir_name | task projection 快照目录名。 |
tasks.persistence_targets | 跨进程重启保存并恢复 task projection 的目标运行时；不影响统一 journal 记录。 |
tasks.rotate_max_bytes | task journal 单个分段的最大字节数。 |
skills.dir_name | skills 根目录名。 |
skills.enabled | 是否启用 skills 加载。 |
skills.load | 预加载 skill 列表；空列表表示加载全部已发现 skill。 |
Server 与 Console
| 字段 | 含义 |
|---|---|
server.auth_token | 运行时 API 鉴权 token（Bearer）。 |
server.max_queue | 任务队列最大长度。 |
console.listen | Console API + 静态资源监听地址。 |
console.base_path | Console 路由基础路径。 |
console.static_dir | Console 静态站点目录（生产构建产物）。 |
console.password | Console 明文密码（生产不推荐）。 |
console.password_hash | Console bcrypt 密码哈希。 |
console.session_ttl | Console 会话 token 有效期。 |
console.managed_runtimes | 由 console 进程托管的通道 runtime 列表（如 telegram/slack/lark）。 |
console.endpoints[].name | 外部 runtime endpoint 显示名称。 |
console.endpoints[].url | 外部 runtime endpoint 地址。 |
console.endpoints[].auth_token | 访问该 endpoint 的鉴权 token。 |
Telegram
| 字段 | 含义 |
|---|---|
telegram.bot_token | Telegram Bot Token。 |
telegram.allowed_chat_ids | 允许访问的 chat id 白名单；空表示不限制。 |
telegram.group_trigger_mode | 群聊触发策略（strict/smart/talkative）。 |
telegram.addressing_confidence_threshold | addressing 判定通过所需最小置信度。 |
telegram.addressing_interject_threshold | Telegram addressing 的 interject 上限阈值。 |
telegram.poll_timeout | 长轮询超时。 |
telegram.task_timeout | 单条消息任务超时（0s 表示沿用上层）。 |
telegram.max_concurrency | 并发处理 chat 的上限。 |
telegram.serve_listen | Telegram runtime API 监听地址。 |
Slack
| 字段 | 含义 |
|---|---|
slack.base_url | Slack Web API 基础地址（通常不用改）。 |
slack.bot_token | Slack Bot Token（xoxb）。 |
slack.app_token | Slack Socket Mode App Token（xapp）。 |
slack.allowed_team_ids | 允许 workspace 白名单。 |
slack.allowed_channel_ids | 允许 channel 白名单（也可用于心跳通知目标）。 |
slack.group_trigger_mode | 群聊触发策略（strict/smart/talkative）。 |
slack.addressing_confidence_threshold | addressing 判定通过所需最小置信度。 |
slack.addressing_interject_threshold | Slack addressing 的 interject 下限阈值。 |
slack.task_timeout | 单条消息任务超时。 |
slack.max_concurrency | 会话并发处理上限。 |
slack.serve_listen | Slack runtime API 监听地址。 |
LINE
| 字段 | 含义 |
|---|---|
line.base_url | LINE Messaging API 基础地址。 |
line.channel_access_token | LINE Channel Access Token。 |
line.channel_secret | LINE Webhook 签名校验密钥。 |
line.webhook_listen | LINE webhook 监听地址。 |
line.webhook_path | LINE webhook 路由路径。 |
line.allowed_group_ids | 允许 group 白名单；空表示不限制。 |
line.group_trigger_mode | 群聊触发策略（strict/smart/talkative）。 |
line.addressing_confidence_threshold | addressing 判定通过所需最小置信度。 |
line.addressing_interject_threshold | LINE addressing 的 interject 下限阈值。 |
line.task_timeout | 单条消息任务超时。 |
line.max_concurrency | 会话并发处理上限。 |
line.serve_listen | LINE runtime API 监听地址。 |
Lark
| 字段 | 含义 |
|---|---|
lark.base_url | Lark/飞书 Open API 基础地址。 |
lark.app_id | Lark App ID。 |
lark.app_secret | Lark App Secret。 |
lark.allowed_chat_ids | 允许 chat 白名单；空表示不限制。 |
lark.group_trigger_mode | 群聊触发策略（strict/smart/talkative）。 |
lark.addressing_confidence_threshold | addressing 判定通过所需最小置信度。 |
lark.addressing_interject_threshold | Lark addressing 的 interject 下限阈值。 |
lark.task_timeout | 单条消息任务超时。 |
lark.max_concurrency | 会话并发处理上限。 |
lark.serve_listen | Lark runtime API 监听地址。 |
Mixin Messenger
| 字段 | 含义 |
|---|---|
mixin.keystore_file | Mixin Developer Dashboard 生成的 Ed25519 keystore 文件路径。 |
mixin.allowed_conversation_ids | 允许的 conversation UUID；空表示不限制。 |
mixin.task_timeout | 单条消息任务超时。 |
mixin.max_concurrency | conversation 并发处理上限。 |
mixin.serve_listen | Mixin runtime API 监听地址。 |
Heartbeat
| 字段 | 含义 |
|---|---|
heartbeat.enabled | 是否启用心跳机制。 |
heartbeat.interval | 心跳执行间隔。Heartbeat 由 cron 服务调度；cron.enabled: false 时不运行。 |
循环限制与文件目录
workspace_dir 是运行时附着的目录，不是配置字段。它和 file_cache_dir、file_state_dir 的关系，见 文件系统根目录。
| 字段 | 含义 |
|---|---|
max_steps | 单次任务最多工具调用步数。 |
parse_retries | 模型输出 JSON 解析失败时的重试次数。 |
max_token_budget | 累计 token 预算上限（0 表示不限制）。 |
tool_repeat_limit | 同名工具在单任务中的重复成功调用上限。 |
timeout | 整个任务运行超时。 |
file_state_dir | 运行状态根目录（skills/tasks/contacts 等）。 |
file_cache_dir | 文件缓存根目录（下载文件、媒体临时文件等）。 |
file_cache.max_age | 缓存文件最大保留时长。 |
file_cache.max_files | 缓存文件数量上限。 |
file_cache.max_total_bytes | 缓存总大小上限。 |