Vibe Coding on MetaX：算子开发实战营

以沐曦 MetaX 为硬件底座，沿着「环境搭建 → 算子实践 → 架构认知 → Agent 设计 → 生态共建」的路径，学习使用 AI 编程工具开发、验证和优化算子，并逐步构建算子开发 Agent。

课程介绍

课程采用分层实践：初次接触 Vibe Coding 的学员先完成环境配置和第一个作品；有经验的学员从接手已有工程开始，通过测试和实验数据验证 AI 的修改。后续课程将进入 MACA 算子开发、Agent 架构及可复用开发流程。

本仓库是首版课程材料，当前可运行内容包括第一课进阶实验：算子测评结果分析器和第二课：Softmax 算子生成。这些实验使用模拟数据，在 CPU 上即可完成，无需 GPU 或模型 API；学员可自行选择已配置的 AI 编程工具。数据不代表 MetaX 实测性能。

学习顺序及章节名称

学习顺序及章节名称	任务入口 / 打卡	任务描述	建议用时	开始日期	截止日期
第一课：Vibe Coding 现状与开发环境搭建（基础路线 / 进阶路线二选一）	基础：任务文档 · Issue 2 进阶：任务文档 · Issue 1	基础：生成个人网页简历，通过追加需求迭代并验证桌面/手机端效果 进阶：接手算子测评分析器，修复实验审计缺失，验证统计结果，完成一项功能扩展	基础 60～90 分钟 进阶 90～120 分钟	待通知	待通知
第二课：Vibe Coding 沐曦算子开发入门	任务文档	生成 Softmax 算子，补边界测试，比较基准并预留 MetaX 适配层	90～120 分钟	待通知	待通知
第三课：Agent 架构深度解析	任务文档 · Issue 3	通过环境诊断与实验执行任务理解工具调用、规划和反馈，实现最小 ReAct Agent	待定	待通知	待通知
第四课：算子开发 Agent 设计与实现	任务文档 · Issue 4	回顾 Agent 架构理论，设计 LLM 大脑 / 记忆 / 工具集 / 决策循环四部分，跑通生成-测试-优化闭环，自主优化 GEMM / Softmax	待定	待通知	待通知
第五课：最终 Agent 开源作品展示 + 生态共建讨论	筹备中	展示学员算子生成 Agent 作品；引入 AKG、CUDA-Harness 等前沿设计；讨论在沐曦 GPU 上的实现路径与生态共建	待定	待通知	待通知

第一课两条路线按经验选择，不要求先完成基础路线才能进入进阶实验。基础路线由学员用 AI 生成作品，在 Issue 2 评论打卡；进阶路线提供可运行的起始代码，在 Issue 1 评论打卡。第三课使用 Issue 3，第四课使用 Issue 4。Issue 编号不代表课次。

DSH 远程环境配置

DeepSeek Harness (DSH) 是 DeepSeek 开源的 Agent 运行框架，提供 Web 交互界面，是本课程 Vibe Coding 的核心工具。本课程提供一键脚本，将 DSH 部署在模力方舟的沐曦 GPU 实例上，学员通过本地浏览器即可访问远程 DSH 交互界面。

相关链接

资源	链接
DSH 官方仓库	https://github.com/deepseek-ai/deepseek-harness
模力方舟平台	https://www.molix.ai
沐曦开发者文档	https://developer.metax-tech.com
DeepSeek 开放平台（API Key）	https://platform.deepseek.com
详细使用指南	scripts/dsh-remote/README.md

3 步速通

1. 创建实例：登录 模力方舟，用课程 token 包（GPU 算力券）创建沐曦 GPU 实例，打开 JupyterLab → Terminal
2. 远程部署：在远程 Terminal 运行 bash scripts/dsh-remote/remote_setup.sh，自动安装 Node.js 并启动 DSH（tmux 后台运行）。如果模力方舟提供模型 Token，可附加 --muxi-base-url、--muxi-api-key、--muxi-model，脚本会直接完成适配
3. 本地连接：在自己电脑运行 bash scripts/dsh-remote/local_connect.sh，输入 SSH 地址，SSH 隧道建立后浏览器自动打开 http://localhost:3080

脚本说明

脚本	功能	运行位置
remote_setup.sh	远程一键部署：自动安装 Node.js、检测端口、tmux 后台启动 DSH	模力方舟远程 Terminal
local_connect.sh	本地一键连接：建立 SSH 隧道、健康检查、自动打开浏览器	学员本地电脑
check.sh	连通性一键检查：4 项诊断（远程进程/端口、本地隧道/HTTP），每项失败给修复命令	学员本地电脑

Token 包说明：GPU 算力券与模型 API Token 可能是两种不同额度。若平台同时给出 OpenAI 兼容 API Base URL、Token 和模型 ID，可用 scripts/dsh-remote/muxi_token.sh 直接注入 DSH；只有 GPU 算力券时，仍需单独配置模型服务 Key。

从第一课进阶实验开始

需要 Python 3.10+ 和 Git，无第三方运行依赖。

git clone https://www.gitlink.org.cn/Dryoung/vibe-coding-on-metax.git
cd vibe-coding-on-metax/lessons/01-report-lab

PowerShell：

$env:PYTHONPATH = "$PWD/src"
python -m unittest discover -s tests -v
python -m operator_report.cli data/benchmark_results.csv --output report.json

Linux / macOS：

export PYTHONPATH="$PWD/src"
python -m unittest discover -s tests -v
python -m operator_report.cli data/benchmark_results.csv --output report.json

初始版本保留一个待修复的行为：正确性失败的记录没有进入排除清单，汇总计数因此也不正确。当前 10 项公开测试中，该项预期失败，其余 9 项应通过。修复后全部通过，且保持输入 CSV 和公开验收测试不变。

仓库结构

lessons/01-report-lab/          第一课进阶：算子测评结果分析器
  TASK.md                        统一任务文档：操作、验收与打卡模板
  data/                          模拟 GEMM / Softmax 测评数据
  src/operator_report/           可运行的学员起始代码
  tests/                         公开验收测试
  student_submission/            上下文、迭代和分析记录模板
lessons/01-resume/               第一课基础：个人网页简历
  TASK.md                        任务与打卡模板
lessons/02-metax-operator/       第二课：沐曦算子开发入门（Softmax）
  TASK.md                        任务文档
  src/operator_lab/              可运行的起始代码
  tests/                         公开验收测试
lessons/03-agent-lab/            第三课：Agent 架构深度解析
  TASK.md                        任务文档
  src/react_agent/               ReAct Agent 参考实现
  tests/                         公开验收测试
  student_submission/            提交模板
lessons/04-operator-agent/       第四课：算子开发 Agent 设计与实现
  TASK.md                        任务文档
  src/operator_agent/            Agent 框架与工具集
  tests/                         公开验收测试
  templates/                     GEMM / Softmax 算子模板
scripts/dsh-remote/              DSH 远程部署工具
  remote_setup.sh                远程一键部署（自动安装 Node.js、启动 DSH）
  local_connect.sh               本地一键连接（SSH 隧道 + 自动打开浏览器）
  check.sh                       连通性一键检查（4 项诊断 + 修复命令）
  README.md                      保姆级 3 步速通指南
docs/check-in.md                 第一课两条路线入口
docs/instructor-guide.md         教学执行与首版验收说明

首版直接在默认 master 分支提供学员版本，不含教师参考实现。进阶路线在 Issue 1 评论打卡，基础路线在 Issue 2 评论打卡。两条路线的完整任务文档分别为 算子测评任务 和 个人网页简历任务，均包含操作、验收和评论模板。