npm - reasonix - Versions diffs - 1.39.7 → 2.28.0 - Mend

reasonix 1.39.7 → 2.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +86 -55
package/package.json +8 -9

package/README.md CHANGED Viewed

@@ -18,9 +18,12 @@
   <a href="https://esengine.github.io/DeepSeek-Reasonix/">Website</a>
   &nbsp;·&nbsp;
   <strong><a href="https://discord.gg/XF78rEME2D">Discord</a></strong>
+  &nbsp;·&nbsp;
+  <strong><a href="https://qm.qq.com/q/i59b0z2R8s">QQ</a></strong>
 </p>
 <p align="center">
+  <a href="https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true"><img src="https://img.shields.io/github/v/release/esengine/DeepSeek-Reasonix.svg?filter=studio-v*&include_prereleases&style=flat-square&color=8250df&labelColor=161b22&label=studio%202.x" alt="Reasonix Studio 2.x"/></a>
   <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>
   <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>
   <a href="./LICENSE"><img src="https://img.shields.io/npm/l/reasonix.svg?style=flat-square&color=8b949e&labelColor=161b22" alt="license"/></a>
@@ -30,6 +33,7 @@
   <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>
   <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>
   <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>
+  <a href="https://qm.qq.com/q/i59b0z2R8s"><img src="https://img.shields.io/badge/QQ%20group-1093562660-12B7F5.svg?style=flat-square&labelColor=161b22&logo=tencentqq&logoColor=white" alt="QQ group 1093562660"/></a>
 </p>
 <p align="center">
@@ -40,20 +44,42 @@
 <br/>
 <p align="center"><strong>Open source · MIT · a single Go binary</strong></p>
-<h3 align="center">A coding agent you can leave running.</h3>
+<h3 align="center">A reliable coding agent for complex software engineering tasks.</h3>
 <p align="center">One local engine, four ways in — terminal, desktop app, browser, or your editor over ACP. Plan mode, permissions, a workspace sandbox and per-turn checkpoints keep a long autonomous run something you can still read and undo.</p>
-<div align="center">
-  <video src="https://github.com/user-attachments/assets/ab2f3878-e224-4931-8254-060e7695cfb9" controls preload="metadata" width="560"></video>
-</div>
-<br/>
+<p align="center">Maintained by <strong>Huahui Yu</strong>.</p>
 > [!IMPORTANT]
 > **Community · 加入社区** — bilingual Discord for setup help (`#help` / `#求助`), workflow showcases, and feature ideas. → **<https://discord.gg/XF78rEME2D>**
+>
+> QQ group **DeepSeek-Reasonix官方群** (`1093562660`) → **<https://qm.qq.com/q/i59b0z2R8s>** ([QR code](./docs/assets/qq-group.svg))
+> Douyin: **做游戏的小鱼** (Douyin ID `22703872788`) · [QR code](./docs/assets/douyin.png)
 <br/>
+## Versions
+Reasonix ships on two lines. See the [version roadmap announcement](https://github.com/esengine/DeepSeek-Reasonix/discussions/10748) for the reasoning behind the split.
+| Line | Branch | Status | Get it |
+| --- | --- | --- | --- |
+| **Reasonix 2.x** | `studio` (this branch) | Active development, pre-release | [Studio releases](https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true) |
+| **Reasonix 1.x** | [`main-v2`](https://github.com/esengine/DeepSeek-Reasonix/tree/main-v2) | Maintenance / stable | `npm i -g reasonix` · [desktop download](https://reasonix.io/?download=desktop#start) |
+- **Want something stable?** Stay on 1.x. It keeps receiving bug fixes,
+  provider/API compatibility, updater and security fixes; its core architecture
+  is no longer being extended.
+- **Want the new architecture?** Use 2.x Reasonix Studio. It is still moving
+  quickly; reports are welcome.
+Valuable fixes, tests and behaviour from 1.x are reviewed one by one and ported
+or reimplemented on 2.x where they fit the new architecture.
+- [Moving from 1.x to 2.x](./docs/MIGRATING.md): what the two lines share, and
+  how to run both on one machine without losing sessions.
+- [2.x roadmap](./docs/ROADMAP.md): what 2.x still has to deliver, how it ships,
+  and the decisions still open.
 ## Features
 - **Config-driven.** Providers, the agent, enabled tools, and plugins are all
@@ -73,57 +99,65 @@
 ## Install
-Choose the path that matches how you want to use Reasonix. The CLI/TUI,
-desktop app, and VS Code extension all use the same local Reasonix engine.
+This branch is **Reasonix 2.x**. Its desktop app is Reasonix Studio; the CLI,
+Studio, and editor integrations all run the same local Reasonix engine.
-### Path A: CLI / TUI
+### Reasonix Studio (2.x)
-Install the native binary through npm on any supported platform, or use
-Homebrew on macOS:
+Download the package for your platform from the latest
+[Studio release](https://github.com/esengine/DeepSeek-Reasonix/releases?q=studio-v&expanded=true)
+(tagged `studio-v2.*`, published as pre-releases while 2.x is in active
+development):
-```sh
-npm i -g reasonix                  # any OS; pulls the prebuilt native binary
-brew install esengine/reasonix/reasonix   # macOS
-```
+| Platform | Package | Architecture |
+| --- | --- | --- |
+| macOS | `.dmg` or `.zip` | Apple Silicon (`arm64`) / Intel (`amd64`) |
+| Windows | Installer `-installer.exe` or portable `.zip` | x64 |
+| Linux | `.deb` | x64 |
-Prebuilt archives (`darwin|linux|windows × amd64|arm64`) and `SHA256SUMS` are on
-every [GitHub release](https://github.com/esengine/DeepSeek-Reasonix/releases).
+Every package ships with a `.minisig` signature, and the release carries
+`SHA256SUMS`. Once installed, Studio updates itself in place.
-### Path B: Desktop app
+The same release also carries the 2.x `reasonix` CLI as archives for
+`darwin|linux|windows × amd64|arm64`.
-Use the [official download page](https://reasonix.io/?download=desktop#start)
-for the latest desktop build.
+### Reasonix 1.x (stable)
-| Platform | Package | Architecture |
-| --- | --- | --- |
-| macOS | Universal `.dmg` or `.zip` | Apple Silicon / Intel |
-| Windows | Installer `.exe` or portable `.zip` | x64 / ARM64 |
-| Linux | `.deb` or `.tar.gz` | x64 |
+The 1.x CLI installs through npm on any supported platform, or Homebrew on
+macOS:
-Windows installers are code-signed with a Certum code-signing certificate.
+```sh
+npm i -g reasonix                  # any OS; pulls the prebuilt native binary
+brew install esengine/reasonix/reasonix   # macOS
+```
+The 1.x desktop app is on the
+[official download page](https://reasonix.io/?download=desktop#start). Windows
+installers are code-signed with a Certum code-signing certificate.
-### Path C: VS Code extension
+### VS Code extension
-Complete Path A first. The extension does not bundle the CLI; it starts your
-local `reasonix acp` backend and adds native chat, editor context, tool-call
-approvals, model selection, and workspace sessions.
+The extension does not bundle the CLI; it starts your local `reasonix acp`
+backend and adds native chat, editor context, tool-call approvals, model
+selection, and workspace sessions. Install the 1.x CLI first.
 - **VS Code:** [install from Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent)
 - **VSCodium / Eclipse Theia:** [install from Open VSX Registry](https://open-vsx.org/extension/SivanLiu/reasonix-agent)
 - **Extension ID:** `SivanLiu.reasonix-agent` · [source and usage guide](https://github.com/SivanCola/reasonix-vscode)
-### Path D: Build from source
+### Build from source
-Clone the repository first:
+Clone the repository; `studio` builds 2.x and `main-v2` builds 1.x:
 ```sh
 git clone https://github.com/esengine/DeepSeek-Reasonix.git
 cd DeepSeek-Reasonix
+git switch studio
 ```
 #### CLI
-The CLI build requires **Go 1.26+**. The module pins a `toolchain` directive;
+The CLI build requires **Go 1.25+**. The module pins a `toolchain` directive;
 keep `GOTOOLCHAIN=auto` so Go downloads the pinned toolchain, or install it.
 ```sh
@@ -131,23 +165,26 @@ make build      # -> bin/reasonix(.exe)
 make cross      # -> dist/ (darwin|linux|windows × amd64|arm64)
 ```
-#### Desktop
+#### Studio
-The desktop build additionally requires **Node 24+ and pnpm 10**
-(`npm install -g pnpm@10`) for the frontend and the Electron shell:
+Studio additionally requires **Node 24+ and pnpm 10**
+(`npm install -g pnpm@10`) for the frontend.
 ```sh
-scripts/desktop-build.sh darwin/arm64 v0.0.0-dev   # one platform per run
+make studio
 ```
-No platform webview dependencies are needed — the shell ships its own
-Chromium. See the [desktop build guide](desktop/README.md#prerequisites).
+See the [Studio build guide](desktop/README.md#prerequisites) for platform
+webview dependencies and Linux build tags.
 ## Quick start
-### CLI / TUI
+### Reasonix Studio
-These commands are for the CLI/TUI installed through Path A:
+Install and launch Studio, then connect a provider and model in the app. No CLI
+setup is needed.
+### CLI / TUI
 ```sh
 reasonix setup                      # configure a provider and model
@@ -158,13 +195,6 @@ reasonix run "implement the TODOs in main.go"
 In an interactive session, run `/init` when you want Reasonix to create project
 instructions.
-### Desktop app
-Download the installer for your platform from the
-[official download page](https://reasonix.io/?download=desktop#start), install
-and launch Reasonix, then configure a provider and model in the app. The CLI
-commands above are not required for the desktop app.
 For advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.md)**,
 **[Guide](./docs/GUIDE.md)**, and
 **[configuration paths](./docs/CONFIG_PATHS.md)**.
@@ -175,14 +205,14 @@ For advanced CLI usage and configuration, see the **[CLI reference](./docs/CLI.m
   [Configuration paths](./docs/CONFIG_PATHS.md) · [ACP editor integration](./docs/ACP.md)
 - **Features & troubleshooting:** [Subagent profiles](./docs/SUBAGENT_PROFILES.md) ·
   [Context Engine v2](./docs/SESSION_MEMORY_RETRIEVAL.md) ·
-  [File deliverables and the `present` tool](./docs/PRESENT_TOOL.md) ·
   [Capability diagnostics](./docs/CAPABILITY_DIAGNOSTICS.md) ·
-  [Recovery and updates](./docs/RECOVERY.md) · [Bot guide](./docs/BOT_GUIDE.md) ·
+  [Recovery and updates](./docs/RECOVERY.md) ·
   [Checkpoints & rewind](./docs/CHECKPOINTS.md)
 - **Engineering & migration:** [Spec](./docs/SPEC.md) ·
   [Task contracts & pause policy](./docs/TASK_CONTRACT.md) ·
-  [Tool contract](./docs/TOOL_CONTRACT.md) · [Migrating from 0.x](./docs/MIGRATING.md)
-- **Extension development:** [Extensions](./docs/EXTENSIONS.md) ·
+  [Tool contract](./docs/TOOL_CONTRACT.md) · [Moving from 1.x to 2.x](./docs/MIGRATING.md) ·
+  [2.x roadmap](./docs/ROADMAP.md)
+- **Extension development:** [Skills](./docs/SKILLS.md) · [Extensions](./docs/EXTENSIONS.md) ·
   [Plugin packages and Manifest v1](./docs/PLUGIN_PACKAGES.md) ·
   [Extension Protocol](./docs/EXTENSION_PROTOCOL.md) ·
   [Go SDK and starter](./sdk/go/README.md)
@@ -212,7 +242,7 @@ A small list of folks whose work has shaped Reasonix the most — the current to
 | **reasonix** | [**HUQIANTAO**](https://github.com/HUQIANTAO) | [**GTC2080**](https://github.com/GTC2080) | [**mchenziyi**](https://github.com/mchenziyi) |
 | [**Li-Charles-One**](https://github.com/Li-Charles-One) | **merge-order-check** | [**light-front-theory**](https://github.com/light-front-theory) | **Yan Li** |
 | [**eghrhegpe**](https://github.com/eghrhegpe) | **wufengfan** | [**Bernardxu123**](https://github.com/Bernardxu123) | [**HaoyueQin**](https://github.com/HaoyueQin) |
-| [**CVEngineer66**](https://github.com/CVEngineer66) | [**JesonChou**](https://github.com/JesonChou) | [**SuMuxi66**](https://github.com/SuMuxi66) | [**lanshi17**](https://github.com/lanshi17) |
+| [**CVEngineer66**](https://github.com/CVEngineer66) | [**KHG420**](https://github.com/KHG420) | [**JesonChou**](https://github.com/JesonChou) | [**SuMuxi66**](https://github.com/SuMuxi66) |
 <!-- reasonix-top-contributors:end -->
 Special thanks to [**Bernardxu123**](https://github.com/Bernardxu123) for designing the project logo and intro video.
@@ -242,8 +272,9 @@ coffee, not a contract — donations don't buy feature priority or change how
 issues get triaged.
 - **International** — PayPal: [paypal.me/yuhuahui](https://paypal.me/yuhuahui)
-- **国内** — 微信支付（扫码）
+- **国内** — 微信支付 / 支付宝（扫码）
 <p align="center">
   <img src=".github/sponsor/wechat-pay.jpg" alt="WeChat Pay QR code" width="180"/>
+  <img src=".github/sponsor/alipay.jpg" alt="Alipay QR code" width="180"/>
 </p>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "reasonix",
-  "version": "1.39.7",
+  "version": "2.28.0",
   "description": "Cache-first DeepSeek coding agent for the terminal.",
   "bin": {
     "reasonix": "bin/reasonix.js"
@@ -29,13 +29,12 @@
     "tui"
   ],
   "optionalDependencies": {
-    "@reasonix/cli-darwin-arm64": "1.39.7",
-    "@reasonix/cli-darwin-x64": "1.39.7",
-    "@reasonix/cli-linux-arm64": "1.39.7",
-    "@reasonix/cli-linux-x64": "1.39.7",
-    "@reasonix/cli-win32-arm64": "1.39.7",
-    "@reasonix/cli-win32-x64": "1.39.7"
+    "@reasonix/cli-darwin-arm64": "2.28.0",
+    "@reasonix/cli-darwin-x64": "2.28.0",
+    "@reasonix/cli-linux-arm64": "2.28.0",
+    "@reasonix/cli-linux-x64": "2.28.0",
+    "@reasonix/cli-win32-arm64": "2.28.0",
+    "@reasonix/cli-win32-x64": "2.28.0"
   },
-  "reasonixCandidateSha": "6dbabcbf7135c56ff5186b0cd36f5cc2725f47b4",
-  "gitHead": "6dbabcbf7135c56ff5186b0cd36f5cc2725f47b4"
+  "reasonixCandidateSha": "d338338d546f7c48b5a3da38a452b6c6f62c394b"
 }