Руководство по началу работы с 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) скачайте установщик для вашей платформы:

| Платформа | Формат файла |
|---|---|
| macOS | Reasonix_x.x.x_universal.dmg |
| Windows | Reasonix_x.x.x_x64-setup.exe |
| Linux | Reasonix_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 предоставляет два режима работы для разных сценариев использования.
| Возможности | code | chat |
|---|---|---|
| Инструменты файловой системы + 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 и другими популярными инструментами ИИ-программирования:
| Измерение | Reasonix | Claude Code | Cursor | Aider |
|---|---|---|---|---|
| Бэкенд | DeepSeek (эксклюзивно) | Anthropic | OpenAI/Anthropic | Любая (OpenRouter) |
| Лицензия | MIT | Закрытый исходный код | Закрытый исходный код | Apache 2 |
| Характеристики стоимости | Низкая стоимость за задачу | Премиальное ценообразование | Подписка + оплата за использование | Зависит от модели |
| Префикс-кэш DeepSeek | Специально разработан | Не применимо | Не применимо | Случайное попадание |
| Встроенная веб-панель | Да | — | В IDE | — |
| Настраиваемый поисковый движок | /search-engine | — | — | — |
| Постоянные сессии для каждого рабочего пространства | Да | Частичная | Не применимо | — |
| Режим планирования · MCP · хуки · навыки | Все доступные | Все доступные | Да | Частичная |
Ресурсы и сообщество
Ниже приведены официальные ресурсы Reasonix и ссылки на сообщество.
Официальные ресурсы
| Ресурс | Ссылка |
|---|---|
| GitHub | esengine/DeepSeek-Reasonix |
| Официальный сайт | https://reasonix.io/ |
| Документация | https://reasonix.io/docs/ |