用途：本指南面向需要修改或理解 MiniMax Code CLI 的开发者，覆盖命令注册、交互式 TUI、headless exec、ACP 协议适配器以及进程内运行时连接。改动前应先阅读 docs/architecture.md 与当前命令注册。
主要能力与结构：独立入口位于 packages/tui。关键路径包括 packages/tui/src/index.ts（进程引导与运行时环境）、cli/main.ts（命令执行与进程生命周期）、cli/program.ts（Commander 命令注册）、cli/contract.ts（交互与 exec 选项契约）、tui/（交互终端界面）、headless/（exec 调用、输出、取消与结算）、acp/（ACP 协议适配）、runtime/adapter.ts（连接到进程内 CliService）、local-runtime-v2 的 local 目录（本地产品服务入口）以及 protocol/src/local.ts（共享 CLI 数据结构）。执行路径为：TUI / exec / ACP -> CliService -> 本地应用 -> 会话/轮次/智能体服务 -> 模型提供者与工具。应保留该进程内边界：共享行为放在相应应用或服务中，展示与传输行为放在各自适配器中。
使用方式：修改命令与标志时，需一并检查 cli/program.ts、cli/contract.ts 与受影响的命令处理器，核对解析、帮助、分发和错误；修改交互行为时，沿 tui/ 下的控制器与渲染路径，检查会话选择、排队输入与中断；修改 exec 时，跟踪从调用到输出与结算的全过程，验证 stdout、stderr、退出码和取消，仅看帮助输出不够；修改 ACP 时，需同时检查协议更新与底层运行时操作；修改共享运行时前，先确认所有受影响的 TUI、exec 与 ACP 消费方。
验证方式：使用 testing-workflow 选择声明的测试。先构建独立产物再查看实际帮助： pnpm build node dist/cli.js --help node dist/cli.js exec --help node dist/cli.js acp --help 记录标志前先阅读当前帮助。行为检查使用临时数据目录与合成输入，参照现有 smoke/BYOK 测试。离线协议测试应与在线提供者验收分开报告。
限制：资料仅提供架构与流程说明，未给出完整命令清单、具体参数默认值、支持平台或版本要求，相关细节暂未提供。