Reasonix Einsteiger-Tutorial

Reasonix ist ein quelloffener KI-Coding-Agent für das Terminal, der tiefgehend für DeepSeek optimiert ist. Seine gesamte Laufzeitschleife wurde von Grund auf um DeepSeeks Prefix-Cache-Mechanismus herum konzipiert, mit dem Ziel, KI-Coding günstig genug zu machen, um es unbegrenzt weiterlaufen zu lassen.

Die Designphilosophie von Reasonix:"Ein Coding-Agent, der günstig genug bleibt, um ihn eingeschaltet zu lassen."(Ein KI-Coding-Agent, günstig genug, um unbegrenzt weiterzulaufen).

Für wen ist es gedacht?

SzenarioBeschreibung
DeepSeek als primäres Werkzeug für Coding-Aufgaben verwendenTiefe Anpassung an die DeepSeek API, mit Cache-Trefferraten, die Allzweck-Tools weit übertreffen
Besorgt über die Kosten der KI-NutzungPräzise Kostenkontrolle, mit Budget-Obergrenzen und Echtzeit-Kostenstatistiken
Terminal-Workflows bevorzugenTerminal-First-Design: Diffs befinden sich in git diff, Dateibäume befinden sich in ls
Agenten über lange Zeiträume kontinuierlich ausführenIdeal für die Analyse großer Codebasen, Batch-Refactoring und ähnliche Szenarien

Was Reasonix nicht tut

Reasonix hat Meinungen; hier ist, was es bewusst nicht tut:

Was es nicht tutGrund
Flexibles Wechseln zwischen mehreren AnbieternNur DeepSeek; das ist Absicht, keine Einschränkung
IDE-IntegrationTerminal-first; verfolgt keine IDE-Plugins
Schwierigste Reasoning-BenchmarksClaude Opus führt bei bestimmten Benchmarks weiterhin; beginnen Sie mit Claude für Beweisprobleme auf PhD-Niveau
Offline / völlig kostenlosErfordert einen kostenpflichtigen DeepSeek-API-Schlüssel; für Offline-Lösungen siehe Aider + Ollama

Bevor Sie Reasonix verwenden, müssen Sie einen DeepSeek-API-Schlüssel erhalten. Besuchen Sieplatform.deepseek.com/api_keys, melden Sie sich an oder registrieren Sie ein Konto.

Klicken Sie aufAPI-Schlüssel erstellen, benennen Sie ihn (z. B. reasonix), kopieren und speichern Sie ihn.

Beim ersten Ausführen vonreasonixwerden Sie aufgefordert, den API-Schlüssel einzufügen. Nach der Eingabe wird er automatisch gespeichert, und Sie müssen ihn nicht erneut eingeben.


Installation: CLI und Desktop

Reasonix bietet zwei Installationsmethoden: CLI und Desktop. Sie werden unten separat beschrieben.

CLI-Installation

Systemanforderungen: Node.js ≥ 22, unterstützt macOS, Linux, Windows (PowerShell, Git Bash, Windows Terminal).

Globale Installation (empfohlen für die tägliche Nutzung):

npm install -g reasonix

Nutzung ohne Installation (npx, verwendet immer die neueste Version):

# 进入项目目录,直接使用 npx 运行
cd my-project
npx reasonix code

Überprüfung und Health-Check: Versionsnummer anzeigen:

reasonix --version

Health-Check: Node-Version, Erreichbarkeit des API-Schlüssels, MCP-Konfiguration:

reasonix doctor

Auf die neueste Version aktualisieren:

reasonix update

Vollständige Konfiguration über einen interaktiven Assistenten zum Initialisieren von API-Schlüssel, Sprache, Design und weiteren Einstellungen.

reasonix setup

Sprache auswählen:

Design auswählen:

DeepSeek-API-Schlüssel eingeben:

Zum Speichern die Eingabetaste drücken:

Als Nächstes in das Projekt vibe-coding-example wechseln, und schon können Sie es verwenden:

cd vibe-coding-example

Geben Sie den folgenden Befehl ein, um zu starten:

reasonix

Geben Sie/ein, um unterstützte Befehle anzuzeigen:

Desktop-Installation

Die Desktop-Version ist ein nativer Client auf Basis von Tauri, mit mehreren Tabs; das rechte Panel zeigt Dateien, die der Agent in der aktuellen Sitzung gelesen oder bearbeitet hat.

Unten werden dieselben Kosten-/Cache-/Token-Zähler wie in der oberen Leiste der CLI angezeigt. Sie verwendet denselben DeepSeek API Key und die ~/.reasonix-Konfiguration.

Die Desktop-Version hat eine integrierte Node-Runtime; eine separate npm install ist nicht nötig.

Laden Sie von der offiziellen Website (https://reasonix.io/#start) den Installer für Ihre Plattform herunter:

PlattformDateiformat
macOSReasonix_x.x.x_universal.dmg
WindowsReasonix_x.x.x_x64-setup.exe
LinuxReasonix_x.x.x_amd64.AppImage oder .deb

Nach dem Herunterladen doppelklicken Sie zum Installieren und geben Sie dann Ihren API-Schlüssel ein:

Nach dem Start hat der Desktop ebenfalls das klassische Links-Rechts-Layout:

Geben Sie eine Nachricht in das Eingabefeld ein, um mit dem Chatten zu beginnen:

Klicken Sie auf das Symbol in der oberen rechten Ecke, um ein dreispaltiges Layout zu öffnen:

Drei Kollaborationsmodi:

Allgemeine Einstellungen, einschließlich Theme, Erscheinungsbild, Sprache, Plugins, MCP usw.:

Hinweise zum ersten Start:

Der Gatekeeper von macOS blockiert den ersten Start. Zum einmaligen Umgehen: Führen Sie xattr -dr com.apple.quarantine /Applications/Reasonix.app im Terminal aus, oder klicken Sie mit der rechten Maustaste → Öffnen → Bestätigen.

Windows: SmartScreen zeigt "Unbekannter Herausgeber"; klicken Sie auf "Weitere Informationen → Trotzdem ausführen". Linux: .deb und .AppImage laufen direkt, keine zusätzlichen Schritte erforderlich.

Die Desktop-Version befindet sich derzeit im Prerelease-Status; die Schleife und das Protokoll sind genau dieselben wie bei der CLI, aber die Benutzeroberfläche wird noch poliert, und der Installer ist noch nicht code-signiert. Die CLI ist die primäre Entwicklungsschnittstelle; jede in der CLI verfügbare Funktion kann im Eingabefeld der Desktop-Version verwendet werden.


Erster Start

Wechseln Sie in das Projektverzeichnis und starten Sie den Reasonix-Coding-Modus.

cd your-project

# 启动编程模式(以下两种方式等价)
reasonix code
# 或者直接
reasonix

Versuchen Sie, die erste Nachricht zu senden:

Analyze the directory structure of this project, and tell me the responsibilities of the main modules.

Reasonix ruft Tools wie list_directory und read_file auf, um das Projekt zu scannen und eine strukturierte Analyse auszugeben.

Headless-Lauf (Pipe-freundlich)

# 单次执行,结果流式输出到 stdout
reasonix run "统计 src 目录中每个 .ts 文件的行数,按从多到少排序"

# 结合 git diff 使用
git diff HEAD~1 | reasonix run "给这段 diff 写一个 Conventional Commits 格式的 commit message"

Zwei Modi: Code und Chat

Reasonix bietet zwei Betriebsmodi für unterschiedliche Anwendungsfälle.

Fähigkeitencodechat
Dateisystem-Tools + edit_file✓—
SEARCH/REPLACE → /apply review✓—
Shell-Tool (durch Berechtigungen gesteuert)✓—
Planmodus, /todo, /skill new, /mcp add✓—
Gedächtnis (remember / recall_memory)Projektebene + globalNur global
MCP-Server, Websuche, ask_choice✓✓
SitzungsbereichPro Verzeichnis isoliertGemeinsame Standardeinstellung

code ist der Standardmodus und der einzige Modus mit Dateisystem- und Shell-Tools — hier starten.

chat ist ein leichterer Modus ohne Festplattenzugriff — verwenden Sie ihn, wenn Sie einen Denkpartner brauchen, aber nicht möchten, dass die KI Dateien anfasst, oder wenn Sie MCP für den Informationsabruf einbinden.

Der System-Prompt des Chat-Modus ist kürzer, mit geringeren Token-Kosten.

Reasonix beschränkt Dateisystem-Tools auf das Startverzeichnis, umgeleitet über --dir. Ein Wechsel des Verzeichnisses zur Laufzeit wird nicht unterstützt (Speicherpfade verheddern sich mit dem alten Root-Pfad) — beenden und neu starten.

# 在指定目录下启动 code 模式
reasonix code --dir /path/to/other-project

Bearbeitungsfreigabe: SEARCH/REPLACE-Vorschau-Ablauf

Dies ist Reasonix' wichtigster Sicherheitsmechanismus — die KI ändert niemals Dateien ohne Ihr Wissen.

Drei Modi der Bearbeitungsfreigabe

Wechseln über /mode oder Shift+Tab:

ModeVerhalten
ReviewVorschau für jede Bearbeitung anzeigen, y/n-Bestätigung pro Hunk
auto(AUTO)Wird automatisch angewendet, aber drücken Sie innerhalb von 5 Sekunden u, um rückgängig zu machen.
yoloDirekt ohne Bestätigung auf die Festplatte schreiben

Typischer Bearbeitungsablauf (Überprüfungsmodus)

1. 你:帮我把 getUserById 函数加上错误处理

2. Reasonix 分析代码,提出 SEARCH/REPLACE 修改方案:

   ─── src/services/user.ts ───
   - async function getUserById(id: string) {
   -   const user = await db.users.findOne({ id });
   -   return user;
   - }
   + async function getUserById(id: string): Promise<User | null> {
   +   try {
   +     const user = await db.users.findOne({ id });
   +     return user ?? null;
   +   } catch (error) {
   +     logger.error({ id, error }, 'getUserById failed');
   +     throw new AppError('USER_FETCH_FAILED', 500);
   +   }
   + }

3. 你:/apply        ← 确认应用,文件写盘
        /discard      ← 丢弃不应用
        /walk         ← 逐块 git-add-p 风格审查

Bearbeitungsverlauf

# 列出本次会话的所有编辑批次
/history

# 查看某次编辑的 diff
/show <id>

# 回滚最近一次 /apply
/undo

Planungsmodus: Schreibgeschütztes Analyse-Gate

Der Planungsmodus versetzt Reasonix in einen schreibgeschützten Zustand — die KI kann nur Dateien lesen, Code analysieren und Pläne vorschlagen; sie kann keine Dateien schreiben oder Befehle ausführen, bis Sie den Plan ausdrücklich genehmigen.

Aktivierung und Workflow

/plan                ← 切换 Plan 模式(顶栏出现 PLAN MODE 标记)

你:我想把这个 Express 应用迁移到 Fastify,先给我分析影响范围

AI 分析后提交计划:
  ✓ 需要替换 5 个路由文件
  ✓ 3 个中间件需要适配
  ✓ 12 个测试需要更新
  预计改动:43 个文件,约 800 行

plan-confirm 模态框出现
  → Ctrl+P 展开/折叠完整计划详情
  → 批准后 AI 进入执行模式
  → 执行过程中每次修改仍走编辑门控

Wann der Planungsmodus verwendet werden sollte

SzenarioBeschreibung
Große ÄnderungenAufgaben, die mehr als 5 Dateien betreffen
ArchitekturänderungenFramework-Migration, Datenbankwechsel, API-Redesign
TeamzusammenarbeitSzenarien, in denen die Vorgehensweise abgestimmt werden muss
Ungewisser UmfangWenn du eine Vorschau sehen möchtest, welche Stellen die KI bearbeiten wird

Modelle und Kostenkontrolle

Reasonix bietet flexible Mechanismen für Modellwechsel und Kostenkontrolle.

Presets wechseln

# 默认 smart(v4-flash + max 推理)
reasonix code

# 快速任务,v4-flash + high 推理,成本最低
reasonix code --preset fast

# 复杂任务,v4-pro + max 推理
reasonix code --preset max

Wechseln innerhalb einer Sitzung:

/preset auto         # 开启自动升级逻辑(flash 优先,失败升级 pro)
/preset flash        # 锁定 flash
/preset pro          # 锁定 pro

/pro Einmal-Upgrade

Der Benutzer gibt /pro ein, der nächste Turn verwendet v4-pro, danach deaktiviert es sich automatisch. Kein Preset-Wechsel, kein Vergessen des Zurücksetzens.

Der aktive Status wird als gelber "pro armed"-Indikator in der oberen Leiste angezeigt.

> /pro
> 解释这段 Rust 异步代码里的生命周期标注为什么必须这样写
# 回答完成后自动恢复 v4-flash

Automatisches Upgrade bei Fehlschlag

Pro Turn sichtbare "flash ist der Aufgabe nicht gewachsen"-Ereignisse: SEARCH-not-found-Fehler in edit_file/write_file und ToolCallRepair-Auslöser.

Sobald der Zählerstand 3 erreicht, wird der Rest des aktuellen Turns automatisch auf v4-pro umgestellt, angekündigt durch eine gelbe Warnzeile — keine stillen Kosten.

Session-Budget-Obergrenze festlegen

# 本次会话上限 $0.50
reasonix code --budget 0.50
/budget 0.20                     # 会话中设置 $0.20 上限
/budget off                      # 取消上限

Bei 80% warnen, bei 100% den nächsten Turn ablehnen.

Kontextkomprimierung und Kostenabfrage

/compact         # 手动将旧轮次折叠为摘要(缓存安全)
                 # 上下文达到 50% 时自动触发,这是手动触发

/cost            # 上一轮花费
/cost 这段文字   # 预估发送这段文字的成本
/stats           # 跨会话成本仪表板(今天/本周/本月/所有时间)

Skills: Wiederverwendbare Markdown-Playbooks

Skills sind Markdown-Playbooks, die die KI bei Bedarf aufrufen kann, ohne entfernte Registry — schreibe sie direkt und sie werden sofort wirksam.

Skills erstellen

# 项目级技能:<project>/.reasonix/skills/code-review.md
/skill new code-review

# 全局技能:~/.reasonix/skills/deploy-check.md
/skill new deploy-check --global

Skill-Dateiformat

Dateipfad: .reasonix/skills/code-review.md

---
description: 对当前改动做系统性代码审查,按 P0-P3 优先级分级
runAs: subagent
tools: [read_file, list_directory, search_content]
---

分析 `git diff HEAD` 中的所有改动。

对每个发现的问题,按如下格式输出:

**[P0]** 严重(阻止合并):安全漏洞、逻辑错误、数据丢失风险
**[P1]** 重要(强烈建议修复):性能问题、错误处理缺失
**[P2]** 一般(建议修复):代码质量、可读性
**[P3]** 改进(可选):最佳实践、未来优化

每条包含:文件名和行号 · 问题描述(一句话)· 修复建议。

最后给出总体评估:是否可以合并,以及最重要的三个改进点。

runAs: subagent führt den Skill in einer isolierten Sub-Agent-Schleife aus, sodass der Kontext der Haupt-Session nicht aufgebläht wird.

Aufrufen und Verwalten

/skill code-review        # 调用技能
/skill list               # 列出所有可用技能
/skill show code-review   # 查看技能内容

Mit Claude-Format kompatible Skills

<project>/.claude/skills/<name>/SKILL.md und ~/.claude/skills/ werden ebenfalls automatisch gelesen.

Sie koexistieren mit den nativen Pfaden von Reasonix, sodass Tools, die Skills im Claude-Format ausgeben, direkt verwendet werden können.

# 写入 .claude/skills/openspec-*/SKILL.md
npx openspec init --tools claude

# 在 Reasonix 中直接调用
/skill openspec-propose <task>

Speicher: Sitzungsübergreifende Kontextpersistenz

Reasonix hat vier Speichertypen, um Kontext über Sitzungen hinweg zu erhalten.

TypeGeltungsbereichZweck
userGlobalIhre Präferenzen, Arbeitsgewohnheiten
feedbackGlobalFehler oder Erfolgserfahrungen der KI
projectProjektebeneProjektkonventionen, Architekturentscheidungen
ReferenzKonfigurierbarFeste Referenzmaterialien

Manuelles Schreiben

/remember 这个项目用 pnpm 而不是 npm
/remember 所有 API 错误统一走 AppError 类,不要 throw 原生 Error
/remember Turso 批量写入并发时需要加锁,见 src/db/mutex.ts

Speicher verwalten

/memory list              # 查看所有记忆
/memory show <id>         # 查看某条记忆详情
/memory forget <id>       # 删除某条记忆
/memory clear             # 清空所有记忆

Projekt-Speicherdatei (REASONIX.md)

Erstellen Sie REASONIX.md im Projektstammverzeichnis; sie wird automatisch zu Beginn jeder Sitzung geladen.

# 扫描项目,自动生成 REASONIX.md 基线
/init

# 强制重新生成(覆盖已有文件)
/init force

Oder manuell erstellen:

# 项目:example-backend

## 技术栈
- Runtime:Bun 1.2(禁止使用 Node.js 专属 API)
- 框架:Hono
- 数据库:Turso(libSQL)

## 编码规范
- 所有函数必须有 JSDoc 类型注解
- 错误统一用 AppError 类
- 禁止 any 类型

## 已知陷阱
- Turso 并发写入需要互斥锁,见 src/db/mutex.ts

MCP-Integration: Anbindung externer Tools

MCP-Server unterstützen drei Transporte: stdio, SSE und Streamable HTTP.

Das gleiche Konfigurationsformat gilt sowohl für config.json als auch für das Kommandozeilenargument --mcp.

Dynamisches Hinzufügen in der Sitzung

/mcp                      # 打开 MCP 中心(在线 + 市场标签页)
/mcp add stdio:npx,-y,@modelcontextprotocol/server-github

Einbindung über die Kommandozeile

# 通过命令行参数挂载 MCP 服务器
reasonix code --mcp stdio:npx,-y,@modelcontextprotocol/server-github

Voreinstellungen in der Konfigurationsdatei (Empfohlen)

Dateipfad: ~/.reasonix/config.json

Beispiele

{
  "mcp": {
    "servers": {
      "github": {
        "transport": "stdio",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
        }
      },
      "postgres": {
        "transport": "stdio",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-postgres"],
        "env": {
          "POSTGRES_CONNECTION_STRING": "postgresql://localhost/mydb"
        }
      },
      "searxng": {
        "transport": "sse",
        "url": "http://localhost:8080/mcp/sse"
      }
    }
  }
}

MCP-Tools durchsuchen

/mcp list                 # 列出已连接的服务器
/resource                 # 浏览 MCP 资源
/prompt                   # 浏览 MCP 提示词模板

Hooks: Lebenszyklus-Automatisierung

Hooks unterstützen vier Lebenszyklus-Ereignisse; PreToolUse kann Tool-Aufrufe mit einem Exit-Code ungleich null blockieren.

Unterstützte Ereignisse

HookAuslösezeitpunktSpezielle Fähigkeit
PreToolUseVor Tool-AufrufenExit-Code ungleich null = Aufruf ablehnen
PostToolUseNach Tool-AufrufenProtokollierung/Formatierung
UserPromptSubmitWenn der Benutzer eine Nachricht sendetZusätzlichen Kontext einfügen
StoppWenn die Sitzung endetZusammenfassung/Aufräumen

Konfigurationsbeispiel

Dateipfad: ~/.reasonix/config.json

Beispiele

{
  hooks: {
    "PostToolUse": [
      {
        "matcher": { "tool": "edit_file" },
        "command": "npx biome format --write {{file}} 2>/dev/null || true",
        "description": "Automatisches Formatieren nach dem Bearbeiten von Dateien"
      }
    ],
    "PreToolUse": [
      {
        "matcher": { "tool": "run_command" },
        "command": "echo '$(date): {{command}}' >> ~/.reasonix/audit.log",
        "description": "Alle Shell-Befehle in einem Audit-Log protokollieren"
      }
    ],
    "Stop": [
      {
        "command": "reasonix stats --session last >> ~/.reasonix/sessions-log.txt",
        "description": "Statistiken nach Ende einer Sitzung speichern"
      }
    ]
  }
}

Anzeigen und Neuladen

/hooks                    # 列出所有已配置的 hooks
/hooks reload             # 热重载 hooks 配置(无需重启)

Sitzungsverwaltung und Checkpoint

Reasonix bietet vollständige Sitzungsverwaltung und Datei-Snapshot-Funktionen.

Sitzungsverwaltung

Beispiele

# Alle Sitzungen auflisten
reasonix sessions

# Angegebene Sitzung öffnen
reasonix sessions my-project

# Sitzungen löschen, die älter als 30 Tage sind
reasonix prune-sessions --days 30

Befehle innerhalb einer Sitzung:

/sessions                 # 列出已保存会话(当前标记 ▸)
--session <name>          # 启动时绑定到具名会话
--continue                # 恢复该工作区最近一次会话
--new                     # 强制新建会话(即使已有现成的)
--no-session              # 临时运行,不持久化任何内容

Checkpoint (Datei-Snapshot)

/checkpoint               # 为本次会话碰过的所有文件创建快照
/checkpoint my-snapshot   # 创建具名快照
/checkpoint list          # 列出所有快照
/checkpoint forget <id>   # 删除快照

/restore my-snapshot      # 恢复到指定快照

Sitzungs-Replay (zum Debuggen)

# 重新渲染 JSONL 会话记录,不调用模型
reasonix replay <transcript>

# 对比两个会话的成本/缓存/Token 差异
reasonix diff <a> <b>

# 跟踪某个会话的事件日志
reasonix events <name>

Semantische Indexierung und Websuche

Reasonix unterstützt das Erstellen eines lokalen Vektorindex für Projekte und das Konfigurieren einer Websuchmaschine.

Semantische Indexierung

Erstellen Sie einen lokalen Vektorindex für das Projekt, der semantische Suche unterstützt, ohne dass exakte Schlüsselwortübereinstimmungen erforderlich sind.

# 构建索引(需要 Ollama 或 OpenAI 兼容 Embedding 端点)
reasonix index

Konfiguration (~/.reasonix/config.json):

Beispiele

{
  "index": {
    "endpoint": "http://localhost:11434/api/embeddings",
    "model": "nomic-embed-text"
  }
}

Nach dem Erstellen in einer Sitzung verwenden:

> 找出所有和用户认证相关的代码
# 触发 semantic_search 工具,基于语义而非关键词检索

Websuche

Mojeek ist die Standardeinstellung; wechseln Sie über /search-engine (oder /se).

/search-engine mojeek     # 默认,隐私友好
/search-engine searxng    # 自托管 SearXNG 实例
/search-engine metaso     # 秘塔搜索(中文内容优化)

Selbstgehostetes SearXNG konfigurieren:

Beispiele

{
  "search": {
    "engine": "searxng",
    "searxngUrl": "http://localhost:8888"
  }
}

QQ-Kanal-Fernsteuerung

Reasonix kann QQ als Fernkommunikationskanal für bestehende Chat- und Code-Sitzungen verwenden; es ist kein eigenständiger Ausführungsmodus.

Starten Sie zuerst eine Sitzung und verbinden Sie sich dann mit QQ.

# 1. 先启动会话
reasonix code

# 2. 会话中连接 QQ
/qq connect          # 首次使用引导输入 App ID 和 App Secret
/qq status           # 查看连接状态
/qq disconnect       # 断开连接

Nach der Verbindung können Slash-Befehle, Bestätigungsaufforderungen und KI-Antworten alle über QQ laufen, ohne dass Sie im Terminal tippen müssen. Nachfolgende Chat-/Code-Sitzungen starten automatisch den QQ-Kanal. Benutzer der Desktop-Version können es in den Einstellungen → Allgemein → QQ-Kanal konfigurieren.


Desktop-Detailanleitung

Die Desktop-Version fügt der CLI-TUI weitere Visualisierungsfunktionen hinzu.

Oberflächenlayout

Die Desktop-Version fügt der CLI-TUI drei Hauptpanels hinzu:

PanelFunktion
Datei-Panel auf der rechten SeiteZeigt in Echtzeit die Liste der Dateien an, die der Agent in der aktuellen Sitzung gelesen oder bearbeitet hat; klicken Sie, um den Inhalt direkt anzuzeigen.
Untere StatusleisteEntspricht vollständig der oberen Leiste der CLI – Kostenanzeige, Cache-Trefferrate, aktuelles Modell, Token-Verbrauch
Mehrere TabsKann mehrere Projekt-Sitzungen gleichzeitig öffnen und unabhängig zwischen Tabs wechseln

Beziehung zur CLI

Die Desktop-Version und die CLI verwenden dieselbe Konfiguration (~/.reasonix/config.json) und denselben API-Schlüssel.

In der CLI gespeicherte Skills, Erinnerungen und MCP-Konfigurationen sind sofort in der Desktop-Version verfügbar und umgekehrt.

Alle in der CLI verfügbaren Slash-Befehle werden im Eingabefeld der Desktop-Version vollständig unterstützt, einschließlich /plan, /skill, /mcp, /apply, /pro usw.

Desktop-spezifische Funktionen

FähigkeitBeschreibung
Grafische Dateibaum-NavigationProjektdateien im rechten Bereich visuell durchsuchen
Multi-Tab-ArbeitsbereichsverwaltungBenutzerfreundlichere Erfahrung beim Wechseln zwischen mehreren Projekten
Grafische QQ-KonfigurationEinstellungen → Allgemein → QQ-Kanal
Integrierte Node-LaufzeitBenutzer müssen Node.js nicht separat installieren

Fall 1: Erkundung eines neuen Projekts und Codelesen

Szenario: Übernahme eines unbekannten TypeScript-Backend-Repositories, wobei die Architektur schnell verstanden und Schlüsselmodule gefunden werden müssen.

Chat-Modus verwenden (greift nicht auf Dateien zu, spart Kosten):

# 进入项目目录,使用 chat 模式并挂载 MCP
cd unknown-project
reasonix chat --mcp stdio:npx,-y,@modelcontextprotocol/server-github

Demo des Gesprächsablaufs:

你:用 100 字以内描述这个项目是做什么的

AI:[调用 read_file 读 README.md 和 package.json]
    这是一个多租户 SaaS 订阅管理服务,基于 Node.js + PostgreSQL,
    处理订阅计划创建、支付 Webhook 和使用量追踪。

你:找出最核心的 3 个业务逻辑文件,各用一句话说明职责

AI:[调用 list_directory、search_content 扫描 src/]
    1. src/billing/subscription.ts — 订阅生命周期管理(创建/升级/取消)
    2. src/webhooks/stripe.ts — Stripe 事件处理和订阅状态同步
    3. src/usage/tracker.ts — API 调用量统计和超限检测

你:src/billing/subscription.ts 里的 cancelSubscription 函数,
    它做了什么,有没有可能的竞态条件?

AI:[调用 read_file 精确读取该函数]
    该函数...
    潜在竞态:如果同时收到两次取消请求,
    第 47 行的状态检查和第 52 行的数据库更新之间存在时间窗口...

Projektgedächtnis generieren:

你:把刚才了解的内容写成 REASONIX.md,我切到 code 模式后继续工作

AI:[生成 REASONIX.md 草稿]

你:/apply

Fall 2: Multi-Datei-Refactoring (mit Plan-Modus)

Szenario: Die Fehlerbehandlung der bestehenden REST API von throw new Error() auf eine benutzerdefinierte AppError-Klasse umstellen.

Starten und in den Planmodus wechseln:

# 启动 code 模式
reasonix code
你:/plan

你:我要把所有 throw new Error() 改成 throw new AppError()。
    AppError 类在 src/errors.ts,接受 code、message、statusCode 三个参数。
    先分析影响范围,不要做任何修改。

AI:[调用 search_content 搜索 "throw new Error"]

    找到 23 处需要迁移的调用,分布在 8 个文件:
    - src/routes/users.ts (5 处)
    - src/routes/billing.ts (4 处)
    - src/services/auth.ts (7 处)
    ...

    建议迁移顺序:先处理 services 层(无 HTTP 依赖),
    再处理 routes 层,最后更新测试。

    预计改动:23 处调用,约 150 行代码变更。

    [plan-confirm 弹出]
    → Ctrl+P 展开完整文件清单

你:批准

AI:[进入执行模式,依次修改文件]
    每次改动都会弹出 SEARCH/REPLACE 预览

你:/apply     ← 每批次确认

Nach Abschluss der Ausführung:

你:/commit
AI:[分析所有改动,生成 commit message]
    "refactor: migrate error handling to AppError class

    Replace 23 bare Error throws with typed AppError instances
    across 8 files, improving error observability and HTTP status
    code consistency."

你:确认提交

Fall 3: Fehlerlokalisierung und -behebung

Szenario: Ein intermittierender Fehler "Cannot read properties of undefined" tritt in der Produktionsumgebung auf, und die Logs enthalten nur einen Stacktrace.

Beispiele

,
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
        }
      }
    }
  },

  "permissions": {
    "shell": {
      "allow": [
        "npm test",
        "npm run ",
        "git ",
        "pnpm ",
        "cat ",
        "ls ",
        "grep "
      ]
    }
  },

  "hooks": {
    "PostToolUse": [
      {
        "matcher": { "tool": "edit_file" },
        "command": "npx biome format --write {{file}} 2>/dev/null || true"
      }
    ]
  },

  "search": {
    "engine": "searxng",
    "searxngUrl": "http://localhost:8888"
  },

  "index": {
    "endpoint": "http://localhost:11434/api/embeddings",
    "model": "nomic-embed-text"
  },

  "parallelMax": 4
}

Berechtigungs-Whitelist-Regeln

Verwendet exakte Präfixübereinstimmung: Das Zulassen von "git " bedeutet, alle Befehle zuzulassen, die mit "git " beginnen (beachten Sie das abschließende Leerzeichen). Befehle, die nicht in der Whitelist stehen, erfordern jedes Mal eine manuelle Bestätigung.


Vergleich mit anderen Tools

Das Folgende ist ein Vergleich zwischen Reasonix und anderen gängigen KI-Programmierwerkzeugen:

DimensionReasonixClaude CodeCursorAider
BackendDeepSeek (exklusiv)AnthropicOpenAI/AnthropicBeliebig (OpenRouter)
LizenzMITClosed SourceClosed SourceApache 2
KostenmerkmaleGeringe Kosten pro AufgabePremium-PreiseAbonnement + NutzungHängt vom Modell ab
DeepSeek-Präfix-CacheSpeziell konzipiertNicht zutreffendNicht zutreffendGelegentlicher Treffer
Integriertes Web-DashboardJa—In der IDE—
Konfigurierbare Web-Suchmaschine/search-engine———
Persistente Sitzungen pro ArbeitsbereichJaTeilweiseNicht zutreffend—
Planmodus · MCP · Hooks · SkillsAlle verfügbarAlle verfügbarJaTeilweise

Ressourcen und Community

Im Folgenden finden Sie die offiziellen Ressourcen und Community-Links von Reasonix.

Offizielle Ressourcen

RessourceLink
GitHubesengine/DeepSeek-Reasonix
Offizielle Websitehttps://reasonix.io/
Dokumentationhttps://reasonix.io/docs/
Weitere Erweiterungen