Руководство по началу работы с Reasonix

Reasonix — это открытый терминальный ИИ-агент для программирования, глубоко оптимизированный для DeepSeek. Весь его рабочий цикл спроектирован с нуля вокруг механизма префиксного кэша DeepSeek, чтобы программирование с ИИ было достаточно дешёвым для бесконечной работы.

Философия дизайна Reasonix:«Агент для программирования, который остаётся достаточно дешёвым, чтобы его не выключать».(ИИ-агент для программирования, достаточно дешёвый, чтобы работать бесконечно долго).

Для кого это?

СценарийОписание
Использование DeepSeek в качестве основного инструмента для задач программированияГлубокая адаптация к DeepSeek API, с частотой попаданий в кэш, значительно превышающей универсальные инструменты
Вас беспокоят затраты на использование ИИТочный контроль затрат: лимиты бюджета и статистика затрат в реальном времени
Предпочитаете терминальные рабочие процессыДизайн с приоритетом терминала: диффы живут в git diff, деревья файлов — в ls
Непрерывный запуск агентов в течение длительного времениИдеально для анализа больших кодовых баз, пакетного рефакторинга и подобных сценариев

Что Reasonix не делает

У Reasonix есть свои принципы; вот что он намеренно не делает:

Что он не делаетПричина
Гибкое переключение между несколькими провайдерамиТолько DeepSeek; это сделано намеренно, а не является ограничением
Интеграция с IDEОриентирован на терминал; не разрабатывает плагины для IDE
Сложнейшие бенчмарки рассужденийClaude Opus по-прежнему лидирует в некоторых бенчмарках; для задач доказательства уровня PhD начинайте с Claude
Офлайн / полностью бесплатноТребуется платный API-ключ DeepSeek; для офлайн-решений см. Aider + Ollama

Прежде чем использовать Reasonix, необходимо получить API-ключ DeepSeek. Посетитеplatform.deepseek.com/api_keys, войдите или зарегистрируйте аккаунт.

НажмитеCreate API key, задайте имя (например, reasonix), скопируйте и сохраните его.

При первом запускеreasonixвам будет предложено вставить API-ключ. После его ввода он сохраняется автоматически, и вам не придётся вводить его снова.


Установка: CLI и Desktop

Reasonix предлагает два способа установки: CLI и Desktop. Они описаны отдельно ниже.

Установка CLI

Системные требования: Node.js ≥ 22, поддерживает macOS, Linux, Windows (PowerShell, Git Bash, Windows Terminal).

Глобальная установка (рекомендуется для повседневного использования):

npm install -g reasonix

Работа без установки (npx, всегда используется последняя версия):

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

Проверка и диагностика: просмотр номера версии:

reasonix --version

Проверка работоспособности: версия Node, доступность API-ключа, конфигурация MCP:

reasonix doctor

Обновление до последней версии:

reasonix update

Завершите настройку с помощью интерактивного мастера для инициализации API-ключа, языка, темы и других параметров.

reasonix setup

Выберите язык:

Выберите тему:

Введите API-ключ DeepSeek:

Нажмите Enter, чтобы сохранить:

Затем войдите в проект vibe-coding-example, и вы можете начать его использовать:

cd vibe-coding-example

Введите следующую команду для запуска:

reasonix

Введите/для просмотра поддерживаемых команд:

Установка настольной версии

Настольная версия — это нативный клиент на основе Tauri с несколькими вкладками; на правой панели отображаются файлы, которые Agent прочитал или изменил в текущем сеансе.

В нижней части отображаются те же счётчики стоимости/кэша/токенов, что и в верхней панели CLI. Используется тот же ключ DeepSeek API и конфигурация ~/.reasonix.

В настольной версии есть встроенная среда выполнения Node; отдельная установка npm не требуется.

С официального сайта (https://reasonix.io/#start) скачайте установщик для вашей платформы:

ПлатформаФормат файла
macOSReasonix_x.x.x_universal.dmg
WindowsReasonix_x.x.x_x64-setup.exe
LinuxReasonix_x.x.x_amd64.AppImage или .deb

После скачивания дважды щёлкните, чтобы установить, затем введите ваш API-ключ:

После запуска в десктопной версии также используется классическая компоновка слева-справа:

Введите сообщение в поле ввода, чтобы начать чат:

Нажмите значок в правом верхнем углу, чтобы открыть трёхколоночную компоновку:

Три режима совместной работы:

Общие настройки, включая тему, внешний вид, язык, плагины, MCP и т. д.:

Примечания при первом запуске:

Gatekeeper в macOS заблокирует первый запуск. Чтобы обойти один раз: выполните xattr -dr com.apple.quarantine /Applications/Reasonix.app в терминале или щёлкните правой кнопкой мыши → Открыть → Подтвердить.

Windows: SmartScreen показывает "Неизвестный издатель"; нажмите "Подробнее → Выполнить в любом случае". Linux: .deb и .AppImage запускаются напрямую, дополнительные шаги не требуются.

Десктопная версия сейчас находится в статусе Prerelease; цикл и протокол точно такие же, как в CLI, но UI всё ещё дорабатывается, а установщик пока не подписан кодом. CLI — основной интерфейс разработки; любую функцию, доступную в CLI, можно использовать в поле ввода десктопной версии.


Первый запуск

Перейдите в каталог проекта и запустите режим программирования Reasonix.

cd your-project

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

Попробуйте отправить первое сообщение:

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

Reasonix вызовет такие инструменты, как list_directory и read_file, чтобы просканировать проект и вывести структурированный анализ.

Headless-запуск (совместим с pipe)

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

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

Два режима: code и chat

Reasonix предоставляет два режима работы для разных сценариев использования.

Возможностиcodechat
Инструменты файловой системы + edit_file✓—
SEARCH/REPLACE → /apply review✓—
Инструмент Shell (управляется разрешениями)✓—
Режим планирования, /todo, /skill new, /mcp add✓—
Память (remember / recall_memory)На уровне проекта + глобальноТолько глобально
MCP-серверы, веб-поиск, ask_choice✓✓
Область сеансаИзоляция по директорииОбщий по умолчанию

code — это режим по умолчанию и единственный режим с инструментами файловой системы и оболочки — начните здесь.

chat — это более лёгкий режим без доступа к диску — используйте его, когда вам нужен партнёр для размышлений, но вы не хотите, чтобы ИИ трогал файлы, или при подключении MCP для поиска информации.

Системный промпт режима chat короче, с меньшими затратами токенов.

Reasonix ограничивает инструменты файловой системы стартовым каталогом, который можно переназначить с помощью --dir. Переключение каталогов на лету не поддерживается (пути памяти перепутаются со старым корневым путём) — выйдите и перезапустите.

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

Ограничение правок: поток предварительного просмотра SEARCH/REPLACE

Это самый важный механизм безопасности Reasonix — ИИ никогда не изменяет файлы без вашего ведома.

Три режима ограничения правок

Переключение через /mode или Shift+Tab:

ModeПоведение
ревьюПоказывать предварительный просмотр для каждой правки, подтверждение y/n для каждого фрагмента
auto(AUTO)Применяется автоматически, но нажмите u в течение 5 секунд, чтобы отменить
yoloЗапись напрямую на диск без подтверждения

Типичный процесс редактирования (режим проверки)

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

История редактирования

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

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

# 回滚最近一次 /apply
/undo

Режим планирования: шлюз анализа только для чтения

Режим планирования переводит Reasonix в состояние только для чтения — ИИ может только читать файлы, анализировать код и предлагать планы; он не может записывать файлы или выполнять команды, пока вы явно не одобрите план.

Включение и рабочий процесс

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

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

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

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

Когда использовать режим планирования

СценарийОписание
Крупные измененияЗадачи, затрагивающие более 5 файлов
Изменения архитектурыМиграция фреймворка, переключение базы данных, переработка API
Командная работаСценарии, в которых нужно согласовать подход
Неопределённый охватКогда нужно предварительно посмотреть, какие места затронет ИИ

Модели и контроль затрат

Reasonix предоставляет гибкие механизмы переключения моделей и контроля затрат.

Переключение пресетов

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

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

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

Переключение в рамках сессии:

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

/pro: однократное повышение

Пользователь вводит /pro, следующий ход использует v4-pro, затем автоматически отключается. Никаких переключений пресетов и никакого забывания вернуться обратно.

Активный статус отображается жёлтым индикатором «pro активирован» в верхней панели.

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

Автоматическое повышение при сбое

Видимые в каждом ходе события «flash не справляется с задачей»: ошибки SEARCH-not-found в edit_file/write_file и срабатывания ToolCallRepair.

Как только счётчик достигает 3, оставшаяся часть текущего хода автоматически переключается на v4-pro, о чём сообщает жёлтая предупреждающая строка — никаких скрытых затрат.

Установка лимита бюджета сессии

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

Предупреждать при 80%, отказывать в следующем ходе при 100%.

Сжатие контекста и запрос стоимости

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

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

Навыки: многоразовые Markdown-плейбуки

Навыки — это Markdown-плейбуки, которые ИИ может вызывать по требованию, без удалённого реестра — напишите их напрямую, и они вступят в силу немедленно.

Создание навыков

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

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

Формат файла навыка

Путь к файлу: .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 выполняет навык в изолированном цикле суб-агента, поэтому контекст основной сессии не раздувается.

Вызов и управление

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

Навыки, совместимые с форматом Claude

<project>/.claude/skills/<name>/SKILL.md и ~/.claude/skills/ также читаются автоматически.

Они сосуществуют с нативными путями Reasonix, поэтому инструменты, выводящие навыки в формате Claude, можно использовать напрямую.

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

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

Память: сохранение контекста между сессиями

Reasonix имеет четыре типа памяти для сохранения контекста между сессиями.

TypeОбласть действияНазначение
userГлобальныйВаши предпочтения, рабочие привычки
feedbackГлобальныйОшибки ИИ или успешный опыт
projectУровень проектаСоглашения проекта, архитектурные решения
справочная информацияНастраиваемыйФиксированные справочные материалы

Ручная запись

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

Управление памятью

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

Файл памяти проекта (REASONIX.md)

Создайте REASONIX.md в корне проекта; он автоматически загружается в начале каждой сессии.

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

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

Или создайте вручную:

# 项目:example-backend

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

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

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

Интеграция с MCP: подключение внешних инструментов

Серверы MCP поддерживают три транспорта: stdio, SSE и Streamable HTTP.

Один и тот же формат конфигурации применяется как к config.json, так и к аргументу командной строки --mcp.

Динамическое добавление в сеансе

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

Монтирование из командной строки

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

Предустановки в файле конфигурации (рекомендуется)

Путь к файлу: ~/.reasonix/config.json

Примеры

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

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

Хуки: Автоматизация жизненного цикла

Хуки поддерживают четыре события жизненного цикла; PreToolUse может блокировать вызовы инструментов при ненулевом коде выхода.

Поддерживаемые события

ХукМомент срабатыванияСпециальная возможность
PreToolUseПеред вызовами инструментовНенулевой код выхода = отклонить вызов
PostToolUseПосле вызовов инструментовЛогирование/форматирование
UserPromptSubmitКогда пользователь отправляет сообщениеВнедрить дополнительный контекст
ОстановитьПри завершении сессииСводка/очистка

Пример конфигурации

Путь к файлу: ~/.reasonix/config.json

Примеры

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": { "tool": "edit_file" },
        "command": "npx biome format --write {{file}} 2>/dev/null || true",
        "description": "Автоформатирование после редактирования файлов"
      }
    ],
    "PreToolUse": [
      {
        "matcher": { "tool": "run_command" },
        "command": "echo '$(date): {{command}}' >> ~/.reasonix/audit.log",
        "description": "Записывать все команды Shell в журнал аудита"
      }
    ],
    "Стоп": [
      {
        "команда": "reasonix stats --session last >> ~/.reasonix/sessions-log.txt",
        "описание": "Сохранить статистику после завершения сессии"
      }
    ]
  }
}

Просмотр и перезагрузка

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

Управление сессиями и контрольная точка

Reasonix предоставляет полное управление сессиями и возможности создания снимков файлов.

Управление сессиями

Примеры

# Список всех сессий
reasonix sessions

# Открыть указанную сессию
reasonix sessions my-project

# Удалить сессии старше 30 дней
reasonix prune-sessions --days 30

Команды внутри сессии:

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

Контрольная точка (снимок файлов)

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

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

Воспроизведение сессии (для отладки)

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

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

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

Семантическая индексация и веб-поиск

Reasonix поддерживает создание локального векторного индекса для проектов и настройку поисковой системы в интернете.

Семантическая индексация

Создайте локальный векторный индекс для проекта, поддерживающий семантический поиск без необходимости точного совпадения ключевых слов.

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

Конфигурация (~/.reasonix/config.json):

Примеры

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

После создания используйте его в сессии:

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

Веб-поиск

Mojeek используется по умолчанию; переключение через /search-engine (или /se).

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

Настройте самостоятельно размещённый SearXNG:

Примеры

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

Удалённое управление каналом QQ

Reasonix может использовать QQ как удалённый канал связи для существующих сеансов чата и кода; это не отдельный режим работы.

Сначала запустите сеанс, затем подключитесь к QQ.

# 1. 先启动会话
reasonix code

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

После подключения слэш-команды, запросы подтверждения и ответы ИИ могут проходить через QQ без ввода в терминале. Последующие сеансы чата / кода будут автоматически запускать канал QQ. Пользователи десктопной версии могут настроить это в Настройках → Общие → Канал QQ.


Углублённое руководство по десктопной версии

Десктопная версия добавляет больше функций визуализации поверх CLI TUI.

Макет интерфейса

Десктопная версия добавляет три основные панели поверх CLI TUI:

ПанельФункция
Панель файлов справаОтображает в реальном времени список файлов, которые Агент прочитал или изменил в текущем сеансе; нажмите, чтобы просмотреть содержимое напрямую.
Нижняя строка состоянияПолностью соответствует верхней панели CLI — счётчик затрат, частота попаданий в кэш, текущая модель, расход токенов
Несколько вкладокМожно одновременно открывать несколько сеансов проекта и независимо переключаться между вкладками

Связь с CLI

Десктопная версия и CLI используют одну и ту же конфигурацию (~/.reasonix/config.json) и API-ключ.

Навыки, воспоминания и конфигурации MCP, сохранённые в CLI, сразу доступны в десктопной версии, и наоборот.

Все slash-команды, доступные в CLI, полностью поддерживаются в поле ввода десктопной версии, включая /plan, /skill, /mcp, /apply, /pro и т. д.

Возможности десктопной версии

СпособностьОписание
Просмотр дерева файлов в графическом видеВизуальный просмотр файлов проекта на правой панели
Управление рабочим пространством с несколькими вкладкамиБолее удобный опыт переключения между несколькими проектами
Графическая настройка QQНастройки → Общие → Канал QQ
Встроенная среда выполнения NodeПользователям не нужно отдельно устанавливать Node.js

Сценарий 1: Изучение нового проекта и чтение кода

Сценарий: вам нужно принять незнакомый репозиторий бэкенда на TypeScript, быстро разобраться в архитектуре и найти ключевые модули.

Используйте режим чата (не трогает файлы, экономит затраты):

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

Демонстрация процесса диалога:

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

Сгенерировать память проекта:

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

AI:[生成 REASONIX.md 草稿]

你:/apply

Сценарий 2: Многофайловый рефакторинг (с режимом планирования)

Сценарий: перенести обработку ошибок существующего REST API с throw new Error() на пользовательский класс AppError.

Запустите и войдите в режим планирования:

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

После завершения выполнения:

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

你:确认提交

Случай 3: локализация и исправление багов

Сценарий: в производственной среде периодически появляется ошибка "Cannot read properties of undefined", а логи содержат только трассировку стека.

Примеры

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

Правила белого списка разрешений

Использует точное сопоставление префикса: разрешение "git " означает разрешение всех команд, начинающихся с "git " (обратите внимание на завершающий пробел). Команды, отсутствующие в белом списке, требуют ручного подтверждения каждый раз.


Сравнение с другими инструментами

Ниже приведено сравнение между Reasonix и другими популярными инструментами ИИ-программирования:

ИзмерениеReasonixClaude CodeCursorAider
БэкендDeepSeek (эксклюзивно)AnthropicOpenAI/AnthropicЛюбая (OpenRouter)
ЛицензияMITЗакрытый исходный кодЗакрытый исходный кодApache 2
Характеристики стоимостиНизкая стоимость за задачуПремиальное ценообразованиеПодписка + оплата за использованиеЗависит от модели
Префикс-кэш DeepSeekСпециально разработанНе применимоНе применимоСлучайное попадание
Встроенная веб-панельДа—В IDE—
Настраиваемый поисковый движок/search-engine———
Постоянные сессии для каждого рабочего пространстваДаЧастичнаяНе применимо—
Режим планирования · MCP · хуки · навыкиВсе доступныеВсе доступныеДаЧастичная

Ресурсы и сообщество

Ниже приведены официальные ресурсы Reasonix и ссылки на сообщество.

Официальные ресурсы

РесурсСсылка
GitHubesengine/DeepSeek-Reasonix
Официальный сайтhttps://reasonix.io/
Документацияhttps://reasonix.io/docs/
Другие расширения