▄███▄ XiaoTie v3
█ ⚙ █ MIMO-only Agent Runtime
▀███▀
只面向 MIMO 的本地 Agent runtime。
小铁 v3 不再做多 provider 适配层。它把模型边界收束到 MIMO，把工程重点放回 Agent 运行时本身：状态机、guardrail、trace、checkpoint、工具权限、上下文预算、RepoMap 和沙箱执行。
小铁是一个 coding-agent runtime，而不是模型聚合器。
| 决策 | v3 行为 |
|---|---|
| 模型入口 | 只支持 provider: mimo |
| 默认模型 | mimo-v2-pro |
| 可选模型 | mimo-v2-pro, mimo-v2-omni |
| API Key | MIMO_API_KEY 或 ${secret:api_key} |
| Thinking | 默认关闭，显式 --thinking 才开启 |
| 多 provider | 拒绝 OpenAI/Anthropic/Gemini/DeepSeek/Qwen 等 provider 参数 |
graph TD
CLI["CLI / TUI / SDK"] --> RT["AgentRuntime"]
RT --> GR["MIMO-only Guardrail"]
RT --> TRACE["Trace Events"]
RT --> CKPT["Checkpoint Store"]
RT --> CTX["ContextEngine"]
RT --> MAP["RepoMapEngine"]
RT --> RESP["ResponseHandler"]
RT --> EXEC["ToolExecutor"]
RESP --> MIMO["MimoClient"]
MIMO --> API["MIMO Anthropic-compatible API"]
EXEC --> PERM["PermissionManager"]
EXEC --> TOOLS["Local Tools / MCP Tools"]
TOOLS --> SB["OS Sandbox"]
CTX --> MEM["Conversation / Memory Budget"]
MAP --> AST["tree-sitter + PageRank"]
运行时核心在 xiaotie/agent/runtime.py，v3 架构原语在 xiaotie/agent/architecture.py。
input_guardrail
-> thinking
-> acting
-> observing
-> reflecting
-> completed | failed | cancelled
每次关键阶段都会生成结构化 AgentTraceEvent，并写入 AgentCheckpoint。这让后续接持久化、resume、human-in-the-loop 和可视化 trace 时有稳定的数据边界。
git clone https://github.com/LeoLin990405/xiaotie.git
cd xiaotie
pip install -e ".[dev,tui,secrets,repomap]"配置 MIMO key：
export MIMO_API_KEY="your-key"或写入系统 keyring：
xiaotie secret set api_key最小配置：
api_key: ${secret:api_key}
api_base: https://token-plan-sgp.xiaomimimo.com/anthropic
model: mimo-v2-pro
provider: mimo
max_steps: 50
workspace_dir: ./workspace
thinking_enabled: false
tools:
enable_file_tools: true
enable_bash: true
enable_git: true运行：
xiaotie
xiaotie --tui
xiaotie -p "分析这个 repo 的结构" -f json
xiaotie -p "重构这个函数" -qimport asyncio
from xiaotie.agent import AgentConfig, AgentRuntime
from xiaotie.llm import LLMClient
from xiaotie.tools import BashTool, ReadTool, WriteTool
async def main():
llm = LLMClient(
provider="mimo",
model="mimo-v2-pro",
)
runtime = AgentRuntime(
llm_client=llm,
system_prompt="你是小铁，一个谨慎的本地 coding agent。",
tools=[
ReadTool(workspace_dir="."),
WriteTool(workspace_dir="."),
BashTool(),
],
config=AgentConfig(max_steps=30, stream=True),
)
result = await runtime.run("帮我整理这个项目的重构入口")
print(result)
print(runtime.trace_events[-1])
asyncio.run(main())| 模块 | 责任 |
|---|---|
xiaotie.llm |
公开 MIMO-only facade，LLMClient 和 MimoClient |
xiaotie.agent.architecture |
phase、trace event、checkpoint、guardrail 原语 |
xiaotie.agent.runtime |
状态机执行循环和 trace/checkpoint 接入 |
xiaotie.agent.executor |
工具执行、权限、审计、并行调用 |
xiaotie.agent.response |
流式响应、token 统计、摘要 |
xiaotie.context_engine |
上下文预算和消息组装 |
xiaotie.repomap_v2 |
tree-sitter AST + PageRank 代码地图 |
xiaotie.permissions |
风险评估、确认、敏感输出脱敏 |
xiaotie.secrets |
keyring/env/config 分层密钥解析 |
xiaotie.sandbox |
macOS Seatbelt / Linux Bubblewrap / rlimits |
| 命令 | 说明 |
|---|---|
xiaotie |
交互式 CLI |
xiaotie --tui |
Textual TUI |
xiaotie -p "问题" |
非交互执行 |
xiaotie -p "问题" -f json |
JSON 输出 |
xiaotie --thinking |
显式启用 MIMO thinking |
xiaotie secret set api_key |
写入 MIMO key |
xiaotie secret list |
查看已存密钥 |
交互命令包括 /help, /tools, /map, /find, /tree, /tokens, /compact, /secret, /reset, /quit。
当前 v3 gate：
uv run --python 3.12 --extra dev ruff check xiaotie/ tests/unit/test_providers.py tests/unit/test_config.py tests/unit/test_builder.py tests/unit/test_runtime.py tests/unit/test_agent_architecture.py tests/unit/test_mimo_client.py
uv run --python 3.12 --extra dev ruff format --check xiaotie/agent/architecture.py xiaotie/agent/runtime.py xiaotie/llm/mimo_client.py xiaotie/llm/providers.py xiaotie/llm/wrapper.py
uv run --python 3.12 --extra dev python -m pytest tests/unit -q
uv run --python 3.12 --extra dev python -m pytest tests/integration/test_core_business_smoke.py -v --tb=short -m smoke最近一次结果：
| Gate | Result |
|---|---|
| Unit tests | 1674 passed, 39 skipped |
| Smoke integration | 3 passed |
| Coverage | 62% |
v3 会拒绝这些旧配置：
provider: openai
provider: anthropic
provider: gemini
provider: deepseek
provider: qwen请统一改为：
provider: mimo
model: mimo-v2-pro
api_key: ${secret:api_key}旧 Agent 类仍保留兼容，但已 deprecated。新代码请使用 AgentRuntime。
- 持久化 checkpoint store
- 可视化 trace timeline
- resumable execution
- human-in-the-loop 中断与恢复
- MCP resource/prompt/tool 统一注册表
- RepoMap 与 ContextEngine 的自动预算调优