CLA协议签署
当前Pull Request的提交暂无外部代码贡献者合并受阻
PR创建成功通知 | 感谢您的贡献 🎉
您好!系统已检测到您成功创建 Pull Request(PR),感谢您对项目的支持与参与!以下几点需要您着重关注:
一、PR必须关联Issue ❗️
触发门禁检查的必要步骤:在PR描述框输入Issue完整链接,完成Issue关联。
请注意,一个 Issue 不能同时关联同一 base 仓库内同一个分支的多个开启状态的 PR
二、门禁触发规则 🔧
- 门禁类型判定:由Issue关联的PR所属代码仓数量决定
- 关联多个代码仓PR:触发「多仓联合门禁」
- 关联单个代码仓PR:触发「单仓门禁」
- 启动指令与检查范围:需主动回复指令:
- 回复 "start build":执行Cangjie的主要基础检查,包含commit格式检查、静态告警分析、OAT开源声明检查、多平台构建、单元/集成测试等
- 关联同一issue的多个PR,仅需在任意一个PR里回复触发一次门禁,该PR门禁通过后,所有PR都会添加Label和测试人
- 每个pr只能同时运行一条CI流水线,如需重新启动,请先关闭运行中的,再评论触发门禁
- Markdown修改仅触发文档类构建测试门禁,不会触发Cangjie的编译测试门禁
- commit 信息格式请遵循:Conventional Commits 规范
- 请保证每一条 commit 都已添加
Signed-Off-By信息 - 回复 "start build cov":执行覆盖率构建工程,生成该提交的增量代码覆盖率报告
三、合入条件 ⚠️
- 满足最低评审人数,且评审问题需全部解决;
- 禁止合入本人创建的PR,需由其他协作者操作;
- 合并前确保关联流水线任务运行成功(build-test-passed);
- 需求类覆盖率门禁:当关联的 Issue 标题以
[feature]:开头(需求类 Issue)时,联合提交中属于cangjie_compiler、cangjie_runtime、cangjie_stdx、cangjie_tools、llvm-project仓库的 PR,必须先回复 "start build cov" 触发增量覆盖率流水线并通过,使 PR 获得cov-test-passed标签后方可合入。
四、合并PR ✅
回复 "start merge",CI流水线会自动检查所有关联PR的状态、版本号标签、检视意见密度、兼容性、需求类覆盖率门禁,若所有PR都满足合并条件,则将会同时合并所有PR。若存在不满足合并条件的PR,则不会合并任何PR。
如果希望不进行兼容性相关的检测,请任一合法审查人复制以下内容,在 start merge 前提交评论:
本 pr 不需要兼容性相关检测,对于引发的任何兼容性问题(即由于本 pr 合入将导致用户需适配代码的话),由本人承担。
If you wish to avoid compatibility-related checks, please have any approver copy the following content and submit it as a comment before sending start merge:
This PR does not require compatibility-related checks. For any compatibility issues caused by this PR (i.e., if the integration of this PR will require users to adapt their code), I will take full responsibility.
五、补充说明 📢
- 详细仓颉贡献流程:贡献流程(Cangjie Community Contribution)
- 门禁结果将自动评论至关联的所有PR,敬请留意。


start build


🔨 构建/测试门禁流水线
已启动,正在后台运行中,您可以点击构建/测试门禁详情查看运行状态。
构建/测试门禁执行流程:
graph LR
A[PR检测] --> B[联合构建]
B[联合构建] --> C[测试运行]
检查内容包括
- commitlint检查
- 构建任务
- linux x64、mac aarch64、windows x64
- 测试任务
- UT、HLT、LLT
构建/测试门禁产物归档路径: obs://cangjie103/CangjieDaily/pub/ci/gate/main/cangjie_tools/1272


start merge


⏳ 正在进行兼容性检测中,可能需要2~3分钟,请稍候,若10分钟无检测结果,请重新回复 start merge。
⏳ Compatibility check in progress. It may take 2–3 minutes. Please wait. If there is no result after 10 minutes, please reply with start merge again.


✅ 合入前兼容性检测通过。
涉及仓库:Cangjie/cangjie_tools
结论
- 分析过程:分析了 Cangjie/cangjie_tools#1272。该 PR 仅修改
cjtrace-recover/doc/developer_guide_zh.md,把重复出现的二级标题‘安装和使用指导’去掉一处,文档结构更整洁,但没有引入新的章节、链接、参数、命令或流程。The change stays within the Chinese developer guide and only removes a duplicated heading, so the documented installation and usage workflow itself remains the same. - 原因:这次变更只是在
cjtrace-recover/doc/developer_guide_zh.md内整理标题层级,没有改动源码、公开 API、构建/安装入口、配置项或用户流程;原有文档内容和使用指引仍然有效,只是重复标题被消除,因此不构成兼容性破坏。The PR only cleans up heading structure incjtrace-recover/doc/developer_guide_zh.md; it does not change source code, public APIs, build or install entry points, config keys, or user workflows. The existing guidance remains valid, with only the duplicate heading removed, so there is no compatibility break. - 结论:兼容


⚠️ 合入前检查失败:带有 "bug" label 的 issue 必须包含问题发现的版本号 label(语义化版本号,如 1.2.3)。
以下 issue 缺少版本号 label:
- Issue #685: [Bug]: 修改文字
请为相关 issue 添加版本号 label 后重新触发合入。
⚠️ Merge check failed: issues with "bug" label must have the version label of the problem found (semantic version, e.g., 1.2.3).
The following issues are missing version labels:
- Issue #685: [Bug]: 修改文字
Please add version labels to the related issues and retry the merge.


问题描述、修改计划、影响范围
问题描述:
cjtrace‑recover/doc/developer_guide_zh.md文件第26、27行存在标题重复问题,## 安装和使用指导标题连续出现两次,文档层级冗余。修改计划:删除第27行重复的
## 安装和使用指导标题,仅保留一处该二级标题,保证文档标题层级规范。影响范围:仅修改该中文开发者指南文档,无代码逻辑变更,仅优化文档排版结构。