mu 编程助手
用轻量判断内核处理日常决策,让主模型专注于代码工作。
- 源仓库
- qybaihe/mu
- Star 数
- ★ 476
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 77/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望在终端中让编码代理处理当前项目代码、运行命令并继续上次会话的开发者。
- 不适合
- 要求所有判断都留在本机的团队
- 需要稳定正式版而非预发布软件的用户
- 源码审查
- 77/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
mu 是基于 pi 构建的编码代理,提供命令行和内置运行时的桌面应用。它在输入处理、上下文筛选、工具安全、任务进度和多代理协作等环节设置判断点,由小型快速模型逐项回答有限问题。主模型负责读取项目、调用工具并完成工作,mu 则根据判断结果调整上下文、拦截或放行操作,并记录裁决。桌面端还提供 board、judgments、hive、files、preview、source 和 browser 等工作面板。项目处于早期开发阶段,当前发布为 0.1.x 预发布版。
在终端运行 mu 后,代理在当前目录开展编码会话;也可用 mu -p 单次执行提示,或用 mu -c 继续上次会话。mu 可逐块筛选工具输出、折叠完全重复的测试日志、检查网页及 MCP 输出中的提示注入内容,并在命令风险、约束、审批、任务漂移和完成状态等决策点询问指定 judge。它调用 pi 支持的模型提供方,并可将特定判断路由给 Jev、Laya、本地或云端分类模型及 LLM。它产生代码修改、工具执行结果和本地裁决记录;多代理 hive 的子代理只读取代码和运行命令,由主模型负责修改。
- 希望在终端中让编码代理处理当前项目代码、运行命令并继续上次会话的开发者。
- 经常面对冗长测试输出、希望按任务目标筛选日志或无损折叠重复内容的工程师。
- 需要在代理运行期间检查命令风险、变更约束和审批要求的个人或团队。
- 想让多个只读子代理并行调查代码,再由主代理统一实施修改的维护者。
- 希望通过桌面界面查看每项判断、任务进展、文件和内置浏览器操作的开发者。
如何安装或部署这个 Agent?
桌面端可从 GitHub Releases 下载 macOS、Windows 或 Linux 安装包;README 未要求额外安装 Node。命令行需要 Node.js 22.19 或更高版本:
如何使用这个 Agent?
安装命令行并连接模型后,在项目目录启动会话:
npm i -g mu-agent
mu setup
mu首次使用可不配置 judge key;此时 README 说明默认由 OpenCode Zen 上的免费 Jev 回答判断问题。要改用自己的 judge 服务,在 mu setup 或桌面应用的 judges 页面配置相应凭据。可用以下命令查看状态或运行一次提示:
mu doctor
mu -p "修复这个项目中的问题"这个 Agent 有哪些优点和局限?
- 判断内核将工具风险、上下文准入、任务漂移和完成检查拆为独立决策点,并可逐点选择 judge 或设为 shadow。
- 测试日志可无模型调用地折叠精确重复内容,README 报告其样本日志字符数减少 51%,且标记可还原原文。
- 提供 Jev 云端、322M 参数的本地 Laya,以及分类模型和通用 LLM 等判断路径。
- 桌面应用内置 mu 运行时,提供 judgments ledger、hive、任务 board 和浏览器等面板。
- 项目明确标注为早期开发,npm 和桌面版本为 0.1.x 预发布版,名称、设置和格式可能变化。
- 除使用 Laya 或关闭云端 judge 外,判断请求可能发送给所选服务;默认免费 Jev 将问题字段发往 OpenCode Zen。
- 命令行需要 Node.js 22.19 或更新版本;桌面应用与 CLI 的提供方登录、设置方式不同。
- README 的测试日志测量来自有限的作者样本,且没有与 pi、Claude Code 或 Codex 在相同任务上的端到端比较。
这个 Agent 与同类方案有什么区别?
mu 扩展 pi 的编码代理能力,加入判断内核;README 提到尚无与 pi、Claude Code 或 Codex 在相同任务上的端到端比较。mu 也支持导入并继续 Claude Code 和 Codex CLI 对话。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| mu 编程助手 当前 | 77 · 表现良好 | 桌面应用免费 + 模型费 | ★ 476 | 1 天前 | TypeScript | — |
| 《深入理解 AI Agent:设计原理与工程实践》开源仓库 | 41 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 53k | 9 天前 | Python | — |
| Claude Code 深度解析 | 0 · 缺口较多 | 网页应用免费 | ★ 3.7k | 1 个月前 | — | Claude Code |
| senpi | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 473 | 今天 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
SECURITY.md 明确说明 mu 以当前用户权限运行、并非沙箱,建议需要隔离时使用容器或虚拟机;风险规则、约束检查、项目 MCP 审批和权限模式提供了实质防护,但没有证据证明能彻底阻止误操作,因此未给满分。文档具体说明对话与裁判数据发往何处、密钥遮蔽和不跨裁判服务发送密钥;外部命令及其他效果受权限模式约束,设置了检查点和回退命令。依赖版本有锁定与 CI 检查线索,但所给材料没有依赖审计或漏洞缓解记录。上游 pi 和 AionUi 被明确点名,仓库范围与维护渠道清楚;因发布者身份未验证且维护团队规模小,归属与来源仍非充分独立核实。
README 描述了决策点、模式和命令,但仓库根 package.json 显示为 pi-monorepo、版本 0.0.3,而 README 称 mu 预发布 0.1.x;桌面依赖 AionUi 且与仓库级清单的对应关系不完全清楚,故只给中等自洽分。CI 文件列出构建、类型检查和测试流程,但运行时依赖免费 OpenCode Zen 或外部模型服务,且本地裁判也有能力局限,依赖可用性证据较薄。SECURITY.md 描述私密漏洞报告和响应时限,CI 也设置失败超时与日志产物;用户侧错误处理的具体证据有限。
文档针对交互式编码、上下文裁剪、测试日志、工具安全和多代理协作等场景给出清晰用途。权限模式、裁判类型、决策点的 active/shadow/off、沙箱边界及模型误判限制均有明确描述,因此能力边界与触发范围说明充分。CLI 明确要求 Node.js 22.19+,桌面版覆盖多个系统和架构;但所给材料没有详细说明资源需求、各环境差异或离线能力,环境适配未给满分。
README 有目录、分区表、命令表、配置提示和独立参考文档链接,安装步骤清楚,也说明预发布状态、测量范围和已知限制。决策点名称和产品名称虽有结构,但版本证据不一致(README 0.1.x 对根清单 0.0.3),且明确提示名称、设置与格式可能变化,因此命名稳定性偏低。LICENSE 文件提供 MIT 文本,但内容版权标为 Mario Zechner,与仓库及给定 MIT 元数据的对应关系在材料中没有解释,故未给满分。SECURITY.md 给出支持版本、维护责任和报告流程;变更历史在所给材料中没有实际条目证据。
产品提供可读的任务状态板、裁判账本、命令和逐项决策点说明,产出便于检查和操作。README 给出日志裁剪和目标感知筛选的量化结果及方法,并披露没有端到端同类产品对照、标签由作者制定等局限,支持其潜在价值但证据仍主要来自项目自测。低延迟、低成本和上下文节省的主张有具体数字;但裁判服务可能增加外部依赖与费用,且效果未由独立比较证实,因此成本收益只评为中等。
README 将主要性能主张链接到仓库内回放脚本和方法文档,并交代数据集、测量日期、标签来源和未覆盖情形;SECURITY.md 与 CI 配置对权限边界和自动化流程提供了补充佐证。由于所给材料中只有一个明确的空操作占位测试和部分工作流配置,不能据此确认所有声称的测试覆盖或实现效果,跨来源佐证评为中等。文档明确区分作者测量、实验范围、局限和未验证事项,事实与推断边界交代充分。
- mu 不是沙箱,可能以当前用户权限运行命令并修改文件;需要隔离时按 SECURITY.md 使用容器或虚拟机。
- 未配置裁判密钥时,决策数据会发送到 OpenCode Zen;使用外部模型时,对话会发送给所选模型提供方。请核对服务与数据流是否符合你的要求。
- README 与根 package.json 的版本线索不一致,且许可证文本中的版权归属没有在所给材料中解释;核实目标发行包、版本和许可证归属后再纳入正式流程。
常见问题
使用 mu 是否必须配置 judge API key?
判断请求会发送到哪里?
MU_JUDGE=off 时,判断留在本机。