企业官网建设流程全解析

DeepSeek-Reasonix配置文件速查表：reasonix.toml全字段一篇讲透

【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix

DeepSeek-Reasonix 是一款面向终端的 DeepSeek 原生 AI 编码智能体（AI coding agent），它的模型选择、界面、工具、沙箱、机器人等几乎所有行为，都由一份 TOML 格式的reasonix.toml 配置文件控制。本文作为一份 Reasonix 配置文件速查表，把reasonix.toml的每个字段、配置优先级和常见模板一次讲透，新手照着抄就能用。

reasonix.toml 配置优先级与存放位置

写配置前，先搞清楚两个问题：文件放哪里、冲突时谁说了算。

解析顺序（高 → 低）：

命令行 flag > ./reasonix.toml > 全局 config.toml > 内置默认值

三点关键规则：

• 🔐密钥永远不写进 TOML。配置里只写api_key_env指定的环境变量名（如DEEPSEEK_API_KEY），真实密钥值保存在全局.env中。
• 部分字段标注为user/global only（仅全局生效），项目里的reasonix.toml无法覆盖它们。
• 设置REASONIX_HOME可将整个 Reasonix home 目录迁移（适合便携安装/测试）。

路径细节可查阅项目文档docs/CONFIG_PATHS.zh-CN.md与docs/GUIDE.zh-CN.md。

顶层字段速查：default_model 与 language

[ui] 与 [desktop]：界面显示配置

[ui]控制CLI/TUI 终端界面，[desktop]控制桌面端：

[[providers]]：模型与供应商（最核心区块）

一个 provider = 一个服务商端点（base_url + key），可挂载多个模型。这是 reasonix.toml 中字段最密集的部分：

最小可用示例：

[[providers]] name = "deepseek" kind = "openai" base_url = "https://api.deepseek.com" models = ["deepseek-v4-flash", "deepseek-v4-pro"] default = "deepseek-v4-flash" api_key_env = "DEEPSEEK_API_KEY" context_window = 1000000 effort = "high"

💡 桌面端「Settings → Model → Access → Add provider」内置了 Kimi、GLM、MiniMax、Qwen、Ollama Cloud 等大量预设，填好后会自动帮你生成这段 TOML。

[agent]：智能体行为调优

[tools]、[environment] 与 [sandbox]：工具、环境与沙箱

[tools] enabled = [] # 空 = 启用全部内置工具 bash_timeout_seconds = 120 # 前台 bash 安全上限，0 = 不设限 mcp_startup_timeout_seconds = 30 mcp_call_timeout_seconds = 300 [tools.background_jobs] stalled_warning_seconds = 900 # 后台任务静默多久后提示一次 [environment] enabled = true # 启动时注入 OS/shell/常见工具的稳定摘要 offline = false # 无出站网络时设 true，避免无效重试

沙箱用于收缩工具调用的「爆炸半径」：

[sandbox] workspace_root = "" # 空 = 当前目录 allow_write = ["/tmp"] # 额外允许写入的目录 forbid_read = ["${HOME}/.ssh"] # 对读取/列表/搜索及沙箱 bash 隐藏 bash = "enforce" # macOS/Linux 默认 enforce；Windows 固定 off network = true

⚠️ 路径请用绝对路径或${HOME}，配置值中的~不会被展开。

[skills]、[plugins]、[bot]、[serve]：扩展能力速查

三套可直接抄的 reasonix.toml 模板

① 极简入门（只换默认模型）

default_model = "deepseek" [[providers]] name = "deepseek" kind = "openai" base_url = "https://api.deepseek.com" models = ["deepseek-v4-flash"] api_key_env = "DEEPSEEK_API_KEY"

② 控费 + 中文思考

default_model = "deepseek" language = "zh" [agent] compact_ratio = 0.85 reasoning_language = "zh" [[providers]] name = "deepseek" kind = "openai" base_url = "https://api.deepseek.com" models = ["deepseek-v4-flash"] api_key_env = "DEEPSEEK_API_KEY" max_output_tokens = 32768

③ 双模型 + 沙箱收紧（生产向）

default_model = "deepseek" [agent] planner_model = "deepseek-pro" [sandbox] workspace_root = "" forbid_read = ["${HOME}/.ssh"] bash = "enforce" [[providers]] name = "deepseek" kind = "openai" base_url = "https://api.deepseek.com" models = ["deepseek-v4-flash", "deepseek-v4-pro"] default = "deepseek-v4-flash" api_key_env = "DEEPSEEK_API_KEY" effort = "high"

常见问题 FAQ

项目配置和全局配置冲突时谁生效？

命令行 flag 最高，其次./reasonix.toml，再其次是全局config.toml。但标注为 user/global only 的字段例外——项目配置无法覆盖，它们只认全局。

API Key 到底应该写在哪？

只写在全局<Reasonix home>/.env（macOS/Linux 为~/.reasonix/.env）。reasonix.toml里只写api_key_env的变量名。setup 向导、桌面端设置页、CLI 缺 key 提示都读写同一个.env，不要把sk-...明文放进 TOML。

从旧版本升级，配置会自动迁移吗？

会。v1.8.1 起启动时自动、非破坏性地把旧路径配置（如~/.config/reasonix/config.toml）复制进 Reasonix home，原文件保留。若自动迁移漏了数据，可在 CLI 或桌面端输入/migrate手动补救。

📌 把本文配合仓库根目录的reasonix.example.toml（每一行都有注释）对照阅读，就是 reasonix.toml 最完整的字段说明书。

【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix