筑·智 AI筑·智 AI课程
M05-06参数化建模 · 第 6 / 7 节· 建议 20 分钟

脚本片段(Python/GH 节点)的安全使用与逐行校核(20 分钟)

本页为公开学习稿。AI 生成内容仅作初稿,涉及工程、合同与对外交付时须人工复核。

一、学习目标

  • 能说出脚本片段使用的安全边界。
  • 能逐行读懂并改写一个简单片段。
  • 能判断片段是否接触敏感数据。
  • 能建立“先审阅、后运行”的使用习惯。

二、知识点讲解要点

什么时候用脚本片段

只在重复计算、批量排列等自己能读懂的场景使用。读不懂的片段,再省事也不运行。

安全规则

未逐行审阅不运行;不在正式项目和真实数据上直接试;先在练习文件或副本上试;不上传真实图纸、项目编号和客户资料。

逐行校核四看

看变量含义、看单位、看边界条件(空值、极值)、看可能报错的位置。每一行都能用自己的话解释。

常见误用

直接粘贴就运行;看不懂就跑;把脚本当黑盒只改数字;在真实项目文件里试错。

复核方法

逐行写说明,解释不出的行删除或重写;试跑异常立即停止并回退副本。

三、演示操作步骤

  • 先复制一份练习文件作为试跑副本,正式练习文件另存保留。
  • 打开豆包,新建对话,粘贴提示词 TY-M05-002(脚本解释),贴入要审阅的片段,发送。
  • 对照 AI 的解释逐行写自己的说明,标注变量与单位。
  • 只在副本上试跑,记录输入、输出与异常;异常即停并回退。
  • 把审阅过的片段存入个人片段库,标注适用范围与风险点。

四、课堂示例(虚构项目:示例·青岚园社区配套用房)

**输入要点(提示词骨架):**提示词骨架:“请逐行解释下面这段用于练习文件批量排列窗户的简单脚本片段,说明每个变量含义、单位和可能报错的位置,不要建议我直接在正式项目运行。”

**操作:**AI 解释后,人工在青岚园练习副本上试跑一次,异常即停,写逐行说明笔记。

**预期产出:**一份带逐行说明的片段笔记,记录试跑结果与停止条件。

**需要人工修改之处:**解释不清的行删除;涉及真实项目信息的内容不上传;试跑只用虚构练习数据。

五、课后练习

对应任务书练习六(片段逐行审阅说明),练习目标:审阅一个片段并写逐行说明;预计用时 40 分钟。

六、产出验收标准

  • □ 逐行说明齐全,无未解释的代码行。
  • □ 仅在练习副本上试跑,未触碰正式项目文件。
  • □ 未上传真实项目数据。
  • □ 出现异常已停止并回退。

七、配套资料指向

提示词 TY-M05-002(脚本解释)、TY-M05-003(错误排查)。

这一节有错别字或失效步骤?