Pull Request已成功合入, 合并人@ascend-robot
(感谢 孟广欣 的贡献)变更摘要
本次 PR 主要针对 TTFHW 能力的资料文档进行修订,在环境安装和编译过程相关文档中增加约束性语言描述,以指导 AI 能够稳定、可重复地执行操作步骤,满足产品线对 TTFHW 能力上线的要求。修改整体为文档类变更(doc),涉及 3 个文件,净删除 47 行。
主要改动
- 增加 AI 执行约束性语言:在 TTFHW 相关文档的环境安装和编译流程中,补充了约束性描述语句,使 AI 在执行时能够遵循明确的步骤和边界条件,减少歧义和不确定性。
- 精简和替换旧有描述:删除了原有文档中缺乏约束力或不够精确的指导内容(删除 155 行),替换为更结构化、更具操作性的约束性说明(新增 108 行)。
- 文档内容重组:对 3 个受影响的文档文件进行了内容调整,使整体指导逻辑更加清晰,便于 AI 稳定解析和执行。


代码审查
审查总结
共审查 3 个变更文件,发现 3 个问题,均为 P3 级别。
| 文件 | 审查结果 |
|---|---|
README.md |
✅ 已审查 — 1 个 P3 问题(Prometheus 安全提示在重构中丢失) |
docs/zh/developer_guide/development_guide.md |
✅ 已审查 — 无问题(变更仅为精简环境配置章节、指向统一安装指南,逻辑清晰、无安全风险) |
docs/zh/msserviceprofiler_install_guide.md |
✅ 已审查 — 2 个 P3 问题(与开发指南和英文安装指南的构建方法不一致) |
发现汇总
- P3 × 3:
- README 重构时 Prometheus/Grafana 第三方软件安全提示被移除(README.md:37)
- zh 安装指南改用
python3 build.py,但 zh 开发指南仍使用build_and_upgrade.sh(安装指南:51) - zh 安装指南改用
python3 build.py,但 en 安装指南未同步(安装指南:51)
整体风险评估:低
本 PR 的核心目的是在文档中增加约束性语言以指导 AI 稳定执行 TTFHW 流程。变更内容均为文档结构调整、章节重组和约束指令添加,不涉及代码逻辑、安全漏洞或构建配置变更。未发现 chmod 777、禁用 TLS、硬编码密钥等危险操作指令。发现的问题均为文档一致性层面的 P3 级别,不构成安全或正确性风险。
⚠️ 已识别出整体风险,但无法提取行内评论,请参考整体评估。


Thanks for your pull-request.
The full list of commands accepted by me can be found at here。
You can get sig-info at here
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| repo-Ascend/msserviceprofiler | ✅ 陈豪, 谢作孟 (2/2) | ✅ 陈豪 (1/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
mengguangxin, thanks for your pull request. All authors of the commits have signed the CLA. 👍


ascend docs pipeline is running...


ascend docs pipeline is running...


compile


ascend docs pipeline is running...


| 阶段 | 任务名 | 状态 | 详情 |
|---|---|---|---|
| 编译构建 | Build_msserviceprofiler_arm | 🛑 | >>> |
| Build_msserviceprofiler_x86 | 🛑 | >>> | |
| Docs_msserviceprofiler | 🛑 | >>> | |
| 恶意代码检查 | Antipoison_msserviceprofiler | 🛑 | >>> |
| 编码安全与规范检查 | codecheck_pre-commit | 🛑 | >>> |
| pre-commit | 🛑 | >>> | |
| 开源片段检查 | SCA_msserviceprofiler | 🛑 | >>> |
| 开发者测试 | UT_msserviceprofiler | 🛑 | >>> |
| 流水线 | PR-pipeline_msserviceprofiler | ✅ | >>> |
- compile : 运行流水线
- retry : 重试流水线所有失败子任务
- retry <任务名> : 仅重试指定失败子任务
- stop : 停止流水线


/approve


1. 修改描述
2. 功能验证
3. 代码检视
4. 资料修改自检