CLICK TO SKIP
点击跳过
MANGOPI-01 // TERMINAL AGENT // SINGLE FILE · ZERO DEPS
SYNC 100% // PATTERN: BLUE // A.T. FIELD ACTIVE
MANGOPIUNIT-01
中文EN GitHub ↗
01
EMERGENCY LAUNCH AUTHORIZED 紧急出击许可已授权 // v0.1.54 // PILOT READY 驾驶员就位

TERMINAL
AGENT UNIT
终端
智能体 一号机

Single-file Python agent. Multimodal + web search. Pure stdlib — no frameworks, no dependency trees. Eject the entry plug, type one command, and it fights. 单文件 Python 智能体。多模态 + Web Search。纯标准库——无框架、无依赖树。弹出插入栓,敲一条命令,它就出战。

SYNC RATIO
同步率
100.0%
PATTERN
信号模式
BLUE
CORE SIZE
核心体积
1604 lines行
DEPENDENCIES
依赖
ZERO
TESTS
测试
469 PASS通过
POWER
动力源
S² stdlibS² 标准库
PRIORITY-A ADVISORY — MCP EXTENSION ONLINE (EXPERIMENTAL) A 级通告 — MCP 扩展已上线(试验阶段) ALL SYSTEMS NOMINAL 全系统正常 17 EXTENSIONS ARMED 17 个扩展已挂载 ∞ PROVIDERS COMPATIBLE ∞ 模型可接入
SEC.01BRIEFING — MAGI ANALYSIS作战简报 — MAGI 分析

THE JUDGMENT三贤人的裁定

SEEKING A PERFECT BALANCE BETWEEN CODE SIZE, COMPLEXITY, AND THE CAPABILITY OF THE AGENT. 在代码体积、复杂度和智能体能力之间,追求完美的平衡。

Every subsystem is deliberated by three MAGI modules. Verdict: unanimous. The proof is the 1604-line core that still ships a full agentic loop, three-tier context compaction, an event bus and a reversible extension registry. 每个子系统都由三台 MAGI 评议表决。裁定结果:全体一致。证据是这份仅 1604 行的核心——依然完整承载 agentic 循环、三级上下文压缩、事件总线与可逆扩展注册表。

1604
LINES OF CODE — SCIENCE
代码行数 — 科学担当
One file. The whole agent: loop, tools, compaction, extensions, ACP. Readable top to bottom in one sitting.
单文件即整个智能体:循环、工具、压缩、扩展、ACP。一杯咖啡从头读到尾。
469
TESTS PASSING — LIFE
测试用例 — 生命担当
Zero runtime dependencies, zero pip install. Pure urllib / json / subprocess against 469 test cases.
零运行时依赖、零 pip 安装。纯 urllib / json / subprocess 对抗 469 个测试用例。
7+17
TOOLS + EXTENSIONS — PERSONALITY
工具与扩展 — 人格担当
7 core tools by default, 17 optional extensions, unlimited OpenAI-compatible providers on top.
默认 7 个核心工具、17 个可选扩展,其上再叠加无限 OpenAI 兼容模型。
SEC.02CAPABILITY REPORT — CLASSIFIED FILES能力报告 — 机密档案

CAPABILITY FILES能力档案

FILE:01
ZERO DEPENDENCIES零依赖
Pure Python stdlib — urllib, json, subprocess. No pip install. Single .py file.纯 Python 标准库 — urllib, json, subprocess。无需 pip 安装,单个 .py 文件。
→
FILE:02
AGENTIC LOOPAGENTIC 循环
Autonomous tool-calling loop: read → think → edit → verify. Multi-step reasoning, no manual intervention.自主工具调用循环:读取→思考→编辑→验证。多步推理无需人工干预。
→
FILE:03
SMART CONTEXT智能上下文
Three-tier compact: micro (expire stale tool results), session-memory, fallback (strip + trim). Auto at 80%.三级压缩:micro(过期工具结果)、session-memory、fallback(剥离+裁剪)。80% 自动触发。
→
FILE:04
MULTIMODAL多模态
view_image extension loads local screenshots / UI mockups into the model's vision context.view_image 扩展将本地截图/界面稿载入模型视觉上下文。
→
FILE:05
RUN MODES + PRESETS运行模式与预设
Per-preset directories: conf.py (tool whitelist / unloads / prompt overrides) + extensions/. Ships standard / minimal / codemode — activate with MANGO_PRESET; without it: pure built-in tools.按预设目录组织:conf.py(工具白名单/卸载/prompt 覆盖)+ extensions/。内置 standard / minimal / codemode — 用 MANGO_PRESET 激活;不设置则为纯内置工具。
→
FILE:06
SESSION PERSIST会话持久化
JSON in .mangocli/session/. Auto-backup on corruption. Resume anywhere.会话保存在 .mangocli/session/。损坏自动备份。断点续聊。
→
FILE:07
SAFETY CHECKS安全检查
rm -rf / sudo / chmod 777 detection. User confirmation before destructive commands. Path sandbox.检测 rm -rf / sudo / chmod 777。危险命令执行前需用户确认。路径沙盒。
→
FILE:08
SKILL SYSTEM技能系统
Reusable workflow bundles via SKILL.md. Install in ~/.mangocli/skills/, invoke via use_skill.通过 SKILL.md 复用工作流。安装至 ~/.mangocli/skills/,通过 use_skill 调用。
→
FILE:09
EXTENSION SYSTEM扩展系统
Extensions in ~/.mangocli/presets/<name>/extensions/ — tools, prompt sections and entry points auto-register at startup. Event bus + reversible unload.扩展放入 ~/.mangocli/presets/<name>/extensions/ — 工具/提示词段/入口启动自动注册。支持事件总线与可逆卸载。
→
FILE:10
ACP AGENT SERVERACP Agent 服务
Agent Client Protocol v1 over stdio — run as an agent inside Zed / JetBrains with session switching and full history replay.基于 stdio 的 Agent Client Protocol v1 — 在 Zed / JetBrains 中以 agent 运行,支持会话切换与历史回放。
→
SEC.03PILOT SELECTION — QUALIFIED CANDIDATES驾驶员遴选 — 适格者

QUALIFIED PILOTS适格驾驶员

Terminal-first devs终端流开发者
Prefer the shell over GUI tools.比起 GUI 工具更爱 shell。
Framework skeptics重型框架厌恶者
Dislike heavy AI frameworks and dependency trees.不喜欢臃肿的 AI 框架与依赖树。
Hackers & tinkerers黑客与折腾者
Want to peek under the hood and customize everything.想掀开引擎盖、一切都自己改。
Local-first enthusiasts本地优先主义者
Want code & data to stay on their machine.希望代码与数据留在本机。
Custom agent builders智能体构建者
Build bespoke agents on a clean, auditable base.在干净基座上构建定制智能体。
Multi-model teams多模型团队
Mix cheap + strong models per task to control API cost.按任务混用轻量与重型模型,控制 API 成本。
SEC.04DESIGN DOCTRINE设计教义

THE DOCTRINE设计教义

LOCAL-FIRST. AUDITABLE. HACKABLE. YOUR MACHINE, YOUR AGENT. 本地优先、可审计、可魔改。你的机器,你的智能体。

Frameworks hide the loop behind abstractions until the agent becomes a black box. Mangopi refuses that: everything is one importable Python file — the prompt, the tool dispatch, the compaction heuristics, the extension registry. Fork it, gut it, rebuild it. 框架把循环藏在抽象背后,直到智能体变成黑箱。Mangopi 拒绝这条路:一切都在一个可导入的 Python 文件里——prompt、工具分发、压缩策略、扩展注册表。fork 它、拆解它、重建它。

    A.T. FIELD // ABSOLUTE TERRITORY
    A.T. 力场 // 绝对领域
  • Easier to audit易于审计
  • Easier to hack易于魔改
  • Easier to fork易于分叉
  • Easier to understand易于理解
  • Easier to run locally易于本地运行
GOD'S IN HIS HEAVEN. ALL'S RIGHT WITH THE WORLD.
— MANGOPI DOCTRINE · SEC.04
— MANGOPI 教义 · SEC.04
SEC.05ARMAMENT MANIFEST武装清单

WEAPON MANIFEST武器清单

# DESIGNATION编号 FUNCTION功能 CLASS类别
001readText files only (view_image for images)仅文本文件(图片用 view_image)CORE核心
002writeWrite or overwrite写入或覆写CORE核心
003editExact string replace + diff精确字符串替换 + diffCORE核心
004searchGlob patterns, sorted by mtimeGlob 模式,按修改时间排序CORE核心
005grepRecursive regex content search递归正则内容搜索CORE核心
006bashShell exec (60s timeout)Shell 执行(60s 超时)CORE核心
007attempt_completionTask completion signal任务完成信号CORE核心
008acpACP v1 agent server over stdio基于 stdio 的 ACP v1 Agent 服务EXTENSION扩展
009ask_userMulti-choice clarification多选澄清提问EXTENSION扩展
010clipboardSystem clipboard R/W系统剪贴板读写EXTENSION扩展
011debugPer-call debug prints逐调用调试打印EXTENSION扩展
012git_statusRead-only git summaries只读 git 摘要EXTENSION扩展
013mcpMCP servers as proxy tools — new in v0.1.54MCP 服务器代理工具 — v0.1.54 新增EXTENSION扩展
014memoryLong-term memory + journals长期记忆 + 日志EXTENSION扩展
015multi_editBatch edits with rollback批量编辑 + 回滚EXTENSION扩展
016plan_modePlan-then-execute计划-执行模式EXTENSION扩展
017ratelimitRate warning (warn only)频率告警(仅告警)EXTENSION扩展
018run_codeCode Mode / PTC scriptsCode Mode / PTC 脚本EXTENSION扩展
019skillSkill system + use_skill技能系统 + use_skillEXTENSION扩展
020task_trackerIn-session task tracking会话任务跟踪EXTENSION扩展
021traceSession event stream JSON会话事件流落盘EXTENSION扩展
022view_imageLocal image to vision本地图片至视觉EXTENSION扩展
023web_fetchFetch URL content抓取 URL 内容EXTENSION扩展
024web_searchBocha AI Search live webBocha AI 实时搜索EXTENSION扩展
025+ yoursDrop a .py into extensions/ — auto-registered at startup放入 .py 至 extensions/ 启动自动注册SLOT空位
/qQuit退出 /nNew session新会话 /cCompact手动压缩 /hHelp帮助
SEC.06DEPLOYMENT SEQUENCE出击序列

DEPLOY SEQUENCE出击序列

LAUNCH PATH 01 出击路径 01 PyPI

Recommended. Requires Python 3.10+.推荐方式。需 Python 3.10+。

$ pip install mangopi-cli
$ mangopi-cli
LAUNCH PATH 02 出击路径 02 SOURCE

Clone and run. Zero setup.克隆即运行,零配置。

$ git clone git@github.com:w4n9H/mangopi-cli.git
$ cd mangopi-cli
$ python mangopi_cli.py
SEC.07ENTRY PLUG PARAMETERS插入栓参数

ENTRY PLUG插入栓配置

MANGO_KEY API keyAPI 密钥 —
MANGO_API_URL Endpoint端点 deepseek
MANGO_MODEL Model name模型名 v4-flash
MANGO_MAX_CONTEXT Max tokens最大 token 1M
MANGO_LANG UI language界面语言 en
$ export MANGO_KEY="your-key"
$ export MANGO_API_URL="https://api.deepseek.com"
$ export MANGO_MODEL="deepseek-v4-flash"