Star112
107
代码
代码
Issues12
Pull Requests22
Actions
项目讨论
Wiki
分析
Star112
107
已开启
[Doc]: 安装部署工具优化 #126
yangpeng197创建于  4月27日
Y
yangpeng197成员
4月27日 创建

在提交新问题之前，请确保您已经在社区中搜索过相关问题，并使用了社区中提供的资源/工具后，仍未找到满意的解决方式。

📚 文档问题描述

建议的替代/修复方案

一、任务交付件
基于开放仓库MindCluster-AscendDeployer代码进行功能扩展，主要开发点如下：
（1）根据指导文档体验安装部署工具，可从资料易用性、可靠性、可维护性及性能等，提出2个改进issue
（2）提交一个pr修复1个改进issue
二、验收标准：
任务完成标准：
（1）提出2个改进issue，可易用性、可靠性、可维护性及性能
（2）合入代码PR、资料、设计文档、测试报告
设计文档参考：https://docs.qq.com/doc/DS3FOVnZXZ2JpTnNQ
测试报告参考：https://docs.qq.com/doc/DS1hpcmdKYXFRekFU

欢迎加入社区，感谢您对社区的贡献 🎉!

likedislike
Yyangpeng197成员
4月27日 添加了label：document
Y
yangpeng197成员
4月27日 评论：

/label add good-first-issue

likedislike
ascend-robotascend-robot成员
4月27日 添加了label：good-first-issue
X
xuchuan成员
4月27日 评论：

/label add triaged

likedislike
ascend-robotascend-robot成员
4月27日 添加了label：triaged
Wu,Qiang-RoyWu,Qiang-Roy成员
4月27日 issue状态由 TODO 改变为 Analysing
Yyangpeng197成员
4月29日 修改标题为 “[Doc]: 安装部署工具优化”，原标题为“[Doc]: 体验安装部署工具”
肾炝喜鲤
肾炝喜鲤
6月27日 评论：

认领这个任务 #126

likedislike
肾炝喜鲤
肾炝喜鲤
6月28日 评论：

已按 #126 任务要求提交改进 issue：#193、#194、#195。

likedislike
NightVoyager
NightVoyager
7月1日 评论：

认领这个任务

likedislike
swagglian
swagglian成员
7月2日 评论：

认领这个任务

likedislike
肾炝喜鲤
肾炝喜鲤
7月7日 评论：
ascend-robotascend-robot成员
7月7日 关联了看板：MindStudio ISSUE管理
X
xuchuan成员
7月16日 评论：

@yangpeng197 您好，新提交了改进issue及PR：
#204：https://gitcode.com/Ascend/ascend-deployer/pull/2220
#205：https://gitcode.com/Ascend/ascend-deployer/pull/2219。

@weixin_40758092

你好，请参考社区任务池，加入社区任务微信群，并将名称修改为gitcode用户名。
加入社区任务微信群后请@许川，预约代码检视时间，请按照社区任务要求，提前准备好交付件

likedislike
肾炝喜鲤
肾炝喜鲤
7月21日 评论：

@xuchuan 您好，#126 当前已完成以下交付：

对应提交了以下修复 PR：

两个 PR 均已同步最新 dev，CLA、主 CI 和文档 CI 均已通过，目前处于 open、可合入状态，尚待人工 lgtm/approve。烦请负责人确认以上 Issue 是否可作为 #126 的最终验收材料，谢谢～

likedislike
肾炝喜鲤
肾炝喜鲤
8月13日 评论：

Issue #126 交付说明

负责人您好，Issue #126 的体验检视覆盖 README 获取入口、安装帮助、在线发布包和源码构建四条用户路径。
任务要求至少提交 2 个改进 Issue，本次共形成 5 个独立 Issue：#193、#194、#195、#204、#205，分别保留问题现象、影响、建议和验证边界。
汇报内容如下：

任务背景

实际体验从文档入口开始，经过帮助命令、在线安装和下载，再进入源码 sdist/wheel 构建。
设计按问题性质分层：资料问题直接修正入口和支持范围；运行时副作用先复现并提出最小解耦方案；发布包和权限问题形成可回归的代码候选。
每项结论都区分 Issue 状态、PR 状态、CI 门禁、合入、公开发布和父任务检视，避免把前一状态当作后一状态。

总体设计思路

  1. 以真实用户路径建立问题边界，先确认可复现现象，再决定资料修正、建议设计或最小代码改动。
  2. 以 #193/#194 的资料闭环、#195 的副作用复现、#204 的撤回决定和 #205 的已合入修复组成分层交付，不把未实现或已退出方案写成有效修复。
  3. 对代码候选同时保留正向、负向、构建、安装后和回归证据，并用 A/B 对照识别真正的修复边界。
  4. 对外只报告当前线上可回读状态和本地报告的固定执行基线；硬件部署、新版本发布和维护者决定均列为外部边界。

主要交付与改动

#193 / #194：资料问题

  • #193 处理 README 获取方式入口，将易失效锚点改为稳定的安装文档文件链接；线上状态为 closed、DONE、resolved。
  • #194 明确 Python 支持范围为 3.6 至 3.12；这是资料约束完善，不代表 Python 3.14 已适配；线上状态为 closed、DONE、resolved。
  • 两项均属于资料交付，没有新增代码 PR；验收应核对目标文件可达、支持范围表述和父任务关联关系。

#195：帮助路径提前初始化

  • 复现表明 Python 3.10 执行 start_deploy.py -h 虽退出 0，仍会生成 parsed_inventory_file；Python 3.14 在帮助输出前触发配置写入异常并退出。
  • 建议将参数解析置于部署模块导入之前，仅在安装、升级或检查动作中延迟创建部署对象，保持实际部署动作原流程。
  • 该 Issue 当前为 open、Analysing、无对应 PR；本次交付是复现与设计建议，不能称为已实现或已修复。

#204 / PR !2220：发布包能力一致性

经与负责人沟通确认，#204 所提改动没有必要，Issue #204 与 PR !2220 后续一并关闭，不再作为 #126 的待评审代码交付。

#205 / PR !2219：脚本权限保持

  • 生产 setup.py 现在保存平台实际原始 mode，转换前临时增加 owner-write，并在 finally 中恢复原 mode，避免把脚本覆盖成 0200。
  • 回归测试按平台实际 mode 比较转换前后权限；POSIX 额外要求 0550，Windows 不错误要求 execute 或 group 位。
  • !2219 已于 2026-08-06 合入，最终 head 为 9bffcc297b5737ade2e0f8f36b46e3da52266693，已具备 approve/lgtm，CLA、文档和 CI 门禁为绿色。
  • Issue #205 线上仍为 open、Analysing；此处准确表述为 PR 已合入的权限修复，不代替 Issue 或父任务的外部决定。

验证证据

  • 固定本地执行基线为 2026-07-21 的 dev@bcf91984，环境为 macOS arm64、Python 3.8/3.10/3.14；完整命令、退出码和限制见测试报告。
  • #193/#194 已检查 README 目标文件存在及支持范围文本；#195 保留 Python 3.10 写文件和 Python 3.14 提前异常两条负向证据。
  • !2219 的修复前构建失败、修复后目标测试和 sdist/wheel 构建通过，并检查源码、sdist、wheel 的权限保持；Python 3.6 仅做语法检查，不计作真机运行验证。

当前状态与边界

  • #126 仍为 open、Analysing，尚无公开的验收决定或赏金结算凭证；请基于附件逐项决定后续验收范围。
  • #193/#194 是资料问题并已 closed、DONE、resolved；#195 仍 open、Analysing 且没有修复 PR。
  • !2219 已合入并完成其权限修复，但 Issue #205 和父任务状态仍应分别回读，不能由 PR 合入推断父任务结果。
  • 本材料未执行真实 NPU/CANN 集群部署、Python 3.6 真机运行或 #195 修复后回归。
  • 以上限制不影响五项 Issue 的提交数量核验；最终有效交付范围和父任务结果仍需维护者确认。

设计文档

8b2802f3dc75496eb9afa198ce974043.md

用户手册

dbedc644abd446ecbfd0ac24ec668d2b.md

测试报告

20d7b7c594f64518819467c6f798c090.md

likedislike
Yyangpeng197成员
9月1日 修改了issue 的描述
肾炝喜鲤
肾炝喜鲤
9月6日 评论：

@coobeam 负责人您好，我根据 Issue #126 最新补充的交付要求，重新整理并补交设计文档和测试验证报告，请您检视。

  • #193、#194 为资料易用性和版本范围问题；
  • #195 记录了帮助命令提前初始化的复现结果与改进建议；
  • #204 对应的 !2220 经沟通确认改动没有必要，Issue 和 PR 均已关闭，不再作为代码交付；
  • #205 对应的有效权限修复 !2219 已合入。

本次两份附件均按照 Issue 指定的新模板重做，同时保留了原有详细材料中的问题分析、设计取舍、历史执行记录、权限回归、发布差异和未执行边界。报告中也明确区分了“PR 已合入”“当前未重跑”“Windows 真机未执行”和“公开版本待发布”等不同状态，没有将本地材料完成等同于父任务验收。

附件：

likedislike
Xxuchuan成员
22 天前 关联了里程碑：MindCluster 26.3.0