MindStudio智能体，提供性能和精度等自动分析功能
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
[feat] msagent add optix skills Co-authored-by: wendellX<wenxiaoping6@huawei.com> # message auto-generated for no-merge-commit merge: !111 merge modeling-optix into master [feat] msagent add optix skills Created-by: wendellX Commit-by: wendellX Merged-by: ascend-robot Description: [feat] msagent add optix skills [toc] ## 验证报告 ### 1）寻优工具安装   ### 2）寻优参数推荐 #### a) 参数推荐&生成       #### b）写入config.toml      ### 3）运行寻优工具  #### a）vllm拉起OK  #### b）benchmark OK；tpot <50ms；  #### c）最终运行结果（设备被占导致仅跑18轮次）  See merge request: Ascend/msagent!111 | 3 天前 | |
sync code from github Co-authored-by: Mrtutu<zhangwei983@huawei.com> | 2 个月前 | |
[feat] msagent add optix skills Co-authored-by: wendellX<wenxiaoping6@huawei.com> # message auto-generated for no-merge-commit merge: !111 merge modeling-optix into master [feat] msagent add optix skills Created-by: wendellX Commit-by: wendellX Merged-by: ascend-robot Description: [feat] msagent add optix skills [toc] ## 验证报告 ### 1）寻优工具安装   ### 2）寻优参数推荐 #### a) 参数推荐&生成       #### b）写入config.toml      ### 3）运行寻优工具  #### a）vllm拉起OK  #### b）benchmark OK；tpot <50ms；  #### c）最终运行结果（设备被占导致仅跑18轮次）  See merge request: Ascend/msagent!111 | 3 天前 | |
[fix]支持通过环境变量WHL_VERSION设置whl包的版本号 Co-authored-by: yuliangbin<y1416490440@163.com> # message auto-generated for no-merge-commit merge: !75 merge fix_env into master [fix]支持通过环境变量WHL_VERSION设置whl包的版本号 Created-by: yu_liangbin Commit-by: yuliangbin Merged-by: ascend-robot Description: 一、修改说明： 1.新增了 version.info 作为默认版本来源，内容固定为 mindstudio-agent 的 26.0.0；当未设置环境变量时，构建会从这里取版本。 2.新增了 scripts/sync_version.py ，现在只读取 WHL_VERSION 环境变量；若未设置，则回退到 version.info，并只同步更新 pyproject.toml 和 uv.lock 中根包 mindstudio-agent 的版本号。 3.修改了 scripts/build_whl.sh ，在构建开始前自动执行版本同步。 二、验证结果： 1.设置WHL_VERSION环境变量，用外部设置的版本号  2.不设置WHL_VERSION环境变量，用默认的版本号，且是version.info中的版本号  3.更新version.info中版本号，能正常刷whl的版本号   4.CI上正常刷新WHL_VERSION  See merge request: Ascend/msagent!75 | 1 个月前 | |
[feat] msagent add optix skills Co-authored-by: wendellX<wenxiaoping6@huawei.com> # message auto-generated for no-merge-commit merge: !111 merge modeling-optix into master [feat] msagent add optix skills Created-by: wendellX Commit-by: wendellX Merged-by: ascend-robot Description: [feat] msagent add optix skills [toc] ## 验证报告 ### 1）寻优工具安装   ### 2）寻优参数推荐 #### a) 参数推荐&生成       #### b）写入config.toml      ### 3）运行寻优工具  #### a）vllm拉起OK  #### b）benchmark OK；tpot <50ms；  #### c）最终运行结果（设备被占导致仅跑18轮次）  See merge request: Ascend/msagent!111 | 3 天前 | |
修复终端获取界面主题颜色错误问题 Co-authored-by: yuliangbin<y1416490440@163.com> # message auto-generated for no-merge-commit merge: !110 merge fix_color_630 into master 修复终端获取界面主题颜色错误问题 Created-by: yu_liangbin Commit-by: yuliangbin Merged-by: ascend-robot Description: 一、修改点： 1.移除 gsettings/macOS 桌面主题检测（SSH 下误判，Adwaita → light 但终端实际是黑背景） 2.新增 MSAGENT_BACKGROUND_THEME 环境变量，支持外部传入 dark/light 覆盖检测结果 3.检测链简化为：MSAGENT_BACKGROUND_THEME → OSC 11 → COLORFGBG → 兜底 dark 二、验证截图： 1.测试环境验证截图，深色主题下字体颜色显示为浅色。  2.外部设置MSAGENT_BACKGROUND_THEME环境变量为dark，可以更换字体颜色，浅色主题下字体为深色。  3.vscode浅色主体下，设置MSAGENT_BACKGROUND_THEME环境变量为light，字体颜色为深色。  See merge request: Ascend/msagent!110 | 5 天前 | |
增加benchmark工程 Co-authored-by: Vossera<galaxygit88@gmail.com> # message auto-generated for no-merge-commit merge: !54 merge feature-benchmark into master 增加benchmark工程 Created-by: gcw_DJmvhaNw Commit-by: Vossera Merged-by: ascend-robot Description: 增加benchmark测评代码 为msagent cli增加token统计，时间统计 temp commit 修改benchmark工程 delete .github ... 测试结果为  See merge request: Ascend/msagent!54 | 5 天前 | |
sync code from github Co-authored-by: Mrtutu<zhangwei983@huawei.com> | 2 个月前 | |
增加benchmark工程 Co-authored-by: Vossera<galaxygit88@gmail.com> # message auto-generated for no-merge-commit merge: !54 merge feature-benchmark into master 增加benchmark工程 Created-by: gcw_DJmvhaNw Commit-by: Vossera Merged-by: ascend-robot Description: 增加benchmark测评代码 为msagent cli增加token统计，时间统计 temp commit 修改benchmark工程 delete .github ... 测试结果为  See merge request: Ascend/msagent!54 | 5 天前 | |
docs: 重构 README 与中文文档目录结构（docs/zh） Co-authored-by: Vossera<galaxygit88@gmail.com> # message auto-generated for no-merge-commit merge: !46 merge feature-README into master docs: 重构 README 与中文文档目录结构（docs/zh） Created-by: gcw_DJmvhaNw Commit-by: Vossera Merged-by: ascend-robot Description: ## Summary 本次 PR 重构项目对外文档入口，将 README 精简为「项目首页 + 快速上手」，并把中文正文统一迁移到 docs/zh/ 分层目录，便于后续维护与 Read the Docs 构建。 主要变更： - **README.md**：按「简介 → 功能介绍 → 快速入门 → 安装/使用指南 → 典型案例 → 扩展参考」重新组织；补充 PyPI / Python / 文档 / 社区等徽章；Agent 表格补齐 **Icarus**；图片与文档链接统一指向 docs/zh/。 - **文档目录重组**：原 docs/agents/、docs/*-guide.md 等中文内容迁移至： - docs/zh/quick_start/（新增《入门安装指南》《快速入门指导》） - docs/zh/agent_guide/（Hermes / Accuracy / Zephyr / Minos / Icarus） - docs/zh/user_guide/（FAQ、配置与扩展、上下文压缩等） - docs/zh/developer_guide/（编译与打包、版本兼容、架构概览等） - docs/zh/images/、docs/zh/example/（静态资源随文档迁移） - docs/zh/legal/（LICENSE、SECURITY 中文入口） - **docs/index.md**：改为轻量入口页，通过 toctree 指向 docs/zh/index 与 docs/legal/。 - **docs/conf.py**：构建时复制 zh/images、zh/example 及 legal/LICENSE；注册 mermaid lexer 以支持相关代码块渲染。 ## 变更详情 ### README | 区域 | 说明 | |------|------| | 顶部 | 增加 PyPI、Python 3.11+、快速入门、配置文档、昇腾社区、Issues 等徽章 | | 简介 / 功能介绍 | 提炼项目定位；Agent 能力表合并为「形象 + 名称 + 领域 + 核心能力」 | | 快速入门 | 压缩安装与 LLM 配置示例，详细说明下沉到 docs/zh/quick_start/ | | 使用指南 | 保留 slash 命令与快捷键速查表 | | 导航链接 | 安装、配置、Agent 说明、FAQ、架构等链接全部改为 docs/zh/... 路径 | ### 文档站点（Sphinx / Read the Docs） - docs/zh/index.md 作为中文文档首页，按四类组织 toctree： - 快速入门 - Agent 指南 - 用户指南 - 开发指南 - 根 docs/index.md 仅保留中英文档与法律声明入口，避免与 README 重复维护大段正文。 ### CI - 移除 .github/workflows/build-wheel.yml（原 wheel 构建 workflow）。若仍需自动化出包，请在合并前确认是否由其他流水线承接。 ## 动机 - README 与 docs/index.md 此前内容高度重复，维护成本高且容易不一致。 - 中文文档缺少清晰分层，新用户难以按「安装 → 上手 → Agent → 开发」路径阅读。 - 为后续多语言文档扩展预留 docs/zh/ 目录空间。 ## 关联信息 - Base branch: master (158e40b) - Head branch: feature-README - Commit: 6b2b1de0ccc11421582ebfda98f18856441778aa See merge request: Ascend/msagent!46 | 1 个月前 | |
sync code from github Co-authored-by: Mrtutu<zhangwei983@huawei.com> | 2 个月前 | |
增加readthedocs配置 Co-authored-by: leo920320<liupengcheng8@huawei.com> | 2 个月前 | |
add mulan license Co-authored-by: fanglanyue<lanyuefang0916@163.com> # message auto-generated for no-merge-commit merge: !112 merge license into master add mulan license Created-by: fanglanyue0916 Commit-by: fanglanyue Merged-by: ascend-robot Description: 修改说明：添加mulan license说明 See merge request: Ascend/msagent!112 | 4 天前 | |
修复众测部分资料相关issue问题 Co-authored-by: yuliangbin<y1416490440@163.com> # message auto-generated for no-merge-commit merge: !104 merge fix_issue_docs into master 修复众测部分资料相关issue问题 Created-by: yu_liangbin Commit-by: yuliangbin Merged-by: ascend-robot Description: 修复以下issue: https://gitcode.com/Ascend/msagent/issues/70 https://gitcode.com/Ascend/msagent/issues/71 https://gitcode.com/Ascend/msagent/issues/76 https://gitcode.com/Ascend/msagent/issues/88 See merge request: Ascend/msagent!104 | 6 天前 | |
msagent编包脚本调整，提供web ui可控制打包能力 Co-authored-by: Mrtutu<zhangwei983@huawei.com> | 2 个月前 | |
sync code from github Co-authored-by: Mrtutu<zhangwei983@huawei.com> | 2 个月前 | |
fix(deps): 将 langgraph-cli[inmem] 移为可选 web extra 以解决 starlette 冲突 Co-authored-by: Xilun_Liu<413110682@qq.com> # message auto-generated for no-merge-commit merge: !109 merge fix/issue-83-web-optional-starlette into master fix(deps): 将 langgraph-cli[inmem] 移为可选 web extra 以解决 starlette 冲突 Created-by: Xilun_Liu Commit-by: Xilun_Liu Merged-by: ascend-robot Description: Fixes #83 改动说明 由于当前不再使用 web/UI 功能，将其依赖 langgraph-cli[inmem] 从核心依赖移到可选 extra [web]。 背景 在 vllm-ascend 容器内安装 msagent 时，langgraph-cli[inmem] 会传递引入 langgraph-api，强制把 starlette 升级到 1.x，与 vLLM 自带的 fastapi 0.123.10（要求 starlette<0.51）冲突，导致 vLLM 启动报错 Router.__init__() got an unexpected keyword argument 'on_startup'（见 issue #83）。 改动 把 langgraph-cli[inmem] 从 [project.dependencies] 移到 [project.optional-dependencies].web 重新生成 uv.lock web/UI 代码未改动；需要时仍可通过 pip install mindstudio-agent[web] 启用 效果 默认安装不再拉入 starlette 1.x，仅由 mcp（starlette>=0.27，无上限）约束，可与 fastapi 0.123.10 共存于 starlette 0.50，不再污染 vLLM 环境。CLI 主流程不受影响。 [image.png](https://raw.gitcode.com/user-images/assets/9610884/34f9d0f9-6fe3-41cd-8ae2-1171fdc012f3/image.png 'image.png') See merge request: Ascend/msagent!109 | 5 天前 | |
增加benchmark工程 Co-authored-by: Vossera<galaxygit88@gmail.com> # message auto-generated for no-merge-commit merge: !54 merge feature-benchmark into master 增加benchmark工程 Created-by: gcw_DJmvhaNw Commit-by: Vossera Merged-by: ascend-robot Description: 增加benchmark测评代码 为msagent cli增加token统计，时间统计 temp commit 修改benchmark工程 delete .github ... 测试结果为  See merge request: Ascend/msagent!54 | 5 天前 | |
fix(deps): 将 langgraph-cli[inmem] 移为可选 web extra 以解决 starlette 冲突 Co-authored-by: Xilun_Liu<413110682@qq.com> # message auto-generated for no-merge-commit merge: !109 merge fix/issue-83-web-optional-starlette into master fix(deps): 将 langgraph-cli[inmem] 移为可选 web extra 以解决 starlette 冲突 Created-by: Xilun_Liu Commit-by: Xilun_Liu Merged-by: ascend-robot Description: Fixes #83 改动说明 由于当前不再使用 web/UI 功能，将其依赖 langgraph-cli[inmem] 从核心依赖移到可选 extra [web]。 背景 在 vllm-ascend 容器内安装 msagent 时，langgraph-cli[inmem] 会传递引入 langgraph-api，强制把 starlette 升级到 1.x，与 vLLM 自带的 fastapi 0.123.10（要求 starlette<0.51）冲突，导致 vLLM 启动报错 Router.__init__() got an unexpected keyword argument 'on_startup'（见 issue #83）。 改动 把 langgraph-cli[inmem] 从 [project.dependencies] 移到 [project.optional-dependencies].web 重新生成 uv.lock web/UI 代码未改动；需要时仍可通过 pip install mindstudio-agent[web] 启用 效果 默认安装不再拉入 starlette 1.x，仅由 mcp（starlette>=0.27，无上限）约束，可与 fastapi 0.123.10 共存于 starlette 0.50，不再污染 vLLM 环境。CLI 主流程不受影响。 [image.png](https://raw.gitcode.com/user-images/assets/9610884/34f9d0f9-6fe3-41cd-8ae2-1171fdc012f3/image.png 'image.png') See merge request: Ascend/msagent!109 | 5 天前 | |
更新langchain-core为1.3.3+langchain-openai为1.1.14版本 Co-authored-by: yuliangbin<y1416490440@163.com> # message auto-generated for no-merge-commit merge: !107 merge fix_safe_629 into master 更新langchain-core为1.3.3+langchain-openai为1.1.14版本 Created-by: yu_liangbin Commit-by: yuliangbin Merged-by: ascend-robot Description: 修改点： 1.更新langchain-core为1.3.3版本 2.更新langchain-openai为1.1.14版本 3.agent版本更新为26.1.0.a2 关联issue: https://gitcode.com/Ascend/msagent/issues/2 https://gitcode.com/Ascend/msagent/issues/8 验证结果：   See merge request: Ascend/msagent!107 | 6 天前 |
MindStudio Agent
面向 Ascend NPU 场景的一站式调试调优
✨ 最新消息
🔹 [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 审查与评审意见整理。 |
🧩 Skills
除领域 Agent 外，msagent 还内置了一批可复用的 Skills，覆盖 Profiling 数据分析、算子性能调优、精度溢出检测、文档体验审查、代码审查等场景。完整技能清单、触发方式与依赖说明，请参见 《Skills》。
如需将 Skills 或 msprof-mcp 接入 Trae、Claude、Codex 等外部 Agent，可参考 《接入指南》。
🚀 快速入门
快速体验核心功能，请参见《msAgent快速入门》。
📦 安装指南
介绍工具的环境依赖与安装方法，请参见《msAgent安装指南》。
📘 使用指南
工具的详细使用方法，请参见《msAgent使用指南》。
❓ FAQ
常见问题与排查入口请参见 《FAQ》。
🌌 智能检索
为提升文档查阅效率，建议优先通过以下入口定位信息：
🔹 《中文文档首页》：按快速入门、用户指南、Agent 指南和开发指南组织内容。
🔹 《配置与扩展》：查询本地配置目录、MCP 配置、Skills 扩展与加载顺序。
🔹 《版本与兼容性》：查询版本要求、兼容策略与内置依赖。
🔹 会话内直接询问 msagent：让对应 Agent 结合仓库文档、配置和上下文辅助定位问题。
🛠️ 贡献指南
欢迎提交 Issue、PR 或补充新的领域 Skills。完整流程、开发自检与各类贡献指引见 《贡献指南》。
⚖️ 相关说明
🔹 《版本与兼容性》
🔹 《安全声明》
🔹 《免责声明》
🔹 《许可证声明》
🤝 建议与交流
欢迎大家为社区做贡献。如果有任何疑问或建议，请提交 Issues，我们会尽快回复。感谢您的支持。
| 即时互动（微信群） | 官方资讯（公众号） | 深度支持（助手/论坛） |
|---|---|---|
 扫码加入技术交流群 |
 扫码关注官方公众号 |
扫码入群并关注公众号，直达 MindStudio 用户与开发者最快捷的交流平台： 快速提问： 与社区小伙伴即时探讨技术问题 掌握动态： 第一时间获取版本发布与功能更新通知 经验共享： 与广大开发者交流最佳实践与实战心得 更多支持渠道：👉 昇腾助手：  👉 昇腾论坛： |
🙏 致谢
本工具由华为公司下列部门联合贡献：
🔹 昇腾计算 MindStudio 开发部
🔹 昇腾计算生态使能部
感谢来自社区的每一个 PR，欢迎贡献！