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énario | Description |
|---|---|
| Utiliser DeepSeek comme outil principal pour les tâches de codage | Adaptation 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'IA | Contrô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 terminal | Conception 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ériodes | Idé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 pas | Raison |
|---|---|
| Bascule flexible entre plusieurs fournisseurs | DeepSeek uniquement ; c'est un choix de conception, pas une limitation |
| Intégration IDE | Priorité au terminal ; pas de plugins IDE |
| Raisonnement le plus difficile | Claude Opus reste en tête sur les benchmarks ; commencez par Claude pour les preuves de niveau doctorat |
| Hors ligne / entièrement gratuit | Né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 :

| Plateforme | Format de fichier |
|---|---|
| macOS | Reasonix_x.x.x_universal.dmg |
| Windows | Reasonix_x.x.x_x64-setup.exe |
| Linux | Reasonix_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és | code | chat |
|---|---|---|
| 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 + global | Global uniquement |
| Serveurs MCP, recherche web, ask_choice | ✓ | ✓ |
| Portée de session | Isolé par répertoire | Partagé 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 :
| Mode | Comportement |
|---|---|
| revue | Afficher 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énario | Description |
|---|---|
| Modifications importantes | Tâches affectant plus de 5 fichiers |
| Modifications d'architecture | Migration de framework, changement de base de données, refonte d'API |
| Collaboration en équipe | Scénarios où l'approche doit être alignée |
| Périmètre incertain | Lorsque 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.
| Type | Portée | Objectif |
|---|---|---|
| user | Global | Vos préférences, habitudes de travail |
| feedback | Global | Les erreurs ou les expériences réussies de l'IA |
| project | Niveau projet | Conventions du projet, décisions d'architecture |
| référence | Configurable | Documents 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
| Hook | Moment du déclenchement | Capacité spéciale |
|---|---|---|
| PreToolUse | Avant les appels d'outils | Code de sortie non nul = rejeter l'appel |
| PostToolUse | Après les appels d'outils | Journalisation/formatage |
| UserPromptSubmit | Lorsque l'utilisateur envoie un message | Injecter du contexte supplémentaire |
| Arrêter | Lorsque la session se termine | Ré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
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 :
| Panneau | Fonction |
|---|---|
| Panneau de fichiers à droite | Affiche 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érieure | Correspond 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 multiples | Permet 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 fichiers | Parcourir visuellement les fichiers du projet dans le panneau de droite |
| Gestion d'espace de travail multi-onglets | Expérience de commutation entre plusieurs projets plus conviviale |
| Configuration graphique de QQ | Paramè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 :
| Dimension | Reasonix | Claude Code | Cursor | Aider |
|---|---|---|---|---|
| Backend | DeepSeek (exclusif) | Anthropic | OpenAI/Anthropic | N'importe quel (OpenRouter) |
| Licence | MIT | Source fermée | Source fermée | Apache 2 |
| Caractéristiques de coût | Faible coût par tâche | Tarification premium | Abonnement + utilisation | Dépend du modèle |
| Cache de préfixe DeepSeek | Spécialement conçu | Sans objet | Sans objet | Succès occasionnel |
| Tableau de bord Web intégré | Oui | — | Dans l'IDE | — |
| Moteur de recherche web configurable | /search-engine | — | — | — |
| Sessions persistantes par espace de travail | Oui | Partielle | Sans objet | — |
| Mode Plan · MCP · Hooks · Skills | Tous disponibles | Tous disponibles | Oui | Partielle |
Ressources et communauté
Voici les ressources officielles et les liens communautaires de Reasonix.
Ressources officielles
| Ressource | Lien |
|---|---|
| GitHub | esengine/DeepSeek-Reasonix |
| Site officiel | https://reasonix.io/ |
| Documentation | https://reasonix.io/docs/ |