mAgent

运行在手机上的 Agent 程序（Flutter）。

聊天页：子任务（create_subtask）卡片、工具调用结果折叠卡片与 Markdown 实时渲染。

功能

• 工作区：沙箱内多工作区管理，支持 zip 导入/导出（含 .magent 配置与会话数据）
• 会话：多会话、消息记录（messages.jsonl）与 Agent 上下文（context.json）实时落盘到 <工作区>/.magent/sessions/<id>/
• 两层配置：全局（应用私有目录）+ 工作区（.magent/），同名时工作区优先；Agent/技能/MCP 配置均支持两层
• 供应商与模型：内置供应商模板（OpenAI 兼容 / Anthropic / Gemini 三种 API 类型），可拉取模型列表或手输创建模型配置
• Agent 配置：Markdown + YAML frontmatter（名称、描述、模型、允许/拒绝工具、允许技能）
• 工具系统：内置文件工具（glob/grep/read/write/edit）、read_skill、create_subtask（子会话，深度 ≤2）；MCP 远程服务器（Streamable HTTP，按请求解析工具表、超时降级）
• 对话体验：Markdown 渲染、流式输出、工具调用卡片、中断（含悬空 tool_calls 补偿）、启动恢复
• 指令：/new（重置会话）、/compact（LLM 摘要压缩上下文）

开发

flutter pub get
flutter test        # 53 个单元测试
flutter analyze
flutter run         # 真机或桌面调试

结构

• docs/DESIGN.md 设计文档（存储布局、运行时循环、切换/中断/恢复语义）
• lib/config 配置模型与两层合并 · lib/provider LLM 客户端 · lib/agent Agent/上下文/提示词
• lib/session 会话存储/运行时/恢复 · lib/tools 工具注册表/内置工具/MCP · lib/workspace 工作区管理与导入导出
• lib/ui/pages 工作区/会话/聊天/配置页面