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-ReasonixDeepSeek-Reasonix 是一款面向终端的 DeepSeek 原生 AI 编码智能体AI coding agent它的模型选择、界面、工具、沙箱、机器人等几乎所有行为都由一份 TOML 格式的reasonix.toml 配置文件控制。本文作为一份 Reasonix 配置文件速查表把reasonix.toml的每个字段、配置优先级和常见模板一次讲透新手照着抄就能用。reasonix.toml 配置优先级与存放位置写配置前先搞清楚两个问题文件放哪里、冲突时谁说了算。概念位置项目配置项目根目录./reasonix.toml当前仓库根目录的reasonix.example.toml就是官方完整示例直接复制改名即可全局配置macOS/Linux~/.reasonix/config.tomlWindows%APPDATA%\reasonix\config.tomlProvider 密钥全局Reasonix home/.env唯一运行时来源解析顺序高 → 低命令行 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字段示例说明default_modeldeepseek默认模型。可填 provider 名→其默认模型或provider/model全名languagezh界面语言留空则从$LANG/$REASONIX_LANG自动检测[ui] 与 [desktop]界面显示配置[ui]控制CLI/TUI 终端界面[desktop]控制桌面端字段可选值说明[ui].themeauto|dark|light终端配色REASONIX_THEME可临时覆盖[ui].theme_stylegraphite|aurora|slate|carbon|nocturne|amber主题风格[ui].cursor_shapeblock|underline|bar输入光标形状默认bar避免遮挡中日韩双宽字符[ui].show_turn_usagetrue/false是否在回滚区显示每轮 token/费用回执[ui].shortcut_layoutclassic|desktop快捷键布局兼容项ShiftTab 切换 PlanCtrlY 切换 YOLO[desktop].layout_styleclassic|workbench|creation桌面端布局风格[desktop].theme/terminal_themeauto|dark|light桌面端及内置终端主题[[providers]]模型与供应商最核心区块一个 provider 一个服务商端点base_url key可挂载多个模型。这是 reasonix.toml 中字段最密集的部分字段说明nameprovider 名称default_model里引用它kindopenaiOpenAI 兼容或anthropic直连 Messages APIbase_urlAPI 地址models/model多模型列表或单模型写法单模型适合需要独立 base_url 的场景default缺省取models第一个api_key_env密钥环境变量名真值在全局.envcontext_window上下文窗口tokenmodel_overrides按模型单独覆盖上下文窗口等能力max_output_tokens每轮输出预算0自动 /32768控费 /65536重推理billing_currency/billing_mode冻结的官方标价币种CNY/USD、计费模式payg/subscription_equivalentprices显式锁定自定义价格每 1M token含cache_hit/input/outputeffort推理档位disabled|low|high|maxthinking仅 anthropic 类扩展思考如adaptivereasoning_protocolauto|deepseek|openai|none控制推理协议supported_efforts/default_effort自定义/effort命令暴露的档位auth_headertrue时改用 Bearer 认证适配部分网关web_search开启联网搜索能力最小可用示例[[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]智能体行为调优字段默认说明temperature0.0采样温度编码场景保持 0 更稳定system_prompt/system_prompt_file内置自定义人设文件路径可指向工作区或 homecompact_ratio0.80唯一的自动上下文维护触发阈值预设 0.70激进/ 0.80推荐/ 0.85偏晚planner_model无设置后启用双模型协同低频规划器subagent_model/subagent_models无子代理默认模型 / 按技能名覆盖max_subagent_concurrency6会话级子代理总并发task/fleet/skillsmax_parallel_writers3写路径不重叠时的并行写入上限output_style默认explanatory|learning|concise或自定义.reasonix/output-styles/name.mdreasoning_languageauto可见思考文本语言auto|zh|enrecovery_model无低风险自动恢复的评审模型逐级回退[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 默认 enforceWindows 固定 off network true⚠️ 路径请用绝对路径或${HOME}配置值中的~不会被展开。[skills]、[plugins]、[bot]、[serve]扩展能力速查区块关键字段用途[skills]paths/excluded_paths/disabled_skills/disable_implicit_invocation追加自定义技能目录、隐藏约定来源或禁用技能内置 explore/review 等开箱即用[[plugins]]name/command/startup_timeout_seconds/call_timeout_seconds/tool_timeout_seconds外接 MCP 兼容的 stdio 插件每个是独立可执行文件[bot]enabled/queue_mode/[bot.allowlist]/[bot.qq]等QQ、飞书、微信多频道 IM 机器人密钥一律走环境变量[serve]auth_mode/token/password_hash/behind_proxyreasonix serve的 HTTP 前端认证none/token/password[billing]display_currency仅切换显示币种auto/CNY/USD不改写官方标价[notifications]enabled/turn_done/approval_request/ask_request回合完成、工具审批、提问等待时的系统通知三套可直接抄的 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/.envmacOS/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考