超高缓存命中率的 Reasonix Agent:专为deepseek开发
Reasonix 是一款以 DeepSeek 为原生后端的终端编程 Agent。设计围绕 DeepSeek API 展开 —— Cache-First 循环、Flash 优先的成本控制、工具调用自动修复 —— 直接对接 api.deepseek.com,不需要协议转换层。
1. 安装 Node.js
安装 Node.js 20.10 及以上版本。
Windows 用户请安装 Git for Windows。
2. 获取 DeepSeek API Key
在 DeepSeek 开放平台 获取 API Key。Reasonix 首次启动会有内置向导询问 Key 并持久化到 ~/.reasonix/config.json —— 无需配置环境变量。
安装
任意系统,自动拉取对应平台的原生二进制
快速开始
第一次启动时需要配置项目级配置,配置最终生成在 ./reasonix.toml :
在对应项目文件夹中的终端在运行:
关于配置
优先级:flag > ./reasonix.toml > ~/.config/reasonix/config.toml > 内置默认值。 密钥经环境变量通过 api_key_env 注入,绝不写入配置文件。
default_model = "deepseek-flash" # 执行器;设 [agent].planner_model 可加规划器
# language = "zh" # 界面语言;为空则按 $LANG / $REASONIX_LANG 自动检测
[agent]
# planner_model = "mimo-pro" # 可选的低频规划器
# subagent_model = "deepseek-pro" # runAs=subagent skill 的默认模型
# subagent_models = { review = "deepseek-pro", security_review = "deepseek-pro" }
auto_plan = "ask" # off|ask|on;复杂聊天任务自动进入计划模式
# auto_plan_classifier = "deepseek-flash" # 可选;只在边界任务上调用
[[providers]]
name = "deepseek-flash"
kind = "openai"
base_url = "https://api.deepseek.com"
model = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"
# 还有预设:deepseek-pro、mimo-pro(mimo-v2.5-pro)、mimo-flash(mimo-v2-flash) @ api.xiaomimimo.com/v1
[tools]
enabled = [] # 省略/为空 = 全部内置工具
[skills]
# paths = ["~/my-skills", "../shared/skills"] # 额外的自定义技能目录
# disabled_skills = ["review"] # 隐藏技能,直到 /skill enable <name>
[permissions]
mode = "ask" # 无规则命中时 writer 的兜底:ask|allow|deny
deny = ["bash(rm -rf*)", "bash(git push*)"] # 任何模式下都硬阻断
allow = ["bash(go test*)"] # 从不询问
[sandbox]
# workspace_root = "" # 文件写工具被限制在此目录;留空 = 当前目录
# allow_write = ["/tmp"] # write_file/edit_file/multi_edit 额外可写的目录
[[plugins]]
name = "example"
command = "reasonix-plugin-example"


评论