返回 DeepSeek-Reasonix
README.zh-CN.md
根目录 / README.zh-CN.md
1 <p align="center">
2 <img src="docs/logo.svg" alt="Reasonix" width="640"/>
3 </p>
4
5 <p align="center">
6 <a href="./README.md">English</a>
7 &nbsp;·&nbsp;
8 <strong>简体中文</strong>
9 &nbsp;·&nbsp;
10 <a href="./docs/GUIDE.zh-CN.md">指南</a>
11 &nbsp;·&nbsp;
12 <a href="./docs/ACP.zh-CN.md">ACP</a>
13 &nbsp;·&nbsp;
14 <a href="./docs/EXTENSIONS.zh-CN.md">扩展开发</a>
15 &nbsp;·&nbsp;
16 <a href="./docs/SPEC.zh-CN.md">规格</a>
17 &nbsp;·&nbsp;
18 <a href="https://esengine.github.io/DeepSeek-Reasonix/">官方网站</a>
19 &nbsp;·&nbsp;
20 <strong><a href="https://discord.gg/XF78rEME2D">Discord</a></strong>
21 </p>
22
23 <p align="center">
24 <a href="https://www.npmjs.com/package/reasonix"><img src="https://img.shields.io/npm/v/reasonix.svg?style=flat-square&color=cb3837&labelColor=161b22&logo=npm&logoColor=white" alt="npm version"/></a>
25 <a href="https://github.com/esengine/DeepSeek-Reasonix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/esengine/DeepSeek-Reasonix/ci.yml?style=flat-square&label=ci&labelColor=161b22&logo=githubactions&logoColor=white" alt="CI"/></a>
26 <a href="./LICENSE"><img src="https://img.shields.io/npm/l/reasonix.svg?style=flat-square&color=8b949e&labelColor=161b22" alt="license"/></a>
27 <a href="https://www.npmjs.com/package/reasonix"><img src="https://img.shields.io/npm/dm/reasonix.svg?style=flat-square&color=3fb950&labelColor=161b22&label=downloads" alt="downloads"/></a>
28 <a href="https://github.com/esengine/DeepSeek-Reasonix/stargazers"><img src="https://img.shields.io/github/stars/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=dbab09&labelColor=161b22&logo=github&logoColor=white" alt="GitHub stars"/></a>
29 <a href="https://atomgit.com/esengine/DeepSeek-Reasonix"><img src="https://atomgit.com/esengine/DeepSeek-Reasonix/star/badge.svg" alt="AtomGit stars"/></a>
30 <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors"><img src="https://img.shields.io/github/contributors/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=bc8cff&labelColor=161b22&logo=github&logoColor=white" alt="contributors"/></a>
31 <a href="https://github.com/esengine/DeepSeek-Reasonix/discussions"><img src="https://img.shields.io/github/discussions/esengine/DeepSeek-Reasonix.svg?style=flat-square&color=58a6ff&labelColor=161b22&logo=github&logoColor=white" alt="Discussions"/></a>
32 <a href="https://discord.gg/XF78rEME2D"><img src="https://img.shields.io/badge/discord-join-5865F2.svg?style=flat-square&labelColor=161b22&logo=discord&logoColor=white" alt="Discord"/></a>
33 </p>
34
35 <p align="center">
36 <a href="https://trendshift.io/repositories/27020?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27020/monthly?language=Go" alt="esengine/DeepSeek-Reasonix | Trendshift" width="250" height="55"/></a>
37 <a href="https://trendshift.io/repositories/27020?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-27020" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/27020" alt="esengine/DeepSeek-Reasonix | Trendshift" width="250" height="55"/></a>
38 </p>
39
40 <br/>
41
42 <h3 align="center">面向终端的 DeepSeek 原生 AI coding agent。</h3>
43 <p align="center">由配置与插件驱动的极薄 harness——单一静态 Go 二进制，围绕 DeepSeek 的前缀缓存调优，长会话也能把 token 成本压低。</p>
44
45 <br/>
46
47 > [!IMPORTANT]
48 > **加入社区 · Community** — 双语 Discord，提供安装答疑（`#help` / `#求助`）、工作流展示与功能想法。→ **<https://discord.gg/XF78rEME2D>**
49
50 ## 特性
51
52 - **配置驱动**：provider、agent、启用的工具、插件全部在 `reasonix.toml` 中声明，
53 内核无硬编码模型。
54 - **多模型 · 可组合**：DeepSeek 作为预设内置；任何 OpenAI 兼容
55 端点都只是一条配置。可选让两个模型协同（执行器 + 规划器），各自独立、缓存稳定的 session。
56 - **插件驱动**：MCP server 提供工具、提示词和资源；Extension Protocol v1
57 Sidecar 还可以拦截运行时事件、提供 Provider 与结构化 UI，并通过版本化插件包分发。
58 - **缓存友好的上下文维护**：启动时注入稳定的环境摘要；旧工具输出会先 snip/prune，
59 再进入摘要 compaction；内置工具 schema 合约有文档和回归测试保护。
60 - **零摩擦分发**：`CGO_ENABLED=0` 单二进制；一条命令交叉编译到六个目标平台。
61 产物是完全自包含的静态二进制——目标机器上除二进制本身外无需安装任何东西。
62
63 ## 安装
64
65 选择适合你的使用路径。CLI/TUI、桌面端和 VS Code 扩展都使用同一套本地
66 Reasonix 引擎。
67
68 ### 路径 A：CLI / TUI
69
70 任意支持的平台都可以通过 npm 安装原生二进制；macOS 也可以使用 Homebrew：
71
72 ```sh
73 npm i -g reasonix # 任意系统;自动拉取对应平台的原生二进制
74 brew install esengine/reasonix/reasonix # macOS
75 ```
76
77 预编译归档(`darwin|linux|windows × amd64|arm64`)和 `SHA256SUMS` 见每个
78 [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases)。
79
80 ### 路径 B：桌面端
81
82 前往[官方下载页](https://reasonix.io/?download=desktop#start)获取最新桌面版本。
83
84 | 平台 | 安装包 | 架构 |
85 | --- | --- | --- |
86 | macOS | 通用 `.dmg` 或 `.zip` | Apple Silicon / Intel |
87 | Windows | 安装器 `.exe` 或便携 `.zip` | x64 / ARM64 |
88 | Linux | `.deb` 或 `.tar.gz` | x64 |
89
90 Windows 安装器通过 [SignPath.io](https://signpath.io/) 完成代码签名，证书由
91 [SignPath 基金会](https://signpath.org/) 免费提供。
92
93 ### 路径 C：VS Code 扩展
94
95 请先完成路径 A。扩展不内置 CLI，而是启动本机的 `reasonix acp` 后端，
96 并提供原生聊天、编辑器上下文、工具调用审批、模型选择和工作区会话。
97
98 - **VS Code：** [从 Visual Studio Marketplace 安装](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent)
99 - **VSCodium / Eclipse Theia：** [从 Open VSX Registry 安装](https://open-vsx.org/extension/SivanLiu/reasonix-agent)
100 - **扩展 ID：** `SivanLiu.reasonix-agent` · [源码与使用说明](https://github.com/SivanCola/reasonix-vscode)
101
102 ### 路径 D：从源码构建
103
104 ```sh
105 git clone https://github.com/esengine/DeepSeek-Reasonix.git
106 cd DeepSeek-Reasonix
107 make build # -> bin/reasonix(.exe)
108 make cross # -> dist/（darwin|linux|windows × amd64|arm64）
109 ```
110
111 ## 快速开始
112
113 ### CLI / TUI
114
115 以下命令仅适用于通过路径 A 安装的 CLI/TUI：
116
117 ```sh
118 reasonix setup # 配置 provider 和模型
119 reasonix # 启动交互式会话
120 reasonix run "把 main.go 里的 TODO 实现掉"
121 ```
122
123 需要项目指令时，可在交互式会话中运行 `/init`。
124
125 ### 桌面端
126
127 从[官方下载页](https://reasonix.io/?download=desktop#start)下载对应系统的安装包，
128 安装并启动 Reasonix，然后在应用内配置 provider 和模型即可使用。桌面端无需执行
129 上面的 CLI 命令。
130
131 CLI 进阶用法和详细配置见 **[CLI 命令参考](./docs/CLI.zh-CN.md)**、
132 **[指南](./docs/GUIDE.zh-CN.md)** 和
133 **[配置路径](./docs/CONFIG_PATHS.zh-CN.md)**。
134
135 ## 文档
136
137 - **开始使用：** [指南](./docs/GUIDE.zh-CN.md) ·
138 [CLI 命令参考](./docs/CLI.zh-CN.md) · [配置路径](./docs/CONFIG_PATHS.zh-CN.md) ·
139 [ACP 编辑器接入](./docs/ACP.zh-CN.md)
140 - **功能与排障：** [子智能体 Profile](./docs/SUBAGENT_PROFILES.zh-CN.md) ·
141 [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.zh-CN.md) ·
142 [能力诊断](./docs/CAPABILITY_DIAGNOSTICS.zh-CN.md) ·
143 [恢复与安全模式](./docs/RECOVERY.zh-CN.md) ·
144 [机器人使用指南](./docs/BOT_GUIDE.zh-CN.md) ·
145 [Checkpoints 与 rewind](./docs/CHECKPOINTS.zh-CN.md)
146 - **工程与迁移：** [规格](./docs/SPEC.zh-CN.md) ·
147 [任务合约与暂停策略](./docs/TASK_CONTRACT.zh-CN.md) ·
148 [工具合约](./docs/TOOL_CONTRACT.zh-CN.md) ·
149 [从 0.x 迁移](./docs/MIGRATING.zh-CN.md)
150 - **扩展开发：** [扩展概览](./docs/EXTENSIONS.zh-CN.md) ·
151 [插件包与 Manifest v1](./docs/PLUGIN_PACKAGES.zh-CN.md) ·
152 [Extension Protocol](./docs/EXTENSION_PROTOCOL.zh-CN.md) ·
153 [Go SDK 与 starter](./sdk/go/README.md)
154
155 ## Star 趋势
156
157 <a href="https://www.star-history.com/?repos=esengine%2FDeepSeek-Reasonix&type=date&legend=top-left">
158 <picture>
159 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-dark.svg" />
160 <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-light.svg" />
161 <img alt="Star History Chart" src="https://raw.githubusercontent.com/esengine/DeepSeek-Reasonix/star-history/assets/star-history/star-history-light.svg" />
162 </picture>
163 </a>
164
165 <br/>
166
167 ## 致谢
168
169 下面这些朋友的工作塑造了 Reasonix 今天的样子 —— 当前按 commit 数统计的前 20 名贡献者。
170 完整贡献者列表在
171 [GitHub](https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors?all=1)。
172
173 <!-- reasonix-top-contributors:start -->
174 | Contributor | Contributor | Contributor | Contributor |
175 | --- | --- | --- | --- |
176 | [**SivanCola**](https://github.com/SivanCola) | [**esengine**](https://github.com/esengine) | [**ttmouse**](https://github.com/ttmouse) | [**lifu963**](https://github.com/lifu963) |
177 | **reasonix**（anonymous） | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**light-front-theory**](https://github.com/light-front-theory) |
178 | **merge-order-check**（anonymous） | [**Li-Charles-One**](https://github.com/Li-Charles-One) | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan**（anonymous） |
179 | [**CVEngineer66**](https://github.com/CVEngineer66) | [**dependabot\[bot\]**](https://github.com/apps/dependabot) | [**lanshi17**](https://github.com/lanshi17) | [**SuMuxi66**](https://github.com/SuMuxi66) |
180 | [**CnsMaple**](https://github.com/CnsMaple) | [**cyq1017**](https://github.com/cyq1017) | [**JesonChou**](https://github.com/JesonChou) | [**XTLine**](https://github.com/XTLine) |
181 <!-- reasonix-top-contributors:end -->
182
183 另外特别感谢 [**Bernardxu123**](https://github.com/Bernardxu123) 设计的项目 logo，
184 以及 [AIGC Link](https://xhslink.com/m/80ngts127cA) 在小红书上的推广。
185
186 <p align="center">
187 <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors">
188 <img src="https://contrib.rocks/image?repo=esengine/DeepSeek-Reasonix&max=100&columns=12" alt="esengine/DeepSeek-Reasonix 贡献者" width="860"/>
189 </a>
190 </p>
191
192 <br/>
193
194 ---
195
196 <p align="center">
197 <sub>MIT —— 见 <a href="./LICENSE">LICENSE</a></sub>
198 <br/>
199 <sub>由 <a href="https://github.com/esengine/DeepSeek-Reasonix/graphs/contributors">esengine/DeepSeek-Reasonix</a> 社区共建</sub>
200 </p>
201
202 ---
203
204 <p align="center"><sub><strong>支持本项目</strong></sub></p>
205
206 如果 Reasonix 帮你省了时间或 token，欢迎请杯咖啡。捐助不会换来 feature
207 优先级，也不会影响 issue 的处理顺序——就是「谢谢」。
208
209 - **国内** — 微信支付（扫下方二维码）
210 - **海外** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)
211
212 <p align="center">
213 <img src=".github/sponsor/wechat-pay.jpg" alt="微信支付收款码" width="180"/>
214 </p>
215
215 lines MARKDOWN