企业官网建设流程全解析

虚拟主机如何做网站,北京专业企业营销网站建设,建设工程合同可以约定仲裁管辖吗,哈尔滨 网站建设公司第 8 篇#xff1a;模板库 一键场景加载 引言 在之前的开发中#xff0c;我们已经实现了宏编辑器#xff08;MacroEditorPanel#xff09;#xff0c;允许用户手动编写和运行宏脚本。但对于现场维护工具来说#xff0c;许多场景#xff08;如停车场巡航、周界警戒模板库 一键场景加载引言在之前的开发中我们已经实现了宏编辑器MacroEditorPanel允许用户手动编写和运行宏脚本。但对于现场维护工具来说许多场景如停车场巡航、周界警戒是常见的重复操作。如果每次都从零编写宏不仅效率低下还容易出错。为此本篇引入模板库功能预置常见宏模板支持参数化占位符用户可一键加载到编辑器中编辑/运行。这大大简化了用户操作例如选择“停车场巡航”模板即可自动填充脚本用户只需调整参数如循环次数即可运行。模板基于 JSON 文件管理便于扩展和维护。同时我们在 UI 中集成模板选择界面实现“一键场景加载”。此外模板系统支持参数输入对话框通过 ParamProvider 类允许用户在加载或运行时动态填充值。关键收益标准化统一常见场景的宏逻辑避免用户自行编写出错。参数化使用 Mustache-style 占位符如 {{preset}}加载后可通过 UI 对话框自动填充或手动替换。可扩展用户或开发者可添加新模板无需修改代码。集成性模板库作为独立面板嵌入 RightPanel 的 Tabs 中便于切换。本篇将逐步说明模板文件结构、参数化机制、UI 集成及配套代码。通过此功能Pelco KBD300A 模拟器进一步向“现场维护工具”转型提供开箱即用的场景解决方案。1. 模板文件结构templates.json模板库的核心是 templates.json 文件位于 resources/ 目录下可动态加载。每个模板是一个 JSON 对象包含名称、描述、脚本及参数列表。文件结构示例基于当前项目文件{templates:[{name:停车场巡航,description:调用预置位 1-4每位停留 5 秒循环 3 次,script:loop(3){\n send_preset(1)\n delay(5000)\n send_preset(2)\n delay(5000)\n send_preset(3)\n delay(5000)\n send_preset(4)\n delay(5000)\n},params:[]},{name:周界警戒,description:辅助开关 PTZ 移动带参数,script:aux_on({{aux_id}})\npan_tilt({{pan}}, {{tilt}})\ndelay(2000)\nsend_preset({{preset}}),params:[aux_id,pan,tilt,preset]},{name:球机调试,description:球机基本调试Zoom/Focus/Iris 测试,script:zoom(1, in)\ndelay(1000)\nzoom(1, out)\ndelay(1000)\nfocus(1, far)\ndelay(1000)\nfocus(1, near)\ndelay(1000)\niris(1, open)\ndelay(1000)\niris(1, close),params:[]},{name:巡航 报警联动,description:带参数的巡航宏可设置巡航次数、预置位范围、报警 AUX 编号,script:loop({{loops}}){\n # 巡航预置位范围\n for(p{{start}}; p{{end}}; p){\n send_preset(1, p)\n delay(3000)\n }\n}\n\n# 报警联动动作\naux_on(1, {{aux_id}})\ndelay(2000)\nsend_preset(1, {{alarm_preset}})\n,params:[loops,start,end,aux_id,alarm_preset]}]}name模板名称用于 UI 显示。description简要描述用于提示用户。script宏脚本主体支持我们的宏语法loop/for/delay/send_preset 等。params参数列表数组表示脚本中需要替换的占位符如 {{aux_id}}。如果为空则模板无参数直接加载。设计考虑使用 JSON 便于解析和扩展通过 TemplateLibrary 类加载。脚本中占位符采用 {{var}} 或 {{{var}}} 格式类似 Mustache优先匹配 {{{var}}} 以避免冲突。默认提供多个示例模板覆盖巡航、警戒、调试、联动场景。文件路径resources/templates.json不存在时自动创建默认模板DEFAULT_TEMPLATES。2. 模板参数化机制参数化是模板的核心提升复用性。核心类包括TemplateRenderercore/template/renderer.py负责替换占位符。支持 {{key}} 和 {{{key}}} 两种格式先替换 {{{key}}} 避免冲突。示例TemplateRenderer.render(script, {aux_id: 1})将 {{aux_id}} 替换为 1。ParamProvidercore/template/params.py提供参数输入对话框。支持多种类型int, float, str, bool 等。通过 QInputDialog 获取用户输入支持默认值和描述。示例param_provider.get_params([{name: aux_id, type: int}])返回 {“aux_id”: 用户输入值}。TemplateController和TemplateRunnercore/template/controller.py 和 runner.py集成渲染和运行。Controller 处理加载到编辑器Runner 使用 MacroEngine 执行渲染后的脚本。示例流程用户选择“周界警戒”模板。系统弹出参数对话框输入 aux_id, pan, tilt, preset。渲染脚本替换 {{aux_id}} 等为用户值。填充到宏编辑器或直接运行。这比纯静态模板更灵活适合现场自定义。3. UI 集成模板库面板我们在 RightPanel 的 Tabs 中添加一个新面板TemplateLibraryPanel包含模板列表、描述、操作按钮。UI 布局搜索框QLineEdit支持名称/描述过滤。模板列表QListWidget 显示所有模板名称支持右键菜单编辑/删除。描述区域QTextEdit 显示选中模板的描述和脚本预览。按钮栏加载到编辑器、直接运行、新增/编辑/删除模板。集成到 RightPanel在 ui/right_panel/panel.py 的__init__中添加self.template_panelTemplateLibraryPanel(self)self.tabs.addTab(self.template_panel,模板库)用户交互选择模板 → 显示描述 → 点击“加载” → 参数对话框若有 → 渲染脚本填充到宏编辑器切换到宏编辑 Tab。点击“运行” → 参数对话框若有 → 渲染并直接执行模板脚本。新增/编辑弹出 TemplateEditDialog支持输入名称、描述、脚本、参数列表。信号连接在 RightPaneltemplate_panel.load_template.connect(self.macro_editor.set_script)加载到编辑器。template_panel.run_template.connect(self.run_macro)直接运行。4. 配套代码模板管理类与面板实现模板管理类TemplateLibrary位于 core/template/library.pyclassTemplateLibrary:def__init__(self,path):self.pathpath self.templates[]self.load()defload(self):ifnotos.path.exists(self.path):logger.warning(f模板文件不存在:{self.path})self._create_default_templates()returnself.templatestry:withopen(self.path,r,encodingutf-8)asf:datajson.load(f)self.templatesdata.get(templates,[])logger.info(f加载了{len(self.templates)}个模板)exceptExceptionase:logger.error(f加载模板失败:{e})self.templates[]self._create_default_templates()returnself.templatesdefsave(self):try:withopen(self.path,w,encodingutf-8)asf:json.dump({templates:self.templates},f,indent4,ensure_asciiFalse)logger.info(模板已保存)exceptExceptionase:logger.error(f保存模板失败:{e})deffind(self,name:str):returnnext((tfortinself.templatesift[name]name),None)def_create_default_templates(self):创建默认模板self.templates[# ... 默认模板列表与 templates.json 一致]logger.info(创建了默认模板)支持加载/保存/查找模板。错误处理加载失败时回退到默认模板。模板库面板TemplateLibraryPanel位于 ui/right_panel/template_library.py简化版代码classTemplateLibraryPanel(QtWidgets.QWidget):load_templateQtCore.pyqtSignal(str)run_templateQtCore.pyqtSignal(str)error_occurredQtCore.pyqtSignal(str)def__init__(self,parentNone):super().__init__(parent)self.libTemplateLibrary(resources/templates.json)self.param_providerParamProvider()# 参数输入提供器self._init_ui()self._reload()def_init_ui(self):# ... 布局代码与文章中示例一致包括搜索、列表、描述、按钮、右键菜单def_load_to_editor(self):tplself.lib.templates[self.template_list.currentRow()]scriptself._prepare_script(tpl)ifscript:self.load_template.emit(script)def_run_template(self):tplself._current_tpl()iftpl:scriptself._prepare_script(tpl)ifscript:self.run_template.emit(script)def_prepare_script(self,tpl):paramstpl.get(params,[])ifparams:valuesself.param_provider.get_params(params)ifvaluesisNone:QMessageBox.warning(self,参数错误,参数获取取消或失败)returnNonetry:returnTemplateRenderer.render(tpl[script],values)exceptExceptionase:QMessageBox.critical(self,渲染错误,f参数渲染失败:{str(e)})returnNonereturntpl[script]使用信号解耦不直接依赖宏编辑器。_prepare_script集成参数获取和渲染。5. 测试与优化单元测试在 tests/right_panel/test_template_library_ui.py 中测试 JSON 加载、参数提取、渲染。集成测试在 tests/integration/test_template_to_editor.py 中测试模板加载到编辑器的流程。端到端测试在 tests/e2e/test_template_e2e.py 中模拟用户选择模板 → 输入参数 → 加载/运行。优化如果 params 非空弹出对话框自动渲染支持参数类型校验int/float 等JSON 损坏时回退到 DEFAULT_TEMPLATES。边界处理无模板时显示默认参数取消时不加载。结语通过模板库我们为 Pelco KBD300A 模拟器注入了“一键场景加载”的实用性用户无需深究宏语法即可快速部署常见维护任务。这标志着项目从“模拟器”向“智能工具”的转变。下篇将聚焦实时接收数据解析与协议反馈处理进一步增强现场处理能力。上一篇总目录下一篇