msAgent

MindStudio Agent

面向 Ascend NPU 场景的一站式调试调优

简体中文 | English

✨ 最新消息

🔹 [2026.08.26]：新增一键安装方式（curl | bash / irm | iex），基于 uv 隔离安装，避免与现有环境依赖冲突，推荐使用（详见《安装指南》）。 🔹 [2026.06.04]：Hermes 更名为 Profiler，Zephyr 更名为 Quantizer，Icarus 更名为 Operator。 🔹 [2026.05.21]：v26.0.0已发布，新增Icarus Agent，覆盖算子性能调优场景。 🔹 [2026.04.27]：v26.0.0.alpha1 发布，新增 Accuracy / Zephyr Agent，覆盖精度调优与模型量化场景。 🔹 [2026.04.08]：v0.1.3 发布，完成 DeepAgents 重构并增强 Hermes / Minos Agent。 🔹 [2026.03.19]：mindstudio-agent 已发布到 PyPI，推荐使用 pip install mindstudio-agent 安装。

ℹ️ 简介

MindStudio-Agent（简称 msAgent）是面向昇腾 Ascend NPU 开发、调试和调优场景的 AI Agent 工作台。它将 CLI、多模型 Provider、MCP 工具、内置 Skills 与领域 Agent 组合在一起，帮助用户在性能调优、精度分析、模型量化、算子优化、文档体验与代码审查等任务中更快定位问题并形成可执行建议。

⚙️ 功能介绍

名称	核心能力
Profiler	【性能调优】 聚焦 Ascend Profiling 分析，覆盖单卡、多卡、集群等场景，擅长快慢卡、慢节点、MFU、通信瓶颈、算子热点、下发调度等性能问题定位与优化建议。
Accuracy	【精度调优】 聚焦 Ascend 精度分析与优化，覆盖 RL 训推一致性分析、loss / gnorm NaN 分析等常见精度问题。
Quantizer	【模型量化】 聚焦 msModelSlim 量化与压缩场景，协助完成模型适配可行性、结构风险评估与基础适配器开发。
Modeling	【仿真建模】 聚焦大模型（LLM/VLM）仿真建模场景，承接性能建模、单点仿真、吞吐规划、设备画像与模型接入准备类问题。
Operator	【算子调优】 聚焦 Ascend NPU 算子性能调优，包括算子性能深度分析、端到端算子性能优化，辅助提升调优效率并降低开发难度。
Minos	【文档体验与代码审查】 聚焦 README 走查、安装流程验证、Quick Start 体验、新手 onboarding、文档可用性评估，以及 GitCode PR 审查与评审意见整理。
SpecTrainer	【投机解码重采样】 聚焦投机解码训练数据的 on-policy 重采样（响应重生成），把多轮对话的 assistant 回答用 verifier 模型逐轮重新生成可直接进训练的预分词样本。

SpecTrainer 的 Skill 脚本基于开源 speculators 仓 v0.6.0 做流程编排；技能说明见 skills/README.md。

🚀 快速入门

10 分钟快速一站式体验一键安装、接入模型并启动msAgent进入交互会话的流程，请参见《msAgent快速入门》。

🧩 AI Skill

除领域 Agent 外，msagent 还内置了一批可复用的 Skills，覆盖 Profiling 数据分析、算子性能调优、精度溢出检测、文档体验审查、代码审查等场景。完整技能清单、触发方式与依赖说明，请参见 《Skills》。

如需将 Skills 或 msprof-mcp 接入 Trae、Claude、Codex 等外部 Agent，可参考 《接入指南》。

📦 安装指南

介绍工具的环境依赖与安装方法，支持一键安装、pip 安装、源码编译三种方式，请参见《msAgent安装指南》。

📘 使用指南

工具的详细使用方法，请参见《msAgent使用指南》。

安全提示

• msagent 可执行 shell 命令、加载第三方 MCP Server 与 Skill，请仅在可信环境中使用。
• 建议通过环境变量传入凭据；msagent 自身发起的 HTTP 请求默认启用 TLS 证书校验。

❓ FAQ

常见问题与排查入口请参见 《FAQ》。

🌌 智能检索

为提升文档查阅效率，我们提供多种高效检索方式： 🔹 AI 问答（DeepWiki）：自然语言问答，快速把握项目架构与模块关系。 🔹 AI 问答（ZRead）：中文问答体验更优，精准定位功能用法与细节。 🔹 精确搜索（ReadTheDocs）：关键词全文检索，直达接口、参数与报错等信息。

🛠️ 贡献指南

欢迎提交 Issue、PR 或补充新的领域 Skills。完整流程、开发自检与各类贡献指引见 《贡献指南》。

⚖️ 相关说明

🔹 《版本说明》 🔹 《许可证声明》 🔹 《安全声明》 🔹 《免责声明》

🤝 建议与交流

欢迎大家为社区做贡献。如果有任何疑问或建议，请提交 Issues，我们会尽快回复。感谢您的支持。