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 |


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 | 修复内容、影响范围、验证命令、验证结果、未覆盖风险 |


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 | 修复内容、影响范围、验证命令、验证结果、未覆盖风险 |


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 |


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 | 修复内容、影响范围、验证命令、验证结果、未覆盖风险 |


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


【中级任务】
- 复现 qwen3 sft 一站式平台样例;
- 在此基础上修改数据集相关配置,参考ShareGPT数据集准备,将原有alpaca格式训练修改为shareGPT格式训练,支持Roleplay多轮对话训练;
- 需要提交完整训练日志,将复现训练过程时遇到的问题以issue形式提出,相应的解决方案、文档和新增数据集支持以PR形式提出。
【高级任务】
- 支持qwen3 模型DPO训练,参考指导文档Offline DPO。需要开发者提供数据处理脚本和训练启动脚本,需要提交完整训练日志和相关样例代码,将调试过程中遇到的问题以issue形式提出,相应的解决方案和训练样例以PR形式提出。
- 支持qwen3 模型SFT lora训练,参考指导文档LoRA 微调迁移开发。需要开发者提供LoRA微调脚本,LoRA推理脚本,LoRA权重与Base权重的合并与转换三个部分,需要提交完整训练日志和相关样例代码,将调试过程中遇到的问题以issue形式提出,相应的解决方案和训练样例以PR形式提出。


- 参考Amct_Pytorch中提供的Qwen3.6-MoE和DeepSeek-V4的一站式样例,利用云平台进行上述两个模型的推理、精度估计、量化等,将进行过程中遇到的问题以Issue形式提出,相应的解决方案和最终的部署脚本、文档以PR形式提出。
- 以上述一站式样例为基础,尝试不同的算法实现,不同算法实现过程中遇到的问题以Issue形式提出,算法流程优化等以PR的形式提出。
- 对已支持的模型,结合仓上已有量化算法,实现4bit下ppl在0.1以内的掉点,训练参数以及算法选择以Issue形式提出,文档以及一站式样例以PR形式提出。


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


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形式提出。


CANN Recipes 三仓社区任务设计
任务主题
CANN Recipes 三仓体验共建计划:文档捉虫 / 代码捉虫 / 一站式平台样例体验
任务背景
CANN Recipes 系列仓库面向开发者提供基于 CANN 平台的典型模型、算法和优化实践样例,覆盖推理、训练、具身智能等场景:
为了提升仓库文档质量、代码可用性和样例体验完整度,现面向社区发起三类共建任务,欢迎开发者参与体验、反馈和贡献。
任务方向
方向一:文档捉虫任务
参与者可选择任意一个或多个仓库,对 README、样例说明、环境准备、启动脚本说明、FAQ、贡献指南等文档进行体验和检查。
可反馈的问题包括但不限于:
交付方式:
方向二:代码捉虫任务
参与者可选择任意仓库中的样例代码、脚本、patch、配置文件或 CI 检查逻辑进行阅读、运行和排查。
可反馈的问题包括但不限于:
交付方式:
方向三:一站式平台样例体验任务
参与者可基于一站式平台提供的 NPU 环境,选择三仓中的样例进行端到端体验,并反馈体验问题。
建议优先体验方向:
cann-recipes-infer:LLM / 多模态模型推理样例,关注模型加载、推理启动、性能参数、输出结果。cann-recipes-train:SFT、RL、预训练等训练样例,关注环境准备、数据准备、启动脚本、日志输出、训练结果。cann-recipes-embodied-ai:具身智能相关模型或算法样例,关注样例链路、输入输出、部署步骤和可复现性。体验反馈建议包含:
参与方式
任务认领
在任务讨论下方评论认领任务,格式如下:
任务执行
任务交付
在任务讨论下方回复交付链接,格式如下:
验收标准
有效 Issue 标准
有效 PR 标准
一站式平台体验报告标准
评分机制
本次任务采用积分制,鼓励开发者不仅发现问题,也推动问题修复和经验沉淀。原则上,同类问题中,提交可合入 PR 的贡献高于仅提交 Issue。
计分规则
重点代码问题双倍积分机制
为鼓励开发者发现并修复影响样例可用性、正确性和性能体验的关键问题,本次任务设置“重点代码问题”双倍积分机制。
重点代码问题范围
重点代码问题包括但不限于:
认定方式
双倍积分规则
推荐激励导向
推荐选题
cann-recipes-infer推理样例 README 可复现性检查。cann-recipes-infer模型推理脚本参数与文档一致性检查。cann-recipes-trainSFT / RL 样例一站式平台快速启动体验。cann-recipes-trainpatch 命名、apply 流程和贡献文档一致性检查。cann-recipes-embodied-ai具身智能样例环境准备与启动流程检查。奖励说明