配置参考
KaaS 通过 TOML 文件进行配置(默认:工作目录下的 kaas.toml)。每个 section 控制一个特定子系统。
[server]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
host | string | "0.0.0.0" | 监听地址 |
port | int | 8080 | 监听端口 |
[storage]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
driver | string | "sqlite" | 存储驱动:"sqlite" 或 "mysql" |
sqlite_path | string | "./data/kaas.db" | SQLite 数据库文件路径 |
kb_dir | string | "./data" | 知识库数据目录 |
[worker]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
extract_workers | int | 4 | 并行提取 worker 数量 |
pipeline_concurrency | int | 2 | 并发 pipeline 任务数 |
poll_interval_ms | int | 1000 | 队列轮询间隔(毫秒) |
lease_timeout_sec | int | 300 | Worker 租约超时(秒) |
cb_failure_threshold | int | 5 | 熔断器失败阈值 |
cb_cooldown_sec | int | 30 | 熔断器冷却时间(秒) |
[ai]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
mcp_url | string | "" | 远程 MCP 上游地址(已废弃 — 请改用 [ai.mcp]) |
[ai.daemon]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
command | string | "uv" | 守护进程命令 |
args | []string | ["run", "--directory", "py", "kb-ai", "daemon"] | 守护进程命令参数 |
concurrency | int | 8 | 守护进程最大并发数 |
warmup_timeout_sec | int | 30 | 启动超时(秒) |
max_restarts | int | 5 | 最大重启次数 |
[ai.mcp]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled | bool | false | 启用原生 MCP streamable-http 端点(/mcp) |
token | string | "" | Bearer token 认证(空值表示不验证) |
timeout_sec | int | 120 | 工具调用超时(秒) |
[llm]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
api_key | string | "" | OpenAI 兼容 API 密钥 |
base_url | string | "https://api.openai.com/v1" | API 端点 URL |
model | string | "gpt-4o-mini" | 模型名称 |
summarize_model | string | (同 model) | 摘要任务使用的模型 |
[log]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
level | string | "info" | 日志级别:debug / info / warn / error |
format | string | "json" | 日志格式:json / text |
[upload]
| 键 | 类型 | 默认值 | 说明 |
|---|---|---|---|
max_body_bytes | int | 31457280 | multipart body 最大尺寸(30 MiB) |
max_file_size | int | 1048576 | 单文件最大尺寸(1 MiB) |
max_zip_file_size | int | 5242880 | zip 压缩包最大尺寸(5 MiB) |
max_files_per_upload | int | 20 | 单次上传最大文件数 |
max_zip_entries | int | 200 | zip 中最大条目数 |
max_zip_extracted_size | int | 31457280 | 解压后最大总尺寸(30 MiB) |