MandoCode 是一个面向开发者工作流的本地优先 CLI 编码代理，使用 .NET C# 编写，技术上由 RazorConsole 提供终端 UI（Razor 组件、虚拟 DOM 与 Spectre.Console 渲染），并由 Microsoft Agent Framework 和 Ollama 驱动。它既可以本地运行，也可以连接 Ollama 云端；官方称无需任何 API 密钥，包括 Web 搜索；可选的免费 Tavily 密钥可提升搜索可靠性。它提供类似 Claude Code 的项目感知能力，能够在终端内读取、写入、搜索、规划与网页浏览整个代码库，并理解 C#、JavaScript、TypeScript、Python、CSS、HTML、JSON、配置文件等多种文件类型。
核心组织方式围绕“代理（Agent）”与“工作区（Workspace）”展开。每个代理拥有自己的模型、对话、设置和上下文；可在本地与云端 Ollama 模型之间即时切换；代理之间可通过 @ 提及、提问和委派任务进行协作。每个工作区最多容纳四个独立代理。可将某个代理的上下文保存为摘要快照，带入另一个代理，或导入多个快照整合相关发现。也可通过历史记录重新打开之前的代理。命名工作区各自可容纳最多四个独立代理，键盘快捷键支持代理导航、文件浏览、项目目录、上下文快照、MCP 服务器与 Skills 管理，同时其他代理可继续工作。
安装与运行：需要 .NET 10 SDK（SDK 内含运行时，只需安装 SDK）以及 Ollama。已有 .NET 8 也不会被阻塞：MandoCode 同时提供 .NET 8 与 .NET 10 构建，dotnet tool install -g MandoCode 会自动为机器选择合适的版本；官方表示该回退机制将在 .NET 8 于 2026 年 11 月结束支持后取消。可运行 mandocode --doctor 查看当前使用的运行时。首次运行会启动引导向导：检测 Ollama、提示启动、引导云登录（如需更强模型），并自动拉取一个合理的默认模型；随时可用 /setup 重新运行。可在 MandoCode 内运行 /update 检查最新稳定版，也支持手动更新。
主要能力与使用方式：
- 多代理与工作区：每个任务可分配独立代理，每个工作区最多四个独立代理，各自拥有模型、对话与审批设置；可用 Alt+N 打开代理、Alt+Left/Right 切换代理、Alt+Shift+N 创建工作区。
- 可携带的上下文：用 /context-snap-create 保存对话中的决策、发现与后续步骤；用 /context-snap-import（Alt+C）搜索、预览并导入快照到另一个代理；快照持久化于 ~/.mandocode/snapshots.json，并在 CLI 代理与工作区之间共享。
- 恢复先前工作：用 /history（Alt+H）按名称、项目、模型或对话文本查找已保存代理，预览对话后恢复其名称、模型设置、转录与对话上下文。
- 代理协作：在提示符中输入 @ 后按 Tab 从 Files 切换到 Agents，可向其他代理询问发现、请求审查或移交独立工作；代理交互有独立折叠区域，展示参与者与实时状态，可展开查看请求、消息、任务评论、工具调用与带时间戳的 Markdown 回复。子任务有类似 job1 的可读 ID，收件箱消息类似 message1，任务会报告 Completed、Declined、Cancelled 或 Failed 等结果，并在受理后返回而不是等待结果。
- 项目工具：用 Alt+E 打开文件浏览器浏览项目文件夹与文件，选择文件会在提示光标处插入 @ 引用；用 Alt+D 更改当前代理的项目目录，用 Alt+G 查看 Git 变更；每个代理保持自己的项目目录，可在同一工作区跨项目工作。
- 扩展与集成：/mcp（Alt+M）打开 MCP 管理器，可添加或编辑服务器、测试连接、查看可用工具、启用或禁用集成；/skills（Alt+K）可从 Git、ZIP 文件或本地文件夹安装技能，也可编写、生成和精炼自己的指令后保存；共享集成跨代理可用，而每个代理保持自己的对话与设置。
- 模型管理：首次设置与 /setup 使用引导面板（连接 → 选择模型 → 下载 → 验证 → 就绪），可选择推荐的云端入门模型（如 glm-5.3-flash:cloud 或 deepseek-v4.1-flash:cloud）、带大致下载大小的本地入门模型、已安装模型或完整模型浏览器；云端需要 Ollama 登录与联网，官方提示适用账户限制与定价；本地模型内存占用取决于模型与上下文，超过下载大小。下载目标为配置的 Ollama 服务器；远程云认证必须在该服务器上配置。设置会用真实模型响应进行验证，验证失败可重试、换模型或稍后完成；已有模型偏好会在验证成功前保留。/ollama-pull 可随时浏览 Ollama 库、选择模型标签并带进度下载，搜索框可过滤模型名，支持 Popular、Name A–Z、Newest 排序，切换 Cloud 仅显示标记为云端托管的模型；/model 用于切换到已下载模型。
- 终端交互：对话在持久多行提示符上方滚动，带有可搜索选择器和可折叠工具输出；输入 / 可见自动补全下拉并搜索命令，输入 ! 可运行 shell 命令；/keybindings 查看完整快捷键参考（含菜单导航与编辑器控制）。
适用场景：适合在终端中完成代码重构、差异提议、代码库问答、跨文件搜索与规划、上下文交接、多代理并行任务、MCP 与技能扩展等开发工作；同时提供 MandoCode Desktop 原生 Windows 界面（同一引擎，WinUI 3 顶部，含集成 shell、感知 Git 的文件浏览器与 16 个内置主题），适合偏好原生应用的用户。
限制与注意事项：需要 .NET SDK；本地工具与源码构建应使用原始安装方式；更新会先询问再关闭所有工作区并保存代理历史（需启用持久化），终端会打印更新日志路径，完成后需重新启动 mandocode；云端模型需要 Ollama 登录与联网，并受账户限制与定价约束；本地模型内存占用取决于模型与上下文；快捷键依赖终端是否转发组合键；代理移交只是向模型传达责任与文件范围，并不锁定文件；只读审查允许内置检查工具，但不可用 shell 命令与未知 MCP 工具；忙碌代理可接收消息与更新，但会在下一轮才消费，不会注入当前活动请求；取消仅针对该次交互，所有权由分配代理检查。其他未在此提供的事实暂未提供。
