DeepSeek-Reasonix 实战指南一个可长期常驻运行的配置驱动型编码 Agent【免费下载链接】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 编码 Agent以「前缀缓存稳定性」为设计前提支持计划模式、权限管控、工作区沙箱与逐轮 checkpoint目标是让 Agent 长时间自治运行时始终可读、可撤销。它提供终端 CLI/TUI、桌面端、浏览器reasonix serve与 ACP 编辑器接入四个入口共用同一套本地 Go 引擎。读完本文你可以完成四种安装路径中的任意一种、理解reasonix.toml配置体系的解析顺序与各核心配置段并从源码层面理解「缓存友好上下文维护」与「零摩擦单二进制分发」的工程实现。定位与核心特性官方中文 README 对项目的一句话定位是「可以一直开着跑的编码 Agent」一套本地引擎四个入口——终端、桌面端、浏览器或通过 ACP 接入编辑器。其核心特性可以归纳为五点以下均出自 README.zh-CN.md配置驱动provider、agent、启用的工具、插件全部在reasonix.toml中声明内核无硬编码模型多模型 · 可组合DeepSeek 作为预设内置任何 OpenAI 兼容端点都只是一条配置可选让两个模型协同执行器 规划器各自独立、缓存稳定的 session插件驱动MCP server 提供工具、提示词和资源Extension Protocol v1 Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI并通过版本化插件包分发缓存友好的上下文维护启动时注入稳定的环境摘要旧工具输出会先 snip/prune再进入摘要 compaction内置工具 schema 合约有文档和回归测试保护零摩擦分发CGO_ENABLED0单二进制一条命令交叉编译到六个目标平台产物是完全自包含的静态二进制。其中「内核无硬编码模型」这一点在源码中有直接对应CLI 入口 cmd/reasonix/main.go 通过空导入把 provider 与内置工具在编译期注册进内核——_ reasonix/internal/provider/anthropic、_ reasonix/internal/provider/openai、_ reasonix/internal/provider/responses和_ reasonix/internal/tool/builtin。内核本身只消费配置里声明的 provider模型能力如 reasoning 协议也完全由配置决定这与 README 宣称的「配置驱动」一致。安装四条路径CLI/TUI、桌面端和 VS Code 扩展都使用同一套本地 Reasonix 引擎按需选择即可。路径 ACLI / TUI任意支持的平台都可以通过 npm 安装原生二进制npm 包reasonix会自动拉取对应平台的原生二进制macOS 也可以使用 Homebrewnpm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制 brew install esengine/reasonix/reasonix # macOS预编译归档darwin|linux|windows × amd64|arm64和SHA256SUMS随每个官方 release 发布供无法使用 npm/brew 的环境手动下载校验。路径 B桌面端从官方下载页获取对应平台的安装包平台安装包架构macOS通用.dmg或.zipApple Silicon / IntelWindows安装器.exe或便携.zipx64 / ARM64Linux.deb或.tar.gzx64Windows 安装器通过 SignPath.io 完成代码签名证书由 SignPath 基金会免费提供。桌面端的构建细节前端 Electron 壳见 desktop/README.md。路径 CVS Code 扩展先完成路径 A 安装 CLI。扩展不内置 CLI而是启动本机的reasonix acp后端并提供原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。扩展 ID 为SivanLiu.reasonix-agent可在 Visual Studio Marketplace 与 Open VSX Registry 上检索安装编辑器侧的接入协议详见 ACP 编辑器接入文档。路径 D从源码构建git clone https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix.git cd DeepSeek-ReasonixCLI 构建README 要求 Go 1.25当前仓库 go.mod 固定了go 1.26.0与toolchain go1.26.6指令保持GOTOOLCHAINauto可让 Go 自动下载固定工具链也可以自行安装。make build # - bin/reasonix(.exe) make cross # - dist/darwin|linux|windows × amd64|arm64对照 Makefile 可以看到这两条命令的确切行为build目标执行CGO_ENABLED0 go build -ldflags ...产出bin/reasonix以及示例插件bin/reasonix-plugin-example。ldflags 通过git describe注入版本号、12 位 git commit 与构建时间——这与 cmd/reasonix/main.go 中version/gitCommit/buildTimeUTC三个变量一一对应reasonix --version即读取其中的 version 值cross目标循环遍历darwin|linux|windows × amd64|arm64六个GOOS/GOARCH组合每个都以CGO_ENABLED0编译输出dist/reasonix-os-arch。这正是「零摩擦分发」特性的实现来源CGO_ENABLED0保证产物不依赖任何 C 运行时目标机器上除二进制本身外无需安装任何东西。桌面端构建额外需要 Node 24 和 pnpm 10npm install -g pnpm10scripts/desktop-build.sh darwin/arm64 v0.0.0-dev # 每次构建一个平台无需安装系统 WebView 依赖Electron 壳自带 Chromium。快速开始CLI / TUI以下命令仅适用于通过路径 A 安装的 CLI/TUIreasonix setup # 配置 provider 和模型 reasonix # 启动交互式会话 reasonix run 把 main.go 里的 TODO 实现掉需要项目指令时可在交互式会话中运行/init。CLI 进阶用法见 CLI 命令参考、使用指南 与 配置路径。桌面端安装并启动桌面应用后在应用内配置 provider 和模型即可使用无需执行上面的 CLI 命令。配置体系reasonix.example.toml 全解读仓库根目录的 reasonix.example.toml 是官方给出的完整配置模板下面按配置段逐项展开。解析顺序与密钥管理文件头部注释明确了配置的解析顺序flag ./reasonix.toml Reasonix home/config.toml built-in defaults这与源码 internal/config/config.go 包注释完全一致flag 项目./reasonix.toml 用户配置目录config.toml 内置默认值。标注为 user/global only 的字段不会被项目级./reasonix.toml覆盖。密钥管理约定是provider 条目只通过api_key_env指定环境变量名实际的 key 值存放在 Reasonix 全局Reasonix home/.env中永远不要写进配置文件。顶层与 UIdefault_model deepseek # provider 名→ 其默认模型或 provider/model # language zh # 界面语言空 从 $LANG / $REASONIX_LANG 自动检测 [ui] theme auto # auto|dark|light只影响 CLI 配色REASONIX_THEME 可按次覆盖 # theme_style graphite # graphite|aurora|slate|carbon|nocturne|amber 及旧别名 # shortcut_layout desktop # classic|desktopShiftTab 切换 PlanCtrlY 切换 YOLO # cursor_shape bar # block|underline|barslim 默认值避免遮挡 CJK 字符 show_turn_usage true # 在滚动回显中显示每次请求的 token 与费用回执[desktop]段同理提供桌面端layout_styleworkbench|creation、theme、terminal_theme等[billing].display_currency只控制展示货币不会改写 provider 列表价——列表价以各 provider 的billing_currency来自官方价表或自定义价格为准。Agent 核心参数compact_ratio 与双模型协同[agent] temperature 0.0 compact_ratio 0.80 # 唯一自动触发阈值预设 0.70(激进) / 0.80(推荐默认) / 0.85(保守) # planner_model deepseek-pro # 可选启用两个模型协同执行器 规划器 # subagent_model deepseek-pro # runAssubagent 技能的默认模型 # max_subagent_concurrency 6 # 会话级子智能体并发task/fleet/skills # max_parallel_writers 3 # 写路径不重叠的并发写者数 # recovery_model # 可选低危自动恢复评审模型空 仅规则恢复 # reasoning_language auto # 可见推理文本auto|zh|en # output_style explanatory # explanatory|learning|concise 或 .reasonix/output-styles/name.mdcompact_ratio是上下文自动压缩的唯一触发阈值。源码侧可以印证其演进internal/config/load.go 中CompactRatio 0时回填默认值并把遗留的soft_compact_ratio归零internal/boot/boot.go 还会对旧版多阈值压缩配置做迁移MigrateLegacyMultiThresholdCompactionForRoot迁移时提示「Deprecated multi-threshold compaction keys were ignored.」——说明项目曾使用多阈值策略现已收敛为单一compact_ratio。压缩行为的回归保障见 internal/agent/compact_test.go 与基准 benchmarks/compaction/。planner_model对应 README 中「可选让两个模型协同执行器 规划器」规划器与执行器各自持有独立且缓存稳定的 session互不干扰前缀缓存。Provider 声明DeepSeek 与 Anthropic 两个标准示例reasonix.example.toml给出两个开箱即用的 provider 条目[[providers]] name deepseek kind openai base_url https://api.deepseek.com models [deepseek-v4-flash, deepseek-v4-pro] default deepseek-v4-flash # 可选默认取 models 首项 api_key_env DEEPSEEK_API_KEY context_window 1000000 effort high # thinking 默认开启disabled|low|high|max缺省 auto[[providers]] name claude kind anthropic model claude-opus-4-8 api_key_env ANTHROPIC_API_KEY context_window 1000000 price { cache_hit 0.5, input 5, output 25, currency $ } # 每 1M tokens thinking adaptive # 仅 anthropic kind在工具调用间往返签名推理块 effort high要点kind openai走 OpenAI 兼容协议kind anthropic直接说 Messages API无 OpenAI shim注意 anthropic provider 不启用 extended thinking 也不发送 temperature因为当前 Claude 模型拒绝采样参数见 internal/provider 下的实现说明一个 provider 条目可用models [...]暴露多个模型切换模型复用同一条连接无需重复声明base_url/api_key需要独立base_url的单模型则用model ...形式模型共享端点但需要不同 context window 时用model_overrides费用侧官方锚定价按 provider 冻结billing_currencyCNY|USDDeepSeek 存储的是峰值价Reasonix 会在发生时刻自动套用文档声明的半价时段仅当需要钉住自定义费率时才显式设置prices对走代理的 DeepSeek 模型会按模型名自动识别reasoning_protocol none可禁用识别openai强制走普通reasoning_effort。其他 OpenAI 兼容 provider 除非在此显式声明supported_efforts/default_effort否则不暴露/effort命令桌面端 Settings → Model → Access → Add provider 内置了 Kimi、MiMo、GLM/Z.AI、OpenCode Go/Zen、Qwen/DashScope、Ollama Cloud 等一系列可编辑预设详见注释与 PROVIDER_CATALOG.zh-CN.md。环境摘要、工具与沙箱[environment] enabled true # 启动时注入 OS、shell、常用工具的稳定摘要到提示词 offline false # 出站网络不可用时置 true避免无谓重试 [tools] enabled [] # 空 全部内置工具 bash_timeout_seconds 120 # 前台安全上限0 不设工具级上限 mcp_startup_timeout_seconds 30 # 后台 initialize tools/list 上限 mcp_call_timeout_seconds 300 # MCP 调用默认安全上限 [tools.background_jobs] stalled_warning_seconds 900 # 静默 900s 后每任务提醒一次0 禁用[environment].enabled true正是「启动时注入稳定的环境摘要」的实现入口对应 internal/environment 包——稳定摘要保证提示词前缀跨轮次不变是前缀缓存命中率的前提。沙箱配置限制工具调用的爆炸半径# [sandbox] # workspace_root # allow_write [/tmp] # forbid_read [${HOME}/.ssh] # bash enforce # macOS/Linux 默认 enforceWindows 无 OS 级 Bash 沙箱固定 off # network true写操作被约束在workspace_root空 当前目录加allow_write之内forbid_read会在 OS 级沙箱激活期间把敏感目录从读取/列目录/搜索工具乃至沙箱化 bash 中隐藏。路径支持绝对路径或${HOME}~不会被展开。Skills、Hooks、插件与 Bot 网关SkillsSKILL.md/name.md带 frontmatter形式的可调用剧本搜索路径包括.reasonix/skills、.agents/skills、.claude/skills项目级及同名全局目录内置 explore/research/review/security-review/test 开箱即用。模型侧通过run_skill/explore等工具调用用户侧用/name调用/skill命令可管理disable_implicit_invocation true可强制显式调用HooksPreToolUse / PostToolUse / PermissionRequest / UserPromptSubmit / Stop 五个时点不在reasonix.toml里配置而是放在Reasonix home/settings.json全局与project/.reasonix/settings.json项目exit 0 放行、exit 2 阻断仅 PreToolUse / UserPromptSubmitPlugins[[plugins]]声明外部 stdio MCP 插件独立可执行文件支持startup_timeout_seconds、按 server 与按工具的调用超时覆盖启用后在会话启动后自动后台连接可用/mcp或桌面 MCP 面板刷新/重连/禁用。仓库自带示例插件入口 cmd/reasonix-plugin-exampleBot 网关[bot]段支持 QQ / 飞书 / 微信多通道 IM botreasonix bot start --channels qq,feishu,weixin所有密钥只从环境变量读取提供消息合并窗口、队列模式steer|followup|collect|interrupt、按会话的路由[[bot.routes]]可绑定独立workspace_root与模型、配对与白名单/管理员体系以及本机 loopback 控制 API[bot.control]GET /status、GET /metrics、POST /send。完整用法见 机器人使用指南。Checkpoints 与 serve# [checkpoints] # retain_turns 100 # 保留多少轮的文件 payload # blob_quota_bytes 1073741824 # 1 GiB 软预算 [serve] # auth_mode none # none | token | password # token # token 模式预共享令牌空则自动生成 # password_hash # 可用 reasonix serve --hash-password password 生成 # behind_proxy false # 反代nginx/Caddy下置 true 以信任 X-Forwarded-*[checkpoints]控制 rewind 快照保留量受保护或当前轮次可能临时超出字节预算详见 Checkpoints 与 rewind 文档。reasonix serve是「浏览器入口」的宿主为 HTTP 前端提供认证token/password与反代适配。纵深解析为什么它能「一直开着跑」README 的卖点「Engineered around prefix-cache stability — leave it running」落在三层机制上1. 稳定前缀。[environment].enabled的启动摘要、固定的系统提示、不变的工具 schema 共同保证会话前缀逐轮稳定工具 schema 合约由 internal/tool/contract_lock_test.go、internal/tool/contract_test.go 等回归测试保护防止工具定义被无意改动而击穿缓存。仓库内还有scripts/check-cache-impact.sh、scripts/cache-guard.sh一类脚本用于在变更时检查缓存影响面。2. 分级上下文维护。旧工具输出不是直接全部进摘要先 snip/prune裁剪再进入摘要 compaction。核心实现在 internal/agent/context_manager.go投影逻辑见 internal/agent/compact_projection.go专项基准位于 benchmarks/compaction/含 snip_test.go与端到端基准 benchmarks/context-maintenance-e2e/benchmarks/下的 README.md 汇总了各基准用法。3. 逐轮可撤销。每轮 checkpoint 记录文件 payload[checkpoints]预算内可 rewind长时间自治运行因此「始终可读、可撤销」详见 docs/RECOVERY.zh-CN.md 与 docs/CHECKPOINTS.zh-CN.md。延伸阅读文档索引项目文档成体系地放在docs/下中文文档均为*.zh-CN.md与本文主题最相关的入口开始使用指南 · CLI 命令参考 · 配置路径 · ACP 编辑器接入功能与排障子智能体 Profile · Context Engine v2 · 能力诊断 · 恢复与安全模式 · 机器人使用指南 · Checkpoints 与 rewind工程与迁移规格 · 任务合约与暂停策略 · 工具合约 · 从 0.x 迁移扩展开发扩展概览 · 插件包与 Manifest v1 · Extension Protocol · Go SDK 与 starter小结DeepSeek-Reasonix 的技术形态可以概括为一个CGO_ENABLED0编译的纯 Go 单二进制引擎Makefile 的build/cross目标直接可复现配置即内核internal/config/config.go 定义四级解析顺序reasonix.example.toml 给出全量参数基线以稳定前缀 分级上下文维护 逐轮 checkpoint 支撑长期常驻运行。上手路径最短的组合是npm i -g reasonixreasonix setup需要深度定制时从reasonix.example.toml的 provider / agent / tools / sandbox 四个段切入再按延伸阅读索引深入各专题文档。项目采用 MIT 协议见 LICENSE。【免费下载链接】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），仅供参考 DeepSeek-Reasonix 实战指南：一个可长期常驻运行的配置驱动型编码 Agent
DeepSeek-Reasonix 实战指南一个可长期常驻运行的配置驱动型编码 Agent【免费下载链接】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 编码 Agent以「前缀缓存稳定性」为设计前提支持计划模式、权限管控、工作区沙箱与逐轮 checkpoint目标是让 Agent 长时间自治运行时始终可读、可撤销。它提供终端 CLI/TUI、桌面端、浏览器reasonix serve与 ACP 编辑器接入四个入口共用同一套本地 Go 引擎。读完本文你可以完成四种安装路径中的任意一种、理解reasonix.toml配置体系的解析顺序与各核心配置段并从源码层面理解「缓存友好上下文维护」与「零摩擦单二进制分发」的工程实现。定位与核心特性官方中文 README 对项目的一句话定位是「可以一直开着跑的编码 Agent」一套本地引擎四个入口——终端、桌面端、浏览器或通过 ACP 接入编辑器。其核心特性可以归纳为五点以下均出自 README.zh-CN.md配置驱动provider、agent、启用的工具、插件全部在reasonix.toml中声明内核无硬编码模型多模型 · 可组合DeepSeek 作为预设内置任何 OpenAI 兼容端点都只是一条配置可选让两个模型协同执行器 规划器各自独立、缓存稳定的 session插件驱动MCP server 提供工具、提示词和资源Extension Protocol v1 Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI并通过版本化插件包分发缓存友好的上下文维护启动时注入稳定的环境摘要旧工具输出会先 snip/prune再进入摘要 compaction内置工具 schema 合约有文档和回归测试保护零摩擦分发CGO_ENABLED0单二进制一条命令交叉编译到六个目标平台产物是完全自包含的静态二进制。其中「内核无硬编码模型」这一点在源码中有直接对应CLI 入口 cmd/reasonix/main.go 通过空导入把 provider 与内置工具在编译期注册进内核——_ reasonix/internal/provider/anthropic、_ reasonix/internal/provider/openai、_ reasonix/internal/provider/responses和_ reasonix/internal/tool/builtin。内核本身只消费配置里声明的 provider模型能力如 reasoning 协议也完全由配置决定这与 README 宣称的「配置驱动」一致。安装四条路径CLI/TUI、桌面端和 VS Code 扩展都使用同一套本地 Reasonix 引擎按需选择即可。路径 ACLI / TUI任意支持的平台都可以通过 npm 安装原生二进制npm 包reasonix会自动拉取对应平台的原生二进制macOS 也可以使用 Homebrewnpm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制 brew install esengine/reasonix/reasonix # macOS预编译归档darwin|linux|windows × amd64|arm64和SHA256SUMS随每个官方 release 发布供无法使用 npm/brew 的环境手动下载校验。路径 B桌面端从官方下载页获取对应平台的安装包平台安装包架构macOS通用.dmg或.zipApple Silicon / IntelWindows安装器.exe或便携.zipx64 / ARM64Linux.deb或.tar.gzx64Windows 安装器通过 SignPath.io 完成代码签名证书由 SignPath 基金会免费提供。桌面端的构建细节前端 Electron 壳见 desktop/README.md。路径 CVS Code 扩展先完成路径 A 安装 CLI。扩展不内置 CLI而是启动本机的reasonix acp后端并提供原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。扩展 ID 为SivanLiu.reasonix-agent可在 Visual Studio Marketplace 与 Open VSX Registry 上检索安装编辑器侧的接入协议详见 ACP 编辑器接入文档。路径 D从源码构建git clone https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix.git cd DeepSeek-ReasonixCLI 构建README 要求 Go 1.25当前仓库 go.mod 固定了go 1.26.0与toolchain go1.26.6指令保持GOTOOLCHAINauto可让 Go 自动下载固定工具链也可以自行安装。make build # - bin/reasonix(.exe) make cross # - dist/darwin|linux|windows × amd64|arm64对照 Makefile 可以看到这两条命令的确切行为build目标执行CGO_ENABLED0 go build -ldflags ...产出bin/reasonix以及示例插件bin/reasonix-plugin-example。ldflags 通过git describe注入版本号、12 位 git commit 与构建时间——这与 cmd/reasonix/main.go 中version/gitCommit/buildTimeUTC三个变量一一对应reasonix --version即读取其中的 version 值cross目标循环遍历darwin|linux|windows × amd64|arm64六个GOOS/GOARCH组合每个都以CGO_ENABLED0编译输出dist/reasonix-os-arch。这正是「零摩擦分发」特性的实现来源CGO_ENABLED0保证产物不依赖任何 C 运行时目标机器上除二进制本身外无需安装任何东西。桌面端构建额外需要 Node 24 和 pnpm 10npm install -g pnpm10scripts/desktop-build.sh darwin/arm64 v0.0.0-dev # 每次构建一个平台无需安装系统 WebView 依赖Electron 壳自带 Chromium。快速开始CLI / TUI以下命令仅适用于通过路径 A 安装的 CLI/TUIreasonix setup # 配置 provider 和模型 reasonix # 启动交互式会话 reasonix run 把 main.go 里的 TODO 实现掉需要项目指令时可在交互式会话中运行/init。CLI 进阶用法见 CLI 命令参考、使用指南 与 配置路径。桌面端安装并启动桌面应用后在应用内配置 provider 和模型即可使用无需执行上面的 CLI 命令。配置体系reasonix.example.toml 全解读仓库根目录的 reasonix.example.toml 是官方给出的完整配置模板下面按配置段逐项展开。解析顺序与密钥管理文件头部注释明确了配置的解析顺序flag ./reasonix.toml Reasonix home/config.toml built-in defaults这与源码 internal/config/config.go 包注释完全一致flag 项目./reasonix.toml 用户配置目录config.toml 内置默认值。标注为 user/global only 的字段不会被项目级./reasonix.toml覆盖。密钥管理约定是provider 条目只通过api_key_env指定环境变量名实际的 key 值存放在 Reasonix 全局Reasonix home/.env中永远不要写进配置文件。顶层与 UIdefault_model deepseek # provider 名→ 其默认模型或 provider/model # language zh # 界面语言空 从 $LANG / $REASONIX_LANG 自动检测 [ui] theme auto # auto|dark|light只影响 CLI 配色REASONIX_THEME 可按次覆盖 # theme_style graphite # graphite|aurora|slate|carbon|nocturne|amber 及旧别名 # shortcut_layout desktop # classic|desktopShiftTab 切换 PlanCtrlY 切换 YOLO # cursor_shape bar # block|underline|barslim 默认值避免遮挡 CJK 字符 show_turn_usage true # 在滚动回显中显示每次请求的 token 与费用回执[desktop]段同理提供桌面端layout_styleworkbench|creation、theme、terminal_theme等[billing].display_currency只控制展示货币不会改写 provider 列表价——列表价以各 provider 的billing_currency来自官方价表或自定义价格为准。Agent 核心参数compact_ratio 与双模型协同[agent] temperature 0.0 compact_ratio 0.80 # 唯一自动触发阈值预设 0.70(激进) / 0.80(推荐默认) / 0.85(保守) # planner_model deepseek-pro # 可选启用两个模型协同执行器 规划器 # subagent_model deepseek-pro # runAssubagent 技能的默认模型 # max_subagent_concurrency 6 # 会话级子智能体并发task/fleet/skills # max_parallel_writers 3 # 写路径不重叠的并发写者数 # recovery_model # 可选低危自动恢复评审模型空 仅规则恢复 # reasoning_language auto # 可见推理文本auto|zh|en # output_style explanatory # explanatory|learning|concise 或 .reasonix/output-styles/name.mdcompact_ratio是上下文自动压缩的唯一触发阈值。源码侧可以印证其演进internal/config/load.go 中CompactRatio 0时回填默认值并把遗留的soft_compact_ratio归零internal/boot/boot.go 还会对旧版多阈值压缩配置做迁移MigrateLegacyMultiThresholdCompactionForRoot迁移时提示「Deprecated multi-threshold compaction keys were ignored.」——说明项目曾使用多阈值策略现已收敛为单一compact_ratio。压缩行为的回归保障见 internal/agent/compact_test.go 与基准 benchmarks/compaction/。planner_model对应 README 中「可选让两个模型协同执行器 规划器」规划器与执行器各自持有独立且缓存稳定的 session互不干扰前缀缓存。Provider 声明DeepSeek 与 Anthropic 两个标准示例reasonix.example.toml给出两个开箱即用的 provider 条目[[providers]] name deepseek kind openai base_url https://api.deepseek.com models [deepseek-v4-flash, deepseek-v4-pro] default deepseek-v4-flash # 可选默认取 models 首项 api_key_env DEEPSEEK_API_KEY context_window 1000000 effort high # thinking 默认开启disabled|low|high|max缺省 auto[[providers]] name claude kind anthropic model claude-opus-4-8 api_key_env ANTHROPIC_API_KEY context_window 1000000 price { cache_hit 0.5, input 5, output 25, currency $ } # 每 1M tokens thinking adaptive # 仅 anthropic kind在工具调用间往返签名推理块 effort high要点kind openai走 OpenAI 兼容协议kind anthropic直接说 Messages API无 OpenAI shim注意 anthropic provider 不启用 extended thinking 也不发送 temperature因为当前 Claude 模型拒绝采样参数见 internal/provider 下的实现说明一个 provider 条目可用models [...]暴露多个模型切换模型复用同一条连接无需重复声明base_url/api_key需要独立base_url的单模型则用model ...形式模型共享端点但需要不同 context window 时用model_overrides费用侧官方锚定价按 provider 冻结billing_currencyCNY|USDDeepSeek 存储的是峰值价Reasonix 会在发生时刻自动套用文档声明的半价时段仅当需要钉住自定义费率时才显式设置prices对走代理的 DeepSeek 模型会按模型名自动识别reasoning_protocol none可禁用识别openai强制走普通reasoning_effort。其他 OpenAI 兼容 provider 除非在此显式声明supported_efforts/default_effort否则不暴露/effort命令桌面端 Settings → Model → Access → Add provider 内置了 Kimi、MiMo、GLM/Z.AI、OpenCode Go/Zen、Qwen/DashScope、Ollama Cloud 等一系列可编辑预设详见注释与 PROVIDER_CATALOG.zh-CN.md。环境摘要、工具与沙箱[environment] enabled true # 启动时注入 OS、shell、常用工具的稳定摘要到提示词 offline false # 出站网络不可用时置 true避免无谓重试 [tools] enabled [] # 空 全部内置工具 bash_timeout_seconds 120 # 前台安全上限0 不设工具级上限 mcp_startup_timeout_seconds 30 # 后台 initialize tools/list 上限 mcp_call_timeout_seconds 300 # MCP 调用默认安全上限 [tools.background_jobs] stalled_warning_seconds 900 # 静默 900s 后每任务提醒一次0 禁用[environment].enabled true正是「启动时注入稳定的环境摘要」的实现入口对应 internal/environment 包——稳定摘要保证提示词前缀跨轮次不变是前缀缓存命中率的前提。沙箱配置限制工具调用的爆炸半径# [sandbox] # workspace_root # allow_write [/tmp] # forbid_read [${HOME}/.ssh] # bash enforce # macOS/Linux 默认 enforceWindows 无 OS 级 Bash 沙箱固定 off # network true写操作被约束在workspace_root空 当前目录加allow_write之内forbid_read会在 OS 级沙箱激活期间把敏感目录从读取/列目录/搜索工具乃至沙箱化 bash 中隐藏。路径支持绝对路径或${HOME}~不会被展开。Skills、Hooks、插件与 Bot 网关SkillsSKILL.md/name.md带 frontmatter形式的可调用剧本搜索路径包括.reasonix/skills、.agents/skills、.claude/skills项目级及同名全局目录内置 explore/research/review/security-review/test 开箱即用。模型侧通过run_skill/explore等工具调用用户侧用/name调用/skill命令可管理disable_implicit_invocation true可强制显式调用HooksPreToolUse / PostToolUse / PermissionRequest / UserPromptSubmit / Stop 五个时点不在reasonix.toml里配置而是放在Reasonix home/settings.json全局与project/.reasonix/settings.json项目exit 0 放行、exit 2 阻断仅 PreToolUse / UserPromptSubmitPlugins[[plugins]]声明外部 stdio MCP 插件独立可执行文件支持startup_timeout_seconds、按 server 与按工具的调用超时覆盖启用后在会话启动后自动后台连接可用/mcp或桌面 MCP 面板刷新/重连/禁用。仓库自带示例插件入口 cmd/reasonix-plugin-exampleBot 网关[bot]段支持 QQ / 飞书 / 微信多通道 IM botreasonix bot start --channels qq,feishu,weixin所有密钥只从环境变量读取提供消息合并窗口、队列模式steer|followup|collect|interrupt、按会话的路由[[bot.routes]]可绑定独立workspace_root与模型、配对与白名单/管理员体系以及本机 loopback 控制 API[bot.control]GET /status、GET /metrics、POST /send。完整用法见 机器人使用指南。Checkpoints 与 serve# [checkpoints] # retain_turns 100 # 保留多少轮的文件 payload # blob_quota_bytes 1073741824 # 1 GiB 软预算 [serve] # auth_mode none # none | token | password # token # token 模式预共享令牌空则自动生成 # password_hash # 可用 reasonix serve --hash-password password 生成 # behind_proxy false # 反代nginx/Caddy下置 true 以信任 X-Forwarded-*[checkpoints]控制 rewind 快照保留量受保护或当前轮次可能临时超出字节预算详见 Checkpoints 与 rewind 文档。reasonix serve是「浏览器入口」的宿主为 HTTP 前端提供认证token/password与反代适配。纵深解析为什么它能「一直开着跑」README 的卖点「Engineered around prefix-cache stability — leave it running」落在三层机制上1. 稳定前缀。[environment].enabled的启动摘要、固定的系统提示、不变的工具 schema 共同保证会话前缀逐轮稳定工具 schema 合约由 internal/tool/contract_lock_test.go、internal/tool/contract_test.go 等回归测试保护防止工具定义被无意改动而击穿缓存。仓库内还有scripts/check-cache-impact.sh、scripts/cache-guard.sh一类脚本用于在变更时检查缓存影响面。2. 分级上下文维护。旧工具输出不是直接全部进摘要先 snip/prune裁剪再进入摘要 compaction。核心实现在 internal/agent/context_manager.go投影逻辑见 internal/agent/compact_projection.go专项基准位于 benchmarks/compaction/含 snip_test.go与端到端基准 benchmarks/context-maintenance-e2e/benchmarks/下的 README.md 汇总了各基准用法。3. 逐轮可撤销。每轮 checkpoint 记录文件 payload[checkpoints]预算内可 rewind长时间自治运行因此「始终可读、可撤销」详见 docs/RECOVERY.zh-CN.md 与 docs/CHECKPOINTS.zh-CN.md。延伸阅读文档索引项目文档成体系地放在docs/下中文文档均为*.zh-CN.md与本文主题最相关的入口开始使用指南 · CLI 命令参考 · 配置路径 · ACP 编辑器接入功能与排障子智能体 Profile · Context Engine v2 · 能力诊断 · 恢复与安全模式 · 机器人使用指南 · Checkpoints 与 rewind工程与迁移规格 · 任务合约与暂停策略 · 工具合约 · 从 0.x 迁移扩展开发扩展概览 · 插件包与 Manifest v1 · Extension Protocol · Go SDK 与 starter小结DeepSeek-Reasonix 的技术形态可以概括为一个CGO_ENABLED0编译的纯 Go 单二进制引擎Makefile 的build/cross目标直接可复现配置即内核internal/config/config.go 定义四级解析顺序reasonix.example.toml 给出全量参数基线以稳定前缀 分级上下文维护 逐轮 checkpoint 支撑长期常驻运行。上手路径最短的组合是npm i -g reasonixreasonix setup需要深度定制时从reasonix.example.toml的 provider / agent / tools / sandbox 四个段切入再按延伸阅读索引深入各专题文档。项目采用 MIT 协议见 LICENSE。【免费下载链接】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），仅供参考