MaxCode（MiniMax Agent）

基于 MiniMax 模型、面向中国开发者、具备高阶自主性与持续学习能力的终端 AI 编程助手。

产品定位

三层递进价值：

编程助手（基础） — 15 个核心工具（文件读写、Shell、搜索、Web、项目模板）+ 17 个斜杠命令 + microCompact 两段式上下文压缩
自主 Agent（进阶） — 四级授权 + LLM 风险评估 + 定时任务 + 事件驱动唤醒（EventTrigger）+ 子代理 + 内置技能 + 内置插件
持续进化（差异化） — 三层记忆（含 FTS5 全文搜索）+ LLM 反思引擎 + 每日自动复盘 + 多偏好学习 + 可切换输出风格
UX 可定制（V2.0 新增） — 键绑定可覆盖（keybindings.json，27+ 默认 action）+ /init 一键脚手架 Python/Node/TS 项目

与 Claude Code 的对比

MaxCode 大量借鉴 Claude Code 的 Tool-as-constraint 哲学、三级权限制、AsyncGenerator 主循环、JSONL 会话历史等成熟范式，但在以下维度做了"面向中国开发者 + 长程自主性"的差异化升级。

能力矩阵

维度	Claude Code	MaxCode
模型后端	Anthropic Claude（闭源 SaaS）	MiniMax M2.7（默认）+ OpenAI 兼容层，可换 Ollama
语言优先级	英文	全中文（UI / 工具 description / prompt / 错误提示，CI 有自动审计锁防回归）
搜索引擎	Google / 内置	秘塔搜索（Metaso），中文语料优化
安装方式	npm	预编译 Binary（4 平台 curl 一行安装 + npm 双通路）
记忆系统	会话级 + 可选 Hook	三层架构：WorkingMemory → SessionMemory → PersistentMemory (SQLite + FTS5 + 中文 trigram + BM25 加权)
反思机制	无（需用户手动拼 Hook）	LLM 反思引擎：任务后自动反思 · `/feedback` 深度反思 · 每日 cron 自动复盘
授权模型	三级静态（allow / ask / deny）	四级 + LLM 动态风险评估（按工具分类，危险命令自动升级）
调度能力	无	WakeupScheduler：cron + 任务持久化 + 事件驱动（EventTrigger） + 条件驱动（ConditionTrigger DSL）
上下文压缩	LLM 全量摘要一档	两段式：microCompact（60%，零 LLM）→ autoCompact（93%，LLM）
Hook 类型	command 类（执行 shell 脚本）	command + prompt 类（LLM 守门人） + agent 类（子代理验证）
插件 builtin	分散在不同模块	统一视图 `/plugins` + `config.plugins.disabled` 禁用清单
输出风格	提示词固化	`/output-style` 可切换（default / concise / tutorial + 用户自定义 Markdown）
开源协议	闭源商业 CLI	MIT 开源，可自托管 + 二次开发

触发机制对比

两者共有：

用户显式消息 / 工具调用 / 子代理 / 技能触发 /<skill> / Hook（Pre / PostToolUse）

MaxCode 独有：

触发类型	说明	对应 WP
📡 事件驱动	`file_write` / `file_edit` 成功 → 自动投递 `file.changed` 事件 → `EventTrigger` 订阅 → 任务唤醒；支持 `/fire-event` 手动投递	V1.2-1
⏰ Cron 调度	标准 cron 表达式（wildcard/step/range/list）+ 任务持久化（进程重启后自动恢复）	M4
🧠 LLM 守门人	Hook `{ type: 'prompt' }` 让 LLM 在 PreToolUse 评估工具调用意图，三档 fallback：passthrough / deny / ask	V1.2-4
🔄 每日自动复盘	默认 23:00 cron 触发 `ReflectionEngine.generateDailyReview()`，写入 PersistentMemory	M4
💬 深度反思	`/feedback` → `analyzeFeedbackWithLLM` → 多维偏好识别（速度 / 详细度 / 风格）→ 写入偏好记忆	M4 / M5-2c
📊 条件轮询	`ConditionTrigger` 白名单 DSL（`hour==9 && weekday<=5`），无需事件也能周期性评估触发	V1.1 L2

核心价值与亮点功能

🎯 核心价值

🇨🇳 中文原生 — UI / 工具 / prompt / 错误全中文，CI 有 CJK 正则锁防回归；秘塔搜索 + MiniMax 免翻墙
🛡️ 安全默认 + 可控自主 — features.autonomy: false 默认关闭；启用后四级授权 + LLM 风险评估，危险命令（rm -rf / git push --force）自动拦截；LLM 不可用时 fail-closed
🧠 会学习的 Agent — 每轮任务自动反思；用户反馈深度学习偏好；三层记忆 + FTS5 预取；越用越懂你
⚡ 生产级稳定性 — 1277 测试 / 0 失败；TypeScript strict 零错误；LLM / 启发式双轨回退 — 所有 LLM 模块失败自动降级，基础功能永不阻塞
🔌 开放可扩展 — 插件 / 技能 / 输出风格 / Hook 全部用 Markdown + JSON 描述，无需改源码

架构总览

flowchart TB
    User([👤 用户输入]) --> TUI[React + Ink TUI]
    TUI --> TurnLoop[TurnLoop<br/>AsyncGenerator 主循环]
    TurnLoop --> OutputStyle[OutputStyleRegistry<br/>注入系统提示词]
    TurnLoop --> Compact[两段式压缩<br/>microCompact → autoCompact]
    TurnLoop --> ModelProvider[ModelProvider<br/>MiniMax · OpenAI 兼容]
    ModelProvider --> ToolDispatcher
    ToolDispatcher[ToolDispatcher<br/>工具调度] --> Hooks[HookEngine<br/>command · prompt · agent]
    ToolDispatcher --> Autonomy[AutonomyController<br/>四级授权 + LLM 风险评估]
    ToolDispatcher --> Tools[15 核心工具]
    Tools --> EventBus[fireEvent<br/>file.changed]
    EventBus --> Scheduler[WakeupScheduler<br/>cron / event / condition]
    Scheduler --> Reflection[ReflectionEngine<br/>任务反思 · 每日复盘]
    Reflection --> Memory[(三层记忆<br/>Working · Session · Persistent)]
    Memory --> TurnLoop
    Plugins[Builtin Plugins<br/>bundled-skills<br/>output-styles<br/>metaso-search<br/>reflection] -.-> TurnLoop

三层记忆系统

flowchart LR
    WM[WorkingMemory<br/>Map 内存 · 当前会话] -->|超阈值溢出| SM[SessionMemory<br/>JSONL 持久化]
    SM -->|任务完成 + LLM 反思| PM[(PersistentMemory<br/>SQLite + FTS5<br/>trigram + BM25)]
    PM -->|下次任务启动<br/>Relevant Memory 预取| WM

自主性反馈闭环

flowchart TB
    Task[🎯 用户任务] --> Execute[工具执行]
    Execute -->|成功| AutoReflect[ReflectionEngine<br/>extractLessonsWithLLM]
    AutoReflect --> Lessons[(经验 →<br/>PersistentMemory)]
    Task -.->|用户 /feedback| Deep[analyzeFeedbackWithLLM<br/>多偏好识别]
    Deep --> Prefs[(偏好 →<br/>PersistentMemory)]
    DailyCron[⏰ 每日 23:00<br/>auto-wakeup] -.-> Review[自动复盘报告]
    Review --> Lessons
    Lessons & Prefs -->|预取| NextTask[🎯 下次任务]

四级授权 + LLM 风险评估

flowchart LR
    Tool[🔧 工具调用] --> L{autonomyLevel<br/>配置}
    L -->|Level 0<br/>严格| Ask[❓ 用户确认]
    L -->|Level 1/2<br/>评估| RiskLLM{assessRiskWithLLM<br/>LLM 动态评估}
    L -->|Level 3<br/>完全自主| Auto[✅ 自主执行]
    RiskLLM -->|高风险<br/>rm -rf · push --force| Ask
    RiskLLM -->|低风险<br/>读文件 · 搜索| Auto
    RiskLLM -->|LLM 失败| FailClosed[🛡️ fail-closed<br/>破坏性操作强制用户确认]

两段式上下文压缩

flowchart LR
    TurnEnd[turn_stop 前] --> Check60{>60%<br/>上下文窗口?}
    Check60 -->|否| Continue[↻ 继续下轮]
    Check60 -->|是| Micro[microCompact<br/>占位符替换旧 tool_result<br/>🚀 零 LLM · pairing 100%]
    Micro --> Check93{>93%<br/>上下文窗口?}
    Check93 -->|否| Continue
    Check93 -->|是| Auto[autoCompact<br/>LLM 全量摘要]
    Auto --> Continue

内置插件统一管理（V1.2-7）

flowchart TB
    Config[config.plugins.disabled<br/>用户禁用清单] --> Registry
    Registry[BuiltinPluginRegistry<br/>4 内置插件声明]
    Registry --> PM[PluginManager]
    ExternalDir[~/.maxcode/plugins/<br/>外部插件目录] --> PM
    PM --> Builtin[🔹 builtin 插件<br/>bundled-skills ✅<br/>output-styles ✅<br/>metaso-search ✅<br/>reflection ✅]
    PM --> External[🔸 外部插件<br/>同名时覆盖 builtin]
    Builtin --> Command[/plugins 命令]
    External --> Command
    Builtin -.->|bundled-skills 禁用| SkillSys[SkillSystem.reload<br/>跳过 bundled 目录]

快速开始

方式一：下载预编译 Binary（推荐）

无需安装 Bun，下载即用。每次发布 GitHub Release 时自动构建。

# macOS（Apple Silicon / M 系列）
curl -L https://github.com/MaxHou-infinity/maxcode/releases/latest/download/maxcode-darwin-arm64 -o maxcode
chmod +x maxcode && sudo mv maxcode /usr/local/bin/

# macOS（Intel）
curl -L https://github.com/MaxHou-infinity/maxcode/releases/latest/download/maxcode-darwin-x64 -o maxcode
chmod +x maxcode && sudo mv maxcode /usr/local/bin/

# Linux（x64）
curl -L https://github.com/MaxHou-infinity/maxcode/releases/latest/download/maxcode-linux-x64 -o maxcode
chmod +x maxcode && sudo mv maxcode /usr/local/bin/

# Windows（x64）
# 从 Releases 页面下载 maxcode-windows-x64.exe
# https://github.com/MaxHou-infinity/maxcode/releases/latest

安装后设置 API Key 并启动：

export MINIMAX_API_KEY=your_api_key   # 从 https://www.minimaxi.com 获取
maxcode                                # 交互模式
maxcode --print "帮我写一个 Hello World"  # 单次查询

方式二：从源码运行（需要 Bun ≥ 1.0.0）

# 1. 克隆仓库
git clone https://github.com/MaxHou-infinity/maxcode.git
cd maxcode

# 2. 安装依赖
bun install

# 3. 设置 API Key
export MINIMAX_API_KEY=your_api_key

# 4. 启动
bun run start

# 全局化（可选）
bun link
maxcode --help
maxcode --verbose   # 调试模式（查看 LLM 调用日志）

技术栈

维度	选型
运行时	Bun ≥ 1.0.0（原生 TypeScript，无需预编译）
语言	TypeScript（strict 模式）
TUI	React + Ink 5
模型	MiniMax M2.7（默认）· 支持 OpenAI 兼容层
验证	Zod v3
存储	SQLite（`bun:sqlite`）
测试	`bun:test` 单栈（1277 用例，V1.2 A3 完成 vitest 迁移）

斜杠命令（17 个）

命令	用途
`/help`	显示所有可用命令
`/plan [任务描述]`	手动触发任务规划并等待确认
`/feedback <反馈>`	提交对上一轮任务的反馈，触发 LLM 深度反思（多偏好识别）
`/review`	查看工具使用统计和复盘报告
`/tasks`	列出活跃的定时任务（含每日复盘）
`/skills`	列出已加载的技能（含 3 个内置 bundled 技能）
`/agents`	列出活跃子代理
`/plugins` ★V1.2	分组展示内置 + 外部插件清单（启用状态 / 能力说明）
`/output-style [list\|<name>]` ★V1.2	切换终端输出风格（default / concise / tutorial）
`/fire-event <name> [json-payload]` ★V1.2	手动投递命名事件，触发 EventTrigger
`/memory [list\|search <query>]`	查看或搜索记忆
`/save-memory <key> <content>`	手动保存工作记忆
`/memories`	列出持久化记忆
`/config [key] [value]`	显示或修改配置
`/compact`	手动触发上下文压缩
`/clear`	清空当前对话历史
`/exit` / `/quit`	退出

配置

配置文件路径（按优先级）：

环境变量 MINIMAX_API_KEY（仅 Key）
项目级 ./maxcode.config.json（可选）
全局 ~/.maxcode/config.json（推荐）

完整配置示例

{
  "model": {
    "provider": "minimax",
    "apiKey": "sk-...",
    "model": "minimax-m2.7",
    "maxTokens": 8192,
    "temperature": 0.3,
    "toolChoice": "auto"
  },
  "features": {
    "autonomy": false,
    "memory": true,
    "reflection": true
  },
  "reflection": {
    "dailyReviewCron": "0 23 * * *"
  }
}

启用自主模式（四级授权）

默认 features.autonomy: false 保障安全。启用后 LLM 自动评估风险升降级授权：

{ "features": { "autonomy": true } }

启用效果：

读文件/搜索等低风险操作直接自主执行
rm -rf / git push --force 等高风险操作被 LLM 拦截并要求确认
LLM 不可用时，破坏性操作 fail-closed（强制升级为用户确认）

自定义每日复盘时间

默认每日 23:00 触发复盘。修改 reflection.dailyReviewCron（标准 cron 表达式）：

{ "reflection": { "dailyReviewCron": "0 9 * * *" } }

技能扩展

内置技能（V1.2-5 起开箱即用）：commit（原子化中文 commit）/ code-review（结构化代码审查）/ explain（代码讲解）
自定义技能：在 ~/.maxcode/skills/ 或 .maxcode/skills/ 放置 Markdown 文件（Claude Code 兼容 frontmatter 格式），重启后通过 /skills 查看
覆盖优先级：user > project > bundled（同名技能被高优先级覆盖）
环境变量：MAXCODE_BUNDLED_SKILLS_DIR 可覆盖内置技能目录（测试/打包场景）

输出风格（V1.2-6）

切换终端输出风格以适配不同场景：

/output-style list       # 列出所有可用风格（标注当前风格）
/output-style concise    # 切换到简洁模式（≤3 句、去寒暄、无总结句）
/output-style tutorial   # 切换到教学模式（解释原理、附专有名词定义）
/output-style default    # 恢复默认（保持 MaxCode 原生行为）

自定义风格：在 .maxcode/output-styles/<name>.md（项目级）或 ~/.maxcode/output-styles/<name>.md（用户级）放置带 YAML frontmatter 的 Markdown 文件：

---
name: mystyle
description: 我的自定义风格
---

只用一句话回答，不要表情符号。

内置插件管理（V1.2-7）

MaxCode 将分散的 builtin 能力聚合为可禁用的"内置插件"视图：

/plugins   # 分组展示 builtin（bundled-skills / output-styles / metaso-search / reflection）+ external 插件

禁用某内置插件，在配置中加入：

{ "plugins": { "disabled": ["bundled-skills"] } }

V1.2-7 实装范围：目前仅 bundled-skills 接入了运行时禁用门禁（禁用后 SkillSystem 不加载 bundled 目录）；其他 3 个仅声明式展示，后续迭代按需实装。

事件驱动唤醒（V1.2-1）

file_write / file_edit 工具执行成功后自动投递 file.changed 事件，载荷为 { toolName, path }。可通过 EventTrigger 订阅并触发自定义任务。手动投递事件：

/fire-event file.changed {"path":"/tmp/test.txt"}
/fire-event my.custom.event                           # 无载荷

上下文压缩（V1.2-3 两段式）

microCompact（60% 阈值，零 LLM）：将白名单工具（file_read/file_edit/file_write/grep/glob/bash/web_search/web_fetch）的旧 tool_result 替换为占位符，保留最近 5 个结果；tool_use block 完全不动，pairing 100% 保持
autoCompact（~93% 阈值，LLM 全量摘要）：microCompact 仍不足时兜底

主要功能概览

① 编程助手层（基础工具）

工具	说明
file_read / write / edit	文件读写编辑（Read-before-Edit 约束）
glob / grep	文件搜索 + 内容全文检索
bash	Shell 执行 + 危险命令检测（30+ 只读命令白名单）
web_search / fetch	秘塔（Metaso）搜索 + 网页抓取
task	6 件套：create / update / get / list / output / stop
todo_write	全量替换语义的待办管理

② 自主 Agent 层

功能	实现
四级授权	Level 0-3 按操作类型（file / git / system / web / destructive / scheduled）分别配置
LLM 风险评估	`assessRiskWithLLM()` 动态决定是否升级授权
PlanningEngine	ComplexityEstimator + ExperienceRetriever + RiskAssessor
CronTrigger	标准 cron 表达式解析（wildcard / step / range / list）
WakeupScheduler	任务持久化（进程重启保留）+ 按授权级别执行
子代理	AgentTool 并行任务 + SendMessageTool 消息传递
技能系统	`~/.maxcode/skills/*.md`，Claude Code 兼容
插件系统	`~/.maxcode/plugins/`，`plugin.json` + 动态 `import()`

③ 持续进化层

功能	实现
三层记忆	WorkingMemory（Map）→ SessionMemory（JSON）→ PersistentMemory（SQLite）
Relevant Memory 预取	关键词提取 + 并行搜索 + 上下文注入
LLM 反思引擎	任务后自动反思（`extractLessonsWithLLM`）+ 启发式回退
深度反思	`/feedback` 触发 `analyzeFeedbackWithLLM`，识别多偏好维度（速度/详细度）
每日复盘	WakeupScheduler + cron，默认 23:00，可自定义
自主复盘报告	`/review` 显示工具使用统计 + 优化建议

架构亮点

structuredCall helper（src/utils/structuredCall.ts）：统一 "LLM → 结构化 JSON" 调用链路（流式收集 → JSON 抽取 → Zod 校验 → 4 种分类失败原因 empty/parse_failed/schema_failed/llm_error）
LLM / 启发式双轨回退：所有 LLM 模块（PlanningEngine / ReflectionEngine / AutonomyController）失败时自动回退到启发式，保证基础功能永不阻塞
模型提供者抽象：ModelProvider 接口 + MiniMax 适配器 + OpenAI 兼容层
事件驱动 UI：AsyncGenerator<TurnEvent> + Ink 流式渲染 + 50ms debounce
模块依赖向下：ui → core → model / memory / security → utils / types

项目结构

maxcode/
├── src/
│   ├── index.ts              # CLI 入口
│   ├── core/                 # 核心引擎
│   │   ├── turnLoop.ts       # AsyncGenerator 主循环
│   │   ├── autonomyController.ts   # 四级授权 + LLM 风险评估
│   │   ├── autonomyLLM.ts    # LLM 风险评估 prompt
│   │   ├── compact/          # 上下文压缩
│   │   ├── context/          # 智能上下文加载
│   │   ├── planningEngine/   # PlanningEngine + planningLLM
│   │   ├── reflection/       # ReflectionEngine + reflectionLLM + 复盘
│   │   ├── review/           # AutonomyReview
│   │   └── wakeup/           # WakeupScheduler + CronTrigger + taskStorage
│   ├── tools/                # 工具系统（15 个核心工具）
│   │   ├── file/ bash/ web/ task/ todo/
│   │   ├── agent/            # SubAgent 系统
│   │   ├── skill/ plugin/    # 技能 + 插件
│   │   └── interactive/      # ask_user / plan_mode
│   ├── memory/               # 三层记忆
│   ├── model/                # ModelProvider 抽象
│   ├── security/             # 权限 + autonomyLevels
│   ├── hooks/                # Hook 系统
│   ├── ui/                   # React + Ink TUI
│   │   ├── App.tsx           # 根组件
│   │   ├── commandDispatch.ts     # 斜杠命令分派
│   │   ├── planConfirmation.ts    # 规划/问题回答
│   │   └── turnEventHandler.ts    # TurnEvent → UI 更新
│   ├── config/               # Zod 配置 Schema
│   ├── utils/                # structuredCall / logger / truncate
│   └── types/                # 全局类型定义
├── docs/dev/                 # 开发过程文档
├── dist/                     # bun build 输出（.gitignore）
├── CHANGELOG.md              # 版本变更
├── LICENSE                   # MIT
├── package.json
└── tsconfig.json

开发

# 类型检查
bun run typecheck

# 运行测试
bun test

# 一次性检查（typecheck + test）
bun run check

# 编译单文件 bundle
bun run build    # 输出到 dist/index.js

# E2E 测试
bun test src/__tests__/e2e/

测试

✅ 1277 passed / 0 failed / 2903 expect() calls / 101 files
✅ TypeScript 严格模式零错误
✅ V1.2 跨特性集成测试覆盖 7 个组合场景
⚠️  registry.ts / hooks/engine.ts / turnLoop.ts 超 500 行软约束（V1.3 拆分）

插件开发

# 1. 创建插件目录
mkdir -p ~/.maxcode/plugins/my-plugin/dist

# 2. 编写 plugin.json
cat > ~/.maxcode/plugins/my-plugin/plugin.json <<'EOF'
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "我的插件",
  "main": "dist/index.js",
  "tools": ["MyTool"]
}
EOF

# 3. 编写工具实现（dist/index.js）
cat > ~/.maxcode/plugins/my-plugin/dist/index.js <<'EOF'
export const MyTool = {
  name: 'my-tool',
  inputSchema: null,
  description: () => '我的自定义工具',
  prompt: () => '这是一个自定义工具',
  async call(args, context) {
    return { result: 'Hello from plugin!' }
  }
}
EOF

# 4. 重启 maxcode，插件自动加载

里程碑进度

里程碑	状态	关键产出
M0	✅	终端纯文本对话 + MiniMax 模型接入
M1	✅	工具系统 + 权限引擎 + 文件/Bash + TUI + Hook
M2	✅	上下文压缩 + 智能上下文 + 搜索 + 任务系统 + 待办
M3	✅	三层记忆 + Relevant Memory 预取 + 会话持久化 + PlanningEngine
M4	✅	ReflectionEngine + WakeupScheduler + SubAgent + Skill + Plugin + 复盘
M5-0	✅	测试回归归零
M5-1	✅	工具调用率优化（prompt 工程 + tool_choice）
M5-2a	✅	Prompt 硬化（根治 tool_call 文本化复述）
M5-2b	✅	structuredCall helper + PlanningEngine LLM 化
M5-2c	✅	ReflectionEngine LLM 化
M5-2d	✅	AutonomyController LLM 风险评估
M5-2e	✅	激活运行时自主性（WakeupScheduler 接入 + /feedback）
M5-2f	✅	遗留问题收尾（14 条修复） + V1.0 发布准备
V1.0.0	✅	2026-04-17 首个正式版本
V1.1 (L1)	✅	PersistentMemory FTS5 全文搜索 + trigram + BM25 加权
V1.1 (L2)	✅	EventTrigger + ConditionTrigger + taskStorage 持久化
V1.2-1	✅	激活 EventTrigger：ToolDispatcher 投递 `file.changed` + `/fire-event`
V1.2-2	✅	工具 DESCRIPTION 中文化审计锁（CJK 自动扫描）
V1.2-3	✅	microCompact 两段式压缩（60% 阈值，零 LLM）
V1.2-4	✅	Hook `prompt` 类型（LLM 守门人 + fallback 三档）
V1.2-5	✅	Bundled Skills（3 个内置中文技能，开箱即用）
V1.2-6	✅	OutputStyles 输出风格系统（`/output-style`）
V1.2-7	✅	Plugins builtin 内置插件统一管理（`/plugins`）
V1.2.0	✅	2026-04-18 内部查漏补缺 + 系统化集成（969 测试）
V1.3-1	✅	Metaso v1 API 迁移 + web_reader + APIKey 双通道
V1.3-3	✅	Hook 扩展 agent 类型（自主子 agent 守门人）
V1.3-4	✅	Coordinator 系统提示词 + worker 续传 + 结构性嵌套防护
V1.3-I1~I6	✅	Memory 三件套 + 身份锚定 + OutputStyle 强化 + Config 修复
V1.3.0	✅	2026-04-20 差异化深化（1101 测试）
V2.0-1	✅	Keybindings 键绑定系统（6 context × 33 action，用户可覆盖）
V2.0-2	✅	项目模板系统（`/init` + Python/Node/TS 三套预置模板）
V2.0.0	✅	2026-04-21 UX 大升级（1277 测试）

已知限制

features.autonomy 默认关闭（安全优先），需显式开启以使用四级授权
V1.2-7 目前仅 bundled-skills 接入运行时禁用门禁；output-styles / metaso-search / reflection 禁用仅影响 /plugins 展示层
MiniMax 529 过载时自动回退到启发式模式（不阻塞基础工具调用，有中文友好提示）
registry.ts / hooks/engine.ts / turnLoop.ts 超过 CLAUDE.md 500 行软约束（V2.0-3 计划拆分）
V2.0-1 Keybindings 首版不支持 chord 和弦键 / 热重载 / 平台特化分支；保留键 ctrl+c/d/m/\ 不可覆盖
V2.0-2 Templates 首版仅加载二进制内置 3 套模板，不支持 ~/.maxcode/templates/ 用户自定义和远程 URL 拉取

贡献

仓库自 V2.0.0 起公开。欢迎通过以下方式参与：

通过 Issues 提交 bug 报告或功能建议
提交 PR 前请阅读项目根目录 CLAUDE.md 的开发规范（中文注释、PECT 四步、500 行硬限）
联系作者：gaolin1006@gmail.com

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
.github/workflows		.github/workflows
docs		docs
memory		memory
probes		probes
scripts		scripts
src		src
templates		templates
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
bunfig.toml		bunfig.toml
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

MaxCode（MiniMax Agent）

产品定位

与 Claude Code 的对比

能力矩阵

触发机制对比

核心价值与亮点功能

🎯 核心价值

架构总览

三层记忆系统

自主性反馈闭环

四级授权 + LLM 风险评估

两段式上下文压缩

内置插件统一管理（V1.2-7）

快速开始

方式一：下载预编译 Binary（推荐）

方式二：从源码运行（需要 Bun ≥ 1.0.0）

技术栈

斜杠命令（17 个）

配置

完整配置示例

启用自主模式（四级授权）

自定义每日复盘时间

技能扩展

输出风格（V1.2-6）

内置插件管理（V1.2-7）

事件驱动唤醒（V1.2-1）

上下文压缩（V1.2-3 两段式）

主要功能概览

① 编程助手层（基础工具）

② 自主 Agent 层

③ 持续进化层

架构亮点

项目结构

开发

测试

插件开发

里程碑进度

已知限制

贡献

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 5

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages