网友作品 #000239 · 提交于 2026/09/28
铁路三级技术交底生成器：勾选工序一键出Word
作品简介
铁路项目三级技术交底生成器是一款离线可用的 Windows 桌面小工具：填写项目参数、勾选本次交底涉及的专业工序，几秒钟生成铁路工程三级技术交底 Word 文档，可直接在 Word 中二次编辑后打印签认、归档报审。
程序不需要联网、不需要 API Key、不上传任何数据，内容由内置工序知识库与参数派生引擎生成，而非随机拼凑。一个 Word 文件内可同时输出第一、二、三级交底，每级独立成节并附签认表；参数可保存配置，下次同类交底载入后改几个字段就能出本。
核心亮点
- 知识库覆盖 7 个专业 37 个工序：通用综合、路基、桥涵、隧道、轨道、四电、站场房建，每个工序含工艺流程、技术参数、质量标准、操作要点、安全要点与质量通病防治
- 三级交底一次生成：第一级（项目级）、第二级（分部分项级）、第三级（班组/工序级）各自成节，生成级别可自由指定（只做二级就填 2），每级附签认表
- 参数派生而非填空：按风险等级与工序类型自动产出危大工程清单及控制要求表；邻近营业线、高原、严寒、瓦斯、岩溶、跨航道等特殊环境标签自动写入对应专项措施
- 签认表自动带人：交底人、安全与质量负责人自动带入，预留可配置的空白签名行与日期栏
- 不生成空白句：未填写的字段在正文留「【待补充】」标记，方便逐项补完
- 双击即用：打包好的 exe 无需安装 Python；新增工序只需在知识库数据文件追加一条记录，界面自动出现
技术与工具
- 技术栈：Python + tkinter 桌面界面，uv 管理依赖
- 工程结构：knowledge 工序知识库、services 派生引擎与 Word 导出、templates 文档节点定义，分层清晰、与导出格式解耦
- 质量保障：ruff 代码规范检查、pytest 单元测试与生成冒烟测试
- 交付方式：PyInstaller 打包 exe，启动目录留有日志便于排错
- 开发方式：作者零基础，借助 AI 编程类工具与国内顶级模型完成
适用场景
适合铁路工程施工项目的项目总工、技术主管、工区技术员快速编制三级技术交底：新项目或新分部分项工程开工前，按页签填好项目信息并勾选工序即可出稿，同类交底可复用已保存的参数配置。生成内容中的工艺参数、允许偏差等取值属通用经验值，正式签认前需结合本项目设计文件、专项方案与现行标准复核。
原始提交内容（点开查看，可复制全文去问 AI）
铁路项目三级技术交底生成器 一个离线可用的桌面小工具：填写项目参数、勾选专业工序，一键生成铁路工程三级技术交底（Word 文档）， 内容按铁路行业通用做法与验收标准术语编写，可直接在 Word 中二次编辑后打印签认、归档报审。
不需要联网，不需要 API Key，不上传任何数据 内容由内置工序知识库 + 参数派生引擎生成，非随机拼凑 内置 7 个专业、37 个工序的交底知识（工艺流程 / 技术参数 / 质量标准 / 操作要点 / 安全要点 / 质量通病防治） 一个 Word 文件内可同时输出第一、二、三级交底，每级独立成节并附签认表 一、怎么用（普通用户版） 双击 dist\铁路三级技术交底生成器.exe（无需安装 Python）； 开发环境下用 uv run railway-three-level-disclosure 启动 点右上角「填充示例参数」，先看看各字段填什么 按页签填写：项目信息 交底设置 专业与工序 人员与签署 输出设置 「专业与工序」页选专业，再在下方工序列表中多选本次交底涉及的工序（可「全选」） 「输出设置」页的「生成级别」填 1,2,3（只做二级交底就填 2） 点「生成交底文档」，几秒钟后弹出提示，文件就在「输出目录」里（默认 output 文件夹） 打印后由交底人和被交底人手工签字，签认表已预留空白行与日期栏 参数可以「保存参数配置」，下次同类交底直接「载入参数配置」，改几个字段就能出本。
二、生成什么 第一级技术交底（项目级） 交底人：项目总工程师 接收：项目部各职能部门、各工区（架子队）负责人及技术主管
工程概况与交底范围、设计技术标准与主要技术指标、施工组织与总体部署要求、 关键工序与危大工程控制要求（表）、质量目标与过程控制要求（8 条通用控制要求）、 安全生产与风险管控要求、特殊施工环境措施、接口管理与成品保护、技术资料与信息化管理、补充要求与答疑记录。
第二级技术交底（单位工程 / 分部分项级） 交底人：项目部技术主管 接收：工区技术负责人、施工员、质检员、安全员
施工准备要求；然后按所选工序逐项展开：适用范围 施工工艺流程 关键技术参数与控制指标 质量控制标准与检验方法（表） 质量通病及防治措施（表） 安全与环境保护要点 验收与内业资料 引用标准。
第三级技术交底（班组 / 工序级） 交底人：工区（架子队）技术员 接收：班组长及全体作业人员
班前准备与检查；按工序展开：操作步骤（按顺序作业） 操作要点（必须做到） 关键控制参数（记住这几个数） 质量标准与自检要求（表） 本工序安全注意事项；最后统一给出禁止行为（红线）、应急处置、收工与文明施工要求。
签认表（每级一份） 序号 / 姓名 / 部门·工种（职务） / 签字 / 日期，自动带入交底人、安全与质量负责人，并预留可配置的空白签名行（默认 10 行）。
三、知识库覆盖范围 专业 工序 通用综合 施工测量放样、钢筋加工与安装、模板安装与拆除、混凝土浇筑与养护、脚手架搭设与拆除、起重吊装作业 路基工程 地基处理（CFG桩/搅拌桩）、路堤填筑、过渡段施工、边坡防护与支挡、路基防排水 桥涵工程 钻孔灌注桩、承台与墩台身、连续梁挂篮悬浇、预制箱梁架设、涵洞施工 隧道工程 洞口与边仰坡、超前支护（管棚/小导管）、洞身开挖、初期支护、结构防排水、二次衬砌 轨道工程 底座板（支承层）、轨道板铺设与精调、无缝线路锁定、有砟道床、道岔铺设 四电工程 接触网支柱基础与安装、腕臂装配与架线调整、电力电缆敷设、信号电缆与设备基础、综合接地 站场房建 站场土石方与管线、站房主体结构、站台与雨棚、钢结构制作与安装、装饰装修与机电安装 四、自动化能力（不只是填空） 输入 自动产出 选择的工序 工艺流程、技术参数、质量控制表、质量通病防治表、安全要点、验收资料清单、引用标准 风险等级 + 工序类型 危大工程清单及控制要求（表）、危险源管控要求 特殊环境标签（邻近营业线/高原/严寒/瓦斯/岩溶/跨航道等） 对应专项措施条目，写入一级交底 人员与接收对象 各级交底信息表与签认表（含交底人、接收对象、部门/工种） 未填写的字段 正文中留「【待补充】」标记，方便逐项补完，不会生成空白句子 工艺参数、允许偏差等取值属通用经验值，只作初稿参考；正式签认前请结合本项目设计文件、专项方案与现行标准复核。
五、二次开发 src/railway_disclosure/ ui/ 界面（tkinter，表单由 models/fields.py 的 FIELD_SPECS 自动渲染） models/ 参数模型（params.py）与表单字段（fields.py），新增参数只改这两处 knowledge/ 工序知识库：base.py 数据结构，data_.py 各专业工序数据，processes.py 注册表 services/ context.py 派生引擎、renderer.py 文档编排、docx_writer.py Word 导出、generator.py 生成入口 templates/ 文档节点定义（与导出格式解耦） utils/ 路径与文件名处理 新增一个工序：在对应 knowledge/data_.py 中追加一条 ProcessKnowledge，界面自动出现，无需改其它代码。
常用命令（需 Python 环境，uv 管理依赖）：
uv run ruff check src tests # 代码规范 uv run pytest -q # 单元测试与生成冒烟 uv run railway-three-level-disclosure # 启动界面 uv run pyinstaller “铁路三级技术交底生成器.spec” # 打包 exe 日志在启动目录下的 logs\ 目录，遇到报错可把日志发