@@ -336,7 +336,7 @@ stateDiagram-v2
- 兼容:旧版 `models[]` (扁平)自动迁移到 `platforms[]` 层级;旧版 `web_search.*` 迁移到 `mcp_servers[]` ( log.info 提示)。
- 规范化:`normalizePlatforms` 校验 `name/url/type` , key 层 `concurrency` , model 层 `{id, display_name, vision, enable, extra_params, thinking_params, profile}` ;同平台内 model id 必须唯一(内部唯一键 = 平台名/模型id);`profile` 引用不存在的名字直接报错。
- `model_profiles` (顶层,`normalizeModelProfiles` ):多套可复用的 prompt+tools 组合,每项 `{tools_allow?, system_prompt_file?}` ,两者至少配一个。`tools_allow` 按**最终发给模型的工具名**匹配(内置 + MCP,含 `服务名__` 前缀,与 prompt.txt dump 同源可对);未配 = 全量,**空数组 `[]` = 零工具(纯文本组合)**——与 MCP 的 `tools_allow` (空名单视作未配)有意不同。`system_prompt_file` 相对 `server/templates/` ( compose 已 bind-mount ./app/server,宿主直接可改),**配置加载时一次性读入常驻内存**,缺失/为空报错拦在保存/重启预检;自定义文件 = 完全接管模板正文,技能清单靠模板内 `{APP_SKILLS}` 占位符就地插入(不放 = 无技能段;默认模板同机制,见 §5.2),语言指令始终尾拼。运行期切换(前端传参)零 IO、不碰本配置。
- 默认值(`DEFAULTS` ):port=8090、workspace_root/data_root=`/workspace/tasks` `/workspace/data` 、log_level=info、terminal 30s/10K、agent temperature=1.0、max_tool_iterations=5 0、max_retries=2、model_hold 3min/30min/10s、上传 1.5MB/2000px/0.85;内置 `model_profiles` 含 `mini` (文件/终端/网页白名单 + `mini-system.txt` )与 `zero` (零工具 + `zero-system.txt` )。`config.yml` 只覆盖 deploy 相关段,其余走默认值;整份清单见 `app/config.example.yml` 。
- 默认值(`DEFAULTS` ):port=8090、workspace_root/data_root=`/workspace/tasks` `/workspace/data` 、log_level=info、terminal 30s/10K、agent temperature=1.0、max_tool_iterations=10 0、max_retries=2、model_hold 3min/30min/10s、上传 1.5MB/2000px/0.85;内置 `model_profiles` 含 `mini` (文件/终端/网页白名单 + `mini-system.txt` )与 `zero` (零工具 + `zero-system.txt` )。`config.yml` 只覆盖 deploy 相关段,其余走默认值;整份清单见 `app/config.example.yml` 。
- 读写:`readConfigText` / `writeConfigText` (先校验后写,无原子 rename,因 bind mount 上 rename 会 EBUSY);`applyEditsToText` 用 `YAML.Document` 保留注释。
- `getConfig` 是浅引用,路由层拿到的就是运行中实例,**改完 in-memory 不影响**(要重启)。
@@ -473,7 +473,7 @@ AI 通过 `schedule_task` 工具为所在会话建周期性任务(`scheduled_t
- `platforms[].keys[].models[]` —— 三层层级。内部唯一键 = `平台名/模型id` (用于历史会话回绑、用量统计),**改名等于重建其下所有模型**。
- `model_profiles` (顶层)—— 多套可复用的 prompt+tools 组合(`{tools_allow?, system_prompt_file?}` );模型层用 `profile: <名>` 引用,不配 = 默认全量。内置 `mini` /`zero` 两套默认组合,可用同名覆盖。小模型省上下文用,详见 §5.8;运行期可前端切换(见 §5.1)。
- `agent.max_tool_iterations` (默认 2 0)—— 单轮迭代上限(含工具调用),到顶自动停止并提示用户继续输入。
- `agent.max_tool_iterations` (默认 10 0)—— 单轮迭代上限(含工具调用),到顶自动停止并提示用户继续输入。
- `terminal.max_output_chars` (默认 10000)—— AI 看到的命令输出上限;executor 侧另有 `EXECUTOR_MAX_OUTPUT_CHARS=200000` 兜底。
- `skills.skills_root` —— 缺省取 `workspace_root` 的同级 `skills/` 。
- `model_hold` —— 保持租约;详情见 §5.1。