已开启
社区任务 #1
zhangky创建于  5月18日
zhangky
zhangky成员
5月18日 创建

CANN Recipes 三仓社区任务设计

任务主题

CANN Recipes 三仓体验共建计划:文档捉虫 / 代码捉虫 / 一站式平台样例体验

任务背景

CANN Recipes 系列仓库面向开发者提供基于 CANN 平台的典型模型、算法和优化实践样例,覆盖推理、训练、具身智能等场景:

  • cann-recipes-infer:面向 LLM 与多模态模型推理业务,提供 CANN 平台推理优化样例。
  • cann-recipes-train:面向 LLM 与多模态模型训练业务,提供训练、强化学习、预训练、SFT 等优化样例。
  • cann-recipes-embodied-ai:面向具身智能业务场景,提供典型模型与加速算法样例。

为了提升仓库文档质量、代码可用性和样例体验完整度,现面向社区发起三类共建任务,欢迎开发者参与体验、反馈和贡献。

任务方向

方向一:文档捉虫任务

参与者可选择任意一个或多个仓库,对 README、样例说明、环境准备、启动脚本说明、FAQ、贡献指南等文档进行体验和检查。

可反馈的问题包括但不限于:

  • 文档链接失效、路径错误、锚点跳转失败。
  • 命令行参数、脚本名称、目录结构与实际仓库不一致。
  • 环境依赖、版本要求、模型或数据下载说明不完整。
  • 操作步骤缺失,导致新用户无法按文档完成体验。
  • 表述不清、错别字、格式错乱、表格渲染异常。
  • 中英文术语混用不规范,关键概念解释不足。
  • 样例结果、性能数据、硬件要求缺少说明或前后不一致。

交付方式:

  • 轻量问题:在 Issue 中提交问题说明。
  • 可直接修复的问题:提交 Pull Request,修正文档内容。
  • 批量文档问题:建议整理为表格,包含“仓库、文件路径、问题描述、建议修改”。

方向二:代码捉虫任务

参与者可选择任意仓库中的样例代码、脚本、patch、配置文件或 CI 检查逻辑进行阅读、运行和排查。

可反馈的问题包括但不限于:

  • 脚本参数错误、默认路径错误、变量名不一致。
  • patch 无法正常 apply,或与文档描述不一致。
  • requirements、Dockerfile、启动脚本存在依赖缺失。
  • 示例命令执行失败,错误信息未在文档中说明。
  • 代码中存在明显拼写错误、无效导入、未使用变量。
  • 配置项命名混乱,容易导致用户误用。
  • 样例代码与仓库贡献规范、目录规范不一致。
  • CI 校验、格式检查、基础构建存在可改进点。

交付方式:

  • 提交 Issue:需包含复现环境、复现步骤、实际结果、期望结果。
  • 提交 PR:需说明修复原因、修改范围、验证方式。
  • 涉及新增特性或较大改动时,建议先提交 Issue 进行方案讨论。

方向三:一站式平台样例体验任务

参与者可基于一站式平台提供的 NPU 环境,选择三仓中的样例进行端到端体验,并反馈体验问题。

建议优先体验方向:

  • cann-recipes-infer:LLM / 多模态模型推理样例,关注模型加载、推理启动、性能参数、输出结果。
  • cann-recipes-train:SFT、RL、预训练等训练样例,关注环境准备、数据准备、启动脚本、日志输出、训练结果。
  • cann-recipes-embodied-ai:具身智能相关模型或算法样例,关注样例链路、输入输出、部署步骤和可复现性。

体验反馈建议包含:

  • 体验仓库和样例名称。
  • 使用的硬件环境、CANN 版本、Python 版本、依赖版本。
  • 是否能按 README 完成启动。
  • 遇到的问题、错误日志和解决方式。
  • 对文档步骤、默认参数、样例组织方式的改进建议。
  • 若体验成功,可补充运行截图、关键日志或结果说明。

参与方式

任务认领

在任务讨论下方评论认领任务,格式如下:

认领仓库:
任务方向:文档捉虫 / 代码捉虫 / 一站式平台样例体验
计划检查的样例或文件:
预计完成时间:

任务执行

  1. Fork 对应仓库,基于最新分支进行体验、问题定位或修改。
  2. 根据问题类型提交 Issue 或 Pull Request。
  3. 对于能够直接修复的问题,鼓励优先提交 PR,推动问题闭环。
  4. 对于涉及新增特性、较大代码改动或样例流程调整的问题,建议先提交 Issue 进行方案讨论。

任务交付

在任务讨论下方回复交付链接,格式如下:

交付仓库:
任务方向:
Issue / PR 链接:
问题摘要:
验证方式:

验收标准

有效 Issue 标准

  • 问题描述清晰,能说明影响范围。
  • 提供具体文件路径、命令、日志、截图或复现步骤。
  • 不是重复问题,且与目标仓库直接相关。
  • 建议类问题需给出明确改进方向。

有效 PR 标准

  • 修改内容与任务方向一致。
  • 不引入无关改动。
  • 文档修改表达清晰、格式正确。
  • 代码修改需说明验证方式,必要时通过仓库已有检查。
  • 不修改现有 Signed-off-by 信息。
  • PR 通过仓库评审并最终合入后计入积分。

一站式平台体验报告标准

  • 说明体验的具体仓库、样例、环境和步骤。
  • 明确给出“成功 / 失败 / 部分成功”的体验结论。
  • 若失败,需附关键日志和定位建议。
  • 若成功,建议补充关键输出、截图或性能记录。

评分机制

本次任务采用积分制,鼓励开发者不仅发现问题,也推动问题修复和经验沉淀。原则上,同类问题中,提交可合入 PR 的贡献高于仅提交 Issue。

贡献类型 说明 建议分值
有效文档 Issue 指出文档链接、命令、路径、表述、格式等问题,并提供明确位置和修改建议 1-3 分
有效代码 Issue 反馈脚本、配置、patch、依赖、运行流程等问题,包含复现步骤和关键日志 2-5 分
重点代码 Issue 经公开 SIG 例会认定为重点代码问题 代码 Issue 分值 x2
文档修复 PR 修复文档错误、补充缺失步骤、优化样例说明,且通过评审合入 4-8 分
代码修复 PR 修复脚本、配置、patch、样例代码或 CI 检查问题,且通过评审合入 6-12 分
重点代码修复 PR 经公开 SIG 例会认定为重点代码问题修复 代码修复 PR 分值 x2
一站式平台体验报告 完成端到端体验,提供环境、步骤、结果、日志和改进建议 5-10 分
体验报告 + PR 闭环 基于体验问题提交修复 PR,并完成问题闭环 10-20 分
FAQ / 排障文档沉淀 将高频问题整理为 FAQ、排障指南或补充到 README 额外 3-8 分

计分规则

  1. 重复问题不重复计分,以首次有效提交为准。
  2. 同一根因导致的多个现象,原则上合并计分。
  3. Issue 需包含明确的问题位置、复现步骤或修改建议,否则不计分。
  4. PR 需通过仓库评审并最终合入后计分。
  5. PR 若关联有效 Issue,可同时获得 Issue 基础分和 PR 修复分。
  6. 大量低质量、无法复现、无实际价值的问题不计分。
  7. 涉及较大功能改动、新增样例或架构调整的 PR,需先通过 Issue 讨论达成共识。

重点代码问题双倍积分机制

为鼓励开发者发现并修复影响样例可用性、正确性和性能体验的关键问题,本次任务设置“重点代码问题”双倍积分机制。

重点代码问题范围

重点代码问题包括但不限于:

  • 导致样例无法启动、无法完成端到端运行的问题。
  • 导致推理、训练或具身智能样例结果明显错误的问题。
  • 导致 patch 无法应用、依赖无法安装、脚本无法执行的问题。
  • 导致一站式平台体验链路中断的问题。
  • 影响较多用户或多个样例的公共代码、公共配置、公共文档问题。

认定方式

  • 是否属于重点问题,由 CANN 社区公开 SIG 例会讨论决定。
  • 参与者可在 Issue 或 PR 中标注“申请重点问题认定”,并说明影响范围、复现方式和修复价值。
  • SIG 例会确认后,在对应 Issue / PR 中同步认定结论。

双倍积分规则

  • 重点代码问题发现:对应代码 Issue 分值按 2 倍计算。
  • 重点代码问题修复:对应代码修复 PR 分值按 2 倍计算。
  • 若同一参与者完成“发现 + 修复”闭环,则 Issue 分和 PR 分均可按重点问题规则分别计算。
  • 若多人协作完成同一重点问题,积分分配由 SIG 例会根据实际贡献讨论确认。

推荐激励导向

  • 只发现问题:有基础分。
  • 发现问题并说明清楚:获得更高评分。
  • 发现问题并提交 PR 修复:重点奖励。
  • 完成一站式平台体验并沉淀文档:重点奖励。
  • 推动问题从发现到合入闭环:最高优先级奖励。

推荐选题

  • cann-recipes-infer 推理样例 README 可复现性检查。
  • cann-recipes-infer 模型推理脚本参数与文档一致性检查。
  • cann-recipes-train SFT / RL 样例一站式平台快速启动体验。
  • cann-recipes-train patch 命名、apply 流程和贡献文档一致性检查。
  • cann-recipes-embodied-ai 具身智能样例环境准备与启动流程检查。
  • 三仓 README 链接、目录结构、术语、License 和免责声明一致性检查。

奖励说明

likedislike
zhangkyzhangky成员
5月18日 修改了issue 的描述
wang_zzp
wang_zzp
5月19日 评论:

cann-recipes-infer 社区任务清单

以下任务清单基于 cann-recipes-infer 仓库当前结构整理,面向社区开发者发布,开发者可选择任一任务提交 Issue 或 PR。

样例 README 可复现性检查

任务事项 任务说明 建议交付
LLM 样例 README 可复现性检查 选择 DeepSeek、GLM、Qwen、Kimi、LongCat、GPT-OSS、Pangu、LLaDA、HSTU 等任一 LLM / 推荐模型样例,检查 README 中环境准备、权重准备、依赖安装、启动命令、配置修改、预期输出是否完整,是否能指导开发者完成一次推理体验 Issue 或 PR
多模态样例 README 可复现性检查 选择 SANA-Video、HunyuanVideo、Wan2.2-I2V、HunyuanImage-3.0、DeepSeek-OCR-2 等任一多模态样例,检查输入准备、prompt / 图片 / PDF 路径、输出目录、输出格式、依赖安装和推理结果说明是否完整 Issue 或 PR
社区贡献样例 README 可复现性检查 检查 contrib/ 下 DeepSeek-OCR-2、DeepSeek 310P、vLLM PD Hybrid 等样例的部署说明、patch 流程、启动命令、结果说明和第三方依赖是否可复现 Issue 或 PR

脚本、配置与依赖一致性检查

任务事项 任务说明 建议交付
推理启动脚本与 README 一致性检查 检查 models/*/infer.sh、set_env.sh、function.sh、executor/scripts/*.sh 与 README 命令是否一致,重点关注模型路径、配置路径、卡数、batch、并行参数、输出路径、环境变量和错误提示 Issue 或 PR
config YAML 与配置文档一致性检查 检查 models/*/config、docs/common/inference_config_guide.md 中配置字段是否一致,重点关注 model_path、并行参数、batch、输出路径、执行模式、不可配置字段和默认值说明 Issue 或 PR
依赖与版本说明检查 检查 requirements.txt、pyproject.toml、README 中 CANN、Python、PyTorch、torch-npu、Transformers、SGLang、vLLM、OmniInfer 等版本要求是否清晰,是否存在依赖缺失、版本冲突或安装顺序不清晰的问题 Issue 或 PR

一站式平台体验与快速启动完善

任务事项 任务说明 建议交付
SANA-Video 一站式平台快速启动体验 按 README 中一站式平台快速启动路径体验 SANA-Video,若发现问题,提交包含硬件环境、软件版本、操作步骤、输出结果、报错日志和改进建议的 Issue;若可直接修复,提交 PR Issue 或 PR
一站式平台入口与 FAQ 完善 检查根 README 中“一站式平台快速体验”入口是否清晰;将体验中遇到的路径、权限、依赖、模型下载、输出目录等高频问题整理成 FAQ 或补充到对应 README Issue 或 PR
其他样例一站式平台适配建议 选择 README 样例列表中的代表性模型,评估是否适合补充一站式平台快速启动路径,并说明需要补齐的脚本、依赖、模型准备和文档内容 Issue

Patch 与第三方框架适配检查

任务事项 任务说明 建议交付
SGLang 样例 patch 与启动流程检查 检查 Qwen3-Next、Qwen3-MoE SGLang、LLaDA2.0 SGLang 等样例中的源码准备、patch 应用、安装脚本、prefill / decode / router 启动流程是否闭环,失败时是否有明确提示 Issue 或 PR
vLLM / vLLM-Ascend / OmniInfer 样例检查 检查 DeepSeek-OCR-2、vLLM PD Hybrid 等样例中的模型下载、源码准备、NPU patch、环境变量、启动命令、输出结果和性能数据说明是否完整 Issue 或 PR
DeepSeek 310P 社区样例检查 检查 contrib/deepseek_v3_ascend310p 中 C++ 推理引擎编译、配置文件、启动脚本、性能分析脚本和部署说明是否完整 Issue 或 PR

自定义算子编译与运行体验

任务事项 任务说明 建议交付
AscendC 算子编译与 examples 体验 检查 ops/ascendc 的 SoC 编译参数、编译产物说明、安装步骤、torch_ops_extension wheel 构建,以及 examples 运行命令和结果说明是否完整 Issue 或 PR
PyPTO / PyPTO Python 算子体验 检查 ops/pypto、ops/pypto_python 的 build、install、examples、compare 脚本和 docs 是否一致,是否能指导开发者完成一次算子运行体验 Issue 或 PR
TileLang 算子样例检查 检查 ops/tilelang 中 DeepSeek 相关 TileLang kernel 示例是否有必要的环境准备、运行方式、输入输出和结果说明 Issue 或 PR

executor 推理框架与公共模块检查

任务事项 任务说明 建议交付
executor offline / online 流程一致性检查 检查 executor/offline、executor/online 与 docs/design 中离线推理、在线推理、server、router、bootstrap、PD 分离、KV transfer 等描述是否与代码一致 Issue 或 PR
KV Cache 与权重加载流程检查 检查 executor/core/kv_cache、executor/model_loader 与相关设计文档中 block pool、cache manager、paged cache、default loader、dummy loader、weight utils 的说明和报错提示是否清晰 Issue 或 PR
公共模块与日志易用性检查 检查 module/linear.py、module/quantization、module/dit_cache、module/unified_sp、executor/utils/logging_config.py 等公共模块的参数命名、边界条件、调用说明和错误日志是否便于定位问题 Issue 或 PR
测试入口可用性检查 检查 tests/、executor/scripts/test_all_case.sh 是否可作为基础验证入口,测试失败时是否有明确说明和排查建议 Issue 或 PR

全仓规范与基础质量检查

任务事项 任务说明 建议交付
全仓链接、目录结构和术语检查 检查 README.md、docs/、models/*/README.md、contrib/*/README.md 中内部链接、外部链接、锚点、目录结构、模型名称、脚本名、配置名、并行术语和硬件型号是否准确统一 Issue 或 PR
License、免责声明和第三方资源说明检查 检查根目录、模型目录、contrib 样例中第三方模型、权重、数据、代码的 License 信息、免责声明和风险提示是否说明清楚 Issue 或 PR
贡献指南与 Issue / PR 模板检查 检查 CONTRIBUTION.md、.gitcode/ISSUE_TEMPLATE、.gitcode/PULL_REQUEST_TEMPLATE 是否覆盖文档反馈、代码问题、体验问题、样例共建等常见社区贡献场景 Issue 或 PR

生态共建建议与未来方向

任务事项 任务说明 建议交付
新模型适配建议 结合当前 LLM、多模态模型发展趋势,提出适合补充到 cann-recipes-infer 的新模型样例建议,说明模型价值、目标硬件、推理框架、预期使用场景和可复现路径 Issue
一站式平台样例扩展建议 基于现有样例体验,评估哪些模型适合补充一站式平台快速启动路径,说明需要补齐的脚本、依赖、模型准备、默认参数和文档内容 Issue 或 PR
现有样例缺陷和改进建议 总结当前样例在可复现性、易用性、性能说明、错误提示、环境依赖、输入输出说明等方面的不足,提出可落地的改进方案 Issue 或 PR
推理性能评测与结果呈现建议 建议统一的性能记录方式,例如硬件型号、卡数、输入长度、batch、并行策略、耗时、吞吐、显存占用等字段,并补充到 README 或 docs 中 Issue 或 PR
模型样例标准模板建议 基于已有 README 和 contrib 样例,提出统一的模型样例模板,覆盖环境准备、权重准备、依赖安装、配置说明、启动命令、输出结果、FAQ、License 等内容 Issue 或 PR
第三方框架生态适配建议 围绕 vLLM、SGLang、OmniInfer、Transformers 等框架,提出后续适配、版本升级、patch 收敛、启动脚本统一和文档补齐建议 Issue 或 PR
自定义算子生态补齐建议 基于 LLM 和多模态样例中的高频算子需求,提出 AscendC、PyPTO、PyPTO Python、TileLang 相关算子补齐、示例完善、文档增强或测试补充建议 Issue 或 PR
公共推理框架能力建议 针对 executor、module 等公共能力,提出配置管理、在线推理、KV Cache、权重加载、日志、测试入口、错误诊断等方面的可实施改进建议 Issue 或 PR
新手贡献体验改进建议 从外部开发者视角反馈首次参与贡献时遇到的门槛,例如仓库入口、贡献流程、Issue / PR 模板、样例目录规范、验证方式说明等,并提出优化建议 Issue 或 PR
likedislike
tianjyoi
tianjyoi
5月19日 评论:

cann-recipes-infer 社区任务清单

本文档面向外部社区开发者整理 cann-recipes-infer 开源共建任务。任务按“由浅入深”的参与路径设计,开发者可以先从阅读代码和文档开始,通过 Issue 反馈问题;也可以在本地部署样例、复现推理流程;进一步还可以基于仓库已有 skill、框架、公共能力和模型样例结构,贡献新的模型适配代码。

推荐参与路径如下:

阶段 参与方式 适合人群 建议交付
初级任务 阅读文档、脚本、配置和仓库规范,发现浅层错误并参与文档捉虫 首次参与社区贡献的开发者 Issue 或 PR
中级任务 部署并运行仓上样例,反馈复现、部署、环境和不同机型适配问题 有昇腾环境或样例体验条件的开发者 Issue 或 PR
进阶任务 基于现有框架能力补充完善仓上未覆盖的模型代码和样例 熟悉模型推理、框架适配或算子优化的开发者 Issue、设计说明或 PR

初级任务:文档捉虫与基础质量检查

本阶段希望开发者先通过阅读仓库文档、脚本和配置,查找低门槛、易验证的问题,例如错别字、链接失效、命令不一致、配置字段说明不清晰、依赖版本描述缺失等。建议优先通过 Issue 说明问题位置、现象和修改建议;如果可以直接修复,欢迎提交 PR。

任务事项 任务说明 建议交付
全仓链接、目录结构和术语检查 检查 README.md、docs/、models/*/README.md、contrib/*/README.md 中内部链接、外部链接、锚点、目录结构、模型名称、脚本名、配置名、并行术语和硬件型号是否准确统一 Issue 或 PR
脚本、配置与 README 一致性检查 检查 models/*/infer.sh、set_env.sh、function.sh、executor/scripts/*.sh 与 README 命令是否一致,重点关注模型路径、配置路径、输出路径和环境变量等 Issue 或 PR
YAML 与配置文档一致性检查 检查 models/*/config、docs/common/inference_config_guide.md 中配置字段是否一致,重点关注参数注释和默认值说明 Issue 或 PR
依赖与版本说明检查 检查 requirements.txt、pyproject.toml、README 中 CANN、Python、PyTorch、torch-npu、Transformers、SGLang、vLLM、OmniInfer 等版本要求是否清晰,是否存在依赖缺失、版本冲突或安装顺序不清晰的问题 Issue 或 PR

中级任务:样例部署、复现与机型体验反馈

本阶段希望开发者真正运行仓库中的样例,反馈部署和复现过程中遇到的问题。问题范围可以比较广,包括 README 步骤是否可复现、一站式平台是否能快速启动、自定义算子是否能完成编译和运行,以及在不同硬件机型、软件版本、驱动/CANN 版本上使用代码时发现的问题和修改点。

提交体验类 Issue 时,建议尽量包含硬件环境、软件版本、模型名称、操作步骤、配置修改、完整报错、日志片段、实际输出和期望输出;如果已经定位到修复方式,欢迎直接提交 PR。

任务事项 任务说明 建议交付
LLM 样例 README 可复现性检查 选择 DeepSeek、GLM、Qwen、Kimi、LongCat、GPT-OSS、Pangu、LLaDA、HSTU 等任一 LLM / 推荐模型样例,检查 README 中环境准备、权重准备、依赖安装、启动命令、配置修改、预期输出是否完整,是否能指导开发者完成一次推理体验 Issue 或 PR
多模态样例 README 可复现性检查 选择 SANA-Video、HunyuanVideo、Wan2.2-I2V、HunyuanImage-3.0、DeepSeek-OCR-2 等任一多模态样例,检查输入准备、prompt / 图片 / PDF 路径、输出目录、输出格式、依赖安装和推理结果说明是否完整 Issue 或 PR
社区贡献样例 README 可复现性检查 检查 contrib/ 下 DeepSeek-OCR-2、DeepSeek 310P、vLLM PD Hybrid 等样例的部署说明、patch 流程、启动命令、结果说明和第三方依赖是否可复现 Issue 或 PR
一站式平台快速启动体验 按 README 中“一站式平台快速体验”路径运行 SANA-Video 等已有样例,检查入口、脚本、依赖、模型下载、权限、输出目录和结果说明是否清晰;若发现高频问题,可补充 FAQ 或 README Issue 或 PR
其他样例一站式平台适配建议 选择 README 样例列表中的代表性模型,评估是否适合补充一站式平台快速启动路径,并说明需要补齐的脚本、依赖、模型准备、默认参数和文档内容 Issue
自定义算子编译与运行体验 体验 ops/ascendc、ops/pypto、ops/pypto_python、ops/tilelang 等目录中的 build、install、examples、compare 流程,检查 SoC 编译参数、编译产物、运行命令、输入输出和结果说明是否完整 Issue 或 PR
不同机型部署与适配反馈 在不同昇腾硬件机型、卡数、驱动/CANN 版本、Python/PyTorch/torch-npu 组合下部署和运行样例,反馈环境差异导致的脚本、配置、依赖、性能、显存或报错问题,并说明可复现路径 Issue 或 PR
性能结果记录与呈现建议 基于实际运行结果,建议统一记录硬件型号、卡数、输入长度、batch、并行策略、耗时、吞吐、显存占用等字段,并补充到 README 或 docs 中 Issue 或 PR

进阶任务:新模型样例与框架能力扩展

本阶段希望开发者在已有能力基础上参与代码共建。仓库已经沉淀了模型样例目录、推理启动脚本、配置模板、LLM 推理框架、公共模块、自定义算子目录和相关 skill 能力,社区开发者可以基于这些基础补充仓上未覆盖的模型代码,共同丰富模型多样性。

建议在提交新模型 PR 前先通过 Issue 描述模型价值、目标硬件、依赖框架、权重来源、License 风险、复现步骤和计划修改范围,便于社区讨论和协同。

任务事项 任务说明 建议交付
新模型样例适配 参考仓库模型样例,补充当前仓上未覆盖的 LLM、推荐模型或多模态模型代码,提供 README、配置文件、启动脚本、依赖说明、输入输出示例和基础验证方式 Issue 或 PR
基于 skill 的模型贡献 复用仓库已有 skill 和样例模板,沉淀新模型适配过程中的代码生成、配置整理、README 编写、验证流程和常见问题,提升后续模型接入效率 Issue 或 PR
框架能力扩展 针对框架等公共能力,补充新模型需要的配置管理、KV Cache 管理、量化、并行策略、日志、错误诊断或测试入口能力 Issue 或 PR
第三方框架生态适配 围绕 vLLM、SGLang、OmniInfer 等框架,贡献后续适配、版本升级、patch 收敛、启动脚本统一和文档补齐方案 Issue 或 PR
自定义算子能力补齐 基于 LLM 和多模态样例中的高频算子需求,补充 AscendC、PyPTO、PyPTO Python、TileLang 相关算子实现、示例、文档或测试 Issue 或 PR
模型样例标准模板共建 基于已有 README 和 contrib 样例,完善统一的模型样例模板,覆盖环境准备、权重准备、依赖安装、配置说明、启动命令、输出结果、FAQ、License 等内容 Issue 或 PR
现有样例缺陷修复 对已存在样例进行代码、脚本、配置或文档修复,提升可复现性、易用性、性能说明、错误提示、环境依赖和输入输出说明质量 Issue 或 PR

Issue / PR 提交建议

场景 建议说明内容
文档捉虫 问题文件、章节位置、当前描述、建议修改、是否愿意提交 PR
样例复现问题 硬件机型、卡数、驱动/CANN 版本、Python/PyTorch/torch-npu 版本、模型名称、操作步骤、报错日志、期望结果
新模型共建 模型名称、模型价值、目标硬件、依赖框架、权重和 License 说明、计划目录结构、验证方式、预期交付
代码修复 PR 修复内容、影响范围、验证命令、验证结果、未覆盖风险
likedislike
chenhy
5月19日 评论:

cann-recipes-embodied-ai 社区任务清单

本文档面向外部社区开发者整理 cann-recipes-embodied-ai 开源共建任务。仓库覆盖 manipulation、world_model、navigation、locomotion、3d_vision 五大具身智能场景,提供训练、在线推理、OM 离线推理多种样例。任务按"由浅入深"的参与路径设计,开发者可以先从阅读代码和文档开始通过 Issue 反馈问题;也可以在本地部署样例、复现推理或训练流程;进一步还可以基于仓库已有公共能力和样例结构,贡献新的优化手段、模型适配或真机部署样例。

推荐参与路径

阶段 参与方式 适合人群 建议交付
初级任务 阅读文档、脚本、配置和仓库规范,发现浅层错误并参与文档捉虫与样例可复现性检查 首次参与社区贡献的开发者、在校学生 Issue 或 PR
中级任务 部署并运行仓上样例,反馈复现、部署、环境和不同昇腾机型适配问题 有昇腾环境(Atlas A2 / A3 / 310P / OrangePi)或样例体验条件的开发者 Issue 或 PR
进阶任务 基于现有公共能力补充优化手段(量化 / DiT-Cache / 公共算子)、新增模型样例或完成真机部署 demo 熟悉模型推理、框架适配、算子优化或机器人部署的开发者与高校实验室 Issue、RFC 或 PR

初级任务:文档捉虫与基础质量检查

本阶段希望开发者通过阅读仓库文档、脚本和配置,查找低门槛、易验证的问题,例如错别字、链接失效、命令不一致、配置字段说明不清晰、依赖版本描述缺失、README 步骤不可复现等。建议优先通过 Issue 说明问题位置、现象和修改建议;如果可以直接修复,欢迎提交 PR。

仓库基础质量检查

任务事项 任务说明 建议交付
全仓链接、目录结构与术语检查 检查 README.md、docs/、manipulation/*/README.md、world_model/*/README.md、locomotion/*/README.md、navigation/*/README.md、3d_vision/*/README.md 中内部链接、外部链接、锚点、目录结构、模型名称、脚本名、配置名、并行术语和硬件型号(Atlas A2 / A3 / Ascend 310P / OrangePi AI Station)是否准确统一 Issue 或 PR
脚本与 README 命令一致性检查 检查各样例下 download_code_and_data.sh、run_*.sh、set_env.sh、set_conda_env.sh、setup.sh 等脚本与 README 中的命令、参数、路径是否一致,重点关注模型路径、配置路径、卡数、batch、输出路径和环境变量 Issue 或 PR
依赖与版本说明检查 检查各样例的 requirements.txt、pyproject.toml、README 中 CANN、Python、PyTorch、torch-npu、Transformers、LeRobot 等版本要求是否清晰,是否存在依赖缺失、版本冲突、conda / uv 两种环境管理方式说明不一致或安装顺序不清晰的问题 Issue 或 PR

样例 README 可复现性检查

任务事项 任务说明 建议交付
Manipulation 样例 README 可复现性检查 选择 Pi0、Pi0.5、ACT、SmolVLA、DiffusionPolicy、OpenVLA、Isaac-GR00T N1.6、Spirit-v1.5 等任一操作类样例,检查 README 中环境准备、CANN 版本要求、代码仓拉取、数据集与权重下载、torch_npu 安装、推理/训练命令、预期输出与精度指标是否完整,是否能指导开发者完成一次端到端体验 Issue 或 PR
World Model 样例 README 可复现性检查 选择 Cosmos-Predict2.5、Cosmos-Transfer2.5、AgiBot-Arm-World-Model 任一世界模型样例,检查 git-lfs 安装、prompt/condition 输入准备、输出视频路径、显存占用、生成耗时说明是否完整 Issue 或 PR
Navigation / Locomotion / 3D Vision 样例 README 可复现性检查 选择 Alpamayo-R1、LQC、Hunyuan3D 2.0、VGGT 任一样例,检查 docker 镜像加载、子模块克隆、第三方代码合入流程、推理/训练脚本启动方式与预期结果说明是否完整 Issue 或 PR

中级任务:样例部署、复现与机型适配反馈

本阶段希望开发者真正运行仓库中的样例,反馈部署和复现过程中遇到的问题。问题范围包括一站式平台是否能快速启动、Ascend 310P / OrangePi 等边缘机型上的样例是否能完成 OM 转换与离线推理、以及在不同昇腾机型、CANN 版本、torch-npu 版本组合下使用代码时发现的问题和修改点。

提交体验类 Issue 时,建议尽量包含硬件机型、卡数、驱动 / CANN 版本、Python / PyTorch / torch-npu 版本、模型名称、操作步骤、配置修改、完整报错、日志片段、实际输出和期望输出;如果已经定位到修复方式,欢迎直接提交 PR。

一站式平台快速启动完善

任务事项 任务说明 建议交付
一站式平台快速启动模板补齐 参考 3d_vision/vggt/README.md 与 manipulation/pi0/infer_with_torch/README.md 中的"一站式平台快速启动"段落,为尚未接入的样例(如 ACT、SmolVLA、Pi0.5、Hunyuan3D、Cosmos、Alpamayo-R1、LQC 等)补充"最小步骤"路径,帮助用户在已集成 CANN 的 NPU 环境中跳过繁琐配置直接体验 Issue 或 PR
一站式平台入口与 FAQ 完善 检查根 README 🏃 一站式平台快速体验 一节入口是否清晰;将体验中遇到的镜像路径、权限、conda/uv 切换、模型下载镜像、输出目录、set_env.sh 加载等高频问题整理成 FAQ 或补充到对应 README Issue 或 PR

Ascend 310P 样例维护

任务事项 任务说明 建议交付
310P OM 推理样例可复现性检查 检查 manipulation/pi0/infer_with_om、manipulation/pi05/infer_with_om、manipulation/act/infer_with_om、manipulation/diffusion-policy/infer_with_om、manipulation/openvla/infer_with_om 的 ONNX 导出脚本、OM 转换命令、convert_and_verify_onnx.py 输入输出说明、AIPP 配置、batch / 动态 shape 支持是否完整可复现 Issue 或 PR
310P 性能数据补齐 README 性能表中 DiffusionPolicy、OpenVLA 等 310P 样例的"性能参考"列为空,跑通后按统一格式(硬件型号 / batch / 端到端时延 / 单步推理时延 / 显存占用)补齐 Issue 或 PR
310P 在线推理样例检查 检查 manipulation/pi05/infer_with_torch、manipulation/spirit-v1.5/infer_with_torch 在 Ascend 310P 上的 torch 在线推理路径、环境约束、性能数据与错误提示是否完整 Issue 或 PR

跨硬件机型与版本适配反馈

任务事项 任务说明 建议交付
跨昇腾机型部署反馈 在不同昇腾硬件机型(Atlas A2 / A3 / Ascend 310P / OrangePi AI Station)、卡数、驱动 / CANN 版本下部署和运行现有样例,反馈硬件差异导致的脚本、配置、依赖、性能、显存或报错问题,并说明可复现路径 Issue 或 PR
CANN 与 torch-npu 版本组合适配反馈 在不同 CANN 版本(8.3.RC1 / 8.5.0 等)与 torch-npu 版本(2.1.0.post12 / 2.7.1.post2 等)组合下复现现有样例,反馈版本依赖问题或提交版本兼容性修复 Issue 或 PR

进阶任务:优化手段、公共能力、真机部署与新模型共建

本阶段希望开发者在已有公共能力基础上参与代码共建。仓库已经沉淀了样例目录结构、推理与训练脚本、module/dit_cache 通用缓存能力、VGGT 量化路径与部分模型的融合算子优化,社区开发者可以基于这些基础贡献新的优化手段、抽取公共算子库、补充真机部署 demo 或新增模型样例。

建议进阶任务在提交完整 PR 前,先通过 Issue / RFC 描述方案、目标硬件、依赖框架、权重来源、License 风险、计划修改范围与预期交付,便于社区讨论和协同。

优化手段使能

任务事项 任务说明 建议交付
INT8 量化适配——OpenVLA 7B 参考 3d_vision/vggt/quant/vggt_linear.py、vggt_utils.py 中的 INT8 量化实现路径,为 manipulation/openvla/infer_with_om 补充 INT8 量化样例,给出精度(任务成功率 / 动作 MAE)与性能(端到端时延 / 显存)对比 Issue 或 PR
INT8 量化适配——Pi0 / Pi0.5 参考 VGGT INT8 路径,对 Pi0 与 Pi0.5 的 PaliGemma + Action Expert 做 INT8 量化适配(Atlas A2 在线推理 / Ascend 310P OM 离线推理路径均可选其一),给出精度-性能对比 Issue 或 PR
INT8 量化适配——Cosmos / Hunyuan3D 参考 VGGT INT8 路径,为 Cosmos-Predict2.5-2B、Cosmos-Transfer2.5-2B、Hunyuan3D 2.0 任一世界模型/3D 生成模型补充 INT8 量化样例,输出 PSNR/LPIPS 或主观对比图与生成耗时对比 Issue 或 PR
DiT-Cache 使能——Cosmos 世界模型 参考 3d_vision/Hunyuan3D/hy3dgen/cache/cache_block.py 与 module/dit_cache/cache_method.py 提供的 FBCache / TeaCache / TaylorSeer 通用方案,为 Cosmos-Predict2.5-2B 或 Cosmos-Transfer2.5-2B 集成 DiT-Cache,给出加速比与视觉质量对比 Issue 或 PR
DiT-Cache 使能——Diffusion Policy / AgiBot-Arm-World-Model 参考 Hunyuan3D 的 DiT-Cache 接入方式,为 manipulation/diffusion-policy 或 world_model/agibot-arm-world-model 集成 DiT-Cache,输出加速比与策略成功率/视频质量曲线 Issue 或 PR
DiT-Cache 通用化与新策略扩展 当前 module/dit_cache 的 TaylorSeer 假设 double_stream/single_stream 双流结构、FBCache 默认走 CFG 双路缓存,可对接入新模型时遇到的限制做通用化改造;或在 BaseCache 基础上新增 PAB / AdaCache / ∆-DiT 等近期 SOTA 策略 Issue 或 PR
姊妹仓优化手段引入 参考 cann-recipes-infer、cann-recipes-train 等姊妹仓上已沉淀的模型优化手段(如图模式编译、并行策略、训练侧融合算子或显存优化等),选择本仓任一已有样例(manipulation / world_model / navigation / locomotion / 3d_vision)进行适配落地,输出精度-性能对比报告并沉淀优化文档 Issue 或 PR

公共模块与算子库抽取

任务事项 任务说明 建议交付
NPU 融合算子公共库抽取——RMSNorm 当前 npu_rms_norm 在 Hunyuan3D、Cosmos-Predict2.5、Cosmos-Transfer2.5、Isaac-GR00T、Pi0 等至少 5 处独立实现,建议以 manipulation/Isaac-GR00T/adaptor_patches/modeling_siglip2_patch.py:72 的 NpuRMSNorm(带 CPU fallback)为基线,抽取到 module/npu_ops/rms_norm.py,并替换各样例的重复定义 Issue 或 PR
NPU 融合算子公共库抽取——RoPE 当前 npu_rotary_mul 在 Pi0(拼接调一次)、Isaac-GR00T(q/k 分别调)、Cosmos(现算 cos/sin)、VGGT(rotary_mode='half')等至少 5 处实现且范式不一致,建议在 module/npu_ops/rope.py 提供 apply_rope_qk / apply_rope_concat / apply_rope_1d 统一签名 Issue 或 PR
NPU 融合算子公共库抽取——Fused Attention 当前 npu_prompt_flash_attention(Pi0、Spirit-v1.5)与 npu_fusion_attention(Pi0.5 训练、Cosmos)签名、layout(BSND/BNSD)、attention_mask 转换、KV-head 重复展开各写各的,建议在 module/npu_ops/attention.py 提供统一入口并内部按场景路由 Issue 或 PR

真机部署与端到端 Demo 共建

任务事项 任务说明 建议交付
边缘设备 + 机械臂端到端 Demo——LeRobot 系机型 基于 OrangePi AI Station / Atlas 边缘设备 + SO-100 / LeKiwi / Koch 等 LeRobot 兼容机械臂,以 Pi0 / Pi0.5 / ACT / DiffusionPolicy 任一已开源样例为策略模型,完成"摄像头采集 → NPU 推理 → 机械臂执行"端到端 demo,输出演示视频与复现指南 Issue 或 PR
边缘设备 + 足式机器人端到端 Demo 基于昇腾 Atlas 边缘设备 + 宇树 G1 / GO2 等主流足式机器人本体,以 locomotion/LQC 强化学习运动控制器为基础,完成 Sim2Real 部署 demo,输出复现指南、传感器接入说明与稳定性测试数据 Issue 或 PR
真机部署文档与配套脚本 整理真机部署所需的驱动安装、ROS / LeRobot 接入、相机标定、急停安全、延迟测量等通用步骤,沉淀为 docs/deployment/ 下的统一指南,避免每个 demo 重复说明 Issue 或 PR
仿真 → 真机迁移评估 选择 LIBERO / SimplerEnv 仿真任务上跑通的策略模型(如 SmolVLA、Pi0.5),分析其迁移到真机时的性能/精度差异,输出评估报告 Issue 或 PR

新模型样例适配

任务事项 任务说明 建议交付
新模型样例适配(RFC + PR) 结合当前 VLA、世界模型、足式控制等具身智能发展趋势,先通过 RFC(Issue 形式)描述模型价值、目标硬件、依赖框架、权重与 License 说明、计划目录结构、验证方式与预期交付时间,达成共识后提交完整样例 PR(含 README、代码、配置、精度/性能验证)。候选模型如 Lingbot-VA 等,具体范围由 RFC 阶段共同确认 RFC + PR

Issue / PR 提交建议

提交 Issue 或 PR 时,建议按场景包含以下信息,便于社区快速理解、定位与协同。

场景 建议说明内容
文档捉虫 问题文件、章节位置、当前描述、建议修改、是否愿意提交 PR
样例复现问题 硬件机型(Atlas A2 / A3 / 310P / OrangePi)、卡数、驱动 / CANN 版本、Python / PyTorch / torch-npu 版本、模型名称、操作步骤、配置修改、完整报错日志、实际输出与期望输出
优化手段使能(量化 / DiT-Cache / 公共算子) 目标模型、参考实现(如 VGGT INT8 / Hunyuan3D DiT-Cache)、改造范围、精度评估方式、性能对比方式、回退路径
真机部署样例共建 硬件平台(边缘设备 + 机器人本体型号)、策略模型、传感器与控制接口、复现步骤、演示视频或图像、安全注意事项
新模型 / 新样例共建 模型名称、模型价值、目标硬件、依赖框架、权重和 License 说明、计划目录结构、验证方式、预期交付时间
代码修复 PR 修复内容、影响范围、验证命令、验证结果、未覆盖风险
likedislike
zhangyi
zhangyi
5月19日 评论:

AMCT Pytorch 社区任务清单

本文档根据 amct/amct_pytorch 仓库当前结构整理,将社区任务按难度从低到高分为三类。开发者可以先从阅读代码和文档开始,通过 Issue 反馈问题。

推荐参与路径如下:

难易度 参与方式 适合人群 建议交付
低级任务 文档阅读、脚本规范审查与简单代码更改 首次参与社区贡献的开发者 Issue 或 PR
中级任务 中等难度代码更改、更多模型适配与算法效果测试 有昇腾环境或样例体验条件的开发者 Issue 或 PR
高级任务 性能优化、端到端样例以及算子测试与适配 熟悉模型推理、框架适配或算子优化的开发者 Issue 或 PR

低级任务

任务事项 任务方向 建议交付
验证/补齐 LLM 量化快速上手文档 面向首次接触 AMCT PyTorch 的开发者,整理从模型准备、校准数据、PTQ、评测到部署的最短使用路径 Issue 或 PR
为常见量化配置补充 YAML 使用样例 补充 amct_pytorch/configs/ 中常见 bit policy 的字段说明和典型使用场景,帮助开发者理解线性层、MoE、Attention、KV Cache 等量化目标 Issue 或 PR
新增算法注册机制教学样例 基于 algorithm_register 机制提供极简插件式算法样例,降低社区开发者二次开发自定义量化模块的门槛 Issue 或 PR
建立模型支持矩阵与验收记录 梳理当前 AMCT 已支持的模型族、量化算法、bit 配置和评测状态,帮助社区理解能力边界 Issue 或 PR

中级任务

任务事项 任务方向 建议交付
增加校准数据导出与复用样例 展示如何将一次 PTQ 流程中的校准数据导出,并复用到后续不同量化配置或算法对比中 Issue 或 PR
扩展 VLM 量化评测入口 完善 VLM eval 流程,支持图片输入、多模态 prompt 和基础评测结果输出 Issue 或 PR
补充 LWC/LAC/OmniQuant/AutoRound 对比实验脚本 帮助开发者在同一模型、校准集和评测集下比较不同 PTQ 算法效果 Issue 或 PR
为 BitPolicy 增加更多配置校验与错误提示 提升 YAML 配置错误、bit width 冲突、eval_mode 冲突等场景下的可诊断性 Issue 或 PR
增加量化模块单元测试 为 QuantLinear、QuantMatmul 等基础量化模块补齐最小测试,降低后续算法扩展风险 Issue 或 PR
优化 HiFloat8 CPU 扩展构建与测试体验 改善 experimental/hifloat8 的编译依赖检查、OpenMP 说明和跨平台构建体验 Issue 或 PR
新增 KV Cache 量化示例与评测说明 围绕大模型推理中的 KV Cache 显存占用,补充可运行的 attention cache 量化示例 Issue 或 PR

高级任务

任务事项 任务方向 建议交付
支持新的 HuggingFace LLM 模型适配 扩展 amct_pytorch/common/models/llm/ 的模型适配能力,让 AMCT 覆盖更多 HuggingFace CausalLM 架构 Issue 或 PR
为部署模型导出增加一致性检查 在量化模型导出后检查权重、scale、config、忽略层等信息是否一致,降低部署侧失败概率 Issue 或 PR
优化大模型逐层量化的显存/内存占用 针对更大模型优化权重加载、临时 tensor 生命周期、CPU/NPU 迁移策略和峰值占用记录 Issue 或 PR
增加 FlatQuant 端到端样例 为 experimental/flatquant 补充从配置、训练或校准到部署的完整示例,方便社区理解实验特性 Issue 或 PR
likedislike
kkodoo
kkodoo
5月20日 评论:

cann-recipes-train 社区任务清单

本文档面向外部社区开发者整理 cann-recipes-train 开源共建任务。开发者可以先从阅读代码、文档和训练配置开始,通过 Issue 反馈问题;也可以在集群或一站式平台中部署训练样例、复现训练流程;进一步还可以基于仓库已有训练框架、公共能力、模型样例和优化特性,贡献新的样例。

推荐参与路径如下:

阶段 参与方式 适合人群 建议交付
初级任务 阅读文档、脚本、配置和仓库规范,发现浅层错误并参与文档捉虫 首次参与社区贡献的开发者 Issue 或 PR
中级任务 部署并运行仓上训练样例,反馈复现、环境、数据和框架适配问题 有昇腾训练环境或样例体验条件的开发者 Issue 或 PR
进阶任务 基于已有训练框架、公共能力和样例结构补充未覆盖的模型、算法、特性或性能优化 熟悉大模型训练、强化学习、SFT、预训练、框架适配或分布式性能优化的开发者 Issue、设计说明或 PR

初级任务:文档捉虫与基础质量检查

本阶段希望开发者先通过阅读仓库文档、脚本和配置,查找低门槛、易验证的问题,例如错别字、链接失效、命令不一致、目录说明不完整、配置字段说明不清晰、依赖版本描述缺失、环境变量命名不统一等。建议优先通过 Issue 说明问题位置、现象和修改建议;如果可以直接修复,欢迎提交 PR。

任务事项 任务说明 建议交付
全仓链接、目录结构和术语检查 检查 README.md、docs/、llm_rl/、agent_rl/、multimodal_rl/、llm_sft/、llm_pretrain/ 等目录中的内部链接、外部链接、目录结构、模型名称、脚本名、配置名、并行和硬件型号是否准确统一 Issue 或 PR
训练脚本与 README 一致性检查 检查各模型目录下启动脚本、环境脚本、配置文件与 README 命令是否一致,重点关注模型路径、数据路径、输出路径、日志路径、环境变量、卡数配置和运行入口 Issue 或 PR
patch 命名、apply 流程和贡献文档一致性检查 在不实际运行训练的前提下,检查仓库中 patch 文件命名、存放目录、README apply 命令、脚本入口和贡献文档是否一致,重点关注命名是否表达patch实际功能点或修复目的,以及开发者是否能明确知道何时、在哪个目录、如何应用 patch Issue 或 PR
配置文件与说明文档一致性检查 检查训练配置中的 batch size、sequence length、rollout 配置、并行策略、reward等是否在 README 或 docs 中有清晰说明 Issue 或 PR
依赖与版本说明检查 检查 CANN、Python、PyTorch、torch-npu、verl、vLLM-Ascend等版本要求是否清晰,是否存在依赖缺失、版本冲突或安装顺序不清晰的问题 Issue 或 PR
训练术语统一检查 检查 GRPO、DAPO、RLVR、rollout、actor、critic、reference、reward model、agent loop、asyncLLM、SAM 投机推理、长序列、训练入图、AutoFuse 等术语在文档中的中文/英文表述是否一致 Issue 或 PR
License、数据和模型来源说明检查 检查模型权重、训练数据集、第三方框架、沙盒环境和外部脚本的来源、License、使用限制和免责声明是否清晰 Issue 或 PR

中级任务:训练样例部署、复现与环境体验反馈

本阶段希望开发者优先体验仓库中门槛较低的训练样例。考虑到外部开发者不一定具备完整昇腾训练集群,建议优先选择一站式平台快速启动路径、单卡样例或只需要少量配置改动的入门样例;如果暂时没有可运行环境,也可以从启动入口、默认参数、依赖安装、数据准备、日志说明和结果验证链路入手,反馈文档和脚本层面的可复现性问题。

提交体验类 Issue 时,建议尽量包含是否使用一站式平台、是否具备本地昇腾环境、硬件环境、卡数、驱动/CANN 版本、Python/PyTorch/torch-npu 版本、框架版本、模型名称、训练算法、操作步骤、配置修改、完整报错、日志片段、实际输出和期望输出;如果仅做文档或脚本检查,也可以说明尚未实际运行以及无法运行的原因。

任务事项 任务说明 建议交付
Qwen2.5 单卡强化学习入门样例复现 运行或静态检查基于 verl 的 Qwen2.5-1.5B-Instruct 强化学习入门样例,优先关注单卡 Atlas A2 环境下数据准备、依赖安装、启动命令、日志指标、checkpoint 和结果验证是否完整 Issue 或 PR
LLM SFT 单卡样例体验 选择 llm_sft 下适合单卡或入门体验的样例,检查数据格式、chat template、启动命令、checkpoint 保存等流程说明是否完整;没有运行环境时,可检查 README 是否明确标注操作流程和环境配置要求 Issue 或 PR
快速启动脚本参数检查 检查一站式平台或单卡样例中的启动脚本是否提供清晰的默认参数、模型路径、数据路径、输出路径、日志路径和可修改项,避免外部开发者第一次运行时需要大范围理解源码 Issue 或 PR
训练日志与结果说明检查 检查入门样例是否说明启动成功标志、关键日志字段、checkpoint 保存位置、异常退出排查方式和最小结果验证方式;没有运行环境时,可基于 README 和脚本做静态检查 Issue 或 PR

进阶任务:新模型样例、训练算法与框架能力扩展

本阶段希望开发者在已有能力基础上参与代码共建。仓库已经沉淀了 LLM RL、Agent RL、多模态、SFT、预训练等样例,社区开发者可以基于这些基础补充仓上未覆盖的模型训练代码、训练算法、优化特性和标准模板。

建议在提交新模型或新算法 PR 前先通过 Issue 描述模型价值、目标硬件、依赖框架、权重来源、数据来源、License 风险、复现步骤、性能目标和计划修改范围,便于社区讨论和协同。

任务事项 任务说明 建议交付
新 RL 模型训练样例适配 参考已有 DeepSeek、Qwen2.5、Qwen3 等样例,补充当前仓上未覆盖的 LLM RL 模型训练代码,提供 README、配置文件、启动脚本、依赖说明、数据准备、指标说明和基础验证方式 Issue 或 PR
新 Agent RL 样例适配 基于现有 tool agent RL、Code RL、Sandbox/ScaleBox 能力,补充新的 agentic RL 任务、工具调用任务、代码生成任务或多轮交互训练样例 Issue 或 PR
多模态训练样例扩展 补充多模态 RL、SFT 或预训练样例,覆盖图像、视频、OCR、文档理解或跨模态 reward 的数据准备、训练配置和验证流程 Issue 或 PR
框架版本升级与适配 围绕 verl、MindSpeed、vLLM-Ascend、torchtitan、Transformers、torch-npu 等框架,贡献版本升级、patch 收敛、兼容性修复、启动脚本统一和文档补齐方案 Issue 或 PR
现有样例缺陷修复 对已存在样例进行代码、脚本、配置或文档修复,提升可复现性、易用性、性能说明、错误提示、环境依赖、输入输出和训练结果说明质量 Issue 或 PR

Issue / PR 提交建议

场景 建议说明内容
文档捉虫 问题文件、章节位置、当前描述、建议修改、是否愿意提交 PR
patch 流程检查 patch 文件路径、当前命名、适配对象、README apply 步骤、执行目录、关联脚本、贡献文档位置、发现的不一致点和建议修改
样例复现问题 是否使用一站式平台、是否具备本地昇腾环境、硬件机型、卡数、驱动/CANN 版本、Python/PyTorch/torch-npu 版本、框架版本、模型名称、算法类型、操作步骤、配置修改、报错日志、期望结果
性能问题 硬件型号、卡数、模型规模、输入/输出长度、batch、并行策略、吞吐、显存、step time、rollout TPS、对比基线、性能瓶颈现象
分布式训练问题 节点数量、每节点卡数、rank table、HCCL 配置、网络配置、启动命令、超时或通信报错、可复现概率和日志片段
新模型共建 模型名称、模型价值、训练类型、目标硬件、依赖框架、权重和 License 说明、数据来源、计划目录结构、验证方式、预期交付
新算法或特性共建 算法/特性名称、适用场景、影响模块、配置变更、兼容性风险、验证计划、性能或效果目标
代码修复 PR 修复内容、影响范围、验证命令、验证结果、未覆盖风险
likedislike
chenhy
5月25日 评论:

参考VGGT和Pi0这两个已提供一站式平台支持的样例,利用一站式平台部署具身仓上已有的单卡推理样例(如Hy3D),转化为仓上的一站式平台可体验样例。
将部署时遇到的问题以Issue形式提出,相应的解决方案和最终的部署脚本、文档以PR形式提出。

likedislike
kkodoo
kkodoo
5月26日 评论:

【中级任务】

  1. 复现 qwen3 sft 一站式平台样例;
  2. 在此基础上修改数据集相关配置,参考ShareGPT数据集准备,将原有alpaca格式训练修改为shareGPT格式训练,支持Roleplay多轮对话训练;
  3. 需要提交完整训练日志,将复现训练过程时遇到的问题以issue形式提出,相应的解决方案、文档和新增数据集支持以PR形式提出。

【高级任务】

  1. 支持qwen3 模型DPO训练,参考指导文档Offline DPO。需要开发者提供数据处理脚本和训练启动脚本,需要提交完整训练日志和相关样例代码,将调试过程中遇到的问题以issue形式提出,相应的解决方案和训练样例以PR形式提出。
  2. 支持qwen3 模型SFT lora训练,参考指导文档LoRA 微调迁移开发。需要开发者提供LoRA微调脚本,LoRA推理脚本,LoRA权重与Base权重的合并与转换三个部分,需要提交完整训练日志和相关样例代码,将调试过程中遇到的问题以issue形式提出,相应的解决方案和训练样例以PR形式提出。
likedislike
zhangyi
zhangyi
5月26日 评论:
  1. 参考Amct_Pytorch中提供的Qwen3.6-MoE和DeepSeek-V4的一站式样例,利用云平台进行上述两个模型的推理、精度估计、量化等,将进行过程中遇到的问题以Issue形式提出,相应的解决方案和最终的部署脚本、文档以PR形式提出。
  2. 以上述一站式样例为基础,尝试不同的算法实现,不同算法实现过程中遇到的问题以Issue形式提出,算法流程优化等以PR的形式提出。
  3. 对已支持的模型,结合仓上已有量化算法,实现4bit下ppl在0.1以内的掉点,训练参数以及算法选择以Issue形式提出,文档以及一站式样例以PR形式提出。
likedislike
wang_zzp
wang_zzp
5月27日 评论:

infer仓具体任务:
1、HunyuanVideo 推理性能数据采集与特性收益分析:在单卡和多卡场景下,HunyuanVideo 从基础版本到逐步启用 NPU 推理优化特性的性能变化。开发者需要按照统一的测试配置,分别采集不同优化阶段的端到端耗时、吞吐、显存占用等指标,并记录每个特性带来的性能收益。
2、参考 SanaVideo 一站式平台样例,建设 Wan2.2 与 HunyuanVideo 多卡样例:希望社区开发者参考现有 SanaVideo 一站式平台样例,进一步补齐 Wan2.2 和 HunyuanVideo 的多卡推理样例,保证功能和精度正常。以PR形式合入。

likedislike
tianjyoi
tianjyoi
5月27日 评论:

infer-LLM:
1、将Qwen3.6-27B模型(https://huggingface.co/Qwen/Qwen3.6-27B)部署在框架上,可以参考现有的Qwen3.5模型样例,使用现有的迁移skill,利用云平台进行Qwen3.6-27B模型的推理部署和进行性能优化:
(1)必做:Qwen3.6-27B 在单卡环境的单算子模式下推理功能正常,精度正常;
(2)必做:对该模型进行性能优化:利用npugraph_ex 加速模型推理,保证功能和精度正常;
(3)【选做】:继续对该模型增加性能优化,例如:多流、量化、接入更多融合算子等多种推理加速方法;
参考仓库中其他模型,开发者提供代码脚本和启动脚本,需要提交完整推理日志和性能数据,性能数据中需要写出每个优化点的优化时延;将调试过程中遇到的问题以issue形式提出,相应的解决方案和训练样例以PR形式提出。

likedislike