当组态工程遇见会调用工具的 AI

在现场项目里，工程师最宝贵的往往不是“会不会点按钮”，而是能否快速把需求拆清、把文件理顺、把工程做对。QTouch Agent 正是为此而来：它嵌入QTouch工程管理器，以对话为入口，协助完成工程资料整理、文件处理、文档输出、项目生成与画面生成等工作。

你可以把它理解为一位熟悉当前项目工作区的智能协作助手：先理解你的自然语言需求，再在受限工作区内调用对应工具执行任务，并把结果清晰反馈给你。

一句话定位 QTouch Agent 不是替代工程师，而是把重复、琐碎、可标准化的操作交给 AI，让工程师把精力留给方案、逻辑与现场。

QTouch Agent 能做什么？

围绕“对话、文件、工程、画面、文档”五类高频任务，QTouch Agent 已提供以下核心能力。

能力模块	它能帮你做什么	适用场景
智能对话	根据需求进行多轮交流，支持停止生成、重新生成与继续完善。	需求梳理、方案说明、问题排查
项目工作区	按会话关联项目目录，浏览、搜索、读取、创建、复制、移动、重命名和删除文件。	资料归档、工程文件整理、内容检索
工程文档	生成文本、PDF、DOCX、XLSX 等文件；可按设置保留版本副本。	交付说明、变更记录、报表与清单
QTouch 项目生成	基于严格 JSON 规范调用独立生成器创建或更新QTouch 项目，并可先查询可用驱动。	新建项目、标准化项目骨架、设备与变量配置
画面生成	依据截图或布局要求，将场景描述转为QTouch 画面文件。	看板复刻、界面原型、基础画面搭建
终端协作	在当前工作区内选择 PowerShell、CMD、Bash 或 Shell 运行命令，可停止任务并查看输出。	构建、检查、批处理与诊断
模型与记忆	支持模型选择、服务商配置、流式输出、温度与令牌设置，以及可选长期记忆。	适配不同模型服务与个人工作习惯

面对一个交接而来的项目，最怕的是文件散、命名乱、资料找不到。你可以先让 Agent 搜索关键字、列出目录、读取配置或文本文件，再按你的要求生成说明文档、整理清单或创建规范目录。

·示例提问：请搜索当前项目中包含“报警”的配置文件，并汇总文件路径。

·示例提问：在 reports 目录创建一份项目交接清单，按日期保留版本。

新项目往往有大量重复配置。QTouch Agent 可先查询目标平台下已安装驱动及其元数据，再按规范生成 QTouch 项目。它调用的是独立项目生成器，不会直接操作QTouch 内部函数，过程更清晰、边界更明确。

·示例提问：先列出 IPC(1024x768) 平台可用驱动，再为我生成一个包含设备和变量的项目框架。

·示例提问：根据这份规范生成项目；设备、驱动和变量请严格遵循可用驱动元数据。

当你已有现场截图、UI 草图或清晰的布局描述时，可将其作为视觉参考交给 Agent。它会把页面要素转换为严格的场景规范，并交由画面生成器输出 QTouch 画面文件，适合用于原型搭建与重复界面复刻。

·示例提问：参考我附上的截图，生成一个 1024x768 的设备总览画面，保留标题、状态卡片和趋势区域。

1.新建会话并关联项目：选择或打开对应项目工作区。每个会话可关联自己的项目目录，避免任务串扰。

2.配置模型服务：在设置中选择服务商，填写 Base URL 与 API Key，设置模型、温度、最大令牌数和是否流式输出。也可创建、复制、重命名或切换多个服务商配置。

3.用“目标 + 范围 + 结果”提需求：例如“在当前工作区搜索 PLC，输出路径清单”；又如“生成一份 DOCX 项目交接说明，保存到 docs”。描述越明确，结果越可控。

4.按需添加附件：可点击加号、拖放或粘贴文件。对文本类附件，Agent 可读取部分内容作为上下文；对截图等视觉附件，可用于画面生成参考。

5.核对结果并继续迭代：在对话中查看执行状态、工具结果和文件输出；需要调整时，直接补充条件，或使用停止、重新生成等操作。

小提示 对于已有文件的修改，建议先让 Agent 读取文件再提出改动要求；对于项目生成，先查询目标平台驱动，再生成项目规范。这样更容易得到符合当前工程环境的结果。

任务类型	可以直接这样说
查找与理解	“搜索当前工作区中名称或内容含有‘变频器’的文件，按类型归类并告诉我哪些需要优先查看。”
生成文档	“为当前项目生成一份 DOCX 使用说明，包含项目概述、文件结构和部署检查项，输出到 docs 目录。”
创建工程	“先列出目标平台的可用驱动；确认后按指定设备和变量生成一个新的QTouch 项目。”
生成画面	“参考附件截图，生成一个设备监控画面：顶部标题、左侧导航、中间三张状态卡、底部趋势图区域。”

好用的 AI，需要清晰的边界。QTouch Agent 的写入、移动、删除、项目生成等操作限定在当前配置的工作区内；终端命令同样在当前工作区环境执行。请始终把工作区指向本次项目，避免把重要文件放在不应修改的位置。

·先备份、再批量修改：对重要工程、配置和交付文件，建议保留项目副本或开启“生成文档保留版本”。

·关键结果要复核：项目配置、设备地址、变量定义、画面布局及终端输出，都应由工程师结合现场要求确认。

·不上传敏感信息：模型服务和附件使用应遵循企业的数据安全、保密和网络管理规范。

·从小任务开始：先用搜索、文档、目录整理建立信任，再逐步扩展到项目与画面生成。

从“帮我找文件”，到“帮我整理交付说明”，再到“按规范生成项目、按截图搭建画面”，QTouch Agent 正在把自然语言变成更贴近工程现场的协作方式。它不替你做判断，但可以更快地把判断落到工程里。

下一次打开QTouch工程管理器，不妨从一句清晰的需求开始：把你想完成的事告诉 QTouch Agent，让重复工作先走一步。