M05-06参数化建模 · 第 6 / 7 节· 建议 20 分钟
脚本片段(Python/GH 节点)的安全使用与逐行校核(20 分钟)
本页为公开学习稿。AI 生成内容仅作初稿,涉及工程、合同与对外交付时须人工复核。
一、学习目标
- 能说出脚本片段使用的安全边界。
- 能逐行读懂并改写一个简单片段。
- 能判断片段是否接触敏感数据。
- 能建立“先审阅、后运行”的使用习惯。
二、知识点讲解要点
什么时候用脚本片段
只在重复计算、批量排列等自己能读懂的场景使用。读不懂的片段,再省事也不运行。
安全规则
未逐行审阅不运行;不在正式项目和真实数据上直接试;先在练习文件或副本上试;不上传真实图纸、项目编号和客户资料。
逐行校核四看
看变量含义、看单位、看边界条件(空值、极值)、看可能报错的位置。每一行都能用自己的话解释。
常见误用
直接粘贴就运行;看不懂就跑;把脚本当黑盒只改数字;在真实项目文件里试错。
复核方法
逐行写说明,解释不出的行删除或重写;试跑异常立即停止并回退副本。
三、演示操作步骤
- 先复制一份练习文件作为试跑副本,正式练习文件另存保留。
- 打开豆包,新建对话,粘贴提示词 TY-M05-002(脚本解释),贴入要审阅的片段,发送。
- 对照 AI 的解释逐行写自己的说明,标注变量与单位。
- 只在副本上试跑,记录输入、输出与异常;异常即停并回退。
- 把审阅过的片段存入个人片段库,标注适用范围与风险点。
四、课堂示例(虚构项目:示例·青岚园社区配套用房)
**输入要点(提示词骨架):**提示词骨架:“请逐行解释下面这段用于练习文件批量排列窗户的简单脚本片段,说明每个变量含义、单位和可能报错的位置,不要建议我直接在正式项目运行。”
**操作:**AI 解释后,人工在青岚园练习副本上试跑一次,异常即停,写逐行说明笔记。
**预期产出:**一份带逐行说明的片段笔记,记录试跑结果与停止条件。
**需要人工修改之处:**解释不清的行删除;涉及真实项目信息的内容不上传;试跑只用虚构练习数据。
五、课后练习
对应任务书练习六(片段逐行审阅说明),练习目标:审阅一个片段并写逐行说明;预计用时 40 分钟。
六、产出验收标准
- □ 逐行说明齐全,无未解释的代码行。
- □ 仅在练习副本上试跑,未触碰正式项目文件。
- □ 未上传真实项目数据。
- □ 出现异常已停止并回退。
七、配套资料指向
提示词 TY-M05-002(脚本解释)、TY-M05-003(错误排查)。
这一节有错别字或失效步骤?