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?
| Szenario | Beschreibung |
|---|---|
| DeepSeek als primäres Werkzeug für Coding-Aufgaben verwenden | Tiefe Anpassung an die DeepSeek API, mit Cache-Trefferraten, die Allzweck-Tools weit übertreffen |
| Besorgt über die Kosten der KI-Nutzung | Präzise Kostenkontrolle, mit Budget-Obergrenzen und Echtzeit-Kostenstatistiken |
| Terminal-Workflows bevorzugen | Terminal-First-Design: Diffs befinden sich in git diff, Dateibäume befinden sich in ls |
| Agenten über lange Zeiträume kontinuierlich ausführen | Ideal 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 tut | Grund |
|---|---|
| Flexibles Wechseln zwischen mehreren Anbietern | Nur DeepSeek; das ist Absicht, keine Einschränkung |
| IDE-Integration | Terminal-first; verfolgt keine IDE-Plugins |
| Schwierigste Reasoning-Benchmarks | Claude Opus führt bei bestimmten Benchmarks weiterhin; beginnen Sie mit Claude für Beweisprobleme auf PhD-Niveau |
| Offline / völlig kostenlos | Erfordert 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:

| Plattform | Dateiformat |
|---|---|
| macOS | Reasonix_x.x.x_universal.dmg |
| Windows | Reasonix_x.x.x_x64-setup.exe |
| Linux | Reasonix_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ähigkeiten | code | chat |
|---|---|---|
| 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 + global | Nur global |
| MCP-Server, Websuche, ask_choice | ✓ | ✓ |
| Sitzungsbereich | Pro Verzeichnis isoliert | Gemeinsame 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:
| Mode | Verhalten |
|---|---|
| Review | Vorschau 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. |
| yolo | Direkt 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
| Szenario | Beschreibung |
|---|---|
| Große Änderungen | Aufgaben, die mehr als 5 Dateien betreffen |
| Architekturänderungen | Framework-Migration, Datenbankwechsel, API-Redesign |
| Teamzusammenarbeit | Szenarien, in denen die Vorgehensweise abgestimmt werden muss |
| Ungewisser Umfang | Wenn 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.
| Type | Geltungsbereich | Zweck |
|---|---|---|
| user | Global | Ihre Präferenzen, Arbeitsgewohnheiten |
| feedback | Global | Fehler oder Erfolgserfahrungen der KI |
| project | Projektebene | Projektkonventionen, Architekturentscheidungen |
| Referenz | Konfigurierbar | Feste 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
| Hook | Auslösezeitpunkt | Spezielle Fähigkeit |
|---|---|---|
| PreToolUse | Vor Tool-Aufrufen | Exit-Code ungleich null = Aufruf ablehnen |
| PostToolUse | Nach Tool-Aufrufen | Protokollierung/Formatierung |
| UserPromptSubmit | Wenn der Benutzer eine Nachricht sendet | Zusätzlichen Kontext einfügen |
| Stopp | Wenn die Sitzung endet | Zusammenfassung/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
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:
| Panel | Funktion |
|---|---|
| Datei-Panel auf der rechten Seite | Zeigt 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 Statusleiste | Entspricht vollständig der oberen Leiste der CLI – Kostenanzeige, Cache-Trefferrate, aktuelles Modell, Token-Verbrauch |
| Mehrere Tabs | Kann 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ähigkeit | Beschreibung |
|---|---|
| Grafische Dateibaum-Navigation | Projektdateien im rechten Bereich visuell durchsuchen |
| Multi-Tab-Arbeitsbereichsverwaltung | Benutzerfreundlichere Erfahrung beim Wechseln zwischen mehreren Projekten |
| Grafische QQ-Konfiguration | Einstellungen → Allgemein → QQ-Kanal |
| Integrierte Node-Laufzeit | Benutzer 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:
| Dimension | Reasonix | Claude Code | Cursor | Aider |
|---|---|---|---|---|
| Backend | DeepSeek (exklusiv) | Anthropic | OpenAI/Anthropic | Beliebig (OpenRouter) |
| Lizenz | MIT | Closed Source | Closed Source | Apache 2 |
| Kostenmerkmale | Geringe Kosten pro Aufgabe | Premium-Preise | Abonnement + Nutzung | Hängt vom Modell ab |
| DeepSeek-Präfix-Cache | Speziell konzipiert | Nicht zutreffend | Nicht zutreffend | Gelegentlicher Treffer |
| Integriertes Web-Dashboard | Ja | — | In der IDE | — |
| Konfigurierbare Web-Suchmaschine | /search-engine | — | — | — |
| Persistente Sitzungen pro Arbeitsbereich | Ja | Teilweise | Nicht zutreffend | — |
| Planmodus · MCP · Hooks · Skills | Alle verfügbar | Alle verfügbar | Ja | Teilweise |
Ressourcen und Community
Im Folgenden finden Sie die offiziellen Ressourcen und Community-Links von Reasonix.
Offizielle Ressourcen
| Ressource | Link |
|---|---|
| GitHub | esengine/DeepSeek-Reasonix |
| Offizielle Website | https://reasonix.io/ |
| Dokumentation | https://reasonix.io/docs/ |