Coding Modes / 编程模式

Synerix has two coding modes to match your workflow.

Synerix 提供两种编码模式，适配你的工作方式。

Plan Mode / 规划模式

Analyze first, then execute with approval. / 先分析，再审批执行。

Plan mode decomposes complex tasks into actionable, prioritized steps. Each step requires your approval before execution — perfect for large features, migrations, or unfamiliar codebases.

规划模式将复杂任务分解为可执行的、有优先级的步骤。每步执行前需要你的审批 —— 适用于大型功能、迁移或不熟悉的代码库。

Feature / 特性	Detail / 详情
Decomposition / 分解	Hierarchical task breakdown with effort estimates / 分层任务分解，含工作量估算
Approval / 审批	Every tool call requires explicit approval / 每个工具调用都需要明确审批
Context / 上下文	Reads project structure before planning / 规划前读取项目结构
Use when / 适用场景	Large features, migrations, refactoring, unknowns / 大型功能、迁移、重构、未知问题

❯ Plan a migration from REST to GraphQL
   1. Schema design (2h)
   2. Query resolver stubs (3h)
   3. Client migration (4h)
   4. Testing strategy (1h)

❯ /mode plan
   ✓ Switched to Plan mode

Vibe Mode / 沉浸模式

Immersive flow state — describe and let it flow. / 沉浸式心流 —— 描述即可。

Vibe mode is designed for rapid prototyping and implementation. Describe what you want, and Synerix handles the rest: generate, compile, test, and fix — automatically iterating until it works. Low-risk operations are auto-approved to keep you in flow.

沉浸模式专为快速原型和实现设计。描述你想要什么，Synerix 处理剩下的事：生成、编译、测试和修复 —— 自动迭代直到成功。低风险操作自动批准，保持心流。

Feature / 特性	Detail / 详情
Auto-iterate / 自动迭代	generate → compile → test → fix loop / 生成 → 编译 → 测试 → 修复 循环
Auto-approve / 自动批准	Safe file edits and builds pass instantly / 安全文件编辑和构建立即通过
Error feedback / 错误反馈	Compilation errors automatically fed back to AI / 编译错误自动反馈给 AI
Use when / 适用场景	Implementing features, prototyping, refactoring / 实现功能、原型开发、重构

❯ Add pagination to the API endpoint
   ✓ Generated pagination module
   ✓ Compiled successfully
   ✓ Tests pass
   ✓ Done in 1.8s

❯ /mode vibe
   ✓ Switched to Vibe mode — auto-iterate enabled

Switching Modes / 切换模式

Command / 命令	Mode / 模式
/mode plan	Plan / 规划
/mode vibe	Vibe / 沉浸

Press Tab to cycle through modes without typing.

按 Tab 键循环切换模式，无需输入。

Mode Comparison / 模式对比

Aspect / 方面	Plan / 规划	Vibe / 沉浸
Speed / 速度	Deliberate / 深思熟虑	Fast / 快速
Approval / 审批	Required / 需要	Auto for safe ops / 安全操作自动
Best for / 最佳场景	Complex tasks / 复杂任务	Rapid prototyping / 快速原型
Risk tolerance / 风险容忍	Low / 低	Medium / 中

Next Steps / 下一步

• Configuration — Fine-tune mode behavior / 微调模式行为
• Troubleshooting — Common issues / 常见问题