Tutoriel de démarrage Reasonix

Reasonix est un agent de codage IA en terminal open source, profondément optimisé pour DeepSeek. Sa boucle d'exécution entière est conçue à partir de zéro autour du mécanisme de cache de préfixe de DeepSeek, visant à rendre le codage IA suffisamment bon marché pour fonctionner indéfiniment.

Philosophie de conception de Reasonix :"Un agent de codage qui reste suffisamment bon marché pour être laissé allumé."(Un agent de codage IA suffisamment bon marché pour fonctionner indéfiniment).

À qui s'adresse-t-il ?

ScénarioDescription
Utiliser DeepSeek comme outil principal pour les tâches de codageAdaptation profonde à l'API DeepSeek, avec des taux de réussite du cache dépassant largement ceux des outils généralistes
Préoccupation concernant les coûts d'utilisation de l'IAContrôle précis des coûts, avec plafonds budgétaires et statistiques de coûts en temps réel
Préférence pour les workflows en terminalConception centrée sur le terminal : les diffs vivent dans git diff, les arborescences de fichiers dans ls
Exécution d'agents en continu pendant de longues périodesIdéal pour l'analyse de grandes bases de code, le refactoring par lots et les scénarios similaires

Ce que Reasonix ne fait pas

Reasonix a des partis pris ; voici ce qu'il ne fait délibérément pas :

Ce qu'il ne fait pasRaison
Bascule flexible entre plusieurs fournisseursDeepSeek uniquement ; c'est un choix de conception, pas une limitation
Intégration IDEPriorité au terminal ; pas de plugins IDE
Raisonnement le plus difficileClaude Opus reste en tête sur les benchmarks ; commencez par Claude pour les preuves de niveau doctorat
Hors ligne / entièrement gratuitNécessite une clé API DeepSeek ; pour le hors ligne, voir Aider + Ollama

Avant d'utiliser Reasonix, vous devez obtenir une clé API DeepSeek.deepseek.com, connectez-vous ou créez un compte.

Cliquez surCreate API, nommez-la (par exemple, reasonix), copiez et enregistrez-la.

Lors du premier lancement dereasonix, il vous sera demandé de coller la clé API. Après l'avoir saisie, elle est conservée automatiquement, et vous n'aurez plus besoin de la saisir à nouveau.


Installation

Reasonix propose deux méthodes d'installation : CLI et Desktop. Elles sont décrites séparément ci-dessous.

Installation de la CLI

Configuration requise : Node.js ≥ 22, prend en charge macOS, Linux, Windows (PowerShell, Git Bash, Windows Terminal).

Installation globale (recommandée pour un usage quotidien) :

npm install -g reasonix

Expérience sans installation (npx, utilise toujours la dernière version) :

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

Vérification et contrôle de santé : afficher le numéro de version :

reasonix --version

Contrôle de santé : version de Node, accessibilité de la clé API, configuration MCP :

reasonix doctor

Mettre à niveau vers la dernière version :

reasonix update

Configuration complète via un assistant interactif pour initialiser la clé API, la langue, le thème et d'autres paramètres.

reasonix setup

Sélectionnez la langue :

Sélectionnez le thème :

Saisissez la clé API DeepSeek :

Appuyez sur Entrée pour enregistrer :

Ensuite, entrez le projet vibe-coding-example, et vous pouvez commencer à l'utiliser :

cd vibe-coding-example

Entrez la commande suivante pour démarrer :

reasonix

Entrez/pour afficher les commandes prises en charge :

Installation de la version Desktop

La version Desktop est un client natif basé sur Tauri, avec plusieurs onglets ; le panneau de droite affiche les fichiers que l'Agent a lus ou modifiés dans la session en cours.

La partie inférieure affiche les mêmes compteurs de coût/cache/token que la barre supérieure de la CLI. Elle utilise la même clé API DeepSeek et la configuration ~/.reasonix.

La version Desktop intègre un runtime Node ; aucune installation npm séparée n'est nécessaire.

Depuis le site officiel (https://reasonix.io/#start) téléchargez l'installateur pour votre plateforme :

PlateformeFormat de fichier
macOSReasonix_x.x.x_universal.dmg
WindowsReasonix_x.x.x_x64-setup.exe
LinuxReasonix_x.x.x_amd64.AppImage or .deb

Après le téléchargement, double-cliquez pour installer, puis saisissez votre clé API :

Après le lancement, le bureau dispose également de la disposition classique gauche-droite :

Saisissez un message dans la zone de saisie pour commencer à discuter :

Cliquez sur l'icône dans le coin supérieur droit pour ouvrir une disposition à trois colonnes :

Trois modes de collaboration :

Paramètres courants, notamment le thème, l'apparence, la langue, les plugins, MCP, etc. :

Remarques pour le premier lancement :

Le Gatekeeper de macOS bloquera le premier lancement. Pour le contourner une fois : exécutez xattr -dr com.apple.quarantine /Applications/Reasonix.app dans le terminal, ou faites un clic droit → Ouvrir → Confirmer.

Windows : SmartScreen affiche « Éditeur inconnu » ; cliquez sur « Plus d'informations → Exécuter quand même ». Linux : .deb et .AppImage s'exécutent directement, aucune étape supplémentaire n'est nécessaire.

La version Desktop est actuellement en statut Prerelease ; la boucle et le protocole sont exactement les mêmes que ceux de la CLI, mais l'interface utilisateur est encore en cours de peaufinage, et l'installateur n'est pas encore signé numériquement. La CLI est l'interface de développement principale ; toute fonctionnalité disponible dans la CLI peut être utilisée dans la zone de saisie de la version Desktop.


Premier lancement

Entrez dans le répertoire du projet et démarrez le mode de codage Reasonix.

cd your-project

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

Essayez d'envoyer le premier message :

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

Reasonix appellera des outils tels que list_directory et read_file pour parcourir le projet et produire une analyse structurée.

Exécution sans interface (compatible pipe)

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

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

Deux modes : code et chat

Reasonix propose deux modes de fonctionnement pour différents cas d'utilisation.

Capacitéscodechat
Outils de système de fichiers + edit_file✓—
SEARCH/REPLACE → /apply review✓—
Outil shell (contrôlé par les autorisations)✓—
Mode plan, /todo, /skill new, /mcp add✓—
Mémoire (remember / recall_memory)Niveau projet + globalGlobal uniquement
Serveurs MCP, recherche web, ask_choice✓✓
Portée de sessionIsolé par répertoirePartagé par défaut

code est le mode par défaut et le seul mode disposant d'outils de système de fichiers et de shell — commencez ici.

chat est un mode plus léger sans accès disque — utilisez-le lorsque vous avez besoin d'un partenaire de réflexion mais que vous ne voulez pas que l'IA touche aux fichiers, ou lorsque vous montez MCP pour la recherche d'informations.

Le prompt système du mode chat est plus court, avec un coût en tokens plus faible.

Reasonix limite les outils de système de fichiers au répertoire de démarrage, redirigé via --dir. Le changement de répertoire en cours de route n'est pas pris en charge (les chemins de mémoire s'entremêleront avec l'ancien chemin racine) — quittez et redémarrez.

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

Contrôle des modifications : flux d'aperçu SEARCH/REPLACE

C'est le mécanisme de sécurité le plus important de Reasonix — l'IA ne modifie jamais les fichiers à votre insu.

Trois modes de contrôle des modifications

Basculez via /mode ou Shift+Tab :

ModeComportement
revueAfficher un aperçu pour chaque modification, confirmation y/n par bloc
auto(AUTO)Appliqué automatiquement, mais appuyez sur u dans les 5 secondes pour annuler
yoloÉcrire directement sur le disque sans confirmation

Flux d'édition typique (mode révision)

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 风格审查

Historique des modifications

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

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

# 回滚最近一次 /apply
/undo

Mode Plan : Porte d'analyse en lecture seule

Le mode Plan place Reasonix dans un état en lecture seule — l'IA peut uniquement lire des fichiers, analyser le code et proposer des plans ; elle ne peut pas écrire de fichiers ni exécuter de commandes tant que vous n'avez pas explicitement approuvé le plan.

Activation et flux de travail

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

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

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

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

Quand utiliser le mode Plan

ScénarioDescription
Modifications importantesTâches affectant plus de 5 fichiers
Modifications d'architectureMigration de framework, changement de base de données, refonte d'API
Collaboration en équipeScénarios où l'approche doit être alignée
Périmètre incertainLorsque vous voulez prévisualiser les endroits que l’IA va toucher

Modèles et contrôle des coûts

Reasonix fournit des mécanismes flexibles de changement de modèle et de contrôle des coûts.

Changement de préréglages

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

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

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

Changement au sein d’une session :

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

/pro Mise à niveau ponctuelle

L’utilisateur saisit /pro, le tour suivant utilise v4-pro, puis il se désactive automatiquement. Aucun changement de préréglage, aucun oubli de retour en arrière.

Le statut actif est affiché sous la forme d’un indicateur jaune « pro armé » dans la barre supérieure.

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

Mise à niveau automatique en cas d’échec

Événements visibles par tour « flash pas à la hauteur » : erreurs SEARCH-not-found dans edit_file/write_file, et déclenchements de ToolCallRepair.

Une fois que le compteur atteint 3, le reste du tour en cours bascule automatiquement vers v4-pro, annoncé par une ligne d’avertissement jaune — aucun coût silencieux.

Définition d’un plafond budgétaire de session

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

Avertir à 80 %, refuser le tour suivant à 100 %.

Compression du contexte et requête de coût

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

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

Skills : guides pratiques Markdown réutilisables

Les Skills sont des guides pratiques Markdown que l’IA peut invoquer à la demande, sans registre distant — écrivez-les directement et ils prennent effet immédiatement.

Création de compétences

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

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

Format de fichier Skill

Chemin de fichier : .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 exécute la compétence dans une boucle de sous-agent isolée, afin que le contexte de la session principale ne gonfle pas.

Invocation et gestion

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

Skills compatibles avec le format Claude

<project>/.claude/skills/<name>/SKILL.md et ~/.claude/skills/ sont également lus automatiquement.

Ils coexistent avec les chemins natifs de Reasonix, de sorte que les outils qui produisent des skills au format Claude peuvent être utilisés directement.

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

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

Mémoire : persistance du contexte entre les sessions

Reasonix dispose de quatre types de mémoire pour conserver le contexte entre les sessions.

TypePortéeObjectif
userGlobalVos préférences, habitudes de travail
feedbackGlobalLes erreurs ou les expériences réussies de l'IA
projectNiveau projetConventions du projet, décisions d'architecture
référenceConfigurableDocuments de référence fixes

Écriture manuelle

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

Gestion de la mémoire

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

Fichier de mémoire du projet (REASONIX.md)

Créez REASONIX.md à la racine du projet ; il est automatiquement chargé au début de chaque session.

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

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

Ou créez-le manuellement :

# 项目:example-backend

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

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

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

Intégration MCP : connexion d'outils externes

Les serveurs MCP prennent en charge trois transports : stdio, SSE et Streamable HTTP.

Le même format de configuration s'applique à la fois à config.json et à l'argument de ligne de commande --mcp.

Ajout dynamique en session

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

Montage en ligne de commande

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

Préréglages du fichier de configuration (recommandé)

Chemin du fichier : ~/.reasonix/config.json

Exemples

{
  "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"
      }
    }
  }
}

Outils MCP de navigation

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

Hooks : Automatisation du cycle de vie

Les hooks prennent en charge quatre événements de cycle de vie ; PreToolUse peut bloquer les appels d'outils avec un code de sortie non nul.

Événements pris en charge

HookMoment du déclenchementCapacité spéciale
PreToolUseAvant les appels d'outilsCode de sortie non nul = rejeter l'appel
PostToolUseAprès les appels d'outilsJournalisation/formatage
UserPromptSubmitLorsque l'utilisateur envoie un messageInjecter du contexte supplémentaire
ArrêterLorsque la session se termineRésumé/nettoyage

Exemple de configuration

Chemin du fichier : ~/.reasonix/config.json

Exemples

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": { "tool": "edit_file" },
        "command": "npx biome format --write {{file}} 2>/dev/null || true",
        "description": "Formatage automatique après modification de fichiers"
      }
    ],
    "PreToolUse": [
      {
        "matcher": { "tool": "run_command" },
        "command": "echo '$(date): {{command}}' >> ~/.reasonix/audit.log",
        "description": "Consigner toutes les commandes Shell dans un journal d'audit"
      }
    ],
    "Stop": [
      {
        "command": "reasonix stats --session last >> ~/.reasonix/sessions-log.txt",
        "description": "Enregistrer les statistiques après la fin d'une session"
      }
    ]
  }
}

Affichage et rechargement

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

Gestion des sessions et points de contrôle

Reasonix propose une gestion complète des sessions et des fonctionnalités d'instantanés de fichiers.

Gestion des sessions

Exemples

# Lister toutes les sessions
reasonix sessions

# Ouvrir la session spécifiée
reasonix sessions my-project

# Supprimer les sessions de plus de 30 jours
reasonix prune-sessions --days 30

Commandes dans une session :

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

Point de contrôle (instantané de fichier)

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

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

Rejeu de session (pour le débogage)

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

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

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

Indexation sémantique et recherche web

Reasonix prend en charge la création d'un index vectoriel local pour les projets et la configuration d'un moteur de recherche web.

Indexation sémantique

Créez un index vectoriel local pour le projet, permettant une recherche sémantique sans avoir besoin de correspondances exactes de mots-clés.

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

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

Exemples

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

Après l'avoir construit, utilisez-le dans une session :

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

Recherche web

Mojeek est le moteur par défaut ; changez via /search-engine (ou /se).

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

Configurer un SearXNG auto-hébergé :

Exemples

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

Contrôle à distance du canal QQ

Reasonix peut utiliser QQ comme canal de communication à distance pour les sessions de chat et de code existantes ; ce n'est pas un mode d'exécution autonome.

Démarrez d'abord une session, puis connectez-vous à QQ.

# 1. 先启动会话
reasonix code

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

Une fois connecté, les commandes slash, les invites de confirmation et les réponses de l'IA peuvent toutes passer par QQ sans saisie dans le terminal. Les sessions de chat / code suivantes démarreront automatiquement le canal QQ. Les utilisateurs de la version bureau peuvent le configurer dans Paramètres → Général → Canal QQ.


Guide approfondi de la version bureau

La version bureau ajoute davantage de fonctionnalités de visualisation en plus de l'interface TUI de la CLI.

Disposition de l’interface

La version bureau ajoute trois panneaux principaux en plus de l'interface TUI de la CLI :

PanneauFonction
Panneau de fichiers à droiteAffiche en temps réel la liste des fichiers que l'Agent a lus ou modifiés dans la session en cours ; cliquez pour afficher directement le contenu.
Barre d'état inférieureCorrespond entièrement à la barre supérieure de la CLI—compteur de coût, taux de succès du cache, modèle actuel, consommation de tokens
Onglets multiplesPermet d'ouvrir plusieurs sessions de projet simultanément et de basculer indépendamment entre les onglets

Relation avec la CLI

La version bureau et la CLI partagent la même configuration (~/.reasonix/config.json) et la même clé API.

Les compétences, les mémoires et les configurations MCP enregistrées dans la CLI sont immédiatement disponibles dans la version bureau, et inversement.

Toutes les commandes slash disponibles dans la CLI sont entièrement prises en charge dans la zone de saisie de la version bureau, y compris /plan, /skill, /mcp, /apply, /pro, etc.

Fonctionnalités spécifiques au bureau

CapacitéDescription
Navigation graphique dans l'arborescence des fichiersParcourir visuellement les fichiers du projet dans le panneau de droite
Gestion d'espace de travail multi-ongletsExpérience de commutation entre plusieurs projets plus conviviale
Configuration graphique de QQParamètres → Général → Canal QQ
Runtime Node intégréLes utilisateurs n'ont pas besoin d'installer Node.js séparément

Cas 1 : Exploration d'un nouveau projet et lecture de code

Scénario : Reprendre un dépôt backend TypeScript inconnu, devoir comprendre rapidement l'architecture et trouver les modules clés.

Utiliser le mode chat (ne touche pas aux fichiers, économise des coûts) :

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

Démo du processus de conversation :

你:用 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 行的数据库更新之间存在时间窗口...

Générer la mémoire du projet :

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

AI:[生成 REASONIX.md 草稿]

你:/apply

Cas 2 : Refactorisation multi-fichiers (avec le mode Plan)

Scénario : Migrer la gestion des erreurs de l'API REST existante de throw new Error() vers une classe AppError personnalisée.

Lancer et entrer en mode Plan :

# 启动 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     ← 每批次确认

Une fois l'exécution terminée :

你:/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."

你:确认提交

Cas 3 : Localisation et correction de bogues

Scénario : Une erreur intermittente "Cannot read properties of undefined" apparaît dans l'environnement de production, et les journaux ne contiennent qu'une trace de pile.

Exemples

,
        "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
}

Règles de liste blanche des permissions

Utilise une correspondance exacte de préfixe : autoriser "git " signifie autoriser toutes les commandes commençant par "git " (notez l'espace final). Les commandes ne figurant pas dans la liste blanche nécessitent une confirmation manuelle à chaque fois.


Comparaison avec d'autres outils

Voici une comparaison entre Reasonix et d'autres outils de programmation IA courants :

DimensionReasonixClaude CodeCursorAider
BackendDeepSeek (exclusif)AnthropicOpenAI/AnthropicN'importe quel (OpenRouter)
LicenceMITSource ferméeSource ferméeApache 2
Caractéristiques de coûtFaible coût par tâcheTarification premiumAbonnement + utilisationDépend du modèle
Cache de préfixe DeepSeekSpécialement conçuSans objetSans objetSuccès occasionnel
Tableau de bord Web intégréOui—Dans l'IDE—
Moteur de recherche web configurable/search-engine———
Sessions persistantes par espace de travailOuiPartielleSans objet—
Mode Plan · MCP · Hooks · SkillsTous disponiblesTous disponiblesOuiPartielle

Ressources et communauté

Voici les ressources officielles et les liens communautaires de Reasonix.

Ressources officielles

RessourceLien
GitHubesengine/DeepSeek-Reasonix
Site officielhttps://reasonix.io/
Documentationhttps://reasonix.io/docs/
Autres extensions