更新底层参数修改规则
This commit is contained in:
1 parent
30565e222a
commit
982171299a
5 files changed
+75
-40
No files matched your search
+28
-10
@@ -1,4 +1,4 @@
|
||||
# 应用层与底层边界
|
||||
# 应用层与底层修改边界
|
||||
|
||||
文件、字段或脚本可能影响硬件和底层固件时,按本说明判断。
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
|
||||
应用组负责上述工作,但只执行当前需求明确要求的内容。外部操作必须先单独确认。
|
||||
|
||||
## 应用组不得修改
|
||||
## 默认不修改的内容
|
||||
|
||||
- `psp/` 目录、`psp.json` 及其他 PSP 配置。
|
||||
- BSP、Bootloader、内核、内核模块和驱动。
|
||||
@@ -22,23 +22,41 @@
|
||||
- GPIO/PQ、传感器初始化、ISP、底层媒体实现和硬件编解码。
|
||||
- 电机电气控制、Wi-Fi 驱动选择和其他硬件初始化。
|
||||
|
||||
可以读取和使用已有底层文件或产物,但不能修改它们。复制、链接、打包已有底层产物,也不代表可以编辑它们。
|
||||
默认可以读取、检查和使用已有底层文件或产物,但不主动修改。复制、链接、打包已有底层产物,也不代表可以编辑它们。
|
||||
|
||||
## 明确指定后可以修改
|
||||
|
||||
用户明确说出要修改的底层类型或目标时,可以执行对应修改,包括 PSP、BSP、Bootloader、内核、驱动、设备树、分区、GPIO/PQ、传感器配置、底层媒体和硬件初始化。
|
||||
|
||||
执行要求:
|
||||
|
||||
1. 将底层修改列入任务清单。
|
||||
2. 查找具体文件、字段、当前值和影响。
|
||||
3. 目标值或做法不明确时,列出确认项。
|
||||
4. 给出简短实现方案,用户确认后修改。
|
||||
5. 只修改确认范围。需要增加关联文件时,先说明原因并等待确认。
|
||||
6. 修改后检查 Git 差异,并运行项目已有的配置校验。
|
||||
7. 编译和打包按任务要求执行。生成 Bootloader、内核、驱动或底层镜像前单独确认。
|
||||
|
||||
用户确认普通应用任务不等于允许修改底层。普通应用需求涉及底层依赖时,先列出需要修改的内容和影响。
|
||||
|
||||
## 混合配置
|
||||
|
||||
PSP 文件整份都不属于应用组修改范围,即使其中某个字段看起来与应用有关,也不能直接修改。
|
||||
PSP 文件默认不修改。用户明确要求修改 PSP 时,可以按已确认的任务和方案修改相应字段。
|
||||
|
||||
其他产品清单、镜像清单、传感器配置、GPIO/PQ 参数和驱动映射也可能同时包含应用和底层内容。只有项目资料明确说明由应用组维护时,才能修改其中的应用字段。
|
||||
其他产品清单、镜像清单、传感器配置、GPIO/PQ 参数和驱动映射也可能同时包含应用和底层内容。没有明确底层修改要求时,只修改项目资料明确由应用维护的字段。
|
||||
|
||||
无法确认归属时:
|
||||
没有底层修改要求且无法确认归属时:
|
||||
|
||||
1. 先按底层内容处理。
|
||||
2. 保持文件不变。
|
||||
3. 列出需要底层处理的内容及其影响。
|
||||
3. 列出需要修改的内容及其影响。
|
||||
|
||||
## 底层未处理内容
|
||||
用户已经明确指定该类底层修改时,先查找归属和具体位置;仍无法确认时列出确认项,不猜测修改。
|
||||
|
||||
发现需要底层修改时,只输出必要信息:
|
||||
## 未明确要求的底层内容
|
||||
|
||||
应用开发中发现需要底层修改,但用户没有明确要求修改时,只输出必要信息:
|
||||
|
||||
- 相关应用任务。
|
||||
- 需要处理的底层文件、模块或能力。
|
||||
@@ -46,7 +64,7 @@ PSP 文件整份都不属于应用组修改范围,即使其中某个字段看
|
||||
- 需要达到的结果。
|
||||
- 对应用代码、编译或联调的影响。
|
||||
|
||||
不建立中心转交或跟踪流程。能独立完成的应用代码继续完成;依赖底层的部分标记为“底层未处理”。
|
||||
不建立中心转交或跟踪流程。能独立完成的应用代码继续完成;依赖底层的部分标记为“底层未处理”。用户后来明确要求修改时,再将其加入任务清单并确认方案。
|
||||
|
||||
## 禁止假实现
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
```markdown
|
||||
| 任务 | 修改范围 | 状态 |
|
||||
|---|---|---|
|
||||
| T1 - <名称> | <应用模块和文件> | 待确认 |
|
||||
| T1 - <名称> | <应用模块、应用配置或明确指定的底层文件> | 待确认 |
|
||||
```
|
||||
|
||||
状态只使用必要的普通中文:
|
||||
@@ -34,14 +34,14 @@
|
||||
- 用户已确认
|
||||
- 受阻
|
||||
|
||||
底层修改不放入应用开发任务。需要说明时,单独使用“底层未处理内容”。
|
||||
用户明确指定的底层修改放入任务清单。没有明确要求修改的底层依赖,单独使用“底层未处理内容”。
|
||||
|
||||
## 当前任务方案
|
||||
|
||||
```markdown
|
||||
任务:T1 - <名称>
|
||||
|
||||
实现方案:<准备怎样修改应用代码>
|
||||
实现方案:<准备怎样修改应用代码、应用配置或明确指定的底层内容>
|
||||
```
|
||||
|
||||
方案保持简短。用户确认后才能开发。
|
||||
@@ -58,7 +58,7 @@
|
||||
- 影响:<哪些应用代码、编译、打包或联调暂时不能完成>
|
||||
```
|
||||
|
||||
只列事实和影响,不建立中心转交、跟踪或替代流程。
|
||||
只列事实和影响,不建立中心转交、跟踪或替代流程。用户明确要求修改后,将对应内容加入任务清单并确认方案。
|
||||
|
||||
## 完成报告
|
||||
|
||||
@@ -67,7 +67,7 @@
|
||||
状态:<代码已完成、底层未处理、等待用户测试等>
|
||||
|
||||
代码修改:
|
||||
- <修改的应用文件和逻辑>
|
||||
- <修改的应用文件、应用配置、明确指定的底层文件和逻辑>
|
||||
|
||||
中文注释:
|
||||
- <关键逻辑的注释位置,或说明本次没有需要补充注释的复杂逻辑>
|
||||
@@ -83,6 +83,9 @@ Git 差异:
|
||||
底层未处理:
|
||||
- <内容和影响,或“无”>
|
||||
|
||||
已执行的底层修改:
|
||||
- <文件、字段和结果,或“无”>
|
||||
|
||||
等待用户处理:
|
||||
- <功能测试、样机测试、平台确认或其他工作>
|
||||
```
|
||||
|
||||
+18
-9
@@ -19,7 +19,8 @@
|
||||
|
||||
- 阅读当前需求、规格说明、功能清单、工程说明、构建脚本和相关代码。
|
||||
- 参考工程只用于了解做法,不能直接代替目标工程的要求。
|
||||
- 找出本次需要修改的应用模块,以及可能依赖的底层内容。
|
||||
- 找出本次需要修改的应用模块、用户明确指定的底层内容,以及可能存在但尚未要求修改的底层依赖。
|
||||
- 默认不把 PSP 或其他底层文件作为固定检查项。判断应用影响或定位明确指定的底层修改时,可以主动读取和检查。
|
||||
- 查看 Git 状态,不修改任何文件。
|
||||
|
||||
需求冲突时,默认顺序是:
|
||||
@@ -58,8 +59,8 @@
|
||||
## 4. 确认任务清单
|
||||
|
||||
- 任务清单只列任务名称、修改范围和状态。
|
||||
- 只包含当前需求明确分配给应用组的工作。
|
||||
- 底层内容不作为应用开发任务,只在“底层未处理内容”中说明。
|
||||
- 只包含当前需求明确要求的工作。
|
||||
- 用户明确指定的底层修改作为开发任务。没有明确要求修改的底层依赖只在“底层未处理内容”中说明。
|
||||
- 在对话中展示完整清单并等待用户确认。
|
||||
- 默认不创建流程文档。用户明确要求时才写入项目。
|
||||
|
||||
@@ -69,12 +70,12 @@
|
||||
|
||||
1. 给出简短实现方案并等待用户确认。
|
||||
2. 再次检查 Git 状态和应用层边界。
|
||||
3. 只修改已确认范围内的应用代码或应用配置。
|
||||
3. 只修改已确认范围内的应用代码、应用配置或明确指定的底层内容。
|
||||
4. 关键逻辑添加必要的中文注释。
|
||||
5. 不新增、不修改、不执行单元测试。
|
||||
6. 不使用 Mock、Stub、假数据、假成功、临时兜底或绕行流程补齐缺失功能。
|
||||
7. 可以执行编译、语法检查和项目已有的静态检查。确认退出结果和实际输出,不能只看“成功”字样。
|
||||
8. 当前任务明确要求打包或产物检查时,可以执行对应命令。
|
||||
8. 当前任务明确要求打包或产物检查时,可以执行对应命令。生成 Bootloader、内核、驱动或底层镜像前必须另行确认。
|
||||
9. 再次检查 Git 状态和差异,确认中间文件已被忽略。不得暂存或提交。
|
||||
10. 用简洁中文汇报结果,等待用户确认和测试。
|
||||
|
||||
@@ -82,16 +83,23 @@
|
||||
|
||||
## 6. 底层内容
|
||||
|
||||
发现 PSP、BSP、Bootloader、内核、驱动、设备树、分区、GPIO/PQ、传感器底层配置、底层媒体或硬件初始化需要修改时:
|
||||
默认以应用层为主。发现 PSP、BSP、Bootloader、内核、驱动、设备树、分区、GPIO/PQ、传感器配置、底层媒体或硬件初始化需要修改,但用户没有明确要求时:
|
||||
|
||||
1. 不修改、不重新生成,也不做试验性改动。
|
||||
2. 列出需要底层处理的内容、原因和对应用代码的影响。
|
||||
1. 保持底层文件不变。
|
||||
2. 列出需要修改的内容、原因和对应用代码的影响。
|
||||
3. 能独立完成的应用代码继续完成。
|
||||
4. 依赖底层的部分标记为“底层未处理”。
|
||||
5. 不写假接口、替代逻辑或临时流程。
|
||||
6. 不建立中心转交或跟踪步骤。
|
||||
|
||||
底层内容以后准备好时,应用组负责按当前需求完成应用侧接入、编译、打包、联调和后续工作,但仍不修改底层文件。
|
||||
用户明确说出要修改的底层类型或目标时:
|
||||
|
||||
1. 将修改加入任务清单并确认。
|
||||
2. 查找具体文件、字段、当前值和影响;不明确的内容集中询问。
|
||||
3. 给出简短实现方案并等待确认。
|
||||
4. 只修改确认范围。需要增加关联文件时,先说明文件、原因和影响并等待确认。
|
||||
5. 修改后检查 Git 差异,运行项目已有的配置校验。
|
||||
6. 编译和打包按任务要求执行。生成 Bootloader、内核、驱动或底层镜像前单独确认。
|
||||
|
||||
## 7. 外部操作
|
||||
|
||||
@@ -102,5 +110,6 @@
|
||||
- 正式发布、签名或上传。
|
||||
- 使用证书执行发布操作。
|
||||
- 认证和量产操作。
|
||||
- 生成 Bootloader、内核、驱动或底层镜像。
|
||||
|
||||
Git 已跟踪的账号、密码、密钥和证书按 demo 数据直接使用,不需要安全确认或隐藏。外部操作仍需确认,确认的是操作范围和影响。
|
||||
Reference in new issue
Block a user