esengine/DeepSeek-Reasonix

English  ·  简体中文  ·  指南  ·  规范  ·  官网  ·  Discord

为你的终端打造的 DeepSeek 原生 AI 编程 agent。

一个由配置和插件驱动的框架 —— 单个静态编译的 Go 二进制文件，针对 DeepSeek 的前缀缓存进行了优化，确保在长会话中保持较低的 token 成本。

## 功能 - **配置驱动。** provider、agent、启用的工具和插件全部在 `reasonix.toml` 中声明。没有硬编码的模型。 - **多模型与可组合。** DeepSeek 作为预设提供；任何兼容 OpenAI 的 endpoint 只需配置即可，无需编写新代码。可选择在独立且缓存稳定的会话中同时运行两个模型（executor + planner）。 - **插件驱动。** 外部工具作为子进程通过 stdio JSON-RPC 运行（兼容 MCP）。内置工具在编译时自动注册。 - **零阻力分发。** `CGO_ENABLED=0` 单一二进制文件；使用一条命令即可交叉编译到六个目标平台。唯一的依赖是一个 TOML 解析器。 ## 安装 ``` npm i -g reasonix # any OS; pulls the prebuilt native binary brew install esengine/reasonix/reasonix # macOS ``` 预构建的压缩包（`darwin|linux|windows × amd64|arm64`）和 `SHA256SUMS` 可在每个 [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases) 中找到。 ### 代码签名 Windows 构建版本使用由 [SignPath Foundation](https://signpath.org/) 提供的免费证书进行代码签名，并通过 [SignPath.io](https://signpath.io/) 完成签署。 ### 从源码构建 ``` make build # -> bin/reasonix(.exe) make cross # -> dist/ (darwin|linux|windows × amd64|arm64) ``` ## 快速开始 ``` reasonix setup # config wizard → ./reasonix.toml export DEEPSEEK_API_KEY=sk-... # or let setup save it to the credential store reasonix # then run /init to generate AGENTS.md (project memory) reasonix run "implement the TODOs in main.go" reasonix run --model deepseek-pro "add unit tests for this function" echo "explain this code" | reasonix run ``` ## 配置 一个最简化的 `reasonix.toml` —— 包含一个 provider 和一个默认模型 —— 就足以开始： ``` default_model = "deepseek-flash" [[providers]] name = "deepseek-flash" kind = "openai" base_url = "https://api.deepseek.com" model = "deepseek-v4-flash" api_key_env = "DEEPSEEK_API_KEY" ``` 解析优先级依次为 **命令行 flag > `./reasonix.toml` > 用户配置文件 > 内置默认值**；从 **Reasonix v1.8.1** 开始，用户配置文件在 macOS/Linux 上位于 `~/.reasonix/config.toml`，在 Windows 上位于 `%AppData%\reasonix\config.toml`。有关迁移详情，请参阅 **[配置路径](./docs/CONFIG_PATHS.md)**。密钥通过 `api_key_env` 从环境变量中获取，绝不写入配置文件，新密钥默认存储在 OS 凭据存储中，并以 Reasonix 独占的文件作为后备。项目的 `.env` 文件会作为兼容性覆盖被读取，但 Reasonix 不会在那里写入新密钥。权限、sandbox、插件 (MCP)、斜杠命令、`@` 引用以及双模型设置均在 **[指南](./docs/GUIDE.md)** 中详细说明。 ## 文档 - **[指南](./docs/GUIDE.md)** — 配置、权限和 sandbox、插件 (MCP)、斜杠命令、`@` 引用、双模型协作。 - **[Bot 指南](./docs/BOT_GUIDE.md)** — 从桌面应用连接飞书、Lark 和微信 Bot，然后在即时通讯 (IM) 中使用审批、YOLO 和命令。 - **[规范](./docs/SPEC.md)** — 工程契约：架构、注册表、数据类型和路线图。 - **[从 0.x 迁移](./docs/MIGRATING.md)** — 从早期的 TypeScript 版本迁移至 1.0 Go 重写版本。 - **[检查点与回溯](./docs/CHECKPOINTS.md)** — 基于快照的编辑安全网（Esc-Esc / `/rewind`）。

标签：AI编程助手, DeepSeek, EVTX分析, Python安全, SOC Prime, 开发工具, 日志审计, 熵值分析